Manual pages › System administration commands (1M)

rfadmin(1M)

Remote File Sharing domain administration

From the original Amiga UNIX 2.1 manual. Some things it mentions may not be in this release.

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