/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

  • Committer: Teddy Hogeborn
  • Date: 2021-03-21 20:46:40 UTC
  • mto: This revision was merged to the branch mainline in revision 406.
  • Revision ID: teddy@recompile.se-20210321204640-lpsyen8jr9lw1jma
Some cleanup of GnuTLS interface

Rename opaque internal GnuTLS structures named *_int to also start
with underscore (_), as is the custom in Python programs.

Decode byte strings from UTF-8 where needed.  (Fixing, among other
things, all "DEBUG: GnuTLS" lines having a "b'" prefix in Python 3.)

Simplify calling C functions by:
1. Using the "_as_parameter_" attribute to store the ctypes object.
2. Creating and using helper classes to automatically create pointers
   or cast typed pointers to pointers to void.
3. Providing the "from_param()" method on relevant classes.

Remove "restype" attribute on C functions where "errcheck" attribute
is already set.

* mandos (gnutls.session_int): Rename to start with "_".
  (gnutls.openpgp_crt_int): - '' -
  (gnutls.Error.__init__): Decode byte string from gnutls.strerror().
  (gnutls.PointerTo): New helper class.
  (gnutls.CastToVoidPointer): - '' -
  (gnutls.With_from_param): - '' -
  (gnutls.Credentials): Inherit from "With_from_param" and store the
  ctypes object in the "_as_parameter_" attribute instead of
  "_c_object".
  (gnutls._error_code): Use "gnutls.E_SUCCESS" instead of the unadorned
  numerical constant "0".
  (gnutls._retry_on_error): - '' -
  (gnutls.priority_set_direct.argtypes): Use "ClientSession" instead
  of "session_t", and change all callers to match.
  (gnutls.init.argtypes): Use "PointerTo(ClientSession)" instead of
  "ctypes.POINTER(session_t)", and change all callers to match.
  (gnutls.set_default_priority.argtypes): Use "ClientSession" instead
  of "session_t", and change all callers to match.
  (gnutls.record_send.argtypes): - '' -
  (gnutls.certificate_allocate_credentials.argtypes): Use
  "PointerTo(Credentials)" instead of
  "ctypes.POINTER(certificate_credentials_t)", and change all callers
  to match.
  (gnutls.certificate_free_credentials.argtypes): Use "Credentials"
  instead of "certificate_credentials_t", and change all callers to
  match.
  (gnutls.handshake_set_private_extensions.argtypes): Use
  "ClientSession" instead of "session_t", and change all callers to
  match.
  (gnutls.credentials_set.argtypes): Use
  "CastToVoidPointer(Credentials)" instead of "ctypes.c_void_p", and
  change all callers to match.
  (gnutls.certificate_type_get.argtypes): Use "ClientSession" instead
  of "session_t", and change all callers to match.
  (gnutls.certificate_get_peers.argtypes): - '' -
  (gnutls.deinit.argtypes): - '' -
  (gnutls.handshake.argtypes): - '' -
  (gnutls.handshake.restype): Change from "_error_code" to
  "ctypes.c_int".
  (gnutls.transport_set_ptr.argtypes): Use "ClientSession" instead of
  "session_t", and change all callers to match.
  (gnutls.bye.argtypes): - '' -
  (gnutls.bye.restype): Change from "_error_code" to "ctypes.c_int".
  (gnutls.certificate_type_get2.argtypes): Use "ClientSession" instead
  of "session_t", and change all callers to match.
  (ClientHandler.handle): Decode "key_id" bytes to string before
  logging it in the debug log.
  (main.debug_gnutls): Decode GnuTLS log message from bytes to string
  before logging it in the debug log.

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]]
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
3
* Testing
18
4
** python-nemu
19
5
 
20
6
* mandos-applet
21
7
 
22
8
* mandos-client
23
 
** TODO [#B] Use capabilities instead of seteuid().
24
 
** TODO [#B] Use struct sockaddr_storage instead of a union
25
 
** TODO [#B] Use getaddrinfo(hints=AI_NUMERICHOST) instead of inet_pton()
26
 
** TODO [#B] Use getnameinfo(serv=NULL, NI_NUMERICHOST) instead of inet_ntop()
27
 
** TODO [#B] Prefer /run/tmp over /tmp, if it exists
28
 
** TODO [#C] Make start_mandos_communication() take "struct server".
 
9
** TODO A ~--server~ option which only adds to the server list.
 
10
   (Unlike ~--connect~, which implicitly disables ZeroConf.)
 
11
** TODO [#B] Use [[man:capabilities][capabilities]] instead of [[info:libc#Setting%20User%20ID][seteuid()]].
 
12
   [[https://forums.grsecurity.net/viewtopic.php?f=7&t=2522]]
 
13
** TODO [#B] Use ~getaddrinfo(hints=AI_NUMERICHOST)~ instead of ~inet_pton()~
 
14
** TODO [#C] Make ~start_mandos_communication()~ take ~struct server~.
 
15
** TODO [#C] ~--interfaces=regex,eth*,noregex~ [[man:bridge-utils-interfaces][bridge-utils-interfaces(5)]]
 
16
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
29
17
 
30
18
* splashy
31
 
** TODO [#B] use scandir(3) instead of readdir(3)
 
19
** TODO [#B] use [[info:libc#Scanning%20Directory%20Content][scandir(3)]] instead of [[info:libc#Reading/Closing%20Directory][readdir(3)]]
 
20
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
32
21
 
33
22
* usplash (Deprecated)
34
 
** TODO [#A] Make it work again
35
 
** TODO [#B] use scandir(3) instead of readdir(3)
 
23
** TODO [#B] Make it work again
 
24
** TODO [#B] use [[info:libc#Scanning%20Directory%20Content][scandir(3)]] instead of [[info:libc#Reading/Closing%20Directory][readdir(3)]]
 
25
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
36
26
 
37
27
* askpass-fifo
38
 
** TODO [#B] Drop privileges after opening FIFO.
 
28
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
39
29
 
40
30
* password-prompt
41
 
** TODO [#B] lock stdin (with flock()?)
 
31
** TODO [#B] lock stdin (with [[info:libc#File%20Locks][flock()]]?)
 
32
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
42
33
 
43
34
* plymouth
 
35
** TODO [#A] Detect partial writes to stdout and exit with ~EX_TEMPFAIL~
44
36
 
45
37
* TODO [#B] passdev
46
38
 
47
39
* plugin-runner
48
40
** TODO handle printing for errors for plugins
49
41
*** Hook up stderr of plugins, buffer them, and prepend "Mandos Plugin [plugin name]"
50
 
** TODO [#B] use scandir(3) instead of readdir(3)
51
 
** TODO [#C] use same file name rules as run-parts(8)
 
42
** TODO [#C] use same file name rules as [[man:run-parts][run-parts(8)]]
52
43
** kernel command line option for debug info
53
 
** TODO [#B] Use openat()
 
44
** TODO [#A] Restart plugins which exit with ~EX_TEMPFAIL~
54
45
 
55
46
* mandos (server)
 
47
** TODO [#B] ~--notify-command~
 
48
   This would allow the mandos.service to use
 
49
   ~--notify-command="systemd-notify --pid --ready"~
 
50
** TODO [#B] python-systemd
 
51
*** import systemd.daemon; systemd.daemon.notify()
56
52
** TODO [#B] Log level                                                    :BUGS:
57
53
*** TODO /etc/mandos/clients.d/*.conf
58
54
    Watch this directory and add/remove/update clients?
63
59
** TODO [#B] Global enable/disable flag
64
60
** TODO [#B] By-client countdown on number of secrets given
65
61
** D-Bus Client method NeedsPassword(50) - Timeout, default disapprove
66
 
    + SetPass(u"gazonk", True) -> Approval, persistent
 
62
    + SetPass("gazonk", True) -> Approval, persistent
67
63
    + Approve(False) -> Close client connection immediately
68
64
** TODO [#C] python-parsedatetime
69
65
** TODO Separate logging logic to own object
70
 
** TODO [#A] Limit approval_delay to max gnutls/tls timeout value
71
 
** TODO [#B] break the wait on approval_delay if connection dies
72
 
** TODO Generate Client.runtime_expansions from client options + extra
 
66
** TODO [#B] Limit ~approval_delay~ to max GnuTLS/TLS timeout value
 
67
** TODO [#B] break the wait on ~approval_delay~ if connection dies
 
68
** TODO Generate ~Client.runtime_expansions~ from client options + extra
73
69
** TODO Allow %%(checker)s as a runtime expansion
74
 
** TODO Use python-tlslite?
75
70
** TODO D-Bus AddClient() method on server object
76
71
** TODO Use org.freedesktop.DBus.Method.NoReply annotation on async methods. :2:
77
 
** TODO Emit [[http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-properties][org.freedesktop.DBus.Properties.PropertiesChanged]] signal         :2:
78
 
   TODO Deprecate se.recompile.Mandos.Client.PropertyChanged - annotate!
79
 
   TODO Can use "invalidates" annotation to also emit on changed secret.
80
 
** TODO Support [[http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager][org.freedesktop.DBus.ObjectManager]] interface on server object :2:
81
 
   Deprecate methods GetAllClients(), GetAllClientsWithProperties()
82
 
   and signals ClientAdded and ClientRemoved.
83
72
** TODO Save state periodically to recover better from hard shutdowns
84
73
** TODO CheckerCompleted method, deprecate CheckedOK
85
 
** TODO Secret Service API?
86
 
   http://standards.freedesktop.org/secret-service/
 
74
** TODO [[https://standards.freedesktop.org/secret-service/][Secret Service]] API?
87
75
** TODO Remove D-Bus interfaces with old domain name                      :2:
88
 
** TODO Remove old string_to_delta format                                 :2:
89
 
** TODO --no-zeroconf (only valid if port or socket is set)
90
 
 
91
 
* mandos.xml
92
 
** Add mandos contact info in manual pages
 
76
** TODO Remove old ~string_to_delta~ format                               :2:
 
77
** TODO http://0pointer.de/blog/projects/stateless.html
 
78
*** File in /usr/lib/sysusers.d to create user+group "~_mandos~"
 
79
** TODO Error handling on error parsing config files
 
80
** TODO init.d script error handling
 
81
** TODO D-Bus server properties; address, port, interface, etc.           :2:
93
82
 
94
83
* mandos-ctl
95
 
*** Handle "no D-Bus server" and/or "no Mandos server found" better
96
 
*** [#B] --dump option
97
84
** TODO Remove old string_to_delta format                                 :2:
98
85
 
99
86
* TODO mandos-dispatch
101
88
  arguments.
102
89
 
103
90
* mandos-monitor
 
91
** TODO ~--servicename~                                                :BUGS:
104
92
** TODO help should be toggleable
105
93
** Urwid client data displayer
106
94
   Better view of client data in the listing
107
95
*** Properties popup
108
96
** Print a nice "We are sorry" message, save stack trace to log.
109
 
** Rename module "gobject" to "GObject".
110
97
 
111
98
* mandos-keygen
112
 
** TODO "--secfile" option
 
99
** TODO "~--secfile~" option
113
100
   Using the "secfile" option instead of "secret"
114
 
** TODO [#B] "--test" option
 
101
** TODO [#B] "~--test~" option
115
102
   For testing decryption before rebooting.
116
103
 
117
 
* Makefile
118
 
** TODO [#C] Implement DEB_BUILD_OPTIONS
119
 
   http://www.debian.org/doc/debian-policy/ch-source.html#s-debianrules-options
120
 
 
121
104
* Package
122
105
** /usr/share/initramfs-tools/hooks/mandos
123
 
*** TODO [#C] use same file name rules as run-parts(8)
 
106
*** TODO [#C] use same file name rules as [[man:run-parts][run-parts(8)]]
124
107
*** TODO [#C] Do not install in initrd.img if configured not to.
125
108
    Use "/etc/initramfs-tools/hooksconf.d/mandos"?
126
 
** TODO [#C] /etc/bash_completion.d/mandos
 
109
** TODO [#C] ~$(pkg-config --variable=completionsdir bash-completion)~
127
110
   From XML sources directly?
128
111
 
129
112
* Side Stuff
130
113
** TODO Locate which package moves the other bin/sh when busybox is deactivated
131
114
** TODO contact owner of package, and ask them to have that shell static in position regardless of busybox
132
115
 
 
116
* [[http://www.undeadly.org/cgi?action=article&sid=20110530221728][OpenBSD]]
 
117
 
133
118
 
134
119
#+STARTUP: showall
 
120
#+FILETAGS: :mandos: