/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
95
    <arg> with inner <replaceable> and <option> tags
120 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Use <option> and <replaceable> tags. Unify
96
**** DONE mandos-clients.conf.xml
119 by Teddy Hogeborn
* mandos-clients.conf.xml (SYNOPSIS): Remove line breaks.
97
**** DONE mandos-keygen.xml
120 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Use <option> and <replaceable> tags. Unify
98
**** DONE mandos.conf.xml
99
**** DONE mandos.xml
121 by Teddy Hogeborn
* plugin-runner.xml (NAME): Improved wording.
100
**** DONE plugin-runner.xml
120 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Use <option> and <replaceable> tags. Unify
101
**** TODO plugins.d/password-prompt.xml
119 by Teddy Hogeborn
* mandos-clients.conf.xml (SYNOPSIS): Remove line breaks.
102
**** DONE plugins.d/password-request.xml
115 by Teddy Hogeborn
* mandos.xml (SYNOPSIS): Split <term> tags for the "--help" and
103
*** OPTIONS
104
    Separate <term> tags with <option> and <replaceable> tags
119 by Teddy Hogeborn
* mandos-clients.conf.xml (SYNOPSIS): Remove line breaks.
105
**** DONE mandos-clients.conf.xml
106
**** TODO mandos-keygen.xml
107
**** DONE mandos.conf.xml
108
**** TODO mandos.xml
109
**** TODO plugin-runner.xml
110
**** TODO plugins.d/password-prompt.xml
111
**** TODO plugins.d/password-request.xml
111 by Teddy Hogeborn
* mandos-clients.conf.xml (ENTITY TIMESTAMP): New. Automatically
112
** Use xinclude for common sections
113
   Like copyright, authors, etc.
114
109 by Teddy Hogeborn
* .bzrignore: New.
115
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
116
* Installer
88 by Teddy Hogeborn
No code or documentation changes.
117
** Client-side
67 by Teddy Hogeborn
* mandos-keygen: New program to generate new client keys on
118
*** Update initrd.img after installation
86 by Teddy Hogeborn
* mandos-keygen.xml: Removed <?xml-stylesheet>. New entity
119
    This seems to use some kind of "trigger" system
109 by Teddy Hogeborn
* .bzrignore: New.
120
    [[file:/usr/share/doc/dpkg/triggers.txt.gz]]
121
    dpkg-trigger(1), deb-triggers(5)
88 by Teddy Hogeborn
No code or documentation changes.
122
*** Keydir move: /etc/mandos -> /etc/keys/mandos
123
    Must create in preinst if not pre-depending on cryptsetup
124
*** mandos-keygen
106 by Teddy Hogeborn
* mandos-clients.conf.xml (DESCRIPTION): Do not imply that this is the
125
**** "--passfile" option
126
     Using the "secfile" option instead of "secret"
97 by Teddy Hogeborn
* mandos-keygen: Bug fix: Recognize new options --subtype and
127
**** [#A] "--test" option
128
     For testing decryption before rebooting.
88 by Teddy Hogeborn
No code or documentation changes.
129
** Server-side
67 by Teddy Hogeborn
* mandos-keygen: New program to generate new client keys on
130
*** [#A] Create mandos user and group for server
131
*** [#A] Create /var/run/mandos directory with perm and ownership
132
57 by Teddy Hogeborn
* mandos (version): New variable.
133
* [#A] Package
67 by Teddy Hogeborn
* mandos-keygen: New program to generate new client keys on
134
** /usr/share/initramfs-tools/hooks/mandos
82 by Teddy Hogeborn
* mandos-keygen.xml (NOTES): Removed section, since it is
135
*** Do not install in initrd.img if configured not to.
67 by Teddy Hogeborn
* mandos-keygen: New program to generate new client keys on
136
    Use "/etc/initramfs-tools/conf.d/mandos"?  Definitely a debconf
137
    question.
55 by Teddy Hogeborn
* TODO: More notes.
138
** /etc/bash_completion.d/mandos
88 by Teddy Hogeborn
No code or documentation changes.
139
   From XML sources directly?
61 by Teddy Hogeborn
* mandos (console): Define handler globally.
140
** unperish
141
** bzr-builddeb
55 by Teddy Hogeborn
* TODO: More notes.
142
24.1.30 by Björn Påhlsson
Added more stuff to do
143
* INSTALL file
144
56 by Teddy Hogeborn
Resolving merge commit.
145
* Web site
24.1.30 by Björn Påhlsson
Added more stuff to do
146
147
* Mailing list
148
149
* Announce project on news
56 by Teddy Hogeborn
Resolving merge commit.
150
  [[news:comp.os.linux.announce]]
24.1.30 by Björn Påhlsson
Added more stuff to do
151
36 by Teddy Hogeborn
* TODO: Converted to org-mode style
152

153
#+STARTUP: showall