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