/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: 2019-07-29 16:35:53 UTC
  • Revision ID: teddy@recompile.se-20190729163553-1i442i2cbx64c537
Make tests and man page examples match

Make the tests test_manual_page_example[1-5] match exactly what is
written in the manual page, and add comments to manual page as
reminders to keep tests and manual page examples in sync.

* mandos-ctl (Test_commands_from_options.test_manual_page_example_1):
  Remove "--verbose" option, since the manual does not have it as the
  first example, and change assertion to match.
* mandos-ctl.xml (EXAMPLE): Add comments to all examples documenting
  which test function they correspond to.  Also remove unnecessary
  quotes from option arguments in fourth example, and clarify language
  slightly in fifth example.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
-*- org -*-
2
2
 
3
 
* Use _attribute_((nonnull)) wherever possible.
 
3
* Testing
 
4
** python-nemu
4
5
 
5
6
* mandos-applet
6
7
 
7
 
* Convert README into intro(8mandos) man page
8
 
 
9
8
* mandos-client
10
 
** TODO [#B] use scandir(3) instead of readdir(3)
11
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
12
 
** TODO [#B] Retry a server which has a non-definite reply:
13
 
*** A closed connection during the TLS handshake
14
 
*** A TCP timeout
 
9
** TODO A --server option which only adds to the server list.
 
10
   (Unlike --connect, which implicitly disables zeroconf.)
15
11
** TODO [#B] Use capabilities instead of seteuid().
16
 
** TODO [#A] Retry --connect forever
17
 
** TODO [#B] Use struct sockaddr_storage instead of a union
 
12
   https://forums.grsecurity.net/viewtopic.php?f=7&t=2522
18
13
** TODO [#B] Use getaddrinfo(hints=AI_NUMERICHOST) instead of inet_pton()
19
 
** TODO [#B] Use getnameinfo(serv=NULL, NI_NUMERICHOST) instead of inet_ntop()
20
 
** TODO [#B] Accept [] around IPv6 address in --connect option; see [[http://tools.ietf.org/html/rfc5952][RFC 5952 - A Recommendation for IPv6 Address Text Representation]]
 
14
** TODO [#C] Make start_mandos_communication() take "struct server".
 
15
** TODO [#C] --interfaces=regex,eth*,noregex (bridge-utils-interfaces(5))
 
16
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
 
17
** TODO [#B] Use reallocarray() with GNU LibC 2.29 or later.
21
18
 
22
19
* splashy
23
20
** TODO [#B] use scandir(3) instead of readdir(3)
24
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
 
21
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
25
22
 
26
 
* usplash
27
 
** TODO [#A] Make it work again
 
23
* usplash (Deprecated)
 
24
** TODO [#B] Make it work again
28
25
** TODO [#B] use scandir(3) instead of readdir(3)
29
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
30
 
** TODO Use [[info:libc:Argz%20Functions][argz_extract]]
 
26
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
31
27
 
32
28
* askpass-fifo
33
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
34
 
** TODO [#B] Drop privileges after opening FIFO.
 
29
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
35
30
 
36
31
* password-prompt
37
 
** TODO [#B] Prefix all debug output with "Mandos plugin " + program_invocation_short_name
38
32
** TODO [#B] lock stdin (with flock()?)
39
 
** TODO [#A] Free direntries after scandir()
 
33
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
40
34
 
41
35
* plymouth
42
 
** TODO [#A] Free direntries after scandir()
 
36
** TODO [#A] Detect partial writes to stdout and exit with EX_TEMPFAIL
 
37
** TODO [#B] Use reallocarray() with GNU LibC 2.29 or later.
43
38
 
44
39
* TODO [#B] passdev
45
40
 
46
41
* plugin-runner
47
 
** TODO [#B] use scandir(3) instead of readdir(3)
 
42
** TODO handle printing for errors for plugins
 
43
*** Hook up stderr of plugins, buffer them, and prepend "Mandos Plugin [plugin name]"
48
44
** TODO [#C] use same file name rules as run-parts(8)
49
45
** kernel command line option for debug info
50
 
** TODO [#B] Use openat()
 
46
** TODO [#A] Restart plugins which exit with EX_TEMPFAIL
51
47
 
52
48
* mandos (server)
 
49
** TODO [#B] --notify-command
 
50
   This would allow the mandos.service to use
 
51
   --notify-command="systemd-notify --pid --ready"
 
52
** TODO [#B] python-systemd
 
53
*** import systemd.daemon; systemd.daemon.notify()
53
54
** TODO [#B] Log level                                                    :BUGS:
54
 
** TODO Persistent state                                                  :BUGS:
55
 
   /var/lib/mandos/*
56
55
*** TODO /etc/mandos/clients.d/*.conf
57
56
    Watch this directory and add/remove/update clients?
58
57
** TODO [#C] config for TXT record
59
 
** TODO Log level option
60
 
   syslogger.setLevel(logging.WARNING)
61
 
   + SetLogLevel D-Bus call
62
 
** TODO Implement --foreground                                            :BUGS:
63
 
   [[info:standards:Option%20Table][Table of Long Options]]
64
 
** TODO Implement --socket
65
 
   [[info:standards:Option%20Table][Table of Long Options]]
66
 
** TODO Date+time on console log messages                                 :BUGS:
67
 
   Is this the default?
 
58
** TODO Log level dbus option
 
59
   SetLogLevel D-Bus call
68
60
** TODO [#C] DBusServiceObjectUsingSuper
69
61
** TODO [#B] Global enable/disable flag
70
 
** TODO [#B] By-client countdown on secrets given
71
 
** TODO [#B] Fix problem with fsck taking a really long time
72
 
   Whenever a client successfully gets a secret it could get a
73
 
   one-time timeout boost to allow for an fsck-incurred delay
74
 
** TODO [#A] Delay before client receives key
75
 
   This would give an operator opportunity to cancel the request if
76
 
   desired.
77
 
** TODO [#A] Client manual approval mode
78
 
   A client needs manual approval on the server before it gets the
79
 
   secret
80
 
** TODO [#B] Support RFC 3339 time duration syntax
81
 
** More D-Bus methods
82
 
*** NeedsApproval(50, True) -> timeout, default approve
83
 
    Default approval is configurable, but True by default
84
 
    + Approve(True) -> approve sending saved
85
 
    + Approve(False) -> Close client connection immediately
86
 
*** NeedsPassword(50) - Timeout, default disapprove
 
62
** TODO [#B] By-client countdown on number of secrets given
 
63
** D-Bus Client method NeedsPassword(50) - Timeout, default disapprove
87
64
    + SetPass(u"gazonk", True) -> Approval, persistent
88
65
    + Approve(False) -> Close client connection immediately
89
66
** TODO [#C] python-parsedatetime
90
 
** TODO [#C] systemd/launchd
91
 
   http://0pointer.de/blog/projects/systemd.html
92
67
** TODO Separate logging logic to own object
93
 
** TODO make clients to a dict!
94
 
** TODO [#A] Limit approval_delay to max gnutls/tls timeout value
 
68
** TODO [#B] Limit approval_delay to max gnutls/tls timeout value
95
69
** TODO [#B] break the wait on approval_delay if connection dies
96
70
** TODO Generate Client.runtime_expansions from client options + extra
97
71
** TODO Allow %%(checker)s as a runtime expansion
98
 
** TODO Use python-tlslite?
99
 
 
100
 
* mandos.xml
101
 
** Add mandos contact info in manual pages
 
72
** TODO D-Bus AddClient() method on server object
 
73
** TODO Use org.freedesktop.DBus.Method.NoReply annotation on async methods. :2:
 
74
** TODO Save state periodically to recover better from hard shutdowns
 
75
** TODO CheckerCompleted method, deprecate CheckedOK
 
76
** TODO Secret Service API?
 
77
   https://standards.freedesktop.org/secret-service/
 
78
** TODO Remove D-Bus interfaces with old domain name                      :2:
 
79
** TODO Remove old string_to_delta format                                 :2:
 
80
** TODO http://0pointer.de/blog/projects/stateless.html
 
81
*** File in /usr/lib/sysusers.d to create user+group "_mandos"
 
82
** TODO Error handling on error parsing config files
 
83
** TODO init.d script error handling
 
84
** TODO D-Bus server properties; address, port, interface, etc.           :2:
 
85
** Python 3                                                               :2:
 
86
*** TODO [#C] In Python 3.3, use shlex.quote() instead of re.escape()
102
87
 
103
88
* mandos-ctl
104
 
*** Handle "no D-Bus server" and/or "no Mandos server found" better
105
 
*** [#B] --dump option
106
 
** TODO Support RFC 3339 time duration syntax
 
89
** TODO Remove old string_to_delta format                                 :2:
107
90
 
108
91
* TODO mandos-dispatch
109
92
  Listens for specified D-Bus signals and spawns shell commands with
110
93
  arguments.
111
94
 
112
95
* mandos-monitor
113
 
** TODO help should be toggable
 
96
** TODO --servicename                                                  :BUGS:
 
97
** TODO help should be toggleable
114
98
** Urwid client data displayer
115
99
   Better view of client data in the listing
116
100
*** Properties popup
117
 
** Nicer crashes. Stack traces Messes up shell.
118
 
*** Print a nice "We are sorry" message, save stack trace to log.
119
 
** Show timeout countdown for approval
 
101
** Print a nice "We are sorry" message, save stack trace to log.
120
102
 
121
103
* mandos-keygen
122
 
** TODO Loop until passwords match when run interactively
123
104
** TODO "--secfile" option
124
105
   Using the "secfile" option instead of "secret"
125
106
** TODO [#B] "--test" option
126
107
   For testing decryption before rebooting.
127
108
 
128
 
* Makefile
129
 
** TODO Add "--Xlinker --as-needed"
130
 
   http://udrepper.livejournal.com/19395.html
131
 
** TODO [#C] Implement DEB_BUILD_OPTIONS
132
 
   http://www.debian.org/doc/debian-policy/ch-source.html#s-debianrules-options
133
 
 
134
109
* Package
135
110
** /usr/share/initramfs-tools/hooks/mandos
136
111
*** TODO [#C] use same file name rules as run-parts(8)
137
112
*** TODO [#C] Do not install in initrd.img if configured not to.
138
113
    Use "/etc/initramfs-tools/hooksconf.d/mandos"?
139
 
** TODO [#C] /etc/bash_completion.d/mandos
 
114
** TODO [#C] $(pkg-config --variable=completionsdir bash-completion)
140
115
   From XML sources directly?
141
116
 
142
117
* Side Stuff
143
 
** TODO Locate which packet move the other bin/sh when busy box is deactivated
144
 
** TODO contact owner of packet, and ask them to have that shell static in position regardless of busybox
 
118
** TODO Locate which package moves the other bin/sh when busybox is deactivated
 
119
** TODO contact owner of package, and ask them to have that shell static in position regardless of busybox
 
120
 
 
121
* [[http://www.undeadly.org/cgi?action=article&sid=20110530221728][OpenBSD]]
145
122
 
146
123
 
147
124
#+STARTUP: showall