1WARNQUOTA.CONF(5) File Formats Manual WARNQUOTA.CONF(5)
2
6 warnquota.conf - configuration for warnquota
7
9 /etc/warnquota.conf
10
12 The warnquota.conf file stores a configuration for warnquota(8) tool
13 which is used to notify a user or a group who exceeds its disk quota
14 limits.
15 The syntax is an option name followed by an equal sign and the option
17 value. White space characters surrounding the option names and values
18 are allowed.
19 Empty lines or lines starting with a hash sign or a semicolon are
21 ignored.
22 An option value can but does not have to be quoted. The value can span
24 across multiple lines provided each previous line ends with a back‐
25 slash.
26 Some option values can contain formatting sequences which will be
28 expanded to their respective values. Following sequences are recog‐
29 nized:
30 %d domain name
32 %h host name
33 %i, %s user or group name
34 %% literal % character
35 | new-line character
36
38 CC_BEFORE Send to copy-carbon address only when a user has
39 less than specified grace time left. Value is a
40 number followed by a time unit. Known units are
41 seconds, minutes, hours, and days. Example: 5 days
42 CC_TO An e-mail address to put into copy-carbon (CC:)
43 recipient header. Default value is root.
44 CHARSET Defines character set for sent e-mails. Default
45 value will be current locale character set used
46 when executing warnquota command, if locale is not
47 either C or POSIX. Otherwise no character set will
48 be specified in the e-mails.
49 FROM Defines From: e-email address. Default value is
50 support@localhost.
51 GROUP_MESSAGE A text sent as an e-mail body if a group exceeds
52 its limits. This option recognizes formatting
53 sequences.
54 GROUP_SIGNATURE A signature text appended to notification for a
55 group. Default value is a general explanation uti‐
56 lizing SUPPORT and PHONE values. This option recog‐
57 nizes formatting sequences.
58 LDAP_BASEDN Base distinguished name for LDAP queries.
59 LDAP_BINDDN Bind distinguished name for LDAP queries.
60 LDAP_BINDPW Bind password for LDAP queries.
61 LDAP_DEFAULT_MAIL_DOMAIN
62 Default e-mail address domain of searched user if
63 given LDAP attribute does not specify any.
64 LDAP_HOST LDAP server name to connect to if LDAP_URI is not
65 defined.
66 LDAP_MAIL A boolean controlling if LDAP has to be used to
67 look up user's e-mail address. Possible values are
68 true and false. Default value is false.
69 LDAP_MAIL_ATTRIBUTE The LDAP attribute which holds user's e-mail
70 address.
71 LDAP_PORT LDAP server port number to connect to if LDAP_URI
72 is not defined.
73 LDAP_SEARCH_ATTRIBUTE
74 The LDAP attribute which holds user's ID to look
75 up.
76 LDAP_URI The URL of LDAP server to use to search user's e-
77 mail addresses. This option takes preference over
78 LDAP_HOST and LDAP_PORT. Example: ldaps://exam‐
79 ple.com:389/
80 MESSAGE A beginning of text sent as an e-mail body if a
81 user exceeds his limits. This option recognizes
82 formatting sequences.
83 MAIL_CMD The command to execute to send an e-mail. The e-
84 mail text including all headers is passed to the
85 standard input of the command. Default value is
86 /usr/lib/sendmail -t.
87 MAILDEV The device with disk quotas to exclude from sending
88 notifications if there are exceeded limits. This
89 option should identify the device where mail boxes
90 are stored to prevent from bouncing the warnquota
91 notification by local MDA due to no space for stor‐
92 ing new e-mails. Special value any denotes all
93 devices.
94 PHONE The telephone contact to the user support. Default
95 value is (xxx) xxx-xxxx or (yyy) yyy-yyyy.
96 SIGNATURE The end of e-mail body if a user exceeds its lim‐
97 its. Default value is a general explanation utiliz‐
98 ing SUPPORT and PHONE values. This option recog‐
99 nizes formatting sequences.
100 SUBJECT The text to put into Subject: header. Default value
101 is Disk Quota usage on system.
102 SUPPORT The contact to the user support. Default value is
103 support@localhost.
105 # comment
106 FROM = root@example.com
107 SUPPORT = support@example.com
108 PHONE = 1234
110 /etc/warnquota.conf configuration for warnquota(8)
111
113 warnquota(8).
114 WARNQUOTA.CONF(5)