.Dd March 29, 2000 .Dt FS 1 .Os .Sh NAME .Nm fs .Nd Manage AFS directories .Sh SYNOPSIS .Nm .Op Ar command .Op Ar args .Sh DESCRIPTION The .Nm utility is used to manipulate the AFS filesystem. Note that the .Nm utility does .Em not modify the traditional .Ux filesystem, only files in AFS. .Pp The .Nm utility provides several commands: .Pp .Bl -tag -width setmaxpriority -compact .It Cm apropos locate commands by keyword .It Cm arladebug tweek arla-debugging flags .It Cm checkservers check if servers are up .It Cm checkvolumes not yet implemented .It Cm cleanacl not yet implemented .It Cm copyacl not yet implemented .It Cm diskfree show free partition space .It Cm examine examine volume status .It Cm flush remove file from cache .It Cm flushvolume remove volumedata (and files in volume) from cache .It Cm gcpags garbage collect pags .It Cm getcacheparms get cache usage .It Cm getcrypt get encrypt status .It Cm getcellstatus get suid cell status .It Cm getfid get fid .It Cm getserverprefs not yet implemented .It Cm getpriority get priority of a file/dir .It Cm gp shorthand for the .Cm getpriority command .It Cm getmaxpriority get max priority for a file gc .It Cm gmp shorthand for the .Cm getmaxpriority command .It Cm help get help for .Nm .It Cm listacl show acl .It Cm la shorthand for the .Cm listacl command .It Cm listcells list cells that the cache handler can communicate with .It Cm listquota show volume quota .It Cm lq shorthand for the .Cm listquota command .It Cm quota shorthand for the .Cm listquota command .It Cm lsmount show a mount point .It Cm messages not yet implemented .It Cm mkmount create mount point .It Cm connect connect mode .It Cm monitor set remote logging host .It Cm newcell add new cell .It Cm nop do a pioctl-nop .It Cm quit leave interactive mode .It Cm exit leave interactive mode .It Cm rmmount delete a mount point .It Cm removepriority remove priority from file/directory .It Cm rmp shorthand for the .Cm removepriority command .It Cm setacl add an acl entry on a directory .It Cm sa shorthand for the .Cm setacl command .It Cm setcachesize change disk cache size .It Cm setcell change cell status .It Cm setpriority set priority of a file/directory .It Cm sp shorthand for the .Cm setpriority command .It Cm setmaxpriority set upper limit of prio gc .It Cm smq shorthand for the .Cm setmaxpriority comand .It Cm setquota change quota on a volume .It Cm sq shorthand for the .Cm setquota command .It Cm setserverprefs not yet implemented .It Cm setcrypt set encryption on/off .It Cm setvol not yet implemented .It Cm suidcells list status of cells .It Cm sysname read/change sysname .It Cm version get version of fs and fs_lib .It Cm venuslog make arlad print status .It Cm whereis show server(s) of file .It Cm whichcell show cell of file .It Cm wscell display cell of workstation .It Cm xfsdebug tweek xfs-debugging flags .It Cm xfsprint make xfs print debug info .El .Pp Most .Nm commands accept the following general arguments: .Pp .Bd -filled -offset indent -compact .Op Fl cell Ar cellname Specifies which AFS cell to use, if the default cell is not to be used. .Pp .Op Fl noauth Specifies that .Nm should not try to authenticate the connection to the server. This may be useful with shell scripts, or if there is a problem with the AFS cell. Note that the server will reject many commands if .Fl noauth is specified. .Pp .Ed The syntax of the .Nm commands: .Pp .Ic fs apropos .Bd -filled -offset indent -compact Locate commands by keyword .Ed .Pp .Ic fs arladebug .Op Ar flags .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Tweek arla-debugging flags. .Ed .Pp .Ic fs checkservers .Op Fl cell Ar cellname .Op Fl noauth .Op Fl nopoll .Bd -filled -offset indent -compact Check if the server in a cell are up. If .Fl nopoll is specified, the servers are not contactad; only internal information is printed. .Ed .Pp .Ic fs checkvolumes .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs cleanacl .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs copyacl .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs diskfree .Ar path .Bd -filled -offset indent -compact show free partition space .Ed .Pp .Ic fs examine .Op Ar path .Bd -filled -offset indent -compact Print detailed information about the volume mounted on the specified path or the current directory. .Ed .Pp .Ic fs flush .Ar path .Bd -filled -offset indent -compact Flush the file specified, causing it to be stored on the fileserver. .Ed .Pp .Ic fs flushvolume .Ar path .Bd -filled -offset indent -compact Flush all the files in the volume where the file specified is stored, causing them to be stored on the fileserver. Meta information about the volume is also flushed. .Ed .Pp .Ic fs gcpags .Bd -filled -offset indent -compact Remove unused PAGs from the kernel. .Ed .Pp .Ic fs getcacheparms .Bd -filled -offset indent -compact Print information about cache usage. .Ed .Pp .Ic fs getcrypt .Bd -filled -offset indent -compact Display wether traffic between the client and server is encrypted. .Ed .Pp .Ic fs getcellstatus .Ar cellname .Bd -filled -offset indent -compact Indicate if setuid files are enabled for the specified cell. .Ed .Pp .Ic fs getfid .Ar path .Bd -filled -offset indent -compact Print fid information for a file. .Ed .Pp .Ic fs getserverprefs .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs getpriority .Bd -filled -offset indent -compact Display priority of a file or directory. .Ed .Pp .Ic fs gp .Bd -filled -offset indent -compact shorthand for the .Cm getpriority command .Ed .Pp .Ic fs getmaxpriority .Bd -filled -offset indent -compact Display max priority for a file. .Ed .Pp .Ic fs gmp .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Shorthand for the .Cm getmaxpriority command. .Ed .Pp .Ic fs help .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Get help for .Nm .Ed .Pp .Ic fs listacl .Ar path .Bd -filled -offset indent -compact Show acl for the specified path or the current directory. .Ed .Pp .Ic fs la .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Shorthand for the .Cm listacl command. .Ed .Pp .Ic fs listcells .Bd -filled -offset indent -compact List cells that the cache handler can communicate with. These are the cells listed in the file .Pa /etc/afs/CellServDB . .Ed .Pp .Ic fs listquota .Op Ar path .Bd -filled -offset indent -compact Show the quota for the volume of the file or directory specified. .Ed .Pp .Ic fs lq .Bd -filled -offset indent -compact shorthand for the .Cm listquota command .Ed .Pp .Ic fs quota .Op Fl cell Ar cellname .Op Fl noauth .Bd -filled -offset indent -compact Shorthand for the .Ic listquota command. .Ed .Pp .Ic fs lsmount .Bd -filled -offset indent -compact .Ar path Show a mount point. .Ed .Pp .Ic fs messages .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs mkmount .Ar directory .Ar volume .Bd -filled -offset indent -compact Create a mountpoint. Note that the there must not exist a directory named as the mount point you are creating. .Ed .Pp .Ic fs connect .Op Ar mode .Bd -filled -offset indent -compact Set or get connected mode, if a mode is specified, the cache manager will be set to that mode. If not, the current mode will be printed. Valid modes are: .Bl -tag -width -Fl -compact .It Cm connected Connected mode - this is the normal operating mode. .It Cm fetch Fetch only mode - files are retreived from fileserver but are not stored back. .It Cm disconnected Disconnected mode - files are read and written from/to the cache, and no attempt is made to contact a fileserver- .El .Pp Disconnected mode is very useful for machines that are not connected to the network at all times, such as laptops. Disconnected mode is to be considered very experimental at this stage. .Ed .Pp .Ic fs monitor .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs newcell .Fl cell Ar cellname .Fl servers Ar vldb-servers .Op Fl help .Bd -filled -offset indent -compact Add a new cell to the running configuration of the cache manager, or update already existing information. This information should also be entered in the file .Pa /etc/afs/CellServDB . .Ed .Pp .Ic fs nop .Bd -filled -offset indent -compact Do a pioctl-nop. This is useful for debugging. .Ed .Pp .Ic fs quit .Bd -filled -offset indent -compact Leave interactive mode. .Ed .Pp .Ic fs exit .Bd -filled -offset indent -compact Leave interactive mode. .Ed .Pp .Ic fs rmmount .Ar mountpoint .Bd -filled -offset indent -compact Delete a mount point. .Ed .Pp .Ic fs removepriority .Ar file .Bd -filled -offset indent -compact Remove priority from file/directory. .Ed .Pp .Ic fs rmp .Bd -filled -offset indent -compact Shorthand for the .Cm removepriority command. .Ed .Pp .Ic fs setacl .Bd -filled -offset indent -compact Add an acl entry on a directory. Each entry consists of two components: a user or group and a character string describing the permissions granted for that user or group. These characters and the permission they represent are: .Bl -tag -width Fl -compact .It Cm r read the files .It Cm l list the files .It Cm i insert new files .It Cm d delete files .It Cm w write (change) the files .It Cm k lock files .It Cm a administer the acl, that is, to change the acl .El .Pp There are also a few convinience strings recognized by .Ic fs setacl : .Bl -tag -width Fl -compact .It Cm none removes all permissions. .It Cm read adds 'rl' permissions, which are suitable for a read-only directory. .It Cm write adds all permissions except 'a', that is, the user/group can read, write, delete etc. but not change the acl of the directory. .It Cm all add all permissions. .El .Pp Note that in AFS you set the permissions on a directory, and the permissions of a file are those of their directory. So, if you move a file from one directory to another, you might change the permission of the file, as the two directories may have different permissions. .Pp Of the traditional .Ux permission bits only the user part is honored, and is used for any user permissioned by the directories acl. The group and world permission bits are ignored, but they are stored. .Ed .Pp .Ic fs sa .Bd -filled -offset indent -compact shorthand for the .Cm setacl command .Ed .Pp .Ic fs setcachesize .Ar lowvnodes .Op Ar highvnodes Ar lowbytes Ar highbytes .Bd -filled -offset indent -compact Set the size of the disk cache. .Ed .Pp .Ic fs setcell .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs setpriority .Ar file .Ar priority .Bd -filled -offset indent -compact Set priority of a file/directory. .Ed .Pp .Ic fs sp .Bd -filled -offset indent -compact Shorthand for the .Cm setpriority command. .Ed .Pp .Ic fs setmaxpriority .Ar macprio .Bd -filled -offset indent -compact Set upper limit of priority. .Ed .Pp .Ic fs smq .Bd -filled -offset indent -compact shorthand for the .Cm setmaxpriority comand .Ed .Pp .Ic fs setquota .Ar path .Ar quota .Bd -filled -offset indent -compact Set the quota (in Kbytes) on a volume. .Ed .Pp .Ic fs sq .Bd -filled -offset indent -compact Shorthand for the .Cm setquota command. .Ed .Pp .Ic fs setserverprefs .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs setcrypt .Ar flag .Bd -filled -offset indent -compact If 'no' is specified, encryption of the traffic to/from fileservers is disabled, and if 'yes' is specified, it is enabled. .Ed .Pp .Ic fs setvol .Bd -filled -offset indent -compact Not implemented yet. .Ed .Pp .Ic fs suidcells .Bd -filled -offset indent -compact Print cells and wether setuid execution is allowed for them. .Ed .Pp .Ic fs sysname .Op Ar sysname .Bd -filled -offset indent -compact Get or set the value of the '@sys' value. .Ed .Pp .Ic fs version .Bd -filled -offset indent -compact Print version of fs and fs_lib. .Ed .Pp .Ic fs venuslog .Bd -filled -offset indent -compact Make afsd print status. .Ed .Pp .Ic fs whereis .Op Ar path .Bd -filled -offset indent -compact Show server(s) of the specified file or the current directory. .Ed .Pp .Ic fs whichcell .Op Ar path .Bd -filled -offset indent -compact Show cell of a file or the current directory. .Ed .Pp .Ic fs wscell .Bd -filled -offset indent -compact Display default cell of the client. .Ed .Pp .Ic fs xfsdebug .Bd -filled -offset indent -compact Tweek xfs-debugging flags .Ed .Pp .Ic fs xfsprint .Op Ar flags .Bd -filled -offset indent -compact Make xfs print debug info. .Ed .Sh SEE ALSO .Xr afsd 8 , .Xr pts 1 , .Xr vos 8 .Sh STANDARDS The Arla authors are trying to mimic the behaviour of the original AFS utilities. .Sh AUTHORS The Arla project . .Sh BUGS Some commands are not implemented yet.