rfadmin(1M)       MISC. REFERENCE MANUAL PAGES        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  associ-
     ated  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 responsibil-
                 ities  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.

     -q          Tells if RFS is running.

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




           Last change: Remote File Sharing Utilities           1

rfadmin(1M)       MISC. REFERENCE MANUAL PAGES        rfadmin(1M)



                 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).
























           Last change: Remote File Sharing Utilities           2