bionic (3) roar_socket_listen.3.gz

Provided by: libroar-dev_1.0~beta11-10_amd64 bug

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