| Patrick Williams | 3350f3e | 2016-11-23 07:27:01 -0600 | [diff] [blame] | 1 | description: > |
| 2 | The priority, for redundancy purposes, of the associated |
| 3 | xyz.openbmc_project.Software.Version. |
| 4 | properties: |
| 5 | - name: Priority |
| Patrick Williams | 4eb5235 | 2017-01-25 09:16:59 -0600 | [diff] [blame] | 6 | type: byte |
| Patrick Williams | 3350f3e | 2016-11-23 07:27:01 -0600 | [diff] [blame] | 7 | description: > |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 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. |
| Patrick Williams | 3350f3e | 2016-11-23 07:27:01 -0600 | [diff] [blame] | 11 | |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 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. |
| Patrick Williams | 3350f3e | 2016-11-23 07:27:01 -0600 | [diff] [blame] | 15 | |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame^] | 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 | |
| Patrick Williams | 3350f3e | 2016-11-23 07:27:01 -0600 | [diff] [blame] | 22 | # TODO: Specify "EAGAIN" type error when priority is unable to be modified |
| 23 | # due to current system state. Currently, sdbusplus does not support |
| 24 | # errors on properties. |