NAME

rfstart − start Remote File Sharing

SYNOPSIS

rfstart [−v] [−p primary_addr]

AVAILABILITY

SUNWrfsu

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 the domain name and network specification have been defined using dname(1M). 

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. 

OPTIONS

−v Specify 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
Indicate 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:

 example% rfstart −p addr
example% rfstart −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 rfmaster(4) for a description of the valid address syntax. 

ERRORS

If syntax errors are found when validating an rfmaster(4) file, a warning that describes 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:

 Remote file sharing is already running.
There is no communications network.
A domain name server cannot be found.
A domain name server does not recognize the machine.
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 re-enter your password. 

FILES

/etc/rfs/<transport>/rfmaster
/etc/rfs/<transport>/loc.passwd

SEE ALSO

dname(1M), mount(1M), rfadmin(1M), rfstop(1M), share(1M), unshare(1M), rfmaster(4)

NOTES

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. 

SunOS 5.1/SPARC  —  Last change: 14 Sep 1992