apxs - מקוון בענן

תָכְנִית:

שֵׁם

apxs - כלי APache eXtenSion

תַקצִיר

apxs -g [ -S שם=ערך ] -n שם מוד

apxs -q [ -v ] [ -S שם=ערך ] שאלה ...

apxs -c [ -S שם=ערך ] [ -o dsofile ] [ -I incdir ] [ -D שם=ערך ] [ -L libdir ] [
-l libname ] [ -בב"ש,מהדר-דגלים ] [ -וול,מקשר-דגלים ] קבצים ...

apxs -i [ -S שם=ערך ] [ -n שם מוד ] [ -a ] [ -A ] קובץ dso ...

apxs -e [ -S שם=ערך ] [ -n שם מוד ] [ -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 לא פועל, מנסה להתחיל
[Te Mar 31 11:27:55 1998] [Debug] mod_so.c(303): מודול טעון foo_module
/path/to/apache/sbin/apachectl הפעלה מחדש: httpd התחיל
$ _

הטיעונים קבצים יכול להיות כל קובץ מקור C (.c), קובץ אובייקט (.o) או אפילו ספריה
ארכיון (.א). הכלי apxs מזהה באופן אוטומטי את ההרחבות הללו ובאופן אוטומטי
השתמש בקבצי המקור C להידור תוך שימוש רק בקובצי האובייקט ובארכיון עבור
שלב הקישור. אבל בעת שימוש באובייקטים מהודרים כאלה יש לוודא שהם מורכבים
עבור קוד בלתי תלוי במיקום (PIC) כדי להיות מסוגל להשתמש בהם עבור משותף טעון דינמי
לְהִתְנַגֵד. למשל עם GCC אתה תמיד פשוט צריך להשתמש ב-fpic. עבור מהדרים אחרים של C
עיין בדף המדריך שלו או במעקב אחר הדגלים שבהם משתמש apxs כדי להדר את קבצי האובייקט.

לפרטים נוספים על תמיכת DSO ב- Apache קרא את התיעוד של mod_so או אולי
אפילו לקרוא את קובץ המקור src/modules/standard/mod_so.c.

אפשרויות

Common אפשרויות
-n שם מוד
זה מגדיר במפורש את שם המודול עבור -i (install) ו-g (תבנית
דור) אפשרות. השתמש בזה כדי לציין במפורש את שם המודול. עבור אפשרות -ג
זה נדרש, עבור אפשרות -i הכלי apxs מנסה לקבוע את השם מה-
מקור או (כחלופה) לפחות על ידי ניחוש זה מתוך שם הקובץ.

שאלה אפשרויות
-q מבצע שאילתה עבור משתנים והגדרות סביבה המשמשות לבניית httpd. מתי
מופעל בלי שאלה פרמטרים, הוא מדפיס את כל המשתנים הידועים והערכים שלהם.
הפרמטר -v האופציונלי מעצב את פלט הרשימה. .PP השתמש בזה כדי ידנית
לקבוע הגדרות המשמשות לבניית ה-httpd שיטען את המודול שלך. לדוגמה
השתמש ב-INC=-I`apxs -q INCLUDEDIR` .PP בתוך Makefiles שלך אם אתה צריך מדריך
גישה לקבצי כותרות C של Apache.

תְצוּרָה אפשרויות
-S שם=ערך
אפשרות זו משנה את הגדרות ה-apxs שתוארו לעיל.

תבנית דור אפשרויות
-g זה יוצר ספריית משנה שם (ראה אפשרות -n) ושם שני קבצים: דוגמה
קובץ מקור מודול בשם mod_שם.c שיכול לשמש כתבנית ליצירה
מודולים משלך או כהתחלה מהירה למשחק עם מנגנון apxs. וגם א
Makefile המקביל לבנייה והתקנה קלה עוד יותר של מודול זה.

DSO Compilation אפשרויות
-c זה מציין את פעולת ההידור. תחילה הוא אוסף את קובצי המקור של C (.c)
of קבצים לתוך קבצי אובייקט תואמים (.o) ולאחר מכן בונה קובץ משותף באופן דינמי
חפץ ב dsofile על ידי קישור קובצי האובייקטים הללו בתוספת קבצי האובייקט הנותרים (.o
ו.א) של קבצים. אם לא צוינה אפשרות -o, קובץ הפלט ניחוש מה-
שם הקובץ הראשון ב קבצים ובדרך כלל ברירת המחדל היא mod_שם.כך.

-o dsofile
מציין במפורש את שם הקובץ של האובייקט שנוצר באופן דינמי משותף. אם לא
צוין ולא ניתן לנחש את השם מה- קבצים רשימה, שם החלפה
נעשה שימוש ב-mod_unknown.so.

-D שם=ערך
אפשרות זו מועברת ישירות לפקודות הקומפילציה. השתמש בזה כדי
הוסף הגדרות משלך לתהליך הבנייה.

-I incdir
אפשרות זו מועברת ישירות לפקודות הקומפילציה. השתמש בזה כדי
הוסף ספריות משלך לחיפוש לתהליך הבנייה.

-L libdir
אפשרות זו מועברת ישירות לפקודת המקשר. השתמש בזה כדי להוסיף את שלך
ספריות משלו לחיפוש בתהליך הבנייה.

-l libname
אפשרות זו מועברת ישירות לפקודת המקשר. השתמש בזה כדי להוסיף את שלך
ספריות משלו לחיפוש בתהליך הבנייה.

-שירותים,מהדר-דגלים
אפשרות זו עוברת מהדר-דגלים כדגלים נוספים ל-libtool --mode=compile
פקודה. השתמש בזה כדי להוסיף אפשרויות ספציפיות למהדר מקומי.

-וול,מקשר-דגלים
אפשרות זו עוברת מקשר-דגלים כדגלים נוספים ל-libtool --mode=link
פקודה. השתמש בזה כדי להוסיף אפשרויות ספציפיות לקישור מקומי.

-p אפשרות זו גורמת ל-apxs לקשר אל ספריות apr/apr-util. זה שימושי
בעת קומפילציה של תוכניות עוזר המשתמשות בספריות apr/apr-util.

DSO הַתקָנָה ו תְצוּרָה אפשרויות
-i זה מציין את פעולת ההתקנה ומתקין אחד או יותר באופן דינמי
אובייקטים משותפים לשרת מודולים במדריך.

-a זה מפעיל את המודול על ידי הוספת שורת LoadModule תואמת
לקובץ התצורה httpd.conf של Apache, או על ידי הפעלתו אם הוא כבר קיים.

-A זהה לאפשרות -a אבל ההנחיה LoadModule שנוצרה מקדימה עם סימן hash
(#), כלומר, המודול פשוט מוכן להפעלה מאוחרת יותר אך מושבת בתחילה.

-e זה מציין את פעולת העריכה, שניתן להשתמש בה עם האפשרויות -a ו-A
בדומה לפעולת -i לעריכת קובץ התצורה httpd.conf של Apache
מבלי לנסות להתקין את המודול.

דוגמאות

נניח שיש לך מודול Apache בשם mod_foo.c זמין שאמור להרחיב את זה של Apache
פונקציונליות השרת. כדי להשיג זאת, תחילה עליך להרכיב את מקור C ל-a
אובייקט משותף המתאים לטעינה לשרת ה-Apache בזמן ריצה באמצעות הפריטים הבאים
פקודה:

$ 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
$ _

לאחר מכן עליך לעדכן את תצורת ה-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=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 אתה יכול ליצור תבנית מודול Apache לדוגמה פלוס
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]
הפעלה מחדש של apachectl
/path/to/apache/sbin/apachectl הפעלה מחדש: httpd לא פועל, מנסה להתחיל
[Te Mar 31 11:27:55 1998] [Debug] mod_so.c(303): מודול טעון foo_module
/path/to/apache/sbin/apachectl הפעלה מחדש: httpd התחיל
$ _

השתמש ב-apxs באופן מקוון באמצעות שירותי onworks.net