src/man/fs_setquota.1

   1 fs setquota                AFS Commands             fs setquota
   2
   3
   4 NAME
   5
   6    fs  setquota -- sets  maximum  quota  for volume containing
   7
   8                        specified directory.
   9
  10
  11    fs setquota  [-path <dir/file path>]  -max <max quota in
  12    kbytes>  [-help]
  13
  14 ACCEPTABLE ABBREVIATIONS/ALIASES
  15
  16    fs sq  [-p <dir/file path>]  -m <max quota in kbytes>  [-h]
  17
  18 DESCRIPTION
  19
  20    Sets the maximum size quota for the volume that contains the
  21    specified  directory  or  file.    The  fs  examine  and  fs
  22    listquota commands show the current maximum quota.   The  fs
  23    quota command shows the percent of maximum quota used.
  24
  25    The  fs  setvol  command  can  be  used  to set the quota on
  26    multiple volumes at once.  It can also  be  used  to  create
  27    messages associated with the volumes.
  28
  29 ARGUMENTS
  30
  31    -path           names  the directory or file for which quota
  32                    on the host volume is to be set.    If  this
  33                    argument  is  omitted,  the  current working
  34                    directory is used; in this  case,  the  -max
  35                    switch must be used.
  36
  37    -max            specifies  the  maximum amount of disk space
  38                    the volume can use.  Express it in  kilobyte
  39                    blocks (a value of 1024 is one megabyte).  A
  40                    value of 0 grants an  unlimited  quota,  but
  41                    the  size  of the disk partition that houses
  42                    the volume places an absolute limit  on  the
  43                    volume's maximum size.
  44
  45    -help           prints   the  online  help  entry  for  this
  46                    command.  Do not provide any other arguments
  47                    or  flags with this one.  See section 3.1 in
  48                    the Reference Manual for more details.
  49
  50 EXAMPLES
  51
  52    The following imposes a maximum quota of 3000  kilobytes  on
  53    the      volume      that      houses      the     directory
  54    /afs/transarc.com/usr/smith:
  55
  56    % fs sq /afs/transarc.com/usr/smith 3000
  57
  58 PRIVILEGE REQUIRED
  59
  60    Issuer must belong to the system:administrators group in the
  61    Protection Database.
  62
  63 MORE INFORMATION
  64
  65
  66
  67    fs examine
  68
  69    fs listquota
  70
  71    fs quota
  72
  73    fs setvol