/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 INSTALL

  • Committer: Teddy Hogeborn
  • Date: 2016-02-28 10:59:18 UTC
  • Revision ID: teddy@recompile.se-20160228105918-tb8pt2p5j0tkcls3
Handle GnuTLS errors and partial sends in gnutls "module".

* mandos (GnuTLS.E_INTERRUPTED, GnuTLS.E_AGAIN): New.
  (GnuTLS.Error): Set error code as "code" attribute.
  (GnuTLS.ClientSession.send): Handle partial sends with a loop.
  (GnuTLS._retry_on_error): New function.
  (GnuTLS.record_send, GnuTLS.handshake, GnuTLS.bye): Set "errcheck"
                                                      attribute to
                                                    "_retry_on_error".
  (ClientHandler.handle): Remove loop for handling partial sends;
                          GnuTLS.ClientSession.send() will do that.

Show diffs side-by-side

added added

removed removed

Lines of Context:
38
38
    "man -l mandos.8".
39
39
    
40
40
*** Mandos Server
41
 
    + GnuTLS 3.3          https://www.gnutls.org/
42
 
      (but not 3.6.0 or later, until 3.6.6, which works)
 
41
    + GnuTLS 3.3          http://www.gnutls.org/
43
42
    + Avahi 0.6.16        http://www.avahi.org/
44
43
    + Python 2.7          https://www.python.org/
45
 
    + dbus-python 0.82.4 https://dbus.freedesktop.org/doc/dbus-python/
46
 
    + PyGObject 3.7.1     https://wiki.gnome.org/Projects/PyGObject
47
 
    + pkg-config https://www.freedesktop.org/wiki/Software/pkg-config/
 
44
    + dbus-python 0.82.4  http://dbus.freedesktop.org/doc/dbus-python/
 
45
    + PyGObject 2.14.2    https://developer.gnome.org/pygobject/
 
46
    + pkg-config  http://www.freedesktop.org/wiki/Software/pkg-config/
48
47
    + Urwid 1.0.1         http://urwid.org/
49
48
      (Only needed by the "mandos-monitor" tool.)
50
49
    
53
52
    + ssh-keyscan from OpenSSH http://www.openssh.com/
54
53
    
55
54
    Package names:
56
 
    avahi-daemon python python-dbus python-gi python-urwid pkg-config
57
 
    fping ssh-client
 
55
    avahi-daemon python python-avahi python-dbus python-gobject
 
56
    python-urwid pkg-config fping ssh-client
58
57
    
59
58
*** Mandos Client
60
 
    + GNU C Library 2.16 https://gnu.org/software/libc/
61
59
    + initramfs-tools 0.85i
62
60
                        https://tracker.debian.org/pkg/initramfs-tools
63
 
    + GnuTLS 3.3        https://www.gnutls.org/
64
 
      (but not 3.6.0 or later, until 3.6.6 which works)
 
61
    + GnuTLS 3.3        http://www.gnutls.org/
65
62
    + Avahi 0.6.16      http://www.avahi.org/
66
63
    + GnuPG 1.4.9       https://www.gnupg.org/
67
64
    + GPGME 1.1.6       https://www.gnupg.org/related_software/gpgme/
68
 
    + pkg-config https://www.freedesktop.org/wiki/Software/pkg-config/
 
65
    + pkg-config  http://www.freedesktop.org/wiki/Software/pkg-config/
69
66
    
70
67
    Strongly recommended:
71
68
    + OpenSSH           http://www.openssh.com/
72
69
    
73
70
    Package names:
74
 
    initramfs-tools libgnutls-dev gnutls-bin libavahi-core-dev gnupg
 
71
    initramfs-tools libgnutls-dev libavahi-core-dev gnupg
75
72
    libgpgme11-dev pkg-config ssh
76
73
 
77
74
* Installing the Mandos server
125
122
     
126
123
        # /usr/lib/mandos/plugins.d/mandos-client \
127
124
                --pubkey=/etc/keys/mandos/pubkey.txt \
128
 
                --seckey=/etc/keys/mandos/seckey.txt \
129
 
                --tls-privkey=/etc/keys/mandos/tls-privkey.pem \
130
 
                --tls-pubkey=/etc/keys/mandos/tls-pubkey.pem; echo
 
125
                --seckey=/etc/keys/mandos/seckey.txt; echo
131
126
     
132
127
     This command should retrieve the password from the server,
133
128
     decrypt it, and output it to standard output.