1ce8d16d9SWillam A. Kennington IIIdescription: >
2f7944dcbSPatrick Williams    An example interface originally described as part of the announcement of new
3f7944dcbSPatrick Williams    sd-bus interfaces at:
4ce8d16d9SWillam A. Kennington III        http://0pointer.net/blog/the-new-sd-bus-api-of-systemd.html
5ce8d16d9SWillam A. Kennington IIImethods:
6ce8d16d9SWillam A. Kennington III    - name: Multiply
7ce8d16d9SWillam A. Kennington III      description: >
8ce8d16d9SWillam A. Kennington III          Multiplies two integers 'x' and 'y' and returns the result.
9ce8d16d9SWillam A. Kennington III      parameters:
10ce8d16d9SWillam A. Kennington III          - name: x
11ce8d16d9SWillam A. Kennington III            type: int64
12ce8d16d9SWillam A. Kennington III            description: >
13ce8d16d9SWillam A. Kennington III                The first integer to multiply.
14ce8d16d9SWillam A. Kennington III          - name: y
15ce8d16d9SWillam A. Kennington III            type: int64
16ce8d16d9SWillam A. Kennington III            description: >
17ce8d16d9SWillam A. Kennington III                The second integer to multiply.
18ce8d16d9SWillam A. Kennington III            default: 1
19ce8d16d9SWillam A. Kennington III      returns:
20ce8d16d9SWillam A. Kennington III          - name: z
21ce8d16d9SWillam A. Kennington III            type: int64
22ce8d16d9SWillam A. Kennington III            description: >
23ce8d16d9SWillam A. Kennington III                The result of (x*y).
24ce8d16d9SWillam A. Kennington III    - name: Divide
25ce8d16d9SWillam A. Kennington III      description: >
26ce8d16d9SWillam A. Kennington III          Divides two integers 'x' and 'y' and returns the result.
27ce8d16d9SWillam A. Kennington III      parameters:
28ce8d16d9SWillam A. Kennington III          - name: x
29ce8d16d9SWillam A. Kennington III            type: int64
30ce8d16d9SWillam A. Kennington III            description: >
31ce8d16d9SWillam A. Kennington III                The first integer to divide.
32ce8d16d9SWillam A. Kennington III          - name: y
33ce8d16d9SWillam A. Kennington III            type: int64
34ce8d16d9SWillam A. Kennington III            description: >
35ce8d16d9SWillam A. Kennington III                The second integer to divide.
36ce8d16d9SWillam A. Kennington III            default: 1
37ce8d16d9SWillam A. Kennington III      returns:
38ce8d16d9SWillam A. Kennington III          - name: z
39ce8d16d9SWillam A. Kennington III            type: int64
40ce8d16d9SWillam A. Kennington III            description: >
41ce8d16d9SWillam A. Kennington III                The result of (x/y).
42ce8d16d9SWillam A. Kennington III      errors:
43ce8d16d9SWillam A. Kennington III          - self.Error.DivisionByZero
44ce8d16d9SWillam A. Kennington III    - name: Clear
45ce8d16d9SWillam A. Kennington III      flags:
46ce8d16d9SWillam A. Kennington III          - unprivileged
47ce8d16d9SWillam A. Kennington III          - no_reply
48ce8d16d9SWillam A. Kennington III      description: >
49ce8d16d9SWillam A. Kennington III          Reset the LastResult property to zero.
50ce8d16d9SWillam A. Kennington IIIproperties:
51ce8d16d9SWillam A. Kennington III    - name: LastResult
52ce8d16d9SWillam A. Kennington III      type: int64
53ce8d16d9SWillam A. Kennington III      default: 0
54ce8d16d9SWillam A. Kennington III      description: >
55ce8d16d9SWillam A. Kennington III          The result of the most recent calculation.
56ce8d16d9SWillam A. Kennington III    - name: Status
57ce8d16d9SWillam A. Kennington III      type: enum[self.State]
58ce8d16d9SWillam A. Kennington III      default: Success
59ce8d16d9SWillam A. Kennington III      flags:
60ce8d16d9SWillam A. Kennington III          - const
61ce8d16d9SWillam A. Kennington III      description: >
62ce8d16d9SWillam A. Kennington III          The current state of the Calculator.
63ce8d16d9SWillam A. Kennington III    - name: Owner
64ce8d16d9SWillam A. Kennington III      type: string
65ce8d16d9SWillam A. Kennington III      description: >
66ce8d16d9SWillam A. Kennington III          The name of the owner of the Calculator.
67ce8d16d9SWillam A. Kennington III      errors:
68ce8d16d9SWillam A. Kennington III          - self.Error.PermissionDenied
69ce8d16d9SWillam A. Kennington IIIsignals:
70ce8d16d9SWillam A. Kennington III    - name: Cleared
71ce8d16d9SWillam A. Kennington III      description: >
72ce8d16d9SWillam A. Kennington III          Signal indicating the LastReset property has been set to zero by the
73ce8d16d9SWillam A. Kennington III          'Clear' method.
74ce8d16d9SWillam A. Kennington III      properties:
75ce8d16d9SWillam A. Kennington III          - type: int64
76ce8d16d9SWillam A. Kennington III            description: >
77ce8d16d9SWillam A. Kennington III                Value of LastReset prior to Clear.
78ce8d16d9SWillam A. Kennington IIIenumerations:
79ce8d16d9SWillam A. Kennington III    - name: State
80ce8d16d9SWillam A. Kennington III      description: >
81ce8d16d9SWillam A. Kennington III          Identifies if the service has encountered an error or not.
82ce8d16d9SWillam A. Kennington III      values:
83ce8d16d9SWillam A. Kennington III          - name: Success
84ce8d16d9SWillam A. Kennington III            description: >
85ce8d16d9SWillam A. Kennington III                No error has been encountered.
86ce8d16d9SWillam A. Kennington III          - name: Error
87ce8d16d9SWillam A. Kennington III            description: >
88ce8d16d9SWillam A. Kennington III                The service has encountered an error.
89*b4bae8f6SPatrick Williams
90*b4bae8f6SPatrick Williamspaths:
91*b4bae8f6SPatrick Williams    - instance: /net/poettering/calculator
92*b4bae8f6SPatrick Williams      description: Expected path of the instance.
93*b4bae8f6SPatrick Williams
94*b4bae8f6SPatrick Williamsservice_names:
95*b4bae8f6SPatrick Williams    - default: net.poettering.Calculator
96*b4bae8f6SPatrick Williams      description: Expected service name for the instance.
97