.\" -*- 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_CGI 1"
.TH SMOKEPING_CGI 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_cgi \- رابط کاربری تحت وب SmokePing
.SH "نمای کلی (OVERVIEW)"
.IX Header "OVERVIEW"
این اسکریپت به عنوان یک «وب‌سایت» برای عملیات پایش SmokePing شما عمل می‌کند. این برنامه اهدافی را که پایش می‌کنید در یک ساختار درختی نمایش داده و نمودارها را بر اساس نیاز کاربرانی که صفحات را مشاهده می‌کنند، رسم می‌نماید.
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
برای راه‌اندازی و اجرای \fBsmokeping_cgi\fR، به یک وب‌سرور نیاز دارید که امکان اجرای اسکریپت‌های CGI یا ترجیحاً FastCGI را برای شما فراهم کند. سیستم باید به‌گونه‌ای پیکربندی شود که فرایند cgi اجازهٔ نوشتن در ناحیهٔ کَش تصاویر (همان‌طور که در فایل پیکربندی تعریف شده است) را داشته باشد.
.PP
این اسکریپت به صورت یک CGI معمولی به خوبی کار می‌کند، \fBاما\fR بسیار کُند به نظر خواهد رسید؛ چرا که هنگام راه‌اندازی کارهای زیادی انجام می‌دهد. بنابراین اگر قرار باشد اسکریپت با هر کلیک از نو اجرا شود، هم زمان‌بر خواهد بود و هم بار سنگینی بر دوش وب‌سرور شما خواهد گذاشت. از این رو، اکیداً توصیه می‌شود از FastCGI استفاده کنید.
.PP
لطفاً برای دریافت دستورالعمل‌های جامع راه‌اندازی، به مستندات نصب مراجعه کنید.
.SH "راه‌اندازی (SETUP)"
.IX Header "SETUP"
یک دایرکتوری نمونهٔ \fIhtdocs\fR در ریشهٔ نصب smokeping شما قرار دارد. محتوای آن را به مکانی که وب‌سرور شما فایل‌هایش را در آن انتظار دارد کپی کنید. اسکریپت fcgi روش ارجح برای اجرای smokeping را نشان می‌دهد. شما همچنین می‌توانید smokeping را به عنوان یک cgi اجرا کنید؛ اما اطمینان حاصل کنید که حتماً از wrapper استفاده نمایید، چرا که افشای مستقیم ARGV به وب‌سرور نمایانگر یک آسیب‌پذیری امنیتی است که احتمالاً ترجیح می‌دهید با آن مواجه نشوید.
.PP
مسیرها را در اسکریپت تنظیم کنید؛ پس از آن همه‌چیز آمادهٔ استفاده خواهد بود.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBsmokeping_config\fR\|(5), \fBsmokeping\fR\|(1), \fBsmokeping_install\fR\|(7),
\&\fBsmokeping_upgrade\fR\|(7)
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.IX Header "COPYRIGHT"
حق نشر (c) ۲۰۱۱ متعلق به Tobias Oetiker. تمامی حقوق محفوظ است.
.SH "مجوز (LICENSE)"
.IX Header "LICENSE"
این برنامه یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU GPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، چه نسخهٔ ۲ مجوز و چه (به انتخاب خودتان) هر نسخهٔ بعدی دیگری، بازتوزیع کرده و/یا تغییر دهید.
.PP
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا تناسب برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید.
.PP
شما باید به همراه این برنامه یک نسخه از «مجوز عمومی همگانی گنو» را دریافت کرده باشید؛ در غیر این صورت، به آدرس زیر نامه ارسال کنید:
Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
Tobias Oetiker <tobi@oetiker.ch>