.TH LOGWATCH 8 "May 2012" Linux "راهنمای کاربری لینوکس"
.SH "نام (NAME)"
logwatch \- تحلیل‌گر و گزارش‌دهنده گزارش‌های سیستمی (لاگ‌ها)
.SH "خلاصه دستور (SYNOPSIS)"
.B logwatch [--detail
.I level
.B ] [--logfile
.I log-file-group
.B ] [--service
.I service-name
.B ] [--mailto
.I address
.B ] [--noarchives] [--range
.I range
.B ] [--debug
.I level
.B ] [--filename
.I file-name
.B ] [--logdir
.I directory
.B ] [--hostlimit
.I hosts
.B ] [--hostname
.I hostname
.B ] [--html_wrap
.I number of characters
.B ] [--hostformat
.I host based options
.B ] [--output
.I output-type
.B ] [--format
.I report format
.B ] [--subject
.I email subject
.B ] [--encode
.I encoding to use
.B ] [--numeric] [--version] [--help|--usage]
.SH "توضیحات (DESCRIPTION)"
ابزار
.B Logwatch
یک سامانه پایش وقایع و گزارش‌ها (لاگ‌ها) با قابلیت سفارشی‌سازی و افزونه‌پذیری است. این برنامه لاگ‌های شما را در بازه زمانی مشخص بررسی کرده و در بخش‌ها و با جزئیات مورد نظر شما گزارش تهیه می‌کند. Logwatch در لینوکس و انواع مختلف یونیکس به کار می‌رود.
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB--detail\fR level"
سطح جزئیات گزارش.
.I level
می‌تواند یک عدد صحیح مثبت یا یکی از مقادیر high، med، low باشد که به ترتیب معادل اعداد ۱۰، ۵ و ۰ هستند.
.IP "\fB--logfile\fR log-file-group"
برنامه Logwatch را وادار می‌کند تا تنها مجموعه‌ای از فایل‌های گزارش مشخص‌شده توسط
.I log-file-group
(مانند messages، xferlog و...) را پردازش کند. بنابراین Logwatch تمام سرویس‌هایی را که از این فایل‌ها استفاده می‌کنند پردازش خواهد کرد. این گزینه می‌تواند بیش از یک بار برای تعیین چند گروه فایل لاگ تکرار شود.
.IP "\fB--service\fR service-name"
برنامه Logwatch را وادار می‌کند تا تنها سرویس مشخص‌شده در
.I service-name
(مانند login، pam، identd و...) را پردازش کند. بنابراین Logwatch هر گروه فایل لاگ لازم برای پردازش این سرویس‌ها را نیز بررسی می‌کند. این گزینه می‌تواند بیش از یک بار برای تعیین چندین سرویس جهت پردازش تکرار شود. یک مقدار مفید برای
.I service-name
گزینه
.I All
است که تمام سرویس‌ها (و گروه‌های فایل لاگ) را که فیلتر آن‌ها نصب شده است پردازش می‌کند.
.IP "\fB--mailto\fR address"
ارسال نتایج به نشانی ایمیل یا کاربر مشخص‌شده در
.I address.
.IP "\fB--range\fR range"
تعیین بازه تاریخی برای پردازش. بازه‌های رایج عبارتند از
.IR Yesterday ،
.IR Today ،
.IR All
و
.IR Help .
گزینه‌های بیشتر هنگام اجرای دستور با پارامتر
.I Help
فهرست می‌شوند.
.IP "\fB--noarchives\fR"
هر گروه فایل لاگ شامل فایل‌های لاگ پایه (مانند /var/log/messages) و فایل‌های آرشیو (مانند /var/log/messages.? یا /var/log/messages.?.gz) است. به طور پیش‌فرض، Logwatch علاوه بر فایل‌های لاگ معمولی، در آرشیوها نیز جستجو می‌کند. برای مقادیر \-\-range به جز "all"، برنامه Logwatch لاگ‌های آرشیوشده مربوطه را جستجو می‌کند. اگر "\-\-noarchives" مشخص شود، Logwatch برای هیچ مقداری از "\-\-range" در لاگ‌های آرشیوشده جستجو نخواهد کرد.
.IP "\fB--debug\fR level"
برای اهداف اشکال‌زدایی.
.I level
معمولاً مقداری بین ۰ تا ۱۰۰ دارد. این گزینه خروجی را با جزئیات فراوان شلوغ می‌کند، بنابراین احتمالاً تنها هنگام اشکال‌زدایی مایل به استفاده از آن هستید. مقادیر ۱۰۰ یا بیشتر، فایل‌های موقت را نگه می‌دارند (به طور پیش‌فرض زیر مسیر /var/cache/logwatch ایجاد می‌شوند، مگر اینکه به عنوان tmpdir در فایل logwatch.conf مشخص شده باشد).
.IP "\fB--filename\fR file-name"
ذخیره خروجی در
.I file-name
به جای نمایش در خروجی استاندارد یا ارسال ایمیل.
.IP "\fB--logdir\fR directory"
جستجوی پوشه‌های فرعی یا فایل‌های لاگ در
.I directory
پیش از بررسی پوشه‌های پیش‌فرض.
.IP "\fB--hostlimit\fR host1,host2"
محدود کردن گزارش به نام میزبان‌های مشخص‌شده \- host1, host2.
.IP "\fB--hostname\fR hostname"
استفاده از
.I hostname
برای گزارش‌ها به جای نام میزبان این سیستم. افزون بر این، اگر HostLimit در فایل پیکربندی logwatch.conf تنظیم شده باشد (بخش
.B اطلاعات بیشتر
در زیر را ببینید)، تنها لاگ‌های مربوط به این نام میزبان پردازش خواهند شد (در صورت کاربرد).
.IP "\fB--html_wrap\fR num-characters"
تعداد کاراکترهایی که خروجی html باید به آن سطرشکنی (wrap) شود. پیش‌فرض ۸۰ است.
.IP "\fB--hostformat\fR split"
استفاده از رویکرد
.I split
هنگام قالب‌بندی گزارش برای چند میزبان \- none [پیش‌فرض]، split، splitmail.
.IP "\fB--output\fR output-type"
گزارش‌گیری با استفاده از
.I output-type
\- stdout [پیش‌فرض]، mail، file.
.IP "\fB--format\fR format"
قالب‌بندی گزارش با
.I format
\- text [پیش‌فرض]، html.
.IP "\fB--subject\fR email-subject"
سفارشی‌سازی موضوع ایمیل ارسالی توسط Logwatch. گزینه
.B \-\-output
باید روی mail تنظیم شده باشد.
.IP "\fB--encode\fR encoding"
کدگذاری گزارش با استفاده از
.I encoding
\- none [پیش‌فرض]، base64، 7bit، 8bit [مشابه 'none'].
.IP "\fB--numeric\fR"
جلوگیری از وضوح‌یابی نام‌ها و نمایش عددی نشانی‌های IP.
.IP "\fB--usage\fR"
نمایش اطلاعات نحوه استفاده
.IP "\fB--help\fR"
مشابه \-\-usage.
.SH "فایل‌ها (FILES)"
.IP /usr/share/logwatch/
.RS
این دایرکتوری شامل تمام برنامه‌های اجرایی پرل و فایل‌های پیکربندی ارائه‌شده همراه با توزیع logwatch است.
.RE
.IP /etc/logwatch
.RS
این دایرکتوری شامل فایل‌های پیکربندی محلی است که پیکربندی پیش‌فرض را بازنویسی می‌کنند. برای جزئیات بیشتر بخش
.B "اطلاعات بیشتر (MORE INFORMATION)"
در زیر را ببینید.
.RE
.SH "مثال‌ها (EXAMPLES)"
.B logwatch --service ftpd-xferlog --range all --detail high
.RS
تمام انتقالات FTP ذخیره‌شده در کلیه xferlogهای جاری و آرشیوشده را چاپ می‌کند.
.RE
.B logwatch --service pam_pwdb --range yesterday --detail high
.RS
اطلاعات ورود به سیستم برای روز گذشته را چاپ می‌کند...
.RE
.SH "اطلاعات بیشتر (MORE INFORMATION)"
پوشه /usr/share/doc/logwatch-* شامل چندین فایل حاوی مستندات تکمیلی است:
.RE
.I HOWTO-Customize-LogWatch
.RS
ساختار پوشه‌های پیکربندی و فایل‌های اجرایی Logwatch را مستند کرده و نحوه سفارشی‌سازی Logwatch را با بازنویسی این فایل‌های پیش‌فرض شرح می‌دهد.
.RE
.I LICENSE
.RS
مجوزی را که Logwatch تحت آن توزیع شده است شرح می‌دهد. بندهای تکمیلی ممکن است در فایل‌های جداگانه مشخص شده باشند.
.RE
.I README
.RS
نحوه نصب، محل دریافت، لیست‌های پستی و سایر اطلاعات مفید را شرح می‌دهد.
.SH "نویسنده (AUTHOR)"
.RE
Kirk Bauer <kirk@kaybee.org>
.RE
<http://sourceforge.net/projects/logwatch>