rfstart(1M)           (Remote File Sharing Utilities)           rfstart(1M)


   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




   8/91                                                                 Page 1

   rfstart(1M)           (Remote File Sharing Utilities)           rfstart(1M)


         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 message.  However, if you try to mount a resource from the
         primary, 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
         /etc/rfs/<transport>/rfmaster
         /etc/rfs/<transport>/loc.passwd

   SEE ALSO
         share(1M), dname(1M), mount(1M), rfadmin(1M), rfstop(1M),
         unshare(1M).
         rfmaster(4) in the Programmer's Reference Manual.





















   Page 2                                                                 8/91