AFAddHost(3) AFAddHost(3)
NAME
AFAddHost, AFAddHosts, AFListHosts, AFRemoveHost, AFRemoveHosts, AFSetAc-
cessControl, AFEnableAccessControl, AFDisableAccessControl, AFHostAddress -
control host access and host control structure
SYNTAX
#include <AF/AFlib.h>
void AFAddHost(AFAudioConn *aud, AFHostAddress *host)
void AFAddHosts(AFAudioConn *aud, AFHostAddress *hosts, int n)
AFHostAddress *AFListHosts(AFAudioConn *aud, int *nhosts_ret,
ABool *enabled_ret)
void AFRemoveHost(AFAudioConn *aud, AFHostAddress *host)
void AFRemoveHosts(AFAudioConn *aud, AFHostAddress *hosts, int n)
void AFSetAccessControl(AFAudioConn *aud, int mode)
void AFEnableAccessControl(AFAudioConn *aud)
void AFDisableAccessControl(AFAudioConn *aud)
ARGUMENTS
aud Specifies the connection to the AF server.
enabled_ret
Returns the current state of access control.
host Specifies the host that is to be added or removed.
hosts Specifies each host that is to be added or removed.
mode Specifies the mode.
n Specifies the number of hosts in the host list. You can pass
AEnableAccess or ADisableAccess.
nhosts_ret
Returns the number of hosts currently in the access control list.
num_hosts Specifies the number of hosts.
state_return
Returns the state of the access control.
DESCRIPTION
The AFAddHost function adds the specified host to the access control list
for that aud. The server must be on the same host as the client issuing
the command, or a ABadAccess error results.
AFAddHost can generate ABadAccess and ABadValue errors.
The AFAddHosts function adds each specified host to the access control list
for that aud. The server must be on the same host as the client issuing
the command, or a ABadAccess error results.
AFAddHosts can generate ABadAccess and ABadValue errors.
The AFListHosts function returns the current access control list as well as
whether the use of the list at connection setup was enabled or disabled.
AFListHosts allows a program to find out what machines can make connec-
tions. It also returns a pointer to a list of host structures that were
allocated by the function. When no longer needed, this memory should be
freed by calling AFFree.
The AFRemoveHost function removes the specified host from the access con-
trol list for that aud. The server must be on the same host as the client
process, or a ABadAccess error results. If you remove your machine from
the access list, you can no longer connect to that server, and this opera-
tion cannot be reversed unless you reset the server.
AFRemoveHost can generate ABadAccess and ABadValue errors.
The AFRemoveHosts function removes each specified host from the access con-
trol list for that aud. The AF server must be on the same host as the
client process, or a ABadAccess error results. If you remove your machine
from the access list, you can no longer connect to that server, and this
operation cannot be reversed unless you reset the server.
AFRemoveHosts can generate ABadAccess and ABadValue errors.
The AFSetAccessControl function either enables or disables the use of the
access control list at each connection setup.
AFSetAccessControl can generate ABadAccess and ABadValue errors.
The AFEnableAccessControl function enables the use of the access control
list at each connection setup.
AFEnableAccessControl can generate a ABadAccess error.
The AFDisableAccessControl function disables the use of the access control
list at each connection setup.
AFDisableAccessControl can generate a ABadAccess error.
STRUCTURES
The AFHostAddress structure contains:
typedef struct {
int family; /* e.g., AFamilyInternet */
int length; /* length of address, in bytes */
char *address; /* pointer to where to find the address */
} AFHostAddress;
The family member specifies which protocol address family to use (for exam-
ple, TCP/IP or DECnet) and can be AFamilyInternet, AFamilyDECnet, or AFami-
lyChaos. The length member specifies the length of the address in bytes.
The address member specifies a pointer to the address.
DIAGNOSTICS
ABadAccess
A client attempted to modify the access control list from other
than the local (or otherwise authorized) host.
ABadValue Some numeric value falls outside the range of values accepted by
the request. Unless a specific range is specified for an argu-
ment, the full range defined by the argument's type is accepted.
Any argument defined as a set of alternatives can generate this
error.
SEE ALSO
AFFree(3)
AF(1)
BUGS
If you encounter a reproducible bug, please submit a problem report to
(af-bugs@crl.dec.com).
COPYRIGHT
Copyright 1990-1994, Digital Equipment Corporation.
See AF(1) for a full statement of rights and permissions.
AUTHORS
Digital Cambridge Research Lab