.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.\" DO NOT EDIT! Generated from XML source.
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
.de Sh \" Subsection
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Ip \" List item
.br
.ie \\n(.$>=3 .ne \\$3
.el .ne 3
.IP "\\$1" \\$2
..
.TH "APACHECTL" 8 "2026-05-08" "Apache HTTP Server" "apachectl"

.SH "نام (NAME)"
apachectl \- رابط کنترل وب‌سرور HTTP آپاچی

.SH "خلاصه دستور (SYNOPSIS)"

.PP
هنگامی که در حالت عبور مستقیم (pass-through) عمل می‌کند، \fBapachectl\fR می‌تواند تمام آرگومان‌های موجود برای باینری \fBhttpd\fR را بپذیرد\&.

.PP
\fB\fBapachectl\fR [ \fIhttpd-argument\fR ]\fR

.PP
هنگامی که در حالت SysV init عمل می‌کند، \fBapachectl\fR دستورات ساده و تک‌کلمه‌ای که در ادامه تعریف شده‌اند را می‌پذیرد\&.

.PP
\fB\fBapachectl\fR \fIcommand\fR\fR


.SH "چکیده (SUMMARY)"

.PP
دستور \fBapachectl\fR یک رابط پیشانی (front end) برای سرور پروتکل انتقال ابرمتن آپاچی (HTTP) است\&. این ابزار به منظور کمک به مدیر سیستم جهت کنترل عملکرد دیمن \fBhttpd\fR آپاچی طراحی شده است\&.

.PP
اسکریپت \fBapachectl\fR می‌تواند در دو حالت کار کند\&. نخست، می‌تواند به عنوان یک پیشانی ساده برای دستور \fBhttpd\fR عمل کند که صرفاً متغیرهای محیطی لازم را تنظیم کرده و سپس \fBhttpd\fR را با ارسال آرگومان‌های خط فرمان فراخوانی می‌کند\&. دوم، \fBapachectl\fR می‌تواند به عنوان یک اسکریپت SysV init عمل کند و آرگومان‌های ساده و تک‌کلمه‌ای مانند \fBstart\fR، \fBrestart\fR و \fBstop\fR را دریافت کرده و آن‌ها را به سیگنال‌های مناسب برای \fBhttpd\fR تبدیل نماید\&.

.PP
اگر نصب آپاچی شما از مسیرهای غیراستاندارد استفاده می‌کند، باید اسکریپت \fBapachectl\fR را برای تنظیم مسیرهای مناسب به باینری \fBhttpd\fR ویرایش کنید\&. همچنین می‌توانید هرگونه آرگومان خط فرمان لازم برای \fBhttpd\fR را مشخص کنید\&. برای جزئیات بیشتر به توضیحات درون اسکریپت مراجعه کنید\&.

.PP
اسکریپت \fBapachectl\fR در صورت موفقیت مقدار خروج 0 و در صورت وقوع خطا مقداری بزرگتر از 0 (>0) برمی‌گرداند\&. برای جزئیات بیشتر، توضیحات درون اسکریپت را مشاهده کنید\&.


.SH "گزینه‌ها (OPTIONS)"

.PP
در اینجا تنها گزینه‌های به سبک SysV init تعریف شده‌اند\&. سایر آرگومان‌ها در صفحه راهنمای \fBhttpd\fR تعریف شده‌اند\&.


.TP
\fBstart\fR
دیمن \fBhttpd\fR آپاچی را راه‌اندازی می‌کند\&. در صورتی که دیمن در حال اجرا باشد، خطا می‌دهد\&. این معادل با \fBapachectl -k start\fR است\&.
.TP
\fBstop\fR
دیمن \fBhttpd\fR آپاچی را متوقف می‌کند\&. این معادل با \fBapachectl -k stop\fR است\&.
.TP
\fBrestart\fR
دیمن \fBhttpd\fR آپاچی را مجدداً راه‌اندازی می‌کند\&. اگر دیمن در حال اجرا نباشد، راه‌اندازی می‌شود\&. این دستور پیش از آغاز راه‌اندازی مجدد، به صورت خودکار فایل‌های پیکربندی را همانند \fBconfigtest\fR بررسی می‌کند تا مطمئن شود دیمن متوقف نمی‌شود\&. این معادل با \fBapachectl -k restart\fR است\&.
.TP
\fBfullstatus\fR
یک گزارش وضعیت کامل از mod_status نمایش می‌دهد\&. برای کارکرد این گزینه، باید mod_status روی سرور شما فعال باشد و یک مرورگر متنی مانند \fBlynx\fR روی سیستم شما در دسترس باشد\&. نشانی اینترنتی (URL) مورد استفاده برای دسترسی به گزارش وضعیت را می‌توان با ویرایش متغیر \fBSTATUSURL\fR در اسکریپت تنظیم کرد\&.
.TP
\fBstatus\fR
یک گزارش وضعیت مختصر نمایش می‌دهد\&. مشابه گزینه \fBfullstatus\fR است، با این تفاوت که فهرست درخواست‌هایی که در حال حاضر به آن‌ها رسیدگی می‌شود حذف شده است\&.
.TP
\fBgraceful\fR
دیمن \fBhttpd\fR آپاچی را به صورت نرم (graceful) مجدداً راه‌اندازی می‌کند\&. اگر دیمن در حال اجرا نباشد، راه‌اندازی می‌شود\&. تفاوت این حالت با راه‌اندازی مجدد عادی در این است که اتصال‌های در حال حاضر باز قطع نمی‌شوند\&. اثر جانبی این امر آن است که فایل‌های گزارش (لاگ) قدیمی بلافاصله بسته نخواهند شد\&. این بدان معناست که اگر در یک اسکریپت چرخش گزارش (log rotation) استفاده شود، ممکن است تاخیر قابل‌توجهی برای اطمینان از بسته شدن فایل‌های گزارش قدیمی قبل از پردازش آن‌ها لازم باشد\&. این دستور پیش از آغاز راه‌اندازی مجدد، به صورت خودکار فایل‌های پیکربندی را همانند \fBconfigtest\fR بررسی می‌کند تا مطمئن شود آپاچی متوقف نمی‌شود\&. این معادل با \fBapachectl -k graceful\fR است\&.
.TP
\fBgraceful-stop\fR
دیمن \fBhttpd\fR آپاچی را به صورت نرم (graceful) متوقف می‌کند\&. تفاوت این حالت با توقف عادی در این است که اتصال‌های در حال حاضر باز قطع نمی‌شوند\&. اثر جانبی این امر آن است که فایل‌های گزارش قدیمی بلافاصله بسته نخواهند شد\&. این معادل با \fBapachectl -k graceful-stop\fR است\&.
.TP
\fBconfigtest\fR
آزمون نحو (سینتکس) فایل پیکربندی را اجرا می‌کند\&. این دستور فایل‌های پیکربندی را تجزیه کرده و یا عبارت \fBSyntax Ok\fR را گزارش می‌دهد یا اطلاعات دقیقی درباره خطای نحوی خاص ارائه می‌کند\&. این معادل با \fBapachectl -t\fR است\&.

.PP
گزینه زیر در نسخه‌های قبلی در دسترس بود اما حذف شده است\&.


.TP
\fBstartssl\fR
برای راه‌اندازی \fBhttpd\fR با پشتیبانی از SSL، باید فایل پیکربندی خود را ویرایش کنید تا دستورالعمل‌های مربوطه را شامل شود و سپس از دستور عادی \fBapachectl start\fR استفاده کنید\&.

.SH "فایل‌ها (FILES)"

.PP
مسیرهای پیش‌فرض ذکرشده در زیر ممکن است در زمان کامپایل تغییر کرده باشند\&. برای مکان‌های واقعی به نصب محلی خود مراجعه کنید\&.


.TP
\fB/usr/local/apache2/bin/envvars\fR
تنظیمات متغیرهای محیطی که در زمان راه‌اندازی بارگذاری (source) می‌شوند\&.
.TP
\fB/usr/local/apache2/bin/httpd\fR
باینری httpd که توسط apachectl فراخوانی می‌شود\&.