connection object

For all connection methods that take a timeout argument, a value of -1 is indefinite, meaning that the command runs to completion.


\begin{datadesc}{callback}
If this member is set to a value other than \code{Non...
... are advised against using asynchronous
calls for the time being.
\end{datadesc}


\begin{funcdesc}{Open}{timeout}
Open an outgoing connection, waiting at most \var{timeout} seconds for
the connection to be established.
\end{funcdesc}


\begin{funcdesc}{Listen}{timeout}
Wait for an incoming connection. Stop waiting ...
...var{timeout}
seconds. This call is only meaningful to some tools.
\end{funcdesc}


\begin{funcdesc}{accept}{yesno}
Accept (when \var{yesno} is non-zero) or reject an incoming call after
\var{Listen} returned.
\end{funcdesc}


\begin{funcdesc}{Close}{timeout\, now}
Close a connection. When \var{now} is zer...
... \var{now} is non-zero the close is
immediate, discarding output.
\end{funcdesc}


\begin{funcdesc}{Read}{len\, chan\, timeout}
Read \var{len} bytes, or until \var...
...}). Return a 2-tuple:\ the data read and the end-of-message
flag.
\end{funcdesc}


\begin{funcdesc}{Write}{buf\, chan\, timeout\, eom}
Write \var{buf} to channel \...
...munication tool). The method returns
the number of bytes written.
\end{funcdesc}


\begin{funcdesc}{Status}{}
Return connection status as the 2-tuple \code{(\var{s...
...r{flags} is a set of bits describing the state
of the connection.
\end{funcdesc}


\begin{funcdesc}{GetConfig}{}
Return the configuration string of the communicati...
...rings are tool-dependent, but usually easily parsed
and modified.
\end{funcdesc}


\begin{funcdesc}{SetConfig}{str}
Set the configuration string for the tool. The ...
... tool before it
encountered an error (or completed successfully).
\end{funcdesc}


\begin{funcdesc}{Choose}{}
Present the user with a dialog to choose a communicat...
...rn value (one of the \var{choose*} constants) will
indicate this.
\end{funcdesc}


\begin{funcdesc}{Idle}{}
Give the tool a chance to use the processor. You should call this
method regularly.
\end{funcdesc}


\begin{funcdesc}{Abort}{}
Abort an outstanding asynchronous \var{Open} or \var{Listen}.
\end{funcdesc}


\begin{funcdesc}{Reset}{}
Reset a connection. Exact meaning depends on the tool.
\end{funcdesc}


\begin{funcdesc}{Break}{length}
Send a break. Whether this means anything, what ...
...retation of the \var{length} parameter depend on the tool in
use.
\end{funcdesc}