rfstart(8)                          CLIX                          rfstart(8)



  NAME

    rfstart - Starts Remote File Sharing

  SYNOPSIS

    rfstart [-v] [-p primary_addr]

  FLAGS

    -v                Specifies that verification of all clients is required
                      in response to initial incoming mount requests; any host
                      not in the domain file to which they belong 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.  The primary_addr must be the network address of
                      the primary name server for your domain.  If the -p flag
                      is not specified, the address of the domain name server
                      is taken from the rfmaster file.  (See rfmaster for a
                      description of the valid address syntax.)

  DESCRIPTION

    The rfstart command starts Remote File Sharing (RFS) 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 has been defined using dname.)

    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).  If you remove
    the loc.passwd file or change domains, you will also have to re-enter the
    password.

    In addition, when rfstart is run on a domain name server, entries in the
    rfmaster file are syntactically validated.

    This command is restricted to use by the superuser.

  EXAMPLES

    The following example starts RFS on the current system:

    /usr/bin/rfstart -v </dev/console >/dev/console 2>/usr/tmp/rfs

    The -v flag specifies that host verification is to be used to restrict
    access to the current host.



  2/94 - Intergraph Corporation                                              1

  rfstart(8)                          CLIX                          rfstart(8)



  FILES

    /usr/nserve/rfmaster     The names and network addresses of primary and
                             secondary domain name servers.

    /usr/nserve/loc.passwd   Contains your host's authentication password.

  NOTES

    The rfstart command 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 host has listed for your machine.

  DIAGNOSTICS

    If syntax errors are found in validating the rfmaster file, a warning
    describing each error will be sent to stderr.

    A message will also be sent to stderr if:

    ⊕  The shared resource environment is already running

    ⊕  There is no communications network

    ⊕  The domain name server cannot be found

    ⊕  The domain name server does not recognize the machine or

    ⊕  The command is run without superuser privileges.

    Remote File Sharing will not start if the host password in
    /usr/nserve/loc.passwd is corrupted.  If you suspect this has happened,
    remove the file and run rfstart again to reenter your password.

  EXIT VALUES

    The rfstart command exits with a value of 0 if successful, a value of 1 if
    the name server failed, and a value of 2 if something else went wrong.

  RELATED INFORMATION

    Commands: adv(8), dname(8), mount(8), rfadmin(8) rfstop(8), unadv(8)

    Files: rfmaster(4)








  2                                              Intergraph Corporation - 2/94