fs - Introduction to the fs command suite
The commands in the fs command suite constitute the main
administrative interface to the Cache Manager on an AFS client machine,
which is responsible for fetching AFS data from file server machines on
behalf of applications running on the client machine.
There are several categories of commands in the fs command
suite:
- Commands to set and report how the Cache Manager interacts with server
machines: fs checkservers, fs getcellstatus, fs
getcrypt, fs getserverprefs, fs getverify, fs
listcells, fs newcell, fs setcbaddr, fs setcell,
fs setcrypt, fs setserverprefs, fs setverify, fs
sysname, fs uuid, and fs wscell.
- Commands to administer access control lists (ACLs): fs cleanacl,
fs copyacl, fs getcalleraccess, fs listacl, and fs
setacl.
- Commands to administer server machines, volumes or partitions that house a
given file or directory: fs diskfree, fs examine, fs
getfid, fs listquota, fs quota, fs setquota,
fs setvol, fs whereis, and fs whichcell.
- Commands to administer the local client cache and related information:
fs bypassthreshold, fs checkvolumes, fs cscpolicy,
fs flush, fs flushall, fs flushvolume, fs
getcacheparms, fs listaliases, fs newalias, and fs
setcachesize.
- Commands to administer volume mount points: fs lsmount, fs
mkmount, and fs rmmount.
- Commands to control monitoring and tracing: fs debug, fs
memdump, fs messages, fs minidump, fs monitor,
fs rxstatpeer, fs rxstatproc, and fs trace.
- A command to administer the Cache Manager's interaction with other file
systems: fs exportafs.
- Commands to obtain help: fs apropos and fs help.
- A command to display the OpenAFS command suite version: fs
version.
The Cache Manager and the fs commands use and maintain the
following configuration files:
- /etc/openafs/CellServDB
- Lists the database server machines in the local cell and any foreign cell
to which the administrator wishes to enable AFS access for users working
on the machine. The database server machines run the Authentication,
Backup, Protection and Volume Location (VL) Server processes, which
maintain databases of administrative information. For users to access a
cell, its "root.cell" volume must also
be mounted in the local cell's AFS file tree.
- /etc/openafs/ThisCell
- Defines the machine's cell membership with respect to the AFS command
suites and Cache Manager access to AFS data.
- /etc/openafs/cacheinfo
- Defines configuration parameters for the cache, including its size and
whether it is in memory or on disk.
In addition, the Cache Manager automatically creates files on the
cache partition (by default, /usr/vice/cache for caching and tracking
files fetched from file server machines.
For more details, see the reference page for each file.
The following flag is available on every command in the fs suite.
The reference page for each command also lists it, but it is described here
in greater detail.
- -help
- Prints a command's online help message on the standard output stream. Do
not combine this flag with any of the command's other options; when it is
provided, the command interpreter ignores all other options, and only
prints the help message.
The privileges required for fs commands vary more than for other
command suites. Pay special attention to the PRIVILEGE REQUIRED section of
each command description.
The various types of necessary privilege include:
- Having permissions on a directory's ACL. For example, creating and
removing mount points requires "a"
(administer), "i" (insert), and
"d" (delete) permissions on the ACL of
the directory in which the mount point resides.
- Being logged onto the machine as the local superuser
"root". This is necessary when issuing
commands that affect Cache Manager configuration.
- Belonging to the system:administrators group in the Protection
Database.
- No privilege. Many fs commands simply list information.
afs_cache(5), CellServDB(5), ThisCell(5)
cacheinfo(5), fs_apropos(1), fs_checkservers(1),
fs_checkvolumes(1), fs_cleanacl(1), fs_copyacl(1),
fs_cscpolicy(1), fs_diskfree(1), fs_examine(1),
fs_exportafs(1), fs_flush(1), fs_flushall(1),
fs_flushmount(1), fs_flushvolume(1),
fs_getcacheparms(1), fs_getcalleraccess(1),
fs_getcellstatus(1), fs_getclientaddrs(1),
fs_getcrypt(1), fs_getfid(1), fs_getserverprefs(1),
fs_getverify(1), fs_help(1), fs_listacl(1),
fs_listaliases(1), fs_listcells(1), fs_listquota(1),
fs_lsmount(1), fs_memdump(1), fs_messages(1),
fs_minidump(1), fs_mkmount(1), fs_monitor(1),
fs_newalias(1), fs_newcell(1), fs_quota(1),
fs_rmmount(1), fs_rxstatpeer(1), fs_rxstatproc(1),
fs_setacl(1), fs_setcachesize(1), fs_setcbaddr(1),
fs_setcell(1), fs_setclientaddrs(1), fs_setcrypt(1),
fs_setquota(1), fs_setserverprefs(1), fs_setverify(1),
fs_setvol(1), fs_storebehind(1), fs_sysname(1),
fs_trace(1), fs_whereis(1), fs_whichcell(1),
fs_wscell(1)
IBM Corporation 2000. <http://www.ibm.com/> All Rights
Reserved.
This documentation is covered by the IBM Public License Version
1.0. It was converted from HTML to POD by software written by Chas Williams
and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.