/mandos/release

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

« back to all changes in this revision

Viewing changes to TODO

Convert some programs to use the exit codes from <sysexits.h>.  Change
all programs using the "argp" parsing functions to use them correctly;
checking return value, using argp_error() to report parse errors etc.

* plugin-runner.c: Use <sysexits.h> exit codes.  Always use fallback,
                   even on option errors, except for "--help", etc.
  (getplugin): Make sure "errno" is set correctly on return.
  (main): Declare our own "--help", "--usage", and "--version"
          options which do not cause the fallback to be invoked.
          In all other options, use fallback on any error.
  (parse_opt, parse_opt_config_file): Reset errno at start and return
                                      errno.  No need to check "arg"
                                      for NULL.  New "--help",
                                      "--usage", and "--version"
                                      options.
  (parse_opt): Accept empty string as global option.  Do not print
               errors which will be detected and reported later.  Do
               "argp_error()" on parse error or empty plugin names.
* plugins.d/mandos-client.c: Use <sysexits.h> exit codes.  Do not
                             return successful exit code on "--help",
                             etc. since this would give the wrong
                             message to "plugin-runner".
  (main): Declare our own "--help", "--usage", and "--version"
          options which do not return a successful exit code.
  (parse_opt): Reset errno at start and return errno.  Do
               "argp_error()" on parse errors.  New "--help",
               "--usage", and "--version" options.
* plugins.d/password-prompt.c: Use exit codes from <sysexits.h>.  Do
                               not return successful exit code on
                               "--help", etc. since this would give
                               the wrong message to "plugin-runner".
  (main): Declare our own "--help", "--usage", and "--version" options
          which do not return a successful exit code.  Do
          close(STDOUT_FILENO) after writing to check its return code.
  (parse_opt): Reset errno at start and return errno.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
-*- org -*-
2
2
 
3
 
* GIT
4
 
** General: [[https://www.atlassian.com/git/workflows][Git Workflows]], [[http://gitimmersion.com/][Git Immersion]], [[https://news.ycombinator.com/item?id=7036628][Simple git workflow is simple]] [[https://news.ycombinator.com/item?id=9661349][On undoing, fixing, or removing commits in git]]
5
 
** Intro: [[http://www.eyrie.org/~eagle/notes/debian/git.html#combine][Using Git for Debian Packaging]]
6
 
** Use: [[https://honk.sigxcpu.org/piki/projects/git-buildpackage/][git-buildpackage]]
7
 
** Migration
8
 
   tailor?
9
 
   Using bzr-fastimport: [[http://www.fusonic.net/en/blog/2013/03/26/migrating-from-bazaar-to-git/][Migrating from Bazaar to Git]]
10
 
** Unresolved: [[http://jameswestby.net/bzr/builddeb/user_manual/split.html][bzr builddeb split mode]]
11
 
   Maybe: [[http://honk.sigxcpu.org/projects/git-buildpackage/manual-html/gbp.import.html#GBP.IMPORT.UPSTREAM.GIT.NOTARBALL][git-buildpackage - No upstream tarballs]]
12
 
   [[http://www.python.org/dev/peps/pep-0374/][PEP 374 - Choosing a distributed VCS for the Python project]]
13
 
   [[http://www.emacswiki.org/emacs/GitForEmacsDevs][Git For Emacs Devs]]
14
 
 
15
 
* [[http://www.undeadly.org/cgi?action=article&sid=20110530221728][OpenBSD]]
16
 
 
17
 
* Testing
18
 
** python-nemu
19
 
 
20
 
* mandos-applet
21
 
 
22
3
* mandos-client
23
 
** TODO [#A] --dh-params=FILE
 
4
** TODO [#B] use scandir(3) instead of readdir(3)
 
5
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
6
** TODO use error() instead of perror()
 
7
** TODO [#B] Retry a server which has a non-definite reply:
 
8
*** A closed connection during the TLS handshake
 
9
*** A TCP timeout
24
10
** TODO [#B] Use capabilities instead of seteuid().
25
 
   https://forums.grsecurity.net/viewtopic.php?f=7&t=2522
26
 
** TODO [#B] Use getaddrinfo(hints=AI_NUMERICHOST) instead of inet_pton()
27
 
** TODO [#C] Make start_mandos_communication() take "struct server".
28
 
** TODO [#C] --interfaces=regex,eth*,noregex (bridge-utils-interfaces(5))
29
 
** TODO [#C] Remove code for GNU libc < 2.15
 
11
** TODO use EX_* from <sysexits.h>
30
12
 
31
13
* splashy
32
14
** TODO [#B] use scandir(3) instead of readdir(3)
 
15
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
16
** TODO use error() instead of perror()
33
17
 
34
 
* usplash (Deprecated)
35
 
** TODO [#A] Make it work again
 
18
* usplash
36
19
** TODO [#B] use scandir(3) instead of readdir(3)
 
20
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
21
** TODO use error() instead of perror()
 
22
** TODO use EX_* from <sysexits.h>
37
23
 
38
24
* askpass-fifo
 
25
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
26
** TODO use error() instead of perror()
 
27
** TODO [#B] Drop privileges after opening FIFO.
39
28
 
40
29
* password-prompt
41
 
** TODO [#B] lock stdin (with flock()?)
42
 
 
43
 
* plymouth
44
 
 
45
 
* TODO [#B] passdev
 
30
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
31
** TODO use error() instead of perror()
 
32
** TODO lock stdin (with flock()?)
 
33
 
 
34
* TODO passdev
46
35
 
47
36
* plugin-runner
48
 
** TODO handle printing for errors for plugins
49
 
*** Hook up stderr of plugins, buffer them, and prepend "Mandos Plugin [plugin name]"
 
37
** TODO [#B] use scandir(3) instead of readdir(3)
50
38
** TODO [#C] use same file name rules as run-parts(8)
51
 
** kernel command line option for debug info
52
 
** TODO [#C] Remove code for GNU libc < 2.15
 
39
** TODO use EX_* from <sysexits.h>
 
40
** TODO use error() instead of perror()
53
41
 
54
42
* mandos (server)
55
 
** TODO [#B] Work around Avahi issue
56
 
   Avahi does not announce link-local addresses if any global
57
 
   addresses exist: http://lists.freedesktop.org/archives/avahi/2010-March/001863.html
58
 
** TODO [#B] --notify-command
59
 
   This would allow the mandos.service to use
60
 
   --notify-command="systemd-notify --pid READY=1"
61
 
** TODO [#B] Log level                                                    :BUGS:
62
 
*** TODO /etc/mandos/clients.d/*.conf
63
 
    Watch this directory and add/remove/update clients?
64
 
** TODO [#C] config for TXT record
65
 
** TODO Log level dbus option
66
 
   SetLogLevel D-Bus call
67
 
** TODO [#C] DBusServiceObjectUsingSuper
68
 
** TODO [#B] Global enable/disable flag
69
 
** TODO [#B] By-client countdown on number of secrets given
70
 
** D-Bus Client method NeedsPassword(50) - Timeout, default disapprove
71
 
    + SetPass(u"gazonk", True) -> Approval, persistent
72
 
    + Approve(False) -> Close client connection immediately
73
 
** TODO [#C] python-parsedatetime
74
 
** TODO Separate logging logic to own object
75
 
** TODO [#A] Limit approval_delay to max gnutls/tls timeout value
76
 
** TODO [#B] break the wait on approval_delay if connection dies
77
 
** TODO Generate Client.runtime_expansions from client options + extra
78
 
** TODO Allow %%(checker)s as a runtime expansion
79
 
** TODO Use python-tlslite?
80
 
** TODO D-Bus AddClient() method on server object
81
 
** TODO Use org.freedesktop.DBus.Method.NoReply annotation on async methods. :2:
82
 
** TODO Support [[http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager][org.freedesktop.DBus.ObjectManager]] interface on server object :2:
83
 
   Deprecate methods GetAllClients(), GetAllClientsWithProperties()
84
 
   and signals ClientAdded and ClientRemoved.
85
 
** TODO Save state periodically to recover better from hard shutdowns
86
 
** TODO CheckerCompleted method, deprecate CheckedOK
87
 
** TODO Secret Service API?
88
 
   http://standards.freedesktop.org/secret-service/
89
 
** TODO Remove D-Bus interfaces with old domain name                      :2:
90
 
** TODO Remove old string_to_delta format                                    :2:
91
 
** TODO http://0pointer.de/blog/projects/stateless.html
92
 
*** tmpfiles snippet to create /var/lib/mandos with right user+perms
93
 
*** File in /usr/lib/sysusers.d to create user+group "_mandos"
94
 
** TODO Error handling on error parsing config files
95
 
** TODO init.d script error handling
96
 
** TODO D-Bus server properties; address, port, interface, etc.              :2:
97
 
** TODO [#C] In Python 3.3, use shlex.quote() instead of re.escape()
98
 
** TODO [#A] USe systemd Type=dbus
 
43
** TODO [#B] Log level                          :BUGS:
 
44
** TODO /etc/mandos/clients.d/*.conf
 
45
   Watch this directory and add/remove/update clients?
 
46
** TODO config for TXT record
 
47
** TODO [#B] Run-time communication with server :BUGS:
 
48
   Probably using D-Bus
 
49
*** Client class
 
50
*** Main server
 
51
    + SetLogLevel
 
52
      syslogger.setLevel(logging.WARNING)
 
53
    + [[http://log.ometer.com/2007-05.html][Best D-Bus practices]]
 
54
** TODO Implement --foreground                  :BUGS:
 
55
   [[info:standards:Option%20Table][Table of Long Options]]
 
56
** TODO Implement --socket
 
57
   [[info:standards:Option%20Table][Table of Long Options]]
 
58
** TODO Date+time on console log messages       :BUGS:
 
59
   Is this the default?
 
60
** TODO DBusServiceObjectUsingSuper
 
61
** TODO Global enable/disable flag
 
62
** TODO By-client countdown on secrets given
 
63
** TODO Fix problem with fsck taking a really long time
 
64
   Whenever a client successfully gets a secret it could get a
 
65
   one-time timeout boost to allow for an fsck-incurred delay
 
66
** TODO Delay before client receives key
 
67
   This would give an operator opportunity to cancel the request if
 
68
   desired.
 
69
** TODO Client manual approval mode
 
70
   A client needs manual approval on the server before it gets the
 
71
   secret
 
72
** TODO Persistent state
 
73
   /var/lib/mandos/*
99
74
 
100
75
* mandos.xml
101
 
** Add mandos contact info in manual pages
 
76
** [[file:mandos.xml::XXX][Document D-Bus interface]]
 
77
 
 
78
* Provide and install /etc/dbus-1/system.d/mandos.conf
102
79
 
103
80
* mandos-ctl
104
81
*** Handle "no D-Bus server" and/or "no Mandos server found" better
105
82
*** [#B] --dump option
106
 
** TODO Remove old string_to_delta format                                    :2:
107
83
 
108
84
* TODO mandos-dispatch
109
85
  Listens for specified D-Bus signals and spawns shell commands with
110
86
  arguments.
111
87
 
112
88
* mandos-monitor
113
 
** TODO help should be toggleable
 
89
** D-Bus main loop w/ signal receiver
114
90
** Urwid client data displayer
115
 
   Better view of client data in the listing
 
91
*** Urwid scaffolding
 
92
*** Client Widgets
116
93
*** Properties popup
117
 
** Print a nice "We are sorry" message, save stack trace to log.
118
 
** Rename module "gobject" to "GObject".
119
94
 
120
95
* mandos-keygen
 
96
** TODO Loop until passwords match when run interactively
121
97
** TODO "--secfile" option
122
98
   Using the "secfile" option instead of "secret"
123
99
** TODO [#B] "--test" option
124
100
   For testing decryption before rebooting.
125
101
 
 
102
* Makefile
 
103
** Implement DEB_BUILD_OPTIONS
 
104
   http://www.debian.org/doc/debian-policy/ch-source.html#s-debianrules-options
 
105
 
126
106
* Package
127
107
** /usr/share/initramfs-tools/hooks/mandos
128
108
*** TODO [#C] use same file name rules as run-parts(8)
129
109
*** TODO [#C] Do not install in initrd.img if configured not to.
130
110
    Use "/etc/initramfs-tools/hooksconf.d/mandos"?
131
 
** TODO [#C] $(pkg-config --variable=completionsdir bash-completion)
 
111
** TODO [#C] /etc/bash_completion.d/mandos
132
112
   From XML sources directly?
133
113
 
134
 
* Side Stuff
135
 
** TODO Locate which package moves the other bin/sh when busybox is deactivated
136
 
** TODO contact owner of package, and ask them to have that shell static in position regardless of busybox
137
 
 
138
114
 
139
115
#+STARTUP: showall