rfadmin(1M)           (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.





   7/91                                                                 Page 1

   rfadmin(1M)           (Remote File Sharing Utilities)           rfadmin(1M)


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

         -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                                                                 7/91