Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
FS(1)			     AFS Command Reference			 FS(1)

       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:

       o   Commands to set and report how the Cache Manager interacts with
	   server machines: fs checkservers, fs	getcellstatus, fs getcrypt, fs
	   getserverprefs, fs listcells, fs newcell, fs	setcbaddr, fs setcell,
	   fs setcrypt,	fs setserverprefs, fs sysname, fs uuid,	and fs wscell.

       o   Commands to administer access control lists (ACLs): fs cleanacl, fs
	   copyacl, fs getcalleraccess,	fs listacl, and	fs setacl.

       o   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.

       o   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.

       o   Commands to administer volume mount points: fs lsmount, fs mkmount,
	   and fs rmmount.

       o   Commands to control monitoring and tracing: fs debug, fs memdump,
	   fs messages,	fs minidump, fs	monitor, fs rxstatpeer,	fs rxstatproc,
	   and fs trace.

       o   A command to	administer the Cache Manager's interaction with	other
	   file	systems: fs exportafs.

       o   Commands to obtain help: fs apropos and fs help.

       o   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:

	   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.

	   Defines the machine's cell membership with respect to the AFS
	   command suites and Cache Manager access to AFS data.

	   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.

	   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:

       o   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.

       o   Being logged	onto the machine as the	local superuser	"root".	This
	   is necessary	when issuing commands that affect Cache	Manager

       o   Belonging to	the system:administrators group	in the Protection

       o   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_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_setvol(1), fs_storebehind(1),
       fs_sysname(1), fs_trace(1), fs_whereis(1), fs_whichcell(1),

       IBM Corporation 2000. <> 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.

OpenAFS				  2016-12-14				 FS(1)


Want to link to this manual page? Use this URL:

home | help