/mandos/release

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

« back to all changes in this revision

Viewing changes to overview.xml

  • Committer: Teddy Hogeborn
  • Date: 2008-08-17 22:42:28 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080817224228-nhor2yuv230if01i
* Makefile (DOCBOOKTOMAN): Use the local manpages/docbook.xsl file, do
                           not rely on a stylesheet declaration.

* mandos.xml: Removed <?xml-stylesheet>.  New entity "&OVERVIEW;"
              refers to "overview.xml". Changed all single quotes to
              double quotes for consistency.
  (DESCRIPTION): Use the term "TLS" and not "GnuTLS" for the protocol.
                 Refer to the "OVERVIEW" section for reason for IPv6
                 link-local addresses.
  (PURPOSE): Shortened a lot.  Refer to "OVERVIEW" section for details.
  (OVERVIEW): New section.  Include &OVERVIEW; and add a paragraph
              about what the role of this program is.
  (SECURITY/CLIENTS): Refer to the "CHECKING" section for details on
                      checking.
  (SEE ALSO): Changed from an <itemizedlist> to a <variablelist>.
              Added a short text for each entry.  Removed reference to
              plugin-runner(8mandos).  Add reference to RFC 4291 and
              RFC 4346.

* overview.xml: New file, containing a single <para>.  The idea is to
                use this in all the man pages.

* plugins.d/password-request.c: Updated comments about spurious
                                warnings.

Show diffs side-by-side

added added

removed removed

Lines of Context:
overview.xml
1
1
<?xml version="1.0" encoding="UTF-8"?>
2
 
<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
 
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
4
2
<para>
5
 
  This is part of the Mandos system for allowing computers to have
6
 
  encrypted root file systems and at the same time be capable of
7
 
  remote and/or unattended reboots.  The computers run a small client
8
 
  program in the initial <acronym>RAM</acronym> disk environment which
9
 
  will communicate with a server over a network.  All network
10
 
  communication is encrypted using <acronym>TLS</acronym>.  The
11
 
  clients are identified by the server using a TLS key; each client
12
 
  has one unique to it.  The server sends the clients an encrypted
13
 
  password.  The encrypted password is decrypted by the clients using
14
 
  a separate OpenPGP key, and the password is then used to unlock the
15
 
  root file system, whereupon the computers can continue booting
16
 
  normally.
 
3
  This is part of the Mandos system for allowing host computers to
 
4
  have encrypted root file systems and also be capable of remote and
 
5
  unattended reboots.  The host computers run a small client program
 
6
  in the initial RAM disk environment which will communicate with a
 
7
  server over a network.  The clients are identified by the server
 
8
  using a OpenPGP key; each client has one unique to it.  The server
 
9
  sends the clients an encrypted password.  The encrypted password is
 
10
  decrypted by the clients using the same OpenPGP key, and the
 
11
  password is then used to unlock the root file system, whereupon the
 
12
  host computers can continue booting normally.
17
13
</para>