.\"accept a connection on a socket .DT socket_accept $MUDNAME$ driver help socket_accept .SH Name .SI 5 socket_accept() - accept a connection on a socket .EI .SH Synopsis .SI 5 #include <socket_errors.h> int socket_accept( int s, string | function read_callback, string | function write_callback ); .EI .SH Description .SP 5 5 The argument `s' is a socket that has been created with socket_create(), bound to an address with socket_bind(), and is listening for connections after a socket_listen(). socket_accept() extracts the first connection on the queue of pending connections, creates a new socket with the same properties of `s' and allocates a new file descriptor for the socket. If no pending connections are present on the queue, socket_accept() returns an error as described below. The accepted socket is used to read and write data to and from the socket which connected to this one; it is not used to accept more connections. The original socket `s' remains open for accepting further connections. The argument `read_callback' is the function or name of a function for the driver to call when the new socket (not the accepting socket) receives data. The read callback should follow this format: .EP .SI 5 void read_callback( int fd ) Where fd is the socket which is ready to accept data. .EI .SP 5 5 The argument `write_callback' is the function or name of a function for the driver to call when the new socket (not the accepting socket) is ready to be written to. The write callback should follow this format: .EP .SI 5 void write_callback( int fd ) Where fd is the socket which is ready to be written to. .EI .SP 5 5 Note: The `close_callback' of the accepting socket (not the new socket) is called if the new socket closes unexpectedly, i.e. not as the result of a socket_close() call. The close callback should follow this format: .EP .SI 5 void close_callback( int fd ) Where fd is the socket which has closed. .EI .SP 5 5 socket_accept() returns a non-negative descriptor for the accepted socket on success. On failure, it returns a negative value. socket_error() can be used on the return value to get a text description of the error. .EP .SH Errors .SI 5 These definitions are in <socket_errors.h>: .EI .SO 10 15 45 EEFDRANGE Descriptor out of range. EEBADF Descriptor is invalid. EESECURITY Security violation attempted. EEMODENOTSUPP Socket mode not supported. EENOTLISTN Socket not listening. EEWOULDBLOCK Operation would block. EEINTR Interrupted system call. EEACCEPT Problem with accept. EENOSOCKS No more available efun sockets. .EO .SH See also .SI 5 socket_bind(), socket_connect(), socket_create(), socket_listen() .EI
