Manual pages › System administration commands (1M)

rfstart(1M)

start Remote File Sharing

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

NAME

rfstart - start Remote File Sharing

SYNOPSIS

rfstart [-v] [-p primary_addr]

DESCRIPTION

rfstart starts Remote File Sharing and defines an authentication level for incoming requests. (This command can only be used after the domain name server is set up and your computer's domain name and network specification have been defined using dname(1M).)

-v Specifies that verification of all clients is required in response to initial incoming mount requests; any host not in the file /etc/rfs/auth.info/domain/passwd for the domain they belong to, will not be allowed to mount resources from your host. If -v is not specified, hosts named in domain/passwd will be verified. Other hosts will be allowed to connect without verification.

-p primary_addr

Indicates the primary domain name server for your domain. primary_addr can specify any of the following: the network address of the primary name server for a domain (addr); a list of address tuples when RFS is used over multiple transport providers (transport1:addr1,transport2:addr2, ...). An example of each type of specification follows:

-p addr
-p transport1:addr1,transport2:addr2, ...

If the -p option is not specified, the address of the domain name server is taken from the associated rfmaster files. The -p addr specification is valid only when one transport provider is being used. See the rfmaster(1M) manual page for a description of the valid address syntax. If the host password has not been set, rfstart will prompt for a password. The password prompting process must match the password entered for your machine at the primary domain name server (see rfadmin(1M)). If you remove the loc.passwd file or change domains, you will also have to reenter the password. Also, when rfstart is run on a domain name server, entries in the rfmaster(4) file are syntactically validated. This command is restricted to the super-user.

ERRORS

If syntax errors are found when validating an rfmaster(4) file, a warning describing each error will be sent to standard error. An error message will be sent to standard error if any of the following conditions are true:

     1. remote file sharing is already running
     2. there is no communications network
     3. a domain name server cannot be found
     4. a domain name server does not recognize the machine
     5. the command is run without super-user privileges
Remote file sharing will not start if  a  host  password  in
/etc/rfs/<transport>/loc.passwd   is   corrupted.    If  you
suspect this has happened, remove the file and  run  rfstart
again to reenter your password.  NOTE: rfstart will NOT fail
if your host password does not match  the  password  on  the
domain  name server.  You will simply receive a warning mes-
sage.  However, if you try to mount a resource from the pri-
mary,  or  any  other host that validates your password, the
mount will fail if your password does not match the one that
the host has listed for your machine.

FILES