rfstart(1M)      UNIX System V(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
      If syntax errors are found when validating an rfmaster(4) file, a warning
      describing each error will be sent to standard error.





10/89                                                                    Page 1

rfstart(1M)      UNIX System V(Remote File Sharing Utilities)       rfstart(1M)


      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), idload(1M), mount(1M), rfadmin(1M), rfstop(1M),
      unshare(1M)
      rfmaster(4) in the Programmer's Reference Manual

NOTES
      You must run idload(1M) to put any non-default user and group mappings
      into place.























Page 2                                                                    10/89