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