roar_socket_listen(3)
NAME
roar_socket_listen - Opens a new listen socket
SYNOPSIS
#include <roaraudio.h> int roar_socket_listen(int type, char * host, int port);
DESCRIPTION
Opens a new listening socket for network clients to connect to. You
may accept new connections via accept(2).
PARAMETERS
type The type of the Socket. See the list below.
- host The host or path name to listen on. This depends on the type
- argument. For TCP/IP to listen on any interface use a value of "0.0.0.0".
- port The port number to listen on. This may be ignored by types not
- supporting port numbers.
SOCKET TYPES
- ROAR_SOCKET_TYPE_UNKNOWN
- The type will be auto detected. Don't use this if you know the type. Only use this to support user given addresses and enable auto detection.
- ROAR_SOCKET_TYPE_TCP
- Use a TCP/IP connection. This is standard mode for networking. host is the hostname or IP to listen on and port is the port number to use.
- ROAR_SOCKET_TYPE_INET
- Same as above but deprecated. Use ROAR_SOCKET_TYPE_TCP.
- ROAR_SOCKET_TYPE_UNIX
- UNIX Domain Socket. This should be default for local connections. host is the filename of the socket.
- ROAR_SOCKET_TYPE_DECNET
- DECnet socket.
- ROAR_SOCKET_TYPE_FORK
- This is to fork a roard to communicate with. Can't be use to listen on, just to connect to. host and port is ignored at the moment.
- ROAR_SOCKET_TYPE_FILE
- This is used to open a plain file. Can't be use to listen on, just to connect to. host is the filename to connect to.
RETURN VALUE
On success these calls return filehandle. On error, -1 is returned.
BUGS
Listening on UDP sockets is not supported at the moment.
EXAMPLES
FIXME