NAME

muroar_connect - Opens a connection to a RoarAudio sound daemon

SYNOPSIS

#include <muroar.h>

muroar_t muroar_connect(const char * server, const char * name);

DESCRIPTION

This function opens a connection to sound server supporting the RoarAudio protocol.

PARAMETERS

server

The address of the server to connect to. May be set to NULL to connect to the default server.

name

The name for the application. Should be set to some a string the user will recognize. For example use "OpenOffice Impress" not "soffice.bin" (process name). This can be set to NULL to use a generaic default string. However it is strongly recommended to set this to some useful string.

RETURN VALUE

On success this call returns a file handle to a open connection. On error, MUROAR_HANDLE_INVALID is returned.

BUGS

This function does currently not support DECnet (UNIX Sockets and IPv4 is supported).

HISTORY

This function first appeared in muRoar version 0.1beta0.

SEE ALSO

muroar_connect(3), muroar_quit(3), RoarAudio(7).