15b87a1eaSMatt Spinler# groups.json
25b87a1eaSMatt Spinler
3a49e3f19SPatrick WilliamsThis file contains an array of group definitions. In this usage, a group refers
4a49e3f19SPatrick Williamsto a group of D-Bus objects that all of the same D-Bus path and interface, and
5a49e3f19SPatrick Williamsare acted upon by actions and triggers in events.json. Only the D-Bus objects
6a49e3f19SPatrick Williamspaths are specified in this file, the interface and properties are specified at
7a49e3f19SPatrick Williamsthe time of usage in events.json.
85b87a1eaSMatt Spinler
95b87a1eaSMatt Spinler## JSON example
105b87a1eaSMatt Spinler
11*64fb88c1SGeorge Liu```json
125b87a1eaSMatt Spinler[
135b87a1eaSMatt Spinler  {
145b87a1eaSMatt Spinler    "name": "occ objects",
155b87a1eaSMatt Spinler    "service": "org.open_power.OCC.Control",
16*64fb88c1SGeorge Liu    "members": ["/org/open_power/control/occ0", "/org/open_power/control/occ1"]
175b87a1eaSMatt Spinler  }
185b87a1eaSMatt Spinler]
195b87a1eaSMatt Spinler```
205b87a1eaSMatt Spinler
215b87a1eaSMatt Spinler## Attributes
225b87a1eaSMatt Spinler
235b87a1eaSMatt Spinler### members
24a49e3f19SPatrick Williams
255b87a1eaSMatt SpinlerAn array of the D-Bus object paths that are in the group. Required.
265b87a1eaSMatt Spinler
275b87a1eaSMatt Spinler### name
28a49e3f19SPatrick Williams
29a49e3f19SPatrick WilliamsThe group name. This is how the group is referenced in events.json. Required.
305b87a1eaSMatt Spinler
315b87a1eaSMatt Spinler### service
32a49e3f19SPatrick Williams
33a49e3f19SPatrick WilliamsIf known, the D-Bus service name that provides these D-bus objects. All members
34a49e3f19SPatrick Williamsof the group must be hosted by the same service for this to be used. This
35a49e3f19SPatrick Williamsprovides performance improvements in certain cases. Optional.
36