rfstart(1M)       MISC. REFERENCE MANUAL PAGES        rfstart(1M)



NAME
     rfstart - start Remote File Sharing

SYNOPSIS
     rfstart [-v] [-p primary_addr]

DESCRIPTION
     rfstart starts Remote File Sharing and defines an  authenti-
     cation  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 follow-
             ing:  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 exam-
             ple 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 pass-
             word 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  rfmas-
             ter(4)  file are syntactically validated.  This com-
             mand is restricted to the super-user.

ERRORS
     If syntax errors are found when  validating  an  rfmaster(4)



           Last change: Remote File Sharing Utilities           1

rfstart(1M)       MISC. REFERENCE MANUAL PAGES        rfstart(1M)



     file,  a warning describing each error will be sent to stan-
     dard 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
     /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.



























           Last change: Remote File Sharing Utilities           2