WARNQUOTA.CONF(5)						File Formats Manual						 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  val-
       ues 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 back-
       slash.

       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 warn-
			   quota 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)