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-clients.conf.xml
97
**** DONE mandos-keygen.xml
98
**** DONE mandos.conf.xml
100
**** DONE plugin-runner.xml
101
**** TODO plugins.d/password-prompt.xml
102
**** DONE plugins.d/password-request.xml
104
Separate <term> tags with <option> and <replaceable> tags
105
**** DONE mandos-clients.conf.xml
106
**** TODO mandos-keygen.xml
107
**** DONE mandos.conf.xml
109
**** TODO plugin-runner.xml
110
**** TODO plugins.d/password-prompt.xml
111
**** TODO plugins.d/password-request.xml
112
** Use xinclude for common sections
113
Like copyright, authors, etc.
118
113
*** Update initrd.img after installation
119
114
This seems to use some kind of "trigger" system
120
[[file:/usr/share/doc/dpkg/triggers.txt.gz]]
121
dpkg-trigger(1), deb-triggers(5)
122
115
*** Keydir move: /etc/mandos -> /etc/keys/mandos
123
116
Must create in preinst if not pre-depending on cryptsetup
124
117
*** mandos-keygen
125
**** "--passfile" option
126
Using the "secfile" option instead of "secret"
127
118
**** [#A] "--test" option
128
119
For testing decryption before rebooting.