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