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
** 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.
69
91
** [#A] /etc/init.d/mandos-server :teddy:
70
92
** [#B] Log level :bugs:
71
93
** /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
**** DONE plugin-runner.xml
111
**** DONE plugins.d/password-prompt.xml
112
**** DONE plugins.d/password-request.xml
113
** Use xinclude for common sections
114
Like copyright, authors, etc.
119
114
*** Update initrd.img after installation
120
115
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
116
*** Keydir move: /etc/mandos -> /etc/keys/mandos
124
117
Must create in preinst if not pre-depending on cryptsetup
125
118
*** mandos-keygen
126
**** "--passfile" option
127
Using the "secfile" option instead of "secret"
128
119
**** [#A] "--test" option
129
120
For testing decryption before rebooting.