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