Name

       AuOpenServer - connect to audio server

Synopsis

       #include <audio/audiolib.h>

       AuServer   *AuOpenServer(servername,  num_authproto,  authproto,  num_authdata,  authdata,
       ret_status)
           char *servername;
           int num_authproto;
           char *authproto;
           int num_authdata;
           char *authdata;
           char **return_status; /* RETURN */

Arguments

       servername
                 Specifies the audio server name.  This determines the server and  communications
                 domain to be used.

       num_authproto
                 Specifies the length of the connection authorization protocol name.

       authproto Specifies the name of the connection authorization protocol.

       num_authdata
                 Specifies the length of the connection authorization data.

       authdata  Specifies the connection authorization data.

       return_status
                 If non-NULL, and the connection is refused, returns an error message.

Description

       AuOpenServer  creates  a connection to the specified audio server and returns a pointer to
       an AuServer structure or NULL, with return_status  (if  non-NULL)  pointing  to  an  error
       message describing the reason, if it was unsuccessfull.

       If servername is NULL or a pointer to NUL, AuOpenServer get the value from the enviroment.
       servername has the format  hostname:port  or  hostname::port.   If  a  double  colon  (::)
       separates  the hostname and port number, AuOpenServer connects using DECnet streams.  If a
       single colon (:) separates the hostname and port  number,  and  the  hostname  is  a  host
       machine  name,  AuOpenServer  connects using TCP streams.  If a single colon (:) separates
       the hostname and port number, and the hostname is "unix", AuOpenServer connects using UNIX
       domain sockets (or Streams).  If the hostname is not specified, AuOpenServer uses whatever
       it believes is the fastest transport.

See Also

       AuCloseServer, AuServerName.

       audiolib - Network Audio System C Language Interface