Various asynchronous TCP/IP classes.
End users shouldn't use this module directly - use the reactor APIs instead.
| Variable | EPERM | Undocumented |
| Variable | ENFILE | Undocumented |
| Variable | ENOMEM | Undocumented |
| Class | Connection | Superclass of all socket-based FileDescriptors. |
| Class | BaseClient | A base class for client TCP (and similar) sockets. |
| Class | Client | A transport for a TCP protocol; either TCPv4 or TCPv6. |
| Class | Server | Serverside socket-stream connection class. |
| Class | Port | A TCP server port, listening for connections. |
| Class | Connector | A Connector provides of twisted.internet.interfaces.IConnector for all POSIX-style reactors. |
| Class | _TLSConnectionMixin | Undocumented |
| Class | _TLSClientMixin | Undocumented |
| Class | _TLSServerMixin | Undocumented |
| Variable | _AI_NUMERICSERV | Undocumented |
| Function | _getrealname | No summary |
| Function | _getpeername | See _getrealname. |
| Function | _getsockname | See _getrealname. |
| Class | _SocketCloser | |
| Class | _AbortingMixin | Common implementation of abortConnection. |
| Class | _BaseBaseClient | Code shared with other (non-POSIX) reactors for management of general outgoing connections. |
| Variable | _NUMERIC_ONLY | Undocumented |
| Function | _resolveIPv6 | Resolve an IPv6 literal into an IPv6 address. |
| Class | _BaseTCPClient | Code shared with other (non-POSIX) reactors for management of outgoing TCP connections (both TCPv4 and TCPv6). |
| Interface | _IFileDescriptorReservation | No summary |
| Class | _FileDescriptorReservation | _IFileDescriptorReservation implementation. |
| Class | _NullFileDescriptorReservation | A null implementation of _IFileDescriptorReservation. |
| Variable | _reservedFD | Undocumented |
| Variable | _ACCEPT_ERRORS | Undocumented |
| Class | _BuffersLogs | A context manager that buffers any log events until after its block exits. |
| Function | _accept | Return a generator that yields client sockets from the provided listening socket until there are none left or an unrecoverable error occurs. |
Return a 2-tuple of socket IP and port for IPv4 and a 4-tuple of socket IP, port, flowInfo, and scopeID for IPv6. For IPv6, it returns the interface portion (the part after the %) as a part of the IPv6 address, which Python 3.7+ does not include.
| Parameters | addr | A 2-tuple for IPv4 information or a 4-tuple for IPv6 information. |
Resolve an IPv6 literal into an IPv6 address.
This is necessary to resolve any embedded scope identifiers to the relevant sin6_scope_id for use with socket.connect(), socket.listen(), or socket.bind(); see RFC 3493 for more information.
| Parameters | ip | An IPv6 address literal. (type: str) |
| port | A port number. (type: int) | |
| Returns | a 4-tuple of (host, port, flow, scope), suitable for use as an IPv6 address. | |
| Raises | socket.gaierror | if either the IP or port is not numeric as it should be. |
Return a generator that yields client sockets from the provided listening socket until there are none left or an unrecoverable error occurs.
| Parameters | logger | A logger to which accept-related events will be logged. This should not log to arbitrary observers that might open a file descriptor to avoid claiming the EMFILE file descriptor on UNIX-like systems. (type: Logger) |
| accepts | An iterable iterated over to limit the number consecutive accepts. (type: An iterable.) | |
| listener | The listening socket. (type: socket.socket) | |
| reservedFD | A reserved file descriptor that can be used to recover from EMFILE on UNIX-like systems. (type: _IFileDescriptorReservation) | |
| Returns | A generator that yields (socket, addr) tuples from socket.socket.accept | |