/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to TODO

  • Committer: Teddy Hogeborn
  • Date: 2008-08-17 22:42:28 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080817224228-nhor2yuv230if01i
* Makefile (DOCBOOKTOMAN): Use the local manpages/docbook.xsl file, do
                           not rely on a stylesheet declaration.

* mandos.xml: Removed <?xml-stylesheet>.  New entity "&OVERVIEW;"
              refers to "overview.xml". Changed all single quotes to
              double quotes for consistency.
  (DESCRIPTION): Use the term "TLS" and not "GnuTLS" for the protocol.
                 Refer to the "OVERVIEW" section for reason for IPv6
                 link-local addresses.
  (PURPOSE): Shortened a lot.  Refer to "OVERVIEW" section for details.
  (OVERVIEW): New section.  Include &OVERVIEW; and add a paragraph
              about what the role of this program is.
  (SECURITY/CLIENTS): Refer to the "CHECKING" section for details on
                      checking.
  (SEE ALSO): Changed from an <itemizedlist> to a <variablelist>.
              Added a short text for each entry.  Removed reference to
              plugin-runner(8mandos).  Add reference to RFC 4291 and
              RFC 4346.

* overview.xml: New file, containing a single <para>.  The idea is to
                use this in all the man pages.

* plugins.d/password-request.c: Updated comments about spurious
                                warnings.

Show diffs side-by-side

added added

removed removed

Lines of Context:
TODO
3
3
* [#A] README file
4
4
 
5
5
* Plugin-runner
6
 
** [#A] Free plugin name and args
7
 
   [[file:plugin-runner.c::free%20plugin_list][file:plugin-runner.c::free plugin_list]] (both places)
8
 
** [#A] Change syntax for arguments
9
6
** [#B] Add more comments to code
10
7
** [#B] Add more if(debug) calls
11
8
** [#B] Seperate more code to function for more readability
12
 
** [#B] Make free_plugin_list() function
13
9
** [#A] Man page: man8/plugin-runner.8mandos
14
 
*** DESCRIPTION
15
 
    Describe the plus sign syntax for passing options from crypttab
16
10
*** EXIT STATUS
17
11
    Text needed
18
12
*** EXAMPLES
19
13
    Examples of normal usage, debug usage, debugging single or all
20
 
    plugins, examples of crypttab lines with plus syntax, etc.
 
14
    plugins, etc.
21
15
*** FILES
22
16
    Text needed
23
17
*** SECURITY
24
18
    Text needed
25
 
*** NOTES
26
 
    Text needed
27
19
*** BUGS
28
20
    Text needed
29
21
*** SEE ALSO
30
 
    Explaining test on what you can read
31
 
** Support in configuration file for environment variables
 
22
    Explaining text on what you can read
32
23
** Keydir move: /etc/mandos -> /etc/keys/mandos
33
24
   Must create in preinst if not pre-depending on cryptsetup
34
25
 
35
26
* Password-request
36
27
** [#A] Man page: man8/password-request.8mandos
37
 
** Make prompt exactly like the normal prompt
38
 
   Use environment variables:
39
 
   "Enter passphrase to unlock the disk $cryptsource ($crypttarget): "
40
 
   [[file:plugins.d/password-prompt.c::fprintf%20stderr%20s%20Password%20prefix][Here]]
41
28
** [#B] Temporarily lower kernel log level
42
29
   for less printouts during sucessfull boot.
43
30
*** DESCRIPTION
57
44
    Create this section
58
45
*** SECURITY
59
46
    Create this section
60
 
*** NOTES
61
 
    Create this section (if needed)
62
47
*** BUGS
63
48
    Create this section
64
49
*** SEE ALSO
65
50
    Refer to mandos-client(8mandos) and password-prompt(8mandos)
 
51
*** ENVIRONMENT
 
52
    Document use of "cryptsource" and "crypttarget".
66
53
** IPv4 support
67
54
** use strsep instead of strtok?
68
55
** Do not depend on GnuPG key rings on disk
71
58
 
72
59
* Password-prompt
73
60
** [#A] Man page: man8/password-prompt.8mandos
74
 
** Show getenv("cryptsource") and getenv("crypttarget") if set
75
 
   cryptsource will be the device, like "/dev/sda3", and crypttarget
76
 
   will be the device mapper name, like "sda3_crypt".
77
61
*** DESCRIPTION
78
62
    Move options to new OPTIONS section.
 
63
    Note that this is more or less a simple getpass(3) wrapper, even
 
64
    though actual use of getpass(3) is not guaranteed.
79
65
*** EXIT STATUS
80
66
    Create this section
81
67
*** EXAMPLES
86
72
    Create this section
87
73
    Not much to do here but it is noteworthy to state the danger of
88
74
    not having a fallback option.
89
 
*** NOTES
90
 
    Note that this is more or less a simple getpass(3) wrapper, even
91
 
    though actual use of getpass(3) is not guaranteed.
92
75
*** BUGS
93
76
    Create this section
94
77
*** SEE ALSO
98
81
   does not.  See also [[http://sources.redhat.com/ml/libc-alpha/2003-05/msg00251.html][Marcus Brinkmann: Re: getpass obsolete?]] and
99
82
   [[http://article.gmane.org/gmane.comp.lib.glibc.alpha/4906][Petter Reinholdtsen: Re: getpass obsolete?]], and especially also
100
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?]]
101
 
** Replace completely with "/lib/cryptsetup/askpass"?
102
84
 
103
85
* Mandos (server)
104
86
** [#A] Command man page: man8/mandos.8
105
 
*** DESCRIPTION
106
 
    Move options to new OPTIONS section
107
 
*** EXIT STATUS
108
 
    Create this section
109
 
*** EXAMPLES
110
 
    Create this section
111
 
*** FILES
112
 
    Describe briefly that the server gets global settings from
113
 
    mandos.conf and clients from clients.conf, but refer to their man
114
 
    pages for more details.
115
 
*** DIAGNOSTICS
116
 
    Create this section
117
 
*** SECURITY
118
 
    Create this section
119
 
*** NOTES
120
 
    Create this section (if needed)
121
 
*** BUGS
122
 
    Create this section
123
 
*** SEE ALSO
124
 
    Refer to the client man page
125
87
** [#A] Config file man page: man5/mandos.conf (mandos.conf)
126
88
** [#A] Config file man page: man5/mandos-clients.conf (clients.conf)
127
89
** [#A] /etc/init.d/mandos-server               :teddy:
157
119
 
158
120
** mandos-keygen
159
121
*** [#A] Command man page: man8/mandos-keygen.8
 
122
**** EXIT STATUS
 
123
**** FILES
 
124
**** BUGS
 
125
**** EXAMPLES
 
126
**** SECURITY
160
127
*** [#A] Output cut-and-paste ready snippet for clients.conf.
161
128
 
162
129
* [#A] Package
163
130
** /usr/share/initramfs-tools/hooks/mandos
164
 
*** Do not install in initrd.img if configured not to
 
131
*** Do not install in initrd.img if configured not to.
165
132
    Use "/etc/initramfs-tools/conf.d/mandos"?  Definitely a debconf
166
133
    question.
167
134
** /etc/bash_completion.d/mandos
168
 
*** From xml sources directly?
 
135
*** From XML sources directly?
169
136
** unperish
170
137
** bzr-builddeb
171
138