NAME

       roar_connect, roar_connect2 - connects to RoarAudio's sound server

SYNOPSIS

       #include <roaraudio.h>

       int   roar_connect(struct  roar_connection  *  con,  char  *  server);  int  roar_connect2
       (struct roar_connection * con, char * server, int flags, uint_least32_t timeout);

DESCRIPTION

       Connects to RoarAudio's sound server.  This  calls  just  connects  to  the  sound  server
       without  any  authentication or identify.  Do not use this from end user applications. Use
       roar_simple_connect(3) or roar_simple_connect2(3).

PARAMETERS

       con    The connection object to be filled with the data needed to talk to the server  used
              by nearly all other calls.

       server The server to connect to.

       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

       See libroar/simple.c, roar_simple_connect(3).

SEE ALSO

       roar_simple_connect(3), libroar(7), RoarAudio(7).