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