an_listen - listen for incoming connections on a proxy-capable socket
#include <antinat.h>
The an_listen(3) function is used to wait for an incoming connection on a socket that was created earlier and switched into bound mode using the an_bind_tohostname(3) or an_bind_tosockaddr(3) calls. For proxy-based connections, only one incoming connection is allowed on any listening socket. Accepting a connection will use the primary socket for communication and will not create any other socket.
s is a socket previously created with an_new_connection(3), and bound with the an_bind_tohostname(3) or an_bind_tosockaddr(3) calls.
Although there is planned support for non-blocking sockets in a future release, this call should be considered a blocking call. A non-blocking socket will be silently (and temporarily) changed to a blocking one to process the connection.
This call returns AN_ERROR_SUCCESS to indicate successful completion.
an_accept(3), an_bind_tohostname(3), an_bind_tosockaddr(3), an_new_connection(3)
Malcolm Smith <malxau@users.sourceforge.net>