Back to files

===========================

==== quotatool ====

---

---

Quick Start

./configure
make
su -c "make install"

Usage

quotatool [options ... filesystem
quotatool -u | -g -t time -i | -r filesystem

The actual arguments accepted depends on your system. Solaris, for example, doesn't support group quotas, so the -g option is useless. If your getopt() doesn't support optional arguments, then you always need to pass an argument to -u and -g.

Options

   -b      set block limits
   -i      set inode limits

-q n set soft limit to n blocks/inodes -l n set hard limit to n blocks/inodes

quotatool accepts the units Mb, Kb, bytes and blocks to modify limit arguments. See examples below.

   -t      time set global grace period to time.
           The time parameter consists of an optional
           '+' or '-' modifier, a  number, and one of: 
           'sec', 'min', 'hour', 'day', 'week', and 
           'month'.  If a +/- modifier is present, the
           current quota will be increased/reduced by
           the amount specified

   -r      restart grace period for uid or gid

   -h      print a usage message

   -v      verbose mode -- print status messages during execution
           use this twice for even more information

   -n      do everything except set the quota.  useful with -v
           to see what is supposed to happen

   -V      show version

Examples

Set soft block limit to 15MB, hard block limit to 20MB for user mpg4 on /home:

quotatool -u mpg4 -bq 15M -l "20 Mb" /home

Set hard inode limit to 2000 for user johan on /var:

quotatool -u johan -i -l 2000 /var

Set the global block grace period to one week on /home:

quotatool -u -b -t "1 week" /home

Restart inode grace period for user johan on root filesystem:

quotatool -u johan -i -r /

Notes

Grace periods are set on a "global per quotatype and filesystem" basis only. Each quotatype (usrquota / grpquota) on each filesystem has two grace periods - one for block limits and one for inode limits. It is not possible to set different grace periods for users on the same filesystem.

Platforms and Filesystems

quotatool currently builds and works well on: -- Linux --
Both old and new quota formats.
ext2, ext3, ReiserFS and XFS supported

-- Solaris --

-- AIX --

Missing your favorite *nix OS? Check the ChangeLog for the latest additions, or port it yourself and send us a patch!