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

  • Committer: Teddy Hogeborn
  • Date: 2015-08-10 09:00:23 UTC
  • mto: (237.7.594 trunk)
  • mto: This revision was merged to the branch mainline in revision 325.
  • Revision ID: teddy@recompile.se-20150810090023-fz6vjqr7zf33e2tf
Support the standard org.freedesktop.DBus.ObjectManager interface.

Now that the D-Bus standard has an interface to keep track of new and
removed objects, use that instead of our own methods.  This deprecates
our D-Bus methods "GetAllClients" and "GetAllClientsWithProperties"
and the signals "ClientAdded" and "ClientRemoved", all on the server
interface "se.recompile.Mandos".

* DBUS-API: Removed references to deprecated methods and signals;
  insert reference to the org.freedesktop.DBus.ObjectManager
  interface.
* mandos (DBusObjectWithProperties._get_all_interface_names): New.
  (dbus.OBJECT_MANAGER_IFACE): If not present, monkey patch.
  (DBusObjectWithObjectManager): New.
  (main/MandosDBusService): Inherit from DBusObjectWithObjectManager.
  (main/MandosDBusService.ClientRemoved): Annotate as deprecated.
  (main/MandosDBusService.GetAllClients): - '' -
  (main/MandosDBusService.GetAllClientsWithProperties): Annotate as
                                                        deprecated.
                                                        Also only
                                                        return
                                                        properties on
                                                        client
                                                        interface.
  (main/MandosDBusService.RemoveClient): Call client_removed_signal
                                         instead of ClientRemoved.
  (main/MandosDBusService.GetManagedObjects): New.
  (main/MandosDBusService.client_added_signal): New.
  (main/MandosDBusService.client_removed_signal): - '' -
  (main/cleanup): Call "client_removed_signal" instead of sending
                  "ClientRemoved" signal directly.
  (main): Call "client_added_signal" instead of sending "ClientAdded"
          signal directly.
* mandos-ctl: Use GetManagedObjects instead of
              GetAllClientsWithProperties.  Also, show better error
              message in case of failure to connect to the D-Bus

* mandos-monitor (MandosClientPropertyCache.properties_changed):
  Bug fix; only update properties on client interface.
  (UserInterface.find_and_remove_client): Change to accept arguments
                                          from InterfacesRemoved
                                          signal.  Also, bug fix:
                                          working error message when
                                          removing unknown client.
  (UserInterface.add_new_client): Change to accept arguments from
                                  InterfacesRemoved signal.  Pass
                                  properties to MandosClientWidget
                                  constructor.
  (UserInterface.run): Connect find_and_remove_client method to
                       InterfacesRemoved signal and the add_new_client
                       method to the InterfacesAdded signal.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
#!/usr/bin/python
 
1
#!/usr/bin/python2.7
2
2
# -*- mode: python; coding: utf-8 -*-
3
3
4
4
# Mandos server - give out binary blobs to connecting clients.
11
11
# "AvahiService" class, and some lines in "main".
12
12
13
13
# Everything else is
14
 
# Copyright © 2008,2009 Teddy Hogeborn
15
 
# Copyright © 2008,2009 Björn Påhlsson
 
14
# Copyright © 2008-2015 Teddy Hogeborn
 
15
# Copyright © 2008-2015 Björn Påhlsson
16
16
17
17
# This program is free software: you can redistribute it and/or modify
18
18
# it under the terms of the GNU General Public License as published by
28
28
# along with this program.  If not, see
29
29
# <http://www.gnu.org/licenses/>.
30
30
31
 
# Contact the authors at <mandos@fukt.bsnet.se>.
 
31
# Contact the authors at <mandos@recompile.se>.
32
32
33
33
 
34
 
from __future__ import division, with_statement, absolute_import
35
 
 
36
 
import SocketServer as socketserver
 
34
from __future__ import (division, absolute_import, print_function,
 
35
                        unicode_literals)
 
36
 
 
37
from future_builtins import *
 
38
 
 
39
try:
 
40
    import SocketServer as socketserver
 
41
except ImportError:
 
42
    import socketserver
37
43
import socket
38
 
import optparse
 
44
import argparse
39
45
import datetime
40
46
import errno
41
47
import gnutls.crypto
44
50
import gnutls.library.functions
45
51
import gnutls.library.constants
46
52
import gnutls.library.types
47
 
import ConfigParser as configparser
 
53
try:
 
54
    import ConfigParser as configparser
 
55
except ImportError:
 
56
    import configparser
48
57
import sys
49
58
import re
50
59
import os
59
68
import struct
60
69
import fcntl
61
70
import functools
62
 
import cPickle as pickle
 
71
try:
 
72
    import cPickle as pickle
 
73
except ImportError:
 
74
    import pickle
63
75
import multiprocessing
 
76
import types
 
77
import binascii
 
78
import tempfile
 
79
import itertools
 
80
import collections
 
81
import codecs
64
82
 
65
83
import dbus
66
84
import dbus.service
67
 
import gobject
 
85
try:
 
86
    import gobject
 
87
except ImportError:
 
88
    from gi.repository import GObject as gobject
68
89
import avahi
69
90
from dbus.mainloop.glib import DBusGMainLoop
70
91
import ctypes
80
101
    except ImportError:
81
102
        SO_BINDTODEVICE = None
82
103
 
83
 
 
84
 
version = "1.0.14"
85
 
 
86
 
#logger = logging.getLogger(u'mandos')
87
 
logger = logging.Logger(u'mandos')
88
 
syslogger = (logging.handlers.SysLogHandler
89
 
             (facility = logging.handlers.SysLogHandler.LOG_DAEMON,
90
 
              address = "/dev/log"))
91
 
syslogger.setFormatter(logging.Formatter
92
 
                       (u'Mandos [%(process)d]: %(levelname)s:'
93
 
                        u' %(message)s'))
94
 
logger.addHandler(syslogger)
95
 
 
96
 
console = logging.StreamHandler()
97
 
console.setFormatter(logging.Formatter(u'%(name)s [%(process)d]:'
98
 
                                       u' %(levelname)s:'
99
 
                                       u' %(message)s'))
100
 
logger.addHandler(console)
 
104
if sys.version_info.major == 2:
 
105
    str = unicode
 
106
 
 
107
version = "1.6.9"
 
108
stored_state_file = "clients.pickle"
 
109
 
 
110
logger = logging.getLogger()
 
111
syslogger = None
 
112
 
 
113
try:
 
114
    if_nametoindex = ctypes.cdll.LoadLibrary(
 
115
        ctypes.util.find_library("c")).if_nametoindex
 
116
except (OSError, AttributeError):
 
117
    
 
118
    def if_nametoindex(interface):
 
119
        "Get an interface index the hard way, i.e. using fcntl()"
 
120
        SIOCGIFINDEX = 0x8933  # From /usr/include/linux/sockios.h
 
121
        with contextlib.closing(socket.socket()) as s:
 
122
            ifreq = fcntl.ioctl(s, SIOCGIFINDEX,
 
123
                                struct.pack(b"16s16x", interface))
 
124
        interface_index = struct.unpack("I", ifreq[16:20])[0]
 
125
        return interface_index
 
126
 
 
127
 
 
128
def initlogger(debug, level=logging.WARNING):
 
129
    """init logger and add loglevel"""
 
130
    
 
131
    global syslogger
 
132
    syslogger = (logging.handlers.SysLogHandler(
 
133
        facility = logging.handlers.SysLogHandler.LOG_DAEMON,
 
134
        address = "/dev/log"))
 
135
    syslogger.setFormatter(logging.Formatter
 
136
                           ('Mandos [%(process)d]: %(levelname)s:'
 
137
                            ' %(message)s'))
 
138
    logger.addHandler(syslogger)
 
139
    
 
140
    if debug:
 
141
        console = logging.StreamHandler()
 
142
        console.setFormatter(logging.Formatter('%(asctime)s %(name)s'
 
143
                                               ' [%(process)d]:'
 
144
                                               ' %(levelname)s:'
 
145
                                               ' %(message)s'))
 
146
        logger.addHandler(console)
 
147
    logger.setLevel(level)
 
148
 
 
149
 
 
150
class PGPError(Exception):
 
151
    """Exception if encryption/decryption fails"""
 
152
    pass
 
153
 
 
154
 
 
155
class PGPEngine(object):
 
156
    """A simple class for OpenPGP symmetric encryption & decryption"""
 
157
    
 
158
    def __init__(self):
 
159
        self.tempdir = tempfile.mkdtemp(prefix="mandos-")
 
160
        self.gnupgargs = ['--batch',
 
161
                          '--home', self.tempdir,
 
162
                          '--force-mdc',
 
163
                          '--quiet',
 
164
                          '--no-use-agent']
 
165
    
 
166
    def __enter__(self):
 
167
        return self
 
168
    
 
169
    def __exit__(self, exc_type, exc_value, traceback):
 
170
        self._cleanup()
 
171
        return False
 
172
    
 
173
    def __del__(self):
 
174
        self._cleanup()
 
175
    
 
176
    def _cleanup(self):
 
177
        if self.tempdir is not None:
 
178
            # Delete contents of tempdir
 
179
            for root, dirs, files in os.walk(self.tempdir,
 
180
                                             topdown = False):
 
181
                for filename in files:
 
182
                    os.remove(os.path.join(root, filename))
 
183
                for dirname in dirs:
 
184
                    os.rmdir(os.path.join(root, dirname))
 
185
            # Remove tempdir
 
186
            os.rmdir(self.tempdir)
 
187
            self.tempdir = None
 
188
    
 
189
    def password_encode(self, password):
 
190
        # Passphrase can not be empty and can not contain newlines or
 
191
        # NUL bytes.  So we prefix it and hex encode it.
 
192
        encoded = b"mandos" + binascii.hexlify(password)
 
193
        if len(encoded) > 2048:
 
194
            # GnuPG can't handle long passwords, so encode differently
 
195
            encoded = (b"mandos" + password.replace(b"\\", b"\\\\")
 
196
                       .replace(b"\n", b"\\n")
 
197
                       .replace(b"\0", b"\\x00"))
 
198
        return encoded
 
199
    
 
200
    def encrypt(self, data, password):
 
201
        passphrase = self.password_encode(password)
 
202
        with tempfile.NamedTemporaryFile(
 
203
                dir=self.tempdir) as passfile:
 
204
            passfile.write(passphrase)
 
205
            passfile.flush()
 
206
            proc = subprocess.Popen(['gpg', '--symmetric',
 
207
                                     '--passphrase-file',
 
208
                                     passfile.name]
 
209
                                    + self.gnupgargs,
 
210
                                    stdin = subprocess.PIPE,
 
211
                                    stdout = subprocess.PIPE,
 
212
                                    stderr = subprocess.PIPE)
 
213
            ciphertext, err = proc.communicate(input = data)
 
214
        if proc.returncode != 0:
 
215
            raise PGPError(err)
 
216
        return ciphertext
 
217
    
 
218
    def decrypt(self, data, password):
 
219
        passphrase = self.password_encode(password)
 
220
        with tempfile.NamedTemporaryFile(
 
221
                dir = self.tempdir) as passfile:
 
222
            passfile.write(passphrase)
 
223
            passfile.flush()
 
224
            proc = subprocess.Popen(['gpg', '--decrypt',
 
225
                                     '--passphrase-file',
 
226
                                     passfile.name]
 
227
                                    + self.gnupgargs,
 
228
                                    stdin = subprocess.PIPE,
 
229
                                    stdout = subprocess.PIPE,
 
230
                                    stderr = subprocess.PIPE)
 
231
            decrypted_plaintext, err = proc.communicate(input = data)
 
232
        if proc.returncode != 0:
 
233
            raise PGPError(err)
 
234
        return decrypted_plaintext
 
235
 
101
236
 
102
237
class AvahiError(Exception):
103
238
    def __init__(self, value, *args, **kwargs):
104
239
        self.value = value
105
 
        super(AvahiError, self).__init__(value, *args, **kwargs)
106
 
    def __unicode__(self):
107
 
        return unicode(repr(self.value))
 
240
        return super(AvahiError, self).__init__(value, *args,
 
241
                                                **kwargs)
 
242
 
108
243
 
109
244
class AvahiServiceError(AvahiError):
110
245
    pass
111
246
 
 
247
 
112
248
class AvahiGroupError(AvahiError):
113
249
    pass
114
250
 
119
255
    Attributes:
120
256
    interface: integer; avahi.IF_UNSPEC or an interface index.
121
257
               Used to optionally bind to the specified interface.
122
 
    name: string; Example: u'Mandos'
123
 
    type: string; Example: u'_mandos._tcp'.
124
 
                  See <http://www.dns-sd.org/ServiceTypes.html>
 
258
    name: string; Example: 'Mandos'
 
259
    type: string; Example: '_mandos._tcp'.
 
260
     See <https://www.iana.org/assignments/service-names-port-numbers>
125
261
    port: integer; what port to announce
126
262
    TXT: list of strings; TXT record for the service
127
263
    domain: string; Domain to publish on, default to .local if empty.
133
269
    server: D-Bus Server
134
270
    bus: dbus.SystemBus()
135
271
    """
136
 
    def __init__(self, interface = avahi.IF_UNSPEC, name = None,
137
 
                 servicetype = None, port = None, TXT = None,
138
 
                 domain = u"", host = u"", max_renames = 32768,
139
 
                 protocol = avahi.PROTO_UNSPEC, bus = None):
 
272
    
 
273
    def __init__(self,
 
274
                 interface = avahi.IF_UNSPEC,
 
275
                 name = None,
 
276
                 servicetype = None,
 
277
                 port = None,
 
278
                 TXT = None,
 
279
                 domain = "",
 
280
                 host = "",
 
281
                 max_renames = 32768,
 
282
                 protocol = avahi.PROTO_UNSPEC,
 
283
                 bus = None):
140
284
        self.interface = interface
141
285
        self.name = name
142
286
        self.type = servicetype
150
294
        self.group = None       # our entry group
151
295
        self.server = None
152
296
        self.bus = bus
153
 
    def rename(self):
 
297
        self.entry_group_state_changed_match = None
 
298
    
 
299
    def rename(self, remove=True):
154
300
        """Derived from the Avahi example code"""
155
301
        if self.rename_count >= self.max_renames:
156
 
            logger.critical(u"No suitable Zeroconf service name found"
157
 
                            u" after %i retries, exiting.",
 
302
            logger.critical("No suitable Zeroconf service name found"
 
303
                            " after %i retries, exiting.",
158
304
                            self.rename_count)
159
 
            raise AvahiServiceError(u"Too many renames")
160
 
        self.name = unicode(self.server.GetAlternativeServiceName(self.name))
161
 
        logger.info(u"Changing Zeroconf service name to %r ...",
 
305
            raise AvahiServiceError("Too many renames")
 
306
        self.name = str(
 
307
            self.server.GetAlternativeServiceName(self.name))
 
308
        self.rename_count += 1
 
309
        logger.info("Changing Zeroconf service name to %r ...",
162
310
                    self.name)
163
 
        syslogger.setFormatter(logging.Formatter
164
 
                               (u'Mandos (%s) [%%(process)d]:'
165
 
                                u' %%(levelname)s: %%(message)s'
166
 
                                % self.name))
167
 
        self.remove()
 
311
        if remove:
 
312
            self.remove()
168
313
        try:
169
314
            self.add()
170
 
        except dbus.exceptions.DBusException, error:
171
 
            logger.critical(u"DBusException: %s", error)
172
 
            self.cleanup()
173
 
            os._exit(1)
174
 
        self.rename_count += 1
 
315
        except dbus.exceptions.DBusException as error:
 
316
            if (error.get_dbus_name()
 
317
                == "org.freedesktop.Avahi.CollisionError"):
 
318
                logger.info("Local Zeroconf service name collision.")
 
319
                return self.rename(remove=False)
 
320
            else:
 
321
                logger.critical("D-Bus Exception", exc_info=error)
 
322
                self.cleanup()
 
323
                os._exit(1)
 
324
    
175
325
    def remove(self):
176
326
        """Derived from the Avahi example code"""
 
327
        if self.entry_group_state_changed_match is not None:
 
328
            self.entry_group_state_changed_match.remove()
 
329
            self.entry_group_state_changed_match = None
177
330
        if self.group is not None:
178
331
            self.group.Reset()
 
332
    
179
333
    def add(self):
180
334
        """Derived from the Avahi example code"""
 
335
        self.remove()
181
336
        if self.group is None:
182
337
            self.group = dbus.Interface(
183
338
                self.bus.get_object(avahi.DBUS_NAME,
184
339
                                    self.server.EntryGroupNew()),
185
340
                avahi.DBUS_INTERFACE_ENTRY_GROUP)
186
 
            self.group.connect_to_signal('StateChanged',
187
 
                                         self
188
 
                                         .entry_group_state_changed)
189
 
        logger.debug(u"Adding Zeroconf service '%s' of type '%s' ...",
 
341
        self.entry_group_state_changed_match = (
 
342
            self.group.connect_to_signal(
 
343
                'StateChanged', self.entry_group_state_changed))
 
344
        logger.debug("Adding Zeroconf service '%s' of type '%s' ...",
190
345
                     self.name, self.type)
191
346
        self.group.AddService(
192
347
            self.interface,
197
352
            dbus.UInt16(self.port),
198
353
            avahi.string_array_to_txt_array(self.TXT))
199
354
        self.group.Commit()
 
355
    
200
356
    def entry_group_state_changed(self, state, error):
201
357
        """Derived from the Avahi example code"""
202
 
        logger.debug(u"Avahi entry group state change: %i", state)
 
358
        logger.debug("Avahi entry group state change: %i", state)
203
359
        
204
360
        if state == avahi.ENTRY_GROUP_ESTABLISHED:
205
 
            logger.debug(u"Zeroconf service established.")
 
361
            logger.debug("Zeroconf service established.")
206
362
        elif state == avahi.ENTRY_GROUP_COLLISION:
207
 
            logger.warning(u"Zeroconf service name collision.")
 
363
            logger.info("Zeroconf service name collision.")
208
364
            self.rename()
209
365
        elif state == avahi.ENTRY_GROUP_FAILURE:
210
 
            logger.critical(u"Avahi: Error in group state changed %s",
211
 
                            unicode(error))
212
 
            raise AvahiGroupError(u"State changed: %s"
213
 
                                  % unicode(error))
 
366
            logger.critical("Avahi: Error in group state changed %s",
 
367
                            str(error))
 
368
            raise AvahiGroupError("State changed: {!s}".format(error))
 
369
    
214
370
    def cleanup(self):
215
371
        """Derived from the Avahi example code"""
216
372
        if self.group is not None:
217
 
            self.group.Free()
 
373
            try:
 
374
                self.group.Free()
 
375
            except (dbus.exceptions.UnknownMethodException,
 
376
                    dbus.exceptions.DBusException):
 
377
                pass
218
378
            self.group = None
219
 
    def server_state_changed(self, state):
 
379
        self.remove()
 
380
    
 
381
    def server_state_changed(self, state, error=None):
220
382
        """Derived from the Avahi example code"""
221
 
        logger.debug(u"Avahi server state change: %i", state)
222
 
        if state == avahi.SERVER_COLLISION:
223
 
            logger.error(u"Zeroconf server name collision")
224
 
            self.remove()
 
383
        logger.debug("Avahi server state change: %i", state)
 
384
        bad_states = {
 
385
            avahi.SERVER_INVALID: "Zeroconf server invalid",
 
386
            avahi.SERVER_REGISTERING: None,
 
387
            avahi.SERVER_COLLISION: "Zeroconf server name collision",
 
388
            avahi.SERVER_FAILURE: "Zeroconf server failure",
 
389
        }
 
390
        if state in bad_states:
 
391
            if bad_states[state] is not None:
 
392
                if error is None:
 
393
                    logger.error(bad_states[state])
 
394
                else:
 
395
                    logger.error(bad_states[state] + ": %r", error)
 
396
            self.cleanup()
225
397
        elif state == avahi.SERVER_RUNNING:
226
 
            self.add()
 
398
            try:
 
399
                self.add()
 
400
            except dbus.exceptions.DBusException as error:
 
401
                if (error.get_dbus_name()
 
402
                    == "org.freedesktop.Avahi.CollisionError"):
 
403
                    logger.info("Local Zeroconf service name"
 
404
                                " collision.")
 
405
                    return self.rename(remove=False)
 
406
                else:
 
407
                    logger.critical("D-Bus Exception", exc_info=error)
 
408
                    self.cleanup()
 
409
                    os._exit(1)
 
410
        else:
 
411
            if error is None:
 
412
                logger.debug("Unknown state: %r", state)
 
413
            else:
 
414
                logger.debug("Unknown state: %r: %r", state, error)
 
415
    
227
416
    def activate(self):
228
417
        """Derived from the Avahi example code"""
229
418
        if self.server is None:
230
419
            self.server = dbus.Interface(
231
420
                self.bus.get_object(avahi.DBUS_NAME,
232
 
                                    avahi.DBUS_PATH_SERVER),
 
421
                                    avahi.DBUS_PATH_SERVER,
 
422
                                    follow_name_owner_changes=True),
233
423
                avahi.DBUS_INTERFACE_SERVER)
234
 
        self.server.connect_to_signal(u"StateChanged",
235
 
                                 self.server_state_changed)
 
424
        self.server.connect_to_signal("StateChanged",
 
425
                                      self.server_state_changed)
236
426
        self.server_state_changed(self.server.GetState())
237
427
 
238
428
 
 
429
class AvahiServiceToSyslog(AvahiService):
 
430
    def rename(self, *args, **kwargs):
 
431
        """Add the new name to the syslog messages"""
 
432
        ret = AvahiService.rename(self, *args, **kwargs)
 
433
        syslogger.setFormatter(logging.Formatter(
 
434
            'Mandos ({}) [%(process)d]: %(levelname)s: %(message)s'
 
435
            .format(self.name)))
 
436
        return ret
 
437
 
 
438
def call_pipe(connection,       # : multiprocessing.Connection
 
439
              func, *args, **kwargs):
 
440
    """This function is meant to be called by multiprocessing.Process
 
441
    
 
442
    This function runs func(*args, **kwargs), and writes the resulting
 
443
    return value on the provided multiprocessing.Connection.
 
444
    """
 
445
    connection.send(func(*args, **kwargs))
 
446
    connection.close()
 
447
 
239
448
class Client(object):
240
449
    """A representation of a client host served by this server.
241
450
    
242
451
    Attributes:
243
 
    name:       string; from the config file, used in log messages and
244
 
                        D-Bus identifiers
 
452
    approved:   bool(); 'None' if not yet approved/disapproved
 
453
    approval_delay: datetime.timedelta(); Time to wait for approval
 
454
    approval_duration: datetime.timedelta(); Duration of one approval
 
455
    checker:    subprocess.Popen(); a running checker process used
 
456
                                    to see if the client lives.
 
457
                                    'None' if no process is running.
 
458
    checker_callback_tag: a gobject event source tag, or None
 
459
    checker_command: string; External command which is run to check
 
460
                     if client lives.  %() expansions are done at
 
461
                     runtime with vars(self) as dict, so that for
 
462
                     instance %(name)s can be used in the command.
 
463
    checker_initiator_tag: a gobject event source tag, or None
 
464
    created:    datetime.datetime(); (UTC) object creation
 
465
    client_structure: Object describing what attributes a client has
 
466
                      and is used for storing the client at exit
 
467
    current_checker_command: string; current running checker_command
 
468
    disable_initiator_tag: a gobject event source tag, or None
 
469
    enabled:    bool()
245
470
    fingerprint: string (40 or 32 hexadecimal digits); used to
246
471
                 uniquely identify the client
247
 
    secret:     bytestring; sent verbatim (over TLS) to client
248
472
    host:       string; available for use by the checker command
249
 
    created:    datetime.datetime(); (UTC) object creation
250
 
    last_enabled: datetime.datetime(); (UTC)
251
 
    enabled:    bool()
 
473
    interval:   datetime.timedelta(); How often to start a new checker
 
474
    last_approval_request: datetime.datetime(); (UTC) or None
252
475
    last_checked_ok: datetime.datetime(); (UTC) or None
 
476
    last_checker_status: integer between 0 and 255 reflecting exit
 
477
                         status of last checker. -1 reflects crashed
 
478
                         checker, -2 means no checker completed yet.
 
479
    last_checker_signal: The signal which killed the last checker, if
 
480
                         last_checker_status is -1
 
481
    last_enabled: datetime.datetime(); (UTC) or None
 
482
    name:       string; from the config file, used in log messages and
 
483
                        D-Bus identifiers
 
484
    secret:     bytestring; sent verbatim (over TLS) to client
253
485
    timeout:    datetime.timedelta(); How long from last_checked_ok
254
486
                                      until this client is disabled
255
 
    interval:   datetime.timedelta(); How often to start a new checker
256
 
    disable_hook:  If set, called by disable() as disable_hook(self)
257
 
    checker:    subprocess.Popen(); a running checker process used
258
 
                                    to see if the client lives.
259
 
                                    'None' if no process is running.
260
 
    checker_initiator_tag: a gobject event source tag, or None
261
 
    disable_initiator_tag: - '' -
262
 
    checker_callback_tag:  - '' -
263
 
    checker_command: string; External command which is run to check if
264
 
                     client lives.  %() expansions are done at
265
 
                     runtime with vars(self) as dict, so that for
266
 
                     instance %(name)s can be used in the command.
267
 
    current_checker_command: string; current running checker_command
268
 
    approved_delay: datetime.timedelta(); Time to wait for approval
269
 
    _approved:   bool(); 'None' if not yet approved/disapproved
270
 
    approved_duration: datetime.timedelta(); Duration of one approval
 
487
    extended_timeout:   extra long timeout when secret has been sent
 
488
    runtime_expansions: Allowed attributes for runtime expansion.
 
489
    expires:    datetime.datetime(); time (UTC) when a client will be
 
490
                disabled, or None
 
491
    server_settings: The server_settings dict from main()
271
492
    """
272
493
    
 
494
    runtime_expansions = ("approval_delay", "approval_duration",
 
495
                          "created", "enabled", "expires",
 
496
                          "fingerprint", "host", "interval",
 
497
                          "last_approval_request", "last_checked_ok",
 
498
                          "last_enabled", "name", "timeout")
 
499
    client_defaults = {
 
500
        "timeout": "PT5M",
 
501
        "extended_timeout": "PT15M",
 
502
        "interval": "PT2M",
 
503
        "checker": "fping -q -- %%(host)s",
 
504
        "host": "",
 
505
        "approval_delay": "PT0S",
 
506
        "approval_duration": "PT1S",
 
507
        "approved_by_default": "True",
 
508
        "enabled": "True",
 
509
    }
 
510
    
273
511
    @staticmethod
274
 
    def _timedelta_to_milliseconds(td):
275
 
        "Convert a datetime.timedelta() to milliseconds"
276
 
        return ((td.days * 24 * 60 * 60 * 1000)
277
 
                + (td.seconds * 1000)
278
 
                + (td.microseconds // 1000))
279
 
    
280
 
    def timeout_milliseconds(self):
281
 
        "Return the 'timeout' attribute in milliseconds"
282
 
        return self._timedelta_to_milliseconds(self.timeout)
283
 
    
284
 
    def interval_milliseconds(self):
285
 
        "Return the 'interval' attribute in milliseconds"
286
 
        return self._timedelta_to_milliseconds(self.interval)
287
 
 
288
 
    def approved_delay_milliseconds(self):
289
 
        return self._timedelta_to_milliseconds(self.approved_delay)
290
 
    
291
 
    def __init__(self, name = None, disable_hook=None, config=None):
292
 
        """Note: the 'checker' key in 'config' sets the
293
 
        'checker_command' attribute and *not* the 'checker'
294
 
        attribute."""
 
512
    def config_parser(config):
 
513
        """Construct a new dict of client settings of this form:
 
514
        { client_name: {setting_name: value, ...}, ...}
 
515
        with exceptions for any special settings as defined above.
 
516
        NOTE: Must be a pure function. Must return the same result
 
517
        value given the same arguments.
 
518
        """
 
519
        settings = {}
 
520
        for client_name in config.sections():
 
521
            section = dict(config.items(client_name))
 
522
            client = settings[client_name] = {}
 
523
            
 
524
            client["host"] = section["host"]
 
525
            # Reformat values from string types to Python types
 
526
            client["approved_by_default"] = config.getboolean(
 
527
                client_name, "approved_by_default")
 
528
            client["enabled"] = config.getboolean(client_name,
 
529
                                                  "enabled")
 
530
            
 
531
            # Uppercase and remove spaces from fingerprint for later
 
532
            # comparison purposes with return value from the
 
533
            # fingerprint() function
 
534
            client["fingerprint"] = (section["fingerprint"].upper()
 
535
                                     .replace(" ", ""))
 
536
            if "secret" in section:
 
537
                client["secret"] = section["secret"].decode("base64")
 
538
            elif "secfile" in section:
 
539
                with open(os.path.expanduser(os.path.expandvars
 
540
                                             (section["secfile"])),
 
541
                          "rb") as secfile:
 
542
                    client["secret"] = secfile.read()
 
543
            else:
 
544
                raise TypeError("No secret or secfile for section {}"
 
545
                                .format(section))
 
546
            client["timeout"] = string_to_delta(section["timeout"])
 
547
            client["extended_timeout"] = string_to_delta(
 
548
                section["extended_timeout"])
 
549
            client["interval"] = string_to_delta(section["interval"])
 
550
            client["approval_delay"] = string_to_delta(
 
551
                section["approval_delay"])
 
552
            client["approval_duration"] = string_to_delta(
 
553
                section["approval_duration"])
 
554
            client["checker_command"] = section["checker"]
 
555
            client["last_approval_request"] = None
 
556
            client["last_checked_ok"] = None
 
557
            client["last_checker_status"] = -2
 
558
        
 
559
        return settings
 
560
    
 
561
    def __init__(self, settings, name = None, server_settings=None):
295
562
        self.name = name
296
 
        if config is None:
297
 
            config = {}
298
 
        logger.debug(u"Creating client %r", self.name)
299
 
        # Uppercase and remove spaces from fingerprint for later
300
 
        # comparison purposes with return value from the fingerprint()
301
 
        # function
302
 
        self.fingerprint = (config[u"fingerprint"].upper()
303
 
                            .replace(u" ", u""))
304
 
        logger.debug(u"  Fingerprint: %s", self.fingerprint)
305
 
        if u"secret" in config:
306
 
            self.secret = config[u"secret"].decode(u"base64")
307
 
        elif u"secfile" in config:
308
 
            with open(os.path.expanduser(os.path.expandvars
309
 
                                         (config[u"secfile"])),
310
 
                      "rb") as secfile:
311
 
                self.secret = secfile.read()
 
563
        if server_settings is None:
 
564
            server_settings = {}
 
565
        self.server_settings = server_settings
 
566
        # adding all client settings
 
567
        for setting, value in settings.items():
 
568
            setattr(self, setting, value)
 
569
        
 
570
        if self.enabled:
 
571
            if not hasattr(self, "last_enabled"):
 
572
                self.last_enabled = datetime.datetime.utcnow()
 
573
            if not hasattr(self, "expires"):
 
574
                self.expires = (datetime.datetime.utcnow()
 
575
                                + self.timeout)
312
576
        else:
313
 
            raise TypeError(u"No secret or secfile for client %s"
314
 
                            % self.name)
315
 
        self.host = config.get(u"host", u"")
316
 
        self.created = datetime.datetime.utcnow()
317
 
        self.enabled = False
318
 
        self.last_enabled = None
319
 
        self.last_checked_ok = None
320
 
        self.timeout = string_to_delta(config[u"timeout"])
321
 
        self.interval = string_to_delta(config[u"interval"])
322
 
        self.disable_hook = disable_hook
 
577
            self.last_enabled = None
 
578
            self.expires = None
 
579
        
 
580
        logger.debug("Creating client %r", self.name)
 
581
        logger.debug("  Fingerprint: %s", self.fingerprint)
 
582
        self.created = settings.get("created",
 
583
                                    datetime.datetime.utcnow())
 
584
        
 
585
        # attributes specific for this server instance
323
586
        self.checker = None
324
587
        self.checker_initiator_tag = None
325
588
        self.disable_initiator_tag = None
326
589
        self.checker_callback_tag = None
327
 
        self.checker_command = config[u"checker"]
328
590
        self.current_checker_command = None
329
 
        self.last_connect = None
330
 
        self._approved = None
331
 
        self.approved_by_default = config.get(u"approved_by_default",
332
 
                                              True)
 
591
        self.approved = None
333
592
        self.approvals_pending = 0
334
 
        self.approved_delay = string_to_delta(
335
 
            config[u"approved_delay"])
336
 
        self.approved_duration = string_to_delta(
337
 
            config[u"approved_duration"])
338
 
        self.changedstate = multiprocessing_manager.Condition(multiprocessing_manager.Lock())
 
593
        self.changedstate = multiprocessing_manager.Condition(
 
594
            multiprocessing_manager.Lock())
 
595
        self.client_structure = [attr
 
596
                                 for attr in self.__dict__.iterkeys()
 
597
                                 if not attr.startswith("_")]
 
598
        self.client_structure.append("client_structure")
 
599
        
 
600
        for name, t in inspect.getmembers(
 
601
                type(self), lambda obj: isinstance(obj, property)):
 
602
            if not name.startswith("_"):
 
603
                self.client_structure.append(name)
339
604
    
 
605
    # Send notice to process children that client state has changed
340
606
    def send_changedstate(self):
341
 
        self.changedstate.acquire()
342
 
        self.changedstate.notify_all()
343
 
        self.changedstate.release()
344
 
        
 
607
        with self.changedstate:
 
608
            self.changedstate.notify_all()
 
609
    
345
610
    def enable(self):
346
611
        """Start this client's checker and timeout hooks"""
347
 
        if getattr(self, u"enabled", False):
 
612
        if getattr(self, "enabled", False):
348
613
            # Already enabled
349
614
            return
350
 
        self.send_changedstate()
 
615
        self.expires = datetime.datetime.utcnow() + self.timeout
 
616
        self.enabled = True
351
617
        self.last_enabled = datetime.datetime.utcnow()
352
 
        # Schedule a new checker to be started an 'interval' from now,
353
 
        # and every interval from then on.
354
 
        self.checker_initiator_tag = (gobject.timeout_add
355
 
                                      (self.interval_milliseconds(),
356
 
                                       self.start_checker))
357
 
        # Schedule a disable() when 'timeout' has passed
358
 
        self.disable_initiator_tag = (gobject.timeout_add
359
 
                                   (self.timeout_milliseconds(),
360
 
                                    self.disable))
361
 
        self.enabled = True
362
 
        # Also start a new checker *right now*.
363
 
        self.start_checker()
 
618
        self.init_checker()
 
619
        self.send_changedstate()
364
620
    
365
621
    def disable(self, quiet=True):
366
622
        """Disable this client."""
367
623
        if not getattr(self, "enabled", False):
368
624
            return False
369
625
        if not quiet:
 
626
            logger.info("Disabling client %s", self.name)
 
627
        if getattr(self, "disable_initiator_tag", None) is not None:
 
628
            gobject.source_remove(self.disable_initiator_tag)
 
629
            self.disable_initiator_tag = None
 
630
        self.expires = None
 
631
        if getattr(self, "checker_initiator_tag", None) is not None:
 
632
            gobject.source_remove(self.checker_initiator_tag)
 
633
            self.checker_initiator_tag = None
 
634
        self.stop_checker()
 
635
        self.enabled = False
 
636
        if not quiet:
370
637
            self.send_changedstate()
371
 
        if not quiet:
372
 
            logger.info(u"Disabling client %s", self.name)
373
 
        if getattr(self, u"disable_initiator_tag", False):
374
 
            gobject.source_remove(self.disable_initiator_tag)
375
 
            self.disable_initiator_tag = None
376
 
        if getattr(self, u"checker_initiator_tag", False):
377
 
            gobject.source_remove(self.checker_initiator_tag)
378
 
            self.checker_initiator_tag = None
379
 
        self.stop_checker()
380
 
        if self.disable_hook:
381
 
            self.disable_hook(self)
382
 
        self.enabled = False
383
638
        # Do not run this again if called by a gobject.timeout_add
384
639
        return False
385
640
    
386
641
    def __del__(self):
387
 
        self.disable_hook = None
388
642
        self.disable()
389
643
    
390
 
    def checker_callback(self, pid, condition, command):
 
644
    def init_checker(self):
 
645
        # Schedule a new checker to be started an 'interval' from now,
 
646
        # and every interval from then on.
 
647
        if self.checker_initiator_tag is not None:
 
648
            gobject.source_remove(self.checker_initiator_tag)
 
649
        self.checker_initiator_tag = gobject.timeout_add(
 
650
            int(self.interval.total_seconds() * 1000),
 
651
            self.start_checker)
 
652
        # Schedule a disable() when 'timeout' has passed
 
653
        if self.disable_initiator_tag is not None:
 
654
            gobject.source_remove(self.disable_initiator_tag)
 
655
        self.disable_initiator_tag = gobject.timeout_add(
 
656
            int(self.timeout.total_seconds() * 1000), self.disable)
 
657
        # Also start a new checker *right now*.
 
658
        self.start_checker()
 
659
    
 
660
    def checker_callback(self, source, condition, connection,
 
661
                         command):
391
662
        """The checker has completed, so take appropriate actions."""
392
663
        self.checker_callback_tag = None
393
664
        self.checker = None
394
 
        if os.WIFEXITED(condition):
395
 
            exitstatus = os.WEXITSTATUS(condition)
396
 
            if exitstatus == 0:
397
 
                logger.info(u"Checker for %(name)s succeeded",
 
665
        # Read return code from connection (see call_pipe)
 
666
        returncode = connection.recv()
 
667
        connection.close()
 
668
        
 
669
        if returncode >= 0:
 
670
            self.last_checker_status = returncode
 
671
            self.last_checker_signal = None
 
672
            if self.last_checker_status == 0:
 
673
                logger.info("Checker for %(name)s succeeded",
398
674
                            vars(self))
399
675
                self.checked_ok()
400
676
            else:
401
 
                logger.info(u"Checker for %(name)s failed",
402
 
                            vars(self))
 
677
                logger.info("Checker for %(name)s failed", vars(self))
403
678
        else:
404
 
            logger.warning(u"Checker for %(name)s crashed?",
 
679
            self.last_checker_status = -1
 
680
            self.last_checker_signal = -returncode
 
681
            logger.warning("Checker for %(name)s crashed?",
405
682
                           vars(self))
 
683
        return False
406
684
    
407
685
    def checked_ok(self):
408
 
        """Bump up the timeout for this client.
409
 
        
410
 
        This should only be called when the client has been seen,
411
 
        alive and well.
412
 
        """
 
686
        """Assert that the client has been seen, alive and well."""
413
687
        self.last_checked_ok = datetime.datetime.utcnow()
414
 
        gobject.source_remove(self.disable_initiator_tag)
415
 
        self.disable_initiator_tag = (gobject.timeout_add
416
 
                                      (self.timeout_milliseconds(),
417
 
                                       self.disable))
 
688
        self.last_checker_status = 0
 
689
        self.last_checker_signal = None
 
690
        self.bump_timeout()
 
691
    
 
692
    def bump_timeout(self, timeout=None):
 
693
        """Bump up the timeout for this client."""
 
694
        if timeout is None:
 
695
            timeout = self.timeout
 
696
        if self.disable_initiator_tag is not None:
 
697
            gobject.source_remove(self.disable_initiator_tag)
 
698
            self.disable_initiator_tag = None
 
699
        if getattr(self, "enabled", False):
 
700
            self.disable_initiator_tag = gobject.timeout_add(
 
701
                int(timeout.total_seconds() * 1000), self.disable)
 
702
            self.expires = datetime.datetime.utcnow() + timeout
 
703
    
 
704
    def need_approval(self):
 
705
        self.last_approval_request = datetime.datetime.utcnow()
418
706
    
419
707
    def start_checker(self):
420
708
        """Start a new checker subprocess if one is not running.
422
710
        If a checker already exists, leave it running and do
423
711
        nothing."""
424
712
        # The reason for not killing a running checker is that if we
425
 
        # did that, then if a checker (for some reason) started
426
 
        # running slowly and taking more than 'interval' time, the
427
 
        # client would inevitably timeout, since no checker would get
428
 
        # a chance to run to completion.  If we instead leave running
 
713
        # did that, and if a checker (for some reason) started running
 
714
        # slowly and taking more than 'interval' time, then the client
 
715
        # would inevitably timeout, since no checker would get a
 
716
        # chance to run to completion.  If we instead leave running
429
717
        # checkers alone, the checker would have to take more time
430
718
        # than 'timeout' for the client to be disabled, which is as it
431
719
        # should be.
432
720
        
433
 
        # If a checker exists, make sure it is not a zombie
434
 
        try:
435
 
            pid, status = os.waitpid(self.checker.pid, os.WNOHANG)
436
 
        except (AttributeError, OSError), error:
437
 
            if (isinstance(error, OSError)
438
 
                and error.errno != errno.ECHILD):
439
 
                raise error
440
 
        else:
441
 
            if pid:
442
 
                logger.warning(u"Checker was a zombie")
443
 
                gobject.source_remove(self.checker_callback_tag)
444
 
                self.checker_callback(pid, status,
445
 
                                      self.current_checker_command)
 
721
        if self.checker is not None and not self.checker.is_alive():
 
722
            logger.warning("Checker was not alive; joining")
 
723
            self.checker.join()
 
724
            self.checker = None
446
725
        # Start a new checker if needed
447
726
        if self.checker is None:
 
727
            # Escape attributes for the shell
 
728
            escaped_attrs = {
 
729
                attr: re.escape(str(getattr(self, attr)))
 
730
                for attr in self.runtime_expansions }
448
731
            try:
449
 
                # In case checker_command has exactly one % operator
450
 
                command = self.checker_command % self.host
451
 
            except TypeError:
452
 
                # Escape attributes for the shell
453
 
                escaped_attrs = dict((key,
454
 
                                      re.escape(unicode(str(val),
455
 
                                                        errors=
456
 
                                                        u'replace')))
457
 
                                     for key, val in
458
 
                                     vars(self).iteritems())
459
 
                try:
460
 
                    command = self.checker_command % escaped_attrs
461
 
                except TypeError, error:
462
 
                    logger.error(u'Could not format string "%s":'
463
 
                                 u' %s', self.checker_command, error)
464
 
                    return True # Try again later
 
732
                command = self.checker_command % escaped_attrs
 
733
            except TypeError as error:
 
734
                logger.error('Could not format string "%s"',
 
735
                             self.checker_command,
 
736
                             exc_info=error)
 
737
                return True     # Try again later
465
738
            self.current_checker_command = command
466
 
            try:
467
 
                logger.info(u"Starting checker %r for %s",
468
 
                            command, self.name)
469
 
                # We don't need to redirect stdout and stderr, since
470
 
                # in normal mode, that is already done by daemon(),
471
 
                # and in debug mode we don't want to.  (Stdin is
472
 
                # always replaced by /dev/null.)
473
 
                self.checker = subprocess.Popen(command,
474
 
                                                close_fds=True,
475
 
                                                shell=True, cwd=u"/")
476
 
                self.checker_callback_tag = (gobject.child_watch_add
477
 
                                             (self.checker.pid,
478
 
                                              self.checker_callback,
479
 
                                              data=command))
480
 
                # The checker may have completed before the gobject
481
 
                # watch was added.  Check for this.
482
 
                pid, status = os.waitpid(self.checker.pid, os.WNOHANG)
483
 
                if pid:
484
 
                    gobject.source_remove(self.checker_callback_tag)
485
 
                    self.checker_callback(pid, status, command)
486
 
            except OSError, error:
487
 
                logger.error(u"Failed to start subprocess: %s",
488
 
                             error)
 
739
            logger.info("Starting checker %r for %s", command,
 
740
                        self.name)
 
741
            # We don't need to redirect stdout and stderr, since
 
742
            # in normal mode, that is already done by daemon(),
 
743
            # and in debug mode we don't want to.  (Stdin is
 
744
            # always replaced by /dev/null.)
 
745
            # The exception is when not debugging but nevertheless
 
746
            # running in the foreground; use the previously
 
747
            # created wnull.
 
748
            popen_args = { "close_fds": True,
 
749
                           "shell": True,
 
750
                           "cwd": "/" }
 
751
            if (not self.server_settings["debug"]
 
752
                and self.server_settings["foreground"]):
 
753
                popen_args.update({"stdout": wnull,
 
754
                                   "stderr": wnull })
 
755
            pipe = multiprocessing.Pipe(duplex = False)
 
756
            self.checker = multiprocessing.Process(
 
757
                target = call_pipe,
 
758
                args = (pipe[1], subprocess.call, command),
 
759
                kwargs = popen_args)
 
760
            self.checker.start()
 
761
            self.checker_callback_tag = gobject.io_add_watch(
 
762
                pipe[0].fileno(), gobject.IO_IN,
 
763
                self.checker_callback, pipe[0], command)
489
764
        # Re-run this periodically if run by gobject.timeout_add
490
765
        return True
491
766
    
494
769
        if self.checker_callback_tag:
495
770
            gobject.source_remove(self.checker_callback_tag)
496
771
            self.checker_callback_tag = None
497
 
        if getattr(self, u"checker", None) is None:
 
772
        if getattr(self, "checker", None) is None:
498
773
            return
499
 
        logger.debug(u"Stopping checker for %(name)s", vars(self))
500
 
        try:
501
 
            os.kill(self.checker.pid, signal.SIGTERM)
502
 
            #time.sleep(0.5)
503
 
            #if self.checker.poll() is None:
504
 
            #    os.kill(self.checker.pid, signal.SIGKILL)
505
 
        except OSError, error:
506
 
            if error.errno != errno.ESRCH: # No such process
507
 
                raise
 
774
        logger.debug("Stopping checker for %(name)s", vars(self))
 
775
        self.checker.terminate()
508
776
        self.checker = None
509
777
 
510
 
def dbus_service_property(dbus_interface, signature=u"v",
511
 
                          access=u"readwrite", byte_arrays=False):
 
778
 
 
779
def dbus_service_property(dbus_interface,
 
780
                          signature="v",
 
781
                          access="readwrite",
 
782
                          byte_arrays=False):
512
783
    """Decorators for marking methods of a DBusObjectWithProperties to
513
784
    become properties on the D-Bus.
514
785
    
521
792
    """
522
793
    # Encoding deeply encoded byte arrays is not supported yet by the
523
794
    # "Set" method, so we fail early here:
524
 
    if byte_arrays and signature != u"ay":
525
 
        raise ValueError(u"Byte arrays not supported for non-'ay'"
526
 
                         u" signature %r" % signature)
 
795
    if byte_arrays and signature != "ay":
 
796
        raise ValueError("Byte arrays not supported for non-'ay'"
 
797
                         " signature {!r}".format(signature))
 
798
    
527
799
    def decorator(func):
528
800
        func._dbus_is_property = True
529
801
        func._dbus_interface = dbus_interface
530
802
        func._dbus_signature = signature
531
803
        func._dbus_access = access
532
804
        func._dbus_name = func.__name__
533
 
        if func._dbus_name.endswith(u"_dbus_property"):
 
805
        if func._dbus_name.endswith("_dbus_property"):
534
806
            func._dbus_name = func._dbus_name[:-14]
535
 
        func._dbus_get_args_options = {u'byte_arrays': byte_arrays }
536
 
        return func
 
807
        func._dbus_get_args_options = {'byte_arrays': byte_arrays }
 
808
        return func
 
809
    
 
810
    return decorator
 
811
 
 
812
 
 
813
def dbus_interface_annotations(dbus_interface):
 
814
    """Decorator for marking functions returning interface annotations
 
815
    
 
816
    Usage:
 
817
    
 
818
    @dbus_interface_annotations("org.example.Interface")
 
819
    def _foo(self):  # Function name does not matter
 
820
        return {"org.freedesktop.DBus.Deprecated": "true",
 
821
                "org.freedesktop.DBus.Property.EmitsChangedSignal":
 
822
                    "false"}
 
823
    """
 
824
    
 
825
    def decorator(func):
 
826
        func._dbus_is_interface = True
 
827
        func._dbus_interface = dbus_interface
 
828
        func._dbus_name = dbus_interface
 
829
        return func
 
830
    
 
831
    return decorator
 
832
 
 
833
 
 
834
def dbus_annotations(annotations):
 
835
    """Decorator to annotate D-Bus methods, signals or properties
 
836
    Usage:
 
837
    
 
838
    @dbus_annotations({"org.freedesktop.DBus.Deprecated": "true",
 
839
                       "org.freedesktop.DBus.Property."
 
840
                       "EmitsChangedSignal": "false"})
 
841
    @dbus_service_property("org.example.Interface", signature="b",
 
842
                           access="r")
 
843
    def Property_dbus_property(self):
 
844
        return dbus.Boolean(False)
 
845
    
 
846
    See also the DBusObjectWithAnnotations class.
 
847
    """
 
848
    
 
849
    def decorator(func):
 
850
        func._dbus_annotations = annotations
 
851
        return func
 
852
    
537
853
    return decorator
538
854
 
539
855
 
540
856
class DBusPropertyException(dbus.exceptions.DBusException):
541
857
    """A base class for D-Bus property-related exceptions
542
858
    """
543
 
    def __unicode__(self):
544
 
        return unicode(str(self))
 
859
    pass
545
860
 
546
861
 
547
862
class DBusPropertyAccessException(DBusPropertyException):
556
871
    pass
557
872
 
558
873
 
559
 
class DBusObjectWithProperties(dbus.service.Object):
 
874
class DBusObjectWithAnnotations(dbus.service.Object):
 
875
    """A D-Bus object with annotations.
 
876
    
 
877
    Classes inheriting from this can use the dbus_annotations
 
878
    decorator to add annotations to methods or signals.
 
879
    """
 
880
    
 
881
    @staticmethod
 
882
    def _is_dbus_thing(thing):
 
883
        """Returns a function testing if an attribute is a D-Bus thing
 
884
        
 
885
        If called like _is_dbus_thing("method") it returns a function
 
886
        suitable for use as predicate to inspect.getmembers().
 
887
        """
 
888
        return lambda obj: getattr(obj, "_dbus_is_{}".format(thing),
 
889
                                   False)
 
890
    
 
891
    def _get_all_dbus_things(self, thing):
 
892
        """Returns a generator of (name, attribute) pairs
 
893
        """
 
894
        return ((getattr(athing.__get__(self), "_dbus_name", name),
 
895
                 athing.__get__(self))
 
896
                for cls in self.__class__.__mro__
 
897
                for name, athing in
 
898
                inspect.getmembers(cls, self._is_dbus_thing(thing)))
 
899
    
 
900
    @dbus.service.method(dbus.INTROSPECTABLE_IFACE,
 
901
                         out_signature = "s",
 
902
                         path_keyword = 'object_path',
 
903
                         connection_keyword = 'connection')
 
904
    def Introspect(self, object_path, connection):
 
905
        """Overloading of standard D-Bus method.
 
906
        
 
907
        Inserts annotation tags on methods and signals.
 
908
        """
 
909
        xmlstring = dbus.service.Object.Introspect(self, object_path,
 
910
                                                   connection)
 
911
        try:
 
912
            document = xml.dom.minidom.parseString(xmlstring)
 
913
            
 
914
            for if_tag in document.getElementsByTagName("interface"):
 
915
                # Add annotation tags
 
916
                for typ in ("method", "signal"):
 
917
                    for tag in if_tag.getElementsByTagName(typ):
 
918
                        annots = dict()
 
919
                        for name, prop in (self.
 
920
                                           _get_all_dbus_things(typ)):
 
921
                            if (name == tag.getAttribute("name")
 
922
                                and prop._dbus_interface
 
923
                                == if_tag.getAttribute("name")):
 
924
                                annots.update(getattr(
 
925
                                    prop, "_dbus_annotations", {}))
 
926
                        for name, value in annots.items():
 
927
                            ann_tag = document.createElement(
 
928
                                "annotation")
 
929
                            ann_tag.setAttribute("name", name)
 
930
                            ann_tag.setAttribute("value", value)
 
931
                            tag.appendChild(ann_tag)
 
932
                # Add interface annotation tags
 
933
                for annotation, value in dict(
 
934
                    itertools.chain.from_iterable(
 
935
                        annotations().items()
 
936
                        for name, annotations
 
937
                        in self._get_all_dbus_things("interface")
 
938
                        if name == if_tag.getAttribute("name")
 
939
                        )).items():
 
940
                    ann_tag = document.createElement("annotation")
 
941
                    ann_tag.setAttribute("name", annotation)
 
942
                    ann_tag.setAttribute("value", value)
 
943
                    if_tag.appendChild(ann_tag)
 
944
                # Fix argument name for the Introspect method itself
 
945
                if (if_tag.getAttribute("name")
 
946
                                == dbus.INTROSPECTABLE_IFACE):
 
947
                    for cn in if_tag.getElementsByTagName("method"):
 
948
                        if cn.getAttribute("name") == "Introspect":
 
949
                            for arg in cn.getElementsByTagName("arg"):
 
950
                                if (arg.getAttribute("direction")
 
951
                                    == "out"):
 
952
                                    arg.setAttribute("name",
 
953
                                                     "xml_data")
 
954
            xmlstring = document.toxml("utf-8")
 
955
            document.unlink()
 
956
        except (AttributeError, xml.dom.DOMException,
 
957
                xml.parsers.expat.ExpatError) as error:
 
958
            logger.error("Failed to override Introspection method",
 
959
                         exc_info=error)
 
960
        return xmlstring
 
961
 
 
962
 
 
963
class DBusObjectWithProperties(DBusObjectWithAnnotations):
560
964
    """A D-Bus object with properties.
561
 
 
 
965
    
562
966
    Classes inheriting from this can use the dbus_service_property
563
967
    decorator to expose methods as D-Bus properties.  It exposes the
564
968
    standard Get(), Set(), and GetAll() methods on the D-Bus.
565
969
    """
566
970
    
567
 
    @staticmethod
568
 
    def _is_dbus_property(obj):
569
 
        return getattr(obj, u"_dbus_is_property", False)
570
 
    
571
 
    def _get_all_dbus_properties(self):
572
 
        """Returns a generator of (name, attribute) pairs
573
 
        """
574
 
        return ((prop._dbus_name, prop)
575
 
                for name, prop in
576
 
                inspect.getmembers(self, self._is_dbus_property))
577
 
    
578
971
    def _get_dbus_property(self, interface_name, property_name):
579
972
        """Returns a bound method if one exists which is a D-Bus
580
973
        property with the specified name and interface.
581
974
        """
582
 
        for name in (property_name,
583
 
                     property_name + u"_dbus_property"):
584
 
            prop = getattr(self, name, None)
585
 
            if (prop is None
586
 
                or not self._is_dbus_property(prop)
587
 
                or prop._dbus_name != property_name
588
 
                or (interface_name and prop._dbus_interface
589
 
                    and interface_name != prop._dbus_interface)):
590
 
                continue
591
 
            return prop
 
975
        for cls in self.__class__.__mro__:
 
976
            for name, value in inspect.getmembers(
 
977
                    cls, self._is_dbus_thing("property")):
 
978
                if (value._dbus_name == property_name
 
979
                    and value._dbus_interface == interface_name):
 
980
                    return value.__get__(self)
 
981
        
592
982
        # No such property
593
 
        raise DBusPropertyNotFound(self.dbus_object_path + u":"
594
 
                                   + interface_name + u"."
595
 
                                   + property_name)
596
 
    
597
 
    @dbus.service.method(dbus.PROPERTIES_IFACE, in_signature=u"ss",
598
 
                         out_signature=u"v")
 
983
        raise DBusPropertyNotFound("{}:{}.{}".format(
 
984
            self.dbus_object_path, interface_name, property_name))
 
985
    
 
986
    @classmethod
 
987
    def _get_all_interface_names(cls):
 
988
        """Get a sequence of all interfaces supported by an object"""
 
989
        return (name for name in set(getattr(getattr(x, attr),
 
990
                                             "_dbus_interface", None)
 
991
                                     for x in (inspect.getmro(cls))
 
992
                                     for attr in dir(x))
 
993
                if name is not None)
 
994
    
 
995
    @dbus.service.method(dbus.PROPERTIES_IFACE,
 
996
                         in_signature="ss",
 
997
                         out_signature="v")
599
998
    def Get(self, interface_name, property_name):
600
999
        """Standard D-Bus property Get() method, see D-Bus standard.
601
1000
        """
602
1001
        prop = self._get_dbus_property(interface_name, property_name)
603
 
        if prop._dbus_access == u"write":
 
1002
        if prop._dbus_access == "write":
604
1003
            raise DBusPropertyAccessException(property_name)
605
1004
        value = prop()
606
 
        if not hasattr(value, u"variant_level"):
 
1005
        if not hasattr(value, "variant_level"):
607
1006
            return value
608
1007
        return type(value)(value, variant_level=value.variant_level+1)
609
1008
    
610
 
    @dbus.service.method(dbus.PROPERTIES_IFACE, in_signature=u"ssv")
 
1009
    @dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="ssv")
611
1010
    def Set(self, interface_name, property_name, value):
612
1011
        """Standard D-Bus property Set() method, see D-Bus standard.
613
1012
        """
614
1013
        prop = self._get_dbus_property(interface_name, property_name)
615
 
        if prop._dbus_access == u"read":
 
1014
        if prop._dbus_access == "read":
616
1015
            raise DBusPropertyAccessException(property_name)
617
 
        if prop._dbus_get_args_options[u"byte_arrays"]:
 
1016
        if prop._dbus_get_args_options["byte_arrays"]:
618
1017
            # The byte_arrays option is not supported yet on
619
1018
            # signatures other than "ay".
620
 
            if prop._dbus_signature != u"ay":
621
 
                raise ValueError
622
 
            value = dbus.ByteArray(''.join(unichr(byte)
623
 
                                           for byte in value))
 
1019
            if prop._dbus_signature != "ay":
 
1020
                raise ValueError("Byte arrays not supported for non-"
 
1021
                                 "'ay' signature {!r}"
 
1022
                                 .format(prop._dbus_signature))
 
1023
            value = dbus.ByteArray(b''.join(chr(byte)
 
1024
                                            for byte in value))
624
1025
        prop(value)
625
1026
    
626
 
    @dbus.service.method(dbus.PROPERTIES_IFACE, in_signature=u"s",
627
 
                         out_signature=u"a{sv}")
 
1027
    @dbus.service.method(dbus.PROPERTIES_IFACE,
 
1028
                         in_signature="s",
 
1029
                         out_signature="a{sv}")
628
1030
    def GetAll(self, interface_name):
629
1031
        """Standard D-Bus property GetAll() method, see D-Bus
630
1032
        standard.
631
 
 
 
1033
        
632
1034
        Note: Will not include properties with access="write".
633
1035
        """
634
 
        all = {}
635
 
        for name, prop in self._get_all_dbus_properties():
 
1036
        properties = {}
 
1037
        for name, prop in self._get_all_dbus_things("property"):
636
1038
            if (interface_name
637
1039
                and interface_name != prop._dbus_interface):
638
1040
                # Interface non-empty but did not match
639
1041
                continue
640
1042
            # Ignore write-only properties
641
 
            if prop._dbus_access == u"write":
 
1043
            if prop._dbus_access == "write":
642
1044
                continue
643
1045
            value = prop()
644
 
            if not hasattr(value, u"variant_level"):
645
 
                all[name] = value
 
1046
            if not hasattr(value, "variant_level"):
 
1047
                properties[name] = value
646
1048
                continue
647
 
            all[name] = type(value)(value, variant_level=
648
 
                                    value.variant_level+1)
649
 
        return dbus.Dictionary(all, signature=u"sv")
 
1049
            properties[name] = type(value)(
 
1050
                value, variant_level = value.variant_level + 1)
 
1051
        return dbus.Dictionary(properties, signature="sv")
 
1052
    
 
1053
    @dbus.service.signal(dbus.PROPERTIES_IFACE, signature="sa{sv}as")
 
1054
    def PropertiesChanged(self, interface_name, changed_properties,
 
1055
                          invalidated_properties):
 
1056
        """Standard D-Bus PropertiesChanged() signal, see D-Bus
 
1057
        standard.
 
1058
        """
 
1059
        pass
650
1060
    
651
1061
    @dbus.service.method(dbus.INTROSPECTABLE_IFACE,
652
 
                         out_signature=u"s",
 
1062
                         out_signature="s",
653
1063
                         path_keyword='object_path',
654
1064
                         connection_keyword='connection')
655
1065
    def Introspect(self, object_path, connection):
656
 
        """Standard D-Bus method, overloaded to insert property tags.
 
1066
        """Overloading of standard D-Bus method.
 
1067
        
 
1068
        Inserts property tags and interface annotation tags.
657
1069
        """
658
 
        xmlstring = dbus.service.Object.Introspect(self, object_path,
659
 
                                                   connection)
 
1070
        xmlstring = DBusObjectWithAnnotations.Introspect(self,
 
1071
                                                         object_path,
 
1072
                                                         connection)
660
1073
        try:
661
1074
            document = xml.dom.minidom.parseString(xmlstring)
 
1075
            
662
1076
            def make_tag(document, name, prop):
663
 
                e = document.createElement(u"property")
664
 
                e.setAttribute(u"name", name)
665
 
                e.setAttribute(u"type", prop._dbus_signature)
666
 
                e.setAttribute(u"access", prop._dbus_access)
 
1077
                e = document.createElement("property")
 
1078
                e.setAttribute("name", name)
 
1079
                e.setAttribute("type", prop._dbus_signature)
 
1080
                e.setAttribute("access", prop._dbus_access)
667
1081
                return e
668
 
            for if_tag in document.getElementsByTagName(u"interface"):
 
1082
            
 
1083
            for if_tag in document.getElementsByTagName("interface"):
 
1084
                # Add property tags
669
1085
                for tag in (make_tag(document, name, prop)
670
1086
                            for name, prop
671
 
                            in self._get_all_dbus_properties()
 
1087
                            in self._get_all_dbus_things("property")
672
1088
                            if prop._dbus_interface
673
 
                            == if_tag.getAttribute(u"name")):
 
1089
                            == if_tag.getAttribute("name")):
674
1090
                    if_tag.appendChild(tag)
 
1091
                # Add annotation tags for properties
 
1092
                for tag in if_tag.getElementsByTagName("property"):
 
1093
                    annots = dict()
 
1094
                    for name, prop in self._get_all_dbus_things(
 
1095
                            "property"):
 
1096
                        if (name == tag.getAttribute("name")
 
1097
                            and prop._dbus_interface
 
1098
                            == if_tag.getAttribute("name")):
 
1099
                            annots.update(getattr(
 
1100
                                prop, "_dbus_annotations", {}))
 
1101
                    for name, value in annots.items():
 
1102
                        ann_tag = document.createElement(
 
1103
                            "annotation")
 
1104
                        ann_tag.setAttribute("name", name)
 
1105
                        ann_tag.setAttribute("value", value)
 
1106
                        tag.appendChild(ann_tag)
675
1107
                # Add the names to the return values for the
676
1108
                # "org.freedesktop.DBus.Properties" methods
677
 
                if (if_tag.getAttribute(u"name")
678
 
                    == u"org.freedesktop.DBus.Properties"):
679
 
                    for cn in if_tag.getElementsByTagName(u"method"):
680
 
                        if cn.getAttribute(u"name") == u"Get":
681
 
                            for arg in cn.getElementsByTagName(u"arg"):
682
 
                                if (arg.getAttribute(u"direction")
683
 
                                    == u"out"):
684
 
                                    arg.setAttribute(u"name", u"value")
685
 
                        elif cn.getAttribute(u"name") == u"GetAll":
686
 
                            for arg in cn.getElementsByTagName(u"arg"):
687
 
                                if (arg.getAttribute(u"direction")
688
 
                                    == u"out"):
689
 
                                    arg.setAttribute(u"name", u"props")
690
 
            xmlstring = document.toxml(u"utf-8")
691
 
            document.unlink()
692
 
        except (AttributeError, xml.dom.DOMException,
693
 
                xml.parsers.expat.ExpatError), error:
694
 
            logger.error(u"Failed to override Introspection method",
695
 
                         error)
696
 
        return xmlstring
697
 
 
698
 
 
 
1109
                if (if_tag.getAttribute("name")
 
1110
                    == "org.freedesktop.DBus.Properties"):
 
1111
                    for cn in if_tag.getElementsByTagName("method"):
 
1112
                        if cn.getAttribute("name") == "Get":
 
1113
                            for arg in cn.getElementsByTagName("arg"):
 
1114
                                if (arg.getAttribute("direction")
 
1115
                                    == "out"):
 
1116
                                    arg.setAttribute("name", "value")
 
1117
                        elif cn.getAttribute("name") == "GetAll":
 
1118
                            for arg in cn.getElementsByTagName("arg"):
 
1119
                                if (arg.getAttribute("direction")
 
1120
                                    == "out"):
 
1121
                                    arg.setAttribute("name", "props")
 
1122
            xmlstring = document.toxml("utf-8")
 
1123
            document.unlink()
 
1124
        except (AttributeError, xml.dom.DOMException,
 
1125
                xml.parsers.expat.ExpatError) as error:
 
1126
            logger.error("Failed to override Introspection method",
 
1127
                         exc_info=error)
 
1128
        return xmlstring
 
1129
 
 
1130
try:
 
1131
    dbus.OBJECT_MANAGER_IFACE
 
1132
except AttributeError:
 
1133
    dbus.OBJECT_MANAGER_IFACE = "org.freedesktop.DBus.ObjectManager"
 
1134
 
 
1135
class DBusObjectWithObjectManager(DBusObjectWithAnnotations):
 
1136
    """A D-Bus object with an ObjectManager.
 
1137
    
 
1138
    Classes inheriting from this exposes the standard
 
1139
    GetManagedObjects call and the InterfacesAdded and
 
1140
    InterfacesRemoved signals on the standard
 
1141
    "org.freedesktop.DBus.ObjectManager" interface.
 
1142
    
 
1143
    Note: No signals are sent automatically; they must be sent
 
1144
    manually.
 
1145
    """
 
1146
    @dbus.service.method(dbus.OBJECT_MANAGER_IFACE,
 
1147
                         out_signature = "a{oa{sa{sv}}}")
 
1148
    def GetManagedObjects(self):
 
1149
        """This function must be overridden"""
 
1150
        raise NotImplementedError()
 
1151
    
 
1152
    @dbus.service.signal(dbus.OBJECT_MANAGER_IFACE,
 
1153
                         signature = "oa{sa{sv}}")
 
1154
    def InterfacesAdded(self, object_path, interfaces_and_properties):
 
1155
        pass
 
1156
    
 
1157
    @dbus.service.signal(dbus.OBJECT_MANAGER_IFACE,
 
1158
                         signature = "oas")
 
1159
    def InterfacesRemoved(self, object_path, interfaces):
 
1160
        pass
 
1161
    
 
1162
    @dbus.service.method(dbus.INTROSPECTABLE_IFACE,
 
1163
                         out_signature = "s",
 
1164
                         path_keyword = 'object_path',
 
1165
                         connection_keyword = 'connection')
 
1166
    def Introspect(self, object_path, connection):
 
1167
        """Overloading of standard D-Bus method.
 
1168
        
 
1169
        Override return argument name of GetManagedObjects to be
 
1170
        "objpath_interfaces_and_properties"
 
1171
        """
 
1172
        xmlstring = DBusObjectWithAnnotations(self, object_path,
 
1173
                                              connection)
 
1174
        try:
 
1175
            document = xml.dom.minidom.parseString(xmlstring)
 
1176
            
 
1177
            for if_tag in document.getElementsByTagName("interface"):
 
1178
                # Fix argument name for the GetManagedObjects method
 
1179
                if (if_tag.getAttribute("name")
 
1180
                                == dbus.OBJECT_MANAGER_IFACE):
 
1181
                    for cn in if_tag.getElementsByTagName("method"):
 
1182
                        if (cn.getAttribute("name")
 
1183
                            == "GetManagedObjects"):
 
1184
                            for arg in cn.getElementsByTagName("arg"):
 
1185
                                if (arg.getAttribute("direction")
 
1186
                                    == "out"):
 
1187
                                    arg.setAttribute(
 
1188
                                        "name",
 
1189
                                        "objpath_interfaces"
 
1190
                                        "_and_properties")
 
1191
            xmlstring = document.toxml("utf-8")
 
1192
            document.unlink()
 
1193
        except (AttributeError, xml.dom.DOMException,
 
1194
                xml.parsers.expat.ExpatError) as error:
 
1195
            logger.error("Failed to override Introspection method",
 
1196
                         exc_info = error)
 
1197
        return xmlstring
 
1198
 
 
1199
def datetime_to_dbus(dt, variant_level=0):
 
1200
    """Convert a UTC datetime.datetime() to a D-Bus type."""
 
1201
    if dt is None:
 
1202
        return dbus.String("", variant_level = variant_level)
 
1203
    return dbus.String(dt.isoformat(), variant_level=variant_level)
 
1204
 
 
1205
 
 
1206
def alternate_dbus_interfaces(alt_interface_names, deprecate=True):
 
1207
    """A class decorator; applied to a subclass of
 
1208
    dbus.service.Object, it will add alternate D-Bus attributes with
 
1209
    interface names according to the "alt_interface_names" mapping.
 
1210
    Usage:
 
1211
    
 
1212
    @alternate_dbus_interfaces({"org.example.Interface":
 
1213
                                    "net.example.AlternateInterface"})
 
1214
    class SampleDBusObject(dbus.service.Object):
 
1215
        @dbus.service.method("org.example.Interface")
 
1216
        def SampleDBusMethod():
 
1217
            pass
 
1218
    
 
1219
    The above "SampleDBusMethod" on "SampleDBusObject" will be
 
1220
    reachable via two interfaces: "org.example.Interface" and
 
1221
    "net.example.AlternateInterface", the latter of which will have
 
1222
    its D-Bus annotation "org.freedesktop.DBus.Deprecated" set to
 
1223
    "true", unless "deprecate" is passed with a False value.
 
1224
    
 
1225
    This works for methods and signals, and also for D-Bus properties
 
1226
    (from DBusObjectWithProperties) and interfaces (from the
 
1227
    dbus_interface_annotations decorator).
 
1228
    """
 
1229
    
 
1230
    def wrapper(cls):
 
1231
        for orig_interface_name, alt_interface_name in (
 
1232
                alt_interface_names.items()):
 
1233
            attr = {}
 
1234
            interface_names = set()
 
1235
            # Go though all attributes of the class
 
1236
            for attrname, attribute in inspect.getmembers(cls):
 
1237
                # Ignore non-D-Bus attributes, and D-Bus attributes
 
1238
                # with the wrong interface name
 
1239
                if (not hasattr(attribute, "_dbus_interface")
 
1240
                    or not attribute._dbus_interface.startswith(
 
1241
                        orig_interface_name)):
 
1242
                    continue
 
1243
                # Create an alternate D-Bus interface name based on
 
1244
                # the current name
 
1245
                alt_interface = attribute._dbus_interface.replace(
 
1246
                    orig_interface_name, alt_interface_name)
 
1247
                interface_names.add(alt_interface)
 
1248
                # Is this a D-Bus signal?
 
1249
                if getattr(attribute, "_dbus_is_signal", False):
 
1250
                    if sys.version_info.major == 2:
 
1251
                        # Extract the original non-method undecorated
 
1252
                        # function by black magic
 
1253
                        nonmethod_func = (dict(
 
1254
                            zip(attribute.func_code.co_freevars,
 
1255
                                attribute.__closure__))
 
1256
                                          ["func"].cell_contents)
 
1257
                    else:
 
1258
                        nonmethod_func = attribute
 
1259
                    # Create a new, but exactly alike, function
 
1260
                    # object, and decorate it to be a new D-Bus signal
 
1261
                    # with the alternate D-Bus interface name
 
1262
                    if sys.version_info.major == 2:
 
1263
                        new_function = types.FunctionType(
 
1264
                            nonmethod_func.func_code,
 
1265
                            nonmethod_func.func_globals,
 
1266
                            nonmethod_func.func_name,
 
1267
                            nonmethod_func.func_defaults,
 
1268
                            nonmethod_func.func_closure)
 
1269
                    else:
 
1270
                        new_function = types.FunctionType(
 
1271
                            nonmethod_func.__code__,
 
1272
                            nonmethod_func.__globals__,
 
1273
                            nonmethod_func.__name__,
 
1274
                            nonmethod_func.__defaults__,
 
1275
                            nonmethod_func.__closure__)
 
1276
                    new_function = (dbus.service.signal(
 
1277
                        alt_interface,
 
1278
                        attribute._dbus_signature)(new_function))
 
1279
                    # Copy annotations, if any
 
1280
                    try:
 
1281
                        new_function._dbus_annotations = dict(
 
1282
                            attribute._dbus_annotations)
 
1283
                    except AttributeError:
 
1284
                        pass
 
1285
                    # Define a creator of a function to call both the
 
1286
                    # original and alternate functions, so both the
 
1287
                    # original and alternate signals gets sent when
 
1288
                    # the function is called
 
1289
                    def fixscope(func1, func2):
 
1290
                        """This function is a scope container to pass
 
1291
                        func1 and func2 to the "call_both" function
 
1292
                        outside of its arguments"""
 
1293
                        
 
1294
                        def call_both(*args, **kwargs):
 
1295
                            """This function will emit two D-Bus
 
1296
                            signals by calling func1 and func2"""
 
1297
                            func1(*args, **kwargs)
 
1298
                            func2(*args, **kwargs)
 
1299
                        
 
1300
                        return call_both
 
1301
                    # Create the "call_both" function and add it to
 
1302
                    # the class
 
1303
                    attr[attrname] = fixscope(attribute, new_function)
 
1304
                # Is this a D-Bus method?
 
1305
                elif getattr(attribute, "_dbus_is_method", False):
 
1306
                    # Create a new, but exactly alike, function
 
1307
                    # object.  Decorate it to be a new D-Bus method
 
1308
                    # with the alternate D-Bus interface name.  Add it
 
1309
                    # to the class.
 
1310
                    attr[attrname] = (
 
1311
                        dbus.service.method(
 
1312
                            alt_interface,
 
1313
                            attribute._dbus_in_signature,
 
1314
                            attribute._dbus_out_signature)
 
1315
                        (types.FunctionType(attribute.func_code,
 
1316
                                            attribute.func_globals,
 
1317
                                            attribute.func_name,
 
1318
                                            attribute.func_defaults,
 
1319
                                            attribute.func_closure)))
 
1320
                    # Copy annotations, if any
 
1321
                    try:
 
1322
                        attr[attrname]._dbus_annotations = dict(
 
1323
                            attribute._dbus_annotations)
 
1324
                    except AttributeError:
 
1325
                        pass
 
1326
                # Is this a D-Bus property?
 
1327
                elif getattr(attribute, "_dbus_is_property", False):
 
1328
                    # Create a new, but exactly alike, function
 
1329
                    # object, and decorate it to be a new D-Bus
 
1330
                    # property with the alternate D-Bus interface
 
1331
                    # name.  Add it to the class.
 
1332
                    attr[attrname] = (dbus_service_property(
 
1333
                        alt_interface, attribute._dbus_signature,
 
1334
                        attribute._dbus_access,
 
1335
                        attribute._dbus_get_args_options
 
1336
                        ["byte_arrays"])
 
1337
                                      (types.FunctionType(
 
1338
                                          attribute.func_code,
 
1339
                                          attribute.func_globals,
 
1340
                                          attribute.func_name,
 
1341
                                          attribute.func_defaults,
 
1342
                                          attribute.func_closure)))
 
1343
                    # Copy annotations, if any
 
1344
                    try:
 
1345
                        attr[attrname]._dbus_annotations = dict(
 
1346
                            attribute._dbus_annotations)
 
1347
                    except AttributeError:
 
1348
                        pass
 
1349
                # Is this a D-Bus interface?
 
1350
                elif getattr(attribute, "_dbus_is_interface", False):
 
1351
                    # Create a new, but exactly alike, function
 
1352
                    # object.  Decorate it to be a new D-Bus interface
 
1353
                    # with the alternate D-Bus interface name.  Add it
 
1354
                    # to the class.
 
1355
                    attr[attrname] = (
 
1356
                        dbus_interface_annotations(alt_interface)
 
1357
                        (types.FunctionType(attribute.func_code,
 
1358
                                            attribute.func_globals,
 
1359
                                            attribute.func_name,
 
1360
                                            attribute.func_defaults,
 
1361
                                            attribute.func_closure)))
 
1362
            if deprecate:
 
1363
                # Deprecate all alternate interfaces
 
1364
                iname="_AlternateDBusNames_interface_annotation{}"
 
1365
                for interface_name in interface_names:
 
1366
                    
 
1367
                    @dbus_interface_annotations(interface_name)
 
1368
                    def func(self):
 
1369
                        return { "org.freedesktop.DBus.Deprecated":
 
1370
                                 "true" }
 
1371
                    # Find an unused name
 
1372
                    for aname in (iname.format(i)
 
1373
                                  for i in itertools.count()):
 
1374
                        if aname not in attr:
 
1375
                            attr[aname] = func
 
1376
                            break
 
1377
            if interface_names:
 
1378
                # Replace the class with a new subclass of it with
 
1379
                # methods, signals, etc. as created above.
 
1380
                cls = type(b"{}Alternate".format(cls.__name__),
 
1381
                           (cls, ), attr)
 
1382
        return cls
 
1383
    
 
1384
    return wrapper
 
1385
 
 
1386
 
 
1387
@alternate_dbus_interfaces({"se.recompile.Mandos":
 
1388
                            "se.bsnet.fukt.Mandos"})
699
1389
class ClientDBus(Client, DBusObjectWithProperties):
700
1390
    """A Client class using D-Bus
701
1391
    
703
1393
    dbus_object_path: dbus.ObjectPath
704
1394
    bus: dbus.SystemBus()
705
1395
    """
 
1396
    
 
1397
    runtime_expansions = (Client.runtime_expansions
 
1398
                          + ("dbus_object_path", ))
 
1399
    
 
1400
    _interface = "se.recompile.Mandos.Client"
 
1401
    
706
1402
    # dbus.service.Object doesn't use super(), so we can't either.
707
1403
    
708
1404
    def __init__(self, bus = None, *args, **kwargs):
709
 
        self._approvals_pending = 0
710
1405
        self.bus = bus
711
1406
        Client.__init__(self, *args, **kwargs)
712
1407
        # Only now, when this client is initialized, can it show up on
713
1408
        # the D-Bus
714
 
        self.dbus_object_path = (dbus.ObjectPath
715
 
                                 (u"/clients/"
716
 
                                  + self.name.replace(u".", u"_")))
 
1409
        client_object_name = str(self.name).translate(
 
1410
            {ord("."): ord("_"),
 
1411
             ord("-"): ord("_")})
 
1412
        self.dbus_object_path = dbus.ObjectPath(
 
1413
            "/clients/" + client_object_name)
717
1414
        DBusObjectWithProperties.__init__(self, self.bus,
718
1415
                                          self.dbus_object_path)
719
 
 
720
 
    def _get_approvals_pending(self):
721
 
        return self._approvals_pending
722
 
    def _set_approvals_pending(self, value):
723
 
        old_value = self._approvals_pending
724
 
        self._approvals_pending = value
725
 
        bval = bool(value)
726
 
        if (hasattr(self, "dbus_object_path")
727
 
            and bval is not bool(old_value)):
728
 
            dbus_bool = dbus.Boolean(bval, variant_level=1)
729
 
            self.PropertyChanged(dbus.String(u"approved_pending"),
730
 
                                 dbus_bool)
731
 
 
732
 
    approvals_pending = property(_get_approvals_pending,
733
 
                                 _set_approvals_pending)
734
 
    del _get_approvals_pending, _set_approvals_pending
735
 
    
736
 
    @staticmethod
737
 
    def _datetime_to_dbus(dt, variant_level=0):
738
 
        """Convert a UTC datetime.datetime() to a D-Bus type."""
739
 
        return dbus.String(dt.isoformat(),
740
 
                           variant_level=variant_level)
741
 
    
742
 
    def enable(self):
743
 
        oldstate = getattr(self, u"enabled", False)
744
 
        r = Client.enable(self)
745
 
        if oldstate != self.enabled:
746
 
            # Emit D-Bus signals
747
 
            self.PropertyChanged(dbus.String(u"enabled"),
748
 
                                 dbus.Boolean(True, variant_level=1))
749
 
            self.PropertyChanged(
750
 
                dbus.String(u"last_enabled"),
751
 
                self._datetime_to_dbus(self.last_enabled,
752
 
                                       variant_level=1))
753
 
        return r
754
 
    
755
 
    def disable(self, quiet = False):
756
 
        oldstate = getattr(self, u"enabled", False)
757
 
        r = Client.disable(self, quiet=quiet)
758
 
        if not quiet and oldstate != self.enabled:
759
 
            # Emit D-Bus signal
760
 
            self.PropertyChanged(dbus.String(u"enabled"),
761
 
                                 dbus.Boolean(False, variant_level=1))
762
 
        return r
 
1416
    
 
1417
    def notifychangeproperty(transform_func, dbus_name,
 
1418
                             type_func=lambda x: x,
 
1419
                             variant_level=1,
 
1420
                             invalidate_only=False,
 
1421
                             _interface=_interface):
 
1422
        """ Modify a variable so that it's a property which announces
 
1423
        its changes to DBus.
 
1424
        
 
1425
        transform_fun: Function that takes a value and a variant_level
 
1426
                       and transforms it to a D-Bus type.
 
1427
        dbus_name: D-Bus name of the variable
 
1428
        type_func: Function that transform the value before sending it
 
1429
                   to the D-Bus.  Default: no transform
 
1430
        variant_level: D-Bus variant level.  Default: 1
 
1431
        """
 
1432
        attrname = "_{}".format(dbus_name)
 
1433
        
 
1434
        def setter(self, value):
 
1435
            if hasattr(self, "dbus_object_path"):
 
1436
                if (not hasattr(self, attrname) or
 
1437
                    type_func(getattr(self, attrname, None))
 
1438
                    != type_func(value)):
 
1439
                    if invalidate_only:
 
1440
                        self.PropertiesChanged(
 
1441
                            _interface, dbus.Dictionary(),
 
1442
                            dbus.Array((dbus_name, )))
 
1443
                    else:
 
1444
                        dbus_value = transform_func(
 
1445
                            type_func(value),
 
1446
                            variant_level = variant_level)
 
1447
                        self.PropertyChanged(dbus.String(dbus_name),
 
1448
                                             dbus_value)
 
1449
                        self.PropertiesChanged(
 
1450
                            _interface,
 
1451
                            dbus.Dictionary({ dbus.String(dbus_name):
 
1452
                                              dbus_value }),
 
1453
                            dbus.Array())
 
1454
            setattr(self, attrname, value)
 
1455
        
 
1456
        return property(lambda self: getattr(self, attrname), setter)
 
1457
    
 
1458
    expires = notifychangeproperty(datetime_to_dbus, "Expires")
 
1459
    approvals_pending = notifychangeproperty(dbus.Boolean,
 
1460
                                             "ApprovalPending",
 
1461
                                             type_func = bool)
 
1462
    enabled = notifychangeproperty(dbus.Boolean, "Enabled")
 
1463
    last_enabled = notifychangeproperty(datetime_to_dbus,
 
1464
                                        "LastEnabled")
 
1465
    checker = notifychangeproperty(
 
1466
        dbus.Boolean, "CheckerRunning",
 
1467
        type_func = lambda checker: checker is not None)
 
1468
    last_checked_ok = notifychangeproperty(datetime_to_dbus,
 
1469
                                           "LastCheckedOK")
 
1470
    last_checker_status = notifychangeproperty(dbus.Int16,
 
1471
                                               "LastCheckerStatus")
 
1472
    last_approval_request = notifychangeproperty(
 
1473
        datetime_to_dbus, "LastApprovalRequest")
 
1474
    approved_by_default = notifychangeproperty(dbus.Boolean,
 
1475
                                               "ApprovedByDefault")
 
1476
    approval_delay = notifychangeproperty(
 
1477
        dbus.UInt64, "ApprovalDelay",
 
1478
        type_func = lambda td: td.total_seconds() * 1000)
 
1479
    approval_duration = notifychangeproperty(
 
1480
        dbus.UInt64, "ApprovalDuration",
 
1481
        type_func = lambda td: td.total_seconds() * 1000)
 
1482
    host = notifychangeproperty(dbus.String, "Host")
 
1483
    timeout = notifychangeproperty(
 
1484
        dbus.UInt64, "Timeout",
 
1485
        type_func = lambda td: td.total_seconds() * 1000)
 
1486
    extended_timeout = notifychangeproperty(
 
1487
        dbus.UInt64, "ExtendedTimeout",
 
1488
        type_func = lambda td: td.total_seconds() * 1000)
 
1489
    interval = notifychangeproperty(
 
1490
        dbus.UInt64, "Interval",
 
1491
        type_func = lambda td: td.total_seconds() * 1000)
 
1492
    checker_command = notifychangeproperty(dbus.String, "Checker")
 
1493
    secret = notifychangeproperty(dbus.ByteArray, "Secret",
 
1494
                                  invalidate_only=True)
 
1495
    
 
1496
    del notifychangeproperty
763
1497
    
764
1498
    def __del__(self, *args, **kwargs):
765
1499
        try:
766
1500
            self.remove_from_connection()
767
1501
        except LookupError:
768
1502
            pass
769
 
        if hasattr(DBusObjectWithProperties, u"__del__"):
 
1503
        if hasattr(DBusObjectWithProperties, "__del__"):
770
1504
            DBusObjectWithProperties.__del__(self, *args, **kwargs)
771
1505
        Client.__del__(self, *args, **kwargs)
772
1506
    
773
 
    def checker_callback(self, pid, condition, command,
774
 
                         *args, **kwargs):
775
 
        self.checker_callback_tag = None
776
 
        self.checker = None
777
 
        # Emit D-Bus signal
778
 
        self.PropertyChanged(dbus.String(u"checker_running"),
779
 
                             dbus.Boolean(False, variant_level=1))
780
 
        if os.WIFEXITED(condition):
781
 
            exitstatus = os.WEXITSTATUS(condition)
 
1507
    def checker_callback(self, source, condition,
 
1508
                         connection, command, *args, **kwargs):
 
1509
        ret = Client.checker_callback(self, source, condition,
 
1510
                                      connection, command, *args,
 
1511
                                      **kwargs)
 
1512
        exitstatus = self.last_checker_status
 
1513
        if exitstatus >= 0:
782
1514
            # Emit D-Bus signal
783
1515
            self.CheckerCompleted(dbus.Int16(exitstatus),
784
 
                                  dbus.Int64(condition),
 
1516
                                  # This is specific to GNU libC
 
1517
                                  dbus.Int64(exitstatus << 8),
785
1518
                                  dbus.String(command))
786
1519
        else:
787
1520
            # Emit D-Bus signal
788
1521
            self.CheckerCompleted(dbus.Int16(-1),
789
 
                                  dbus.Int64(condition),
 
1522
                                  dbus.Int64(
 
1523
                                      # This is specific to GNU libC
 
1524
                                      (exitstatus << 8)
 
1525
                                      | self.last_checker_signal),
790
1526
                                  dbus.String(command))
791
 
        
792
 
        return Client.checker_callback(self, pid, condition, command,
793
 
                                       *args, **kwargs)
794
 
    
795
 
    def checked_ok(self, *args, **kwargs):
796
 
        r = Client.checked_ok(self, *args, **kwargs)
797
 
        # Emit D-Bus signal
798
 
        self.PropertyChanged(
799
 
            dbus.String(u"last_checked_ok"),
800
 
            (self._datetime_to_dbus(self.last_checked_ok,
801
 
                                    variant_level=1)))
802
 
        return r
 
1527
        return ret
803
1528
    
804
1529
    def start_checker(self, *args, **kwargs):
805
 
        old_checker = self.checker
806
 
        if self.checker is not None:
807
 
            old_checker_pid = self.checker.pid
808
 
        else:
809
 
            old_checker_pid = None
 
1530
        old_checker_pid = getattr(self.checker, "pid", None)
810
1531
        r = Client.start_checker(self, *args, **kwargs)
811
1532
        # Only if new checker process was started
812
1533
        if (self.checker is not None
813
1534
            and old_checker_pid != self.checker.pid):
814
1535
            # Emit D-Bus signal
815
1536
            self.CheckerStarted(self.current_checker_command)
816
 
            self.PropertyChanged(
817
 
                dbus.String(u"checker_running"),
818
 
                dbus.Boolean(True, variant_level=1))
819
1537
        return r
820
1538
    
821
 
    def stop_checker(self, *args, **kwargs):
822
 
        old_checker = getattr(self, u"checker", None)
823
 
        r = Client.stop_checker(self, *args, **kwargs)
824
 
        if (old_checker is not None
825
 
            and getattr(self, u"checker", None) is None):
826
 
            self.PropertyChanged(dbus.String(u"checker_running"),
827
 
                                 dbus.Boolean(False, variant_level=1))
828
 
        return r
829
 
 
830
1539
    def _reset_approved(self):
831
 
        self._approved = None
 
1540
        self.approved = None
832
1541
        return False
833
1542
    
834
1543
    def approve(self, value=True):
 
1544
        self.approved = value
 
1545
        gobject.timeout_add(int(self.approval_duration.total_seconds()
 
1546
                                * 1000), self._reset_approved)
835
1547
        self.send_changedstate()
836
 
        self._approved = value
837
 
        gobject.timeout_add(self._timedelta_to_milliseconds(self.approved_duration),
838
 
                            self._reset_approved)
839
 
    
840
1548
    
841
1549
    ## D-Bus methods, signals & properties
842
 
    _interface = u"se.bsnet.fukt.Mandos.Client"
 
1550
    
 
1551
    ## Interfaces
843
1552
    
844
1553
    ## Signals
845
1554
    
846
1555
    # CheckerCompleted - signal
847
 
    @dbus.service.signal(_interface, signature=u"nxs")
 
1556
    @dbus.service.signal(_interface, signature="nxs")
848
1557
    def CheckerCompleted(self, exitcode, waitstatus, command):
849
1558
        "D-Bus signal"
850
1559
        pass
851
1560
    
852
1561
    # CheckerStarted - signal
853
 
    @dbus.service.signal(_interface, signature=u"s")
 
1562
    @dbus.service.signal(_interface, signature="s")
854
1563
    def CheckerStarted(self, command):
855
1564
        "D-Bus signal"
856
1565
        pass
857
1566
    
858
1567
    # PropertyChanged - signal
859
 
    @dbus.service.signal(_interface, signature=u"sv")
 
1568
    @dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})
 
1569
    @dbus.service.signal(_interface, signature="sv")
860
1570
    def PropertyChanged(self, property, value):
861
1571
        "D-Bus signal"
862
1572
        pass
871
1581
        pass
872
1582
    
873
1583
    # Rejected - signal
874
 
    @dbus.service.signal(_interface, signature=u"s")
 
1584
    @dbus.service.signal(_interface, signature="s")
875
1585
    def Rejected(self, reason):
876
1586
        "D-Bus signal"
877
1587
        pass
878
1588
    
879
1589
    # NeedApproval - signal
880
 
    @dbus.service.signal(_interface, signature=u"db")
 
1590
    @dbus.service.signal(_interface, signature="tb")
881
1591
    def NeedApproval(self, timeout, default):
882
1592
        "D-Bus signal"
883
 
        pass
 
1593
        return self.need_approval()
884
1594
    
885
1595
    ## Methods
886
 
 
 
1596
    
887
1597
    # Approve - method
888
 
    @dbus.service.method(_interface, in_signature=u"b")
 
1598
    @dbus.service.method(_interface, in_signature="b")
889
1599
    def Approve(self, value):
890
1600
        self.approve(value)
891
 
 
 
1601
    
892
1602
    # CheckedOK - method
893
1603
    @dbus.service.method(_interface)
894
1604
    def CheckedOK(self):
895
 
        return self.checked_ok()
 
1605
        self.checked_ok()
896
1606
    
897
1607
    # Enable - method
 
1608
    @dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})
898
1609
    @dbus.service.method(_interface)
899
1610
    def Enable(self):
900
1611
        "D-Bus method"
901
1612
        self.enable()
902
1613
    
903
1614
    # StartChecker - method
 
1615
    @dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})
904
1616
    @dbus.service.method(_interface)
905
1617
    def StartChecker(self):
906
1618
        "D-Bus method"
907
1619
        self.start_checker()
908
1620
    
909
1621
    # Disable - method
 
1622
    @dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})
910
1623
    @dbus.service.method(_interface)
911
1624
    def Disable(self):
912
1625
        "D-Bus method"
913
1626
        self.disable()
914
1627
    
915
1628
    # StopChecker - method
 
1629
    @dbus_annotations({"org.freedesktop.DBus.Deprecated": "true"})
916
1630
    @dbus.service.method(_interface)
917
1631
    def StopChecker(self):
918
1632
        self.stop_checker()
919
1633
    
920
1634
    ## Properties
921
1635
    
922
 
    # approved_pending - property
923
 
    @dbus_service_property(_interface, signature=u"b", access=u"read")
924
 
    def approved_pending_dbus_property(self):
 
1636
    # ApprovalPending - property
 
1637
    @dbus_service_property(_interface, signature="b", access="read")
 
1638
    def ApprovalPending_dbus_property(self):
925
1639
        return dbus.Boolean(bool(self.approvals_pending))
926
1640
    
927
 
    # approved_by_default - property
928
 
    @dbus_service_property(_interface, signature=u"b",
929
 
                           access=u"readwrite")
930
 
    def approved_by_default_dbus_property(self):
931
 
        return dbus.Boolean(self.approved_by_default)
932
 
    
933
 
    # approved_delay - property
934
 
    @dbus_service_property(_interface, signature=u"t",
935
 
                           access=u"readwrite")
936
 
    def approved_delay_dbus_property(self):
937
 
        return dbus.UInt64(self.approved_delay_milliseconds())
938
 
    
939
 
    # approved_duration - property
940
 
    @dbus_service_property(_interface, signature=u"t",
941
 
                           access=u"readwrite")
942
 
    def approved_duration_dbus_property(self):
943
 
        return dbus.UInt64(self._timedelta_to_milliseconds(
944
 
                self.approved_duration))
945
 
    
946
 
    # name - property
947
 
    @dbus_service_property(_interface, signature=u"s", access=u"read")
948
 
    def name_dbus_property(self):
 
1641
    # ApprovedByDefault - property
 
1642
    @dbus_service_property(_interface,
 
1643
                           signature="b",
 
1644
                           access="readwrite")
 
1645
    def ApprovedByDefault_dbus_property(self, value=None):
 
1646
        if value is None:       # get
 
1647
            return dbus.Boolean(self.approved_by_default)
 
1648
        self.approved_by_default = bool(value)
 
1649
    
 
1650
    # ApprovalDelay - property
 
1651
    @dbus_service_property(_interface,
 
1652
                           signature="t",
 
1653
                           access="readwrite")
 
1654
    def ApprovalDelay_dbus_property(self, value=None):
 
1655
        if value is None:       # get
 
1656
            return dbus.UInt64(self.approval_delay.total_seconds()
 
1657
                               * 1000)
 
1658
        self.approval_delay = datetime.timedelta(0, 0, 0, value)
 
1659
    
 
1660
    # ApprovalDuration - property
 
1661
    @dbus_service_property(_interface,
 
1662
                           signature="t",
 
1663
                           access="readwrite")
 
1664
    def ApprovalDuration_dbus_property(self, value=None):
 
1665
        if value is None:       # get
 
1666
            return dbus.UInt64(self.approval_duration.total_seconds()
 
1667
                               * 1000)
 
1668
        self.approval_duration = datetime.timedelta(0, 0, 0, value)
 
1669
    
 
1670
    # Name - property
 
1671
    @dbus_annotations(
 
1672
        {"org.freedesktop.DBus.Property.EmitsChangedSignal": "const"})
 
1673
    @dbus_service_property(_interface, signature="s", access="read")
 
1674
    def Name_dbus_property(self):
949
1675
        return dbus.String(self.name)
950
1676
    
951
 
    # fingerprint - property
952
 
    @dbus_service_property(_interface, signature=u"s", access=u"read")
953
 
    def fingerprint_dbus_property(self):
 
1677
    # Fingerprint - property
 
1678
    @dbus_annotations(
 
1679
        {"org.freedesktop.DBus.Property.EmitsChangedSignal": "const"})
 
1680
    @dbus_service_property(_interface, signature="s", access="read")
 
1681
    def Fingerprint_dbus_property(self):
954
1682
        return dbus.String(self.fingerprint)
955
1683
    
956
 
    # host - property
957
 
    @dbus_service_property(_interface, signature=u"s",
958
 
                           access=u"readwrite")
959
 
    def host_dbus_property(self, value=None):
 
1684
    # Host - property
 
1685
    @dbus_service_property(_interface,
 
1686
                           signature="s",
 
1687
                           access="readwrite")
 
1688
    def Host_dbus_property(self, value=None):
960
1689
        if value is None:       # get
961
1690
            return dbus.String(self.host)
962
 
        self.host = value
963
 
        # Emit D-Bus signal
964
 
        self.PropertyChanged(dbus.String(u"host"),
965
 
                             dbus.String(value, variant_level=1))
966
 
    
967
 
    # created - property
968
 
    @dbus_service_property(_interface, signature=u"s", access=u"read")
969
 
    def created_dbus_property(self):
970
 
        return dbus.String(self._datetime_to_dbus(self.created))
971
 
    
972
 
    # last_enabled - property
973
 
    @dbus_service_property(_interface, signature=u"s", access=u"read")
974
 
    def last_enabled_dbus_property(self):
975
 
        if self.last_enabled is None:
976
 
            return dbus.String(u"")
977
 
        return dbus.String(self._datetime_to_dbus(self.last_enabled))
978
 
    
979
 
    # enabled - property
980
 
    @dbus_service_property(_interface, signature=u"b",
981
 
                           access=u"readwrite")
982
 
    def enabled_dbus_property(self, value=None):
 
1691
        self.host = str(value)
 
1692
    
 
1693
    # Created - property
 
1694
    @dbus_annotations(
 
1695
        {"org.freedesktop.DBus.Property.EmitsChangedSignal": "const"})
 
1696
    @dbus_service_property(_interface, signature="s", access="read")
 
1697
    def Created_dbus_property(self):
 
1698
        return datetime_to_dbus(self.created)
 
1699
    
 
1700
    # LastEnabled - property
 
1701
    @dbus_service_property(_interface, signature="s", access="read")
 
1702
    def LastEnabled_dbus_property(self):
 
1703
        return datetime_to_dbus(self.last_enabled)
 
1704
    
 
1705
    # Enabled - property
 
1706
    @dbus_service_property(_interface,
 
1707
                           signature="b",
 
1708
                           access="readwrite")
 
1709
    def Enabled_dbus_property(self, value=None):
983
1710
        if value is None:       # get
984
1711
            return dbus.Boolean(self.enabled)
985
1712
        if value:
987
1714
        else:
988
1715
            self.disable()
989
1716
    
990
 
    # last_checked_ok - property
991
 
    @dbus_service_property(_interface, signature=u"s",
992
 
                           access=u"readwrite")
993
 
    def last_checked_ok_dbus_property(self, value=None):
 
1717
    # LastCheckedOK - property
 
1718
    @dbus_service_property(_interface,
 
1719
                           signature="s",
 
1720
                           access="readwrite")
 
1721
    def LastCheckedOK_dbus_property(self, value=None):
994
1722
        if value is not None:
995
1723
            self.checked_ok()
996
1724
            return
997
 
        if self.last_checked_ok is None:
998
 
            return dbus.String(u"")
999
 
        return dbus.String(self._datetime_to_dbus(self
1000
 
                                                  .last_checked_ok))
1001
 
    
1002
 
    # timeout - property
1003
 
    @dbus_service_property(_interface, signature=u"t",
1004
 
                           access=u"readwrite")
1005
 
    def timeout_dbus_property(self, value=None):
 
1725
        return datetime_to_dbus(self.last_checked_ok)
 
1726
    
 
1727
    # LastCheckerStatus - property
 
1728
    @dbus_service_property(_interface, signature="n", access="read")
 
1729
    def LastCheckerStatus_dbus_property(self):
 
1730
        return dbus.Int16(self.last_checker_status)
 
1731
    
 
1732
    # Expires - property
 
1733
    @dbus_service_property(_interface, signature="s", access="read")
 
1734
    def Expires_dbus_property(self):
 
1735
        return datetime_to_dbus(self.expires)
 
1736
    
 
1737
    # LastApprovalRequest - property
 
1738
    @dbus_service_property(_interface, signature="s", access="read")
 
1739
    def LastApprovalRequest_dbus_property(self):
 
1740
        return datetime_to_dbus(self.last_approval_request)
 
1741
    
 
1742
    # Timeout - property
 
1743
    @dbus_service_property(_interface,
 
1744
                           signature="t",
 
1745
                           access="readwrite")
 
1746
    def Timeout_dbus_property(self, value=None):
1006
1747
        if value is None:       # get
1007
 
            return dbus.UInt64(self.timeout_milliseconds())
 
1748
            return dbus.UInt64(self.timeout.total_seconds() * 1000)
 
1749
        old_timeout = self.timeout
1008
1750
        self.timeout = datetime.timedelta(0, 0, 0, value)
1009
 
        # Emit D-Bus signal
1010
 
        self.PropertyChanged(dbus.String(u"timeout"),
1011
 
                             dbus.UInt64(value, variant_level=1))
1012
 
        if getattr(self, u"disable_initiator_tag", None) is None:
1013
 
            return
1014
 
        # Reschedule timeout
1015
 
        gobject.source_remove(self.disable_initiator_tag)
1016
 
        self.disable_initiator_tag = None
1017
 
        time_to_die = (self.
1018
 
                       _timedelta_to_milliseconds((self
1019
 
                                                   .last_checked_ok
1020
 
                                                   + self.timeout)
1021
 
                                                  - datetime.datetime
1022
 
                                                  .utcnow()))
1023
 
        if time_to_die <= 0:
1024
 
            # The timeout has passed
1025
 
            self.disable()
1026
 
        else:
1027
 
            self.disable_initiator_tag = (gobject.timeout_add
1028
 
                                          (time_to_die, self.disable))
1029
 
    
1030
 
    # interval - property
1031
 
    @dbus_service_property(_interface, signature=u"t",
1032
 
                           access=u"readwrite")
1033
 
    def interval_dbus_property(self, value=None):
1034
 
        if value is None:       # get
1035
 
            return dbus.UInt64(self.interval_milliseconds())
 
1751
        # Reschedule disabling
 
1752
        if self.enabled:
 
1753
            now = datetime.datetime.utcnow()
 
1754
            self.expires += self.timeout - old_timeout
 
1755
            if self.expires <= now:
 
1756
                # The timeout has passed
 
1757
                self.disable()
 
1758
            else:
 
1759
                if (getattr(self, "disable_initiator_tag", None)
 
1760
                    is None):
 
1761
                    return
 
1762
                gobject.source_remove(self.disable_initiator_tag)
 
1763
                self.disable_initiator_tag = gobject.timeout_add(
 
1764
                    int((self.expires - now).total_seconds() * 1000),
 
1765
                    self.disable)
 
1766
    
 
1767
    # ExtendedTimeout - property
 
1768
    @dbus_service_property(_interface,
 
1769
                           signature="t",
 
1770
                           access="readwrite")
 
1771
    def ExtendedTimeout_dbus_property(self, value=None):
 
1772
        if value is None:       # get
 
1773
            return dbus.UInt64(self.extended_timeout.total_seconds()
 
1774
                               * 1000)
 
1775
        self.extended_timeout = datetime.timedelta(0, 0, 0, value)
 
1776
    
 
1777
    # Interval - property
 
1778
    @dbus_service_property(_interface,
 
1779
                           signature="t",
 
1780
                           access="readwrite")
 
1781
    def Interval_dbus_property(self, value=None):
 
1782
        if value is None:       # get
 
1783
            return dbus.UInt64(self.interval.total_seconds() * 1000)
1036
1784
        self.interval = datetime.timedelta(0, 0, 0, value)
1037
 
        # Emit D-Bus signal
1038
 
        self.PropertyChanged(dbus.String(u"interval"),
1039
 
                             dbus.UInt64(value, variant_level=1))
1040
 
        if getattr(self, u"checker_initiator_tag", None) is None:
 
1785
        if getattr(self, "checker_initiator_tag", None) is None:
1041
1786
            return
1042
 
        # Reschedule checker run
1043
 
        gobject.source_remove(self.checker_initiator_tag)
1044
 
        self.checker_initiator_tag = (gobject.timeout_add
1045
 
                                      (value, self.start_checker))
1046
 
        self.start_checker()    # Start one now, too
1047
 
 
1048
 
    # checker - property
1049
 
    @dbus_service_property(_interface, signature=u"s",
1050
 
                           access=u"readwrite")
1051
 
    def checker_dbus_property(self, value=None):
 
1787
        if self.enabled:
 
1788
            # Reschedule checker run
 
1789
            gobject.source_remove(self.checker_initiator_tag)
 
1790
            self.checker_initiator_tag = gobject.timeout_add(
 
1791
                value, self.start_checker)
 
1792
            self.start_checker() # Start one now, too
 
1793
    
 
1794
    # Checker - property
 
1795
    @dbus_service_property(_interface,
 
1796
                           signature="s",
 
1797
                           access="readwrite")
 
1798
    def Checker_dbus_property(self, value=None):
1052
1799
        if value is None:       # get
1053
1800
            return dbus.String(self.checker_command)
1054
 
        self.checker_command = value
1055
 
        # Emit D-Bus signal
1056
 
        self.PropertyChanged(dbus.String(u"checker"),
1057
 
                             dbus.String(self.checker_command,
1058
 
                                         variant_level=1))
 
1801
        self.checker_command = str(value)
1059
1802
    
1060
 
    # checker_running - property
1061
 
    @dbus_service_property(_interface, signature=u"b",
1062
 
                           access=u"readwrite")
1063
 
    def checker_running_dbus_property(self, value=None):
 
1803
    # CheckerRunning - property
 
1804
    @dbus_service_property(_interface,
 
1805
                           signature="b",
 
1806
                           access="readwrite")
 
1807
    def CheckerRunning_dbus_property(self, value=None):
1064
1808
        if value is None:       # get
1065
1809
            return dbus.Boolean(self.checker is not None)
1066
1810
        if value:
1068
1812
        else:
1069
1813
            self.stop_checker()
1070
1814
    
1071
 
    # object_path - property
1072
 
    @dbus_service_property(_interface, signature=u"o", access=u"read")
1073
 
    def object_path_dbus_property(self):
 
1815
    # ObjectPath - property
 
1816
    @dbus_annotations(
 
1817
        {"org.freedesktop.DBus.Property.EmitsChangedSignal": "const",
 
1818
         "org.freedesktop.DBus.Deprecated": "true"})
 
1819
    @dbus_service_property(_interface, signature="o", access="read")
 
1820
    def ObjectPath_dbus_property(self):
1074
1821
        return self.dbus_object_path # is already a dbus.ObjectPath
1075
1822
    
1076
 
    # secret = property
1077
 
    @dbus_service_property(_interface, signature=u"ay",
1078
 
                           access=u"write", byte_arrays=True)
1079
 
    def secret_dbus_property(self, value):
1080
 
        self.secret = str(value)
 
1823
    # Secret = property
 
1824
    @dbus_annotations(
 
1825
        {"org.freedesktop.DBus.Property.EmitsChangedSignal":
 
1826
         "invalidates"})
 
1827
    @dbus_service_property(_interface,
 
1828
                           signature="ay",
 
1829
                           access="write",
 
1830
                           byte_arrays=True)
 
1831
    def Secret_dbus_property(self, value):
 
1832
        self.secret = bytes(value)
1081
1833
    
1082
1834
    del _interface
1083
1835
 
1087
1839
        self._pipe = child_pipe
1088
1840
        self._pipe.send(('init', fpr, address))
1089
1841
        if not self._pipe.recv():
1090
 
            raise KeyError()
1091
 
 
 
1842
            raise KeyError(fpr)
 
1843
    
1092
1844
    def __getattribute__(self, name):
1093
 
        if(name == '_pipe'):
 
1845
        if name == '_pipe':
1094
1846
            return super(ProxyClient, self).__getattribute__(name)
1095
1847
        self._pipe.send(('getattr', name))
1096
1848
        data = self._pipe.recv()
1097
1849
        if data[0] == 'data':
1098
1850
            return data[1]
1099
1851
        if data[0] == 'function':
 
1852
            
1100
1853
            def func(*args, **kwargs):
1101
1854
                self._pipe.send(('funcall', name, args, kwargs))
1102
1855
                return self._pipe.recv()[1]
 
1856
            
1103
1857
            return func
1104
 
 
 
1858
    
1105
1859
    def __setattr__(self, name, value):
1106
 
        if(name == '_pipe'):
 
1860
        if name == '_pipe':
1107
1861
            return super(ProxyClient, self).__setattr__(name, value)
1108
1862
        self._pipe.send(('setattr', name, value))
1109
1863
 
1116
1870
    
1117
1871
    def handle(self):
1118
1872
        with contextlib.closing(self.server.child_pipe) as child_pipe:
1119
 
            logger.info(u"TCP connection from: %s",
1120
 
                        unicode(self.client_address))
1121
 
            logger.debug(u"Pipe FD: %d",
 
1873
            logger.info("TCP connection from: %s",
 
1874
                        str(self.client_address))
 
1875
            logger.debug("Pipe FD: %d",
1122
1876
                         self.server.child_pipe.fileno())
1123
 
 
1124
 
            session = (gnutls.connection
1125
 
                       .ClientSession(self.request,
1126
 
                                      gnutls.connection
1127
 
                                      .X509Credentials()))
1128
 
 
 
1877
            
 
1878
            session = gnutls.connection.ClientSession(
 
1879
                self.request, gnutls.connection .X509Credentials())
 
1880
            
1129
1881
            # Note: gnutls.connection.X509Credentials is really a
1130
1882
            # generic GnuTLS certificate credentials object so long as
1131
1883
            # no X.509 keys are added to it.  Therefore, we can use it
1132
1884
            # here despite using OpenPGP certificates.
1133
 
 
1134
 
            #priority = u':'.join((u"NONE", u"+VERS-TLS1.1",
1135
 
            #                      u"+AES-256-CBC", u"+SHA1",
1136
 
            #                      u"+COMP-NULL", u"+CTYPE-OPENPGP",
1137
 
            #                      u"+DHE-DSS"))
 
1885
            
 
1886
            #priority = ':'.join(("NONE", "+VERS-TLS1.1",
 
1887
            #                      "+AES-256-CBC", "+SHA1",
 
1888
            #                      "+COMP-NULL", "+CTYPE-OPENPGP",
 
1889
            #                      "+DHE-DSS"))
1138
1890
            # Use a fallback default, since this MUST be set.
1139
1891
            priority = self.server.gnutls_priority
1140
1892
            if priority is None:
1141
 
                priority = u"NORMAL"
1142
 
            (gnutls.library.functions
1143
 
             .gnutls_priority_set_direct(session._c_object,
1144
 
                                         priority, None))
1145
 
 
 
1893
                priority = "NORMAL"
 
1894
            gnutls.library.functions.gnutls_priority_set_direct(
 
1895
                session._c_object, priority, None)
 
1896
            
1146
1897
            # Start communication using the Mandos protocol
1147
1898
            # Get protocol number
1148
1899
            line = self.request.makefile().readline()
1149
 
            logger.debug(u"Protocol version: %r", line)
 
1900
            logger.debug("Protocol version: %r", line)
1150
1901
            try:
1151
1902
                if int(line.strip().split()[0]) > 1:
1152
 
                    raise RuntimeError
1153
 
            except (ValueError, IndexError, RuntimeError), error:
1154
 
                logger.error(u"Unknown protocol version: %s", error)
 
1903
                    raise RuntimeError(line)
 
1904
            except (ValueError, IndexError, RuntimeError) as error:
 
1905
                logger.error("Unknown protocol version: %s", error)
1155
1906
                return
1156
 
 
 
1907
            
1157
1908
            # Start GnuTLS connection
1158
1909
            try:
1159
1910
                session.handshake()
1160
 
            except gnutls.errors.GNUTLSError, error:
1161
 
                logger.warning(u"Handshake failed: %s", error)
 
1911
            except gnutls.errors.GNUTLSError as error:
 
1912
                logger.warning("Handshake failed: %s", error)
1162
1913
                # Do not run session.bye() here: the session is not
1163
1914
                # established.  Just abandon the request.
1164
1915
                return
1165
 
            logger.debug(u"Handshake succeeded")
1166
 
 
 
1916
            logger.debug("Handshake succeeded")
 
1917
            
1167
1918
            approval_required = False
1168
1919
            try:
1169
1920
                try:
1170
 
                    fpr = self.fingerprint(self.peer_certificate
1171
 
                                           (session))
1172
 
                except (TypeError, gnutls.errors.GNUTLSError), error:
1173
 
                    logger.warning(u"Bad certificate: %s", error)
 
1921
                    fpr = self.fingerprint(
 
1922
                        self.peer_certificate(session))
 
1923
                except (TypeError,
 
1924
                        gnutls.errors.GNUTLSError) as error:
 
1925
                    logger.warning("Bad certificate: %s", error)
1174
1926
                    return
1175
 
                logger.debug(u"Fingerprint: %s", fpr)
1176
 
 
 
1927
                logger.debug("Fingerprint: %s", fpr)
 
1928
                
1177
1929
                try:
1178
1930
                    client = ProxyClient(child_pipe, fpr,
1179
1931
                                         self.client_address)
1180
1932
                except KeyError:
1181
1933
                    return
1182
1934
                
1183
 
                if client.approved_delay:
1184
 
                    delay = client.approved_delay
 
1935
                if client.approval_delay:
 
1936
                    delay = client.approval_delay
1185
1937
                    client.approvals_pending += 1
1186
1938
                    approval_required = True
1187
1939
                
1188
1940
                while True:
1189
1941
                    if not client.enabled:
1190
 
                        logger.warning(u"Client %s is disabled",
1191
 
                                       client.name)
 
1942
                        logger.info("Client %s is disabled",
 
1943
                                    client.name)
1192
1944
                        if self.server.use_dbus:
1193
1945
                            # Emit D-Bus signal
1194
 
                            client.Rejected("Disabled")                    
 
1946
                            client.Rejected("Disabled")
1195
1947
                        return
1196
1948
                    
1197
 
                    if client._approved or not client.approved_delay:
 
1949
                    if client.approved or not client.approval_delay:
1198
1950
                        #We are approved or approval is disabled
1199
1951
                        break
1200
 
                    elif client._approved is None:
1201
 
                        logger.info(u"Client %s need approval",
 
1952
                    elif client.approved is None:
 
1953
                        logger.info("Client %s needs approval",
1202
1954
                                    client.name)
1203
1955
                        if self.server.use_dbus:
1204
1956
                            # Emit D-Bus signal
1205
1957
                            client.NeedApproval(
1206
 
                                client.approved_delay_milliseconds(),
1207
 
                                client.approved_by_default)
 
1958
                                client.approval_delay.total_seconds()
 
1959
                                * 1000, client.approved_by_default)
1208
1960
                    else:
1209
 
                        logger.warning(u"Client %s was not approved",
 
1961
                        logger.warning("Client %s was not approved",
1210
1962
                                       client.name)
1211
1963
                        if self.server.use_dbus:
1212
1964
                            # Emit D-Bus signal
1213
 
                            client.Rejected("Disapproved")
 
1965
                            client.Rejected("Denied")
1214
1966
                        return
1215
1967
                    
1216
1968
                    #wait until timeout or approved
1217
 
                    #x = float(client._timedelta_to_milliseconds(delay))
1218
1969
                    time = datetime.datetime.now()
1219
1970
                    client.changedstate.acquire()
1220
 
                    client.changedstate.wait(float(client._timedelta_to_milliseconds(delay) / 1000))
 
1971
                    client.changedstate.wait(delay.total_seconds())
1221
1972
                    client.changedstate.release()
1222
1973
                    time2 = datetime.datetime.now()
1223
1974
                    if (time2 - time) >= delay:
1227
1978
                                           client.name)
1228
1979
                            if self.server.use_dbus:
1229
1980
                                # Emit D-Bus signal
1230
 
                                client.Rejected("Time out")
 
1981
                                client.Rejected("Approval timed out")
1231
1982
                            return
1232
1983
                        else:
1233
1984
                            break
1238
1989
                while sent_size < len(client.secret):
1239
1990
                    try:
1240
1991
                        sent = session.send(client.secret[sent_size:])
1241
 
                    except (gnutls.errors.GNUTLSError), error:
1242
 
                        logger.warning("gnutls send failed")
 
1992
                    except gnutls.errors.GNUTLSError as error:
 
1993
                        logger.warning("gnutls send failed",
 
1994
                                       exc_info=error)
1243
1995
                        return
1244
 
                    logger.debug(u"Sent: %d, remaining: %d",
1245
 
                                 sent, len(client.secret)
1246
 
                                 - (sent_size + sent))
 
1996
                    logger.debug("Sent: %d, remaining: %d", sent,
 
1997
                                 len(client.secret) - (sent_size
 
1998
                                                       + sent))
1247
1999
                    sent_size += sent
1248
 
 
1249
 
                logger.info(u"Sending secret to %s", client.name)
1250
 
                # bump the timeout as if seen
1251
 
                client.checked_ok()
 
2000
                
 
2001
                logger.info("Sending secret to %s", client.name)
 
2002
                # bump the timeout using extended_timeout
 
2003
                client.bump_timeout(client.extended_timeout)
1252
2004
                if self.server.use_dbus:
1253
2005
                    # Emit D-Bus signal
1254
2006
                    client.GotSecret()
1258
2010
                    client.approvals_pending -= 1
1259
2011
                try:
1260
2012
                    session.bye()
1261
 
                except (gnutls.errors.GNUTLSError), error:
1262
 
                    logger.warning("gnutls bye failed")
 
2013
                except gnutls.errors.GNUTLSError as error:
 
2014
                    logger.warning("GnuTLS bye failed",
 
2015
                                   exc_info=error)
1263
2016
    
1264
2017
    @staticmethod
1265
2018
    def peer_certificate(session):
1266
2019
        "Return the peer's OpenPGP certificate as a bytestring"
1267
2020
        # If not an OpenPGP certificate...
1268
 
        if (gnutls.library.functions
1269
 
            .gnutls_certificate_type_get(session._c_object)
 
2021
        if (gnutls.library.functions.gnutls_certificate_type_get(
 
2022
                session._c_object)
1270
2023
            != gnutls.library.constants.GNUTLS_CRT_OPENPGP):
1271
2024
            # ...do the normal thing
1272
2025
            return session.peer_certificate
1275
2028
                     .gnutls_certificate_get_peers
1276
2029
                     (session._c_object, ctypes.byref(list_size)))
1277
2030
        if not bool(cert_list) and list_size.value != 0:
1278
 
            raise gnutls.errors.GNUTLSError(u"error getting peer"
1279
 
                                            u" certificate")
 
2031
            raise gnutls.errors.GNUTLSError("error getting peer"
 
2032
                                            " certificate")
1280
2033
        if list_size.value == 0:
1281
2034
            return None
1282
2035
        cert = cert_list[0]
1286
2039
    def fingerprint(openpgp):
1287
2040
        "Convert an OpenPGP bytestring to a hexdigit fingerprint"
1288
2041
        # New GnuTLS "datum" with the OpenPGP public key
1289
 
        datum = (gnutls.library.types
1290
 
                 .gnutls_datum_t(ctypes.cast(ctypes.c_char_p(openpgp),
1291
 
                                             ctypes.POINTER
1292
 
                                             (ctypes.c_ubyte)),
1293
 
                                 ctypes.c_uint(len(openpgp))))
 
2042
        datum = gnutls.library.types.gnutls_datum_t(
 
2043
            ctypes.cast(ctypes.c_char_p(openpgp),
 
2044
                        ctypes.POINTER(ctypes.c_ubyte)),
 
2045
            ctypes.c_uint(len(openpgp)))
1294
2046
        # New empty GnuTLS certificate
1295
2047
        crt = gnutls.library.types.gnutls_openpgp_crt_t()
1296
 
        (gnutls.library.functions
1297
 
         .gnutls_openpgp_crt_init(ctypes.byref(crt)))
 
2048
        gnutls.library.functions.gnutls_openpgp_crt_init(
 
2049
            ctypes.byref(crt))
1298
2050
        # Import the OpenPGP public key into the certificate
1299
 
        (gnutls.library.functions
1300
 
         .gnutls_openpgp_crt_import(crt, ctypes.byref(datum),
1301
 
                                    gnutls.library.constants
1302
 
                                    .GNUTLS_OPENPGP_FMT_RAW))
 
2051
        gnutls.library.functions.gnutls_openpgp_crt_import(
 
2052
            crt, ctypes.byref(datum),
 
2053
            gnutls.library.constants.GNUTLS_OPENPGP_FMT_RAW)
1303
2054
        # Verify the self signature in the key
1304
2055
        crtverify = ctypes.c_uint()
1305
 
        (gnutls.library.functions
1306
 
         .gnutls_openpgp_crt_verify_self(crt, 0,
1307
 
                                         ctypes.byref(crtverify)))
 
2056
        gnutls.library.functions.gnutls_openpgp_crt_verify_self(
 
2057
            crt, 0, ctypes.byref(crtverify))
1308
2058
        if crtverify.value != 0:
1309
2059
            gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)
1310
 
            raise (gnutls.errors.CertificateSecurityError
1311
 
                   (u"Verify failed"))
 
2060
            raise gnutls.errors.CertificateSecurityError(
 
2061
                "Verify failed")
1312
2062
        # New buffer for the fingerprint
1313
2063
        buf = ctypes.create_string_buffer(20)
1314
2064
        buf_len = ctypes.c_size_t()
1315
2065
        # Get the fingerprint from the certificate into the buffer
1316
 
        (gnutls.library.functions
1317
 
         .gnutls_openpgp_crt_get_fingerprint(crt, ctypes.byref(buf),
1318
 
                                             ctypes.byref(buf_len)))
 
2066
        gnutls.library.functions.gnutls_openpgp_crt_get_fingerprint(
 
2067
            crt, ctypes.byref(buf), ctypes.byref(buf_len))
1319
2068
        # Deinit the certificate
1320
2069
        gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)
1321
2070
        # Convert the buffer to a Python bytestring
1322
2071
        fpr = ctypes.string_at(buf, buf_len.value)
1323
2072
        # Convert the bytestring to hexadecimal notation
1324
 
        hex_fpr = u''.join(u"%02X" % ord(char) for char in fpr)
 
2073
        hex_fpr = binascii.hexlify(fpr).upper()
1325
2074
        return hex_fpr
1326
2075
 
1327
2076
 
1328
2077
class MultiprocessingMixIn(object):
1329
2078
    """Like socketserver.ThreadingMixIn, but with multiprocessing"""
 
2079
    
1330
2080
    def sub_process_main(self, request, address):
1331
2081
        try:
1332
2082
            self.finish_request(request, address)
1333
 
        except:
 
2083
        except Exception:
1334
2084
            self.handle_error(request, address)
1335
2085
        self.close_request(request)
1336
 
            
 
2086
    
1337
2087
    def process_request(self, request, address):
1338
2088
        """Start a new process to process the request."""
1339
 
        multiprocessing.Process(target = self.sub_process_main,
1340
 
                                args = (request, address)).start()
 
2089
        proc = multiprocessing.Process(target = self.sub_process_main,
 
2090
                                       args = (request, address))
 
2091
        proc.start()
 
2092
        return proc
 
2093
 
1341
2094
 
1342
2095
class MultiprocessingMixInWithPipe(MultiprocessingMixIn, object):
1343
2096
    """ adds a pipe to the MixIn """
 
2097
    
1344
2098
    def process_request(self, request, client_address):
1345
2099
        """Overrides and wraps the original process_request().
1346
2100
        
1347
2101
        This function creates a new pipe in self.pipe
1348
2102
        """
1349
2103
        parent_pipe, self.child_pipe = multiprocessing.Pipe()
1350
 
 
1351
 
        super(MultiprocessingMixInWithPipe,
1352
 
              self).process_request(request, client_address)
 
2104
        
 
2105
        proc = MultiprocessingMixIn.process_request(self, request,
 
2106
                                                    client_address)
1353
2107
        self.child_pipe.close()
1354
 
        self.add_pipe(parent_pipe)
1355
 
 
1356
 
    def add_pipe(self, parent_pipe):
 
2108
        self.add_pipe(parent_pipe, proc)
 
2109
    
 
2110
    def add_pipe(self, parent_pipe, proc):
1357
2111
        """Dummy function; override as necessary"""
1358
 
        pass
 
2112
        raise NotImplementedError()
 
2113
 
1359
2114
 
1360
2115
class IPv6_TCPServer(MultiprocessingMixInWithPipe,
1361
2116
                     socketserver.TCPServer, object):
1366
2121
        interface:      None or a network interface name (string)
1367
2122
        use_ipv6:       Boolean; to use IPv6 or not
1368
2123
    """
 
2124
    
1369
2125
    def __init__(self, server_address, RequestHandlerClass,
1370
 
                 interface=None, use_ipv6=True):
 
2126
                 interface=None,
 
2127
                 use_ipv6=True,
 
2128
                 socketfd=None):
 
2129
        """If socketfd is set, use that file descriptor instead of
 
2130
        creating a new one with socket.socket().
 
2131
        """
1371
2132
        self.interface = interface
1372
2133
        if use_ipv6:
1373
2134
            self.address_family = socket.AF_INET6
 
2135
        if socketfd is not None:
 
2136
            # Save the file descriptor
 
2137
            self.socketfd = socketfd
 
2138
            # Save the original socket.socket() function
 
2139
            self.socket_socket = socket.socket
 
2140
            # To implement --socket, we monkey patch socket.socket.
 
2141
            # 
 
2142
            # (When socketserver.TCPServer is a new-style class, we
 
2143
            # could make self.socket into a property instead of monkey
 
2144
            # patching socket.socket.)
 
2145
            # 
 
2146
            # Create a one-time-only replacement for socket.socket()
 
2147
            @functools.wraps(socket.socket)
 
2148
            def socket_wrapper(*args, **kwargs):
 
2149
                # Restore original function so subsequent calls are
 
2150
                # not affected.
 
2151
                socket.socket = self.socket_socket
 
2152
                del self.socket_socket
 
2153
                # This time only, return a new socket object from the
 
2154
                # saved file descriptor.
 
2155
                return socket.fromfd(self.socketfd, *args, **kwargs)
 
2156
            # Replace socket.socket() function with wrapper
 
2157
            socket.socket = socket_wrapper
 
2158
        # The socketserver.TCPServer.__init__ will call
 
2159
        # socket.socket(), which might be our replacement,
 
2160
        # socket_wrapper(), if socketfd was set.
1374
2161
        socketserver.TCPServer.__init__(self, server_address,
1375
2162
                                        RequestHandlerClass)
 
2163
    
1376
2164
    def server_bind(self):
1377
2165
        """This overrides the normal server_bind() function
1378
2166
        to bind to an interface if one was specified, and also NOT to
1379
2167
        bind to an address or port if they were not specified."""
1380
2168
        if self.interface is not None:
1381
2169
            if SO_BINDTODEVICE is None:
1382
 
                logger.error(u"SO_BINDTODEVICE does not exist;"
1383
 
                             u" cannot bind to interface %s",
 
2170
                logger.error("SO_BINDTODEVICE does not exist;"
 
2171
                             " cannot bind to interface %s",
1384
2172
                             self.interface)
1385
2173
            else:
1386
2174
                try:
1387
 
                    self.socket.setsockopt(socket.SOL_SOCKET,
1388
 
                                           SO_BINDTODEVICE,
1389
 
                                           str(self.interface
1390
 
                                               + u'\0'))
1391
 
                except socket.error, error:
1392
 
                    if error[0] == errno.EPERM:
1393
 
                        logger.error(u"No permission to"
1394
 
                                     u" bind to interface %s",
1395
 
                                     self.interface)
1396
 
                    elif error[0] == errno.ENOPROTOOPT:
1397
 
                        logger.error(u"SO_BINDTODEVICE not available;"
1398
 
                                     u" cannot bind to interface %s",
1399
 
                                     self.interface)
 
2175
                    self.socket.setsockopt(
 
2176
                        socket.SOL_SOCKET, SO_BINDTODEVICE,
 
2177
                        (self.interface + "\0").encode("utf-8"))
 
2178
                except socket.error as error:
 
2179
                    if error.errno == errno.EPERM:
 
2180
                        logger.error("No permission to bind to"
 
2181
                                     " interface %s", self.interface)
 
2182
                    elif error.errno == errno.ENOPROTOOPT:
 
2183
                        logger.error("SO_BINDTODEVICE not available;"
 
2184
                                     " cannot bind to interface %s",
 
2185
                                     self.interface)
 
2186
                    elif error.errno == errno.ENODEV:
 
2187
                        logger.error("Interface %s does not exist,"
 
2188
                                     " cannot bind", self.interface)
1400
2189
                    else:
1401
2190
                        raise
1402
2191
        # Only bind(2) the socket if we really need to.
1403
2192
        if self.server_address[0] or self.server_address[1]:
1404
2193
            if not self.server_address[0]:
1405
2194
                if self.address_family == socket.AF_INET6:
1406
 
                    any_address = u"::" # in6addr_any
 
2195
                    any_address = "::" # in6addr_any
1407
2196
                else:
1408
 
                    any_address = socket.INADDR_ANY
 
2197
                    any_address = "0.0.0.0" # INADDR_ANY
1409
2198
                self.server_address = (any_address,
1410
2199
                                       self.server_address[1])
1411
2200
            elif not self.server_address[1]:
1412
 
                self.server_address = (self.server_address[0],
1413
 
                                       0)
 
2201
                self.server_address = (self.server_address[0], 0)
1414
2202
#                 if self.interface:
1415
2203
#                     self.server_address = (self.server_address[0],
1416
2204
#                                            0, # port
1430
2218
    
1431
2219
    Assumes a gobject.MainLoop event loop.
1432
2220
    """
 
2221
    
1433
2222
    def __init__(self, server_address, RequestHandlerClass,
1434
 
                 interface=None, use_ipv6=True, clients=None,
1435
 
                 gnutls_priority=None, use_dbus=True):
 
2223
                 interface=None,
 
2224
                 use_ipv6=True,
 
2225
                 clients=None,
 
2226
                 gnutls_priority=None,
 
2227
                 use_dbus=True,
 
2228
                 socketfd=None):
1436
2229
        self.enabled = False
1437
2230
        self.clients = clients
1438
2231
        if self.clients is None:
1439
 
            self.clients = set()
 
2232
            self.clients = {}
1440
2233
        self.use_dbus = use_dbus
1441
2234
        self.gnutls_priority = gnutls_priority
1442
2235
        IPv6_TCPServer.__init__(self, server_address,
1443
2236
                                RequestHandlerClass,
1444
2237
                                interface = interface,
1445
 
                                use_ipv6 = use_ipv6)
 
2238
                                use_ipv6 = use_ipv6,
 
2239
                                socketfd = socketfd)
 
2240
    
1446
2241
    def server_activate(self):
1447
2242
        if self.enabled:
1448
2243
            return socketserver.TCPServer.server_activate(self)
 
2244
    
1449
2245
    def enable(self):
1450
2246
        self.enabled = True
1451
 
    def add_pipe(self, parent_pipe):
 
2247
    
 
2248
    def add_pipe(self, parent_pipe, proc):
1452
2249
        # Call "handle_ipc" for both data and EOF events
1453
 
        gobject.io_add_watch(parent_pipe.fileno(),
1454
 
                             gobject.IO_IN | gobject.IO_HUP,
1455
 
                             functools.partial(self.handle_ipc,
1456
 
                                               parent_pipe = parent_pipe))
1457
 
        
1458
 
    def handle_ipc(self, source, condition, parent_pipe=None,
 
2250
        gobject.io_add_watch(
 
2251
            parent_pipe.fileno(),
 
2252
            gobject.IO_IN | gobject.IO_HUP,
 
2253
            functools.partial(self.handle_ipc,
 
2254
                              parent_pipe = parent_pipe,
 
2255
                              proc = proc))
 
2256
    
 
2257
    def handle_ipc(self, source, condition,
 
2258
                   parent_pipe=None,
 
2259
                   proc = None,
1459
2260
                   client_object=None):
1460
 
        condition_names = {
1461
 
            gobject.IO_IN: u"IN",   # There is data to read.
1462
 
            gobject.IO_OUT: u"OUT", # Data can be written (without
1463
 
                                    # blocking).
1464
 
            gobject.IO_PRI: u"PRI", # There is urgent data to read.
1465
 
            gobject.IO_ERR: u"ERR", # Error condition.
1466
 
            gobject.IO_HUP: u"HUP"  # Hung up (the connection has been
1467
 
                                    # broken, usually for pipes and
1468
 
                                    # sockets).
1469
 
            }
1470
 
        conditions_string = ' | '.join(name
1471
 
                                       for cond, name in
1472
 
                                       condition_names.iteritems()
1473
 
                                       if cond & condition)
1474
 
        logger.debug(u"Handling IPC: FD = %d, condition = %s", source,
1475
 
                     conditions_string)
1476
 
 
1477
 
        # error or the other end of multiprocessing.Pipe has closed
1478
 
        if condition & (gobject.IO_ERR | condition & gobject.IO_HUP):
 
2261
        # error, or the other end of multiprocessing.Pipe has closed
 
2262
        if condition & (gobject.IO_ERR | gobject.IO_HUP):
 
2263
            # Wait for other process to exit
 
2264
            proc.join()
1479
2265
            return False
1480
2266
        
1481
2267
        # Read a request from the child
1482
2268
        request = parent_pipe.recv()
1483
 
        logger.debug(u"IPC request: %s", repr(request))
1484
2269
        command = request[0]
1485
2270
        
1486
2271
        if command == 'init':
1487
2272
            fpr = request[1]
1488
2273
            address = request[2]
1489
2274
            
1490
 
            for c in self.clients:
 
2275
            for c in self.clients.itervalues():
1491
2276
                if c.fingerprint == fpr:
1492
2277
                    client = c
1493
2278
                    break
1494
2279
            else:
1495
 
                logger.warning(u"Client not found for fingerprint: %s, ad"
1496
 
                               u"dress: %s", fpr, address)
 
2280
                logger.info("Client not found for fingerprint: %s, ad"
 
2281
                            "dress: %s", fpr, address)
1497
2282
                if self.use_dbus:
1498
2283
                    # Emit D-Bus signal
1499
 
                    mandos_dbus_service.ClientNotFound(fpr, address)
 
2284
                    mandos_dbus_service.ClientNotFound(fpr,
 
2285
                                                       address[0])
1500
2286
                parent_pipe.send(False)
1501
2287
                return False
1502
2288
            
1503
 
            gobject.io_add_watch(parent_pipe.fileno(),
1504
 
                                 gobject.IO_IN | gobject.IO_HUP,
1505
 
                                 functools.partial(self.handle_ipc,
1506
 
                                                   parent_pipe = parent_pipe,
1507
 
                                                   client_object = client))
 
2289
            gobject.io_add_watch(
 
2290
                parent_pipe.fileno(),
 
2291
                gobject.IO_IN | gobject.IO_HUP,
 
2292
                functools.partial(self.handle_ipc,
 
2293
                                  parent_pipe = parent_pipe,
 
2294
                                  proc = proc,
 
2295
                                  client_object = client))
1508
2296
            parent_pipe.send(True)
1509
 
            # remove the old hook in favor of the new above hook on same fileno
 
2297
            # remove the old hook in favor of the new above hook on
 
2298
            # same fileno
1510
2299
            return False
1511
2300
        if command == 'funcall':
1512
2301
            funcname = request[1]
1513
2302
            args = request[2]
1514
2303
            kwargs = request[3]
1515
2304
            
1516
 
            parent_pipe.send(('data', getattr(client_object, funcname)(*args, **kwargs)))
1517
 
 
 
2305
            parent_pipe.send(('data', getattr(client_object,
 
2306
                                              funcname)(*args,
 
2307
                                                        **kwargs)))
 
2308
        
1518
2309
        if command == 'getattr':
1519
2310
            attrname = request[1]
1520
 
            if callable(client_object.__getattribute__(attrname)):
1521
 
                parent_pipe.send(('function',))
 
2311
            if isinstance(client_object.__getattribute__(attrname),
 
2312
                          collections.Callable):
 
2313
                parent_pipe.send(('function', ))
1522
2314
            else:
1523
 
                parent_pipe.send(('data', client_object.__getattribute__(attrname)))
 
2315
                parent_pipe.send((
 
2316
                    'data', client_object.__getattribute__(attrname)))
1524
2317
        
1525
2318
        if command == 'setattr':
1526
2319
            attrname = request[1]
1527
2320
            value = request[2]
1528
2321
            setattr(client_object, attrname, value)
1529
 
 
 
2322
        
1530
2323
        return True
1531
2324
 
1532
2325
 
 
2326
def rfc3339_duration_to_delta(duration):
 
2327
    """Parse an RFC 3339 "duration" and return a datetime.timedelta
 
2328
    
 
2329
    >>> rfc3339_duration_to_delta("P7D")
 
2330
    datetime.timedelta(7)
 
2331
    >>> rfc3339_duration_to_delta("PT60S")
 
2332
    datetime.timedelta(0, 60)
 
2333
    >>> rfc3339_duration_to_delta("PT60M")
 
2334
    datetime.timedelta(0, 3600)
 
2335
    >>> rfc3339_duration_to_delta("PT24H")
 
2336
    datetime.timedelta(1)
 
2337
    >>> rfc3339_duration_to_delta("P1W")
 
2338
    datetime.timedelta(7)
 
2339
    >>> rfc3339_duration_to_delta("PT5M30S")
 
2340
    datetime.timedelta(0, 330)
 
2341
    >>> rfc3339_duration_to_delta("P1DT3M20S")
 
2342
    datetime.timedelta(1, 200)
 
2343
    """
 
2344
    
 
2345
    # Parsing an RFC 3339 duration with regular expressions is not
 
2346
    # possible - there would have to be multiple places for the same
 
2347
    # values, like seconds.  The current code, while more esoteric, is
 
2348
    # cleaner without depending on a parsing library.  If Python had a
 
2349
    # built-in library for parsing we would use it, but we'd like to
 
2350
    # avoid excessive use of external libraries.
 
2351
    
 
2352
    # New type for defining tokens, syntax, and semantics all-in-one
 
2353
    Token = collections.namedtuple("Token", (
 
2354
        "regexp",  # To match token; if "value" is not None, must have
 
2355
                   # a "group" containing digits
 
2356
        "value",   # datetime.timedelta or None
 
2357
        "followers"))           # Tokens valid after this token
 
2358
    # RFC 3339 "duration" tokens, syntax, and semantics; taken from
 
2359
    # the "duration" ABNF definition in RFC 3339, Appendix A.
 
2360
    token_end = Token(re.compile(r"$"), None, frozenset())
 
2361
    token_second = Token(re.compile(r"(\d+)S"),
 
2362
                         datetime.timedelta(seconds=1),
 
2363
                         frozenset((token_end, )))
 
2364
    token_minute = Token(re.compile(r"(\d+)M"),
 
2365
                         datetime.timedelta(minutes=1),
 
2366
                         frozenset((token_second, token_end)))
 
2367
    token_hour = Token(re.compile(r"(\d+)H"),
 
2368
                       datetime.timedelta(hours=1),
 
2369
                       frozenset((token_minute, token_end)))
 
2370
    token_time = Token(re.compile(r"T"),
 
2371
                       None,
 
2372
                       frozenset((token_hour, token_minute,
 
2373
                                  token_second)))
 
2374
    token_day = Token(re.compile(r"(\d+)D"),
 
2375
                      datetime.timedelta(days=1),
 
2376
                      frozenset((token_time, token_end)))
 
2377
    token_month = Token(re.compile(r"(\d+)M"),
 
2378
                        datetime.timedelta(weeks=4),
 
2379
                        frozenset((token_day, token_end)))
 
2380
    token_year = Token(re.compile(r"(\d+)Y"),
 
2381
                       datetime.timedelta(weeks=52),
 
2382
                       frozenset((token_month, token_end)))
 
2383
    token_week = Token(re.compile(r"(\d+)W"),
 
2384
                       datetime.timedelta(weeks=1),
 
2385
                       frozenset((token_end, )))
 
2386
    token_duration = Token(re.compile(r"P"), None,
 
2387
                           frozenset((token_year, token_month,
 
2388
                                      token_day, token_time,
 
2389
                                      token_week)))
 
2390
    # Define starting values
 
2391
    value = datetime.timedelta() # Value so far
 
2392
    found_token = None
 
2393
    followers = frozenset((token_duration, )) # Following valid tokens
 
2394
    s = duration                # String left to parse
 
2395
    # Loop until end token is found
 
2396
    while found_token is not token_end:
 
2397
        # Search for any currently valid tokens
 
2398
        for token in followers:
 
2399
            match = token.regexp.match(s)
 
2400
            if match is not None:
 
2401
                # Token found
 
2402
                if token.value is not None:
 
2403
                    # Value found, parse digits
 
2404
                    factor = int(match.group(1), 10)
 
2405
                    # Add to value so far
 
2406
                    value += factor * token.value
 
2407
                # Strip token from string
 
2408
                s = token.regexp.sub("", s, 1)
 
2409
                # Go to found token
 
2410
                found_token = token
 
2411
                # Set valid next tokens
 
2412
                followers = found_token.followers
 
2413
                break
 
2414
        else:
 
2415
            # No currently valid tokens were found
 
2416
            raise ValueError("Invalid RFC 3339 duration: {!r}"
 
2417
                             .format(duration))
 
2418
    # End token found
 
2419
    return value
 
2420
 
 
2421
 
1533
2422
def string_to_delta(interval):
1534
2423
    """Parse a string and return a datetime.timedelta
1535
2424
    
1536
 
    >>> string_to_delta(u'7d')
 
2425
    >>> string_to_delta('7d')
1537
2426
    datetime.timedelta(7)
1538
 
    >>> string_to_delta(u'60s')
 
2427
    >>> string_to_delta('60s')
1539
2428
    datetime.timedelta(0, 60)
1540
 
    >>> string_to_delta(u'60m')
 
2429
    >>> string_to_delta('60m')
1541
2430
    datetime.timedelta(0, 3600)
1542
 
    >>> string_to_delta(u'24h')
 
2431
    >>> string_to_delta('24h')
1543
2432
    datetime.timedelta(1)
1544
 
    >>> string_to_delta(u'1w')
 
2433
    >>> string_to_delta('1w')
1545
2434
    datetime.timedelta(7)
1546
 
    >>> string_to_delta(u'5m 30s')
 
2435
    >>> string_to_delta('5m 30s')
1547
2436
    datetime.timedelta(0, 330)
1548
2437
    """
 
2438
    
 
2439
    try:
 
2440
        return rfc3339_duration_to_delta(interval)
 
2441
    except ValueError:
 
2442
        pass
 
2443
    
1549
2444
    timevalue = datetime.timedelta(0)
1550
2445
    for s in interval.split():
1551
2446
        try:
1552
 
            suffix = unicode(s[-1])
 
2447
            suffix = s[-1]
1553
2448
            value = int(s[:-1])
1554
 
            if suffix == u"d":
 
2449
            if suffix == "d":
1555
2450
                delta = datetime.timedelta(value)
1556
 
            elif suffix == u"s":
 
2451
            elif suffix == "s":
1557
2452
                delta = datetime.timedelta(0, value)
1558
 
            elif suffix == u"m":
 
2453
            elif suffix == "m":
1559
2454
                delta = datetime.timedelta(0, 0, 0, 0, value)
1560
 
            elif suffix == u"h":
 
2455
            elif suffix == "h":
1561
2456
                delta = datetime.timedelta(0, 0, 0, 0, 0, value)
1562
 
            elif suffix == u"w":
 
2457
            elif suffix == "w":
1563
2458
                delta = datetime.timedelta(0, 0, 0, 0, 0, 0, value)
1564
2459
            else:
1565
 
                raise ValueError(u"Unknown suffix %r" % suffix)
1566
 
        except (ValueError, IndexError), e:
1567
 
            raise ValueError(e.message)
 
2460
                raise ValueError("Unknown suffix {!r}".format(suffix))
 
2461
        except IndexError as e:
 
2462
            raise ValueError(*(e.args))
1568
2463
        timevalue += delta
1569
2464
    return timevalue
1570
2465
 
1571
2466
 
1572
 
def if_nametoindex(interface):
1573
 
    """Call the C function if_nametoindex(), or equivalent
1574
 
    
1575
 
    Note: This function cannot accept a unicode string."""
1576
 
    global if_nametoindex
1577
 
    try:
1578
 
        if_nametoindex = (ctypes.cdll.LoadLibrary
1579
 
                          (ctypes.util.find_library(u"c"))
1580
 
                          .if_nametoindex)
1581
 
    except (OSError, AttributeError):
1582
 
        logger.warning(u"Doing if_nametoindex the hard way")
1583
 
        def if_nametoindex(interface):
1584
 
            "Get an interface index the hard way, i.e. using fcntl()"
1585
 
            SIOCGIFINDEX = 0x8933  # From /usr/include/linux/sockios.h
1586
 
            with contextlib.closing(socket.socket()) as s:
1587
 
                ifreq = fcntl.ioctl(s, SIOCGIFINDEX,
1588
 
                                    struct.pack(str(u"16s16x"),
1589
 
                                                interface))
1590
 
            interface_index = struct.unpack(str(u"I"),
1591
 
                                            ifreq[16:20])[0]
1592
 
            return interface_index
1593
 
    return if_nametoindex(interface)
1594
 
 
1595
 
 
1596
2467
def daemon(nochdir = False, noclose = False):
1597
2468
    """See daemon(3).  Standard BSD Unix function.
1598
2469
    
1601
2472
        sys.exit()
1602
2473
    os.setsid()
1603
2474
    if not nochdir:
1604
 
        os.chdir(u"/")
 
2475
        os.chdir("/")
1605
2476
    if os.fork():
1606
2477
        sys.exit()
1607
2478
    if not noclose:
1608
2479
        # Close all standard open file descriptors
1609
 
        null = os.open(os.path.devnull, os.O_NOCTTY | os.O_RDWR)
 
2480
        null = os.open(os.devnull, os.O_NOCTTY | os.O_RDWR)
1610
2481
        if not stat.S_ISCHR(os.fstat(null).st_mode):
1611
2482
            raise OSError(errno.ENODEV,
1612
 
                          u"%s not a character device"
1613
 
                          % os.path.devnull)
 
2483
                          "{} not a character device"
 
2484
                          .format(os.devnull))
1614
2485
        os.dup2(null, sys.stdin.fileno())
1615
2486
        os.dup2(null, sys.stdout.fileno())
1616
2487
        os.dup2(null, sys.stderr.fileno())
1623
2494
    ##################################################################
1624
2495
    # Parsing of options, both command line and config file
1625
2496
    
1626
 
    parser = optparse.OptionParser(version = "%%prog %s" % version)
1627
 
    parser.add_option("-i", u"--interface", type=u"string",
1628
 
                      metavar="IF", help=u"Bind to interface IF")
1629
 
    parser.add_option("-a", u"--address", type=u"string",
1630
 
                      help=u"Address to listen for requests on")
1631
 
    parser.add_option("-p", u"--port", type=u"int",
1632
 
                      help=u"Port number to receive requests on")
1633
 
    parser.add_option("--check", action=u"store_true",
1634
 
                      help=u"Run self-test")
1635
 
    parser.add_option("--debug", action=u"store_true",
1636
 
                      help=u"Debug mode; run in foreground and log to"
1637
 
                      u" terminal")
1638
 
    parser.add_option("--debuglevel", type=u"string", metavar="Level",
1639
 
                      help=u"Debug level for stdout output")
1640
 
    parser.add_option("--priority", type=u"string", help=u"GnuTLS"
1641
 
                      u" priority string (see GnuTLS documentation)")
1642
 
    parser.add_option("--servicename", type=u"string",
1643
 
                      metavar=u"NAME", help=u"Zeroconf service name")
1644
 
    parser.add_option("--configdir", type=u"string",
1645
 
                      default=u"/etc/mandos", metavar=u"DIR",
1646
 
                      help=u"Directory to search for configuration"
1647
 
                      u" files")
1648
 
    parser.add_option("--no-dbus", action=u"store_false",
1649
 
                      dest=u"use_dbus", help=u"Do not provide D-Bus"
1650
 
                      u" system bus interface")
1651
 
    parser.add_option("--no-ipv6", action=u"store_false",
1652
 
                      dest=u"use_ipv6", help=u"Do not use IPv6")
1653
 
    options = parser.parse_args()[0]
 
2497
    parser = argparse.ArgumentParser()
 
2498
    parser.add_argument("-v", "--version", action="version",
 
2499
                        version = "%(prog)s {}".format(version),
 
2500
                        help="show version number and exit")
 
2501
    parser.add_argument("-i", "--interface", metavar="IF",
 
2502
                        help="Bind to interface IF")
 
2503
    parser.add_argument("-a", "--address",
 
2504
                        help="Address to listen for requests on")
 
2505
    parser.add_argument("-p", "--port", type=int,
 
2506
                        help="Port number to receive requests on")
 
2507
    parser.add_argument("--check", action="store_true",
 
2508
                        help="Run self-test")
 
2509
    parser.add_argument("--debug", action="store_true",
 
2510
                        help="Debug mode; run in foreground and log"
 
2511
                        " to terminal", default=None)
 
2512
    parser.add_argument("--debuglevel", metavar="LEVEL",
 
2513
                        help="Debug level for stdout output")
 
2514
    parser.add_argument("--priority", help="GnuTLS"
 
2515
                        " priority string (see GnuTLS documentation)")
 
2516
    parser.add_argument("--servicename",
 
2517
                        metavar="NAME", help="Zeroconf service name")
 
2518
    parser.add_argument("--configdir",
 
2519
                        default="/etc/mandos", metavar="DIR",
 
2520
                        help="Directory to search for configuration"
 
2521
                        " files")
 
2522
    parser.add_argument("--no-dbus", action="store_false",
 
2523
                        dest="use_dbus", help="Do not provide D-Bus"
 
2524
                        " system bus interface", default=None)
 
2525
    parser.add_argument("--no-ipv6", action="store_false",
 
2526
                        dest="use_ipv6", help="Do not use IPv6",
 
2527
                        default=None)
 
2528
    parser.add_argument("--no-restore", action="store_false",
 
2529
                        dest="restore", help="Do not restore stored"
 
2530
                        " state", default=None)
 
2531
    parser.add_argument("--socket", type=int,
 
2532
                        help="Specify a file descriptor to a network"
 
2533
                        " socket to use instead of creating one")
 
2534
    parser.add_argument("--statedir", metavar="DIR",
 
2535
                        help="Directory to save/restore state in")
 
2536
    parser.add_argument("--foreground", action="store_true",
 
2537
                        help="Run in foreground", default=None)
 
2538
    parser.add_argument("--no-zeroconf", action="store_false",
 
2539
                        dest="zeroconf", help="Do not use Zeroconf",
 
2540
                        default=None)
 
2541
    
 
2542
    options = parser.parse_args()
1654
2543
    
1655
2544
    if options.check:
1656
2545
        import doctest
1657
 
        doctest.testmod()
1658
 
        sys.exit()
 
2546
        fail_count, test_count = doctest.testmod()
 
2547
        sys.exit(os.EX_OK if fail_count == 0 else 1)
1659
2548
    
1660
2549
    # Default values for config file for server-global settings
1661
 
    server_defaults = { u"interface": u"",
1662
 
                        u"address": u"",
1663
 
                        u"port": u"",
1664
 
                        u"debug": u"False",
1665
 
                        u"priority":
1666
 
                        u"SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP",
1667
 
                        u"servicename": u"Mandos",
1668
 
                        u"use_dbus": u"True",
1669
 
                        u"use_ipv6": u"True",
1670
 
                        u"debuglevel": u"",
1671
 
                        }
 
2550
    server_defaults = { "interface": "",
 
2551
                        "address": "",
 
2552
                        "port": "",
 
2553
                        "debug": "False",
 
2554
                        "priority":
 
2555
                        "SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP:!RSA"
 
2556
                        ":+SIGN-DSA-SHA256",
 
2557
                        "servicename": "Mandos",
 
2558
                        "use_dbus": "True",
 
2559
                        "use_ipv6": "True",
 
2560
                        "debuglevel": "",
 
2561
                        "restore": "True",
 
2562
                        "socket": "",
 
2563
                        "statedir": "/var/lib/mandos",
 
2564
                        "foreground": "False",
 
2565
                        "zeroconf": "True",
 
2566
                    }
1672
2567
    
1673
2568
    # Parse config file for server-global settings
1674
2569
    server_config = configparser.SafeConfigParser(server_defaults)
1675
2570
    del server_defaults
1676
 
    server_config.read(os.path.join(options.configdir,
1677
 
                                    u"mandos.conf"))
 
2571
    server_config.read(os.path.join(options.configdir, "mandos.conf"))
1678
2572
    # Convert the SafeConfigParser object to a dict
1679
2573
    server_settings = server_config.defaults()
1680
2574
    # Use the appropriate methods on the non-string config options
1681
 
    for option in (u"debug", u"use_dbus", u"use_ipv6"):
1682
 
        server_settings[option] = server_config.getboolean(u"DEFAULT",
 
2575
    for option in ("debug", "use_dbus", "use_ipv6", "foreground"):
 
2576
        server_settings[option] = server_config.getboolean("DEFAULT",
1683
2577
                                                           option)
1684
2578
    if server_settings["port"]:
1685
 
        server_settings["port"] = server_config.getint(u"DEFAULT",
1686
 
                                                       u"port")
 
2579
        server_settings["port"] = server_config.getint("DEFAULT",
 
2580
                                                       "port")
 
2581
    if server_settings["socket"]:
 
2582
        server_settings["socket"] = server_config.getint("DEFAULT",
 
2583
                                                         "socket")
 
2584
        # Later, stdin will, and stdout and stderr might, be dup'ed
 
2585
        # over with an opened os.devnull.  But we don't want this to
 
2586
        # happen with a supplied network socket.
 
2587
        if 0 <= server_settings["socket"] <= 2:
 
2588
            server_settings["socket"] = os.dup(server_settings
 
2589
                                               ["socket"])
1687
2590
    del server_config
1688
2591
    
1689
2592
    # Override the settings from the config file with command line
1690
2593
    # options, if set.
1691
 
    for option in (u"interface", u"address", u"port", u"debug",
1692
 
                   u"priority", u"servicename", u"configdir",
1693
 
                   u"use_dbus", u"use_ipv6", u"debuglevel"):
 
2594
    for option in ("interface", "address", "port", "debug",
 
2595
                   "priority", "servicename", "configdir", "use_dbus",
 
2596
                   "use_ipv6", "debuglevel", "restore", "statedir",
 
2597
                   "socket", "foreground", "zeroconf"):
1694
2598
        value = getattr(options, option)
1695
2599
        if value is not None:
1696
2600
            server_settings[option] = value
1697
2601
    del options
1698
2602
    # Force all strings to be unicode
1699
2603
    for option in server_settings.keys():
1700
 
        if type(server_settings[option]) is str:
1701
 
            server_settings[option] = unicode(server_settings[option])
 
2604
        if isinstance(server_settings[option], bytes):
 
2605
            server_settings[option] = (server_settings[option]
 
2606
                                       .decode("utf-8"))
 
2607
    # Force all boolean options to be boolean
 
2608
    for option in ("debug", "use_dbus", "use_ipv6", "restore",
 
2609
                   "foreground", "zeroconf"):
 
2610
        server_settings[option] = bool(server_settings[option])
 
2611
    # Debug implies foreground
 
2612
    if server_settings["debug"]:
 
2613
        server_settings["foreground"] = True
1702
2614
    # Now we have our good server settings in "server_settings"
1703
2615
    
1704
2616
    ##################################################################
1705
2617
    
 
2618
    if (not server_settings["zeroconf"]
 
2619
        and not (server_settings["port"]
 
2620
                 or server_settings["socket"] != "")):
 
2621
        parser.error("Needs port or socket to work without Zeroconf")
 
2622
    
1706
2623
    # For convenience
1707
 
    debug = server_settings[u"debug"]
1708
 
    debuglevel = server_settings[u"debuglevel"]
1709
 
    use_dbus = server_settings[u"use_dbus"]
1710
 
    use_ipv6 = server_settings[u"use_ipv6"]
1711
 
 
1712
 
    if server_settings[u"servicename"] != u"Mandos":
1713
 
        syslogger.setFormatter(logging.Formatter
1714
 
                               (u'Mandos (%s) [%%(process)d]:'
1715
 
                                u' %%(levelname)s: %%(message)s'
1716
 
                                % server_settings[u"servicename"]))
 
2624
    debug = server_settings["debug"]
 
2625
    debuglevel = server_settings["debuglevel"]
 
2626
    use_dbus = server_settings["use_dbus"]
 
2627
    use_ipv6 = server_settings["use_ipv6"]
 
2628
    stored_state_path = os.path.join(server_settings["statedir"],
 
2629
                                     stored_state_file)
 
2630
    foreground = server_settings["foreground"]
 
2631
    zeroconf = server_settings["zeroconf"]
 
2632
    
 
2633
    if debug:
 
2634
        initlogger(debug, logging.DEBUG)
 
2635
    else:
 
2636
        if not debuglevel:
 
2637
            initlogger(debug)
 
2638
        else:
 
2639
            level = getattr(logging, debuglevel.upper())
 
2640
            initlogger(debug, level)
 
2641
    
 
2642
    if server_settings["servicename"] != "Mandos":
 
2643
        syslogger.setFormatter(
 
2644
            logging.Formatter('Mandos ({}) [%(process)d]:'
 
2645
                              ' %(levelname)s: %(message)s'.format(
 
2646
                                  server_settings["servicename"])))
1717
2647
    
1718
2648
    # Parse config file with clients
1719
 
    client_defaults = { u"timeout": u"1h",
1720
 
                        u"interval": u"5m",
1721
 
                        u"checker": u"fping -q -- %%(host)s",
1722
 
                        u"host": u"",
1723
 
                        u"approved_delay": u"0s",
1724
 
                        u"approved_duration": u"1s",
1725
 
                        }
1726
 
    client_config = configparser.SafeConfigParser(client_defaults)
1727
 
    client_config.read(os.path.join(server_settings[u"configdir"],
1728
 
                                    u"clients.conf"))
 
2649
    client_config = configparser.SafeConfigParser(Client
 
2650
                                                  .client_defaults)
 
2651
    client_config.read(os.path.join(server_settings["configdir"],
 
2652
                                    "clients.conf"))
1729
2653
    
1730
2654
    global mandos_dbus_service
1731
2655
    mandos_dbus_service = None
1732
2656
    
1733
 
    tcp_server = MandosServer((server_settings[u"address"],
1734
 
                               server_settings[u"port"]),
1735
 
                              ClientHandler,
1736
 
                              interface=server_settings[u"interface"],
1737
 
                              use_ipv6=use_ipv6,
1738
 
                              gnutls_priority=
1739
 
                              server_settings[u"priority"],
1740
 
                              use_dbus=use_dbus)
1741
 
    pidfilename = u"/var/run/mandos.pid"
1742
 
    try:
1743
 
        pidfile = open(pidfilename, u"w")
1744
 
    except IOError:
1745
 
        logger.error(u"Could not open file %r", pidfilename)
 
2657
    socketfd = None
 
2658
    if server_settings["socket"] != "":
 
2659
        socketfd = server_settings["socket"]
 
2660
    tcp_server = MandosServer(
 
2661
        (server_settings["address"], server_settings["port"]),
 
2662
        ClientHandler,
 
2663
        interface=(server_settings["interface"] or None),
 
2664
        use_ipv6=use_ipv6,
 
2665
        gnutls_priority=server_settings["priority"],
 
2666
        use_dbus=use_dbus,
 
2667
        socketfd=socketfd)
 
2668
    if not foreground:
 
2669
        pidfilename = "/run/mandos.pid"
 
2670
        if not os.path.isdir("/run/."):
 
2671
            pidfilename = "/var/run/mandos.pid"
 
2672
        pidfile = None
 
2673
        try:
 
2674
            pidfile = codecs.open(pidfilename, "w", encoding="utf-8")
 
2675
        except IOError as e:
 
2676
            logger.error("Could not open file %r", pidfilename,
 
2677
                         exc_info=e)
1746
2678
    
1747
 
    try:
1748
 
        uid = pwd.getpwnam(u"_mandos").pw_uid
1749
 
        gid = pwd.getpwnam(u"_mandos").pw_gid
1750
 
    except KeyError:
 
2679
    for name in ("_mandos", "mandos", "nobody"):
1751
2680
        try:
1752
 
            uid = pwd.getpwnam(u"mandos").pw_uid
1753
 
            gid = pwd.getpwnam(u"mandos").pw_gid
 
2681
            uid = pwd.getpwnam(name).pw_uid
 
2682
            gid = pwd.getpwnam(name).pw_gid
 
2683
            break
1754
2684
        except KeyError:
1755
 
            try:
1756
 
                uid = pwd.getpwnam(u"nobody").pw_uid
1757
 
                gid = pwd.getpwnam(u"nobody").pw_gid
1758
 
            except KeyError:
1759
 
                uid = 65534
1760
 
                gid = 65534
 
2685
            continue
 
2686
    else:
 
2687
        uid = 65534
 
2688
        gid = 65534
1761
2689
    try:
1762
2690
        os.setgid(gid)
1763
2691
        os.setuid(uid)
1764
 
    except OSError, error:
1765
 
        if error[0] != errno.EPERM:
1766
 
            raise error
 
2692
    except OSError as error:
 
2693
        if error.errno != errno.EPERM:
 
2694
            raise
1767
2695
    
1768
 
    # Enable all possible GnuTLS debugging
1769
 
 
1770
 
 
1771
 
    if not debug and not debuglevel:
1772
 
        syslogger.setLevel(logging.WARNING)
1773
 
        console.setLevel(logging.WARNING)
1774
 
    if debuglevel:
1775
 
        level = getattr(logging, debuglevel.upper())
1776
 
        syslogger.setLevel(level)
1777
 
        console.setLevel(level)
1778
 
 
1779
2696
    if debug:
 
2697
        # Enable all possible GnuTLS debugging
 
2698
        
1780
2699
        # "Use a log level over 10 to enable all debugging options."
1781
2700
        # - GnuTLS manual
1782
2701
        gnutls.library.functions.gnutls_global_set_log_level(11)
1783
2702
        
1784
2703
        @gnutls.library.types.gnutls_log_func
1785
2704
        def debug_gnutls(level, string):
1786
 
            logger.debug(u"GnuTLS: %s", string[:-1])
1787
 
        
1788
 
        (gnutls.library.functions
1789
 
         .gnutls_global_set_log_function(debug_gnutls))
1790
 
 
 
2705
            logger.debug("GnuTLS: %s", string[:-1])
 
2706
        
 
2707
        gnutls.library.functions.gnutls_global_set_log_function(
 
2708
            debug_gnutls)
 
2709
        
1791
2710
        # Redirect stdin so all checkers get /dev/null
1792
 
        null = os.open(os.path.devnull, os.O_NOCTTY | os.O_RDWR)
 
2711
        null = os.open(os.devnull, os.O_NOCTTY | os.O_RDWR)
1793
2712
        os.dup2(null, sys.stdin.fileno())
1794
2713
        if null > 2:
1795
2714
            os.close(null)
1796
 
    else:
1797
 
        # No console logging
1798
 
        logger.removeHandler(console)
1799
 
 
 
2715
    
 
2716
    # Need to fork before connecting to D-Bus
 
2717
    if not foreground:
 
2718
        # Close all input and output, do double fork, etc.
 
2719
        daemon()
 
2720
    
 
2721
    # multiprocessing will use threads, so before we use gobject we
 
2722
    # need to inform gobject that threads will be used.
 
2723
    gobject.threads_init()
1800
2724
    
1801
2725
    global main_loop
1802
2726
    # From the Avahi example code
1803
 
    DBusGMainLoop(set_as_default=True )
 
2727
    DBusGMainLoop(set_as_default=True)
1804
2728
    main_loop = gobject.MainLoop()
1805
2729
    bus = dbus.SystemBus()
1806
2730
    # End of Avahi example code
1807
2731
    if use_dbus:
1808
2732
        try:
1809
 
            bus_name = dbus.service.BusName(u"se.bsnet.fukt.Mandos",
1810
 
                                            bus, do_not_queue=True)
1811
 
        except dbus.exceptions.NameExistsException, e:
1812
 
            logger.error(unicode(e) + u", disabling D-Bus")
 
2733
            bus_name = dbus.service.BusName("se.recompile.Mandos",
 
2734
                                            bus,
 
2735
                                            do_not_queue=True)
 
2736
            old_bus_name = dbus.service.BusName(
 
2737
                "se.bsnet.fukt.Mandos", bus,
 
2738
                do_not_queue=True)
 
2739
        except dbus.exceptions.DBusException as e:
 
2740
            logger.error("Disabling D-Bus:", exc_info=e)
1813
2741
            use_dbus = False
1814
 
            server_settings[u"use_dbus"] = False
 
2742
            server_settings["use_dbus"] = False
1815
2743
            tcp_server.use_dbus = False
1816
 
    protocol = avahi.PROTO_INET6 if use_ipv6 else avahi.PROTO_INET
1817
 
    service = AvahiService(name = server_settings[u"servicename"],
1818
 
                           servicetype = u"_mandos._tcp",
1819
 
                           protocol = protocol, bus = bus)
1820
 
    if server_settings["interface"]:
1821
 
        service.interface = (if_nametoindex
1822
 
                             (str(server_settings[u"interface"])))
1823
 
 
1824
 
    if not debug:
1825
 
        # Close all input and output, do double fork, etc.
1826
 
        daemon()
1827
 
        
 
2744
    if zeroconf:
 
2745
        protocol = avahi.PROTO_INET6 if use_ipv6 else avahi.PROTO_INET
 
2746
        service = AvahiServiceToSyslog(
 
2747
            name = server_settings["servicename"],
 
2748
            servicetype = "_mandos._tcp",
 
2749
            protocol = protocol,
 
2750
            bus = bus)
 
2751
        if server_settings["interface"]:
 
2752
            service.interface = if_nametoindex(
 
2753
                server_settings["interface"].encode("utf-8"))
 
2754
    
1828
2755
    global multiprocessing_manager
1829
2756
    multiprocessing_manager = multiprocessing.Manager()
1830
2757
    
1831
2758
    client_class = Client
1832
2759
    if use_dbus:
1833
2760
        client_class = functools.partial(ClientDBus, bus = bus)
1834
 
    def client_config_items(config, section):
1835
 
        special_settings = {
1836
 
            "approved_by_default":
1837
 
                lambda: config.getboolean(section,
1838
 
                                          "approved_by_default"),
1839
 
            }
1840
 
        for name, value in config.items(section):
 
2761
    
 
2762
    client_settings = Client.config_parser(client_config)
 
2763
    old_client_settings = {}
 
2764
    clients_data = {}
 
2765
    
 
2766
    # This is used to redirect stdout and stderr for checker processes
 
2767
    global wnull
 
2768
    wnull = open(os.devnull, "w") # A writable /dev/null
 
2769
    # Only used if server is running in foreground but not in debug
 
2770
    # mode
 
2771
    if debug or not foreground:
 
2772
        wnull.close()
 
2773
    
 
2774
    # Get client data and settings from last running state.
 
2775
    if server_settings["restore"]:
 
2776
        try:
 
2777
            with open(stored_state_path, "rb") as stored_state:
 
2778
                clients_data, old_client_settings = pickle.load(
 
2779
                    stored_state)
 
2780
            os.remove(stored_state_path)
 
2781
        except IOError as e:
 
2782
            if e.errno == errno.ENOENT:
 
2783
                logger.warning("Could not load persistent state:"
 
2784
                               " {}".format(os.strerror(e.errno)))
 
2785
            else:
 
2786
                logger.critical("Could not load persistent state:",
 
2787
                                exc_info=e)
 
2788
                raise
 
2789
        except EOFError as e:
 
2790
            logger.warning("Could not load persistent state: "
 
2791
                           "EOFError:",
 
2792
                           exc_info=e)
 
2793
    
 
2794
    with PGPEngine() as pgp:
 
2795
        for client_name, client in clients_data.items():
 
2796
            # Skip removed clients
 
2797
            if client_name not in client_settings:
 
2798
                continue
 
2799
            
 
2800
            # Decide which value to use after restoring saved state.
 
2801
            # We have three different values: Old config file,
 
2802
            # new config file, and saved state.
 
2803
            # New config value takes precedence if it differs from old
 
2804
            # config value, otherwise use saved state.
 
2805
            for name, value in client_settings[client_name].items():
 
2806
                try:
 
2807
                    # For each value in new config, check if it
 
2808
                    # differs from the old config value (Except for
 
2809
                    # the "secret" attribute)
 
2810
                    if (name != "secret"
 
2811
                        and (value !=
 
2812
                             old_client_settings[client_name][name])):
 
2813
                        client[name] = value
 
2814
                except KeyError:
 
2815
                    pass
 
2816
            
 
2817
            # Clients who has passed its expire date can still be
 
2818
            # enabled if its last checker was successful.  A Client
 
2819
            # whose checker succeeded before we stored its state is
 
2820
            # assumed to have successfully run all checkers during
 
2821
            # downtime.
 
2822
            if client["enabled"]:
 
2823
                if datetime.datetime.utcnow() >= client["expires"]:
 
2824
                    if not client["last_checked_ok"]:
 
2825
                        logger.warning(
 
2826
                            "disabling client {} - Client never "
 
2827
                            "performed a successful checker".format(
 
2828
                                client_name))
 
2829
                        client["enabled"] = False
 
2830
                    elif client["last_checker_status"] != 0:
 
2831
                        logger.warning(
 
2832
                            "disabling client {} - Client last"
 
2833
                            " checker failed with error code"
 
2834
                            " {}".format(
 
2835
                                client_name,
 
2836
                                client["last_checker_status"]))
 
2837
                        client["enabled"] = False
 
2838
                    else:
 
2839
                        client["expires"] = (
 
2840
                            datetime.datetime.utcnow()
 
2841
                            + client["timeout"])
 
2842
                        logger.debug("Last checker succeeded,"
 
2843
                                     " keeping {} enabled".format(
 
2844
                                         client_name))
1841
2845
            try:
1842
 
                yield (name, special_settings[name]())
1843
 
            except KeyError:
1844
 
                yield (name, value)
1845
 
    
1846
 
    tcp_server.clients.update(set(
1847
 
            client_class(name = section,
1848
 
                         config= dict(client_config_items(
1849
 
                        client_config, section)))
1850
 
            for section in client_config.sections()))
 
2846
                client["secret"] = pgp.decrypt(
 
2847
                    client["encrypted_secret"],
 
2848
                    client_settings[client_name]["secret"])
 
2849
            except PGPError:
 
2850
                # If decryption fails, we use secret from new settings
 
2851
                logger.debug("Failed to decrypt {} old secret".format(
 
2852
                    client_name))
 
2853
                client["secret"] = (client_settings[client_name]
 
2854
                                    ["secret"])
 
2855
    
 
2856
    # Add/remove clients based on new changes made to config
 
2857
    for client_name in (set(old_client_settings)
 
2858
                        - set(client_settings)):
 
2859
        del clients_data[client_name]
 
2860
    for client_name in (set(client_settings)
 
2861
                        - set(old_client_settings)):
 
2862
        clients_data[client_name] = client_settings[client_name]
 
2863
    
 
2864
    # Create all client objects
 
2865
    for client_name, client in clients_data.items():
 
2866
        tcp_server.clients[client_name] = client_class(
 
2867
            name = client_name,
 
2868
            settings = client,
 
2869
            server_settings = server_settings)
 
2870
    
1851
2871
    if not tcp_server.clients:
1852
 
        logger.warning(u"No clients defined")
1853
 
        
1854
 
    try:
1855
 
        with pidfile:
 
2872
        logger.warning("No clients defined")
 
2873
    
 
2874
    if not foreground:
 
2875
        if pidfile is not None:
1856
2876
            pid = os.getpid()
1857
 
            pidfile.write(str(pid) + "\n")
 
2877
            try:
 
2878
                with pidfile:
 
2879
                    print(pid, file=pidfile)
 
2880
            except IOError:
 
2881
                logger.error("Could not write to file %r with PID %d",
 
2882
                             pidfilename, pid)
1858
2883
        del pidfile
1859
 
    except IOError:
1860
 
        logger.error(u"Could not write to file %r with PID %d",
1861
 
                     pidfilename, pid)
1862
 
    except NameError:
1863
 
        # "pidfile" was never created
1864
 
        pass
1865
 
    del pidfilename
 
2884
        del pidfilename
1866
2885
    
1867
 
    if not debug:
1868
 
        signal.signal(signal.SIGINT, signal.SIG_IGN)
1869
2886
    signal.signal(signal.SIGHUP, lambda signum, frame: sys.exit())
1870
2887
    signal.signal(signal.SIGTERM, lambda signum, frame: sys.exit())
1871
2888
    
1872
2889
    if use_dbus:
1873
 
        class MandosDBusService(dbus.service.Object):
 
2890
        
 
2891
        @alternate_dbus_interfaces(
 
2892
            { "se.recompile.Mandos": "se.bsnet.fukt.Mandos" })
 
2893
        class MandosDBusService(DBusObjectWithObjectManager):
1874
2894
            """A D-Bus proxy object"""
 
2895
            
1875
2896
            def __init__(self):
1876
 
                dbus.service.Object.__init__(self, bus, u"/")
1877
 
            _interface = u"se.bsnet.fukt.Mandos"
1878
 
            
1879
 
            @dbus.service.signal(_interface, signature=u"o")
 
2897
                dbus.service.Object.__init__(self, bus, "/")
 
2898
            
 
2899
            _interface = "se.recompile.Mandos"
 
2900
            
 
2901
            @dbus.service.signal(_interface, signature="o")
1880
2902
            def ClientAdded(self, objpath):
1881
2903
                "D-Bus signal"
1882
2904
                pass
1883
2905
            
1884
 
            @dbus.service.signal(_interface, signature=u"ss")
 
2906
            @dbus.service.signal(_interface, signature="ss")
1885
2907
            def ClientNotFound(self, fingerprint, address):
1886
2908
                "D-Bus signal"
1887
2909
                pass
1888
2910
            
1889
 
            @dbus.service.signal(_interface, signature=u"os")
 
2911
            @dbus_annotations({"org.freedesktop.DBus.Deprecated":
 
2912
                               "true"})
 
2913
            @dbus.service.signal(_interface, signature="os")
1890
2914
            def ClientRemoved(self, objpath, name):
1891
2915
                "D-Bus signal"
1892
2916
                pass
1893
2917
            
1894
 
            @dbus.service.method(_interface, out_signature=u"ao")
 
2918
            @dbus_annotations({"org.freedesktop.DBus.Deprecated":
 
2919
                               "true"})
 
2920
            @dbus.service.method(_interface, out_signature="ao")
1895
2921
            def GetAllClients(self):
1896
2922
                "D-Bus method"
1897
 
                return dbus.Array(c.dbus_object_path
1898
 
                                  for c in tcp_server.clients)
 
2923
                return dbus.Array(c.dbus_object_path for c in
 
2924
                                  tcp_server.clients.itervalues())
1899
2925
            
 
2926
            @dbus_annotations({"org.freedesktop.DBus.Deprecated":
 
2927
                               "true"})
1900
2928
            @dbus.service.method(_interface,
1901
 
                                 out_signature=u"a{oa{sv}}")
 
2929
                                 out_signature="a{oa{sv}}")
1902
2930
            def GetAllClientsWithProperties(self):
1903
2931
                "D-Bus method"
1904
2932
                return dbus.Dictionary(
1905
 
                    ((c.dbus_object_path, c.GetAll(u""))
1906
 
                     for c in tcp_server.clients),
1907
 
                    signature=u"oa{sv}")
 
2933
                    { c.dbus_object_path: c.GetAll(
 
2934
                        "se.recompile.Mandos.Client")
 
2935
                      for c in tcp_server.clients.itervalues() },
 
2936
                    signature="oa{sv}")
1908
2937
            
1909
 
            @dbus.service.method(_interface, in_signature=u"o")
 
2938
            @dbus.service.method(_interface, in_signature="o")
1910
2939
            def RemoveClient(self, object_path):
1911
2940
                "D-Bus method"
1912
 
                for c in tcp_server.clients:
 
2941
                for c in tcp_server.clients.itervalues():
1913
2942
                    if c.dbus_object_path == object_path:
1914
 
                        tcp_server.clients.remove(c)
 
2943
                        del tcp_server.clients[c.name]
1915
2944
                        c.remove_from_connection()
1916
 
                        # Don't signal anything except ClientRemoved
 
2945
                        # Don't signal the disabling
1917
2946
                        c.disable(quiet=True)
1918
 
                        # Emit D-Bus signal
1919
 
                        self.ClientRemoved(object_path, c.name)
 
2947
                        # Emit D-Bus signal for removal
 
2948
                        self.client_removed_signal(c)
1920
2949
                        return
1921
2950
                raise KeyError(object_path)
1922
2951
            
1923
2952
            del _interface
 
2953
            
 
2954
            @dbus.service.method(dbus.OBJECT_MANAGER_IFACE,
 
2955
                                 out_signature = "a{oa{sa{sv}}}")
 
2956
            def GetManagedObjects(self):
 
2957
                """D-Bus method"""
 
2958
                return dbus.Dictionary(
 
2959
                    { client.dbus_object_path:
 
2960
                      dbus.Dictionary(
 
2961
                          { interface: client.GetAll(interface)
 
2962
                            for interface in
 
2963
                                 client._get_all_interface_names()})
 
2964
                      for client in tcp_server.clients.values()})
 
2965
            
 
2966
            def client_added_signal(self, client):
 
2967
                """Send the new standard signal and the old signal"""
 
2968
                if use_dbus:
 
2969
                    # New standard signal
 
2970
                    self.InterfacesAdded(
 
2971
                        client.dbus_object_path,
 
2972
                        dbus.Dictionary(
 
2973
                            { interface: client.GetAll(interface)
 
2974
                              for interface in
 
2975
                              client._get_all_interface_names()}))
 
2976
                    # Old signal
 
2977
                    self.ClientAdded(client.dbus_object_path)
 
2978
            
 
2979
            def client_removed_signal(self, client):
 
2980
                """Send the new standard signal and the old signal"""
 
2981
                if use_dbus:
 
2982
                    # New standard signal
 
2983
                    self.InterfacesRemoved(
 
2984
                        client.dbus_object_path,
 
2985
                        client._get_all_interface_names())
 
2986
                    # Old signal
 
2987
                    self.ClientRemoved(client.dbus_object_path,
 
2988
                                       client.name)
1924
2989
        
1925
2990
        mandos_dbus_service = MandosDBusService()
1926
2991
    
1927
2992
    def cleanup():
1928
2993
        "Cleanup function; run on exit"
1929
 
        service.cleanup()
1930
 
        
 
2994
        if zeroconf:
 
2995
            service.cleanup()
 
2996
        
 
2997
        multiprocessing.active_children()
 
2998
        wnull.close()
 
2999
        if not (tcp_server.clients or client_settings):
 
3000
            return
 
3001
        
 
3002
        # Store client before exiting. Secrets are encrypted with key
 
3003
        # based on what config file has. If config file is
 
3004
        # removed/edited, old secret will thus be unrecovable.
 
3005
        clients = {}
 
3006
        with PGPEngine() as pgp:
 
3007
            for client in tcp_server.clients.itervalues():
 
3008
                key = client_settings[client.name]["secret"]
 
3009
                client.encrypted_secret = pgp.encrypt(client.secret,
 
3010
                                                      key)
 
3011
                client_dict = {}
 
3012
                
 
3013
                # A list of attributes that can not be pickled
 
3014
                # + secret.
 
3015
                exclude = { "bus", "changedstate", "secret",
 
3016
                            "checker", "server_settings" }
 
3017
                for name, typ in inspect.getmembers(dbus.service
 
3018
                                                    .Object):
 
3019
                    exclude.add(name)
 
3020
                
 
3021
                client_dict["encrypted_secret"] = (client
 
3022
                                                   .encrypted_secret)
 
3023
                for attr in client.client_structure:
 
3024
                    if attr not in exclude:
 
3025
                        client_dict[attr] = getattr(client, attr)
 
3026
                
 
3027
                clients[client.name] = client_dict
 
3028
                del client_settings[client.name]["secret"]
 
3029
        
 
3030
        try:
 
3031
            with tempfile.NamedTemporaryFile(
 
3032
                    mode='wb',
 
3033
                    suffix=".pickle",
 
3034
                    prefix='clients-',
 
3035
                    dir=os.path.dirname(stored_state_path),
 
3036
                    delete=False) as stored_state:
 
3037
                pickle.dump((clients, client_settings), stored_state)
 
3038
                tempname = stored_state.name
 
3039
            os.rename(tempname, stored_state_path)
 
3040
        except (IOError, OSError) as e:
 
3041
            if not debug:
 
3042
                try:
 
3043
                    os.remove(tempname)
 
3044
                except NameError:
 
3045
                    pass
 
3046
            if e.errno in (errno.ENOENT, errno.EACCES, errno.EEXIST):
 
3047
                logger.warning("Could not save persistent state: {}"
 
3048
                               .format(os.strerror(e.errno)))
 
3049
            else:
 
3050
                logger.warning("Could not save persistent state:",
 
3051
                               exc_info=e)
 
3052
                raise
 
3053
        
 
3054
        # Delete all clients, and settings from config
1931
3055
        while tcp_server.clients:
1932
 
            client = tcp_server.clients.pop()
 
3056
            name, client = tcp_server.clients.popitem()
1933
3057
            if use_dbus:
1934
3058
                client.remove_from_connection()
1935
 
            client.disable_hook = None
1936
 
            # Don't signal anything except ClientRemoved
 
3059
            # Don't signal the disabling
1937
3060
            client.disable(quiet=True)
1938
 
            if use_dbus:
1939
 
                # Emit D-Bus signal
1940
 
                mandos_dbus_service.ClientRemoved(client.dbus_object_path,
1941
 
                                                  client.name)
 
3061
            # Emit D-Bus signal for removal
 
3062
            mandos_dbus_service.client_removed_signal(client)
 
3063
        client_settings.clear()
1942
3064
    
1943
3065
    atexit.register(cleanup)
1944
3066
    
1945
 
    for client in tcp_server.clients:
 
3067
    for client in tcp_server.clients.itervalues():
1946
3068
        if use_dbus:
1947
 
            # Emit D-Bus signal
1948
 
            mandos_dbus_service.ClientAdded(client.dbus_object_path)
1949
 
        client.enable()
 
3069
            # Emit D-Bus signal for adding
 
3070
            mandos_dbus_service.client_added_signal(client)
 
3071
        # Need to initiate checking of clients
 
3072
        if client.enabled:
 
3073
            client.init_checker()
1950
3074
    
1951
3075
    tcp_server.enable()
1952
3076
    tcp_server.server_activate()
1953
3077
    
1954
3078
    # Find out what port we got
1955
 
    service.port = tcp_server.socket.getsockname()[1]
 
3079
    if zeroconf:
 
3080
        service.port = tcp_server.socket.getsockname()[1]
1956
3081
    if use_ipv6:
1957
 
        logger.info(u"Now listening on address %r, port %d,"
1958
 
                    " flowinfo %d, scope_id %d"
1959
 
                    % tcp_server.socket.getsockname())
 
3082
        logger.info("Now listening on address %r, port %d,"
 
3083
                    " flowinfo %d, scope_id %d",
 
3084
                    *tcp_server.socket.getsockname())
1960
3085
    else:                       # IPv4
1961
 
        logger.info(u"Now listening on address %r, port %d"
1962
 
                    % tcp_server.socket.getsockname())
 
3086
        logger.info("Now listening on address %r, port %d",
 
3087
                    *tcp_server.socket.getsockname())
1963
3088
    
1964
3089
    #service.interface = tcp_server.socket.getsockname()[3]
1965
3090
    
1966
3091
    try:
1967
 
        # From the Avahi example code
1968
 
        try:
1969
 
            service.activate()
1970
 
        except dbus.exceptions.DBusException, error:
1971
 
            logger.critical(u"DBusException: %s", error)
1972
 
            cleanup()
1973
 
            sys.exit(1)
1974
 
        # End of Avahi example code
 
3092
        if zeroconf:
 
3093
            # From the Avahi example code
 
3094
            try:
 
3095
                service.activate()
 
3096
            except dbus.exceptions.DBusException as error:
 
3097
                logger.critical("D-Bus Exception", exc_info=error)
 
3098
                cleanup()
 
3099
                sys.exit(1)
 
3100
            # End of Avahi example code
1975
3101
        
1976
3102
        gobject.io_add_watch(tcp_server.fileno(), gobject.IO_IN,
1977
3103
                             lambda *args, **kwargs:
1978
3104
                             (tcp_server.handle_request
1979
3105
                              (*args[2:], **kwargs) or True))
1980
3106
        
1981
 
        logger.debug(u"Starting main loop")
 
3107
        logger.debug("Starting main loop")
1982
3108
        main_loop.run()
1983
 
    except AvahiError, error:
1984
 
        logger.critical(u"AvahiError: %s", error)
 
3109
    except AvahiError as error:
 
3110
        logger.critical("Avahi Error", exc_info=error)
1985
3111
        cleanup()
1986
3112
        sys.exit(1)
1987
3113
    except KeyboardInterrupt:
1988
3114
        if debug:
1989
 
            print >> sys.stderr
1990
 
        logger.debug(u"Server received KeyboardInterrupt")
1991
 
    logger.debug(u"Server exiting")
 
3115
            print("", file=sys.stderr)
 
3116
        logger.debug("Server received KeyboardInterrupt")
 
3117
    logger.debug("Server exiting")
1992
3118
    # Must run before the D-Bus bus name gets deregistered
1993
3119
    cleanup()
1994
3120
 
 
3121
 
1995
3122
if __name__ == '__main__':
1996
3123
    main()