6
** [#B] Add more comments to code
7
** [#B] Add more if(debug) calls
8
** [#B] Seperate more code to function for more readability
9
** [#A] Man page: man8/plugin-runner.8mandos
12
Environment is modified according to options and passed to plugins
14
Examples of normal usage, debug usage, debugging single or all
18
Note the danger of using this program, since you might lock
19
yourself out of your system without any means of entering the root
20
file system password. This is, however, very unlikely considering
21
the fallback to getpass(3).
24
Explaining text on what you can read
27
** [#A] Man page: man8/password-request.8mandos
29
Document short options
31
State that this command is not meant to be invoked directly, but
32
is run as a plugin from mandos-client(8) and only run in the
33
initrd environment, not the real system.
40
Note that it does *not* currently use cryptsource or crypttarget.
42
Describe the key files and the key ring files. Also note that
43
they should normally have been automatically created.
46
Examples of normal usage, debug usage, debugging by connecting
50
Update from mandos.xml
8
51
** [#B] Temporarily lower kernel log level
9
52
for less printouts during sucessfull boot.
16
59
Must create in preinst if not pre-depending on cryptsetup
62
** [#A] Man page: man8/password-prompt.8mandos
64
Document short options
66
Note that this is more or less a simple getpass(3) wrapper, even
67
though actual use of getpass(3) is not guaranteed.
70
Document use of "cryptsource" and "crypttarget".
74
Examples of normal usage, debug usage, with a prefix, etc.
76
Not much to do here but it is noteworthy to state the danger of
77
not having a fallback option.
79
Refer to mandos-client(8mandos) and password-request(8mandos)
80
and also, perhaps, to cryptsetup(8)?
82
Man page says "obsolete", but [[info:libc:getpass][GNU LibC Manual: Reading Passwords]]
83
does not. See also [[http://sources.redhat.com/ml/libc-alpha/2003-05/msg00251.html][Marcus Brinkmann: Re: getpass obsolete?]] and
84
[[http://article.gmane.org/gmane.comp.lib.glibc.alpha/4906][Petter Reinholdtsen: Re: getpass obsolete?]], and especially also
85
[[http://www.steve.org.uk/Reference/Unix/faq_4.html#SEC48][Unix Programming FAQ 3.1 How can I make my program not echo input?]]
88
** run gnutls_openpgp_crt_verify_self() and verify clients certificates
89
** [#A] Config file man page: man5/mandos-clients.conf (clients.conf)
90
*** For option "secret", document which program can help generate it.
21
91
** [#A] /etc/init.d/mandos-server :teddy:
22
92
** [#B] Log level :bugs:
23
93
** /etc/mandos/clients.d/*.conf
44
** Use xinclude for common sections
50
114
*** Update initrd.img after installation
51
115
This seems to use some kind of "trigger" system
52
[[file:/usr/share/doc/dpkg/triggers.txt.gz]]
53
dpkg-trigger(1), deb-triggers(5)
54
116
*** Keydir move: /etc/mandos -> /etc/keys/mandos
55
117
Must create in preinst if not pre-depending on cryptsetup
57
**** "--passfile" option
58
Using the "secfile" option instead of "secret"
59
**** [#A] "--test" option
60
For testing decryption before rebooting.
119
**** [#A] Output cut-and-paste ready snippet for clients.conf.
62
121
*** [#A] Create mandos user and group for server
63
122
*** [#A] Create /var/run/mandos directory with perm and ownership