Ubuntu Manpage: warnquota.conf - configuration for warnquota

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