xref: /openbmc/phosphor-dbus-interfaces/yaml/xyz/openbmc_project/Control/Failover.interface.yaml (revision f85ae8afbb5e4be7d83a15ef9b6f24da74d41c4f)
1description: >
2    Implement to provide an interface to start a failover.  Depending on the
3    implementation, this may reside on the 'from' or 'to' object (or both).  The
4    'Options' method argument provides a mechanism to provide implementation
5    specific options.
6
7methods:
8    - name: StartFailover
9      description: >
10          Starts a failover operation.
11      parameters:
12          - name: Requester
13            type: enum[self.Requester]
14            description: >
15                Identifies who's requesting the failover
16          - name: Options
17            type: dict[string, variant[boolean]]
18            description: >
19                Additional options. The key is the string version of the Options
20                enum, in the form of
21                'xyz.openbmc_project.Control.Failover.Options.X'.
22      errors:
23          - xyz.openbmc_project.Common.Error.Unavailable
24
25enumerations:
26    - name: Requester
27      description: >
28          Who is requesting the failover.
29      values:
30          - name: Host
31            description: >
32                The host is requesting the failover.
33          - name: Redfish
34            description: >
35                A Redfish client is requesting the failover.
36          - name: SystemConfig
37            description: >
38                A system config checker on the BMC is requesting the failover.
39          - name: Tool
40            description: >
41                A command line tool is requesting the failover.
42    - name: Options
43      description: >
44          Available options for starting the failover.
45      values:
46          - name: "Force"
47            description: >
48                A boolean option to force the failover when it would normally
49                not be available.  The checks it bypasses are implementation
50                dependent.
51