table of contents
other versions
roar_socket_listen(3) | System Manager's Manual: RoarAudio | 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¶
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).
May 2011 | RoarAudio |