This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

Rlisten()

Listen for connections on a socket (via a SOCKS server)

Synopsis:

#include <sys/socket.h>

int Rlisten( int s, 
             int backlog );

Arguments:

s

The descriptor for the socket that you want to listen on. You can create a socket by calling socket().

backlog

The maximum length that the queue of pending connections may grow to.

Library:

libsocks

Use the -l socks option to qcc to link against this library.

Description:

The Rlisten() function is a cover function for listen() -- the difference is that Rlisten() does its job via a SOCKS server.

For more information about SOCKS and its libraries, see the appendix, SOCKS -- A Basic Firewall.

Returns:

0

Success.

-1

An error occurred (errno is set).

Classification:

SOCKS

See also:

listen() Raccept(), Rbind(), Rconnect(), Rgetsockname(), Rrcmd(), Rselect(), SOCKSinit()

SOCKS -- A Basic Firewall