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).