/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
1
-*- org -*-
2
54 by Teddy Hogeborn
Merge.
3
* [#A] README file
44 by Teddy Hogeborn
* ca.pem: Removed.
4
87 by Teddy Hogeborn
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".
5
* plugin-runner
24.1.52 by Björn Påhlsson
merge + minor adjustments
6
** [#B] Add more comments to code
7
** [#B] Add more if(debug) calls
8
** [#B] Seperate more code to function for more readability
9
** [#A] Man page: man8/plugin-runner.8mandos
24.1.41 by Björn Påhlsson
updated mandos-client sections and added see also stuff
10
*** EXIT STATUS
95 by Teddy Hogeborn
* Makefile (MANPOST): Bug fix: corrected patterns.
11
*** ENVIRONMENT
12
    Environment is modified according to options and passed to plugins
13
*** EXAMPLE
55 by Teddy Hogeborn
* TODO: More notes.
14
    Examples of normal usage, debug usage, debugging single or all
83 by Teddy Hogeborn
* Makefile (MANPOST): Bug fix: do not replace *all* "een" with "en".
15
    plugins, etc.
55 by Teddy Hogeborn
* TODO: More notes.
16
*** FILES
17
*** SECURITY
88 by Teddy Hogeborn
No code or documentation changes.
18
    Note the danger of using this program, since you might lock
19
    yourself out of your system without any means of entering the root
20
    file system password.  This is, however, very unlikely considering
21
    the fallback to getpass(3).
55 by Teddy Hogeborn
* TODO: More notes.
22
*** BUGS
23
*** SEE ALSO
82 by Teddy Hogeborn
* mandos-keygen.xml (NOTES): Removed section, since it is
24
    Explaining text on what you can read
47 by Teddy Hogeborn
* plugbasedclient.c: Renamed to "mandos-client.c". All users changed.
25
87 by Teddy Hogeborn
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".
26
* password-request
47 by Teddy Hogeborn
* plugbasedclient.c: Renamed to "mandos-client.c". All users changed.
27
** [#A] Man page: man8/password-request.8mandos
87 by Teddy Hogeborn
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".
28
*** SYNOPSIS
29
    Document short options
55 by Teddy Hogeborn
* TODO: More notes.
30
*** DESCRIPTION
31
    State that this command is not meant to be invoked directly, but
32
    is run as a plugin from mandos-client(8) and only run in the
33
    initrd environment, not the real system.
87 by Teddy Hogeborn
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".
34
*** PURPOSE
35
    As in mandos.xml
36
*** OVERVIEW
37
    As in mandos.xml
55 by Teddy Hogeborn
* TODO: More notes.
38
*** EXIT STATUS
87 by Teddy Hogeborn
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".
39
*** ENVIRONMENT
40
    Note that it does *not* currently use cryptsource or crypttarget.
41
*** FILES
42
    Describe the key files and the key ring files.  Also note that
43
    they should normally have been automatically created.
44
*** BUGS
45
*** EXAMPLE
55 by Teddy Hogeborn
* TODO: More notes.
46
    Examples of normal usage, debug usage, debugging by connecting
47
    directly, etc.
48
*** SECURITY
49
*** SEE ALSO
87 by Teddy Hogeborn
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".
50
    Update from mandos.xml
51
** [#B] Temporarily lower kernel log level
52
   for less printouts during sucessfull boot.
44 by Teddy Hogeborn
* ca.pem: Removed.
53
** IPv4 support
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
54
** use strsep instead of strtok?
73 by Teddy Hogeborn
* Makefile (COVERAGE): Change back to "--coverage".
55
** Do not depend on GnuPG key rings on disk
56
   This would mean creating new GnuPG key rings with GPGME by
57
   importing the key files from scratch on every program start.
88 by Teddy Hogeborn
No code or documentation changes.
58
** Keydir move: /etc/mandos -> /etc/keys/mandos
59
   Must create in preinst if not pre-depending on cryptsetup
47 by Teddy Hogeborn
* plugbasedclient.c: Renamed to "mandos-client.c". All users changed.
60
87 by Teddy Hogeborn
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".
61
* password-prompt
110 by Teddy Hogeborn
* mandos.xml (EXAMPLE): Replaced all occurences of command name with
62
** [#C] Use getpass(3)?
53 by Teddy Hogeborn
Merge.
63
   Man page says "obsolete", but [[info:libc:getpass][GNU LibC Manual: Reading Passwords]]
64
   does not.  See also [[http://sources.redhat.com/ml/libc-alpha/2003-05/msg00251.html][Marcus Brinkmann: Re: getpass obsolete?]] and
65
   [[http://article.gmane.org/gmane.comp.lib.glibc.alpha/4906][Petter Reinholdtsen: Re: getpass obsolete?]], and especially also
66
   [[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?]]
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
67
87 by Teddy Hogeborn
* Makefile: Bug fix: fixed creation of man pages in "plugins.d".
68
* mandos (server)
53 by Teddy Hogeborn
Merge.
69
** [#A] /etc/init.d/mandos-server		:teddy:
85 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Removed unnecessary 'choice="opt"' from <arg>
70
** [#B] Log level				:bugs:
44 by Teddy Hogeborn
* ca.pem: Removed.
71
** /etc/mandos/clients.d/*.conf
72
   Watch this directory and add/remove/update clients?
73
** config for TXT record
85 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Removed unnecessary 'choice="opt"' from <arg>
74
** [#B] Run-time communication with server	:bugs:
53 by Teddy Hogeborn
Merge.
75
   Probably using D-Bus
76
   See also [[*Mandos-tools]]
85 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Removed unnecessary 'choice="opt"' from <arg>
77
** Implement --foreground			:bugs:
47 by Teddy Hogeborn
* plugbasedclient.c: Renamed to "mandos-client.c". All users changed.
78
   [[info:standards:Option%20Table][Table of Long Options]]
79
** Implement --socket
80
   [[info:standards:Option%20Table][Table of Long Options]]
85 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Removed unnecessary 'choice="opt"' from <arg>
81
** Date+time on console log messages		:bugs:
64 by Teddy Hogeborn
* mandos-client.c (print_out_password): Strip trailing '\n'.
82
   Is this the default?
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
83
84
* Mandos-tools/utilities
85
  All of this probably using D-Bus
86
** List clients
53 by Teddy Hogeborn
Merge.
87
** Disable client
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
88
** Enable client
89
111 by Teddy Hogeborn
* mandos-clients.conf.xml (ENTITY TIMESTAMP): New. Automatically
90
* Man pages
91
** Tags
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:
115 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Split <term> tags for the "--help" and
94
*** SYNOPSIS
122 by Teddy Hogeborn
* mandos-keygen.xml (SYNOPSIS): Put long options before short.
95
    <arg> with inner <option> and <replaceable> tags
96
    Unify long and short options.
120 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Use <option> and <replaceable> tags. Unify
97
**** DONE mandos-clients.conf.xml
119 by Teddy Hogeborn
* mandos-clients.conf.xml (SYNOPSIS): Remove line breaks.
98
**** DONE mandos-keygen.xml
120 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Use <option> and <replaceable> tags. Unify
99
**** DONE mandos.conf.xml
100
**** DONE mandos.xml
121 by Teddy Hogeborn
* plugin-runner.xml (NAME): Improved wording.
101
**** DONE plugin-runner.xml
122 by Teddy Hogeborn
* mandos-keygen.xml (SYNOPSIS): Put long options before short.
102
**** DONE plugins.d/password-prompt.xml
119 by Teddy Hogeborn
* mandos-clients.conf.xml (SYNOPSIS): Remove line breaks.
103
**** DONE plugins.d/password-request.xml
115 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Split <term> tags for the "--help" and
104
*** OPTIONS
122 by Teddy Hogeborn
* mandos-keygen.xml (SYNOPSIS): Put long options before short.
105
    Separate <term> tags with <option> and <replaceable> tags.
119 by Teddy Hogeborn
* mandos-clients.conf.xml (SYNOPSIS): Remove line breaks.
106
**** DONE mandos-clients.conf.xml
123 by Teddy Hogeborn
* mandos-keygen: Minor help text change.
107
**** DONE mandos-keygen.xml
119 by Teddy Hogeborn
* mandos-clients.conf.xml (SYNOPSIS): Remove line breaks.
108
**** DONE mandos.conf.xml
124 by Teddy Hogeborn
* mandos.xml (OPTIONS): Moved long options before short. Use <option>
109
**** DONE mandos.xml
119 by Teddy Hogeborn
* mandos-clients.conf.xml (SYNOPSIS): Remove line breaks.
110
**** TODO plugin-runner.xml
111
**** TODO plugins.d/password-prompt.xml
112
**** TODO plugins.d/password-request.xml
111 by Teddy Hogeborn
* mandos-clients.conf.xml (ENTITY TIMESTAMP): New. Automatically
113
** Use xinclude for common sections
114
   Like copyright, authors, etc.
115
109 by Teddy Hogeborn
* .bzrignore: New.
116
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
117
* Installer
88 by Teddy Hogeborn
No code or documentation changes.
118
** Client-side
67 by Teddy Hogeborn
* mandos-keygen: New program to generate new client keys on
119
*** Update initrd.img after installation
86 by Teddy Hogeborn
* mandos-keygen.xml: Removed <?xml-stylesheet>. New entity
120
    This seems to use some kind of "trigger" system
109 by Teddy Hogeborn
* .bzrignore: New.
121
    [[file:/usr/share/doc/dpkg/triggers.txt.gz]]
122
    dpkg-trigger(1), deb-triggers(5)
88 by Teddy Hogeborn
No code or documentation changes.
123
*** Keydir move: /etc/mandos -> /etc/keys/mandos
124
    Must create in preinst if not pre-depending on cryptsetup
125
*** mandos-keygen
106 by Teddy Hogeborn
* mandos-clients.conf.xml (DESCRIPTION): Do not imply that this is the
126
**** "--passfile" option
127
     Using the "secfile" option instead of "secret"
97 by Teddy Hogeborn
* mandos-keygen: Bug fix: Recognize new options --subtype and
128
**** [#A] "--test" option
129
     For testing decryption before rebooting.
88 by Teddy Hogeborn
No code or documentation changes.
130
** Server-side
67 by Teddy Hogeborn
* mandos-keygen: New program to generate new client keys on
131
*** [#A] Create mandos user and group for server
132
*** [#A] Create /var/run/mandos directory with perm and ownership
133
57 by Teddy Hogeborn
* mandos (version): New variable.
134
* [#A] Package
67 by Teddy Hogeborn
* mandos-keygen: New program to generate new client keys on
135
** /usr/share/initramfs-tools/hooks/mandos
82 by Teddy Hogeborn
* mandos-keygen.xml (NOTES): Removed section, since it is
136
*** Do not install in initrd.img if configured not to.
67 by Teddy Hogeborn
* mandos-keygen: New program to generate new client keys on
137
    Use "/etc/initramfs-tools/conf.d/mandos"?  Definitely a debconf
138
    question.
55 by Teddy Hogeborn
* TODO: More notes.
139
** /etc/bash_completion.d/mandos
88 by Teddy Hogeborn
No code or documentation changes.
140
   From XML sources directly?
61 by Teddy Hogeborn
* mandos (console): Define handler globally.
141
** unperish
142
** bzr-builddeb
55 by Teddy Hogeborn
* TODO: More notes.
143
24.1.30 by Björn Påhlsson
Added more stuff to do
144
* INSTALL file
145
56 by Teddy Hogeborn
Resolving merge commit.
146
* Web site
24.1.30 by Björn Påhlsson
Added more stuff to do
147
148
* Mailing list
149
150
* Announce project on news
56 by Teddy Hogeborn
Resolving merge commit.
151
  [[news:comp.os.linux.announce]]
24.1.30 by Björn Påhlsson
Added more stuff to do
152
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
153

154
#+STARTUP: showall