roar_simple_connect(3)

NAME

roar_simple_connect - Opens a connection to RoarAudio's sound server

SYNOPSIS

#include <roaraudio.h>

int  roar_simple_connect  (struct roar_connection * con, char * server,
char * name);

DESCRIPTION

This call opens a connection to the RoarAudio's sound server. This is useful for controlling the server or update meta data of any kind. For simple playback see roar_simple_play(3). 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 with

out any paths or filenames.

RETURN VALUE

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

EXAMPLES

FIXME

SEE ALSO

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

RoarAudio July 2008 roar_simple_connect(3)