Re: [Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
On 05/09/2023 07:03, Jeremy Fleischman wrote: I have a feeling we're missing a check here. Got it! You're right, I've added that in the v2 version of this patch (see below). Could you send this via git-send-email, I think this is getting ready to be pulled in now. $ git send-email -v2 \ --in-reply-to 20230709231929.195048-1-jeremyfleisch...@gmail.com Thx! -- kind regards, David Sommerseth OpenVPN Inc ___ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel
Re: [Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
> I have a feeling we're missing a check here. Got it! You're right, I've added that in the v2 version of this patch (see below). diff --git a/src/python/openvpn3/SessionManager.py b/src/python/openvpn3/SessionManager.py index 3632790..a175015 100644 --- a/src/python/openvpn3/SessionManager.py +++ b/src/python/openvpn3/SessionManager.py @@ -114,6 +114,7 @@ def __init__(self, dbuscon, objpath): self.__log_callback = None self.__status_callback = None self.__deleted = False +self.__log_forward_enabled = False def __del__(self): @@ -284,6 +285,16 @@ def GetFormattedStatistics(self, prefix='Connection statistics:\n', format_str=' # # 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: self.__log_callback = cbfnc self.__dbuscon.add_signal_receiver(cbfnc, @@ -291,16 +302,14 @@ def LogCallback(self, cbfnc): dbus_interface='net.openvpn.v3.backends', bus_name='net.openvpn.v3.log', path=self.__session_path) -self.__session_intf.LogForward(True) else: -try: -self.__session_intf.LogForward(False) -except dbus.exceptions.DBusException: -# If this fails, the session is typically already removed -pass -self.__dbuscon.remove_signal_receiver(self.__log_callback, 'Log') -self.__log_callback = None +# 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 @@ -310,6 +319,16 @@ def LogCallback(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: self.__status_callback = cbfnc self.__dbuscon.add_signal_receiver(cbfnc, @@ -318,10 +337,14 @@ def StatusChangeCallback(self, cbfnc): bus_name='net.openvpn.v3.log', path=self.__session_path) else: -self.__dbuscon.remove_signal_receiver(self.__status_callback, - 'StatusChange') -self.__status_callback = None +# 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() ## @@ -417,6 +440,30 @@ def GetDCO(self): def SetDCO(self, dco): self.__prop_intf.Set('net.openvpn.v3.sessions', 'dco', dco) +## +# Internal method to enable/disable LogForward as needed. +# Must be called whenever a callback that needs LogForward enabled is +# added or removed. +# +def __set_log_forward(self): +# The LogCallback and the StatusChangeCallback both need LogForward +# enabled. In other words, LogForward should be enabled iff one or both +# of those callbacks are registered. +should_log_forward_be_enabled = ( +self.__log_callback is not None or self.__status_callback is not None +) + +if should_log_forward_be_enabled and not self.__log_forward_enabled: +self.__session_intf.LogForward(True) +self.__log_forward_enabled = True +elif not should_log_forward_be_enabled and self.__log_forward_enabled: +try: +self.__session_intf.LogForward(False) +except
Re: [Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
On 04/09/2023 23:27, Jeremy Fleischman wrote: elif (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') This should enforce only one callback function being enabled this way, and if the callback need to be changed - it's enough to first do disable it (LogCallback(None)) before setting the new one. And if more callbacks functions is wanted/needed, the additional ones can be called via the callback function registered with the LogCallback(). No need to make this code more complicated. That makes sense! I *think* things get a little cleaner if we move this check to the top of the relevant functions (StatusChangeCallback and LogCallback). Basically, by first eliminating the possibility that we're changing an existing registered dbus callback, then we don't actually need to be as careful later on. For example, here's an updated version of LogCallback: 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 not None: 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() Does this seem safe? I have a feeling we're missing a check here. The first check (with the raise RuntimeError), cbfnc and __log_callback are both set. Next check will enable the signal receiver if cbfnc is set. The previous check enforces __log_callback to not be set in this case; this is probably fine - but should have a comment of this condition. The else: clause I'm less convinced about. If cbfnc is None, __log_callback can also be None, which would trigger a remove_signal_receiver() call. We should avoid that. I'm not familiar with path email etiquette/best practices. Let me know if/when I should send a fully updated patch. So far, we've discussed possible solutions - so it has been fine doing it like this now. But I think with this last round, we can go for a v2 patch. -- kind regards, David Sommerseth OpenVPN Inc ___ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel
Re: [Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
> elif (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') > > This should enforce only one callback function being enabled this way, > and if the callback need to be changed - it's enough to first do disable > it (LogCallback(None)) before setting the new one. And if more > callbacks functions is wanted/needed, the additional ones can be called > via the callback function registered with the LogCallback(). No need to > make this code more complicated. That makes sense! I *think* things get a little cleaner if we move this check to the top of the relevant functions (StatusChangeCallback and LogCallback). Basically, by first eliminating the possibility that we're changing an existing registered dbus callback, then we don't actually need to be as careful later on. For example, here's an updated version of LogCallback: 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 not None: 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() Does this seem safe? I'm not familiar with path email etiquette/best practices. Let me know if/when I should send a fully updated patch. ___ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel
Re: [Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
[re-sent to ML] On 04/09/2023 19:51, Jeremy Fleischman wrote: diff --git a/src/python/openvpn3/SessionManager.py b/src/python/openvpn3/SessionManager.py index 3632790..1a567be 100644 --- a/src/python/openvpn3/SessionManager.py +++ b/src/python/openvpn3/SessionManager.py @@ -114,6 +114,7 @@ def __init__(self, dbuscon, objpath): self.__log_callback = None self.__status_callback = None self.__deleted = False +self.__log_forward_enabled = False def __del__(self): @@ -291,16 +292,11 @@ def LogCallback(self, cbfnc): dbus_interface='net.openvpn.v3.backends', bus_name='net.openvpn.v3.log', path=self.__session_path) -self.__session_intf.LogForward(True) else: -try: -self.__session_intf.LogForward(False) -except dbus.exceptions.DBusException: -# If this fails, the session is typically already removed -pass self.__dbuscon.remove_signal_receiver(self.__log_callback, 'Log') self.__log_callback = None Oops, this code unconditionally removes the callback, even if there isn't currently a callback. The code below in StatusChangeCallback first checks if there is currently a callback registered before removing it. If `self.__dbuscon.remove_signal_receiver` is resilient to getting passed None values for callbacks, then I suppose would could skip the check and just unconditionally remove the callback. Let me know what's best. If you look at my proposal; in the LogCallback() method, I have this check: if cbfnc is not None and self.__log_callback is None: while you only do: if cbfnc is not None: I believe you need to check both (more below on that). And there is a similar logic check when disabling the callback: elif cbfnc is None and self.__log_callback is not None: I believe this is the trap you fell into. Your new patch just do an "else:" The additional final check of setting a new callback without disabling the previous one can avoid some additional trouble. IIRC, the Python D-Bus API will actually call multiple callbacks if add_signal_receiver() is called more times with different callback methods. To support this, the LogCallback() and StatusChangeCallback() methods would need to track each callback function independently. I did not consider this a needed feature just yet; hence the additional final check: elif (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') This should enforce only one callback function being enabled this way, and if the callback need to be changed - it's enough to first do disable it (LogCallback(None)) before setting the new one. And if more callbacks functions is wanted/needed, the additional ones can be called via the callback function registered with the LogCallback(). No need to make this code more complicated. Otherwise, I like what you did to __set_log_forward(). That makes sense! -- kind regards, David Sommerseth OpenVPN Inc ___ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel
Re: [Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
> diff --git a/src/python/openvpn3/SessionManager.py > b/src/python/openvpn3/SessionManager.py > index 3632790..1a567be 100644 > --- a/src/python/openvpn3/SessionManager.py > +++ b/src/python/openvpn3/SessionManager.py > @@ -114,6 +114,7 @@ def __init__(self, dbuscon, objpath): > self.__log_callback = None > self.__status_callback = None > self.__deleted = False > +self.__log_forward_enabled = False > > > def __del__(self): > @@ -291,16 +292,11 @@ def LogCallback(self, cbfnc): > > dbus_interface='net.openvpn.v3.backends', > bus_name='net.openvpn.v3.log', > path=self.__session_path) > -self.__session_intf.LogForward(True) > else: > -try: > -self.__session_intf.LogForward(False) > -except dbus.exceptions.DBusException: > -# If this fails, the session is typically already removed > -pass > self.__dbuscon.remove_signal_receiver(self.__log_callback, 'Log') > self.__log_callback = None Oops, this code unconditionally removes the callback, even if there isn't currently a callback. The code below in StatusChangeCallback first checks if there is currently a callback registered before removing it. If `self.__dbuscon.remove_signal_receiver` is resilient to getting passed None values for callbacks, then I suppose would could skip the check and just unconditionally remove the callback. Let me know what's best. > > +self.__set_log_forward() > > ## > # Subscribes to the StatusChange signals for this session and register > @@ -318,10 +314,14 @@ def StatusChangeCallback(self, cbfnc): > bus_name='net.openvpn.v3.log', > path=self.__session_path) > else: > -self.__dbuscon.remove_signal_receiver(self.__status_callback, > - 'StatusChange') > -self.__status_callback = None > +# 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() > > > ## > @@ -417,6 +417,30 @@ def GetDCO(self): > def SetDCO(self, dco): > self.__prop_intf.Set('net.openvpn.v3.sessions', 'dco', dco) > > +## > +# Internal method to enable/disable LogForward as needed. > +# Must be called whenever a callback that needs LogForward enabled is > +# added or removed. > +# > +def __set_log_forward(self): > +# The LogCallback and the StatusChangeCallback both need LogForward > +# enabled. In other words, LogForward should be enabled iff one or > both > +# of those callbacks are registered. > +should_log_forward_be_enabled = ( > +self.__log_callback is not None or self.__status_callback > is not None > +) > + > +if should_log_forward_be_enabled and not self.__log_forward_enabled: > +self.__session_intf.LogForward(True) > +self.__log_forward_enabled = True > +elif not should_log_forward_be_enabled and > self.__log_forward_enabled: > +try: > +self.__session_intf.LogForward(False) > +except dbus.exceptions.DBusException: > +# If this fails, the session is typically already removed > +pass > + > +self.__log_forward_enabled = False > > > ## ___ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel
Re: [Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
Hey David, On Sun, Sep 3, 2023 at 3:56 PM David Sommerseth wrote: > > First of all; sorry it's taken so long time to get back to you. GH > issue #171 has unfortunately taken most of my time, so this patch went > on the side burner. No worries, thanks for getting around to this! > I've looked at your patch, and I wonder if it can be done a bit simpler. > I'm open to hear your views; I might have overlooked some details. I like this! At a high level, your proposal consolidates the logic about "who needs LogForward enabled" into this new __set_log_forward method. It maybe makes it a little more complicated to add more callbacks in the future that require LogForward, but that's an incredibly minor point, and I don't think it's worth the complication of the reference counting implementation I originally proposed. I took your idea, and rolled with it a bit. I think we can simplify things a bit further if we let __set_log_forward be completely responsible for determining if LogForward should be enabled (it knows if it should be enabled because it can check if there are any callbacks registered that require LogForward). How does this updated diff look? diff --git a/src/python/openvpn3/SessionManager.py b/src/python/openvpn3/SessionManager.py index 3632790..1a567be 100644 --- a/src/python/openvpn3/SessionManager.py +++ b/src/python/openvpn3/SessionManager.py @@ -114,6 +114,7 @@ def __init__(self, dbuscon, objpath): self.__log_callback = None self.__status_callback = None self.__deleted = False +self.__log_forward_enabled = False def __del__(self): @@ -291,16 +292,11 @@ def LogCallback(self, cbfnc): dbus_interface='net.openvpn.v3.backends', bus_name='net.openvpn.v3.log', path=self.__session_path) -self.__session_intf.LogForward(True) else: -try: -self.__session_intf.LogForward(False) -except dbus.exceptions.DBusException: -# If this fails, the session is typically already removed -pass 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 @@ -318,10 +314,14 @@ def StatusChangeCallback(self, cbfnc): bus_name='net.openvpn.v3.log', path=self.__session_path) else: -self.__dbuscon.remove_signal_receiver(self.__status_callback, - 'StatusChange') -self.__status_callback = None +# 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() ## @@ -417,6 +417,30 @@ def GetDCO(self): def SetDCO(self, dco): self.__prop_intf.Set('net.openvpn.v3.sessions', 'dco', dco) +## +# Internal method to enable/disable LogForward as needed. +# Must be called whenever a callback that needs LogForward enabled is +# added or removed. +# +def __set_log_forward(self): +# The LogCallback and the StatusChangeCallback both need LogForward +# enabled. In other words, LogForward should be enabled iff one or both +# of those callbacks are registered. +should_log_forward_be_enabled = ( +self.__log_callback is not None or self.__status_callback is not None +) + +if should_log_forward_be_enabled and not self.__log_forward_enabled: +self.__session_intf.LogForward(True) +self.__log_forward_enabled = True +elif not should_log_forward_be_enabled and self.__log_forward_enabled: +try: +self.__session_intf.LogForward(False) +except dbus.exceptions.DBusException: +# If this fails, the session is typically already removed +pass + +self.__log_forward_enabled = False ## ___ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel
Re: [Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
Hi Jeremy, First of all; sorry it's taken so long time to get back to you. GH issue #171 has unfortunately taken most of my time, so this patch went on the side burner. I've looked at your patch, and I wonder if it can be done a bit simpler. I'm open to hear your views; I might have overlooked some details. On 10/07/2023 01:19, Jeremy Fleischman wrote: [...snip...] @@ -285,22 +286,24 @@ def GetFormattedStatistics(self, prefix='Connection statistics:\n', format_str=' # def LogCallback(self, cbfnc): if cbfnc is not None: +# Remove the existing callback if there is one. +if self.__log_callback is not None: +self.LogCallback(None) + 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) -self.__session_intf.LogForward(True) +self.__add_LogForward_receiver() I'm wondering if this could be made cleared. The recursion is kinda clever, but feels like it hides the purpose. Wouldn't this code below work just as well (consider this more a concept code than proper Python code)? Here there is no recursion and no reference counting which could go wrong. class Session(object): [...] self.__log_forward_enabled = False def LogCallback(self, cbfnc): if cbfnc is not None and self.__log_callback is None: # Log Callback function is being enabled; not # set before self.__log_callback = cbfnc self.__dbuscon.add_signal_receiver(cbfnc, ...) self.__set_log_forward(True) elif cbfnc is None and self.__log_callback is not None: # Log Callback function is being disabled; can only # happen because it was set self.__dbuscon.remove_signal_receiver(self.__log_callback, ...) self.__log_callback = None try: self.__set_log_forward(False) except dbus.exception.DBusException: pass elif (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 RuntimeErrpr('LogCallback() is already enabled') # No need to complain if unsetting an unset log callback # function; this will not have any behavioral impact at all. def __set_log_forward(self, enable): # This method can only be called *after* callback # function has been set in this object if not self.__log_forward_enabled and enable: # If log forwarding is disabled it can be enabled self.__log_forward_enabled = True self.__session_intf.LogForward(True) elif self.__log_forward_enabled and not enable: # Log forwarding can only be disabled if # both Log and StatusChange callbacks are unset if (self.__log_callback is None) and (self.__status_callback is None): self.__log_forward_enabled = False self.__session_intf.LogForward(False) The StatusChangeCallback() would need a similar implementation as LogCallback() too. In regards to multi-threading; I would not expect this code to be used in a multi-threaded setup where different callbacks would be enabled/disabled on the fly in parallel. But it might be good to add this as a comment in general, that these methods are not considered thread-safe. However, since the code snippets above does not use reference counting, it should be a bit more robust as it bases the decision on the value of the callback function pointers. Thoughts? -- kind regards, David Sommerseth OpenVPN Inc ___ Openvpn-devel mailing list Openvpn-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/openvpn-devel
[Openvpn-devel] [PATCH] Fix StatusChangeCallback so it works without a LogCallback
`StatusChangeCallback` requires that LogForward be enabled, which previously only happened in `LogCallback`. Now both of them do it, which requires a bit of bookkeeping. This fixes https://github.com/OpenVPN/openvpn3-linux/issues/197 Notes: 1. I'm not sure if this would place nicely with a multithreaded program or not. Hopefully that's not something we care to support? 2. To keep the bookkeeping accurate, I opted to explictly remove any preexisting callbacks before registering a new one. This means that when you're clobbering an existing LogCallback (for example), you'll actually end disabling LogForward right before you re-enable it. I don't think this is a big deal, but just wanted to call it out. Signed-off-by: Jeremy Fleischman --- src/python/openvpn3/SessionManager.py | 63 ++- 1 file changed, 51 insertions(+), 12 deletions(-) diff --git a/src/python/openvpn3/SessionManager.py b/src/python/openvpn3/SessionManager.py index 3632790..05126aa 100644 --- a/src/python/openvpn3/SessionManager.py +++ b/src/python/openvpn3/SessionManager.py @@ -114,6 +114,7 @@ def __init__(self, dbuscon, objpath): self.__log_callback = None self.__status_callback = None self.__deleted = False +self.__LogForward_receiver_count = 0 def __del__(self): @@ -285,22 +286,24 @@ def GetFormattedStatistics(self, prefix='Connection statistics:\n', format_str=' # def LogCallback(self, cbfnc): if cbfnc is not None: +# Remove the existing callback if there is one. +if self.__log_callback is not None: +self.LogCallback(None) + 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) -self.__session_intf.LogForward(True) +self.__add_LogForward_receiver() else: -try: -self.__session_intf.LogForward(False) -except dbus.exceptions.DBusException: -# If this fails, the session is typically already removed -pass -self.__dbuscon.remove_signal_receiver(self.__log_callback, 'Log') -self.__log_callback = None - +# Only remove the callback if there actually *is* a callback +# currently. +if self.__log_callback is not None: +self.__remove_LogForward_receiver() +self.__dbuscon.remove_signal_receiver(self.__log_callback, 'Log') +self.__log_callback = None ## # Subscribes to the StatusChange signals for this session and register @@ -311,16 +314,25 @@ def LogCallback(self, cbfnc): # def StatusChangeCallback(self, cbfnc): if cbfnc is not None: +# Remove the existing callback if there is one. +if self.__status_callback is not None: +self.StatusChangeCallback(None) + 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) +self.__add_LogForward_receiver() else: -self.__dbuscon.remove_signal_receiver(self.__status_callback, - 'StatusChange') -self.__status_callback = None +# Only remove the callback if there actually *is* a callback +# currently. +if self.__status_callback is not None: +self.__remove_LogForward_receiver() +self.__dbuscon.remove_signal_receiver(self.__status_callback, + 'StatusChange') +self.__status_callback = None @@ -417,6 +429,33 @@ def GetDCO(self): def SetDCO(self, dco): self.__prop_intf.Set('net.openvpn.v3.sessions', 'dco', dco) +## +# Internal method to increase the count of how many signal receivers need +# LogForward. Turns on LogForward if this is the first receiver. +# +def __add_LogForward_receiver(self): +# This is our first need for LogForward. Turn it on. +if self.__LogForward_receiver_count == 0: +self.__session_intf.LogForward(True) + +self.__LogForward_receiver_count += 1 + +## +# Internal method track to reduce the count of how many signal receivers +# need LogForward. Turns off