/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-30 07:23:39 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080930072339-jn15gyrtfpdk2dhx
* .bzrignore: Added "man" directory (created by "make install-html").

* Makefile: Add "common.ent" dependency to all manual pages.
  (htmldir, version, SED): New variables.
  (CFLAGS): Add -D option to define VERSION to $(version).
  (MANPOST, HTMLPOST): Use $(SED).
  (PROGS): Use $(CPROGS)
  (CPROGS): New; C-only programs.
  (objects): Use $(CPROGS).
  (common.ent, mandos, mandos-keygen): New targets; update version
                                       number to $(version).
  (clean): Use $(CPROGS).
  (check): Depend on "all".
  (install-html): Install to $(htmldir).

* common.ent: New file with "version" entity.

* mandos-clients.conf.xml: Use "common.ent".
* mandos-keygen.xml: - '' -
* mandos.conf.xml: - '' -
* mandos.xml: - '' -
* plugin-runner.xml: - '' -
* plugins.d/mandos-client.xml: - '' -
* plugins.d/password-prompt.xml: - '' -

* plugin-runner.c (argp_program_version): Use VERSION.
* plugins.d/mandos-client.c (argp_program_version): - '' -
* plugins.d/password-prompt.c (argp_program_version): - '' -

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
99
99
   Multiple Mandos servers can coexist on a network without any
100
100
   trouble.  They do not clash, and clients will try all available
101
101
   servers.  This means that if just one reboots then the other can
102
 
   bring it back up, but if both reboot at the same time they will
 
102
   bring it back up, but if both reboots at the same time they will
103
103
   stay down until someone types in the password on one of them.
104
104
 
105
105
** Faking ping replies?
134
134
  In the early designs, the mandos-client(8mandos) program (which
135
135
  retrieves a password from the Mandos server) also prompted for a
136
136
  password on the terminal, in case a Mandos server could not be
137
 
  found.  Other ways of retrieving a password could easily be
138
 
  envisoned, but this multiplicity of purpose was seen to be too
139
 
  complex to be a viable way to continue.  Instead, the original
140
 
  program was separated into mandos-client(8mandos) and
141
 
  password-prompt(8mandos), and a plugin-runner(8mandos) exist to run
142
 
  them both in parallel, allowing the first successful plugin to
143
 
  provide the password.  This opened up for any number of additional
144
 
  plugins to run, all competing to be the first to find a password and
145
 
  provide it to the plugin runner.
 
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.
146
144
  
147
 
  Four additional plugins are provided:
148
 
  * plymouth(8mandos)
149
 
    This prompts for a password when using plymouth(8).
150
 
  * usplash(8mandos)
 
145
  Three additional plugins are provided:
 
146
  * usplash
151
147
    This prompts for a password when using usplash(8).
152
 
  * splashy(8mandos)
 
148
  * splashy
153
149
    This prompts for a password when using splashy(8).
154
 
  * askpass-fifo(8mandos)
 
150
  * askpass-fifo
155
151
    To provide compatibility with the "askpass" program from
156
152
    cryptsetup, this plugin listens to the same FIFO as askpass would
157
153
    do.
158
154
  
159
 
  More plugins can easily be written and added by the system
 
155
  (None of these take any options or reads any files.)
 
156
  
 
157
  More plugins could easily be written and added by the system
160
158
  administrator; see the section called "WRITING PLUGINS" in
161
159
  plugin-runner(8mandos) to learn the plugin requirements.
162
160
 
163
161
* Copyright
164
162
 
165
 
    Copyright © 2008-2011 Teddy Hogeborn
166
 
    Copyright © 2008-2011 Björn Påhlsson
 
163
    Copyright © 2008 Teddy Hogeborn
 
164
                2008 Björn Påhlsson
167
165
  
168
166
** License:
169
167
   
180
178
   You should have received a copy of the GNU General Public License
181
179
   along with this program.  If not, see
182
180
   <http://www.gnu.org/licenses/>.
183
 
 
184
 
 
185
 
#+STARTUP: showall