NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO
$(OS_DIR)/lib/libtelnetd.a #include <arpa/telnetd.h>int inetBind(inetSocket * sockets, int count);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
The inetBind() function creates one stream socket and binds it to every IP port that the server will listen on.
The sockets parameter is an array of count inetSocket data structures. Each inetSocket structure has the following members:
int port ; /* IP port */ int socket ; /* socket bound to the port */
port must be a valid IP port number and socket must be initialized to TD_INVALID_SOCKET . On successful return from the call, socket will hold the file descriptor of the new socket bound to the IP port.
The inetClose() function closes all sockets which were created by inetBind() . It does not close sockets returned by inetAccept() and does not release any memory allocated by telnetdInit for a new TELNET session; this must be done explicitly by closing the socket and calling telnetdFree on active TELNET sessions.
On successful completion, these functions return a value of zero. Otherwise they return -1 and set errno to indicate the error.
errno is set to EINVAL if one of the socket members of the inetSocket data structures passed to inetBind() is not initialized to TD_INVALID_SOCKET .
The inetBind() function may also fail and set errno to any of the errors specified for the socket(2POSIX) , and bind(2POSIX) functions.
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES | SEE ALSO