/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 README

  • Committer: Teddy Hogeborn
  • Date: 2008-12-29 02:44:54 UTC
  • Revision ID: teddy@fukt.bsnet.se-20081229024454-nbsei556dwy5azr1
* mandos (Client.timeout, Client.interval): Changed from being a
                                            property to be a normal
                                            attribute.
  (Client._timeout, Client._interval): Removed.
  (Client._timeout_milliseconds): Changed from being an attribute to
                                  be a method "timeout_milliseconds".
                                  All users changed.
  (Client._interval_milliseconds): Changed from being an attribute to
                                   be method "interval_milliseconds".
                                   All users changed.
  (Client.__init__): Take additional "use_dbus" keyword argument.
                     Only provide D-Bus interface if "use_dbus" is
                     True.
  (Client.use_dbus): New attribute.
  (Client.dbus_object_path): Changed to only be set if "self.use_dbus"
                             is True.
  (Client.enable, Client.disable, Client.checker_callback,
  Client.bump_timeout, Client.start_checker, Client.stop_checker):
  Only emit D-Bus signals if "self.use_dbus".
  (Client.SetChecker, Client.SetHost, Client.Enable): Bug fix: Emit
                                                      D-Bus signals.
  (Client.SetInterval, Client.SetTimeout): Changed to emit D-Bus
                                           signals.

  (main): Remove deprecated "default" keyword argument to "--check"
          option.  Added new "--no-dbus" option.  Added corresponding
          "use_dbus" server configuration option.  Only provide D-Bus
          interface and emit D-Bus signals if "use_dbus".  Pass
          "use_dbus" on to Client constructor.

* mandos-options.xml ([@id="dbus"]): New option.

* mandos.conf (use_dbus): New option.

* mandos.conf.xml (OPTIONS): New option "use_dbus".
  (EXAMPLE): - '' -

* mandos.xml (SYNOPSIS): New option "--no-dbus".
  (D-BUS INTERFACE): New section.

Show diffs side-by-side

added added

removed removed

Lines of Context:
130
130
  on your door and the sudden absence of all the servers in your
131
131
  server room.  Which it does nicely.
132
132
 
 
133
* The Plugin System
 
134
  In the early designs, the mandos-client(8mandos) program (which
 
135
  retrieves a password from the Mandos server) also prompted for a
 
136
  password on the terminal, in case a Mandos server could not be
 
137
  found.  This duality of purpose was seen to be too complex to be a
 
138
  viable way to continue.  Instead, the programs are now separated
 
139
  into mandos-client(8mandos) and password-prompt(8mandos), and a
 
140
  plugin-runner(8mandos) exist to run them both in parallel, allowing
 
141
  the first plugin to succeed to provide the password.  This opened up
 
142
  for any number of additional plugins to run, all competing to be the
 
143
  first to find a password and provide it to the plugin runner.
 
144
  
 
145
  Three additional plugins are provided:
 
146
  * usplash(8mandos)
 
147
    This prompts for a password when using usplash(8).
 
148
  * splashy(8mandos)
 
149
    This prompts for a password when using splashy(8).
 
150
  * askpass-fifo(8mandos)
 
151
    To provide compatibility with the "askpass" program from
 
152
    cryptsetup, this plugin listens to the same FIFO as askpass would
 
153
    do.
 
154
  
 
155
  (None of these take any options or reads any files.)
 
156
  
 
157
  More plugins could easily be written and added by the system
 
158
  administrator; see the section called "WRITING PLUGINS" in
 
159
  plugin-runner(8mandos) to learn the plugin requirements.
 
160
 
133
161
* Copyright
134
162
 
135
163
    Copyright © 2008 Teddy Hogeborn
136
 
                2008 Björn Påhlsson
 
164
    Copyright © 2008 Björn Påhlsson
137
165
  
138
166
** License:
139
167