man3/AFDisableAccessControl.3

#

    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