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