.TH loggen 1 "18 December 2025" 4.10.2 "The loggen manual page"
.SH "نام (NAME)"
loggen \- تولید پیام‌های syslog با نرخ مشخص
.SH "خلاصه دستور (SYNOPSIS)"
.B loggen
[\fIگزینه‌ها\fR]
.I target
[\fIport\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBنکته:\fP برنامه
.B loggen
همراه با برنامه ثبت وقایع سیستمی
.B syslog\-ng OSE
توزیع می‌شود و معمولاً بخشی از بسته
.B syslog\-ng OSE
است. آخرین نسخه برنامه
.B syslog\-ng OSE
در صفحه رسمی
.B syslog\-ng OSE
در دسترس است.
.PP
این صفحه راهنما صرفاً یک چکیده است.
.PP
برنامه
.B loggen
ابزاری برای آزمایش و تست فشار (Stress Test) کارگزار
.B syslog
و اتصال به آن است. این ابزار می‌تواند پیام‌های
.B syslog
را با نرخ مشخص و با استفاده از انواع اتصالات و پروتکل‌ها، شامل TCP، UDP و سوکت‌های دامنه یونیکس (unix domain sockets) به کارگزار ارسال کند. پیام‌ها می‌توانند به صورت خودکار تولید شوند (با تکرار مداوم رشته PADD)، یا از یک فایل یا ورودی استاندارد (standard input) خوانده شوند.
.PP
هنگامی که
.B loggen
ارسال پیام‌ها را به پایان می‌رساند، آمار زیر را نمایش می‌دهد:
.RS
.IP \(bu 2
نرخ میانگین (average rate): نرخ میانگین پیام‌های ارسال‌شده بر حسب پیام بر ثانیه.
.IP \(bu 2
تعداد (count): تعداد کل پیام‌های ارسال‌شده.
.IP \(bu 2
زمان (time): زمان صرف‌شده برای ارسال پیام‌ها بر حسب ثانیه.
.IP \(bu 2
اندازه میانگین پیام (average message size): اندازه میانگین پیام‌های ارسال‌شده بر حسب بایت.
.IP \(bu 2
پهنای باند (bandwidth): میانگین پهنای باند مصرفی برای ارسال پیام‌ها بر حسب کیلوبایت بر ثانیه.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\fC\-\-active\-connections <تعداد\-اتصالات>\fR
    تعداد اتصالاتی که
    .B loggen
    برای ارسال پیام‌ها به مقصد استفاده خواهد کرد. این گزینه تنها هنگام استفاده از اتصالات TCP یا TLS به مقصد قابل استفاده است. مقدار پیش‌فرض: 1 است.
    ابزار
    .B loggen
    پیش از شروع ارسال پیام‌ها، تا برقرار شدن تمامی اتصالات منتظر می‌ماند. همچنین گزینه
    \fB\fC\-\-idle\-connections\fR
    را ببینید.
.PP
\fB\fC\-\-csv\fR یا \fB\fC\-C\fR
    ارسال آمار پیام‌های ارسال‌شده به خروجی استاندارد (stdout) در قالب CSV. از این خروجی می‌توان برای رسم نمودار نرخ پیام‌ها استفاده کرد.
.PP
\fB\fC\-\-dgram\fR یا \fB\fC\-D\fR
    استفاده از سوکت دیتاگرام (UDP یا unix\-dgram) برای ارسال پیام‌ها به هدف. این گزینه به گزینه
    .B \-\-inet
    نیز نیاز دارد.
.PP
\fB\fC\-\-dont\-parse\fR یا \fB\fC\-d\fR
    خطوط خوانده‌شده از فایل‌های ورودی را تجزیه (parse) نکن و آن‌ها را همان‌گونه که دریافت شده‌اند ارسال کن.
.PP
\fB\fC\-\-help\fR یا \fB\fC\-h\fR
    نمایش یک پیام راهنمای کوتاه.
.PP
\fB\fC\-\-idle\-connection <تعداد\-اتصالات>\fR
    تعداد اتصالات بی‌کار (idle) که
    .B loggen
    با مقصد برقرار خواهد کرد. توجه داشته باشید که
    .B loggen
    هیچ پیامی روی اتصالات بی‌کار ارسال نمی‌کند، اما اتصال با استفاده از پیام‌های keep\-alive باز نگه داشته می‌شود. این گزینه تنها هنگام استفاده از اتصالات TCP یا TLS به مقصد قابل استفاده است. همچنین گزینه
    .B \-\-active\-connections
    را ببینید. مقدار پیش‌فرض: 0 است.
.PP
\fB\fC\-\-inet\fR یا \fB\fC\-i\fR
    استفاده از پروتکل TCP (به‌صورت پیش‌فرض) یا UDP (هنگامی که همراه با گزینه
    .B \-\-dgram
    استفاده شود) برای ارسال پیام‌ها به هدف.
.PP
\fB\fC\-\-interval <ثانیه>\fR یا \fB\fC\-I <ثانیه>\fR
    تعداد ثانیه‌هایی که
    .B loggen
    اجرا خواهد شد. مقدار پیش‌فرض: 10 است.
.PP
.RS
.nf
نکته: هنگامی که \-\-interval و \-\-number با هم استفاده شوند، loggen تا
زمانی پیام ارسال می‌کند که مدت‌زمان تعیین‌شده در \-\-interval منقضی شود یا
تعداد پیام‌های مشخص‌شده در \-\-number تکمیل گردد؛ هر کدام که زودتر رخ دهد.
.fi
.RE
.PP
\fB\fC\-\-ipv6\fR یا \fB\fC\-6\fR
    تعیین مقصد با استفاده از نشانی IPv6 آن. توجه داشته باشید که مقصد باید یک نشانی واقعی IPv6 داشته باشد.
.PP
\fB\fC\-\-loop\-reading\fR یا \fB\fC\-l\fR
    خواندن فایل مشخص‌شده در گزینه
    \fB\fC\-\-read\-file\fR
    در یک حلقه تکرار:
    .B loggen
    هنگامی که به پایان فایل می‌رسد، خواندن را مجدداً از ابتدای فایل آغاز می‌کند.
.PP
\fB\fC\-\-number <تعداد\-پیام‌ها>\fR یا \fB\fC\-n <تعداد\-پیام‌ها>\fR
    تعداد پیام‌هایی که باید تولید شوند.
.PP
.RS
.nf
نکته: هنگامی که \-\-interval و \-\-number با هم استفاده شوند، loggen تا
زمانی پیام ارسال می‌کند که مدت‌زمان تعیین‌شده در \-\-interval منقضی شود یا
تعداد پیام‌های مشخص‌شده در \-\-number تکمیل گردد؛ هر کدام که زودتر رخ دهد.
.fi
.RE
.PP
\fB\fC\-\-no\-framing\fR یا \fB\fC\-F\fR
    از قاب‌بندی (Framing) سبک پروتکل IETF\-syslog استفاده نکن، حتی اگر گزینه
    \fB\fC\-\-syslog\-proto\fR
    تنظیم شده باشد.
.PP
\fB\fC\-\-quiet\fR یا \fB\fC\-Q\fR
    آمار را تنها پس از اتمام کار
    .B loggen
    نمایش بده. در صورت عدم تنظیم، آمار در هر ثانیه نمایش داده می‌شود.
.PP
\fB\fC\-\-permanent\fR یا \fB\fC\-T\fR
    ادامه ارسال وقایع (لاگ‌ها) به صورت نامحدود و بدون محدودیت زمانی.
.PP
\fB\fC\-\-rate <پیام/ثانیه>\fR یا \fB\fC\-r <پیام/ثانیه>\fR
    تعداد پیام‌های تولیدشده در هر ثانیه برای هر اتصال فعال. مقدار پیش‌فرض: 1000 است.
.PP
.RS
.nf
اگر می‌خواهید نرخ پیام‌ها را در حین اجرای loggen تغییر دهید، سیگنال
SIGUSR1 را برای دو برابر کردن نرخ پیام، یا SIGUSR2 را برای نصف کردن آن
ارسال کنید:

kill \-USR1 <loggen\-pid>
kill \-USR2 <loggen\-pid>
.fi
.RE
.PP
\fB\fC\-\-read\-file <نام\-فایل>\fR یا \fB\fC\-R <نام\-فایل>\fR
    پیام‌ها را از یک فایل بخوان و به هدف ارسال کن. همچنین گزینه
    \fB\fC\-\-skip\-tokens\fR
    را ببینید.
    برای خواندن پیام‌ها از ورودی استاندارد (stdio)، مقدار
    .B \-
    را به عنوان فایل ورودی مشخص کنید. توجه داشته باشید هنگام خواندن پیام‌ها از ورودی استاندارد،
    .B loggen
    تنها می‌تواند از یک ریسه (thread) منفرد استفاده کند. پارامترهای
    .B \-R
    باید در انتهای دستور قرار گیرند، مانند:
    .B loggen 127.0.0.1 1061 \-\-read\-file \-
.PP
\fB\fC\-\-sdata <داده\-ارسال>\fR یا \fB\fC\-p <داده\-ارسال>\fR
    ارسال آرگومان گزینه
    \fB\fC\-\-sdata\fR
    به عنوان بخش
    \fB\fCSDATA\fR
    از پیام‌های پروتکل IETF\-syslog (با فرمت RFC\-5424). این گزینه را همراه با گزینه
    \fB\fC\-\-syslog\-proto\fR
    استفاده کنید.
.PP
.RS
.nf
برای مثال:

\-\-sdata "[test name=\\"value\\"]"
.fi
.RE
.PP
\fB\fC\-\-size <اندازه\-پیام>\fR یا \fB\fC\-s <اندازه\-پیام>\fR
    اندازه یک پیام syslog بر حسب بایت. مقدار پیش‌فرض: 256 است. حداقل مقدار: 127 بایت، حداکثر مقدار: 8192 بایت.
.PP
\fB\fC\-\-skip\-tokens <تعداد>\fR
    نادیده گرفتن تعداد مشخص‌شده‌ای از نشانه‌های (کلمات) جداشده با فاصله در ابتدای هر خط. برای نمونه، اگر پیام‌های موجود در فایل به شکل
    .B foo bar message
    باشند، گزینه
    .B \-\-skip\-tokens 2
    بخش
    .B foo bar
    خط را نادیده گرفته و تنها بخش
    .B message
    را ارسال می‌کند. این گزینه فقط در صورت استفاده به همراه پارامتر
    .B \-\-read\-file
    کاربرد دارد. مقدار پیش‌فرض: 0 است.
.PP
\fB\fC\-\-stream\fR یا \fB\fC\-S\fR
    استفاده از سوکت جریانی (Stream socket شامل TCP یا unix\-stream) برای ارسال پیام‌ها به هدف.
.PP
\fB\fC\-\-syslog\-proto\fR یا \fB\fC\-P\fR
    استفاده از قالب جدید پیام‌های IETF\-syslog. به‌صورت پیش‌فرض،
    .B loggen
    از قالب سنتی پیام‌های BSD\-syslog استفاده می‌کند. همچنین گزینه
    .B \-\-no\-framing
    را ببینید.
.PP
\fB\fC\-\-unix </path/to/socket>\fR یا \fB\fC\-x </path/to/socket>\fR
    استفاده از یک سوکت دامنه یونیکس (UNIX domain socket) برای ارسال پیام‌ها به هدف.
.PP
\fB\fC\-\-use\-ssl\fR یا \fB\fC\-U\fR
    استفاده از یک کانال رمزگذاری‌شده با SSL برای ارسال پیام‌ها به هدف. توجه داشته باشید که بررسی گواهی هدف یا انجام احراز هویت متقابل (Mutual authentication) امکان‌پذیر نیست.
.PP
\fB\fC\-\-version\fR یا \fB\fC\-V\fR
    نمایش شماره نسخه syslog\-ng.
.SH "مثال‌ها (EXAMPLES)"
.PP
دستور زیر ۱۰۰ پیام در هر ثانیه به مدت ده دقیقه تولید می‌کند و آن‌ها را از طریق TCP به پورت ۲۰۱۰ میزبان محلی (localhost) ارسال می‌کند. هر پیام ۳۰۰ بایت طول دارد:
.PP
.RS
.nf
loggen \-\-size 300 \-\-rate 100 \-\-interval 600 127.0.0.1 2010
.fi
.RE
.PP
دستور زیر مشابه دستور بالا است، اما از پروتکل UDP استفاده می‌کند:
.PP
.RS
.nf
loggen \-\-inet \-\-dgram \-\-size 300 \-\-rate 100 \-\-interval 600 127.0.0.1 2010
.fi
.RE
.PP
ارسال یک پیام تکی از طریق TCP6 به نشانی ::1 در پروتکل IPv6، پورت ۱۰۶۱:
.PP
.RS
.nf
loggen \-\-ipv6 \-\-number 1 ::1 1061
.fi
.RE
.PP
ارسال یک پیام تکی از طریق UDP6 به نشانی ::1 در پروتکل IPv6، پورت ۱۰۶۱:
.PP
.RS
.nf
loggen \-\-ipv6 \-\-dgram \-\-number 1 ::1 1061
.fi
.RE
.PP
ارسال یک پیام تکی با استفاده از سوکت دامنه یونیکس:
.PP
.RS
.nf
loggen \-\-unix \-\-stream \-\-number 1 </path/to/socket>
.fi
.RE
.PP
خواندن پیام‌ها از ورودی استاندارد (stdio) و ارسال آن‌ها به میزبان محلی:
.PP
.RS
.nf
loggen 127.0.0.1 1061 \-\-read\-file \-
.fi
.RE
.SH "فایل‌ها (FILES)"
.PP
/Users/hofi/Develop/Balabit/syslog-ng/build/install/bin/loggen
.PP
\fBنکته:\fP
اگر با مشکلی مواجه شدید یا به راهنمایی در مورد
syslog\-ng OSE
نیاز داشتید، به
\fIsyslog\-ng OSE Administration Guide\fP[1]
مراجعه کرده یا از
\fIsyslog\-ng OSE mailing list\fP[2]
دیدن فرمایید.
برای اخبار و اطلاعیه‌های مربوط به
syslog\-ng OSE،
به
\fIsyslog\-ng OSE blogs\fP[3]
مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
.PP
این صفحه راهنما از روی
\fIsyslog\-ng OSE Administration Guide\fP[1]
تولید شده است، که توسط چندین مشارکت‌کننده نوشته شده است و مایلیم از آن‌ها صمیمانه تشکر کنیم.
.SH "حق نشر (COPYRIGHT)"
.SH "نکات (NOTES)"
.PP
[1] \fB\fCsyslog\-ng OSE Administration Guide\fR
    \[la]https://syslog-ng.github.io/admin-guide/README\[ra]
.PP
[2] \fB\fCsyslog\-ng OSE mailing list\fR
    \[la]https://lists.balabit.hu/mailman/listinfo/syslog-ng\[ra]
.PP
[3] \fB\fCsyslog\-ng OSE blogs\fR
    \[la]https://syslog-ng.com/blog\[ra]