.TH "metalog" "8" "4" "Frank DENIS" "Syslog daemon"
.SH "نام (NAME)"
.LP
metalog \- دیمن جایگزین ثبت وقایع سیستم (syslog)
.SH "سینتکس (SYNTAX)"
.LP
metalog [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.LP
نرم‌افزار
.B metalog
یک جایگزین امروزی برای
.B syslogd
و
.B klogd
است. پیام‌های ثبت‌شده می‌توانند بر اساس مبدأ (facility)، فوریت (urgency)، نام برنامه و/یا عبارات باقاعده سازگار با پرل تفکیک و هدایت شوند. فایل‌های گزارش می‌توانند در صورت فراتر رفتن از اندازه‌ای معین یا گذشت سنی مشخص، به صورت خودکار چرخش (rotate) پیدا کنند. همچنین در صورت تطابق با الگوهایی خاص، اسکریپت‌های شل خارجی (مانند ارسال ایمیل) قابل اجرا هستند.
.PP
گزارش‌ها مطابق با استانداردهای RFC3164 ،RFC5423 یا قالبی کمینه همراه با سطوح شدت (severity) اختیاری نوشته می‌شوند.
.PP
این ابزار می‌تواند گزارش‌های خود را از طریق پروتکل UDP به کارگزارهای راه دور syslog ارسال کند. همچنین قادر است اطلاعات را از هسته یا
.I /dev/log
و چندین سوکت دامنه یونیکس دریافت کند. این قابلیت امکان ثبت وقایع از برنامه‌های ایزوله‌شده در chroot یا کانتینرها را فراهم می‌سازد.
.PP
پیکربندی
.B metalog
در مقایسه با
.B syslogd
و
.B syslog\-ng
بسیار ساده‌تر است، تعداد نامحدودی از قوانین را می‌پذیرد و برای دستیابی به حداکثر کارایی، مجهز به حافظه بافر موقت (قابل فعال یا غیرفعال‌سازی) می‌باشد.
.SH "گزینه‌ها (OPTIONS)"
.LP
.TP
.BR \-a ", " \-\-async
بهبود کارایی با استفاده از بافرها (البته فایل‌های گزارش به صورت بلادرنگ به‌روزرسانی نخواهند شد).
این رفتار می‌تواند برای گزارش‌های منفرد بازنویسی شود.
.TP
.BR \-B ", " \-\-daemonize
اجرای سرور در پس‌زمینه (تبدیل شدن به دیمن).
.TP
.BR \-c ", " \-\-consolelevel = \fR\fI0..7\fR
تنظیم سطح گزارش کنسول (فقط در لینوکس).
.TP
.BR \-C ", " \-\-configfile = \fR\fIfile\fR
استفاده از یک فایل پیکربندی جایگزین.
.TP
.BR \-g ", " \-\-group = \fR\fIgroup\fR
تغییر شناسه گروه (GID) فرایند metalog.
فایل‌های ایجادشده متعلق به این گروه خواهند بود.
.TP
.BR \-h ", " \-\-help
نمایش اطلاعات راهنما و خروج.
.TP
.BR \-N ", " \-\-no\-kernel
عدم تلاش برای دریافت و ثبت پیام‌ها از سمت هسته.
.TP
.BR \-p ", " \-\-pidfile = \fR\fIfile\fR
استفاده از فایلی جایگزین برای ذخیره شناسه فرایند (PID).
.TP
.BR \-S ", " \-\-socket = \fR\fIpath\fR
استفاده از یک مسیر سوکت جایگزین برای شنونده اصلی syslog.
.TP
.BR \-s ", " \-\-sync ", " \-\-synchronous
اجرا در حالت همگام، بدون استفاده از بافر.
این رفتار می‌تواند برای گزارش‌های منفرد بازنویسی شود.
.TP
.BR \-t ", " \-\-test\-config
خروج بلافاصله پس از ارزیابی و تجزیه فایل(های) پیکربندی.
در صورت سالم بودن پیکربندی، مقدار 0 برگردانده می‌شود.
.TP
.BR \-v ", " \-\-verbose
اجرا در حالت پرگو با جزئیات کامل (برای اشکال‌زدایی رفتار برنامه مفید است).
.TP
.BR \-V ", " \-\-version
نمایش اطلاعات نسخه metalog.
.SH "سیگنال‌ها (SIGNALS)"
.TP
.B SIGUSR1
فعال‌سازی حالت همگام (synchronous).
.TP
.B SIGUSR2
غیرفعال‌سازی حالت همگام.
.fi
.SH "فایل‌ها (FILES)"
.LP
توجه داشته باشید که مسیرهای دقیق به تنظیمات زمان ساخت بستگی دارند. این‌ها مسیرهای استاندارد هستند.

.nf
.I /etc/metalog.conf
.I /var/run/metalog.pid
.I /dev/log
.fi
.SH "نویسندگان (AUTHORS)"
.LP
.nf
Mike Frysinger <vapier@gentoo.org>
Laurent Wandrebeck (low) <wandre.l@free.fr>
Leo Lipelis <aeoo@gentoo.org>
Hendrik Visage <hvisage@users.sourceforge.net>
Frank DENIS (Jedi/Sector One) <j@pureftpd.org>
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR metalog.conf (5)