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.

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

  —  Remote File Sharing Utilities