1# groups.json
2
3This file contains an array of group definitions.  In this usage, a group
4refers to a group of D-Bus objects that all of the same D-Bus path and
5interface, and are acted upon by actions and triggers in events.json.
6Only the D-Bus objects paths are specified in this file, the interface and
7properties are specified at the 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
27An array of the D-Bus object paths that are in the group.  Required.
28
29### name
30The group name.  This is how the group is referenced in events.json.
31Required.
32
33### service
34If known, the D-Bus service name that provides these D-bus objects.  All
35members of the group must be hosted by the same service for this to be used.
36This provides performance improvements in certain cases.  Optional.
37