Content-type: text/html Man page of roar_simple_connect

roar_simple_connect

Section: System Manager's Manual: RoarAudio (3)
Updated: May 2011
Index Return to Main Contents

 

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
PARAMETERS
RETURN VALUE
EXAMPLES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 10:45:11 GMT, October 16, 2011