warnquota.conf(5)
NAME
warnquota.conf - configuration for warnquota
SYNOPSIS
/etc/warnquota.conf
DESCRIPTION
The warnquota.conf file stores a configuration for warnquota(8) tool
which is used to notify a user or a group who exceeds its disk quota
limits.
The syntax is an option name followed by an equal sign and the option
value. White space characters surrounding the option names and values
are allowed.
Empty lines or lines starting with a hash sign or a semicolon are
ignored.
An option value can but does not have to be quoted. The value can span
across multiple lines provided each previous line ends with a
backslash.
Some option values can contain formatting sequences which will be
expanded to their respective values. Following sequences are
recognized:
%d domain name
%h host name
%i, %s user or group name
%% literal % character
| new-line character
OPTIONS
CC_BEFORE Send to copy-carbon address only when a user has
less than specified grace time left. Value is a
number followed by a time unit. Known units are
seconds, minutes, hours, and days. Example: 5 days
CC_TO An e-mail address to put into copy-carbon (CC:)
recipient header. Default value is root.
CHARSET Defines character set for sent e-mails. Default
value will be current locale character set used
when executing warnquota command, if locale is not
either C or POSIX. Otherwise no character set will
be specified in the e-mails.
FROM Defines From: e-email address. Default value is
support@localhost.
GROUP_MESSAGE A text sent as an e-mail body if a group exceeds
its limits. This option recognizes formatting
sequences.
GROUP_SIGNATURE A signature text appended to notification for a
group. Default value is a general explanation
utilizing SUPPORT and PHONE values. This option
recognizes formatting sequences.
LDAP_BASEDN Base distinguished name for LDAP queries.
LDAP_BINDDN Bind distinguished name for LDAP queries.
LDAP_BINDPW Bind password for LDAP queries.
LDAP_DEFAULT_MAIL_DOMAIN
Default e-mail address domain of searched user if
given LDAP attribute does not specify any.
LDAP_HOST LDAP server name to connect to if LDAP_URI is not
defined.
LDAP_MAIL A boolean controlling if LDAP has to be used to
look up user's e-mail address. Possible values are
true and false. Default value is false.
LDAP_MAIL_ATTRIBUTE The LDAP attribute which holds user's e-mail
address.
LDAP_PORT LDAP server port number to connect to if LDAP_URI
is not defined.
LDAP_SEARCH_ATTRIBUTE
The LDAP attribute which holds user's ID to look
up.
LDAP_URI The URL of LDAP server to use to search user's e-
mail addresses. This option takes preference over
LDAP_HOST and LDAP_PORT. Example:
ldaps://example.com:389/
MESSAGE A beginning of text sent as an e-mail body if a
user exceeds his limits. This option recognizes
formatting sequences.
MAIL_CMD The command to execute to send an e-mail. The e-
mail text including all headers is passed to the
standard input of the command. Default value is
/usr/lib/sendmail -t.
MAILDEV The device with disk quotas to exclude from sending
notifications if there are exceeded limits. This
option should identify the device where mail boxes
are stored to prevent from bouncing the warnquota
notification by local MDA due to no space for
storing new e-mails. Special value any denotes all
devices.
PHONE The telephone contact to the user support. Default
value is (xxx) xxx-xxxx or (yyy) yyy-yyyy.
SIGNATURE The end of e-mail body if a user exceeds its
limits. Default value is a general explanation
utilizing SUPPORT and PHONE values. This option
recognizes formatting sequences.
SUBJECT The text to put into Subject: header. Default value
is Disk Quota usage on system.
SUPPORT The contact to the user support. Default value is
support@localhost.
EXAMPLE
# comment
FROM = root@example.com
SUPPORT = support@example.com
PHONE = 1234
FILES
/etc/warnquota.conf configuration for warnquota(8)
SEE ALSO
warnquota(8).
WARNQUOTA.CONF(5)
Free and Open Source Software