/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 intro.xml

  • Committer: Teddy Hogeborn
  • Date: 2019-07-29 16:35:53 UTC
  • mto: This revision was merged to the branch mainline in revision 384.
  • Revision ID: teddy@recompile.se-20190729163553-1i442i2cbx64c537
Make tests and man page examples match

Make the tests test_manual_page_example[1-5] match exactly what is
written in the manual page, and add comments to manual page as
reminders to keep tests and manual page examples in sync.

* mandos-ctl (Test_commands_from_options.test_manual_page_example_1):
  Remove "--verbose" option, since the manual does not have it as the
  first example, and change assertion to match.
* mandos-ctl.xml (EXAMPLE): Add comments to all examples documenting
  which test function they correspond to.  Also remove unnecessary
  quotes from option arguments in fourth example, and clarify language
  slightly in fifth example.

Show diffs side-by-side

added added

removed removed

Lines of Context:
intro.xml
1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
3
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
 
<!ENTITY TIMESTAMP "2019-02-09">
 
4
<!ENTITY TIMESTAMP "2019-04-10">
5
5
<!ENTITY % common SYSTEM "common.ent">
6
6
%common;
7
7
]>
38
38
      <year>2016</year>
39
39
      <year>2017</year>
40
40
      <year>2018</year>
 
41
      <year>2019</year>
41
42
      <holder>Teddy Hogeborn</holder>
42
43
      <holder>Björn Påhlsson</holder>
43
44
    </copyright>
130
131
    </para>
131
132
    <para>
132
133
      So, at boot time, the Mandos client will ask for its encrypted
133
 
      data over the network, decrypt it to get the password, use it to
134
 
      decrypt the root file, and continue booting.
 
134
      data over the network, decrypt the data to get the password, use
 
135
      the password to decrypt the root file system, and the client can
 
136
      then continue booting.
135
137
    </para>
136
138
    <para>
137
139
      Now, of course the initial RAM disk image is not on the
143
145
      long, and will no longer give out the encrypted key.  The timing
144
146
      here is the only real weak point, and the method, frequency and
145
147
      timeout of the server’s checking can be adjusted to any desired
146
 
      level of paranoia
 
148
      level of paranoia.
147
149
    </para>
148
150
    <para>
149
151
      (The encrypted keys on the Mandos server is on its normal file