1description: >
2    The priority, for redundancy purposes, of the associated
3    xyz.openbmc_project.Software.Version.
4properties:
5    - name: Priority
6      type: byte
7      description: >
8        The priority order specified for the associated Software.Version,
9        represented as a value between 0 (High) and 127 (Low).  Any value
10        above 127 has implementation-specific purpose.
11
12        Only one Software.Version, per associated device, may be at any
13        particular priority.  A requested priority change may cause other
14        Software.Versions to change priority.
15
16        A dual-sided redundancy model could be represented by two
17        Software.Version associations, one of which is at priority 0 and the
18        other at priority 1.  When a new image is Activated, the old
19        priority-1 association is deleted, the old priority-0 association
20        becomes priority-1, and the new image is assigned priority-0.
21# TODO: Specify "EAGAIN" type error when priority is unable to be modified
22#       due to current system state.  Currently, sdbusplus does not support
23#       errors on properties.
24