Chapter�3.�Displaying Information about OpenAFS

Table of Contents

Displaying Volume Quota
To Display Percentage of Quota Used
Example: Displaying Percentage of Quota Used
To Display Quota and Other Information about a Volume
Example: Display Quota and Other Information about a Volume
To Display Quota and Other Information about a Volume and Partition
Example: Displaying Quota and Other Information about a Volume and Partition
Locating Files and Directories
To Display a File or Directory's Location
Example: Displaying Directory Location
Checking the Status of Server Machines
To Check File Server Machine Status
Example: Checking Server Machine Status
Determining Access to Foreign Cells
To Display Foreign Cells
Displaying Server Preference Ranks
To Display Server Preference Ranks

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

Displaying Volume Quota

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.

To Display Percentage of Quota Used

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.

Example: Displaying Percentage of Quota Used

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.

To Display Quota and Other Information about a Volume

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.

Example: Display Quota and Other Information about a Volume

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%

To Display Quota and Other Information about a Volume and Partition

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.

Example: Displaying Quota and Other Information about a Volume and Partition

The following example displays quota and other information about the volume that houses the current working directory.

   % fs examine
   Volume status for vid = 536871122 named user.terry
   Current disk quota is 10000
   Current blocks used are 5745
   The partition has 1593 blocks available out of 99162