AuOpenServer (3)

Leading comments

$NCDId: @(#)AuOpSer.man,v 1.1 1994/09/27 00:33:32 greg Exp $
copyright 1994 Steven King

portions are
* Copyright 1993 Network Computing Devices, Inc.
*
* Permission to use, copy, modify, distribute, and sell this software and its
* documentation for any purpose is hereby granted without fee, provided that
* the above copyright notice appear in all copies and that both that
* copyright notice and this permission notice appear in supporting
* documentation, and that the name Network Computing ...

(The comments found at the beginning of the groff file "man3/AuOpenServer.3nas".)

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