/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-09-19 13:50:22 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080919135022-214t21hetv8jgv0y
* debian/mandos-client.docs: New.  Add README and TODO file.
* debian/mandos.docs: - '' -

* debian/mandos-client.links: New.  Create plugin-runner.conf(5) link.

* debian/rules (DH_VERBOSE): Commented out.
               Removed commented-out unused dh_* stuff.  Removed
               "dh_makeshlibs".

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
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
 
 
161
133
* Copyright
162
134
 
163
135
    Copyright © 2008 Teddy Hogeborn