59
59
Must create in preinst if not pre-depending on cryptsetup
62
** [#C] Use getpass(3)?
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)?
63
82
Man page says "obsolete", but [[info:libc:getpass][GNU LibC Manual: Reading Passwords]]
64
83
does not. See also [[http://sources.redhat.com/ml/libc-alpha/2003-05/msg00251.html][Marcus Brinkmann: Re: getpass obsolete?]] and
65
84
[[http://article.gmane.org/gmane.comp.lib.glibc.alpha/4906][Petter Reinholdtsen: Re: getpass obsolete?]], and especially also
66
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
** [#A] Config file man page: man5/mandos-clients.conf (clients.conf)
89
*** For option "secret", document which program can help generate it.
69
90
** [#A] /etc/init.d/mandos-server :teddy:
70
91
** [#B] Log level :bugs:
71
92
** /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 <replaceable> and <option> tags
96
**** DONE mandos-keygen.xml
97
**** DONE plugins.d/password-request.xml
98
**** TODO mandos.conf.xml
100
**** TODO plugin-runner.xml
101
**** TODO plugins.d/password-prompt.xml
103
Separate <term> tags with <option> and <replaceable> tags
104
**** DONE mandos-clients.conf.xml
105
**** TODO mandos-keygen.xml
106
**** DONE mandos.conf.xml
108
**** TODO plugin-runner.xml
109
**** TODO plugins.d/password-prompt.xml
110
**** TODO plugins.d/password-request.xml
111
** Use xinclude for common sections
112
Like copyright, authors, etc.
117
113
*** Update initrd.img after installation
118
114
This seems to use some kind of "trigger" system
119
[[file:/usr/share/doc/dpkg/triggers.txt.gz]]
120
dpkg-trigger(1), deb-triggers(5)
121
115
*** Keydir move: /etc/mandos -> /etc/keys/mandos
122
116
Must create in preinst if not pre-depending on cryptsetup
123
117
*** mandos-keygen
124
**** "--passfile" option
125
Using the "secfile" option instead of "secret"
126
**** [#A] "--test" option
127
For testing decryption before rebooting.
118
**** [#A] Output cut-and-paste ready snippet for clients.conf.
129
120
*** [#A] Create mandos user and group for server
130
121
*** [#A] Create /var/run/mandos directory with perm and ownership