apxs - عبر الإنترنت في السحابة

برنامج:

اسم

apxs - أداة تمديد Apache

موجز

أبكسس -g [-S الاسم=قيمنا ] -n com.modname

أبكسس -q [-v ] [-S الاسم=قيمنا ] سؤال

أبكسس -c [-S الاسم=قيمنا ] [-o com.dsofile ] [-I incdir ] [-D الاسم=قيمنا ] [-L لبدير ] [
-l ليبنام ] [-مرحاض،أعلام المترجم ] [-WL ،رابط الأعلام ] ملفات

أبكسس -i [-S الاسم=قيمنا ] [-n com.modname ] [-a ] [-A ] dso- ملف

أبكسس -e [-S الاسم=قيمنا ] [-n com.modname ] [-a ] [-A ] dso- ملف

ملخص

apxs هي أداة لبناء وتثبيت وحدات الامتداد لـ Apache HyperText
خادم بروتوكول النقل (HTTP). يتم تحقيق ذلك من خلال بناء كائن مشترك ديناميكي
(DSO) من مصدر أو كائن واحد أو أكثر ملفات والتي يمكن تحميلها بعد ذلك في Apache
الخادم تحت وقت التشغيل عبر توجيه LoadModule من mod_so.

لذا لاستخدام آلية الامتداد هذه ، يجب أن يدعم النظام الأساسي الخاص بك ميزة DSO وميزة
يجب إنشاء ملف Apache httpd الثنائي باستخدام الوحدة النمطية mod_so. أداة apxs تلقائيًا
يشكو إذا لم يكن هذا هو الحال. يمكنك التحقق من ذلك بنفسك عن طريق تشغيل ملف
أمر

$ httpd -l

يجب أن تكون الوحدة النمطية mod_so جزءًا من القائمة المعروضة. إذا كانت هذه المتطلبات
يمكنك بسهولة توسيع وظائف خادم Apache عن طريق تثبيت وظيفتك الخاصة
وحدات مع آلية 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) لتتمكن من استخدامها لمشاركة محملة ديناميكيًا
هدف. على سبيل المثال ، مع دول مجلس التعاون الخليجي ، عليك دائمًا استخدام -fpic. لمجمعي C الآخرين
راجع صفحة الدليل الخاصة بها أو راقب استخدامات apxs للعلامات لتجميع ملفات الكائنات.

لمزيد من التفاصيل حول دعم DSO في Apache ، اقرأ وثائق mod_so أو ربما
حتى اقرأ الملف المصدر src / modules / standard / mod_so.c.

OPTIONS

مشترك مزيد من الخيارات
-n com.modname
هذا يحدد بشكل صريح اسم الوحدة لكل من -i (install) و -g (template
جيل) الخيار. استخدم هذا لتحديد اسم الوحدة بشكل صريح. للخيار ز
هذا مطلوب ، بالنسبة للخيار -i ، تحاول أداة apxs تحديد الاسم من ملف
المصدر أو (كبديل) على الأقل بتخمينه من اسم الملف.

سؤال مزيد من الخيارات
-q يقوم بإجراء استعلام عن المتغيرات وإعدادات البيئة المستخدمة لبناء httpd. متى
التذرع بدون سؤال المعلمات ، تطبع جميع المتغيرات المعروفة وقيمها.
تقوم المعلمة الاختيارية -v بتنسيق إخراج القائمة. .PP استخدم هذا يدويًا
تحديد الإعدادات المستخدمة لبناء httpd الذي سيحمل الوحدة الخاصة بك. على سبيل المثال
استخدم INC = -I`apxs -q INCLUDEDIR` .PP داخل ملفات Makefiles الخاصة بك إذا كنت بحاجة إلى دليل
الوصول إلى ملفات رأس C في Apache.

الاعداد مزيد من الخيارات
-S الاسم=قيمنا
يغير هذا الخيار إعدادات apxs الموضحة أعلاه.

قالب جيل مزيد من الخيارات
-g يؤدي هذا إلى إنشاء دليل فرعي الاسم (انظر الخيار ن) وهناك ملفان: عينة
ملف مصدر الوحدة النمطية المسمى mod_الاسم.c والتي يمكن استخدامها كنموذج للإنشاء
الوحدات النمطية الخاصة بك أو كبداية سريعة للعب بآلية أبكسس. وأ
Makefile المطابق لبناء وتثبيت أسهل لهذه الوحدة.

DSO مجموعة مزيد من الخيارات
-c يشير هذا إلى عملية التجميع. يقوم أولاً بتجميع ملفات المصدر C (.c)
of ملفات إلى ملفات الكائنات المقابلة (.o) ثم ينشئ ملفًا مشتركًا ديناميكيًا
الكائن في com.dsofile من خلال ربط ملفات الكائنات هذه بالإضافة إلى ملفات الكائنات المتبقية (.o
و. أ) من ملفات. إذا تم تحديد الخيار no -o ، فسيتم تخمين ملف الإخراج من ملف
اسم الملف الأول في ملفات وبالتالي عادةً ما يتم تعيينه افتراضيًا على mod_الاسم.لذا.

-o com.dsofile
يحدد بشكل صريح اسم ملف الكائن المشترك الذي تم إنشاؤه ديناميكيًا. ان لم
المحدد ولا يمكن تخمين الاسم من ملف ملفات القائمة ، الاسم الاحتياطي
mod_unknown.so يستخدم.

-D الاسم=قيمنا
يتم تمرير هذا الخيار مباشرة إلى أمر (أوامر) الترجمة. استخدم هذا ل
أضف التعريفات الخاصة بك إلى عملية البناء.

-I incdir
يتم تمرير هذا الخيار مباشرة إلى أمر (أوامر) الترجمة. استخدم هذا ل
أضف الدلائل الخاصة بك للبحث في عملية البناء.

-L لبدير
يتم تمرير هذا الخيار مباشرة من خلال الأمر linker. استخدم هذا لإضافة ملف
أدلة المكتبة الخاصة للبحث في عملية البناء.

-l ليبنام
يتم تمرير هذا الخيار مباشرة من خلال الأمر linker. استخدم هذا لإضافة ملف
المكتبات الخاصة للبحث في عملية البناء.

-مرحاض،أعلام المترجم
هذا الخيار يمر أعلام المترجم كأعلام إضافية إلى libtool --mode = compile
يأمر. استخدم هذا لإضافة خيارات خاصة بالمترجم المحلي.

-Wl ،رابط الأعلام
هذا الخيار يمر رابط الأعلام كأعلام إضافية إلى libtool --mode = link
يأمر. استخدم هذا لإضافة خيارات خاصة بالرابط المحلي.

-p يؤدي هذا الخيار إلى ربط أبكس بمكتبات apr / apr-util. وهذا مفيد
عند تجميع البرامج المساعدة التي تستخدم مكتبات apr / apr-util.

DSO التنزيل و الاعداد مزيد من الخيارات
-i يشير هذا إلى عملية التثبيت ويقوم بتثبيت واحد أو أكثر ديناميكيًا
الكائنات المشتركة في الخادم نماذج الدليل.

-a هذا ينشط الوحدة عن طريق إضافة سطر LoadModule المقابل تلقائيًا
إلى ملف التكوين httpd.conf الخاص بـ Apache ، أو عن طريق تمكينه إذا كان موجودًا بالفعل.

-A نفس الخيار -a ولكن توجيه LoadModule الذي تم إنشاؤه مسبوق بعلامة التجزئة
(#) ، أي، تم تجهيز الوحدة للتو للتنشيط لاحقًا ولكن تم تعطيلها في البداية.

-e يشير هذا إلى عملية التحرير ، والتي يمكن استخدامها مع خياري -a و -A
بشكل مشابه لعملية -i لتحرير ملف تكوين httpd.conf الخاص بـ Apache
دون محاولة تثبيت الوحدة.

أمثلة

افترض أن لديك وحدة Apache تسمى mod_foo.c متاحة والتي يجب أن توسع Apache's
وظائف الخادم. لتحقيق ذلك ، عليك أولاً ترجمة مصدر C إلى ملف
كائن مشترك مناسب للتحميل في خادم Apache خلال وقت التشغيل عبر ما يلي
أمر:

apxs $ mod_foo.c
/ path / to / libtool --mode = تجميع gcc ... -c mod_foo.c
/ path / to / libtool --mode = link gcc ... -o mod_foo.la mod_foo.slo
_ دولار

ثم يتعين عليك تحديث تكوين Apache عن طريق التأكد من أن توجيه LoadModule هو
موجود لتحميل هذا الكائن المشترك. لتبسيط هذه الخطوة ، توفر apxs طريقة تلقائية
لتثبيت الكائن المشترك في دليل "الوحدات النمطية" وتحديث ملف httpd.conf
وفقاً لذلك. يمكن تحقيق ذلك من خلال تشغيل:

$ apxs -i -a mod_foo.la
/path/to/instdso.sh mod_foo.la / path / to / apache / modules
/ path / to / libtool --mode = تثبيت 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 ، أي

أبكسس $ -i -A mod_foo.c

لإجراء اختبار سريع لآلية apxs ، يمكنك إنشاء نموذج إضافي لقالب وحدة Apache
ملف Makefile المقابل عبر:

$ apxs -g -n foo
إنشاء [DIR] foo
إنشاء [FILE] foo / Makefile
إنشاء [FILE] foo / modules.mk
إنشاء [FILE] foo / mod_foo.c
إنشاء [FILE] foo / .deps
_ دولار

ثم يمكنك ترجمة هذه الوحدة النمطية فورًا إلى كائن مشترك وتحميلها فيه
خادم Apache:

$ سي دي فو
$ اجعل كل إعادة التحميل
apxs -c mod_foo.c
/ path / to / libtool --mode = تجميع 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 = تثبيت cp mod_foo.la / path / to / apache / modules

chmod 755 /path/to/Apache/modules/mod_foo.so
[تنشيط الوحدة النمطية "foo" في /path/to/apache/conf/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
_ دولار

استخدم apxs عبر الإنترنت باستخدام خدمات onworks.net