roar_exit(3) [debian man page]

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

NAME

       roar_exit - let RoarAudio's sound server quit

       roar_terminate - let RoarAudio's sound server quit as soon as all clients quit

SYNOPSIS

       #include <roaraudio.h>

       int roar_exit(struct roar_connection * con);

       int roar_terminate(struct roar_connection * con, int terminate);

DESCRIPTION

       Ask the sound server to quit.

       roar_exit() let the server quit without waiting for any clients.  All streams and client connections will be closed cleanly.

       roar_terminate()  will  let  the  server  quit as soon as all clients disconnects and all input streams ended. The listening socket will be
       closed. This is useful in case of restarting roard.

PARAMETERS

       con    An open controll connection to the server.

       terminate
	      Wait for all clients to disconnect and all streams to EOF in case of 1.  In case of 0 roar_terminate() is equal to roar_exit().

RETURN VALUE

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

NOTES

       Even when the call was successfull you have to use roar_disconnect(3) to disconnect from the server.

EXAMPLES

       FIXME

SEE ALSO

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

RoarAudio							     May 2011							      roar_exit(3)

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

NAME

       roar_connect, roar_connect2 - connects to RoarAudio's sound server

SYNOPSIS

       #include <roaraudio.h>

       int  roar_connect(struct  roar_connection  *  con,  char * server); int roar_connect2	 (struct roar_connection * con, char * server, int
       flags, uint_least32_t timeout);

DESCRIPTION

       Connects to RoarAudio's sound server.  This calls just connects to the sound server without any authentication or  identify.   Do  not  use
       this from end user applications. Use roar_simple_connect(3) or roar_simple_connect2(3).

PARAMETERS

       con    The connection object to be filled with the data needed to talk to the server used by nearly all other calls.

       server The server to connect to.

       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

       See libroar/simple.c, roar_simple_connect(3).

SEE ALSO

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

RoarAudio							     May 2011							   roar_connect(3)