/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to DBUS-API

  • Committer: teddy at recompile
  • Date: 2012-01-02 01:58:41 UTC
  • Revision ID: teddy@recompile.se-20120102015841-2krpl2epdhishtpg
* mandos: Consistent terminology; use the term "secret" for the
          client's stored data.
  (ClientDBus.__init__): Removed dead code.
  (Clienthandler.handle): Bug fix: send NewRequest signal with only IP
                          address, not str() of address tuple.

Show diffs side-by-side

added added

removed removed

Lines of Context:
DBUS-API
93
93
   | Interval (a)            | t    | Read/Write | interval            |
94
94
   | LastApprovalRequest (g) | s    | Read       | N/A                 |
95
95
   | LastCheckedOK (h)       | s    | Read/Write | N/A                 |
96
 
   | LastCheckerStatus (i)   | n    | Read       | N/A                 |
97
 
   | LastEnabled (j)         | s    | Read       | N/A                 |
 
96
   | LastEnabled (i)         | s    | Read       | N/A                 |
98
97
   | Name                    | s    | Read       | (Section name)      |
99
98
   | ObjectPath              | o    | Read       | N/A                 |
100
 
   | Secret (k)              | ay   | Write      | secret (or secfile) |
 
99
   | Secret (j)              | ay   | Write      | secret (or secfile) |
101
100
   | Timeout (a)             | t    | Read/Write | timeout             |
102
101
   
103
102
   a) Represented as milliseconds.
125
124
      always use an empty string when setting this property, to allow
126
125
      for possible future expansion.
127
126
   
128
 
   i) The exit status of the last checker, -1 if it did not exit
129
 
      cleanly, -2 if a checker has not yet returned.
130
 
   
131
 
   j) The date and time this client was last enabled, as an RFC 3339
 
127
   i) The date and time this client was last enabled, as an RFC 3339
132
128
      string, or an empty string if this has not happened.
133
129
   
134
 
   k) A raw byte array, not hexadecimal digits.
 
130
   j) A raw byte array, not hexadecimal digits.
135
131
 
136
132
** Signals
137
 
*** CheckerCompleted(n: Exitcode, x: Signal, s: Command)
 
133
*** CheckerCompleted(n: Exitcode, x: Waitstatus, s: Command)
138
134
    A checker (Command) has completed.  Exitcode is either the exit
139
 
    code or -1 for abnormal exit, in which case, the signal number
140
 
    is available.
 
135
    code or -1 for abnormal exit.  In any case, the full Waitstatus
 
136
    (as from wait(2)) is also available.
141
137
    
142
138
*** CheckerStarted(s: Command)
143
139
    A checker command (Command) has just been started.
150
146
    milliseconds, depending on ApprovedByDefault.  Approve() can now
151
147
    usefully be called on this client object.
152
148
    
 
149
*** PropertyChanged(s: Property, v: Value)
 
150
    The Property on this client has changed to Value.
 
151
    
153
152
*** Rejected(s: Reason)
154
153
    This client was not given its secret for a specified Reason.
155
154
 
 
155
*** NewRequest(s: IPAddress)
 
156
    A client at IPAdress has requested its secret.
 
157
 
156
158
* Copyright
157
159
 
158
 
    Copyright © 2010-2015 Teddy Hogeborn
159
 
    Copyright © 2010-2015 Björn Påhlsson
 
160
    Copyright © 2010-2012 Teddy Hogeborn
 
161
    Copyright © 2010-2012 Björn Påhlsson
160
162
  
161
163
** License:
162
164