debian man page for roar_vs_new_from_con

Query: roar_vs_new_from_con

OS: debian

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

roar_vs_new(3)						   RoarAudio Programmer's Manual					    roar_vs_new(3)

NAME
roar_vs_stream, roar_vs_new_from_con - Create new VS objects
SYNOPSIS
#include <roaraudio.h> roar_vs_t * roar_vs_new(const char * server, const char * name, int * error); roar_vs_t * roar_vs_new_from_con(struct roar_connection * con, int * error);
DESCRIPTION
These calls are used to create new VS objects without a yet connected data connection. They are only helpful if there you want to share a control connection between multiple streams (generally recommended if using multiple streams to the same server) or need to use some extended parts of the VS API. If you look for a easy way to open a stream see roar_vs_new_simple(3) and roar_vs_new_from_file(3). roar_vs_new() opens a new control connection to server server. name is used as application name. roar_vs_new_from_con() creates a new VS object from the extsing control connection con. VS objects created via roar_vs_new_from_con() will not close the control connection on roar_vs_close(3).
PARAMETERS
server The server to connect to. NULL for defaults. name The application name. This should be something the user can use to identify the application. It MUST NOT be the application's binary name or the value of argv[0]. con The already existing and open control connection to use. error This is a pointer to a integer used to store the error value in case of error. This can be NULL if not used but it is very recom- mended to use this error value to report good error messages to the user.
RETURN VALUE
On success these calls return a new VS object. On error, NULL is returned.
EXAMPLES
FIXME
SEE ALSO
roar_vs_new_simple(3), roar_vs_new_from_file(3), roar_vs_close(3), roarvs(7), libroar(7), RoarAudio(7). RoarAudio June 2011 roar_vs_new(3)
Related Man Pages
roar_simple_play(3) - debian
roar_simple_stream(3) - debian
roar_vs_new_from_con(3) - debian
roar_vs_new_simple(3) - debian
roar_vs_volume_stereo(3) - debian
Similar Topics in the Unix Linux Community
Local system IP address in UNIX
Assign NULL to stream objects
Troubleshooting &quot;A connection failure has occurred&quot;, &quot;The specified server could not be found&quot; or si
FTP error