1AuOpenServer(3)            Library Functions Manual            AuOpenServer(3)
2
3
4

Name

6       AuOpenServer - connect to audio server
7

Synopsis

9       #include <audio/audiolib.h>
10
11       AuServer  *AuOpenServer(servername, num_authproto, authproto, num_auth‐
12       data, authdata, ret_status)
13           char *servername;
14           int num_authproto;
15           char *authproto;
16           int num_authdata;
17           char *authdata;
18           char **return_status; /* RETURN */
19

Arguments

21       servername
22                 Specifies the audio server name.  This determines the  server
23                 and communications domain to be used.
24
25       num_authproto
26                 Specifies the length of the connection authorization protocol
27                 name.
28
29       authproto Specifies the name of the connection authorization protocol.
30
31       num_authdata
32                 Specifies the length of the connection authorization data.
33
34       authdata  Specifies the connection authorization data.
35
36       return_status
37                 If non-NULL, and the connection is refused, returns an  error
38                 message.
39

Description

41       AuOpenServer creates a connection to the specified audio server and re‐
42       turns a pointer to an AuServer structure or  NULL,  with  return_status
43       (if non-NULL) pointing to an error message describing the reason, if it
44       was unsuccessfull.
45
46       If servername is NULL or a pointer to NUL, AuOpenServer get  the  value
47       from  the enviroment.  servername has the format hostname:port or host‐
48       name::port.  If a double colon (::) separates  the  hostname  and  port
49       number,  AuOpenServer connects using DECnet streams.  If a single colon
50       (:) separates the hostname and port number, and the hostname is a  host
51       machine  name,  AuOpenServer  connects  using TCP streams.  If a single
52       colon (:) separates the hostname and port number, and the  hostname  is
53       "unix",  AuOpenServer  connects using UNIX domain sockets (or Streams).
54       If the hostname is not specified, AuOpenServer  uses  whatever  it  be‐
55       lieves is the fastest transport.
56

See Also

58       AuCloseServer, AuServerName.
59
60       audiolib - Network Audio System C Language Interface
61
62
63
64audiolib - housekeeping              1.9.5                     AuOpenServer(3)
Impressum