class documentation

class Client(_SendmsgMixin, tcp.BaseClient): (source)

Implements interfaces: twisted.internet.interfaces.IUNIXTransport

View In Hierarchy

A client for Unix sockets.
Method __init__
Method get​Host Similar to getPeer, but returns an address describing this side of the connection.
Method get​Peer Get the remote address of this connection.
Instance Variable addr Undocumented
Instance Variable connector Undocumented
Instance Variable real​Address Undocumented

Inherited from _SendmsgMixin:

Method do​Read Calls {IProtocol.dataReceived} with all available data and IFileDescriptorReceiver.fileDescriptorReceived once for each received file descriptor in ancillary data.
Method send​File​Descriptor Queue the given file descriptor to be sent and start trying to send it.
Method write​Some​Data Send as much of data as possible. Also send any pending file descriptors.
Method _ancillary​Level​SOLSOCKETType​SCMRIGHTS Processes ancillary data with level SOL_SOCKET and type SCM_RIGHTS, indicating that the ancillary data payload holds file descriptors.
Method _is​Send​Buffer​Full Determine whether the user-space send buffer for this transport is full or not.
Instance Variable _file​Descriptor​Buffer​Size An int giving the maximum number of file descriptors to accept and queue for sending before pausing the registered producer, if there is one.
Instance Variable _sendmsg​Queue A list of int holding file descriptors which are currently buffered before being sent.
Instance Variable _write​Some​Data​Base The class which provides the basic implementation of writeSomeData. Ultimately this should be a subclass of twisted.internet.abstract.FileDescriptor. Subclasses which mix in _SendmsgMixin must define this.

Inherited from BaseClient:

Method create​Internet​Socket (internal) Create a non-blocking socket using self.addressFamily, self.socketType.
Method do​Connect Initiate the outgoing connection attempt.
Instance Variable connected Undocumented
Instance Variable logstr Undocumented
Instance Variable protocol Undocumented
Method _collect​Socket​Details Clean up references to the socket and its file descriptor.
Method _connect​Done This is a hook for when a connection attempt has succeeded.
Method _stop​Reading​And​Writing Implement the POSIX-ish (i.e. twisted.internet.interfaces.IReactorFDSet) method of detaching this socket from the reactor for _BaseBaseClient.
Instance Variable _base Connection, which is the base class of this class which has all of the useful file descriptor methods. This is used by _TLSServerMixin to call the right methods to directly manipulate the transport, as is necessary for writing TLS-encrypted bytes (whereas those methods on Server will go through another layer of TLS if it has been enabled).

Inherited from _BaseBaseClient (via BaseClient):

Method connection​Lost No summary
Method fail​If​Not​Connected Generic method called when the attempts to connect failed. It basically cleans everything it can: call connectionFailed, stop read and write, delete socket related members.
Method resolve​Address No summary
Method stop​Connecting If a connection attempt is still outstanding (i.e. no connection is yet established), immediately stop attempting to connect.
Instance Variable address​Family The address family constant (socket.AF_INET, socket.AF_INET6, socket.AF_UNIX) of the underlying socket of this client connection.
Instance Variable reactor The class pointed to by _commonConnection should set this attribute in its constructor.
Instance Variable socket​Type The socket type constant (socket.SOCK_STREAM or socket.SOCK_DGRAM) of the underlying socket.
Method _finish​Init Called by subclasses to continue to the stage of initialization where the socket connect attempt is made.
Method _set​Real​Address Set the resolved address of this _BaseBaseClient and initiate the connection attempt.
Class Variable _common​Connection Subclasses must provide this attribute, which indicates the Connection-alike class to invoke __init__ and connectionLost on.
Instance Variable _close​Socket Subclasses must implement in order to close the socket in response to a terminated connection attempt.
Instance Variable _requires​Resolution A flag indicating whether the address of this client will require name resolution. True if the hostname of said address indicates a name that must be resolved by hostname lookup, False if it indicates an IP address literal.

Inherited from Connection (via BaseClient):

Method connection​Lost See abstract.FileDescriptor.connectionLost().
Method do​Read Calls self.protocol.dataReceived with all available data.
Method get​Handle Return the socket for this connection.
Method get​Tcp​Keep​Alive Return if SO_KEEPALIVE is enabled.
Method get​Tcp​No​Delay Return if TCP_NODELAY is enabled.
Method log​Prefix Return the prefix to log with when I own the logging thread.
Method read​Connection​Lost Indicates read connection was lost.
Method set​Tcp​Keep​Alive Enable/disable SO_KEEPALIVE.
Method set​Tcp​No​Delay Enable/disable TCP_NODELAY.
Method write​Some​Data Write as much as possible of the given data to this TCP connection.
Instance Variable socket Undocumented
Method _close​Write​Connection Undocumented
Method _data​Received Undocumented

Inherited from _TLSConnectionMixin (via BaseClient, Connection):

Constant TLS Undocumented

Inherited from FileDescriptor (via BaseClient, Connection):

Method do​Write Called when data can be written.
Method fileno File Descriptor number for select().
Method lose​Connection Close the connection at the next available opportunity.
Method lose​Write​Connection Undocumented
Method pause​Producing Pause producing data.
Method resume​Producing Resume producing data.
Method start​Reading Start waiting for read availability.
Method start​Writing Start waiting for write availability.
Method stop​Consuming Stop consuming data.
Method stop​Producing Stop producing data.
Method stop​Reading Stop waiting for read availability.
Method stop​Writing Stop waiting for write availability.
Method write Reliably write some data.
Method write​Connection​Lost Indicates write connection was lost.
Method write​Sequence Reliably write a sequence of data.
Constant SEND​_LIMIT Undocumented
Class Variable buffer​Size Undocumented
Class Variable disconnecting Undocumented
Instance Variable data​Buffer Undocumented
Instance Variable disconnected Undocumented
Instance Variable offset Undocumented
Instance Variable producer Undocumented
Instance Variable producer​Paused Undocumented
Instance Variable reactor Undocumented
Method _is​Send​Buffer​Full Determine whether the user-space send buffer for this transport is full or not.
Method _maybe​Pause​Producer Possibly pause a producer, if there is one and the send buffer is full.
Method _post​Lose​Connection Called after a loseConnection(), when all data has been written.
Class Variable _write​Disconnected Undocumented
Instance Variable _temp​Data​Buffer Undocumented
Instance Variable _temp​Data​Len Undocumented
Instance Variable _write​Disconnecting Undocumented

Inherited from _ConsumerMixin (via BaseClient, Connection, FileDescriptor):

Method register​Producer Register to receive data from a producer.
Method unregister​Producer Stop consuming data from a producer, without disconnecting.
Instance Variable streaming​Producer bool or int

Inherited from _LogOwner (via BaseClient, Connection, FileDescriptor):

Method _get​Log​Prefix Determine the log prefix to use for messages related to applicationObject, which may or may not be an interfaces.ILoggingContext provider.

Inherited from _SocketCloser (via BaseClient, Connection):

Method _close​Socket Undocumented
Instance Variable _should​Shutdown Set to True if shutdown should be called before calling close on the underlying socket.

Inherited from _AbortingMixin (via BaseClient, Connection):

Method abort​Connection Aborts the connection immediately, dropping any buffered data.
Instance Variable do​Write Undocumented
Instance Variable _aborting Set to True when abortConnection is called.
def __init__(self, filename, connector, reactor=None, checkPID=0): (source)
Parameters
filenameUndocumented
connectorUndocumented
reactorAn IReactorFDSet provider which this descriptor will use to get readable and writeable event notifications. If no value is given, the global reactor will be used.
check​PIDUndocumented
def getHost(self): (source)
Similar to getPeer, but returns an address describing this side of the connection.
Returns
An IAddress provider.
def getPeer(self): (source)

Get the remote address of this connection.

Treat this method with caution. It is the unfortunate result of the CGI and Jabber standards, but should not be considered reliable for the usual host of reasons; port forwarding, proxying, firewalls, IP masquerading, etc.

Returns
An IAddress provider.
addr = (source)

Undocumented

connector = (source)

Undocumented