NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO
#include <arpa/telnetd.h>int telnetdWrite(telnetdSessionHandle * hdl, void * buf, unsigned int nchar);
The telnetdWrite function attempts to write nchar characters from the buffer pointed to by buf to the TELNET session designated by the hdl handle.
If the TELNET connection cannot accept data immediatly and the connection socket has O_NONBLOCK set, telnetdWrite returns -1 and sets errno to EAGAIN . Otherwise, telnetdWrite blocks until data can be accepted.
The O_NONBLOCK option may be set for the connection socket by calling fcntl (2POSIX) after the TELNET session has been initialized by telnetdInit .
The telnetdFlush function causes any buffered data waiting to be written for the TELNET session designated by the hdl handle to be written to the TELNET connection socket.
Upon successful completion, telnetdWrite returns the number of characters actually written; this number may be less than nchar . Upon successful completion, telnetdFlush returns 0. In case of failure, both functions return -1 and set errno to indicate the error.
errno is set to EINVAL if telnetdFlush or telnetdWrite is called with an invalid hdl handle.
The telnetdWrite and telnetdFlush functions may fail and set errno to any of the errors specified for the write (2POSIX) function.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO