| Ramesh Iyyar | ae56dbc | 2021-05-17 06:40:00 -0500 | [diff] [blame] | 1 | description: > |
| 2 | This interface contains create method, which can be implemented to |
| 3 | create an xyz.openbmc_project.HardwareIsolation.Entry object |
| 4 | which will use to provide the information of isolated hardware. |
| 5 | |
| 6 | methods: |
| 7 | - name: Create |
| 8 | description: > |
| 9 | Create an xyz.openbmc_project.HardwareIsolation.Entry object |
| 10 | if any of the hardware, needs to be isolated. This interface |
| 11 | can be used if want to isolate hardware without an error log, |
| 12 | for example, the user voluntarily tried to isolate hardware. |
| 13 | parameters: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 14 | - name: IsolateHardware |
| Patrick Williams | b78a070 | 2022-10-24 12:32:56 -0500 | [diff] [blame^] | 15 | type: object_path |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 16 | description: > |
| 17 | The hardware inventory path which is needs to isolate. |
| 18 | - name: Severity |
| 19 | type: enum[xyz.openbmc_project.HardwareIsolation.Entry.Type] |
| 20 | description: > |
| 21 | The severity of hardware isolation. |
| Ramesh Iyyar | ae56dbc | 2021-05-17 06:40:00 -0500 | [diff] [blame] | 22 | returns: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 23 | - name: Path |
| Patrick Williams | b78a070 | 2022-10-24 12:32:56 -0500 | [diff] [blame^] | 24 | type: object_path |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 25 | description: > |
| 26 | The path of created xyz.openbmc_project.HardwareIsolation.Entry |
| 27 | object. |
| Ramesh Iyyar | ae56dbc | 2021-05-17 06:40:00 -0500 | [diff] [blame] | 28 | errors: |
| 29 | - xyz.openbmc_project.Common.Error.InvalidArgument |
| 30 | - xyz.openbmc_project.Common.Error.TooManyResources |
| 31 | - xyz.openbmc_project.HardwareIsolation.Error.IsolatedAlready |
| 32 | - xyz.openbmc_project.Common.Error.NotAllowed |
| 33 | - xyz.openbmc_project.Common.Error.Unavailable |
| Ramesh Iyyar | 6ff6561 | 2021-06-18 00:38:55 -0500 | [diff] [blame] | 34 | |
| 35 | - name: CreateWithErrorLog |
| 36 | description: > |
| 37 | Create an xyz.openbmc_project.HardwareIsolation.Entry object |
| 38 | if any of the hardware, needs to be isolated. This interface |
| 39 | can be used if the system wants to isolate hardware with |
| 40 | an error log that is caused to isolate hardware. |
| 41 | This method is not going to create an error log and the consumer |
| 42 | of this method need to pass the bmc error log which caused |
| 43 | the isolation. |
| 44 | parameters: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 45 | - name: IsolateHardware |
| Patrick Williams | b78a070 | 2022-10-24 12:32:56 -0500 | [diff] [blame^] | 46 | type: object_path |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 47 | description: > |
| 48 | The hardware inventory path which is needs to isolate. |
| 49 | - name: Severity |
| 50 | type: enum[xyz.openbmc_project.HardwareIsolation.Entry.Type] |
| 51 | description: > |
| 52 | The severity of hardware isolation. |
| 53 | - name: BmcErrorLog |
| Patrick Williams | b78a070 | 2022-10-24 12:32:56 -0500 | [diff] [blame^] | 54 | type: object_path |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 55 | description: > |
| 56 | The BMC error log caused the isolation of hardware. |
| Ramesh Iyyar | 6ff6561 | 2021-06-18 00:38:55 -0500 | [diff] [blame] | 57 | returns: |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 58 | - name: Path |
| Patrick Williams | b78a070 | 2022-10-24 12:32:56 -0500 | [diff] [blame^] | 59 | type: object_path |
| Patrick Williams | 8da396c | 2022-03-14 14:21:02 -0500 | [diff] [blame] | 60 | description: > |
| 61 | The path of created xyz.openbmc_project.HardwareIsolation.Entry |
| 62 | object. |
| Ramesh Iyyar | 6ff6561 | 2021-06-18 00:38:55 -0500 | [diff] [blame] | 63 | errors: |
| 64 | - xyz.openbmc_project.Common.Error.InvalidArgument |
| 65 | - xyz.openbmc_project.Common.Error.TooManyResources |
| 66 | - xyz.openbmc_project.HardwareIsolation.Error.IsolatedAlready |
| 67 | - xyz.openbmc_project.Common.Error.NotAllowed |
| 68 | - xyz.openbmc_project.Common.Error.Unavailable |