NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO
#include <arpa/telnetd.h>int telnetdInit(int connectionSocket, telnetdSessionHandle * hdl);
The telnetdInit function initializes a TELNET session for the connectionSocket socket obtained by inetAccept .
The hdl argument is a result parameter filled with the session handle of the new TELNET session. This handle must be used as an argument to other functions of the TELNETD library to designate the new TELNET session.
The telnetdInit function allocates memory to maintain the state of the TELNET session. It also sends TELNET options to the client side indicating the ability to do remote echo of characters, and to suppress go ahead . The state of the virtual terminal is configured to operate in line mode (see telnetdSetTermState (3TELD)). The new TELNET session can perform the following functions: echo , binary , suppress go ahead , and timing mark . It allows the remote client to perform the following functions: binary and suppress go ahead .
The telnetdFree function frees all memory allocated by telnetdInit for the TELNET session designated by its hdl handle. The TELNET connection socket associated with the TELNET session is not closed by telnetdFree .
Upon successful completion, these functions return a value of zero. Otherwise they return -1 and set errno to indicate the error.
The telnetdInit function may fail and set errno to any of the errors specified for the malloc (3STDC), read (2POSIX) and write (2POSIX) functions.
The errno file is set to EINVAL if telnetdFree is called with an invalid hdl handle.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
telnetdFree(3TELD) , telnetdPasswd(3TELD) , telnetdRead(3TELD) , telnetdUser(3TELD) , telnetdWrite(3TELD)
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO