383
427
                                    follow_name_owner_changes=True),
 
384
428
                avahi.DBUS_INTERFACE_SERVER)
 
385
429
        self.server.connect_to_signal("StateChanged",
 
386
 
                                 self.server_state_changed)
 
 
430
                                      self.server_state_changed)
 
387
431
        self.server_state_changed(self.server.GetState())
 
390
434
class AvahiServiceToSyslog(AvahiService):
 
 
435
    def rename(self, *args, **kwargs):
 
392
436
        """Add the new name to the syslog messages"""
 
393
 
        ret = AvahiService.rename(self)
 
394
 
        syslogger.setFormatter(logging.Formatter
 
395
 
                               ('Mandos ({}) [%(process)d]:'
 
396
 
                                ' %(levelname)s: %(message)s'
 
 
437
        ret = AvahiService.rename(self, *args, **kwargs)
 
 
438
        syslogger.setFormatter(logging.Formatter(
 
 
439
            'Mandos ({}) [%(process)d]: %(levelname)s: %(message)s'
 
 
443
# Pretend that we have a GnuTLS module
 
 
444
class GnuTLS(object):
 
 
445
    """This isn't so much a class as it is a module-like namespace.
 
 
446
    It is instantiated once, and simulates having a GnuTLS module."""
 
 
448
    _library = ctypes.cdll.LoadLibrary(
 
 
449
        ctypes.util.find_library("gnutls"))
 
 
450
    _need_version = "3.3.0"
 
 
452
        # Need to use class name "GnuTLS" here, since this method is
 
 
453
        # called before the assignment to the "gnutls" global variable
 
 
455
        if GnuTLS.check_version(self._need_version) is None:
 
 
456
            raise GnuTLS.Error("Needs GnuTLS {} or later"
 
 
457
                               .format(self._need_version))
 
 
459
    # Unless otherwise indicated, the constants and types below are
 
 
460
    # all from the gnutls/gnutls.h C header file.
 
 
470
    E_NO_CERTIFICATE_FOUND = -49
 
 
471
    OPENPGP_FMT_RAW = 0         # gnutls/openpgp.h
 
 
474
    class session_int(ctypes.Structure):
 
 
476
    session_t = ctypes.POINTER(session_int)
 
 
477
    class certificate_credentials_st(ctypes.Structure):
 
 
479
    certificate_credentials_t = ctypes.POINTER(
 
 
480
        certificate_credentials_st)
 
 
481
    certificate_type_t = ctypes.c_int
 
 
482
    class datum_t(ctypes.Structure):
 
 
483
        _fields_ = [('data', ctypes.POINTER(ctypes.c_ubyte)),
 
 
484
                    ('size', ctypes.c_uint)]
 
 
485
    class openpgp_crt_int(ctypes.Structure):
 
 
487
    openpgp_crt_t = ctypes.POINTER(openpgp_crt_int)
 
 
488
    openpgp_crt_fmt_t = ctypes.c_int # gnutls/openpgp.h
 
 
489
    log_func = ctypes.CFUNCTYPE(None, ctypes.c_int, ctypes.c_char_p)
 
 
490
    credentials_type_t = ctypes.c_int # 
 
 
491
    transport_ptr_t = ctypes.c_void_p
 
 
492
    close_request_t = ctypes.c_int
 
 
495
    class Error(Exception):
 
 
496
        # We need to use the class name "GnuTLS" here, since this
 
 
497
        # exception might be raised from within GnuTLS.__init__,
 
 
498
        # which is called before the assignment to the "gnutls"
 
 
499
        # global variable has happened.
 
 
500
        def __init__(self, message = None, code = None, args=()):
 
 
501
            # Default usage is by a message string, but if a return
 
 
502
            # code is passed, convert it to a string with
 
 
505
            if message is None and code is not None:
 
 
506
                message = GnuTLS.strerror(code)
 
 
507
            return super(GnuTLS.Error, self).__init__(
 
 
510
    class CertificateSecurityError(Error):
 
 
514
    class Credentials(object):
 
 
516
            self._c_object = gnutls.certificate_credentials_t()
 
 
517
            gnutls.certificate_allocate_credentials(
 
 
518
                ctypes.byref(self._c_object))
 
 
519
            self.type = gnutls.CRD_CERTIFICATE
 
 
522
            gnutls.certificate_free_credentials(self._c_object)
 
 
524
    class ClientSession(object):
 
 
525
        def __init__(self, socket, credentials = None):
 
 
526
            self._c_object = gnutls.session_t()
 
 
527
            gnutls.init(ctypes.byref(self._c_object), gnutls.CLIENT)
 
 
528
            gnutls.set_default_priority(self._c_object)
 
 
529
            gnutls.transport_set_ptr(self._c_object, socket.fileno())
 
 
530
            gnutls.handshake_set_private_extensions(self._c_object,
 
 
533
            if credentials is None:
 
 
534
                credentials = gnutls.Credentials()
 
 
535
            gnutls.credentials_set(self._c_object, credentials.type,
 
 
536
                                   ctypes.cast(credentials._c_object,
 
 
538
            self.credentials = credentials
 
 
541
            gnutls.deinit(self._c_object)
 
 
544
            return gnutls.handshake(self._c_object)
 
 
546
        def send(self, data):
 
 
550
                data_len -= gnutls.record_send(self._c_object,
 
 
555
            return gnutls.bye(self._c_object, gnutls.SHUT_RDWR)
 
 
557
    # Error handling functions
 
 
558
    def _error_code(result):
 
 
559
        """A function to raise exceptions on errors, suitable
 
 
560
        for the 'restype' attribute on ctypes functions"""
 
 
563
        if result == gnutls.E_NO_CERTIFICATE_FOUND:
 
 
564
            raise gnutls.CertificateSecurityError(code = result)
 
 
565
        raise gnutls.Error(code = result)
 
 
567
    def _retry_on_error(result, func, arguments):
 
 
568
        """A function to retry on some errors, suitable
 
 
569
        for the 'errcheck' attribute on ctypes functions"""
 
 
571
            if result not in (gnutls.E_INTERRUPTED, gnutls.E_AGAIN):
 
 
572
                return _error_code(result)
 
 
573
            result = func(*arguments)
 
 
576
    # Unless otherwise indicated, the function declarations below are
 
 
577
    # all from the gnutls/gnutls.h C header file.
 
 
580
    priority_set_direct = _library.gnutls_priority_set_direct
 
 
581
    priority_set_direct.argtypes = [session_t, ctypes.c_char_p,
 
 
582
                                    ctypes.POINTER(ctypes.c_char_p)]
 
 
583
    priority_set_direct.restype = _error_code
 
 
585
    init = _library.gnutls_init
 
 
586
    init.argtypes = [ctypes.POINTER(session_t), ctypes.c_int]
 
 
587
    init.restype = _error_code
 
 
589
    set_default_priority = _library.gnutls_set_default_priority
 
 
590
    set_default_priority.argtypes = [session_t]
 
 
591
    set_default_priority.restype = _error_code
 
 
593
    record_send = _library.gnutls_record_send
 
 
594
    record_send.argtypes = [session_t, ctypes.c_void_p,
 
 
596
    record_send.restype = ctypes.c_ssize_t
 
 
597
    record_send.errcheck = _retry_on_error
 
 
599
    certificate_allocate_credentials = (
 
 
600
        _library.gnutls_certificate_allocate_credentials)
 
 
601
    certificate_allocate_credentials.argtypes = [
 
 
602
        ctypes.POINTER(certificate_credentials_t)]
 
 
603
    certificate_allocate_credentials.restype = _error_code
 
 
605
    certificate_free_credentials = (
 
 
606
        _library.gnutls_certificate_free_credentials)
 
 
607
    certificate_free_credentials.argtypes = [certificate_credentials_t]
 
 
608
    certificate_free_credentials.restype = None
 
 
610
    handshake_set_private_extensions = (
 
 
611
        _library.gnutls_handshake_set_private_extensions)
 
 
612
    handshake_set_private_extensions.argtypes = [session_t,
 
 
614
    handshake_set_private_extensions.restype = None
 
 
616
    credentials_set = _library.gnutls_credentials_set
 
 
617
    credentials_set.argtypes = [session_t, credentials_type_t,
 
 
619
    credentials_set.restype = _error_code
 
 
621
    strerror = _library.gnutls_strerror
 
 
622
    strerror.argtypes = [ctypes.c_int]
 
 
623
    strerror.restype = ctypes.c_char_p
 
 
625
    certificate_type_get = _library.gnutls_certificate_type_get
 
 
626
    certificate_type_get.argtypes = [session_t]
 
 
627
    certificate_type_get.restype = _error_code
 
 
629
    certificate_get_peers = _library.gnutls_certificate_get_peers
 
 
630
    certificate_get_peers.argtypes = [session_t,
 
 
631
                                      ctypes.POINTER(ctypes.c_uint)]
 
 
632
    certificate_get_peers.restype = ctypes.POINTER(datum_t)
 
 
634
    global_set_log_level = _library.gnutls_global_set_log_level
 
 
635
    global_set_log_level.argtypes = [ctypes.c_int]
 
 
636
    global_set_log_level.restype = None
 
 
638
    global_set_log_function = _library.gnutls_global_set_log_function
 
 
639
    global_set_log_function.argtypes = [log_func]
 
 
640
    global_set_log_function.restype = None
 
 
642
    deinit = _library.gnutls_deinit
 
 
643
    deinit.argtypes = [session_t]
 
 
644
    deinit.restype = None
 
 
646
    handshake = _library.gnutls_handshake
 
 
647
    handshake.argtypes = [session_t]
 
 
648
    handshake.restype = _error_code
 
 
649
    handshake.errcheck = _retry_on_error
 
 
651
    transport_set_ptr = _library.gnutls_transport_set_ptr
 
 
652
    transport_set_ptr.argtypes = [session_t, transport_ptr_t]
 
 
653
    transport_set_ptr.restype = None
 
 
655
    bye = _library.gnutls_bye
 
 
656
    bye.argtypes = [session_t, close_request_t]
 
 
657
    bye.restype = _error_code
 
 
658
    bye.errcheck = _retry_on_error
 
 
660
    check_version = _library.gnutls_check_version
 
 
661
    check_version.argtypes = [ctypes.c_char_p]
 
 
662
    check_version.restype = ctypes.c_char_p
 
 
664
    # All the function declarations below are from gnutls/openpgp.h
 
 
666
    openpgp_crt_init = _library.gnutls_openpgp_crt_init
 
 
667
    openpgp_crt_init.argtypes = [ctypes.POINTER(openpgp_crt_t)]
 
 
668
    openpgp_crt_init.restype = _error_code
 
 
670
    openpgp_crt_import = _library.gnutls_openpgp_crt_import
 
 
671
    openpgp_crt_import.argtypes = [openpgp_crt_t,
 
 
672
                                   ctypes.POINTER(datum_t),
 
 
674
    openpgp_crt_import.restype = _error_code
 
 
676
    openpgp_crt_verify_self = _library.gnutls_openpgp_crt_verify_self
 
 
677
    openpgp_crt_verify_self.argtypes = [openpgp_crt_t, ctypes.c_uint,
 
 
678
                                        ctypes.POINTER(ctypes.c_uint)]
 
 
679
    openpgp_crt_verify_self.restype = _error_code
 
 
681
    openpgp_crt_deinit = _library.gnutls_openpgp_crt_deinit
 
 
682
    openpgp_crt_deinit.argtypes = [openpgp_crt_t]
 
 
683
    openpgp_crt_deinit.restype = None
 
 
685
    openpgp_crt_get_fingerprint = (
 
 
686
        _library.gnutls_openpgp_crt_get_fingerprint)
 
 
687
    openpgp_crt_get_fingerprint.argtypes = [openpgp_crt_t,
 
 
691
    openpgp_crt_get_fingerprint.restype = _error_code
 
 
693
    # Remove non-public functions
 
 
694
    del _error_code, _retry_on_error
 
 
695
# Create the global "gnutls" object, simulating a module
 
 
698
def call_pipe(connection,       # : multiprocessing.Connection
 
 
699
              func, *args, **kwargs):
 
 
700
    """This function is meant to be called by multiprocessing.Process
 
 
702
    This function runs func(*args, **kwargs), and writes the resulting
 
 
703
    return value on the provided multiprocessing.Connection.
 
 
705
    connection.send(func(*args, **kwargs))
 
401
708
class Client(object):
 
402
709
    """A representation of a client host served by this server.
 
 
599
906
        # and every interval from then on.
 
600
907
        if self.checker_initiator_tag is not None:
 
601
908
            gobject.source_remove(self.checker_initiator_tag)
 
602
 
        self.checker_initiator_tag = (gobject.timeout_add
 
604
 
                                           .total_seconds() * 1000),
 
 
909
        self.checker_initiator_tag = gobject.timeout_add(
 
 
910
            int(self.interval.total_seconds() * 1000),
 
606
912
        # Schedule a disable() when 'timeout' has passed
 
607
913
        if self.disable_initiator_tag is not None:
 
608
914
            gobject.source_remove(self.disable_initiator_tag)
 
609
 
        self.disable_initiator_tag = (gobject.timeout_add
 
611
 
                                           .total_seconds() * 1000),
 
 
915
        self.disable_initiator_tag = gobject.timeout_add(
 
 
916
            int(self.timeout.total_seconds() * 1000), self.disable)
 
613
917
        # Also start a new checker *right now*.
 
614
918
        self.start_checker()
 
616
 
    def checker_callback(self, pid, condition, command):
 
 
920
    def checker_callback(self, source, condition, connection,
 
617
922
        """The checker has completed, so take appropriate actions."""
 
618
923
        self.checker_callback_tag = None
 
619
924
        self.checker = None
 
620
 
        if os.WIFEXITED(condition):
 
621
 
            self.last_checker_status = os.WEXITSTATUS(condition)
 
 
925
        # Read return code from connection (see call_pipe)
 
 
926
        returncode = connection.recv()
 
 
930
            self.last_checker_status = returncode
 
 
931
            self.last_checker_signal = None
 
622
932
            if self.last_checker_status == 0:
 
623
933
                logger.info("Checker for %(name)s succeeded",
 
625
935
                self.checked_ok()
 
627
 
                logger.info("Checker for %(name)s failed",
 
 
937
                logger.info("Checker for %(name)s failed", vars(self))
 
630
939
            self.last_checker_status = -1
 
 
940
            self.last_checker_signal = -returncode
 
631
941
            logger.warning("Checker for %(name)s crashed?",
 
634
945
    def checked_ok(self):
 
635
946
        """Assert that the client has been seen, alive and well."""
 
636
947
        self.last_checked_ok = datetime.datetime.utcnow()
 
637
948
        self.last_checker_status = 0
 
 
949
        self.last_checker_signal = None
 
638
950
        self.bump_timeout()
 
640
952
    def bump_timeout(self, timeout=None):
 
 
667
978
        # than 'timeout' for the client to be disabled, which is as it
 
670
 
        # If a checker exists, make sure it is not a zombie
 
672
 
            pid, status = os.waitpid(self.checker.pid, os.WNOHANG)
 
673
 
        except AttributeError:
 
675
 
        except OSError as error:
 
676
 
            if error.errno != errno.ECHILD:
 
680
 
                logger.warning("Checker was a zombie")
 
681
 
                gobject.source_remove(self.checker_callback_tag)
 
682
 
                self.checker_callback(pid, status,
 
683
 
                                      self.current_checker_command)
 
 
981
        if self.checker is not None and not self.checker.is_alive():
 
 
982
            logger.warning("Checker was not alive; joining")
 
684
985
        # Start a new checker if needed
 
685
986
        if self.checker is None:
 
686
987
            # Escape attributes for the shell
 
687
 
            escaped_attrs = { attr:
 
688
 
                                  re.escape(unicode(getattr(self,
 
690
 
                              for attr in self.runtime_expansions }
 
 
989
                attr: re.escape(str(getattr(self, attr)))
 
 
990
                for attr in self.runtime_expansions }
 
692
992
                command = self.checker_command % escaped_attrs
 
693
993
            except TypeError as error:
 
694
994
                logger.error('Could not format string "%s"',
 
695
 
                             self.checker_command, exc_info=error)
 
696
 
                return True # Try again later
 
 
995
                             self.checker_command,
 
 
997
                return True     # Try again later
 
697
998
            self.current_checker_command = command
 
699
 
                logger.info("Starting checker %r for %s",
 
701
 
                # We don't need to redirect stdout and stderr, since
 
702
 
                # in normal mode, that is already done by daemon(),
 
703
 
                # and in debug mode we don't want to.  (Stdin is
 
704
 
                # always replaced by /dev/null.)
 
705
 
                # The exception is when not debugging but nevertheless
 
706
 
                # running in the foreground; use the previously
 
709
 
                if (not self.server_settings["debug"]
 
710
 
                    and self.server_settings["foreground"]):
 
711
 
                    popen_args.update({"stdout": wnull,
 
713
 
                self.checker = subprocess.Popen(command,
 
717
 
            except OSError as error:
 
718
 
                logger.error("Failed to start subprocess",
 
721
 
            self.checker_callback_tag = (gobject.child_watch_add
 
723
 
                                          self.checker_callback,
 
725
 
            # The checker may have completed before the gobject
 
726
 
            # watch was added.  Check for this.
 
728
 
                pid, status = os.waitpid(self.checker.pid, os.WNOHANG)
 
729
 
            except OSError as error:
 
730
 
                if error.errno == errno.ECHILD:
 
731
 
                    # This should never happen
 
732
 
                    logger.error("Child process vanished",
 
737
 
                gobject.source_remove(self.checker_callback_tag)
 
738
 
                self.checker_callback(pid, status, command)
 
 
999
            logger.info("Starting checker %r for %s", command,
 
 
1001
            # We don't need to redirect stdout and stderr, since
 
 
1002
            # in normal mode, that is already done by daemon(),
 
 
1003
            # and in debug mode we don't want to.  (Stdin is
 
 
1004
            # always replaced by /dev/null.)
 
 
1005
            # The exception is when not debugging but nevertheless
 
 
1006
            # running in the foreground; use the previously
 
 
1008
            popen_args = { "close_fds": True,
 
 
1011
            if (not self.server_settings["debug"]
 
 
1012
                and self.server_settings["foreground"]):
 
 
1013
                popen_args.update({"stdout": wnull,
 
 
1015
            pipe = multiprocessing.Pipe(duplex = False)
 
 
1016
            self.checker = multiprocessing.Process(
 
 
1018
                args = (pipe[1], subprocess.call, command),
 
 
1019
                kwargs = popen_args)
 
 
1020
            self.checker.start()
 
 
1021
            self.checker_callback_tag = gobject.io_add_watch(
 
 
1022
                pipe[0].fileno(), gobject.IO_IN,
 
 
1023
                self.checker_callback, pipe[0], command)
 
739
1024
        # Re-run this periodically if run by gobject.timeout_add
 
 
863
1151
    def _get_all_dbus_things(self, thing):
 
864
1152
        """Returns a generator of (name, attribute) pairs
 
866
 
        return ((getattr(athing.__get__(self), "_dbus_name",
 
 
1154
        return ((getattr(athing.__get__(self), "_dbus_name", name),
 
868
1155
                 athing.__get__(self))
 
869
1156
                for cls in self.__class__.__mro__
 
870
1157
                for name, athing in
 
871
 
                inspect.getmembers(cls,
 
872
 
                                   self._is_dbus_thing(thing)))
 
 
1158
                inspect.getmembers(cls, self._is_dbus_thing(thing)))
 
 
1160
    @dbus.service.method(dbus.INTROSPECTABLE_IFACE,
 
 
1161
                         out_signature = "s",
 
 
1162
                         path_keyword = 'object_path',
 
 
1163
                         connection_keyword = 'connection')
 
 
1164
    def Introspect(self, object_path, connection):
 
 
1165
        """Overloading of standard D-Bus method.
 
 
1167
        Inserts annotation tags on methods and signals.
 
 
1169
        xmlstring = dbus.service.Object.Introspect(self, object_path,
 
 
1172
            document = xml.dom.minidom.parseString(xmlstring)
 
 
1174
            for if_tag in document.getElementsByTagName("interface"):
 
 
1175
                # Add annotation tags
 
 
1176
                for typ in ("method", "signal"):
 
 
1177
                    for tag in if_tag.getElementsByTagName(typ):
 
 
1179
                        for name, prop in (self.
 
 
1180
                                           _get_all_dbus_things(typ)):
 
 
1181
                            if (name == tag.getAttribute("name")
 
 
1182
                                and prop._dbus_interface
 
 
1183
                                == if_tag.getAttribute("name")):
 
 
1184
                                annots.update(getattr(
 
 
1185
                                    prop, "_dbus_annotations", {}))
 
 
1186
                        for name, value in annots.items():
 
 
1187
                            ann_tag = document.createElement(
 
 
1189
                            ann_tag.setAttribute("name", name)
 
 
1190
                            ann_tag.setAttribute("value", value)
 
 
1191
                            tag.appendChild(ann_tag)
 
 
1192
                # Add interface annotation tags
 
 
1193
                for annotation, value in dict(
 
 
1194
                    itertools.chain.from_iterable(
 
 
1195
                        annotations().items()
 
 
1196
                        for name, annotations
 
 
1197
                        in self._get_all_dbus_things("interface")
 
 
1198
                        if name == if_tag.getAttribute("name")
 
 
1200
                    ann_tag = document.createElement("annotation")
 
 
1201
                    ann_tag.setAttribute("name", annotation)
 
 
1202
                    ann_tag.setAttribute("value", value)
 
 
1203
                    if_tag.appendChild(ann_tag)
 
 
1204
                # Fix argument name for the Introspect method itself
 
 
1205
                if (if_tag.getAttribute("name")
 
 
1206
                                == dbus.INTROSPECTABLE_IFACE):
 
 
1207
                    for cn in if_tag.getElementsByTagName("method"):
 
 
1208
                        if cn.getAttribute("name") == "Introspect":
 
 
1209
                            for arg in cn.getElementsByTagName("arg"):
 
 
1210
                                if (arg.getAttribute("direction")
 
 
1212
                                    arg.setAttribute("name",
 
 
1214
            xmlstring = document.toxml("utf-8")
 
 
1216
        except (AttributeError, xml.dom.DOMException,
 
 
1217
                xml.parsers.expat.ExpatError) as error:
 
 
1218
            logger.error("Failed to override Introspection method",
 
 
1223
class DBusObjectWithProperties(DBusObjectWithAnnotations):
 
 
1224
    """A D-Bus object with properties.
 
 
1226
    Classes inheriting from this can use the dbus_service_property
 
 
1227
    decorator to expose methods as D-Bus properties.  It exposes the
 
 
1228
    standard Get(), Set(), and GetAll() methods on the D-Bus.
 
874
1231
    def _get_dbus_property(self, interface_name, property_name):
 
875
1232
        """Returns a bound method if one exists which is a D-Bus
 
876
1233
        property with the specified name and interface.
 
878
 
        for cls in  self.__class__.__mro__:
 
879
 
            for name, value in (inspect.getmembers
 
881
 
                                 self._is_dbus_thing("property"))):
 
 
1235
        for cls in self.__class__.__mro__:
 
 
1236
            for name, value in inspect.getmembers(
 
 
1237
                    cls, self._is_dbus_thing("property")):
 
882
1238
                if (value._dbus_name == property_name
 
883
1239
                    and value._dbus_interface == interface_name):
 
884
1240
                    return value.__get__(self)
 
886
1242
        # No such property
 
887
 
        raise DBusPropertyNotFound(self.dbus_object_path + ":"
 
888
 
                                   + interface_name + "."
 
891
 
    @dbus.service.method(dbus.PROPERTIES_IFACE, in_signature="ss",
 
 
1243
        raise DBusPropertyNotFound("{}:{}.{}".format(
 
 
1244
            self.dbus_object_path, interface_name, property_name))
 
 
1247
    def _get_all_interface_names(cls):
 
 
1248
        """Get a sequence of all interfaces supported by an object"""
 
 
1249
        return (name for name in set(getattr(getattr(x, attr),
 
 
1250
                                             "_dbus_interface", None)
 
 
1251
                                     for x in (inspect.getmro(cls))
 
 
1253
                if name is not None)
 
 
1255
    @dbus.service.method(dbus.PROPERTIES_IFACE,
 
892
1257
                         out_signature="v")
 
893
1258
    def Get(self, interface_name, property_name):
 
894
1259
        """Standard D-Bus property Get() method, see D-Bus standard.
 
 
1025
1387
                         exc_info=error)
 
1026
1388
        return xmlstring
 
 
1391
    dbus.OBJECT_MANAGER_IFACE
 
 
1392
except AttributeError:
 
 
1393
    dbus.OBJECT_MANAGER_IFACE = "org.freedesktop.DBus.ObjectManager"
 
 
1395
class DBusObjectWithObjectManager(DBusObjectWithAnnotations):
 
 
1396
    """A D-Bus object with an ObjectManager.
 
 
1398
    Classes inheriting from this exposes the standard
 
 
1399
    GetManagedObjects call and the InterfacesAdded and
 
 
1400
    InterfacesRemoved signals on the standard
 
 
1401
    "org.freedesktop.DBus.ObjectManager" interface.
 
 
1403
    Note: No signals are sent automatically; they must be sent
 
 
1406
    @dbus.service.method(dbus.OBJECT_MANAGER_IFACE,
 
 
1407
                         out_signature = "a{oa{sa{sv}}}")
 
 
1408
    def GetManagedObjects(self):
 
 
1409
        """This function must be overridden"""
 
 
1410
        raise NotImplementedError()
 
 
1412
    @dbus.service.signal(dbus.OBJECT_MANAGER_IFACE,
 
 
1413
                         signature = "oa{sa{sv}}")
 
 
1414
    def InterfacesAdded(self, object_path, interfaces_and_properties):
 
 
1417
    @dbus.service.signal(dbus.OBJECT_MANAGER_IFACE, signature = "oas")
 
 
1418
    def InterfacesRemoved(self, object_path, interfaces):
 
 
1421
    @dbus.service.method(dbus.INTROSPECTABLE_IFACE,
 
 
1422
                         out_signature = "s",
 
 
1423
                         path_keyword = 'object_path',
 
 
1424
                         connection_keyword = 'connection')
 
 
1425
    def Introspect(self, object_path, connection):
 
 
1426
        """Overloading of standard D-Bus method.
 
 
1428
        Override return argument name of GetManagedObjects to be
 
 
1429
        "objpath_interfaces_and_properties"
 
 
1431
        xmlstring = DBusObjectWithAnnotations.Introspect(self,
 
 
1435
            document = xml.dom.minidom.parseString(xmlstring)
 
 
1437
            for if_tag in document.getElementsByTagName("interface"):
 
 
1438
                # Fix argument name for the GetManagedObjects method
 
 
1439
                if (if_tag.getAttribute("name")
 
 
1440
                                == dbus.OBJECT_MANAGER_IFACE):
 
 
1441
                    for cn in if_tag.getElementsByTagName("method"):
 
 
1442
                        if (cn.getAttribute("name")
 
 
1443
                            == "GetManagedObjects"):
 
 
1444
                            for arg in cn.getElementsByTagName("arg"):
 
 
1445
                                if (arg.getAttribute("direction")
 
 
1449
                                        "objpath_interfaces"
 
 
1451
            xmlstring = document.toxml("utf-8")
 
 
1453
        except (AttributeError, xml.dom.DOMException,
 
 
1454
                xml.parsers.expat.ExpatError) as error:
 
 
1455
            logger.error("Failed to override Introspection method",
 
1029
1459
def datetime_to_dbus(dt, variant_level=0):
 
1030
1460
    """Convert a UTC datetime.datetime() to a D-Bus type."""
 
1032
1462
        return dbus.String("", variant_level = variant_level)
 
1033
 
    return dbus.String(dt.isoformat(),
 
1034
 
                       variant_level=variant_level)
 
 
1463
    return dbus.String(dt.isoformat(), variant_level=variant_level)
 
1037
1466
def alternate_dbus_interfaces(alt_interface_names, deprecate=True):
 
 
1067
1497
                # Ignore non-D-Bus attributes, and D-Bus attributes
 
1068
1498
                # with the wrong interface name
 
1069
1499
                if (not hasattr(attribute, "_dbus_interface")
 
1070
 
                    or not attribute._dbus_interface
 
1071
 
                    .startswith(orig_interface_name)):
 
 
1500
                    or not attribute._dbus_interface.startswith(
 
 
1501
                        orig_interface_name)):
 
1073
1503
                # Create an alternate D-Bus interface name based on
 
1074
1504
                # the current name
 
1075
 
                alt_interface = (attribute._dbus_interface
 
1076
 
                                 .replace(orig_interface_name,
 
1077
 
                                          alt_interface_name))
 
 
1505
                alt_interface = attribute._dbus_interface.replace(
 
 
1506
                    orig_interface_name, alt_interface_name)
 
1078
1507
                interface_names.add(alt_interface)
 
1079
1508
                # Is this a D-Bus signal?
 
1080
1509
                if getattr(attribute, "_dbus_is_signal", False):
 
1081
 
                    # Extract the original non-method undecorated
 
1082
 
                    # function by black magic
 
1083
 
                    nonmethod_func = (dict(
 
 
1510
                    if sys.version_info.major == 2:
 
 
1511
                        # Extract the original non-method undecorated
 
 
1512
                        # function by black magic
 
 
1513
                        nonmethod_func = (dict(
 
1084
1514
                            zip(attribute.func_code.co_freevars,
 
1085
 
                                attribute.__closure__))["func"]
 
 
1515
                                attribute.__closure__))
 
 
1516
                                          ["func"].cell_contents)
 
 
1518
                        nonmethod_func = attribute
 
1087
1519
                    # Create a new, but exactly alike, function
 
1088
1520
                    # object, and decorate it to be a new D-Bus signal
 
1089
1521
                    # with the alternate D-Bus interface name
 
1090
 
                    new_function = (dbus.service.signal
 
1092
 
                                     attribute._dbus_signature)
 
1093
 
                                    (types.FunctionType(
 
1094
 
                                nonmethod_func.func_code,
 
1095
 
                                nonmethod_func.func_globals,
 
1096
 
                                nonmethod_func.func_name,
 
1097
 
                                nonmethod_func.func_defaults,
 
1098
 
                                nonmethod_func.func_closure)))
 
 
1522
                    if sys.version_info.major == 2:
 
 
1523
                        new_function = types.FunctionType(
 
 
1524
                            nonmethod_func.func_code,
 
 
1525
                            nonmethod_func.func_globals,
 
 
1526
                            nonmethod_func.func_name,
 
 
1527
                            nonmethod_func.func_defaults,
 
 
1528
                            nonmethod_func.func_closure)
 
 
1530
                        new_function = types.FunctionType(
 
 
1531
                            nonmethod_func.__code__,
 
 
1532
                            nonmethod_func.__globals__,
 
 
1533
                            nonmethod_func.__name__,
 
 
1534
                            nonmethod_func.__defaults__,
 
 
1535
                            nonmethod_func.__closure__)
 
 
1536
                    new_function = (dbus.service.signal(
 
 
1538
                        attribute._dbus_signature)(new_function))
 
1099
1539
                    # Copy annotations, if any
 
1101
 
                        new_function._dbus_annotations = (
 
1102
 
                            dict(attribute._dbus_annotations))
 
 
1541
                        new_function._dbus_annotations = dict(
 
 
1542
                            attribute._dbus_annotations)
 
1103
1543
                    except AttributeError:
 
1105
1545
                    # Define a creator of a function to call both the
 
 
1821
2288
    def fingerprint(openpgp):
 
1822
2289
        "Convert an OpenPGP bytestring to a hexdigit fingerprint"
 
1823
2290
        # New GnuTLS "datum" with the OpenPGP public key
 
1824
 
        datum = (gnutls.library.types
 
1825
 
                 .gnutls_datum_t(ctypes.cast(ctypes.c_char_p(openpgp),
 
1828
 
                                 ctypes.c_uint(len(openpgp))))
 
 
2291
        datum = gnutls.datum_t(
 
 
2292
            ctypes.cast(ctypes.c_char_p(openpgp),
 
 
2293
                        ctypes.POINTER(ctypes.c_ubyte)),
 
 
2294
            ctypes.c_uint(len(openpgp)))
 
1829
2295
        # New empty GnuTLS certificate
 
1830
 
        crt = gnutls.library.types.gnutls_openpgp_crt_t()
 
1831
 
        (gnutls.library.functions
 
1832
 
         .gnutls_openpgp_crt_init(ctypes.byref(crt)))
 
 
2296
        crt = gnutls.openpgp_crt_t()
 
 
2297
        gnutls.openpgp_crt_init(ctypes.byref(crt))
 
1833
2298
        # Import the OpenPGP public key into the certificate
 
1834
 
        (gnutls.library.functions
 
1835
 
         .gnutls_openpgp_crt_import(crt, ctypes.byref(datum),
 
1836
 
                                    gnutls.library.constants
 
1837
 
                                    .GNUTLS_OPENPGP_FMT_RAW))
 
 
2299
        gnutls.openpgp_crt_import(crt, ctypes.byref(datum),
 
 
2300
                                  gnutls.OPENPGP_FMT_RAW)
 
1838
2301
        # Verify the self signature in the key
 
1839
2302
        crtverify = ctypes.c_uint()
 
1840
 
        (gnutls.library.functions
 
1841
 
         .gnutls_openpgp_crt_verify_self(crt, 0,
 
1842
 
                                         ctypes.byref(crtverify)))
 
 
2303
        gnutls.openpgp_crt_verify_self(crt, 0,
 
 
2304
                                       ctypes.byref(crtverify))
 
1843
2305
        if crtverify.value != 0:
 
1844
 
            gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)
 
1845
 
            raise (gnutls.errors.CertificateSecurityError
 
 
2306
            gnutls.openpgp_crt_deinit(crt)
 
 
2307
            raise gnutls.CertificateSecurityError("Verify failed")
 
1847
2308
        # New buffer for the fingerprint
 
1848
2309
        buf = ctypes.create_string_buffer(20)
 
1849
2310
        buf_len = ctypes.c_size_t()
 
1850
2311
        # Get the fingerprint from the certificate into the buffer
 
1851
 
        (gnutls.library.functions
 
1852
 
         .gnutls_openpgp_crt_get_fingerprint(crt, ctypes.byref(buf),
 
1853
 
                                             ctypes.byref(buf_len)))
 
 
2312
        gnutls.openpgp_crt_get_fingerprint(crt, ctypes.byref(buf),
 
 
2313
                                           ctypes.byref(buf_len))
 
1854
2314
        # Deinit the certificate
 
1855
 
        gnutls.library.functions.gnutls_openpgp_crt_deinit(crt)
 
 
2315
        gnutls.openpgp_crt_deinit(crt)
 
1856
2316
        # Convert the buffer to a Python bytestring
 
1857
2317
        fpr = ctypes.string_at(buf, buf_len.value)
 
1858
2318
        # Convert the bytestring to hexadecimal notation