Provided by: sfs-common_0.8-0+pre20060720.1-1.1_i386
sfsagent - SFS authentication agent
sfsagent [-dnkF] -S sock [-c [prog [arg ...]] | keyname]
sfsagent is the program users run to authenticate themselves to remote
file servers, to create symbolic links in /sfs on the fly, and to look
for revocation certificates. Many of the features in sfsagent are con‐
trolled by the sfskey program and described in the sfskey documenta‐
Ordinarily, a user runs sfsagent at the start of a session. sfsagent
runs sfskey add to obtain a private key. As the user touches each SFS
file server for the first time, the agent authenticates the user to the
file server transparently using the private key it has. At the end of
the session, the user should run sfskey kill to kill the agent.
-d Stay in the foreground rather than forking and going into the back‐
-n Do not attempt to communicate with the SFS file system. This can
be useful for debugging, or for running an agent on a machine that
is not running an SFS client. If you specify -n, you must also use
the -S option, otherwise your agent will be useless as there will
be no way to communicate with it.
-k Atomically kill and replace any existing agent. Otherwise, if your
agent is already running, sfsagent will refuse to run again.
-F Turn off forwarding. By default programs other than the file sys‐
tem can ask the agent to authenticate the user. Specifying this
option disables this functionality.
Listen for connections from programs like sfskey on the Unix domain
socket sock. Ordinarily sfskey connects to the agent through the
client file system software, but it can use a named Unix domain
socket as well.
-c [prog [arg ...]]
By default, sfsagent on startup runs the command sfskey add giving
it whatever -t option and keyname you specified. This allows you
to fetch your first key as you start or restart the agent. If you
wish to run a different program, you can specify it using -c. You
might, for instance, wish to run a shell-script that executes a
sfskey add followed by several sfskey certprog commands.
sfsagent runs the program with the environment variable
SFS_AGENTSOCK set to -0 and a Unix domain socket on standard input.
Thus, when atomically killing and restarting the agent using -k,
the commands run by sfsagent talk to the new agent and not the old.
If you don’t wish to run any program at all when starting sfsagent,
simply supply the -c option with no prog. This will start an new
agent that has no private keys.
dirsearch(1), newaid(1), rex(1), sfskey(1), ssu(1), sfs_config(5),
sfs_hosts(5), sfs_srp_params(5), sfs_users(5), sfsauthd_config(5),
sfscd_config(5), sfsrosd_config(5), sfsrwsd_config(5), sfssd_config(5),
sfs_environ(7), funmount(8), nfsmounter(8), sfsauthd(8), sfscd(8), sfs‐
rosd(8), sfsrwcd(8), sfsrwsd(8), sfssd(8), vidb(8)
The full documentation for SFS is maintained as a Texinfo manual. If
the info and SFS programs are properly installed at your site, the com‐
mand info SFS should give you access to the complete manual.
For updates, documentation, and software distribution, please see the
SFS website at http://www.fs.net/.