AuOpenServer

AuOpenServer(3)            Library Functions Manual            AuOpenServer(3)



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



audiolib - housekeeping              1.4.1                     AuOpenServer(3)