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).]

−vSpecifies 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 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). 

NOTES

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

  —  Remote File Sharing Utilities