roar_socket_listen(3) [debian man page]

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

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

RoarAudio							     May 2011						     roar_socket_listen(3)

muroard(1)						   System User's Manual: muroard						muroard(1)

NAME

       muroard - minimalist sound server for the RoarAudio protocol

SYNOPSIS

       muroard [OPTIONS]...

DESCRIPTION

       muRoarD	is  a  sound  server supporting the RoarAudio protocol.  It is designed to mix the audio data of multiple applications together to
       send it as a single stream to the soundcard.

       muRoarD is a minimalist version of such a sound server.	It does only implement the very minimum part the the protocol  but  is	very  much
       smaller than the original roard.

MISC OPTIONS

       -h --help
	      Print a short help and exit.

       --version
	      Print version information of the daemon and exit.

       --daemon
	      Bring the server into background after init.

	      On win32 this hides the console window. This only works if used within a Shortcut.

       --autostandby
	      Start in autostandby mode.

       --no-autostandby
	      Do not start in autostandby mode.

       --standby
	      Start in standby mode.

       --no-standby
	      Do not start in standby mode.

AUDIO OPTIONS

       -R  --rate   RATE
	      Set server sample rate.

       -C  --chans  CHANNELS
	      Set server number of channels channels.

DRIVER OPTIONS

       -O  --odevice DEV
	      Set output device (sound card).  The possible values of this depend on the used driver.

SOURCES OPTIONS

       -S DEV Set the file or device for the new source.

       -sC CHANS
	      Sets the number of channels for the source. This is the same as '-sO channels=XXX' for roard.

       -sB BITS
	      Sets the number of bits for the source. This is the same as '-sO bits=XXX' for roard.

       -sE CODEC
	      Sets codec for the source. This is the same as '-sO codec=XXX' for roard.

NETWORK OPTIONS

       --no-listen
	      Disable listen socket.  This may be used for example to implement the server type '+fork' but is absolutly useless for normal users.

       --client-fh FH
	      Add a client via FH.  See --no-listen.

       --bind ADDR
	      Set path/hostname of listen socket.  This may be a /path/to/sock for UNIX Sockets or a hostname or address for TCP/IP.

	      Please do not use IP Addresses directly if not needed.  Use hostnames.

	      On win32 there is no support for UNIX sockets. Only IP is supported.

       --port PORT
	      Set port of listen socket.  This only applys for TCP/IP sockets and is ignorged for UNIX Sockets.

       -u  --unix
	      Use UNIX Domain listen socket.

	      This is not supported on win32.

       -t  --tcp
	      Use TCP/IP listen socket.

       -n  --decnet
	      Use DECnet listen socket.

SEE ALSO

       muroarstream(1), RoarAudio(7).

HISTORY

       The  first  offical  version  of  muRoarD  (0.1beta0)  was  released on Wed Mar 03 2010 24:26 CET. For more information please see the file
       ChangeLog.

RoarAudio							    March 2010								muroard(1)