.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "SMOKEPING 1"
.TH SMOKEPING 1 2025-06-29 2.9.0 SmokePing
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
smokeping \- ابزار خط فرمان برای سامانه SmokePing
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBsmokeping\fR [ \fB\-\-email\fR | \fB\-\-makepod\fR | \fB\-\-version\fR | \fB\-\-restart\fR ]
.PP
.Vb 1
\& گزینه‌ها:
\&
\& \-\-man[=x]    نمایش صفحه راهنما (manpage) برای برنامه (یا برای کاوشگر x در صورت تعیین)
\&
\& \-\-help       راهنما :\-)
\&
\& \-\-email      ارسال عاملهای SmokePing به همه مقصدهای علامتگذاری شده به صورت DYNAMIC
\&
\& \-\-config=x   استفاده از فایل پیکربندی غیر از پیش‌فرض
\&
\& \-\-check      تنها بررسی نحو (سنتکس) فایل پیکربندی، دیمن را اجرا نکن
\&
\& \-\-makepod[=x] تولید مستندات POD از روی فایل پیکربندی (یا برای کاوشگر x در صورت تعیین)
\&
\& \-\-version    نمایش نسخه SmokePing
\&
\& \-\-debug      اجرا فقط برای یک بار و عدم انشعاب در پس‌زمینه (بدون Fork)
\&
\& \-\-debug\-daemon اجرای دیمن در حالت اشکال‌زدایی فعال
\&
\& \-\-restart    راه‌اندازی مجدد SmokePing
\&
\& \-\-reload     بارگذاری مجدد پیکربندی در فرآیند جاری بدون متوقف ساختن کاوشگرها
\&
\& \-\-nodaemon    عدم اجرای فرآیند به صورت دیمن (بدون انشعاب یا fork)
\&
\& \-\-filter=x   تنها اندازه‌گیری مدخل‌هایی که فیلتر x را برآورده می‌کنند
\&
\& \-\-logfile=x    الحاق هشدارها به فایل لاگ x.
\&
\& \-\-static[=x] ایجاد یک وب‌سایت ایستا در پوشه x. اگر x مشخص نشود،
\&              از مقدار pagedir موجود در فایل پیکربندی استفاده می‌شود.
\&
\& \-\-nosleep    برای اشکال‌زدایی ممکن است بخواهید SmokePing را بدون وقفه زمانی اجرا کنید
\&
\& \-\-gen\-examples تولید مستند smokeping_examples و فایلهای پیکربندی نمونه
\&                (جهت استفاده حین ساخت بسته‌ها درون سورس smokeping)
\&                همراه با \-\-check : بررسی صحت نحو نمونه‌های تولید شده.
\&
\& \-\-master\-url=s اجرای smokeping در حالت slave. اتصال به سرور اصلی برای دریافت پیکربندی.
\&
\& \-\-slave\-name=s به طور پیش‌فرض، اسلیو هنگام ارتباط با سرور اصلی از نام شناسایی خود
\&                استفاده می‌کند. در صورت نیاز می‌توانید این مقدار را بازنویسی کنید.
\&
\&
\& \-\-shared\-secret=s فایلی حاوی رمز مشترک برای برقراری ارتباط ایمن با سرور.
\&
\& \-\-cache\-dir=s پوشه ذخیره‌سازی موقت داده‌ها هنگام اجرا در حالت slave.
\&
\& \-\-pid\-dir=s پوشه نگهداری فایل PID هنگام اجرا در حالت slave.
\&             (اختیاری، پیش‌فرض برابر با \-\-cache\-dir است)
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
ابزار \fBsmokeping\fR بخش خط فرمانی سامانه SmokePing است. وظیفه اصلی آن اجرا در قالب یک دیمن و ارسال پینگ به تمام اهدافی (Targets) است که در فایل پیکربندی تعیین کرده‌اید. چنانچه \fBsmokeping\fR را بدون هیچ آرگومانی اجرا کنید، به صورت یک دیمن در پس‌زمینه شروع به کار کرده و وظایف خود را به انجام می‌رساند.
.PP
در صورت فراخوانی به همراه آرگومان، قابلیت‌های تکمیلی آن فعال می‌شوند، همان‌گونه که در بخش خلاصه دستور در بالا نشان داده شده است. کاربرد گزینه \fB\-\-email\fR در مستندات مربوط به فایل پیکربندی شرح داده شده است.
.PP
گزینه \fB\-\-filter\fR به شما اجازه می‌دهد تا دیمن را با یک فایل پیکربندی بزرگ اجرا کرده، اما آن را فیلتر کنید تا تنها مدخل‌هایی که با فیلتر همخوانی دارند پایش و اندازه‌گیری شوند. این قابلیت برای اندازه‌گیری‌های توزیع‌شده و از راه دور بسیار سودمند است. به عنوان مثال، می‌توانید Smokeping را با دو فیلتر مجزا در دو موقعیت مکانی مختلف اجرا کرده و سپس داده‌های rrd حاصله را با استفاده از rsync به سرور وبی که اسکریپت cgi را اجرا می‌کند منتقل سازید. فیلترها روی نام بخش‌های موجود در فایل پیکربندی اعمال می‌شوند. نام‌های بخش‌های تودرتو مانند ساختار مسیرها با \fB/\fR به یکدیگر متصل می‌شوند:
.PP
.Vb 6
\& *** targets ***
\& + A
\& ....
\& + B
\& ...
\& ++ C
.Ve
.PP
این پیکربندی مسیرهای زیر را می‌سازد:
.PP
.Vb 1
\& /A
.Ve
.PP
و
.PP
.Vb 1
\& /B, /B/C
.Ve
.PP
اگر بخواهید بخش /A را پایش نمایید، فیلتر به صورت زیر خواهد بود:
.PP
.Vb 1
\& \-\-filter=/A
.Ve
.PP
فیلترها از قواعد عبارت‌های باقاعده (regular expressions) پیروی می‌کنند و همواره از ابتدای رشته فیلتر بررسی می‌شوند. با افزودن علامت \fB!\fR به ابتدای رشته فیلتر، آن را منفی (نقیض) می‌کنید؛ بنابراین مدخل‌های منطبق از فرآیند پایش مستثنی خواهند شد. می‌توان از چندین آرگومان \fB\-\-filter\fR برای ایجاد شروط پیچیده‌تر استفاده کرد:
.PP
.Vb 1
\&  \-\-filter=/A \-\-filter=/B
.Ve
.PP
تمامی اهداف موجود در /A و /B را شامل می‌شود، در حالی که دستور:
.PP
.Vb 1
\&  \-\-filter=/A \-\-filter=/B \-\-filter=!/B/C
.Ve
.PP
تمامی موارد را به جز زیرشاخه /B/C شامل خواهد شد.
.PP
گزینه \fB\-\-makepod\fR به صورت داخلی برای استخراج و تولید مستندات پیکربندی SmokePing به کار می‌رود.
.PP
برای دریافت راهنمای گام به گام و کامل راه‌اندازی، لطفاً به سند راهنمای نصب مراجعه نمایید.
.SH "راه‌اندازی (SETUP)"
.IX Header "SETUP"
هنگام نصب برنامه SmokePing، این فایل باید متناسب با پیکربندی سیستم محلی شما ویرایش شود. سه مسیر اصلی باید در آن درج گردند:
.PP
مسیری که به محل نصب \fBrrdtool\fR اشاره می‌کند:
.PP
.Vb 1
\& use lib qw(/usr/pack/rrdtool\-1.0.33\-to/lib/perl);
.Ve
.PP
مسیری که محل نصب کتابخانه‌های SmokePing را مشخص می‌کند:
.PP
.Vb 1
\& use lib qw(/home/oetiker/public_html/smokeping/lib);
.Ve
.PP
مسیر سوم به عنوان آرگومان به دستور Smokeping::main داده می‌شود که مشخص‌کننده مسیر فایل پیکربندی SmokePing است:
.PP
.Vb 2
\& use Smokeping;
\& Smokeping::main("/home/oetiker/.smokeping/config");
.Ve
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBsmokeping_config\fR\|(5), \fBsmokeping_examples\fR\|(5), \fBsmokeping_cgi\fR\|(1),
\&\fBtSmoke\fR\|(1), \fBsmokeping_master_slave\fR\|(7), \fBsmokeping_extend\fR\|(7),
\&\fBsmokeping_install\fR\|(7), \fBsmokeping_upgrade\fR\|(7),
راهنمای خواندن نمودارها https://oss.oetiker.ch/smokeping/doc/reading.en.html
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر (c) 2002 متعلق به Tobias Oetiker. تمامی حقوق محفوظ است.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) طبق آنچه بنیاد نرم‌افزارهای آزاد منتشر کرده است، بازتوزیع کنید یا تغییر دهید؛ چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی دیگری.
.PP
این برنامه با این امید توزیع شده است که سودمند باشد، اما فاقد هرگونه ضمانت است؛ حتی بدون ضمانت ضمنی «قابل فروش بودن» یا «مناسب بودن برای یک هدف خاص». برای جزئیات بیشتر متن کامل «مجوز عمومی همگانی گنو» را مطالعه فرمایید.
.PP
شما باید به همراه این برنامه نسخه‌ای از «مجوز عمومی همگانی گنو» را دریافت کرده باشید؛ در غیر این صورت به آدرس زیر مکاتبه کنید:
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
Tobias Oetiker <tobi@oetiker.ch>