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
SEE ALSO¶
accept(2),
libroar(7),
RoarAudio(7).