NAME

rfadmin − Remote File Sharing domain administration

SYNOPSIS

rfadmin
rfadmin −a hostname
rfadmin −o option
rfadmin −p [ −t transport1, transport2, ... ]
rfadmin −q
rfadmin −r hostname

AVAILABILITY

SUNWrfsu

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 when the −q option is used. 

OPTIONS

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

−o option Set 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. 

−p Pass the domain name server responsibilities back to a primary or a secondary name server. 

−q Indicate whether RFS is running. 

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

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

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 any of the following ar true, an error message will be sent to standard error:

• hostname does not exist in the domain. 

• hostname is defined as a domain name server. 

• There are resources advertised by hostname.

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)

SunOS 5.2  —  Last change: 14 Sep 1992