نام (NAME)

httpd - سرور پروتکل انتقال ابرمتن آپاچی

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

httpd [ -d serverroot ] [ -f config ] [ -C directive ] [ -c directive ] [ -D parameter ] [ -e level ] [ -E file ] [ -k start|restart|graceful|stop|graceful-stop ] [ -h ] [ -l ] [ -L ] [ -S ] [ -t ] [ -v ] [ -V ] [ -X ] [ -M ] [ -T ]

در سیستم‌های ویندوز، آرگومان‌های اضافی زیر در دسترس هستند:

httpd [ -k install|config|uninstall ] [ -n name ] [ -w ]

توضیحات (DESCRIPTION)

دستور httpd برنامه سرور پروتکل انتقال ابرمتن (HTTP) آپاچی است. این برنامه به گونه‌ای طراحی شده است که به عنوان یک پردازه دیمن مستقل اجرا شود. هنگامی که به این شکل استفاده می‌شود، استخری از پردازه‌ها یا رشته‌های فرزند را برای رسیدگی به درخواست‌ها ایجاد می‌کند.

به طور کلی، httpd نباید مستقیماً فراخوانی شود، بلکه باید از طریق apachectl در سیستم‌های مبتنی بر یونیکس، یا به عنوان یک سرویس در ویندوز NT، 2000 و XP، و به عنوان یک برنامه کنسول در ویندوز 9x و ME اجرا شود.

گزینه‌ها (OPTIONS)

-d serverroot: مقدار اولیه برای دستورالعمل ServerRoot را بر روی serverroot تنظیم می‌کند. این مقدار می‌تواند توسط دستورالعمل ServerRoot در فایل پیکربندی بازنویسی شود. مقدار پیش‌فرض /usr/local/apache2 است.
-f config: از دستورالعمل‌های موجود در فایل config هنگام راه‌اندازی استفاده می‌کند. اگر config با / شروع نشود، به عنوان یک مسیر نسبی نسبت به ServerRoot در نظر گرفته می‌شود. مقدار پیش‌فرض conf/httpd.conf است.
-k start|restart|graceful|stop|graceful-stop: به httpd سیگنال ارسال می‌کند تا شروع به کار کند، بازنشانی شود، یا متوقف شود. برای اطلاعات بیشتر بخش Stopping Apache httpd را ببینید.
-C directive: دستورالعمل پیکربندی directive را قبل از خواندن فایل‌های کانفیگ پردازش می‌کند.
-c directive: دستورالعمل پیکربندی directive را پس از خواندن فایل‌های کانفیگ پردازش می‌کند.
-D parameter: یک parameter پیکربندی تنظیم می‌کند که می‌تواند با بخش‌های <IfDefine> در فایل‌های پیکربندی استفاده شود تا در زمان راه‌اندازی و بازنشانی سرور، دستورات به صورت مشروط نادیده گرفته یا پردازش شوند. همچنین می‌تواند برای تنظیم پارامترهای راه‌اندازی کمتر متداول شامل -DNO_DETACH (جلوگیری از انشعاب والد) و -DFOREGROUND (جلوگیری از فراخوانی setsid() و موارد مشابه توسط والد) استفاده شود.
-e level: سطح گزارش‌گیری LogLevel را در زمان راه‌اندازی سرور روی level تنظیم می‌کند. این گزینه برای افزایش موقت جزئیات پیام‌های خطا جهت یافتن مشکلات هنگام راه‌اندازی کاربرد دارد.
-E file: پیام‌های خطا در طول راه‌اندازی سرور را به file ارسال می‌کند.
-h: خلاصه‌ای کوتاه از گزینه‌های خط فرمان موجود را نمایش می‌دهد.
-l: فهرستی از ماژول‌های کامپایل‌شده در سرور را نمایش می‌دهد. این گزینه ماژول‌هایی را که به صورت پویا با استفاده از دستورالعمل LoadModule بارگذاری شده‌اند فهرست نمی‌کند.
-L: فهرستی از دستورالعمل‌های ارائه‌شده توسط ماژول‌های ایستا را به همراه آرگومان‌های مورد انتظار و مکان‌هایی که دستورالعمل در آن‌ها معتبر است، نمایش می‌دهد. دستورالعمل‌های ارائه‌شده توسط ماژول‌های اشتراکی فهرست نمی‌شوند.
-M: فهرستی از ماژول‌های بارگذاری‌شده ایستا و اشتراکی را نمایش می‌دهد.
-S: تنظیمات تجزیه‌شده از فایل پیکربندی را نشان می‌دهد (در حال حاضر تنها تنظیمات virtualhost را نمایش می‌دهد).
-T (در نسخه 2.3.8 و بالاتر در دسترس است): بررسی شاخه ریشه اسناد (document root) را هنگام راه‌اندازی/بازنشانی نادیده می‌گیرد.
-t: فقط آزمون‌های ساختار نحوی را برای فایل‌های پیکربندی اجرا می‌کند. برنامه بلافاصله پس از این آزمون‌های تجزیه نحوی با کد بازگشتی 0 (Syntax OK) یا کد غیر از 0 (Syntax Error) خارج می‌شود. اگر -D DUMP_VHOSTS نیز تنظیم شده باشد، جزئیات پیکربندی میزبان مجازی چاپ خواهد شد. اگر -D DUMP_MODULES تنظیم شده باشد، تمام ماژول‌های بارگذاری‌شده چاپ می‌شوند.
-v: نسخه httpd را چاپ کرده و سپس خارج می‌شود.
-V: نسخه و پارامترهای ساخت httpd را چاپ کرده و سپس خارج می‌شود.
-X: برنامه httpd را در حالت اشکال‌زدایی اجرا می‌کند. تنها یک فرآیند کارگر شروع به کار خواهد کرد و سرور از کنسول جدا نخواهد شد.

فایل‌ها (FILES)

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

/usr/local/apache2/conf/httpd.conf: فایل اصلی پیکربندی سرور.
/usr/local/apache2/conf/mime.types: نگاشت‌های پیش‌فرض نوع MIME.
/usr/local/apache2/logs/error_log: فایل گزارش خطاها.
/usr/local/apache2/logs/access_log: فایل گزارش دسترسی‌ها.
/usr/local/apache2/logs/httpd.pid: فایل حاوی شناسه فرآیند دیمن در حال اجرا.

آرگومان‌های زیر فقط در پلتفرم ویندوز در دسترس هستند:

-k install|config|uninstall: نصب Apache httpd به عنوان یک سرویس ویندوز NT؛ تغییر گزینه‌های راه‌اندازی برای سرویس Apache httpd؛ و لغو نصب سرویس Apache httpd.
-n name: نام (name) سرویس Apache httpd برای ارسال سیگنال.
-w: پنجره کنسول را در صورت بروز خطا باز نگه می‌دارد تا پیام خطا قابل خواندن باشد.