rfadmin(1M)      UNIX System V(Remote File Sharing Utilities)       rfadmin(1M)


NAME
      rfadmin - Remote File Sharing domain administration

SYNOPSIS
      rfadmin

      rfadmin -a hostname

      rfadmin -r hostname

      rfadmin -p [-t transport1,transport2,...]

      rfadmin -q

      rfadmin -o option

DESCRIPTION
      rfadmin is used to add and remove hosts, and their associated
      authentication information, from a domain/passwd file on a Remote File
      Sharing primary domain name server.  It is also used to transfer domain
      name server responsibilities from one machine to another.  Used with no
      options, rfadmin returns the hostname of the current domain name server
      for the local domain on each of the transport providers that span the
      domain.

      rfadmin can only be used to modify domain files on the primary domain
      name server (-a and -r options).  If domain name server responsibilities
      are temporarily passed to a secondary domain name server, that computer
      can use the -p option to pass domain name server responsibility back to
      the primary.  The command can be directed to a specific set of transport
      providers by using the -t option with a comma-separated list of transport
      providers.  Any host can use rfadmin with no options to print information
      about the domain.  The user must have root permissions to use this
      command, except in the case when the -q option is used.

      -a hostname Add a host to a domain that is served by this domain name
                  server.  hostname must be of the form domain.nodename.  It
                  creates an entry for hostname in the domain/passwd file and
                  prompts for an initial authentication password; the password
                  prompting process conforms with that of passwd(1).

      -r hostname Remove a host, hostname, from its domain by removing it from
                  the domain/passwd file.

      -p          Used to pass the domain name server responsibilities back to
                  a primary or to a secondary name server.

      -t transport1, transport2 ...
                  Select transport provider(s).  The -t option is used only
                  with the -p option.




10/89                                                                    Page 1

rfadmin(1M)      UNIX System V(Remote File Sharing Utilities)       rfadmin(1M)


      -q          Tells if RFS is running.

      -o option   Sets RFS system option.  option is one of the following:

                  loopback - Enable loop back facility.  This allows a resource
                  advertised by a computer to be mounted by the same computer.
                  loopback is off by default.

                  noloopback - Turn off the loop back facility. noloopback is
                  the default.

                  loopmode - Check if the loop back facility is on or off.

ERRORS
      When used with the -a option, if hostname is not unique in the domain, an
      error message will be sent to standard error.

      When used with the -r option, if (1) hostname does not exist in the
      domain, (2) hostname is defined as a domain name server, or (3) there are
      resources advertised by hostname, an error message will be sent to
      standard error.

      When used with the -p option to change the domain name server, if there
      are no backup name servers defined for domain, an error message will be
      sent to standard error.

FILES
      /etc/rfs/auth.info/domain/passwd
            For each domain, this file is created on the primary, copied to all
            secondaries, and copied to all hosts that want to do password
            verification of hosts in the domain.

SEE ALSO
      passwd(1), dname(1M), rfstart(1M), rfstop(1M), umount(1M).




















Page 2                                                                    10/89