src/man/fs_diskfree.1

   1 fs diskfree                AFS Commands             fs diskfree
   2
   3
   4 NAME
   5
   6    fs diskfree -- show information about the partition housing
   7
   8                        a directory/file.
   9
  10
  11                                      +
  12    fs diskfree [-path <dir/file path> ]  [-help]
  13
  14 ACCEPTABLE ABBREVIATIONS/ALIASES
  15
  16                              +
  17    fs df  [-p <dir/file path> ]  [-h]
  18
  19 DESCRIPTION
  20
  21    Provides information about the  partition  that  houses  the
  22    volume  containing the specified directory or file.  See the
  23    OUTPUT section for a complete explanation of the information
  24    provided.  To learn more about the volume itself, use the fs
  25    examine command.
  26
  27 ARGUMENTS
  28
  29    -path specifies  a  file  or  directory  about  whose   host
  30          partition information is desired.  If the issuer omits
  31          this  argument,  the  current  working  directory   is
  32          assumed.
  33
  34    -help prints the online help entry for this command.  Do not
  35          provide any other arguments or flags  with  this  one.
  36          See  section  3.1  in  the  Reference  Manual for more
  37          details.
  38
  39 OUTPUT
  40
  41    Note: The numbers that appear in this output may not  always
  42    agree  with  the  corresponding numbers in the output of the
  43    standard UNIX df command.  The main reason is  that  the  df
  44    output  reflects  the  state  of partitions exactly when the
  45    command is issued.  The numbers in this command's output may
  46    be  up to 5 minutes old, as the Cache Manager polls the File
  47    Server for partition information at that frequency.  Another
  48    potential  difference:  the  partition  size reported by the
  49    UNIX df command includes some reserved space that  does  not
  50    show  up  in this report of partition size, and so is likely
  51    to be about 10% larger.
  52
  53    The output reports  the  following  information  about  each
  54    partition that houses a specified directory or file:
  55
  56       - the name of the volume that contains the directory
  57         or file
  58
  59       - the total size in kilobyte blocks of the partition
  60         that stores the named volume
  61
  62       - the   number   of  kilobyte  blocks  used  on  the
  63         partition
  64
  65       - the number of kilobyte  blocks  available  on  the
  66
  67
  68
  69         partition
  70
  71       - the percentage of the partition's total space used
  72
  73 EXAMPLES
  74
  75    The following shows the output for the partition housing the
  76    volume user.smith in the Transarc Corporation cell:
  77
  78        % fs df /afs/transarc.com/usr/smith
  79        Volume Name    kbytes  used     avail     %used
  80        user.smith     333305  286710   46595       86%
  81
  82 PRIVILEGE REQUIRED
  83
  84    None.
  85
  86 MORE INFORMATION
  87
  88    fs examine