RFADMIN(1M) (Remote File Sharing Utilities) RFADMIN(1M)
NAME
rfadmin - Remote File Sharing administration
SYNOPSIS
rfadmin
rfadmin -[ar] domain.nodename
rfadmin -[pq]
rfadmin -o loopback noloopback
DESCRIPTION
rfadmin is primarily used to add and remove computers 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 domain.nodename of the current
domain name server for the local domain. Other options let
you check if RFS is running and turn on the RFS loop back
feature.
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. rfadmin can be used on any computer with no
options or with the q or o options, to print information
about the current domain name server. The user must have
root permissions to use the command.
-a domain.nodename
Used to add a computer to the member list of the
domain that is served by this primary domain
name server. The computer's name must be of the
form domain.nodename. This command creates an
entry for nodename in the domain/passwd file,
which has the same format as /etc/passwd, and
Page 1 May 1989
RFADMIN(1M) (Remote File Sharing Utilities) RFADMIN(1M)
prompts for an initial authentication password.
The password prompting process conforms with
that of passwd(1).
-r domain.nodename
Used to remove a computer 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.
-q Prints a message that will tell you whether or
not RFS is running.
-o option Lets you set RFS system options, by replacing
option with one of the following:
loopback - Enables loop back facility for your
computer. When this is set, you can mount a
resource that is advertised from your own
computer. This is used for testing applications
in RFS when only one computer is available.
Loop back is off by default.
noloopback - Turns off the loop back facility
for your computer. This is the default.
ERRORS
When used with the -a option, if domain.nodename is not
unique in the domain, an error message will be sent to
standard error.
When used with the -r option, if (1) domain.nodename does
not exist in the domain, (2) domain.nodename is defined as a
domain name server, or (3) there are resources advertised by
domain.nodename, an error message will be sent to standard
error.
When used with the -p option to change the domain name
Page 2 May 1989
RFADMIN(1M) (Remote File Sharing Utilities) RFADMIN(1M)
server, if there are no backup name servers defined for
domain, a warning message will be sent to standard error.
FILES
/usr/nserve/auth.info/domain/passwd
(For each domain, this file: is created on the primary,
should be copied to all secondaries, and should be copied to
all computers that want to do password verification of computers
in the domain.)
SEE ALSO
passwd(1), rfstart(1M), rfstop(1M), umount(1M).
Page 3 May 1989