Files
os-ken/os_ken/lib/hub.py
Brian Haley 8195cd818c Fix a few eventlet leftovers in the code
There were still a couple of places where the threading
code was using eventlet. Cleaned them up along with some
other test issues noticed during debugging.

Add a definition for cancel() to HubThread class in
native code as it is called when threads are stopped in
the BGP peer code.

Use hub.kill(thread) to kill threads instead of
thread.kill() as it will use hub-specific logic.

Add a stop() method to BGP Peer class so users can stop
any threads that might have been started in __init__(),
like the periodic stats logger.

Do not use eventlet to spawn threads in BGP code, always
use self._spawn() which uses hub-specific code.

Use hub.Semaphore class in bgp/speaker.py which uses the
hub-specific semaphore code.

Change BGP peer "looped" tests to not enable the periodic
stats logging thread since it is unnecessary, and
would require a call to the class stop() method on exit.

Related-bug: #2087939
Change-Id: Ib2a1e12a2d5d25ede1cc1678d23e88ceae822b31
Signed-off-by: Brian Haley <haleyb.dev@gmail.com>
2025-10-31 15:18:01 -04:00

395 lines
12 KiB
Python

# Copyright (C) 2013 Nippon Telegraph and Telephone Corporation.
# Copyright (C) 2013 YAMAMOTO Takashi <yamamoto at valinux co jp>
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
# implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import logging
import os
import ssl
import socket
import sys
import traceback
from os_ken.lib import ip
# We don't bother to use cfg.py because monkey patch needs to be
# called very early. Instead, we use an environment variable to
# select the type of hub.
HUB_TYPE = os.getenv('OSKEN_HUB_TYPE', 'eventlet')
LOG = logging.getLogger('os_ken.lib.hub')
class StreamServer(object):
def __init__(self, listen_info, handle=None, backlog=None,
spawn='default', **ssl_args):
assert backlog is None
assert spawn == 'default'
if ip.valid_ipv6(listen_info[0]):
self.server = listen(listen_info, family=socket.AF_INET6)
elif os.path.isdir(os.path.dirname(listen_info[0])):
# Case for Unix domain socket
self.server = listen(listen_info[0], family=socket.AF_UNIX)
else:
self.server = listen(listen_info)
if ssl_args:
ssl_args.setdefault('server_side', True)
if 'ssl_ctx' not in ssl_args:
raise RuntimeError("no SSLContext ssl_ctx in ssl_args")
ctx = ssl_args.pop('ssl_ctx')
ctx.load_cert_chain(ssl_args.pop('certfile'),
ssl_args.pop('keyfile'))
if 'cert_reqs' in ssl_args:
ctx.verify_mode = ssl_args.pop('cert_reqs')
if 'ca_certs' in ssl_args:
ctx.load_verify_locations(ssl_args.pop('ca_certs'))
def wrap_and_handle_ctx(sock, addr):
handle(ctx.wrap_socket(sock, **ssl_args), addr)
self.handle = wrap_and_handle_ctx
else:
self.handle = handle
def serve_forever(self):
while True:
sock, addr = self.server.accept()
spawn(self.handle, sock, addr)
class StreamClient(object):
def __init__(self, addr, timeout=None, **ssl_args):
assert ip.valid_ipv4(addr[0]) or ip.valid_ipv6(addr[0])
self.addr = addr
self.timeout = timeout
self.ssl_args = ssl_args
self._is_active = True
def connect(self):
try:
if self.timeout is not None:
client = socket.create_connection(self.addr,
timeout=self.timeout)
else:
client = socket.create_connection(self.addr)
except socket.error:
return None
if self.ssl_args:
ctx = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
ctx.load_cert_chain(self.ssl_args.pop('certfile'),
self.ssl_args.pop('keyfile'))
if 'cert_reqs' in self.ssl_args:
ctx.verify_mode = self.ssl_args.pop('cert_reqs')
if 'ca_certs' in self.ssl_args:
ctx.load_verify_location(self.ssl_args.pop('ca_certs'))
client = ctx.wrap_socket(client, **self.ssl_args)
return client
def connect_loop(self, handle, interval):
while self._is_active:
sock = self.connect()
if sock:
handle(sock, self.addr)
sleep(interval)
def stop(self):
self._is_active = False
class LoggingWrapper(object):
def write(self, message):
LOG.info(message.rstrip('\n'))
class Event(object):
def __init__(self):
self._ev = HubEvent()
self._cond = False
def _wait(self, timeout=None):
while not self._cond:
self._ev.wait()
def _broadcast(self):
self._ev.send()
# Since eventlet Event doesn't allow multiple send() operations
# on an event, re-create the underlying event.
# Note: _ev.reset() is obsolete.
self._ev = HubEvent()
def is_set(self):
return self._cond
def set(self):
self._cond = True
self._broadcast()
def clear(self):
self._cond = False
def wait(self, timeout=None):
if timeout is None:
self._wait()
else:
try:
with Timeout(timeout):
self._wait()
except Timeout:
pass
return self._cond
if HUB_TYPE == 'eventlet':
import eventlet
# HACK:
# sleep() is the workaround for the following issue.
# https://github.com/eventlet/eventlet/issues/401
eventlet.sleep()
import eventlet.event
import eventlet.queue
import eventlet.semaphore
import eventlet.timeout
import eventlet.wsgi
from eventlet import websocket
import greenlet
getcurrent = eventlet.getcurrent
sleep = eventlet.sleep
listen = eventlet.listen
connect = eventlet.connect
def patch(thread=True):
eventlet.monkey_patch(thread=thread)
def spawn(*args, **kwargs):
raise_error = kwargs.pop('raise_error', False)
def _launch(func, *args, **kwargs):
# Mimic gevent's default raise_error=False behaviour
# by not propagating an exception to the joiner.
try:
return func(*args, **kwargs)
except TaskExit:
pass
except BaseException as e:
if raise_error:
raise e
# Log uncaught exception.
# Note: this is an intentional divergence from gevent
# behaviour; gevent silently ignores such exceptions.
LOG.error('hub: uncaught exception: %s',
traceback.format_exc())
return eventlet.spawn(_launch, *args, **kwargs)
def spawn_after(seconds, *args, **kwargs):
raise_error = kwargs.pop('raise_error', False)
def _launch(func, *args, **kwargs):
# Mimic gevent's default raise_error=False behaviour
# by not propagating an exception to the joiner.
try:
return func(*args, **kwargs)
except TaskExit:
pass
except BaseException as e:
if raise_error:
raise e
# Log uncaught exception.
# Note: this is an intentional divergence from gevent
# behaviour; gevent silently ignores such exceptions.
LOG.error('hub: uncaught exception: %s',
traceback.format_exc())
return eventlet.spawn_after(seconds, _launch, *args, **kwargs)
def kill(thread):
thread.kill()
def joinall(threads):
for t in threads:
# This try-except is necessary when killing an inactive
# greenthread.
try:
t.wait()
except TaskExit:
pass
Queue = eventlet.queue.LightQueue
QueueEmpty = eventlet.queue.Empty
Semaphore = eventlet.semaphore.Semaphore
BoundedSemaphore = eventlet.semaphore.BoundedSemaphore
TaskExit = greenlet.GreenletExit
class WSGIServer(StreamServer):
def serve_forever(self):
self.logger = LoggingWrapper()
eventlet.wsgi.server(self.server, self.handle, self.logger)
WebSocketWSGI = websocket.WebSocketWSGI
Timeout = eventlet.timeout.Timeout
HubEvent = eventlet.event.Event
elif HUB_TYPE == 'native':
LOG.warning("The native implementation is incomplete "
"and should not be used in production environments.")
import threading
import queue
import time
class HubThread(threading.Thread):
def wait(self, timeout=None):
self.join(timeout)
def __init__(self, target, args=(), kwargs=None):
self.raise_error = kwargs.pop('raise_error', False)
super().__init__(target=target, args=args, kwargs=kwargs)
def run(self):
try:
super().run()
except TaskExit:
pass
except BaseException as e:
if self.raise_error:
raise e
LOG.error('HubThread uncaught exception: %s',
traceback.format_exc())
def cancel(self):
pass
def spawn(func, *args, **kwargs):
thread = HubThread(func, args, kwargs)
thread.start()
return thread
def spawn_after(seconds, func, *args, **kwargs):
def delayed_func():
time.sleep(seconds)
func(*args, **kwargs)
return spawn(delayed_func)
def joinall(threads):
for thread in threads:
thread.join()
def kill(thread):
# NOTE(sahid): There is no safe and reliable way to force
# stopping a thread in Python. It is recommended to implement
# a proper termination mechanism using a flag or an event.
pass
getcurrent = threading.current_thread()
sleep = time.sleep
Queue = queue.Queue
QueueEmpty = queue.Empty
Semaphore = threading.Semaphore
BoundedSemaphore = threading.BoundedSemaphore
TaskExit = Exception
HubEvent = threading.Event
class HubEvent(threading.Event):
def send(self):
self.set()
class Timeout(BaseException):
"""
Largely inspired by:
https://github.com/eventlet/eventlet/blob/master/eventlet/timeout.py
"""
def __init__(self, seconds=None, exception=None):
self._event = threading.Event()
self._queue = queue.Queue()
self.seconds = seconds
self.exception = exception
self.timer = None
self.start()
def start(self):
if self.seconds is None:
# "fake" timeout (never expires)
self.timer = None
else:
self.timer = threading.Timer(self.seconds, self._on_timeout)
self.timer.start()
self._wait()
return self
def __enter__(self):
if self.timer is None:
self.start()
return self
def __exit__(self, typ, value, tb):
self.cancel()
if value is self and self.exception is False:
return True
def _on_timeout(self):
if self.exception is None or isinstance(self.exception, bool):
# timeout that raises self
exc = self
else:
exc = self.exception
self._queue.put(exc)
self._event.set()
def cancel(self):
self.timer.cancel()
self._event.set()
def _wait(self):
self._event.wait()
try:
raise self._queue.get_nowait()
except queue.Empty:
pass
def listen(addr, family=socket.AF_INET, backlog=50, reuse_addr=True,
reuse_port=None):
"""
Largely inspired by:
https://github.com/eventlet/eventlet/../eventlet/convenience.py
"""
sock = socket.socket(family, socket.SOCK_STREAM)
if reuse_addr and sys.platform[:3] != 'win':
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
elif reuse_port is None:
reuse_port = True
if reuse_port and hasattr(socket, 'SO_REUSEPORT'):
try:
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEPORT, 1)
except Exception:
# Not supported by the platform
pass
sock.bind(addr)
sock.listen(backlog)
return sock
else:
raise NotImplementedError(
"Invalid OSKEN_HUB_TYPE. Expected one of ('eventlet', 'native').")