1# groups.json
2
3This file contains an array of group definitions. In this usage, a group refers
4to a group of D-Bus objects that all of the same D-Bus path and interface, and
5are acted upon by actions and triggers in events.json. Only the D-Bus objects
6paths are specified in this file, the interface and properties are specified at
7the time of usage in events.json.
8
9## JSON example
10
11```
12[
13  {
14     "name": "occ objects",
15     "service": "org.open_power.OCC.Control",
16     "members": [
17       "/org/open_power/control/occ0",
18       "/org/open_power/control/occ1"
19     ]
20   }
21]
22```
23
24## Attributes
25
26### members
27
28An array of the D-Bus object paths that are in the group. Required.
29
30### name
31
32The group name. This is how the group is referenced in events.json. Required.
33
34### service
35
36If known, the D-Bus service name that provides these D-bus objects. All members
37of the group must be hosted by the same service for this to be used. This
38provides performance improvements in certain cases. Optional.
39