Skip to content

exceptions

RadiusException

Bases: Exception

Base class for all exceptions raised by pyrad2.

Source code in pyrad2/exceptions.py 
1
2
3
4
class RadiusException(Exception):
    """Base class for all exceptions raised by pyrad2."""

    pass

ServerPacketError

Bases: RadiusException

Exception class for bogus packets. ServerPacketError exceptions are only used inside the Server class to abort processing of a packet.

Source code in pyrad2/exceptions.py 
 7
 8
 9
10
11
12
13
class ServerPacketError(RadiusException):
    """Exception class for bogus packets.
    ServerPacketError exceptions are only used inside the Server class to
    abort processing of a packet.
    """

    pass

Timeout

Bases: RadiusException

Simple exception class which is raised when a timeout occurs while waiting for a RADIUS server to respond.

Source code in pyrad2/exceptions.py 
16
17
18
19
20
class Timeout(RadiusException):
    """Simple exception class which is raised when a timeout occurs
    while waiting for a RADIUS server to respond."""

    pass

PacketError

Bases: RadiusException

Raised when the packet is invalid.

Source code in pyrad2/exceptions.py 
23
24
25
26
class PacketError(RadiusException):
    """Raised when the packet is invalid."""

    pass

IdentifierExhausted

Bases: RadiusException

All 256 RADIUS Identifier slots on a single (source IP, port) flow are currently in flight.

RFC 2865 §3 caps the Identifier field at one octet. Callers that hit this need to either wait for an in-flight request to complete, open a second source port to get a fresh 256-id space, or queue.

Source code in pyrad2/exceptions.py 
29
30
31
32
33
34
35
36
37
38
class IdentifierExhausted(RadiusException):
    """All 256 RADIUS Identifier slots on a single (source IP, port) flow
    are currently in flight.

    RFC 2865 §3 caps the Identifier field at one octet. Callers that hit
    this need to either wait for an in-flight request to complete, open
    a second source port to get a fresh 256-id space, or queue.
    """

    pass

ParseError

Bases: RadiusException

Exception raised for errors while parsing RADIUS dictionary files.

Attributes:

Name Type Description
msg str

Error message.
file str

Dictionary file the error originated in, if known.
line int

Line number, or -1 if not known.
Source code in pyrad2/exceptions.py 
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
class ParseError(RadiusException):
    """Exception raised for errors while parsing RADIUS dictionary files.

    Attributes:
        msg (str): Error message.
        file (str): Dictionary file the error originated in, if known.
        line (int): Line number, or ``-1`` if not known.
    """

    def __init__(
        self,
        msg: str | None = None,
        *,
        file: str = "",
        line: int = -1,
    ) -> None:
        self.msg = msg
        self.file = file
        self.line = line

    def __str__(self) -> str:
        out = ""
        if self.file:
            out += self.file
        if self.line > -1:
            out += "(%d)" % self.line
        if self.file or self.line > -1:
            out += ": "
        out += "Parse error"
        if self.msg:
            out += ": %s" % self.msg
        return out