.TH WARNQUOTA.CONF 5
.SH "نام (NAME)"
warnquota.conf \- پیکربندی برای warnquota
.SH "خلاصه دستور (SYNOPSIS)"
.B /etc/warnquota.conf
.SH "توضیحات (DESCRIPTION)"
فایل
.B warnquota.conf
پیکربندی ابزار
.BR warnquota (8)
را ذخیره می‌کند که برای آگاه‌سازی کاربر یا گروهی که از محدودیت‌های سهمیه دیسک (quota) فراتر رفته‌اند، استفاده می‌شود.
.P
نحو نگارش، نام گزینه به همراه علامت مساوی و سپس مقدار گزینه است.
استفاده از نویسه‌های فاصله (White space) در دو طرف نام گزینه‌ها و مقادیر مجاز است.
.P
خطوط خالی یا خطوطی که با علامت هش (#) یا نقطه-ویرگول (;) شروع می‌شوند نادیده گرفته می‌شوند.
.P
مقدار گزینه می‌تواند داخل علامت نقل‌قول باشد، هرچند الزامی نیست. مقدار می‌تواند در صورت قرار گرفتن نویسه بک‌اسلش (\\) در انتهای هر خط، چند خط امتداد یابد.
.P
برخی از مقادیر گزینه‌ها می‌توانند شامل توالی‌های قالب‌بندی باشند که با مقادیر متناظرشان جایگزین می‌شوند. توالی‌های زیر شناخته‌شده هستند:
.P
.PD 0
.TP 20
.B %d
نام دامنه (domain name)
.TP
.B %h
نام میزبان (host name)
.TP
.BR "%i" ", " "%s"
نام کاربر یا گروه
.TP
.B %%
نویسه واقعی %
.TP
.B |
نویسه خط جدید (new-line)
.PD
.SH "گزینه‌ها (OPTIONS)"
.PD 0
.TP 20
.B CC_BEFORE
تنها زمانی به نشانی رونوشت (CC) ارسال شود که مهلت ارفاقی (grace time) کاربر کمتر از زمان مشخص‌شده باشد. مقدار، یک عدد به همراه واحد زمان است. واحدهای شناخته‌شده عبارتند از
.IR seconds ،
.IR minutes ،
.IR hours " و"
.IR days .
مثال:
.I 5 days
.TP
.B CC_TO
نشانی رایانامه‌ای که در سرآیند گیرنده رونوشت (:CC) قرار می‌گیرد. مقدار پیش‌فرض
.IR root
است.
.TP
.B CHARSET
مجموعه نویسه (character set) رایانامه‌های ارسالی را مشخص می‌کند. اگر محلی‌سازی (locale) برابر با
.I C
یا
.I POSIX
نباشد، مقدار پیش‌فرض برابر با مجموعه نویسه محلی کنونی در زمان اجرای دستور warnquota خواهد بود.
در غیر این صورت هیچ مجموعه نویسه‌ای در رایانامه‌ها مشخص نخواهد شد.
.TP
.B FROM
نشانی رایانامه :From را مشخص می‌کند. مقدار پیش‌فرض
.IR "support@localhost"
است.
.TP
.B GROUP_MESSAGE
متنی که به عنوان متن اصلی رایانامه در صورت فراتر رفتن یک گروه از محدودیت‌هایش ارسال می‌شود. این گزینه توالی‌های قالب‌بندی را می‌شناسد.
.TP
.B GROUP_SIGNATURE
متن امضا که به انتهای اعلان هشدار برای گروه الصاق می‌شود. مقدار پیش‌فرض توضیحی کلی است که از مقادیر
.B SUPPORT
و
.B PHONE
بهره می‌برد. این گزینه توالی‌های قالب‌بندی را می‌شناسد.
.TP
.B LDAP_BASEDN
نام متمایز پایه (Base DN) برای پرس‌وجوهای LDAP.
.TP
.B LDAP_BINDDN
نام متمایز اتصال (Bind DN) برای پرس‌وجوهای LDAP.
.TP
.B LDAP_BINDPW
گذرواژه اتصال (Bind password) برای پرس‌وجوهای LDAP.
.TP
.B LDAP_DEFAULT_MAIL_DOMAIN
دامنه پیش‌فرض نشانی رایانامه برای کاربر جستجوشده در صورتی که ویژگی LDAP مشخص‌شده هیچ دامنه‌ای تعیین نکرده باشد.
.TP
.B LDAP_HOST
نام کارگزار LDAP برای اتصال، در صورتی که
.B LDAP_URI
تعریف نشده باشد.
.TP
.B LDAP_MAIL
یک مقدار بولی که مشخص می‌کند آیا باید از LDAP برای یافتن نشانی رایانامه کاربر استفاده شود یا خیر. مقادیر ممکن عبارتند از
.I true
و
.IR false .
مقدار پیش‌فرض
.IR false
است.
.TP
.B LDAP_MAIL_ATTRIBUTE
ویژگی LDAP که نشانی رایانامه کاربر را نگهداری می‌کند.
.TP
.B LDAP_PORT
شماره پورت کارگزار LDAP برای اتصال، در صورتی که
.B LDAP_URI
تعریف نشده باشد.
.TP
.B LDAP_SEARCH_ATTRIBUTE
ویژگی LDAP که شناسه کاربر (ID) را جهت جستجو نگهداری می‌کند.
.TP
.B LDAP_URI
نشانی URL کارگزار LDAP جهت استفاده برای جستجوی نشانی‌های رایانامه کاربران. این گزینه بر
.B LDAP_HOST
و
.B LDAP_PORT
اولویت دارد.
مثال:
.I ldaps://example.com:389/
.TP
.B MESSAGE
آغاز متن ارسال‌شده به عنوان بدنه رایانامه در صورتی که کاربری از محدودیت‌هایش فراتر رود. این گزینه توالی‌های قالب‌بندی را می‌شناسد.
.TP
.B MAIL_CMD
دستوری که برای ارسال رایانامه اجرا می‌شود. متن رایانامه شامل تمامی سرآیندها به ورودی استاندارد دستور پاس داده می‌شود. مقدار پیش‌فرض
.IR "/usr/lib/sendmail -t"
است.
.TP
.B MAILDEV
دستگاه دارای سهمیه دیسک که در صورت عبور از محدودیت‌ها، باید از ارسال اعلان‌ها مستثنی شود. این گزینه باید دستگاهی را مشخص کند که صندوق‌های پستی در آن ذخیره می‌شوند تا از برگشت خوردن اعلان warnquota توسط MDA محلی به دلیل کمبود فضا برای ذخیره رایانامه‌های جدید جلوگیری شود. مقدار ویژه
.I any
بیانگر تمامی دستگاه‌ها است.
.TP
.B PHONE
شماره تلفن تماس با پشتیبانی کاربران. مقدار پیش‌فرض
.IR "(xxx) xxx-xxxx or (yyy) yyy-yyyy"
است.
.TP
.B SIGNATURE
انتهای بدنه رایانامه در صورتی که کاربری از محدودیت‌هایش فراتر رود. مقدار پیش‌فرض توضیحی کلی است که از مقادیر
.B SUPPORT
و
.B PHONE
استفاده می‌کند. این گزینه توالی‌های قالب‌بندی را می‌شناسد.
.TP
.B SUBJECT
متنی که در سرآیند :Subject قرار می‌گیرد. مقدار پیش‌فرض
.IR "Disk Quota usage on system"
است.
.TP
.B SUPPORT
اطلاعات تماس با پشتیبانی کاربران. مقدار پیش‌فرض
.IR "support@localhost"
است.
.SH "مثال (EXAMPLE)"
.PP
# comment
.RS 0
FROM = root@example.com
.RS 0
SUPPORT = support@example.com
.RS 0
PHONE = 1234
.SH "فایل‌ها (FILES)"
.PD 0
.TP 20
.B /etc/warnquota.conf
پیکربندی برای
.BR warnquota (8)
.PD
.SH "همچنین ببینید (SEE ALSO)"
.BR warnquota (8).