muroar_connect(3) [debian man page]

muroar_connect(3)					    muRoar Programmer's Manual						 muroar_connect(3)

NAME

       muroar_connect - Opens a connection to a RoarAudio sound daemon

SYNOPSIS

       #include <muroar.h>

       muroar_t muroar_connect(const char * server, const char * name);

DESCRIPTION

       This function opens a connection to sound server supporting the RoarAudio protocol.

PARAMETERS

       server The address of the server to connect to.	May be set to NULL to connect to the default server.

       name   The  name  for  the  application.  Should be set to some a string the user will recognize.  For example use "OpenOffice Impress" not
	      "soffice.bin" (process name).  This can be set to NULL to use a generaic default string. However it is strongly recommented  to  set
	      this to some useful string.

RETURN VALUE

       On success this call returns a file handle to a open connection.  On error, MUROAR_HANDLE_INVALID is returned.

BUGS

       This function does currently not support DECnet (UNIX Sockets and IPv4 is supported).

HISTORY

       This function first appeared in muRoar version 0.1beta0.

SEE ALSO

       muroar_connect(3), muroar_quit(3), RoarAudio(7).

muRoar								    April 2012							 muroar_connect(3)

roar_simple_connect(3)					System Manager's Manual: RoarAudio				    roar_simple_connect(3)

NAME

       roar_simple_connect, roar_simple_connect2 - Opens a connection to RoarAudio's sound server

SYNOPSIS

       #include <roaraudio.h>

       int  roar_simple_connect (struct roar_connection * con, char * server, char * name); int roar_simple_connect2(struct roar_connection * con,
       char * server, char * name, int flags, uint_least32_t timeout);

DESCRIPTION

       This calls opens a connection to the RoarAudio's sound server.  To disconnect use roar_disconnect(3).

PARAMETERS

       con    The roar_connection object to be filled on success with all data needed for comunicating with the server.  This is  used	by  nearly
	      all other functions.

       server The host or filename of the socket of the server. Should normaly be NULL to try default locations.

       name   The name of this client. Should be the name of the player without any paths or filenames.

       flags  Flags   used   to   connect   to	 the  server.  Currently  only	ROAR_ENUM_FLAG_NONE  and  ROAR_ENUM_FLAG_NONBLOCK  are	supported.
	      ROAR_ENUM_FLAG_NONBLOCK disables some of the server location features.

       timeout
	      Timeout for the connection. A value of zero means no timeout. Currently timeouts are not supported.

RETURN VALUE

       On success these calls return 0.  On error, -1 is returned.

EXAMPLES

       FIXME

SEE ALSO

       roar_disconnect(3), libroar(7), RoarAudio(7).

RoarAudio							     May 2011						    roar_simple_connect(3)