Method StatusChangeCallback

src/python/openvpn3/SessionManager.py:324–352

(self, cbfnc)

    #     (integer) StatusMajor, (integer) StatusMinor, (string) message
    #
    def StatusChangeCallback(self, cbfnc):
        if cbfnc is not None and self.__status_callback is not None:
            # In this case, the program must first disable the
            # current StatusChangeCallback() before setting a new one.
            raise RuntimeError('StatusChangeCallback() is already enabled')

        if cbfnc is None and self.__status_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 StatusChange signals, which will be processed
            # by the callback function
            self.__status_callback = cbfnc
            self.__dbuscon.add_signal_receiver(cbfnc,
                                               signal_name='StatusChange',
                                               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.__status_callback is not None:
                self.__dbuscon.remove_signal_receiver(self.__status_callback,
                                                      'StatusChange')
                self.__status_callback = None

        self.__set_log_forward()


    ##