| Server IP : 153.92.12.67 / Your IP : 216.73.216.122 Web Server : LiteSpeed System : Linux id-dci-web1986.main-hosting.eu 5.14.0-611.26.1.el9_7.x86_64 #1 SMP PREEMPT_DYNAMIC Thu Jan 29 05:24:47 EST 2026 x86_64 User : u686484674 ( 686484674) PHP Version : 8.0.30 Disable Function : system, exec, shell_exec, passthru, mysql_list_dbs, ini_alter, dl, symlink, link, chgrp, leak, popen, apache_child_terminate, virtual, mb_send_mail MySQL : OFF | cURL : ON | WGET : ON | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : /proc/self/root/opt/./alt/python311/lib/python3.11/site-packages/pyroute2/dhcp/ |
Upload File : |
'''DHCP client state machine helpers.'''
import functools
from enum import IntEnum, auto
from logging import getLogger
from typing import Any, Callable, Final, Protocol
LOG = getLogger(__name__)
class State(IntEnum):
'''DHCP client states.
see
http://www.tcpipguide.com/free/t_DHCPGeneralOperationandClientFiniteStateMachine.htm
'''
OFF = 0
INIT = auto()
INIT_REBOOT = auto()
REBOOTING = auto()
REQUESTING = auto()
SELECTING = auto()
BOUND = auto()
RENEWING = auto()
REBINDING = auto()
# allowed transitions between states
TRANSITIONS: Final[dict[State, set[State]]] = {
State.OFF: {State.INIT, State.INIT_REBOOT},
State.INIT_REBOOT: {State.REBOOTING},
State.REBOOTING: {State.INIT, State.BOUND},
State.INIT: {State.SELECTING},
State.SELECTING: {State.REQUESTING, State.INIT},
State.REQUESTING: {State.BOUND, State.INIT},
State.BOUND: {State.INIT, State.RENEWING, State.REBINDING},
State.RENEWING: {State.BOUND, State.INIT, State.REBINDING},
State.REBINDING: {State.BOUND, State.INIT},
}
class AsyncCallback(Protocol):
__name__: str
async def __call__(self, *a, **kwds: Any) -> Any:
'''Protocol for async methods that makes mypy happy.'''
def state_guard(*states: State) -> Callable[[AsyncCallback], AsyncCallback]:
'''Decorator that prevents a method from running
if the associated instance is not in one of the given States.'''
def decorator(meth: AsyncCallback) -> AsyncCallback:
@functools.wraps(meth)
async def wrapper(self, *args: Any, **kwargs: Any) -> None:
if self.state not in states:
LOG.debug(
'Ignoring call to %r in %s state',
meth.__name__,
self.state.name,
)
return
await meth(self, *args, **kwargs)
return wrapper
return decorator