WARNQUOTA(8)               System Manager's Manual              WARNQUOTA(8)

NAME         top

       warnquota - send mail to users over quota

SYNOPSIS         top

       warnquota [ -ugsid ] [ -F quotaformat ] [ -q quotatab ] [ -c
       configfile ] [ -a adminsfile ] [ filesystem...  ]

DESCRIPTION         top

       warnquota checks the disk quota for specified local filesystems (or
       for each local filesystem if none specified) and mails a warning
       message to those users who have reached their softlimit.  It is
       typically run via cron(8).

       -F, --format=quotaformat
              Perform setting for specified format (ie. don't perform format
              autodetection).  Possible format names are: vfsold Original
              quota format with 16-bit UIDs / GIDs, vfsv0 Quota format with
              32-bit UIDs / GIDs, 64-bit space usage, 32-bit inode usage and
              limits, vfsv1 Quota format with 64-bit quota limits and usage,
              xfs Quota on XFS filesystem.

       -q, --quota-tab=quotatab
              Use quotatab instead of /etc/quotatab as file with device
              description strings (see quotatab(5) for syntax).

       -c, --config=configfile
              Use configfile instead of /etc/warnquota.conf as configuration
              file (see warnquota.conf(5) for syntax).

       -a, --admins-file=adminsfile
              Use adminsfile instead of /etc/quotagrpadmins as a file with
              administrators of the groups (see quotagrpadmins(5) for

       -u, --user
              check whether users are not exceeding quotas (default).

       -g, --group
              check whether groups are not exceeding quotas. If group is
              exceeding quota a mail is sent to the user specified in

       -s, --human-readable[=units]
              Try to report used space, number of used inodes and limits in
              more appropriate units than the default ones. Units can be
              also specified explicitely by an optional argument in format [
              kgt ],[ kgt ] where the first character specifies space units
              and the second character specifies inode units.

       -i, --no-autofs
              ignore mountpoints mounted by automounter.

       -d, --no-details
              do not attach quota report in email.

FILES         top

       aquota.user         quota file at the filesystem root (version 2
                           quota, non-XFS filesystems)
       quota.user          quota file at the filesystem root (version 1
                           quota, non-XFS filesystems)
       /etc/warnquota.conf configuration file
       /etc/quotatab       device description
       /etc/quotagrpadmins administrators of the groups
       /etc/mtab           default filesystems
       /etc/passwd         default set of users

SEE ALSO         top

       quota(1), quotatab(5), quotagrpadmins(5), warnquota.conf(5), cron(8),

AUTHORS         top

       warnquota(8) was written by Marco van Wieringen
       <>, modifications by Jan Kara <>.
       This reference page written by Heiko Schlittermann
       <>, modifications by Jan Kara

COLOPHON         top

       This page is part of the quota (Linux Diskquota Tools) project.
       Information about the project can be found at [unknown -- if you
       know, please contact] It is not known how to
       report bugs for this man page; if you know, please send a mail to  This page was obtained from the project's
       upstream Git repository
       ⟨git://⟩ on
       2018-02-02.  (At that time, the date of the most recent commit that
       was found in the repository was 2018-01-10.)  If you discover any
       rendering problems in this HTML version of the page, or you believe
       there is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to


Pages that refer to this page: quota(1)quotasync(1)quotagrpadmins(5)quotatab(5)warnquota.conf(5)quotaon(8)repquota(8)warnquota(8)xfs_quota(8)