NAME

fs - suite of commands for contacting the AFS File Server and configuring the Cache Manager. 

SYNOPSIS

fs <option>

Each of the the following operation codes is a valid <option> and has its own set of associated arguments.  See the "OPTIONS" section below for syntax definitions. 

apropos - search by help text
cachesize - set cache size
checkservers - check functioning servers
checkvolumes - check volume/name mappings
cleanacl - clean up access control list
debug - set debugging info
diskfree - show server disk space usage
examine - display volume status
exportafs - enable/disable exporters to AFS
flush - flush file from cache
flushvolume - flush all data in volume
getcacheparms - get cache usage info
getcellstatus - get cell status
help - get help on commands
listacl - list access control list
listcells - list configured cells
listquota - list volume quota
lsmount - list mount point
mkmount - make mount point
monitor - set cache monitor host address
newcell - configure new cell
olsmount - list mount point
ormmount - remove mount point
quota - show volume quota usage
rmmount - remove mount point
setacl - set access control list
setcell - set cell status
setquota - set volume quota
setvol - set volume status
sysname - get/set sysname (i.e. @sys) value
whereis - list file’s location
whichcell - list file’s cell
wscell - list workstation’s cell

DESCRIPTION

The commands in the fs suite belong to two functionally distinct subsets.  The commands in one subset contact the File Server process running on file server machines.  Some of these commands extend UNIX file system semantics by invoking file-related functions that UNIX does not provide (setting access control lists, for example).  The commands in the other subset configure the Cache Manager on the client machine where the command is issued, thus controlling aspects of its performance. 

OPTIONS

apropos - search by help text
syntax: fs apropos  -topic <help string]>  [-help]

cachesize - set cache size
syntax: fs cachesize  [-blocks <size in 1K byte blocks (0 => reset)>]  [-reset]  [-help]

checkservers - check functioning servers
syntax: fs checkservers  [-fast]  [-dir <directory (ignored)>]  [-help]

checkvolumes - check volume/name mappings
syntax: fs checkvolumes  [-help]
alias: fs checkbackups

cleanacl - clean up access control list
syntax: fs cleanacl  [-dir <directory>+]  [-help]

debug - set debugging info
syntax: fs debug  -debug <’on’ or ’off’>  [-dafs <afs debug level>]  [-dnet <network debug level>]  [-help]

diskfree - show server disk space usage
syntax: fs diskfree  [-dir <directory>+]  [-help]
alias: fs df

examine - display volume status
syntax: fs examine  [-dir <directory>+]  [-help]
aliases: fs lv and fs listvol

exportafs - enable/disable exporters to AFS
syntax: fs exportafs  -type <exporter name>  [-state <’on’ or ’off’>]  [-help]

flush - flush file from cache
syntax: fs flush  -dir <directory>+  [-help]

flushvolume - flush all data in volume
syntax: fs flushvolume  -dir <directory>+  [-help]

getcacheparms - get cache usage info
syntax: fs getcacheparms  [-help]

getcellstatus - get cell status
syntax: fs getcellstatus  -cell <cell name>+  [-help]

help - get help on commands
syntax: fs help  [-topic <help string>+]  [-help]

listacl - list access control list
syntax: fs listacl  [-dir <directory>+]  [-help]
alias: fs la

listcells - list configured cells
syntax: fs listcells  [-help]

listquota -list volume quota
syntax: fs listquota  [-dir <directory>+]  [-help]
alias: fs lq

lsmount - list mount point
syntax: fs lsmount  -dir <directory>+  [-help]

mkmount - make mount point
syntax: fs mkmount  -dir <directory>  -vol <volume name>  [-cell <cell name>] @[-rw]  [-fast]  [-root]  [-help]

monitor - set cache monitor host address
syntax: fs monitor  [-server <host name or ’off’>]  [-help]
alias: fs mariner

newcell - configure new cell
syntax: fs newcell -name <cell name>  -servers <primary servers>+  [-help]

olsmount - list mount point
syntax: fs olsmount -dir <directory>+  [-help]

ormmount - remove mount point
syntax: fs ormmount -dir <directory>+  [-help]

quota - show volume quota usage
syntax: fs quota  [-dir <directory>+]  [-help]

rmmount - remove mount point
syntax: fs rmmount  -dir <directory>+  [-help]

setacl - set access control list
syntax: fs setacl  -dir <directory>+ -acl <access list entries>+  [-clear]  [-negative]  [-help]
alias: fs sa

setcell - set cell status
syntax: fs setcell  -cell <cell name>+  [-suid]  [-nosuid]  [-help]

setquota - set volume quota
syntax: fs setquota  -dir <directory>+  -max <max quota in kbytes>  [-min <min quota in kybtes>]  [-help]
alias: fs sq

setvol - set volume status
syntax: fs setvol -dir <directory>+  [-max <disk space quota in 1K units>]  [-min <disk space guaranteed>]  [-motd <message of the day>]  [-offlinemsg <offline message>]  [-help]
alias: fs sv

sysname - get/set sysname (i.e. @sys) value
syntax: fs sysname  [-newsys <new sysname>]  [-help]

whereis - list file’s location
syntax: fs whereis  [-dir <directory>+]  [-help]

whichcell - list file’s cell
syntax: fs whichcell  [-dir <directory>+]  [-help]

wscell -list workstation’s cell
syntax: fs wscell  [-help]

  —  Last change: 30 April 1990