apxs - آنلاین در ابر

برنامه:

نام

apxs - ابزار eXtenSion APache

خلاصه

apxs -g [-S نام=ارزش ] -n نام mod

apxs -q [-v ] [-S نام=ارزش ] پرس و جو ...

apxs -c [-S نام=ارزش ] [-o dsofile ] [-I incdir ] [-D نام=ارزش ] [-L libdir ] [
-l libname ] [-دستشویی،کامپایلر-پرچم ها ] [-Wlپرچم های پیوند دهنده ] فایل ها ...

apxs -i [-S نام=ارزش ] [-n نام mod ] [-a ] [-A ] dso-فایل ...

apxs -e [-S نام=ارزش ] [-n نام mod ] [-a ] [-A ] dso-فایل ...

خلاصه

apxs ابزاری برای ساخت و نصب ماژول های افزونه برای HyperText آپاچی است
سرور پروتکل انتقال (HTTP). این با ساختن یک شی مشترک پویا به دست می آید
(DSO) از یک یا چند منبع یا شی فایل ها که سپس می تواند در آپاچی بارگذاری شود
سرور تحت زمان اجرا از طریق دستورالعمل LoadModule از mod_so.

بنابراین برای استفاده از این مکانیسم توسعه، پلت فرم شما باید از ویژگی DSO و شما پشتیبانی کند
باینری httpd آپاچی باید با ماژول mod_so ساخته شود. ابزار apxs به طور خودکار
اگر اینطور نیست شکایت می کند. شما می توانید این مورد را خودتان با اجرای دستی بررسی کنید
فرمان

$ httpd -l

ماژول mod_so باید بخشی از لیست نمایش داده شده باشد. اگر این الزامات هستند
انجام شده است، شما به راحتی می توانید عملکرد سرور آپاچی خود را با نصب سرور خود گسترش دهید
ماژول هایی با مکانیزم DSO با کمک این ابزار apxs:

$ apxs -i -a -c mod_foo.c
gcc -fpic -DSHARED_MODULE -I/path/to/apache/include -c mod_foo.c
ld -Bshareable -o mod_foo.so mod_foo.o
cp mod_foo.so /path/to/apache/modules/mod_foo.so
chmod 755 /path/to/apache/modules/mod_foo.so
[فعال کردن ماژول «foo» در /path/to/apache/etc/httpd.conf]
$ apachectl راه اندازی مجدد
/path/to/apache/sbin/apachectl راه اندازی مجدد: httpd اجرا نمی شود، تلاش برای شروع
[سه‌شنبه 31 مارس 11 27:55:1998] [اشکال‌زدایی] mod_so.c(303): ماژول بارگذاری شده foo_module
/path/to/apache/sbin/apachectl راه اندازی مجدد: httpd شروع شد
$_

استدلال ها فایل ها می تواند هر فایل منبع C (.c)، یک فایل شی (.o) یا حتی یک کتابخانه باشد
آرشیو (.a). ابزار apxs به طور خودکار این افزونه ها را تشخیص می دهد و به صورت خودکار
از فایل های منبع C برای کامپایل استفاده می کند در حالی که فقط از شی و فایل های بایگانی استفاده می کند
مرحله پیوند اما هنگام استفاده از چنین اشیایی از پیش کامپایل شده مطمئن شوید که آنها کامپایل شده اند
برای کد مستقل موقعیت (PIC) تا بتوان از آنها برای اشتراک گذاری بارگذاری شده پویا استفاده کرد
هدف - شی. به عنوان مثال با GCC شما همیشه باید از -fpic استفاده کنید. برای سایر کامپایلرهای C
برای مشاهده پرچم هایی که apxs برای کامپایل فایل های شی استفاده می کند، به صفحه کتابچه راهنمای آن مراجعه کنید.

برای جزئیات بیشتر در مورد پشتیبانی DSO در آپاچی، مستندات mod_so یا شاید را بخوانید
حتی فایل منبع src/modules/standard/mod_so.c را بخوانید.

OPTIONS

مشترک گزینه
-n نام mod
این به صراحت نام ماژول را برای -i (نصب) و -g (الگو) تنظیم می کند
نسل) گزینه. از این برای تعیین صریح نام ماژول استفاده کنید. برای گزینه -g
این مورد نیاز است، برای گزینه -i ابزار apxs سعی می کند نام را از روی تعیین کند
منبع یا (به عنوان یک بازگشت) حداقل با حدس زدن آن از روی نام فایل.

پرس و جو گزینه
-q یک پرس و جو برای متغیرها و تنظیمات محیطی که برای ساخت httpd استفاده می شود انجام می دهد. چه زمانی
بدون احضار پرس و جو پارامترها، تمام متغیرهای شناخته شده و مقادیر آنها را چاپ می کند.
پارامتر اختیاری -v خروجی لیست را فرمت می کند. .PP از این به صورت دستی استفاده کنید
تنظیمات مورد استفاده برای ساخت httpd را تعیین کنید که ماژول شما را بارگیری می کند. برای مثال
در صورت نیاز به کتابچه راهنمای کاربر، از INC=-I`apxs -q INCLUDEDIR` .PP در Makefiles خود استفاده کنید.
دسترسی به فایل های هدر C آپاچی

پیکر بندی گزینه
-S نام=ارزش
این گزینه تنظیمات apxs که در بالا توضیح داده شد را تغییر می دهد.

قالب نسل گزینه
-g این یک زیر شاخه تولید می کند نام (به گزینه -n مراجعه کنید) و دو فایل وجود دارد: یک نمونه
فایل منبع ماژول با نام mod_نام.c که می تواند به عنوان یک الگو برای ایجاد استفاده شود
ماژول های خود یا به عنوان یک شروع سریع برای بازی با مکانیسم apxs. و الف
Makefile مربوطه برای ساخت و نصب آسان تر این ماژول.

DSO فيلم هاي سكسي تلفيقي گزینه
-c این نشان دهنده عملیات کامپایل است. ابتدا فایل های منبع C (.c) را کامپایل می کند.
of فایل ها به فایل های شی مربوطه (.o) و سپس یک اشتراک گذاری پویا می سازد
شی در dsofile با پیوند دادن این فایل های شی به اضافه فایل های شی باقی مانده (.o
و .الف) از فایل ها. اگر گزینه -o مشخص نشده باشد، فایل خروجی از روی حدس زده می شود
اولین نام فایل در فایل ها و بنابراین معمولاً به صورت پیش فرض mod_ استنام.بنابراین.

-o dsofile
نام فایل شی به اشتراک گذاشته شده به صورت پویا را به صراحت مشخص می کند. اگر نه
مشخص شده است و نام آن را نمی توان حدس زد فایل ها لیست، نام جایگزین
mod_unknown.so استفاده می شود.

-D نام=ارزش
این گزینه مستقیماً به دستور(های) کامپایل ارسال می شود. از این استفاده کنید تا
تعریف های خود را به فرآیند ساخت اضافه کنید.

-I incdir
این گزینه مستقیماً به دستور(های) کامپایل ارسال می شود. از این استفاده کنید تا
دایرکتوری های شامل خود را برای جستجو به فرآیند ساخت اضافه کنید.

-L libdir
این گزینه مستقیماً به دستور linker منتقل می شود. از این برای اضافه کردن خود استفاده کنید
دایرکتوری های کتابخانه خود را برای جستجو در فرآیند ساخت.

-l libname
این گزینه مستقیماً به دستور linker منتقل می شود. از این برای اضافه کردن خود استفاده کنید
کتابخانه های خود را برای جستجو در فرآیند ساخت.

-دستشویی،کامپایلر-پرچم ها
این گزینه می گذرد کامپایلر-پرچم ها به عنوان پرچم های اضافی برای libtool --mode=compile
فرمان از این برای اضافه کردن گزینه های مخصوص کامپایلر محلی استفاده کنید.

-Wl،پرچم های پیوند دهنده
این گزینه می گذرد پرچم های پیوند دهنده به عنوان پرچم های اضافی برای libtool --mode=link
فرمان از این برای اضافه کردن گزینه‌های خاص پیوند دهنده محلی استفاده کنید.

-p این گزینه باعث می شود apx ها با کتابخانه های apr/apr-util پیوند پیدا کنند. این مفید است
هنگام کامپایل برنامه های کمکی که از کتابخانه های apr/apr-util استفاده می کنند.

DSO نصب و راه اندازی و پیکر بندی گزینه
-i این عملیات نصب را نشان می دهد و یک یا چند به صورت پویا نصب می کند
اشیاء به اشتراک گذاشته شده در سرور ماژول ها دایرکتوری.

-a این ماژول را با افزودن خودکار یک خط LoadModule مربوطه فعال می کند
به فایل پیکربندی httpd.conf آپاچی، یا با فعال کردن آن در صورتی که از قبل وجود داشته باشد.

-یک گزینه مشابه -a اما دستور LoadModule ایجاد شده با علامت هش پیشوند است.
(#) ، به عنوان مثال، ماژول فقط برای فعال سازی بعدی آماده شده است اما در ابتدا غیرفعال شده است.

-e این نشان دهنده عملیات ویرایش است که می تواند با گزینه های -a و -A استفاده شود
مشابه عملیات -i برای ویرایش فایل پیکربندی httpd.conf آپاچی
بدون تلاش برای نصب ماژول.

مثال ها

فرض کنید یک ماژول آپاچی به نام mod_foo.c در دسترس دارید که باید Apache را گسترش دهد
عملکرد سرور برای انجام این کار ابتدا باید منبع C را در a کامپایل کنید
شی مشترک مناسب برای بارگیری در سرور آپاچی در زمان اجرا از طریق موارد زیر
فرمان:

$ apxs -c mod_foo.c
/path/to/libtool --mode=compile gcc ... -c mod_foo.c
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
$_

سپس باید با اطمینان از وجود دستورالعمل LoadModule، پیکربندی آپاچی را به روز کنید
برای بارگیری این شی مشترک موجود است. برای ساده کردن این مرحله، apxs یک راه خودکار ارائه می دهد
برای نصب شی به اشتراک گذاشته شده در دایرکتوری "modules" و به روز رسانی فایل httpd.conf
بر این اساس. این را می توان با دویدن به دست آورد:

$ apxs -i -a mod_foo.la
/path/to/instdso.sh mod_foo.la /path/to/apache/modules
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
...
chmod 755 /path/to/apache/modules/mod_foo.so
[فعال کردن ماژول «foo» در /path/to/apache/conf/httpd.conf]
$_

به این ترتیب یک خط به نام

LoadModule foo_module modules/mod_foo.so

در صورت عدم وجود به فایل پیکربندی اضافه می شود. اگر می خواهید این را غیرفعال کنید
به صورت پیش فرض از گزینه -A استفاده کنید، به عنوان مثال

$ apxs -i -A mod_foo.c

برای آزمایش سریع مکانیزم apxs می‌توانید یک نمونه الگوی ماژول آپاچی بسازید
یک Makefile مربوطه از طریق:

$ apxs -g -n foo
ایجاد [DIR] foo
ایجاد [FILE] foo/Makefile
ایجاد [FILE] foo/modules.mk
ایجاد [FILE] foo/mod_foo.c
ایجاد [FILE] foo/.deps
$_

سپس می توانید بلافاصله این ماژول نمونه را در یک شیء مشترک کامپایل کرده و آن را در آن بارگذاری کنید
سرور آپاچی:

$ CD foo
$ همه را دوباره بارگذاری کنید
apxs -c mod_foo.c
/path/to/libtool --mode=compile gcc ... -c mod_foo.c
/path/to/libtool --mode=link gcc ... -o mod_foo.la mod_foo.slo
apxs -i -a -n "foo" mod_foo.la
/path/to/instdso.sh mod_foo.la /path/to/apache/modules
/path/to/libtool --mode=install cp mod_foo.la /path/to/apache/modules
...
chmod 755 /path/to/apache/modules/mod_foo.so
[فعال کردن ماژول «foo» در /path/to/apache/conf/httpd.conf]
راه اندازی مجدد آپاچکتل
/path/to/apache/sbin/apachectl راه اندازی مجدد: httpd اجرا نمی شود، تلاش برای شروع
[سه‌شنبه 31 مارس 11 27:55:1998] [اشکال‌زدایی] mod_so.c(303): ماژول بارگذاری شده foo_module
/path/to/apache/sbin/apachectl راه اندازی مجدد: httpd شروع شد
$_

با استفاده از خدمات onworks.net از apx ها به صورت آنلاین استفاده کنید