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
              Try to report used space, number of used inodes and limits in
              more appropriate units than the default ones.

       -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
       2017-03-13.  If you discover any rendering problems in this HTML ver‐
       sion 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 man‐
       ual page), send a mail to