Method LogCallback

src/python/openvpn3/SessionManager.py:288–315

(self, cbfnc)

    #
    #
    def LogCallback(self, cbfnc):
        if cbfnc is not None and self.__log_callback is not None:
            # In this case, the program must first disable the
            # current LogCallback() before setting a new one.
            raise RuntimeError('LogCallback() is already enabled')

        if cbfnc is None and self.__log_callback is None:
            # This is fine: disabling a callback when there is no
            # callback is a simple no-op.
            return

        if cbfnc is not None:
            # Subscribe to Log signals, which will be processed
            # by the callback function
            self.__log_callback = cbfnc
            self.__dbuscon.add_signal_receiver(cbfnc,
                                               signal_name='Log',
                                               dbus_interface='net.openvpn.v3.backends',
                                               bus_name='net.openvpn.v3.log',
                                               path=self.__session_path)
        else:
            # Only remove the callback if there actually *is* a callback
            # currently.
            if self.__log_callback is not None:
                self.__dbuscon.remove_signal_receiver(self.__log_callback, 'Log')
                self.__log_callback = None

        self.__set_log_forward()

    ##
    #  Subscribes to the StatusChange signals for this session and register