roar_connect(3) connects to RoarAudio's sound server

Other Alias

roar_connect2

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