8
8
** [#B] Seperate more code to function for more readability
9
9
** [#A] Man page: man8/plugin-runner.8mandos
12
Environment is modified according to options and passed to plugins
14
12
Examples of normal usage, debug usage, debugging single or all
59
57
Must create in preinst if not pre-depending on cryptsetup
62
** [#C] Use getpass(3)?
60
** [#A] Man page: man8/password-prompt.8mandos
62
Document short options
64
Note that this is more or less a simple getpass(3) wrapper, even
65
though actual use of getpass(3) is not guaranteed.
68
Document use of "cryptsource" and "crypttarget".
72
Examples of normal usage, debug usage, with a prefix, etc.
74
Not much to do here but it is noteworthy to state the danger of
75
not having a fallback option.
77
Refer to mandos-client(8mandos) and password-request(8mandos)
78
and also, perhaps, to cryptsetup(8)?
63
80
Man page says "obsolete", but [[info:libc:getpass][GNU LibC Manual: Reading Passwords]]
64
81
does not. See also [[http://sources.redhat.com/ml/libc-alpha/2003-05/msg00251.html][Marcus Brinkmann: Re: getpass obsolete?]] and
65
82
[[http://article.gmane.org/gmane.comp.lib.glibc.alpha/4906][Petter Reinholdtsen: Re: getpass obsolete?]], and especially also
66
83
[[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?]]
86
** [#A] Config file man page: man5/mandos.conf (mandos.conf)
87
** [#A] Config file man page: man5/mandos-clients.conf (clients.conf)
69
88
** [#A] /etc/init.d/mandos-server :teddy:
70
89
** [#B] Log level :bugs:
71
90
** /etc/mandos/clients.d/*.conf
92
Go through all man pages to conform to the style of tags chosen in
93
[[http://svn.debian.org/wsvn/debian-xml-sgml/packages/docbook-xsl/trunk/debian/examples/foo.1.example_manpage.xml?op=file&rev=0&sc=0][foo.1.example_manpage.xml]]. In particular:
95
<arg> with inner <option> and <replaceable> tags
96
Unify long and short options.
97
**** DONE mandos-clients.conf.xml
98
**** DONE mandos-keygen.xml
99
**** DONE mandos.conf.xml
101
**** DONE plugin-runner.xml
102
**** DONE plugins.d/password-prompt.xml
103
**** DONE plugins.d/password-request.xml
105
Separate <term> tags with <option> and <replaceable> tags.
106
**** DONE mandos-clients.conf.xml
107
**** DONE mandos-keygen.xml
108
**** DONE mandos.conf.xml
110
**** TODO plugin-runner.xml
111
**** TODO plugins.d/password-prompt.xml
112
**** TODO plugins.d/password-request.xml
113
** Use xinclude for common sections
114
Like copyright, authors, etc.
119
111
*** Update initrd.img after installation
120
112
This seems to use some kind of "trigger" system
121
[[file:/usr/share/doc/dpkg/triggers.txt.gz]]
122
dpkg-trigger(1), deb-triggers(5)
123
113
*** Keydir move: /etc/mandos -> /etc/keys/mandos
124
114
Must create in preinst if not pre-depending on cryptsetup
125
115
*** mandos-keygen
126
**** "--passfile" option
127
Using the "secfile" option instead of "secret"
128
**** [#A] "--test" option
129
For testing decryption before rebooting.
116
**** [#A] Output cut-and-paste ready snippet for clients.conf.
131
118
*** [#A] Create mandos user and group for server
132
119
*** [#A] Create /var/run/mandos directory with perm and ownership