.TH POSTFIX-LOGWATCH 1 .ad .fi .SH "نام (NAME)" postfix-logwatch \- ابزار تجزیه و تحلیل لاگ‌های Postfix .SH "خلاصه دستور (SYNOPSIS)" .na .nf .fi \fBpostfix-logwatch\fR [\fIoptions\fR] [\fIlogfile ...\fR] .SH "توضیحات (DESCRIPTION)" .ad .fi ابزار \fBpostfix-logwatch\fR(1) یک تجزیه‌گر لاگ MTA برای Postfix است که خلاصه‌ها، جزئیات و آمارهایی در رابطه با عملکرد Postfix تولید می‌کند. .PP این ابزار می‌تواند به عنوان یک برنامه مستقل، یا به عنوان یک پودمان فیلتر Logwatch برای ایجاد گزارش‌های خلاصه و تفصیلی Postfix از درون Logwatch به کار رود. .PP \fBPostfix-logwatch\fR قادر است طیف گسترده‌ای از گزارش‌ها را همراه با داده‌هایی که تا حد امکان گروه‌بندی و مرتب شده‌اند تولید کند تا نویز کاهش یافته و الگوها برجسته شوند. گزارش‌های خلاصه، نمای کلی و سریعی از عملیات عمومی Postfix و تحویل پیام‌ها ارائه داده و هشدارهایی که ممکن است نیازمند توجه باشند را گوشزد می‌کنند. گزارش‌های تفصیلی اطلاعاتی سازمان‌یافته، مرتب‌شده به صورت سلسله‌مراتبی و با امکان پیمایش سریع را با هر میزانی از جزئیات که نیاز باشد ارائه می‌دهند. .PP \fBPostfix-logwatch\fR دو بخش اصلی را در خروجی نمایش می‌دهد: بخش \fBSummary\fR (خلاصه) و بخش \fBDetailed\fR (تفصیلی). برای خوانایی و بررسی سریع، تعداد تمامی رویدادها یا دفعات وقوع در ستون سمت چپ نمایش می‌یابد، به دنبال آن توضیح کوتاهی از نوع رویداد می‌آید و در نهایت آمار تکمیلی یا نمایش‌های تعدادی ممکن است در ستون سمت راست ظاهر شوند. بخش زیر نمونه‌ای از یک گزارش Summary را نشان می‌دهد: .RS 4 .nf ****** Summary ******************************************** 81 *Warning: Connection rate limit reached (anvil) 146 Warned 68.310M Bytes accepted 71,628,177 97.645M Bytes delivered 102,388,245 ======== ================================================ 3464 Accepted 41.44% 4895 Rejected 58.56% -------- ------------------------------------------------ 8359 Total 100.00% ======== ================================================ .fi .RE 0 این گزارش هشدار می‌دهد که محدودیت نرخ اتصال سرویس anvil به تعداد ۸۱ بار لمس شده است، اقدام هشداری WARN در بررسی دسترسی Postfix به تعداد ۱۴۶ بار ثبت شده، و در مجموع ۶۸٫۳۱۰ مگابایت (۷۱٬۶۲۸٬۱۷۷ بایت) وارد سامانه Postfix شده که ۹۷٫۶۴۵ مگابایت داده تحویل داده است (به دلیل وجود چندین گیرنده). خطوط Accepted و Rejected نشان می‌دهند که Postfix تعداد ۳۴۶۴ پیام (۴۱٫۴۴٪ از کل پیام‌ها) را پذیرفته و ۴۸۹۵ پیام (۵۸٫۵۶٪ باقی‌مانده) از مجموع ۸۳۵۹ پیام را رد کرده است (ردشدن‌های موقت در جاهای دیگر نمایش داده می‌شوند). .PP ده‌ها زیربخش در گزارش \fBDetailed\fR در دسترس هستند که خروجی هر یک را می‌توان به روش‌های گوناگونی کنترل کرد. هر زیربخش تلاش می‌کند داده‌های پرمعناتر را در سطوح بالاتر گروه‌بندی کرده و ارائه دهد، در حالی که داده‌های کم‌اهمیت‌تر یا دارای نویز (\fInoisy\fR) را به سطوح پایین‌تر سوق می‌دهد. هدف، بهره‌مندی حداکثری از گروه‌بندی هوشمندانه داده‌ها است تا بررسی سریع‌تر گزارش، شناسایی الگوها و حل مشکلات میسر شود. داده‌ها همواره به ترتیب نزولی بر اساس تعداد، و سپس به صورت عددی بر اساس آدرس IP یا به ترتیب حروف الفبا بر حسب مورد مرتب می‌شوند. .PP بخش خطاهای MX زیر از یک نمونه گزارش \fBDetailed\fR ساختار پایه سطوح سلسله‌مراتبی \fBpostfix-logwatch\fR را نشان می‌دهد: .RS 4 .nf ****** Detailed ******************************************* 261 MX errors -------------------------------------- 261 Unable to look up MX host 222 Host not found 73 foolishspammer.local 60 completely.bogus.domain.example 11 friend.example.com 39 No address associated with hostname 23 dummymx.sample.net 16 pushn.spam.sample.com .fi .RE 0 .PP ابزار \fBpostfix-logwatch\fR داده‌ها را از STDIN یا از \fIlogfile\fR مشخص‌شده Postfix می‌خواند. می‌توان چندین آرگومان \fIlogfile\fR را تعیین کرد که هر کدام به ترتیب پردازش می‌شوند. کاربری که \fBpostfix-logwatch\fR را اجرا می‌کند باید مجوز خواندن بر روی هر فایل لاگ تعیین‌شده را داشته باشد. .PP.SS "گزینه‌ها (Options)" گزینه‌های ذکر شده در زیر بر عملکرد \fBpostfix-logwatch\fR تأثیر می‌گذارند. گزینه‌هایی که بعداً در خط فرمان مشخص شوند، بر گزینه‌های قبلی اولویت داشته و جایگزین آن‌ها می‌شوند. هر گزینه‌ای را می‌توان تا حدی که غیرمبهم باشد خلاصه کرد. .IP "\fB-f \fIconfig_file\fR" .PD 0 .IP "\fB--config_file \fIconfig_file\fR" .PD استفاده از فایل پیکربندی جایگزین \fIconfig_file\fR به جای پیش‌فرض. این گزینه را می‌توان بیش از یک بار استفاده کرد. چندین فایل پیکربندی به ترتیبی که در خط فرمان مشخص شده‌اند، پردازش خواهند شد. بخش \fBCONFIGURATION FILE\fR را در زیر ببینید. .IP "\fB--debug \fIkeywords\fR" خروجی دادن اطلاعات اشکال‌زدایی حین اجرای \fBpostfix-logwatch\fR. پارامتر \fIkeywords\fR شامل یک یا چند کلیدواژه است که با کاما یا فاصله از هم جدا شده‌اند. برای دریافت فهرست کلیدواژه‌های معتبر، از --debug xxx استفاده کنید که در آن xxx هر کلیدواژهٔ نامعتبری است. .IP "\fB--[no]delays\fR" خروجی گزارش صدک‌های تأخیر پیام را فعال (غیرفعال) می‌کند. گزارش صدک‌های تأخیر، صدک‌ها را برای هر یک از ۴ زمان تأخیر تحویل گزارش‌شده توسط Postfix (موجود در نگارش ۲.۳ و جدیدتر) در قالب \fBdelays=\fIa\fR/\fIb\fR/\fIc\fR/\fId\fR نمایش می‌دهد، که در آن: \fIa\fR مقدار زمان قبل از صف فعال (شامل زمان تلاش‌های تحویل قبلی و زمان سپری‌شده در صف تعویق‌افتاده)، \fIb\fR مقدار زمان در صف فعال تا واگذاری به کارگزار تحویل، \fIc\fR مقدار زمان صرف‌شده برای برقراری اتصالات (شامل DNS، HELO و TLS) و \fId\fR مقدار زمان صرف‌شده برای تحویل پیام است. کل تأخیر نمایش‌داده‌شده از فیلد \fBdelay=\fR در یک خط لاگ تحویل پیام به دست می‌آید. \fBنکته:\fR این گزارش ممکن است مقدار زیادی از حافظه را مصرف کند؛ اگر به آن نیازی ندارید، گزارش تأخیرها را غیرفعال کنید. .IP "\fB--delays_percentiles \fIp1 [p2 ...]\fR" صدک‌های مورد استفاده در گزارش صدک‌های تأخیر پیام را مشخص می‌کند. صدک‌های \fIp1\fR، \fIp2\fR، \fI...\fR در بازهٔ ۰ تا ۱۰۰ (شامل خود آن‌ها) قرار دارند. ترتیب فهرست مرتب‌سازی نمی‌شود - گزارش ستون‌های صدک‌ها را به همان ترتیبی که مشخص کرده‌اید خروجی می‌دهد. .IP "\fB--detail \fIlevel\fR" حداکثر سطح جزئیات را برای \fBpostfix-logwatch\fR روی \fIlevel\fR تنظیم می‌کند. این گزینه سراسری بوده و بر تمام محدودکننده‌های خروجی دیگری که در زیر توضیح داده شده‌اند اولویت دارد. ابزار \fBpostfix-logwatch\fR یک بخش \fBSummary\fR، یک بخش \fBDetailed\fR و بخش‌های گزارش اضافی تولید می‌کند. اگر مقدار \fIlevel\fR کمتر از ۵ باشد، \fBpostfix-logwatch\fR فقط بخش \fBSummary\fR را تولید می‌کند. در \fIlevel\fR ۵ و بالاتر، بخش \fBDetailed\fR و هر بخش گزارش اضافی کاندیدای خروجی هستند. هر افزایش تدریجی در \fIlevel\fR، یک زیرسطح سلسله‌مراتبی دیگر از خروجی را در بخش \fBDetailed\fR گزارش تولید می‌کند. در \fIlevel\fR ۱۰، همهٔ سطوح خروجی داده می‌شوند. خطوطی که از حداکثر عرض گزارش (مشخص‌شده با \fBmax_report_width\fR) فراتر روند، بریده خواهند شد. تنظیم \fIlevel\fR روی ۱۱ از بریده شدن خطوط در گزارش جلوگیری می‌کند (همچنین \fB--line_style\fR را ببینید). .IP "\fB--help\fR" چاپ اطلاعات نحوه استفاده و شرح مختصری از گزینه‌های خط فرمان. .IP "\fB--ignore_service \fIpattern\fR" نادیده گرفتن خطوط لاگی که شامل نام سرویس postfix به صورت \fBpostfix/\fIservice\fR هستند. پارامتر \fIservice\fR یک عبارت باقاعده (regular expression) است. \fBنکته:\fR اگر در عبارت باقاعدهٔ خود از پرانتز استفاده می‌کنید، اطمینان حاصل کنید که غیرگروه‌بند (cloistering / non-capturing) باشند و نه ضبط‌کننده (capturing): از \fB(?:\fIpattern\fB)\fR به جای \fB(\fIpattern\fB)\fR استفاده کنید. .IP "\fB--ipaddr_width \fIwidth\fR" مشخص می‌کند که نشانی‌های IP در جفت‌های نشانی/نام میزبان (address/hostname) باید با عرض فیلد به اندازهٔ \fIwidth\fR نویسه چاپ شوند. افزایش مقدار پیش‌فرض می‌تواند برای سیستم‌هایی که از نشانی‌های طولانی IPv6 استفاده می‌کنند مفید باشد. .IP "\fB-l limiter=levelspec\fR" .PD 0 .IP "\fB--limit limiter=levelspec\fR" .PD محدودکنندهٔ سطح \fIlimiter\fR را با مشخصهٔ \fIlevelspec\fR تنظیم می‌کند. .IP "\fB--line_style \fIstyle\fR" نحوهٔ مدیریت خطوط طولانی گزارش را مشخص می‌کند. سه سبک در دسترس است: \fBfull\fR، \fBtruncate\fR و \fBwrap\fR. تنظیم \fIstyle\fR روی \fBfull\fR مانع از برش خطوط به اندازهٔ \fBmax_report_width\fR می‌شود؛ این همان وضعیتی است که با تعیین \fBdetail\fR برابر با ۱۱ یا بالاتر رخ می‌دهد. هنگامی که \fIstyle\fR روی \fBtruncate\fR (پیش‌فرض) باشد، خطوط طولانی بر اساس \fBmax_report_width\fR کوتاه می‌شوند. تنظیم \fIstyle\fR روی \fBwrap\fR خطوط طولانی‌تر از \fBmax_report_width\fR را به گونه‌ای می‌شکند که شمارنده‌های ستون چپ مخدوش نشوند. این گزینه بر سبک خطی که توسط سطح \fBdetail\fR تعیین می‌شود اولویت دارد. گزینه‌های \fB--full\fR، \fB--truncate\fR و \fB--wrap\fR مترادف هستند. .IP "\fB--[no]long_queue_ids\fR" تفسیر شناسه‌های صف طولانی (long queue IDs) را در لاگ‌های Postfix (نسخه ۲.۹ یا بالاتر) فعال (غیرفعال) می‌کند. .IP "\fB--nodetail\fR" بخش \fBDetailed\fR گزارش و تمام گزارش‌های تکمیلی را غیرفعال می‌کند. این گزینه سازوکار مناسبی را برای غیرفعال کردن سریع تمام بخش‌های ذیل گزارش \fBDetailed\fR فراهم می‌کند؛ جایی که گزینه‌های بعدی در خط فرمان می‌توانند یک یا چند بخش را برای ایجاد گزارش‌های خاص مجدداً فعال کنند. .IP "\fB--[no]summary\fR" .IP "\fB--show_summary\fR" نمایش بخش \fBSummary\fR گزارش را فعال (غیرفعال) می‌کند. متغیر postfix_Show_Summary در فایل پیکربندی استفاده می‌شود. .IP "\fB--recipient_delimiter \fIdelimiter\fR" تفکیک نشانی‌های تحویل ایمیل با استفاده از نویسهٔ جداکنندهٔ گیرنده \fIdelimiter\fR. این مقدار عموماً باید با \fBrecipient_delimiter\fR مشخص‌شده در فایل پارامترهای Postfix یعنی \fBmain.cf\fR، یا مقدار پیش‌فرض مشخص‌شده در خروجی \fBpostconf -d recipient_delimiter\fR مطابقت داشته باشد. این گزینه برای به دست آوردن آمار به تفکیک نام مستعار هنگامی که از یک جداکنندهٔ گیرنده برای تحویل ایمیل استفاده می‌شود بسیار مفید است. .IP "\fB--reject_reply_patterns \fIr1 [r2 ...]\fR" فهرست الگوهای پاسخ رد (reject reply patterns) مورد استفاده برای ایجاد گروه‌های رد را مشخص می‌کند. هر مدخل در فهرست \fIr1 [r2 ...]\fR باید یا یک کد پاسخ سه نویسه‌ای عبارت باقاعده به شکل [45][0-9.][0-9.] باشد، یا کلمهٔ "Warn". نقطه "." در عبارت باقاعده یک نقطهٔ عینی است که با هر زیرکد پاسخ رد مطابقت دارد؛ این نویسهٔ عام امکان ایجاد گروه‌های رد گسترده را فراهم می‌سازد. ترتیب فهرست حفظ می‌شود، بدین صورت که گزارش‌های رد با همان ترتیبی که در فهرست قرار دارند خروجی داده خواهند شد. کدهای پاسخ ردِ مشخص، بدون در نظر گرفتن ترتیب فهرست، نسبت به الگوهای عام اولویت خواهند داشت. فهرست پیش‌فرض "5.. 4.. Warn" است که سه گروه از ردها را ایجاد می‌کند: ردهای دائمی، شکست‌های رد موقت و هشدارهای رد (مانند warn_if_reject). این ویژگی به عنوان مثال امکان تمایز بین بسته‌شدن کانال انتقال 421 از خطاهای 45x (مانند 450 صندوق پستی در دسترس نیست، 451 خطاهای پردازش محلی، 452 فضای ذخیره‌سازی ناکافی) را فراهم می‌آورد. چنین گروه‌بندی‌ای با این فهرست پیکربندی می‌شود: "421 4.. 5.. Warn". برای اطلاعات بیشتر در مورد کدهای پاسخ، RFC 2821 را ببینید. همچنین بخش \fBCONFIGURATION FILE\fR را دربارهٔ استفاده از \fBreject_reply_patterns\fR در فایل پیکربندی ببینید. .IP "\fB--[no]sect_vars\fR" .PD 0 .IP "\fB--show_sect_vars \fIboolean\fR" .PD تکمیل عنوان هر بخش \fBDetailed\fR با نام محدودکنندهٔ سطح آن بخش را فعال (غیرفعال) می‌کند. نام نمایش‌داده‌شده، گزینهٔ خط فرمان (یا متغیر فایل پیکربندی) است که برای محدود کردن خروجی آن بخش استفاده می‌شود. . با توجه به تعداد زیاد محدودکننده‌های سطح موجود در \fBpostfix-logwatch\fR، این یک سازوکار مناسب برای تعیین دقیق این است که کدام محدودکنندهٔ سطح بر یک بخش تأثیر می‌گذارد. .IP "\fB--syslog_name \fInamepat\fR" نام سرویس syslog را که \fBpostfix-logwatch\fR برای تطبیق با خطوط syslog استفاده می‌کند مشخص می‌کند. فقط خطوط لاگی که نام سرویس آن‌ها با عبارت باقاعده پرل \fInamepat\fR مطابقت داشته باشد توسط \fBpostfix-logwatch\fR استفاده خواهند شد؛ تمام خطوط غیر منطبق بدون هشدار نادیده گرفته می‌شوند. این ویژگی زمانی مفید است که یک بستهٔ Postfix از پیش نصب‌شده از نامی به غیر از پیش‌فرض (\fBpostfix\fR) استفاده کند، یا زمانی که چندین نمونه از Postfix در حال استفاده هستند و گزارش‌گیری به تفکیک نمونه مورد نیاز باشد. الگوی \fInamepat\fR باید با پارامتر پیکربندی \fBsyslog_name\fR مشخص‌شده در فایل پارامترهای Postfix یعنی \fBmain.cf\fR، فایل کنترلی اصلی \fBmaster.cf\fR یا مقدار پیش‌فرض مشخص‌شده در خروجی \fBpostconf -d syslog_name\fR مطابقت داشته باشد. \fBنکته:\fR اگر در عبارت باقاعدهٔ خود از پرانتز استفاده می‌کنید، اطمینان حاصل کنید که غیرگروه‌بند (cloistering / non-capturing) باشند و نه ضبط‌کننده (capturing): از \fB(?:\fIpattern\fB)\fR به جای \fB(\fIpattern\fB)\fR استفاده کنید. .IP "\fB--[no]unknown\fR" .PD 0 .IP "\fB--show_unknown \fIboolean\fR" .PD نمایش نام 'unknown' تولیدشده توسط postfix را در جفت‌های قالب‌بندی‌شدهٔ IP/نام میزبان در گزارش‌های \fBDetailed\fR فعال (غیرفعال) می‌کند. پیش‌فرض: فعال. .IP "\fB--version\fR" چاپ اطلاعات نگارش \fBpostfix-logwatch\fR..SS "محدودکننده‌های سطح (Level Limiters)" .PP خروجی هر بخش در گزارش \fBDetailed\fR توسط یک محدودکننده سطح کنترل می‌شود. نام متغیر محدودکننده سطح زمانی که گزینه \fBsect_vars\fR تنظیم شده باشد نمایش داده خواهد شد. محدودکننده‌های سطح یا از طریق خط فرمان در حالت مستقل با گزینه \fB--limit \fIlimiter\fB=\fIlevelspec\fR تنظیم می‌شوند، یا از طریق متغیر فایل پیکربندی \fB$postfix_\fIlimiter\fB=\fIlevelspec\fR. هر محدودکننده نیازمند یک آرگومان \fIlevelspec\fR است که در ادامه در بخش \fBLEVEL CONTROL\fR شرح داده شده است. فهرست محدودکننده‌های سطح در زیر آورده شده است. چندین محدودکننده سطح وجود دارند که زیربخش‌های رد (reject) را کنترل می‌کنند (مانند \fBrejectbody\fR، \fBrejectsender\fR و غیره). از آنجا که فهرست گونه‌های رد تا زمان اجرا و پس از مشاهده \fBreject_reply_patterns\fR مشخص نیست، این محدودکننده‌های رد در زیر به صورت عمومی با پیشوند \fB###\fR نمایش داده شده‌اند. برای استفاده از یکی از این محدودکننده‌های رد، \fB###\fR را با یکی از کدهای پاسخ ردِ در حال اجرا جایگزین کنید، به طوری که هر نقطه با یک نویسه \fBx\fR جایگزین شود. به عنوان مثال، با استفاده از فهرست پیش‌فرض \fBreject_reply_patterns\fR به صورت "5.. 4.. Warn"، سه گونه از \fBrejectbody\fR معتبر خواهد بود: \fB--limit 5xxrejectbody\fR، \fB--limit 4xxrejectbody\fR و \fB--limit warnrejectbody\fR. برای راحتی، می‌توانید پیشوند \fB###\fR را به طور کامل حذف کرده و به جای آن از گزینه خالی \fBreject\fIXXX\fR استفاده کنید، و تمام گونه‌های محدودکننده سطح رد به طور خودکار بر اساس فهرست \fBreject_reply_patterns\fR تولید خواهند شد. برای مثال، بخش خط فرمان: .nf ... --reject_reply_patterns "421 5.." \\ --limit rejectrbl="1:10:" .fi به طور خودکار به صورت زیر تبدیل خواهد شد: .nf ... --reject_reply_patterns "421 5.." \\ --limit 421rejectrbl="1:10:" --limit 5xxrejectrbl="1:10:" .fi به \fBreject_reply_patterns\fR در بالا، و توضیحات درون فایل پیکربندی \fBpostfix-logwatch.conf\fR مراجعه کنید. .de TQ . br . ns . TP \\$1 .. [ این بخش هنوز کامل نشده است ] .PD 0 .IP "\fBAttrError" خطاها در دریافت داده‌های مشخصه (attribute) از سرویس. .IP "\fBBCCed" پیام‌هایی که کنش BCC را در access، header_checks یا body_checks فعال کرده‌اند. (شاخه آزمایشی postfix 2.6) .IP "\fBBounceLocal" .IP "\fBBounceRemote" برگشت‌های (bounces) محلی و دوردست. یک برگشت زمانی یک برگشت محلی در نظر گرفته می‌شود که رله یکی از موارد none، local، virtual، avcheck، maildrop یا 127.0.0.1 باشد. .IP "\fBByIpRejects" گروه‌بندی مجدد تمام گونه‌های رد دائمی (5xx) بر اساس آدرس IP میزبان کلاینت. .IP "\fBCommunicationError" خطاهای Postfix در برقراری ارتباط با یکی از سرویس‌های خود. .IP "\fBAnvil" محدودیت‌های نرخ یا همزمانی سرویس Anvil. .IP "\fBConnectionInbound" اتصالات برقرار شده با سرور \fBsmtpd\fR. .IP "\fBConnectionLostInbound" اتصالات قطع‌شده با سرور \fBsmtpd\fR. .IP "\fBConnectionLostOutbound" اتصالات قطع‌شده در حین ارتباطات \fBsmtp\fR با MTA دوردست. .IP "\fBConnectToFailure" شکست‌های گزارش‌شده توسط \fBsmtp\fR هنگام اتصال به MTA دوردست. .IP "\fBDatabaseGeneration" هشدارهای ثبت‌شده زمانی که فایل نگاشت پایگاه‌داده باینری نیازمند به‌روزرسانی \fBpostmap\fR از فایل منبع جدیدتر باشد. .IP "\fBDeferrals" .IP "\fBDeferred" به تعویق افتادن‌های تحویل پیام. یک پیام منفرد \fBdeferred\fR بارها دارای یک یا چند مورد \fBdeferrals\fR خواهد بود. .IP "\fBDeliverable" اعتبارسنجی آدرس نشان می‌دهد که آدرس گیرنده قابل‌تحویل است. .IP "\fBDelivered" تعداد پیام‌های تحویل داده شده به یک عامل تحویل مانند local یا virtual. .IP "\fBDiscarded" پیام‌هایی که کنش DISCARD را در access، header_checks یا body_checks فعال کرده‌اند. .IP "\fBDNSError" هر یک از خطاهای متعددی که در طول جستجوهای DNS رخ داده است. .IP "\fBEnvelopeSenderDomains" فهرست دامنه‌های فرستنده. (۲ سطح: دامنه فرستنده پاکت‌نامه، localpart) .IP "\fBEnvelopeSenders" فهرست فرستندگان پاکت‌نامه. (۱ سطح: فرستنده پاکت‌نامه) .IP "\fBError" پیام‌های خطای (\fBerror\fR) عمومی Postfix. .IP "\fBFatalConfigError" خطاهای پیکربندی مهلک در main.cf یا master.cf. .IP "\fBFatalError" پیام‌های مهلک (\fBfatal\fR) عمومی Postfix. .IP "\fBFiltered" پیام‌هایی که کنش FILTER را در access، header_checks یا body_checks فعال کرده‌اند. .IP "\fBForwarded" پیام‌های بازفرستاده شده توسط MDA از یک رده آدرس به رده دیگر (مانند local -> virtual). .IP "\fBHeloError" XXXXXXXXXXX .IP "\fBHold" پیام‌هایی که توسط postsuper به حالت تعلیق درآمدند، یا کنش HOLD را در access، header_checks یا body_checks فعال کرده‌اند. .IP "\fBHostnameValidationError" نام میزبان نامعتبر شناسایی شد. .IP "\fBHostnameVerification" جستجوی نام میزبان به IP همتا (یعنی سیستم دوردستی که به \fBsmtpd\fR متصل می‌شود) برنمی‌گردد. همچنین با نام DNS معکوس تأیید شده به جلو (FCRDNS) شناخته می‌شود. هنگامی که نام معکوس هیچ ورودی DNS ندارد، پیام «host not found, try again» گنجانده می‌شود؛ در غیر این صورت خیر (به عنوان مثال هنگامی که معکوس دارای آدرس IP دیگری است، اما نه آن آدرسی که Postfix انتظار دارد). .IP "\fBIllegalAddrSyntax" نحو غیرمجاز در آدرس ایمیل ارائه‌شده در طول گفتگوی MAIL FROM یا RCPT TO. .IP "\fBLdapError" هرگونه خطای LDAP در حین جستجوی LDAP. .IP "\fBMailerLoop" جستجوی MX برای یافتن بهترین کارگزار پست به منظور تحویل نامه منجر به ارسال به خودمان شود. .IP "\fBMapProblem" مشکل در جدول نگاشت access که نیازمند تصحیح است. .IP "\fBMessageWriteError" مواجه شدن Postfix با خطا هنگام تلاش برای ایجاد فایل پیام در دایرکتوری spool. .IP "\fBNumericHostname" نام میزبانی یافت شد که به جای حروف، عددی بود. .IP "\fBPanicError" پیام‌های وحشت‌زدگی (\fBpanic\fR) عمومی Postfix. .IP "\fBPixWorkaround" راه‌حل‌های موقتی برای اجتناب از «fixup»های SMTP در Cisco PIX دوردست فعال شدند. .IP "\fBPolicydWeight" خلاصه‌سازی نتایج policyweight/policydweight. .IP "\fBPolicySpf" خلاصه‌سازی نتایج PolicySPF. .IP "\fBPostgrey" خلاصه‌سازی نتایج Postgrey. .IP "\fBPostscreen" خلاصه‌سازی سرویس‌های postscreen و verify در نسخه 2.7. .IP "\fBDNSBLog" خلاصه‌سازی سرویس dnsblog در نسخه 2.7. .IP "\fBPrepended" پیام‌هایی که کنش PREPEND را در header_checks یا body_checks فعال کرده‌اند. .IP "\fBProcessExit" سرویس‌های Postfix که به طور غیرمنتظره خارج شده‌اند. .IP "\fBProcessLimit" یک سرویس Postfix به حداکثر تعداد مجاز فرایندها رسیده یا از آن فراتر رفته است. .IP "\fBQueueWriteError" مشکلات در نوشتن فایل صف Postfix. .IP "\fBRblError" خطاهای جستجو برای RBLها. .IP "\fBRedirected" پیام‌هایی که کنش REDIRECT را در access، header_checks یا body_checks فعال کرده‌اند. .IP "\fB###RejectBody" پیام‌هایی که کنش REJECT را در body_checks فعال کرده‌اند. .IP "\fB###RejectClient" پیام‌های رد شده توسط کنترل‌های دسترسی کلاینت (smtpd_client_restrictions). .IP "\fB###RejectConfigError" پیام‌های رد شده به دلیل خطاهای پیکربندی سرور. .IP "\fB###RejectContent" پیام‌های رد شده توسط message_reject_characters. .IP "\fB###RejectData" پیام‌های رد شده در مرحله DATA در گفتگوی SMTP (smtpd_data_restrictions). .IP "\fB###RejectEtrn" پیام‌های رد شده در مرحله ETRN در گفتگوی SMTP (smtpd_etrn_restrictions). .IP "\fB###RejectHeader" پیام‌هایی که کنش REJECT را در header_checks فعال کرده‌اند. .IP "\fB###RejectHelo" پیام‌های رد شده در مرحله HELO/EHLO در گفتگوی SMTP (smtpd_helo_restrictions). .IP "\fB###RejectInsufficientSpace" پیام‌های رد شده به دلیل کمبود فضای ذخیره‌سازی. .IP "\fB###RejectLookupFailure" پیام‌های رد شده به دلیل خطاهای موقت در جستجوی DNS. .IP "\fB###RejectMilter" ردهای Milter. هیچ کد پاسخ ردی برای این ردها موجود نیست، اما یک DSN گسترده 5.7.1 ارائه شده است. این ردها به اجبار در گروه ردهای عمومی 5xx قرار می‌گیرند. اگر \fBreject_reply_patterns\fR را طوری بازتعریف کنید که شامل الگوی \fB5..\fR نباشد، ردهای milter در خروجی ظاهر نخواهند شد. .IP "\fB###RejectRbl" پیام‌های رد شده به دلیل تطابق در RBL. .IP "\fB###RejectRecip" پیام‌های رد شده توسط کنترل‌های دسترسی گیرنده (smtpd_recipient_restrictions). .IP "\fB###RejectRelay" پیام‌های رد شده توسط کنترل‌های دسترسی رله. .IP "\fB###RejectSender" پیام‌های رد شده توسط کنترل‌های دسترسی فرستنده (smtpd_sender_restrictions). .IP "\fB###RejectSize" پیام‌های رد شده به دلیل حجم بیش از حد پیام. .IP "\fB###RejectUnknownClient" پیام‌های رد شده توسط کنترل‌های دسترسی کلاینت ناشناخته..IP "\fB###RejectUnknownReverseClient" پیام‌های ردشده توسط کنترل‌های دسترسی کلاینت معکوس ناشناخته. .IP "\fB###RejectUnknownUser" پیام‌های ردشده توسط کنترل‌های دسترسی کاربر ناشناخته. .IP "\fB###RejectUnverifiedClient" پیام‌های ردشده توسط کنترل‌های دسترسی کلاینت تأییدنشده. .IP "\fB###RejectVerify" پیام‌های ردشده به دلیل شکست در اعتبارسنجی نشانی. .IP "\fBReplaced" پیام‌هایی که کنش REPLACE را در header_checks یا body_checks فعال کرده‌اند. .IP "\fBReturnedToSender" پیام‌های بازگردانده‌شده به فرستنده به دلیل فراتر رفتن از زمان ماندگاری صف (maximal_queue_lifetime). .IP "\fBSaslAuth" موفقیت‌های احراز هویت SASL؛ شامل روش SASL، نام کاربری و فرستنده در صورت وجود. .IP "\fBSaslAuthFail" شکست‌های احراز هویت SASL. .IP "\fBSent" پیام‌های ارسال‌شده از طریق عامل تحویل SMTP. .IP "\fBSentLmtp" پیام‌های ارسال‌شده از طریق عامل تحویل LMTP. .IP "\fBSmtpConversationError" خطاها در طول گفتگوی SMTP/ESMTP. .IP "\fBSmtpProtocolViolation" نقض پروتکل در طول گفتگوی SMTP/ESMTP. .IP "\fBStartupError" خطاها در حین راه‌اندازی کارگزار Postfix. .IP "\fBTimeoutInbound" اتصال‌هایی به \fBsmtpd\fR که دچار پایان مهلت زمانی (timeout) شده‌اند. .IP "\fBTlsClientConnect" اتصال‌های کلاینت TLS. .IP "\fBTlsOffered" ارتباط TLS پیشنهادشده. .IP "\fBTlsServerConnect" اتصال‌های سرور TLS. .IP "\fBTlsUnverified" اتصال‌های تأییدنشده TLS. .IP "\fBUndeliverable" اعتبارسنجی نشانی نشان می‌دهد که نشانی گیرنده غیرقابل تحویل است. .IP "\fBWarn" پیام‌هایی که کنش WARN را در access، header_checks یا body_checks فعال کرده‌اند. .IP "\fBWarnConfigError" هشدارهای مربوط به خطاهای پیکربندی Postfix. .IP "\fBWarningsOther" پیام‌های عمومی \fBwarning\fR در Postfix. .PD .SH "کنترل سطح (LEVEL CONTROL)" .ad .fi بخش \fBDetailed\fR از گزارش شامل تعدادی زیربخش است که هر یک از آن‌ها هم به صورت سراسری و هم به طور مستقل کنترل می‌شوند. دو تنظیم بر خروجی ارائه‌شده در گزارش \fBDetailed\fR تأثیر می‌گذارند: یک سطح جزئیات سراسری (که با \fB--detail\fR مشخص می‌شود) و کنترل نهایی (چکش بزرگ) را برای محدود کردن خروجی بخش \fBDetailed\fR اعمال می‌کند، و تنظیمات جزئیات مختص زیربخش (چکش کوچک) که امکان محدودسازی بیشتر خروجی را برای هر زیربخش فراهم می‌سازد. هر زیربخش می‌تواند به یک عمق مشخص محدود شود و هر زیرسطح را می‌توان با حدود N تای برتر یا مقادیر آستانه محدود کرد. آرگومان \fIlevelspec\fR برای هر یک از محدودکننده‌های سطحِ ذکرشده در بالا برای دستیابی به این هدف به کار می‌رود. شاید بهتر باشد توضیح محدودسازی زیرسطح را با ساختار سلسله‌مراتبی شناخته‌شده زیر و چند مثال پایه ادامه دهیم: .nf level 0 level 1 level 2 level 3 level 4 level 4 level 2 level 3 level 4 level 4 level 4 level 3 level 4 level 3 level 1 level 2 level 3 level 4 .fi .PP ساده‌ترین شکل محدودسازی خروجی، تمام خروجی‌های پایین‌تر از یک سطح مشخص را حذف می‌کند. برای مثال، یک \fIlevelspec\fR که روی "2" تنظیم شده است، تنها داده‌های سطوح 0 تا 2 را نشان می‌دهد. این کار را مانند جمع‌کردن (collapse) هر مورد در زیرسطح 2 در نظر بگیرید که بدین ترتیب تمامی سطوح پایین‌تر (3، 4، ...) پنهان شده و خروجی زیر حاصل می‌شود: .nf level 0 level 1 level 2 level 2 level 1 level 2 .fi .PP گاهی حجم خروجی در یک بخش بیش از حد زیاد است و حذف داده‌هایی که از یک مقدار آستانه مشخص فراتر نمی‌روند سودمند خواهد بود. یک حمله هرزنامه فرهنگ‌لغتی (dictionary spam attack) را در نظر بگیرید که فهرست‌های بسیار طولانی از نشانی‌های ایمیل یا IP گیرنده‌ای با تنها یک‌بار رخداد تولید می‌کند. هر زیرسطح در سلسله‌مراتب را می‌توان با تنظیم مناسب \fIlevelspec\fR به صورت آستانه‌ای محدود کرد. تنظیم \fIlevelspec\fR به مقدار "2::5" هر داده‌ای را در سطح 2 که تعداد دفعات رخداد آن از 5 بیشتر نباشد، حذف خواهد کرد. .PP شاید ایجاد فهرستی از N تای برتر، مانند ۱۰ فرستنده برتر، مورد نظر باشد. مقدار \fIlevelspec\fR به صورت "3:10:" داده‌های سطح 3 را تنها به ۱۰ رخداد برتر محدود می‌کند. .PP با کنار گذاشتن این مثال‌های ساده، \fIlevelspec\fR به صورت فهرستی از یک یا چند مورد از موارد زیر تعریف می‌شود که با فاصله یا کاما از یکدیگر جدا شده‌اند: .IP "\fIl\fR" حداکثر سطحی را که باید برای این زیربخش نمایش داده شود تعیین می‌کند، با دامنه‌ای از 0 تا 10. اگر \fIl\fR برابر 0 باشد، هیچ سطحی در خروجی نمایش داده نمی‌شود و عملاً زیربخش غیرفعال می‌گردد (داده‌های سطح 0 پیشاپیش در گزارش Summary ارائه شده‌اند، بنابراین سطح 1 نخستین سطح کاربردی در گزارش \fBDetailed\fR در نظر گرفته می‌شود). مقادیر بالاتر، خروجی را تا سطح تعیین‌شده و شامل آن تولید خواهند کرد. .IP "\fIl\fB.\fIn\fR" مشابه بالا، با این افزونه که \fIn\fR خروجی سطح 1 این بخش را به \fIn\fR مورد برتر محدود می‌کند. مقدار \fIn\fR می‌تواند هر عدد صحیح بزرگ‌تر از 1 باشد. (این شیوه محدودسازی کارایی کمتری نسبت به نحو زیر دارد. این قالب جهت سازگاری با نسخه‌های پیشین ارائه شده و به کاربران توصیه می‌شود از نحو زیر استفاده کنند). .IP "\fIl\fB:\fIn\fB:\fIt\fR" این سه‌تایی، سطح \fIl\fR، تعداد برتر \fIn\fR و حداقل آستانه \fIt\fR را تعیین می‌کند. هر یک از مقادیر، اعداد صحیحی هستند که \fIl\fR محدودکننده سطح طبق توضیحات بالا، \fIn\fR محدودکننده N تای برتر برای سطح \fIl\fR، و \fIt\fR محدودکننده آستانه برای سطح \fIl\fR است. هنگامی که هر دو مقدار \fIn\fR و \fIt\fR مشخص شده باشند، \fIn\fR اولویت دارد و امکان ایجاد فهرست‌های N تای برتر را (بدون توجه به مقدار آستانه) فراهم می‌سازد. چنانچه مقدار \fIl\fR درج نشود، مقادیر مشخص‌شده برای \fIn\fR و/یا \fIt\fR برای تمامی سطوح موجود در زیربخش اعمال می‌شوند. این موضوع امکان نوعی تطبیق عام (wildcarding) ساده را فراهم می‌کند (مثلاً اعمال محدودیت‌های حداقل آستانه بر روی تمام سطوح). با این حال، محدودکننده‌های مشخص همواره بر محدودکننده‌های عام ارجحیت دارند. نخستین شکل از محدودکننده سطح می‌تواند در \fIlevelspec\fR گنجانده شود تا بدون توجه به تعداد سه‌تایی‌های موجود، خروجی کلی را محدود کند. .PP هر سه شکل از این محدودکننده‌ها تنها زمانی مؤثر هستند که سطح جزئیات \fBpostfix-logwatch\fR برابر با 5 یا بیشتر باشد (بخش \fBDetailed\fR تا زمانی که سطح جزئیات حداقل 5 نباشد فعال نمی‌گردد). .PP برای مشاهده سناریوهای کاربردی، بخش \fBمثال‌ها (EXAMPLES)\fR را ببینید..SH "فایل پیکربندی (CONFIGURATION FILE)" .ad دستور \fBpostfix-logwatch\fR می‌تواند تنظیمات پیکربندی را از یک فایل پیکربندی بخواند. در اصل، هر گزینه خط فرمان می‌تواند در یک فایل پیکربندی قرار گیرد، و این تنظیمات هنگام راه‌اندازی خوانده می‌شوند. از آنجا که \fBpostfix-logwatch\fR می‌تواند به صورت مستقل یا درون Logwatch اجرا شود، برای به حداقل رساندن سردرگمی، \fBpostfix-logwatch\fR از قواعد ساختاری و قراردادهای فایل پیکربندی Logwatch پیروی می‌کند. این موارد عبارتند از: .IP \(bu 4'. خطوط خالی نادیده گرفته می‌شوند. .IP \(bu 4'. خطوطی که با \fB#\fR شروع می‌شوند نادیده گرفته می‌شوند. .IP \(bu 4'. تنظیمات به این صورت هستند: .nf \fIoption\fB = \fIvalue\fR .fi .IP \(bu 4'. فاصله‌ها یا تب‌ها در دو طرف نویسه \fB=\fR نادیده گرفته می‌شوند. .IP \(bu 4'. بزرگی و کوچکی حروف هر \fIvalue\fR که درون نقل‌قول دوتایی قرار گیرد، حفظ خواهد شد. .IP \(bu 4'. تمام محتواهای دیگر به حروف کوچک تبدیل می‌شوند (عدم حفظ بزرگی و کوچکی، غیرحساس به حروف). .IP \(bu 4'. تمامی تنظیمات پیکربندی \fBpostfix-logwatch\fR باید پیشوند "\fB$postfix_\fR" داشته باشند، در غیر این صورت \fBpostfix-logwatch\fR آن‌ها را نادیده خواهد گرفت. .IP \(bu 4'. هنگام اجرا تحت Logwatch، هر مقداری که فاقد پیشوند "\fB$postfix_\fR" باشد توسط Logwatch مصرف می‌شود؛ Logwatch تنها تنظیماتی را (از طریق متغیر محیطی) به \fBpostfix-logwatch\fR ارسال می‌کند که از نظر خودش معتبر باشند. .IP \(bu 4'. مقادیر \fBTrue\fR و \fBYes\fR به 1، و مقادیر \fBFalse\fR و \fBNo\fR به 0 تبدیل می‌شوند. .IP \(bu 4'. ترتیب تنظیمات درون فایل پیکربندی حفظ نمی‌شود (چرا که تنظیمات توسط Logwatch از طریق متغیرهای محیطی ارسال می‌شوند که هیچ ترتیب تعریف‌شده‌ای ندارند). .PP برای گنجاندن یک گزینه خط فرمان در یک فایل پیکربندی، پیشوند "\fB$postfix_\fR" را به نام گزینه خط فرمان اضافه کنید. تنظیم فایل پیکربندی و گزینه خط فرمان زیر با یکدیگر معادل هستند: .nf \fB$postfix_Line_Style = Truncate\fR \fB--line_style Truncate\fR .fi محدودکننده‌های سطح نیز پیشوند \fB$postfix_\fR دریافت می‌کنند، اما در خط فرمان با گزینه \fB--limit\fR مشخص می‌شوند: .nf \fB$postfix_Sent = 2\fR \fB--limit Sent=2\fR .fi ترتیب پردازش گزینه‌های خط فرمان و فایل‌های پیکربندی به صورت زیر رخ می‌دهد: 1) فایل پیکربندی پیش‌فرض در صورت وجود خوانده می‌شود، مشروط بر اینکه گزینه \fB--config_file\fR در خط فرمان مشخص نشده باشد. 2) فایل‌های پیکربندی به ترتیبی که در خط فرمان آمده‌اند خوانده و پردازش می‌شوند. 3) گزینه‌های خط فرمان بر تمام گزینه‌هایی که پیش‌تر چه از طریق خط فرمان و چه از طریق فایل پیکربندی تنظیم شده‌اند، برتری داشته و آن‌ها را رونویسی می‌کنند. گزینه‌های خط فرمان به ترتیبی که در خط فرمان مشاهده می‌شوند تفسیر می‌شوند، و گزینه‌های پسین گزینه‌های از پیش تنظیم‌شده را رونویسی خواهند کرد. استثنای قابل توجه در مورد متغیرهای محدودکننده است، که به ترتیب مشاهده تفسیر می‌شوند، اما این کار تنها پس از پردازش سایر گزینه‌ها صورت می‌پذیرد. این موضوع به \fB--reject_reply_patterns\fR اجازه می‌دهد تا فهرست پویای محدودکننده‌های گوناگون reject را تعیین کند. همچنین گزینه \fB--reject_reply_patterns\fR را ببینید. .SH "وضعیت خروج (EXIT STATUS)" .na .nf .ad .fi ابزار \fBpostfix-logwatch\fR با کد وضعیت 0 خارج می‌شود، مگر اینکه خطایی رخ داده باشد که در این صورت یک وضعیت خروج غیرصفر بازگردانده خواهد شد. .SH "مثال‌ها (EXAMPLES)" .na .nf .ad .fi.SS "اجرای مستقل (Running Standalone)" \fBنکته:\fR \fBpostfix-logwatch\fR داده‌های گزارش خود را از یک یا چند فایل گزارش مشخص‌شدهٔ Postfix، یا از STDIN می‌خواند. برای اختصار، در صورت نیاز، مثال‌های زیر از واژهٔ \fIfile\fR به عنوان آرگومان خط فرمان به معنای \fI/path/to/postfix.log\fR استفاده می‌کنند. بدیهی است که باید \fIfile\fR را با مسیر مناسب جایگزین کنید. .nf .PP برای اجرای \fBpostfix-logwatch\fR در حالت مستقل، به سادگی دستور زیر را اجرا کنید: .nf .RS 4 .PP \fBpostfix-logwatch \fIfile\fR .RE 0 .nf .PP فهرست کاملی از گزینه‌ها و نحوهٔ استفادهٔ پایه‌ای از طریق دستور زیر در دسترس است: .nf .RS 4 .PP \fBpostfix-logwatch --help\fR .RE 0 .nf .PP برای چاپ گزارشی که تنها شامل خلاصه‌ای از داده‌های گزارش Postfix است: .nf .RS 4 .PP \fBpostfix-logwatch --detail 1 \fIfile\fR .RE 0 .fi .PP برای تولید یک گزارش خلاصه و یک گزارش تفصیلی سطح یک برای ۲۵ مِی (May 25th): .nf .RS 4 .PP \fBgrep 'May 25' \fIfile\fB | postfix-logwatch --detail 5\fR .RE 0 .fi .PP برای تولید فهرستی که فقط شامل ۱۰ دامنهٔ برتر ایمیل‌های ارسالی (Sent) باشد، ابتدا گزارش خلاصه و گزارش‌های تفصیلی غیرفعال می‌شوند. از آن‌جا که گزینه‌های خط فرمان از چپ به راست خوانده و فعال می‌شوند، بخش Sent دوباره تا سطح ۱ با یک محدودکنندهٔ ۱۰ تای برتر سطح ۱ فعال می‌شود: .nf .RS 4 .PP \fBpostfix-logwatch --nosummary --nodetail --limit sent='1 1:10:' \fIfile\fR .RE 0 .fi .PP دستور زیر و خروجی نمونهٔ آن، مثالی پیچیده‌تر از محدودکنندهٔ سطح را نشان می‌دهد. این دستور ۳ نشانی ایمیل ارسالی برتر از ۵ دامنهٔ برتر را ارائه می‌دهد، به علاوه، تمام موارد سطح ۳ با تعداد دفعات تکرار ۲ یا کمتر پنهان (حذف) می‌شوند (در زیربخش Sent، این مورد مربوط به نشانی اصلی گیرندهٔ ایمیل یا Original To است). علامت‌های سه‌نقطه نشان‌دهندهٔ داده‌های N تای برتر یا محدودشده بر اساس آستانه هستند: .nf .RS 4 .PP \fBpostfix-logwatch --nosummary --nodetail \\ --limit sent '1:5: 2:3: 3::2' \fIfile\fR .nf 1762 Sent via SMTP ----------------------------------- 352 example.com 310 joe 255 joe.bob@virtdomain.example.com 7 info@virtdomain.example.com 21 pooryoda3 11 hot93uh ... 244 sample.net 97 buzz 26 leroyjones 14 sally ... 152 example.net 40 jim_jameson 23 sam_sampson 19 paul_paulson ... 83 sample.us 44 root 39 jenny1 69 dom3.example.us 10 kay 7 ron 6 mrsmith ... ... .fi .RE 0 .fi .PP دستور بعدی هم از \fBreject_reply_patterns\fR و هم از محدودکننده‌های سطح برای مشاهدهٔ خطاهای رد ۴۲۱ مربوط به RBL استفاده می‌کند، که خروجی سطح ۲ را به مواردی با تعداد دفعات تکرار بیش از ۵ محدود می‌سازد (سطح ۲ در زیربخش Reject RBL، جفت نشانی IP / نام میزبان کلاینت است). این کار یک فهرست بسیار مناسب از متخلفان RBL ایجاد می‌کند که در خروجی نمونه نشان داده شده است (به استفاده از گزینهٔ خط فرمان اختصاری و بدون ابهام reject_reply_pat توجه کنید): .nf .RS 4 .PP \fBpostfix-logwatch --reject_reply_pat '421 4.. 5.. Warn' \\ --nosummary --nodetail --limit 421rejectrbl='2 2::5' \fIfile\fR .nf 300 421 Reject RBL --------------------------------------- 243 zen.spamhaus.org=127.0.0.2 106 10.0.0.129 129.0.0.example.com 41 192.168.10.70 hostx10.sample.net 40 192.168.42.39 hostz42.sample.net 15 10.1.1.152 dsl-10-1-1-152.example.us 14 10.10.10.122 mail122.sample.com 7 192.168.3.44 smalltime-spammer.example.com ... 48 zen.spamhaus.org=127.0.0.4 17 10.29.124.92 10-29-124-92.adsl-static.sample.us ... 8 zen.spamhaus.org=127.0.0.11 ... 1 zen.spamhaus.org=127.0.0.10 ... .fi .RE 4.SS "اجرا در Logwatch" \fBنکته:\fR نسخه‌های Logwatch پیش از 7.3.6، مگر در صورت پیکربندی دیگر، برای چاپ در STDOUT به‌جای ارسال گزارش‌ها از طریق ایمیل، به گزینهٔ \fB--print\fR نیاز داشتند. از نسخهٔ 7.3.6، STDOUT مقصد خروجی پیش‌فرض است و گزینهٔ \fB--print\fR با \fB--output stdout\fR جایگزین شده است. پیکربندی خود را بررسی کنید تا مشخص شود خروجی گزارش به کجا هدایت خواهد شد، و گزینهٔ مناسب را به دستورهای زیر اضافه کنید. .PP برای چاپ گزارش خلاصه‌ای از داده‌های لاگ امروز Postfix: .nf .RS 4 .PP \fBlogwatch --service postfix --range today --detail 1\fR .RE 0 .nf .PP برای چاپ گزارشی از داده‌های لاگ امروز Postfix، با یک سطح از جزئیات در بخش \fBDetailed\fR: .nf .RS 4 .PP \fBlogwatch --service postfix --range today --detail 5\fR .RE 0 .fi .PP برای چاپ گزارشی برای دیروز، با دو سطح جزئیات در بخش \fBDetailed\fR: .nf .RS 4 .PP \fBlogwatch --service postfix --range yesterday --detail 6\fR .RE 0 .fi .PP برای چاپ گزارشی از ۱۲ دسامبر تا ۱۴ دسامبر، با چهار سطح جزئیات در بخش \fBDetailed\fR: .nf .RS 4 .PP \fBlogwatch --service postfix --range \\ 'between 12/12 and 12/14' --detail 8\fR .RE 0 .PP برای چاپ گزارشی برای امروز، با تمام سطوح جزئیات: .nf .RS 4 .PP \fBlogwatch --service postfix --range today --detail 10\fR .RE 0 .PP مشابه بالا، اما خطوط طولانی را بدون برش باقی می‌گذارد: .nf .RS 4 .PP \fBlogwatch --service postfix --range today --detail 11\fR .RE 0 .SH "محیط (ENVIRONMENT)" .na .nf .ad .fi برنامهٔ \fBpostfix-logwatch\fR هنگام اجرا تحت Logwatch از متغیرهای محیطی زیر (که به‌طور خودکار تنظیم می‌شوند) استفاده می‌کند: .IP \fBLOGWATCH_DETAIL_LEVEL\fR این سطح جزئیات مشخص‌شده با آرگومان خط فرمان \fB--detail\fR در Logwatch یا تنظیم \fBDetail\fR در فایل پیکربندی ...conf/services/postfix.conf است. .IP \fBLOGWATCH_DEBUG\fR این سطح اشکال‌زدایی مشخص‌شده با آرگومان خط فرمان \fB--debug\fR در Logwatch است. .IP \fBpostfix_\fIxxx\fR برنامهٔ Logwatch تمامی تنظیمات \fBpostfix_\fIxxx\fR موجود در فایل پیکربندی ...conf/services/postfix.conf را از طریق متغیر محیطی به فیلتر \fBpostfix\fR (که در واقع .../scripts/services/postfix نام دارد) ارسال می‌کند. .SH "فایل‌ها (FILES)" .na .nf .SS "حالت مستقل (Standalone mode)" .IP "/usr/local/bin/postfix-logwatch" برنامهٔ \fBpostfix-logwatch\fR .IP "/usr/local/etc/postfix-logwatch.conf" فایل پیکربندی \fBpostfix-logwatch\fR در حالت مستقل .SS "حالت Logwatch (Logwatch mode)" .IP "/etc/logwatch/scripts/services/postfix" فیلتر \fBpostfix\fR در Logwatch .IP "/etc/logwatch/conf/services/postfix.conf" فایل پیکربندی فیلتر \fBpostfix\fR در Logwatch.SH "همچنین ببینید (SEE ALSO)" .na .nf logwatch(8)، تحلیل‌گر و گزارش‌دهنده گزارش‌های سیستمی .SH "فایل‌های راهنما (README FILES)" .na .ad .nf README، مروری کلی بر \fBpostfix-logwatch\fR Changes، تاریخچه فهرست تغییرات نسخه‌ها Bugs، فهرستی از باگ‌های کنونی یا سایر کاستی‌ها Makefile، نصب‌کننده مقدماتی LICENSE، شرایط مجوز برای استفاده و بازتوزیع .SH "مجوز (LICENSE)" .na .nf .ad تحت پوشش مجوز گنجانده‌شده MIT/X-Consortium: http://www.opensource.org/licenses/mit-license.php .SH "نویسندگان (AUTHORS)" .na .nf Mike Cappella .fi فیلتر اولیه Logwatch برای \fBpostfix\fR توسط Kenneth Porter نوشته شده بود و طی سال‌ها مشارکت‌کنندگان زیادی داشته است. آن‌ها مطلقاً هیچ مسئولیتی در قبال خطاها، مشکلات یا خرابی‌های ایجادشده از زمانی که کد منبع توسط نویسنده فعلی دستکاری شده است، ندارند.