Table of Contents
This chapter explains how to display information that can help you use AFS more effectively. It includes the following sections.
Displaying Volume Quota |
Locating Files and Directories. |
Checking the Status of Server Machines |
Determining Access to Foreign Cells |
Displaying Server Preference Ranks |
By convention, the files in your home directory are stored together in a single volume. (For information about volumes, see Volumes and Mount Points.) To allocate your cell's available disk space as fairly as possible, your system administrators impose a size limit, or quota, on each volume. You cannot store more data in a volume than its quota allows. If a volume is close to its quota, you sometimes cannot save changes you have made to files stored in the volume.
The amount of space available on the partition that houses the volume also limits how large the volume can grow. If the disk partition is full, you can become unable to save changes to a file even though the volume is not close to its quota.
Check the quota on your home volume periodically to make sure you have adequate space. Also, if you encounter problems saving a file, check the quota of the volume in which the file is stored. Use the following commands to display volume quota.
The fs quota command lists the percentage of the volume quota used.
Both the fs listquota and fs examine commands list the volume name, its maximum size (quota), and its current size. They also report the following additional information.
The fs listquota command lists the percentage used of both the volume and the partition.
The fs examine command lists the partition's size, the amount of space currently used, and any messages associated with the volume.
Issue the fs quota command to display the percentage of the quota currently used for the volume that contains a specified directory or file.
% fs quota [<dir/file path
>+]
where dir/file path
specifies the pathname of a file or directory in each volume for which to
display quota information. If you do not provide a pathname, the output reports quota information for the volume that contains
the current working directory.
The following example displays the percentage of quota used for the volumes that contain two user home directories in the Example Corporation cell.
% cd /afs/example.com/usr % fs quota terry pat 34% of quota used. 85% of quota used.
Issue the fs listquota command to display the following information:
The name of the volume that houses each specified file or directory
The quota, expressed as a number of kilobytes (1024
indicates one megabyte)
The current size of the volume (the number of kilobytes of currently used)
The percentage of the quota used
The percentage of space used on the disk partition housing the volume
The command's syntax is as follows.
% fs listquota [<dir/file path
>+]
where dir/file path
specifies the pathname of a file or directory in each volume for which to
display quota information. If you do not provide a pathname, the output reports quota information for the volume that contains
the current working directory.
The following example displays quota information about the volume that houses the home directory of user terry.
% fs listquota ~terry
Volume Name Quota Used % Used Partition
user.terry 10000 3400 34% 86%
Issue the fs examine command to display the following information about a volume and the partition it resides on:
The volume's ID number (abbreviated in the output as vid
)
The volume name
The volume's quota and current size, in kilobytes
The number of kilobyte blocks available on the disk partition housing the volume and the total size of that partition
An off-line message associated with the volume, if any, as set by a system administrator
The command's syntax is as follows.
% fs examine [<dir/file path
>+]
where dir/file path
specifies the pathname of a file or directory in each volume for which to
display quota information. If you do not provide a pathname, the output reports quota information for the volume that contains
the current working directory.