fmake - מקוון בענן

תָכְנִית:

שֵׁם

לעשות - לשמור על תלות בתוכנית

תַקצִיר

לעשות [-ABPSXeiknpqrstv] [-C בספרייה] [-D משתנה] [-d דגלים] [-E משתנה] [-f קובץ מיידי]
[-I בספרייה] [-j משרות מקסימליות] [-m בספרייה] [-V משתנה] [-x warning_options]
[משתנה=ערך] [יעד ...]

תיאור

השמיים לעשות Utility היא תוכנית שנועדה לפשט את התחזוקה של תוכניות אחרות. שֶׁלָה
קלט הוא רשימה של מפרטים המתארים קשרי תלות בין הדור
של קבצים ותוכניות.

קודם כל, רשימת המפרטים הראשונית תוקרא מקובץ ה-makefile של המערכת,
sys.mk, אלא אם כן מעוכב עם ה -r אוֹפְּצִיָה. הסטנדרט sys.mk כפי שנשלח עם FreeBSD
מטפל גם make.conf(5), נתיב ברירת המחדל שאליו ניתן לשנות באמצעות לעשות משתנה
__MAKE_CONF.

ואז הראשון של BSDmakefile, קובץ מיידי, ו קובץ Makefile שניתן למצוא בזרם
ספרייה, ספריית אובייקטים (ראה .OBJDIR), או נתיב חיפוש (ראה את -I אפשרות) ייקרא
עבור הרשימה הראשית של מפרטי התלות. יכול להיות קובץ makefile שונה או רשימה שלהם
מסופק דרך ה -f אפשרויות). לבסוף, אם הקובץ .לִסְמוֹך ניתן למצוא בכל אחד מה
המיקומים האמורים, הוא גם ייקרא (ראה mkdep(1)).

מתי לעשות מחפש makefile, השם שלו מקבל עדיפות על מיקומו. ל
למשל, BSDmakefile בספריית האובייקט יועדף על פני קובץ Makefile בנוכחי
במדריך.

האפשרויות הן כדלקמן:

-A הפוך שגיאות ארכיון ללא קטלניות, גורם לעשות פשוט לדלג על השאר או על כל
ארכיון והמשך לאחר הדפסת הודעה.

-B נסה להיות תואם לאחור על ידי ביצוע מעטפת בודדת לכל פקודה ועל ידי
ביצוע הפקודות כדי ליצור את המקורות של שורת תלות ברצף. זֶה
מופעל כברירת מחדל אלא אם כן -j משמש.

-C בספרייה
לשנות ל בספרייה לפני קריאת ה-makefiles או ביצוע כל דבר אחר. אם
מספר -C האפשרויות מצוינות, כל אחת מתפרשת ביחס לקודמתה:
-C / -C וכו ' שווה -C /וכו.

-D משתנה
לְהַגדִיר משתנה להיות 1, בהקשר הגלובלי.

-d דגלים
הפעל איתור באגים וציין אילו חלקים של לעשות כדי להדפיס איתור באגים
מֵידָע. טַעֲנָה דגלים הוא אחד או יותר מהבאים:

A הדפס את כל מידע איתור באגים אפשרי; שווה ערך לציון כולם
דגלי ניפוי הבאגים.

a הדפס מידע על ניפוי באגים על חיפוש בארכיון ואחסון במטמון.

c הדפס מידע על ניפוי באגים על הערכה מותנית.

d הדפס מידע על ניפוי באגים על חיפוש ספריות ואחסון במטמון.

f הדפס מידע איתור באגים על ביצוע של לולאות for.

g1 הדפס את גרף הקלט לפני ביצוע משהו.

g2 הדפס את גרף הקלט לאחר ביצוע הכל, או לפני יציאה בשגיאה.

j הדפס מידע על ניפוי באגים על הפעלת קונכיות מרובות.

l הדפס פקודות ב-Makefiles ללא קשר אם יש להן קידומת או לא
על ידי @ או דגלים "שקטים" אחרים. ידוע גם בשם התנהגות "רועשת".

m הדפס מידע על ניפוי באגים על יצירת יעדים, כולל שינוי
תאריכים.

s הדפס מידע על ניפוי באגים על כללי שינוי סיומת.

t הדפס מידע על ניפוי באגים על תחזוקת רשימת יעדים.

v הדפס מידע על ניפוי באגים על הקצאת משתנים.

-E משתנה
ציין משתנה שערך הסביבה שלו (אם קיים) יעקוף הקצאות מאקרו
בתוך makefiles.

-e ציין שערכי הסביבה עוקפים הקצאות מאקרו בתוך makefile עבור כולם
משתנים.

-f קובץ מיידי
ציין makefile לקריאה במקום ברירת המחדל. אם קובץ מיידי הוא לא
שם נתיב מוחלט, לעשות יחפש אותו כמתואר לעיל. במקרה קובץ מיידי is
"-', הקלט הסטנדרטי נקרא. מרובות -f ניתן לספק אפשרויות, ואת ה-makefiles
ייקרא בסדר זה. בניגוד לאפשרויות שורת הפקודה האחרות, -f הוא לא
אוחסן ב .MAKEFLAGS וגם לא נדחף למטה לייצורי משנה דרך MAKEFLAGS. ראה למטה למידע נוסף
פרטים על משתנים אלו.

-I בספרייה
ציין ספרייה שבה יש לחפש קבצי makefile וקבצי makefile הכלולים.
מְרוּבֶּה -I ניתן לציין אפשרויות ליצירת נתיב חיפוש. קובץ המייקאפ של המערכת
ספרייה (או ספריות, ראה את -m אפשרות) מצורף אוטומטית בזנב
של הנתיב הזה.

-i התעלם מיציאה שאינה מאפסת של פקודות מעטפת ב-makefile. שווה לציון
"-' לפני כל שורת פקודה בקובץ makefile.

-j משרות מקסימליות
ציין את המספר המרבי של משרות לעשות יכול להיות פועל בכל עת.
מכבה את מצב התאימות, אלא אם כן -B דגל מצוין גם.

-k המשך בעיבוד לאחר שנתקלו בשגיאות, אך רק ביעדים שכן
לא תלוי ביעד שיצירתו גרמה לשגיאה.

-m בספרייה
ציין ספרייה שבה לחפש את ה-makefile של המערכת ו-makefiles
נכלל דרך הסגנון <...>. מרובות -m ניתן לציין אפשרויות ליצירת חיפוש
נָתִיב. נתיב זה יעקוף את מערכת ברירת המחדל הכוללת נתיב,
/usr/share/mk-freebsd. הנתיב הכולל של המערכת תמיד יצורף ל-
נתיב חיפוש המשמש עבור הכללות בסגנון "..." וחיפושי makefile (ראה את -I
אוֹפְּצִיָה).

אם שם קובץ או ספרייה ב- -m ארגומנט (או סביבת MAKESYSPATH
משתנה) מתחיל במחרוזת ".../" ואז לעשות יחפש את הקובץ שצוין
או ספרייה בשם בחלק הנותר של מחרוזת הארגומנט. החיפוש מתחיל
עם הספרייה הנוכחית של Makefile ולאחר מכן פועלת כלפי מעלה לכיוון השורש של
מערכת הקבצים. אם החיפוש מצליח, הספרייה המתקבלת תחליף
המפרט ".../" ב- -m טַעֲנָה. אם נעשה בו שימוש, תכונה זו מאפשרת לעשות ל
חפש בקלות בעץ המקור הנוכחי אחר קבצי sys.mk מותאמים אישית (למשל באמצעות
".../mk/sys.mk" כטיעון). שימו לב כי א -C שנמצאים קודם לכן בפקודה
קו משפיע היכן -m ".../" מחפש.

-n הצג את הפקודות שהיו מבוצעות, אך אל תבצע בפועל
אותם.

-P אסוף את הפלט של עבודה נתונה והצג אותו רק כאשר העבודה מסתיימת, במקום זאת
של ערבוב הפלט של עבודות מקבילות יחד. לאפשרות זו אין השפעה אלא אם כן -j
משמש גם.

-p הדפס רק את גרף הקלט, ללא ביצוע פקודות. הפלט זהה ל
-d g1. בשילוב עם -f / dev / null, רק הכללים המובנים של לעשות יש לו
מוצג.

-Q תהיה שקט במיוחד. עבור יצרנים מרובים, זה יגרום לבאנרים של קבצים לא להיות
נוצר.

-q אל תבצע פקודה כלשהי, אך צא מ-0 אם היעדים שצוינו מעודכנים ו
1, אחרת.

-r אל תעבדו את קובץ המייקאפ של המערכת.

-S הפסק את העיבוד כאשר נתקלת בשגיאה. התנהגות ברירת מחדל. זה נחוץ כדי
לשלול את -k אפשרות במהלך בנייה רקורסיבית.

-s אין להדהד פקודות כלשהן בזמן שהן מבוצעות. שווה לציון '@' לפני
כל שורת פקודה בקובץ makefile.

-t במקום לבנות מחדש יעד כפי שצוין ב-makefile, צור אותו או עדכן
זמן השינוי שלו כדי לגרום לו להיראות מעודכן.

-V משתנה
קופונים להדפסה לעשותהרעיון של הערך של משתנה, בהקשר הגלובלי. אל תבנה אף אחד
מטרות. ניתן לציין מספר מופעים של אפשרות זו; המשתנים יהיו
מודפס אחד בכל שורה, עם שורה ריקה עבור כל משתנה אפס או לא מוגדר. אם
משתנה מכיל '$אז הערך יורחב לפני ההדפסה.

-v היו מילוליים במיוחד. הדפס כל מידע נוסף.

-X בעת שימוש -V אפשרות להדפיס את הערכים של משתנים, לא להרחיב רקורסיבית
הערכים.

משתנה=ערך
הגדר את הערך של המשתנה משתנה ל ערך.

-x warning_options
ציין אפשרויות אזהרה מורחבות. ניתן לציין אפשרות זו מספר פעמים. א
warning_option יכול להיות קידומו של "לא", ובמקרה זה האזהרה כבויה.
האפשרויות הזמינות כרגע הן:

תחביר תכליתי
הזהר אם משהו מלבד ריקים והערות מופיע אחרי א .נדף or .אַחֵר
הוראה.

ראה גם .לְהַזהִיר יעד מיוחד.

ישנם שבעה סוגים שונים של שורות בקובץ makefile: מפרטי תלות בקבצים,
פקודות מעטפת, הקצאות משתנות, כוללות הצהרות, הנחיות מותנות, עבור לולאות,
והערות.

באופן כללי, ניתן להמשיך קווים משורה אחת לאחרת על ידי סיומם עם קו נטוי אחורי
('\'). תו השורה החדשה והרווח הראשוני בשורה הבאה הם
דחוסים לחלל אחד.

קובץ תלות מפרט

קווי תלות מורכבים ממטרה אחת או יותר, אופרטור ואפס מקורות או יותר.
זה יוצר מערכת יחסים שבה היעדים "תלויים" במקורות והם בדרך כלל
נוצר מהם. היחס המדויק בין המטרה למקור נקבע
על ידי המפעיל שמפריד ביניהם. שלושת המפעילים הם כדלקמן:

: יעד נחשב לא מעודכן אם זמן השינוי שלו קצר מזה של כל יעד
של מקורותיו. מקורות למטרה מצטברים על פני קווי תלות כאשר זה
נעשה שימוש במפעיל. המטרה מוסרת אם לעשות נקטע.

! מטרות תמיד נוצרות מחדש, אך לא עד שכל המקורות נבדקו ו-
נוצר לפי הצורך. מקורות למטרה מצטברים על פני קווי תלות כאשר זה
נעשה שימוש במפעיל. המטרה מוסרת אם לעשות נקטע.

:: אם לא צוינו מקורות, היעד תמיד נוצר מחדש. אחרת, מטרה היא
נחשב לא מעודכן אם אחד ממקורותיו שונה לאחרונה יותר מאשר
יַעַד. מקורות למטרה אינם מצטברים על פני קווי תלות כאשר זה
נעשה שימוש במפעיל. המטרה לא תוסר אם לעשות נקטע.

יעדים ומקורות עשויים להכיל את ביטויי התווים הכלליים '?', '*', '[]' ו-'{}'. ה
ניתן להשתמש בביטויים '?', '*' ו-'[]' רק כחלק מהרכיב הסופי של היעד
או מקור, ויש להשתמש בהם כדי לתאר קבצים קיימים. הביטוי '{}' אינו צריך
בהכרח לשמש לתיאור קבצים קיימים. ההרחבה היא בסדר ספריות, לא
בסדר אלפביתי כפי שנעשה בקליפה.

SHELL פקודות

כל מטרה עשויה לשייך אליו סדרה של פקודות מעטפת, המשמשות בדרך כלל ליצירה
המטרה. כל אחת מהפקודות בסקריפט הזה צריך לפניה כרטיסייה. בעוד כל
המטרה עשויה להופיע בשורת תלות, רק אחת מהתלות הללו עשויה להיות אחריה א
תסריט יצירה, אלא אם כן ה'::נעשה שימוש באופרטור '.

אם התווים הראשונים של שורת הפקודה הם '@','-', ו/או '+', הפקודה מטופלת
במיוחד. א'@' גורם לפקודה לא להדהד לפני ביצועה. א'-' גורם ל
כל סטטוס יציאה שאינו אפס של שורת הפקודה שיש להתעלם ממנו. א'+' גורם לפקודה להיות
הוצא להורג גם אם -n מוגדר בשורת הפקודה.

מִשְׁתַנֶה משימות

משתנים ב לעשות דומים בהרבה למשתנים בקליפה, ולפי המסורת, מורכבים מכולם
אותיות רישיות. חמשת האופרטורים שניתן להשתמש בהם כדי להקצות ערכים למשתנים הם
באופן הבא:

= הקצה את הערך למשתנה. כל ערך קודם מוחלף.

+= הוסף את הערך לערך הנוכחי של המשתנה.

?= הקצה את הערך למשתנה אם הוא עדיין לא מוגדר.

:= הקצה עם הרחבה, כלומר הרחב את הערך לפני הקצאתו למשתנה.
בדרך כלל, הרחבה לא מתבצעת עד שהמשתנה מקבל הפניה.

!= הרחב את הערך והעביר אותו למעטפת לביצוע והקצה את התוצאה ל-
מִשְׁתַנֶה. כל שורות חדשות בתוצאה מוחלפות ברווחים.

כל רווח לבן לפני המוקצה ערך הוסר; אם הערך מצורף, א
רווח בודד מוכנס בין התוכן הקודם של המשתנה והנוסף
ערך.

משתנים מורחבים על ידי כך שהם מקיפים את שם המשתנה בסוגריים מסולסלים ('{}') או
סוגריים ('()') ולפניו בסימן דולר ('$'). אם שם המשתנה מכיל
רק אות בודדת, הסוגריים או הסוגריים שמסביב אינם נדרשים. זה קצר יותר
הטופס אינו מומלץ.

החלפת משתנים מתרחשת בשני מועדים ברורים, תלוי היכן נמצא המשתנה
בשימוש. משתנים בשורות תלות מורחבים עם קריאת השורה. משתנים במעטפת
הפקודות מורחבות כאשר פקודת המעטפת מבוצעת.

ארבעת המחלקות השונות של משתנים (בסדר העדיפויות) הן:

משתני סביבה
משתנים המוגדרים כחלק מ לעשותהסביבה של.

משתנים גלובליים
משתנים המוגדרים ב-makefile או ב-makefile הכלולים.

משתני שורת הפקודה
משתנים המוגדרים כחלק משורת הפקודה ומשתנים המתקבלים מה-
משתנה הסביבה MAKEFLAGS או את .MAKEFLAGS יעד.

משתנים מקומיים
משתנים המוגדרים ספציפיים למטרה מסוימת.

אם השם של משתנה סביבה מופיע בקובץ make-up בצד שמאל של an
הקצאה, נוצר משתנה גלובלי בעל אותו שם, והאחרון מצל את
לשעבר לפי העדיפויות היחסיות שלהם. הסביבה לא משתנה במקרה זה, ו
השינוי אינו מיוצא לתוכניות המופעלות על ידי לעשות. עם זאת, משתנה שורת פקודה
למעשה מחליף את משתנה הסביבה באותו שם אם האחרון קיים, כלומר
גלוי לתוכניות ילדים.

ישנם שבעה משתנים מקומיים ב לעשות:

.ALLSRC רשימת כל המקורות למטרה זו; ידוע גם כ '>".

.ARCHIVE שם קובץ הארכיון; ידוע גם כ '!".

.IMPSRC השם/הנתיב של המקור שממנו יש להפוך את המטרה (ה
מקור "מרומז"); ידוע גם כ '<".

.חבר שם חבר הארכיון; ידוע גם כ '%".

.OODATE רשימת המקורות למטרה זו שנחשבו לא מעודכנים; ידוע גם כ
"?".

‎.PREFIX קידומת הקובץ של הקובץ, המכילה רק את חלק הקובץ, ללא סיומת או
רכיבי ספרייה קודמים; ידוע גם כ '*".

.יַעַד שם המטרה; ידוע גם כ '@".

הצורות הקצרות יותר'@','!','<','%','?','>', ו'*' מותרים לאחור
תאימות ואינם מומלצים. ששת המשתנים '@F','@D','<F','<D','*F', וכן
"*D' מותרים עבור תאימות עם קבצי makefile של AT&T System V UNIX ואינם
מומלץ.

ניתן להשתמש בארבעה מהמשתנים המקומיים במקורות בקווי תלות מכיוון שהם מתרחבים
לערך המתאים לכל מטרה בקו. משתנים אלו הם .יַעַד, ‎.PREFIX,
.ARCHIVE, ו .חבר.

בנוסף, לעשות מגדיר או יודע על המשתנים הפנימיים או הסביבה הבאים
משתנים:

$ סימן דולר בודד '$', כלומר '$$' מתרחב לסימן דולר בודד.

MAKE השם ש לעשות הוצא להורג עם (argv[0]).

.CURDIR נתיב לספרייה שבה לעשות הוצא להורג. ה לעשות ערכות שירות
.CURDIR לנתיב הקנוני שניתן על ידי getcwd(3).

.OBJDIR נתיב לספרייה שבה המטרות בנויות. בעת ההפעלה, לעשות
מחפש ספרייה חלופית להצבת קבצי יעד. זה ינסה
כדי לעבור לספרייה המיוחדת הזו ויחפש בספרייה הזו
makefiles לא נמצאו בספרייה הנוכחית. המדריכים הבאים הם
ניסו לפי הסדר:

1. ${MAKEOBJDIRPREFIX}/`pwd -P`
2. ${MAKEOBJDIR}
3. obj.${MACHINE}
4. obj
5. /usr/obj/`pwd -P`

הספרייה הראשונה ש לעשות משתנה בהצלחה לתוך משמש. או זה או זה
MAKEOBJDIRPREFIX או MAKEOBJDIR מוגדרים בסביבה אבל לעשות אינו מסוגל
כדי לעבור לספרייה המתאימה, אז הספרייה הנוכחית היא
בשימוש מבלי לבדוק את שאר הרשימה. אם הם לא מוגדרים ו
לעשות אם כך, אין אפשרות לשנות לאף אחת משלושת הספריות הנותרות
נעשה שימוש בספרייה הנוכחית. שימו לב, MAKEOBJDIRPREFIX ו-MAKEOBJDIR
חייב להיות משתני סביבה ואין להפעיל לעשותשורת הפקודה של.

השמיים לעשות ערכות שירות .OBJDIR לנתיב הקנוני שניתן על ידי getcwd(3).

.MAKEFILE_LIST As לעשות קורא קבצי makefile שונים, כולל קבצי ברירת המחדל וכל קבצי
מתקבל משורת הפקודה ו .לִכלוֹל ו .include הנחיות, שלהם
שמות יצורפו אוטומטית ל- .MAKEFILE_LIST מִשְׁתַנֶה. הֵם
מתווספים ממש לפני לעשות מתחיל לנתח אותם, כך ששם ה-
ה-makefile הנוכחי היא המילה האחרונה במשתנה זה.

MAKEFLAGS משתנה הסביבה MAKEFLAGS עשוי להכיל בתחילה כל דבר שעשוי
יצוין ב לעשותשורת הפקודה של, כולל -f אפשרויות). לאחר
עיבוד, התוכן שלו מאוחסן ב- .MAKEFLAGS משתנה גלובלי,
למרות כל -f האפשרויות נשמטות. ואז כל האפשרויות והמשתנה
מטלות שצוינו ב לעשותשורת הפקודה של, למעט -f, מצורפים ל
מה היא .MAKEFLAGS משתנה

בכל פעם ש לעשות מפעיל תוכנית, הוא מגדיר MAKEFLAGS בתוכנית של
סביבה לערך הנוכחי של .MAKEFLAGS משתנה גלובלי. לכן,
אם MAKEFLAGS ב לעשותהסביבה של מכילה כל -f אפשרויות, הן לא יהיו
נדחף מטה לתוכניות ילדים באופן אוטומטי. ה לעשות תועלת ביעילות
מסנן החוצה -f אפשרויות מהסביבה ושורת הפקודה למרות זאת
מעביר את שאר האפשרויות שלו לייצור משנה דרך MAKEFLAGS כברירת מחדל.

בעת העברת הגדרות מאקרו וארגומנטים של דגל ב-MAKEFLAGS
תווי משתנה סביבה, רווח וטאב מצוטט לפניהם
עם קו נטוי לאחור. בעת קריאת המשתנה MAKEFLAGS מהסביבה,
כל הרצפים של קו נטוי אחורי ואחד של רווח או טאב מוחלפים רק עם
הדמות השנייה שלהם מבלי לגרום לשבירה במילים. כל התרחשות אחרת
של קו נטוי אחורי נשמרים. קבוצות של רווח ללא ציטוט, טאב ושורה חדשה
תווים גורמים לשבירת מילים.

.MAKEFLAGS בתחילה, המשתנה הגלובלי הזה מכיל לעשותאפשרויות הריצה הנוכחיות של
מהסביבה ומשורת הפקודה כמתואר לעיל, תחת MAKEFLAGS.
על ידי שינוי התוכן של .MAKEFLAGS משתנה גלובלי, ה-makefile
יכול לשנות את התוכן של משתנה הסביבה MAKEFLAGS הזמין
עבור כל התוכניות אשר לעשות מבצע. זה כולל הוספה -f אפשרויות).
הערך הנוכחי של .MAKEFLAGS פשוט מועתק מילה במילה ל-MAKEFLAGS ב-
סביבת תוכניות ילדים.

שים לב שכל האפשרויות שהוכנסו ל .MAKEFLAGS אף אחת מהן לא משפיעה על הזרם
מופע של לעשות ולא להופיע בעותק משלו של MAKEFLAGS באופן מיידי.
עם זאת, הם מופיעים במשתנה הסביבה MAKEFLAGS של תוכניות
מבוצע על ידי לעשות. מצד שני, הקצאה ישירה ל-MAKEFLAGS
אף אחת מהן אינה משפיעה על המופע הנוכחי של לעשות וגם לא מועבר ל לעשות's
יְלָדִים. השווה עם ה .MAKEFLAGS יעד מיוחד למטה.

MFLAGS משתנה זה מסופק עבור תאימות לאחור ומכיל את כל
אפשרויות ממשתנה הסביבה MAKEFLAGS בתוספת כל האפשרויות שצוינו
on לעשותשורת הפקודה של.

.MAKE.PID מזהה התהליך של לעשות.

.MAKE.PPID מזהה התהליך האב של לעשות.

.MAKE.JOB.PREFIX
If לעשות מתנהל עם -j -v ואז פלט עבור כל מטרה מקבל קידומת a
אסימון '--- target ---' שבחלקו הראשון ניתן לשלוט באמצעות
.MAKE.JOB.PREFIX.
לדוגמה: .MAKE.JOB.PREFIX=${.newline}---${MAKE:T}[${.MAKE.PID}]
לייצר אסימונים כמו '---make[1234] target ---' או
.MAKE.JOB.PREFIX=---pid[${.MAKE.PID}],ppid[${.MAKE.PPID}] יפיק
אסימונים כמו '---pid[56789],ppid[1234] target ---' מה שמקל על המעקב
מידת ההקבלה המושגת.

.יעדים רשימת מטרות לעשות בונה כעת.

.כולל לִרְאוֹת .כולל יעד מיוחד.

.LIBS לִרְאוֹת .LIBS יעד מיוחד.

מכונה שם ארכיטקטורת המכונה לעשות פועל על, מתקבל מה
משתנה סביבה MACHINE, או דרך לא שם(3) אם לא הוגדר.

MACHINE_ARCH שם ארכיטקטורת המכונה לעשות הורכב עבור, הוגדר ב
זמן הידור.

VPATH Makefiles עשוי להקצות רשימה מופרדת בנקודתיים של ספריות VPATH. אלה
יחפשו בספריות קבצי מקור על ידי לעשות לאחר שזה יסתיים
ניתוח כל קבצי ה-makefile הקלט.

מִשְׁתַנֶה משנים
ניתן לשנות הרחבת משתנה כדי לבחור או לשנות כל מילה של המשתנה (כאשר א
"מילה" היא רצף תווים מופרד ברווחים לבנים). הפורמט הכללי של משתנה
ההרחבה היא כדלקמן:

{משתנה[:שינוי[:...]]}

כל שינוי מתחיל בנקודתיים ובאחד מהתווים המיוחדים הבאים. המעי הגס
ניתן לברוח באמצעות קו נטוי אחורי ('\').

:C/דפוס/תַחֲלִיף/[1g]
שנה כל מילה של הערך, החלפת כל התאמה של הרגיל המורחב
ביטוי דפוס (ראה re_format(7)) עם ה ed(1) בסגנון תַחֲלִיף מחרוזת.
בדרך כלל, ההופעה הראשונה של התבנית בכל מילה של הערך היא
השתנה. השינוי '1' גורם להחלפה לחול על מילה אחת לכל היותר;
המשנה 'g' גורם להחלפה לחול על כמה שיותר מקרים של
דפוס חיפוש כפי שמתרחש במילה או במילים שבהן הוא נמצא. שימו לב ש-'1' ו
'g' הם אורתוגונליים; הראשון מציין אם יש פוטנציאל למספר מילים
מושפע, האחרון אם תחליפים מרובים יכולים להתרחש בתוכו
כל מילה מושפעת.

:E מחליף כל מילה במשתנה בסיומת שלה.

:H מחליף כל מילה במשתנה בכל דבר מלבד הרכיב האחרון.

:L ממיר משתנה לאותיות קטנות. (הוצא משימוש)

:Mדפוס בחר רק את המילים המתאימות לשאר השינויים. המעטפת הסטנדרטית
ניתן להשתמש בתווים כלליים ('*', '?' ו-'[]'). דמויות התווים הכלליים
ניתן לברוח באמצעות קו נטוי אחורי ('\').

:Nדפוס זה זהה ל :M, אך בוחר את כל המילים שאינן תואמות את שאר המילים
המשנה.

:O סדר כל מילה במשתנה לפי אלפביתי.

:Q מצטט כל מטא-תו של מעטפת במשתנה, כדי שניתן יהיה להעביר אותו
בבטחה באמצעות קריאות רקורסיביות של לעשות.

:R מחליף כל מילה במשתנה בכל דבר מלבד הסיומת שלו.

:S/ישן_מחרוזת/מחרוזת_חדש/[g]
שנה את המופע הראשון של ישן_מחרוזת בכל מילה של ערך המשתנה,
מחליף אותו ב מחרוזת_חדש. אם 'g' מצורף לאכסון האחרון של ה-
דפוס, כל המופעים בכל מילה מוחלפים. אם ישן_מחרוזת מתחיל עם א
caret ('^'), ישן_מחרוזת מעוגן בתחילת כל מילה. אם
ישן_מחרוזת מסתיים בסימן דולר ('$'), הוא מעוגן בסוף כל אחד
מִלָה. בְּתוֹך מחרוזת_חדש, אמפרסנד ('&') מוחלף ב ישן_מחרוזת. כל
תו עשוי לשמש כמפריד עבור חלקי מחרוזת השינוי. ה
תווי עיגון, אמפרסנד ותווי תוחם עשויים להיחלץ עם קו נטוי אחורי
('\').

התרחבות משתנה מתרחשת באופן רגיל בתוך שניהם ישן_מחרוזת ו
מחרוזת_חדש עם החריג היחיד שבו נטוי אחורי משמש כדי למנוע את
הרחבה של סימן דולר ('$'), לא סימן דולר קודם כמקובל.

:old_string=מחרוזת_חדשה
זהו החלפת המשתנה בסגנון AT&T System V UNIX. זה חייב להיות האחרון
צוין שינוי. אם ישן_מחרוזת or מחרוזת_חדש אינם מכילים את התבנית
אופי תואם % אז מניחים שהם מעוגנים בסוף
כל מילה, כך שניתן להחליף רק סיומות או מילים שלמות. אחרת % האם ה
מחרוזת משנה של ישן_מחרוזת להחלפה ב מחרוזת_חדש.

:T מחליף כל מילה במשתנה ברכיב האחרון שלה.

:tl ממיר משתנה לאותיות קטנות.

:tu ממיר משתנה לאותיות גדולות.

:U ממיר משתנה לאותיות גדולות. (הוצא משימוש)

:u הסר מילים כפולות סמוכות (כמו ייחודי(1)).

הנחיות, תנאים, ו עבור לולאות

הנחיות, תנאים ולולאות המזכירות את שפת התכנות C הן
מסופק ב לעשות. כל המבנים הללו מזוהים על ידי קו שמתחיל בנקודה אחת
('.') אופי. ההנחיות הבאות נתמכות:

.לִכלוֹל

.לִכלוֹל "קוֹבֶץ"
כלול את ה-makefile שצוין. משתנים בין סוגרי הזווית או כפול
מרכאות מורחבות כדי ליצור את שם הקובץ. אם נעשה שימוש בסוגריים זווית, הכלול
makefile צפוי להיות בספריית makefile של המערכת. אם זה מרכאות כפולות
בשימוש, הספרייה הכוללת של makefile וכל ספריות שצוינו באמצעות -I
החיפוש מתבצע לפני ספריית makefile של המערכת.

.include

.include "קוֹבֶץ"
כמו .לִכלוֹל, אך התעלמו בשקט אם לא ניתן למצוא ולפתוח את הקובץ.

.undef משתנה
בטל את הגדרת המשתנה הגלובלי שצוין. רק משתנים גלובליים עשויים להיות בלתי מוגדרים.

.שְׁגִיאָה הודעה
הפסק את העיבוד של ה-makefile באופן מיידי. שם הקובץ של ה-makefile, ה-
השורה שבה נתקלה השגיאה וההודעה שצוינה מודפסות ל-
פלט שגיאה סטנדרטי ו לעשות מסתיים עם קוד יציאה 1. משתנים ב-
ההודעה מורחבת.

.אַזהָרָה הודעה
שלח הודעת אזהרה. שם הקובץ של makefile, השורה שבה האזהרה
נתקל, וההודעה שצוינה מודפסת לפלט השגיאה הסטנדרטי.
משתנים בהודעה מורחבים.

תנאים משמשים כדי לקבוע אילו חלקים של Makefile לעבד. הם משומשים
בדומה לתנאים הנתמכים על ידי מעבד הקדם C. התנאים הבאים
נתמכים:

.אם [!]ביטוי [מפעיל ביטוי ...]
בדוק את הערך של ביטוי.

.ifdef [!]משתנה [מפעיל משתנה ...]
בדוק את הערך של משתנה.

.ifndef [!]משתנה [מפעיל משתנה ...]
בדוק את הערך של משתנה.

.ifmake [!]יעד [מפעיל יעד ...]
בדוק את המטרה הנבנית.

.ifnmake [!]יעד [מפעיל יעד ...]
בדוק את המטרה הנבנית.

.אַחֵר הפוך את תחושת התנאי האחרון.

.elif [!]ביטוי [מפעיל ביטוי ...]
שילוב של .אַחֵר אחריו .אם.

.elifdef [!]משתנה [מפעיל משתנה ...]
שילוב של .אַחֵר אחריו .ifdef.

.elifndef [!]משתנה [מפעיל משתנה ...]
שילוב של .אַחֵר אחריו .ifndef.

.elifmake [!]יעד [מפעיל יעד ...]
שילוב של .אַחֵר אחריו .ifmake.

.elifnmake [!]יעד [מפעיל יעד ...]
שילוב של .אַחֵר אחריו .ifnmake.

.נדף סיים את הגוף של המותנה.

השמיים מפעיל יכול להיות כל אחד מהבאים:

|| הגיוני או

&& AND הגיוני; בעדיפות גבוהה יותר מ'||".

כמו ב-C, לעשות יעריך תנאי רק ככל שיידרש לקביעתו
ערך. ניתן להשתמש בסוגריים כדי לשנות את סדר ההערכה. האופרטור הבוליאני'!"
עשוי לשמש כדי לשלול באופן הגיוני תנאי שלם. יש לו עדיפות גבוהה יותר מאשר
"&&".

הערך של ביטוי יכול להיות כל אחד מהבאים:

מוגדר לוקח שם משתנה כארגומנט ומעריך כ-true אם למשתנה יש
הוגדר.

לעשות לוקח שם יעד כארגומנט ומעריך כ-true אם היעד היה
שצוין כחלק מ לעשותשורת הפקודה של או הוכרזה כיעד ברירת המחדל
(בין אם במרומז או במפורש, ראה .רָאשִׁי) לפני השורה המכילה את
מותנה.

ריק לוקח משתנה, עם שינויים אפשריים, ומעריך נכון אם ה
הרחבת המשתנה תגרום למחרוזת ריקה.

קיים לוקח שם קובץ כארגומנט ומעריך כ-true אם הקובץ קיים. ה
מחפשים את הקובץ בנתיב החיפוש של המערכת (ראה .נָתִיב).

יעד לוקח שם יעד כארגומנט ומעריך כ-true אם היעד היה
מוּגדָר.

An ביטוי יכול להיות גם השוואה מספרית או מחרוזת: במקרה זה, הצד השמאלי
צריך be הרחבה משתנה, ואילו הצד הימני יכול להיות קבוע או משתנה
הַרחָבָה. הרחבה משתנה מתבצעת משני הצדדים, ולאחר מכן הערכים המתקבלים
מושווים. ערך מתפרש כהקסדצימלי אם לפניו 0x, אחרת הוא
הוא עשרוני; מספרים אוקטליים אינם נתמכים.

השוואת מחרוזות יכולה להשתמש רק ב-'=='או'!=' אופרטורים, ואילו ערכים מספריים (שניהם
ניתן להשוות מספר שלם ונקודה צפה) גם באמצעות '>','>=','<'ו'<="
אופרטורים.

אם לא ניתנים אופרטור יחסי (וערך יד ימין), סימן '!= 0' משמש.
עם זאת, היזהר מאוד בשימוש בתכונה זו במיוחד כאשר המשתנה בצד שמאל
הרחבה מחזירה מחרוזת.

מתי לעשות מעריך אחד מהביטויים המותנים הללו, והוא נתקל במילה
אינו מזהה, או הביטוי "עשה" או "מוגדר" מוחל עליו, בהתאם
צורת התנאי. אם הטופס הוא .אם, .ifdef or .ifndef, ה"מוגדר"
ביטוי מוחל. באופן דומה, אם הטופס הוא .ifmake or .ifnmake, הביטוי "לעשות".
מוחל.

אם התנאי מוערך כאמת, הניתוח של ה-makefile ממשיך כמו קודם. אם זה
מוערך ל-false, השורות הבאות מדלגות. בשני המקרים זה נמשך עד א
.אַחֵר or .נדף נמצא.

עבור לולאות משמשות בדרך כלל להחלת קבוצת כללים על רשימת קבצים. התחביר של א
עבור לולאה היא:

.ל משתנה in ביטוי

.endfor

אחרי ה-for ביטוי מוערך, הוא מפוצל למילים. האיטרציה משתנה is
הוגדר ברציפות לכל מילה, והוחלף ב- לעשות חוקים בתוך הגוף של הפור
לולאה.

תגובות

הערות מתחילות עם תו hash ('#'), בכל מקום מלבד בשורת פקודה של מעטפת, ו
להמשיך עד סוף הקו.

מיוחד מקורות

.להתעלם התעלם מכל שגיאה מהפקודות המשויכות ליעד זה, בדיוק כאילו
לפני כולם קדם מקף ('-').

.עשה בצע את הפקודות הקשורות למטרה זו גם אם -n or -t אפשרויות
צוינו. משמש בדרך כלל לסימון רקורסיבי לעשותשל.

.לא בדרך כלל לעשות בוחר את היעד הראשון בו הוא נתקל כיעד ברירת המחדל להיות
נבנה אם לא צוין יעד. מקור זה מונע היעד הזה
נבחר.

.אופציונאלי אם יעד מסומן בתכונה זו ו לעשות לא מצליח להבין איך
ליצור אותו, הוא יתעלם מהעובדה הזו ויניח שהקובץ אינו נחוץ או שכבר
קיים.

.יקר ערך מתי לעשות מופסק, הוא מסיר את כל המטרות העשויות חלקית. המקור הזה
מונע את הסרת המטרה.

.שקט אין להדהד אף אחת מהפקודות הקשורות למטרה זו, בדיוק כאילו הן
לפני כולם קדם סימן סימן ('@').

.להשתמש הפוך את המטרה ל לעשותהגרסה של מאקרו. כאשר המטרה משמשת א
מקור עבור יעד אחר, היעד השני רוכש את הפקודות, המקורות ו
תכונות (פרט ל .להשתמש) של המקור. אם למטרה כבר יש פקודות,
מה היא .להשתמש הפקודות של המטרה מצורפות אליהם.

.לַחֲכוֹת אם מיוחד .לַחֲכוֹת מקור מופיע בשורת תלות, המקורות שקודמים
זה נעשה לפני המקורות שמצליחים אותו בשורה. לולאות לא מתקיימות
זוהו ויעדים היוצרים לולאות יתעלמו בשקט.

מיוחד יעדים

אין לכלול יעדים מיוחדים עם יעדים אחרים, כלומר, הם חייבים להיות המטרה היחידה
נָקוּב.

.התחל כל שורת הפקודה המצורפת למטרה זו מבוצעת לפני כל דבר אחר
בוצע.

תקלות זה סוג של א .להשתמש כלל עבור כל יעד (ששימש רק כמקור) כי
לעשות לא מצליח להבין דרך אחרת ליצור. נעשה שימוש רק בסקריפט המעטפת.
השמיים .IMPSRC משתנה של יעד שיורש תקלותהפקודות של מוגדרות ל-
שמו של המטרה עצמו.

. END כל שורת הפקודה המצורפת למטרה זו מבוצעת לאחר שכל השאר
בוצע.

.להתעלם סמן כל אחד מהמקורות ב- .להתעלם תְכוּנָה. אם אין מקורות
שצוין, זוהי המקבילה לציון -i אוֹפְּצִיָה.

.כולל רשימה של סיומות המציינות קבצים שניתן לכלול בקובץ מקור.
כנראה שהסיומת כבר הוכרזה עם .SUFFIXES; כל סיומת כך
המוצהר יכלול את המדריכים בנתיב החיפוש שלו (ראה .נָתִיב) ממוקם ב
.כולל משתנה מיוחד, כל אחד לפניו א -I דגל.

.פסיקת If לעשות מופסק, הפקודות עבור יעד זה יבוצעו.

.LIBS זה עושה לספריות מה .כולל עושה עבור כולל קבצים, אלא שה
דגל בשימוש הוא -L.

.רָאשִׁי אם לא צוין יעד מתי לעשות מופעל, יעד זה ייבנה. זֶה
מוגדר תמיד, במפורש או במשתמע כאשר לעשות בוחר את ברירת המחדל
target, כדי לתת למשתמש דרך להתייחס ליעד ברירת המחדל בפקודה
קו.

.MAKEFILEDEPS
הפעל את הפונקציונליות "Remaking Makefiles", כפי שהוסבר ב- עושה מחדש
MAKEFILES להלן.

.MAKEFLAGS יעד זה מספק דרך לציין דגלים עבור לעשות כאשר נעשה שימוש ב-makefile.
הדגלים הם כאילו הוקלדו על הקליפה, אם כי -f לאופציה תהיה לא
השפעה. דגלים (למעט -f) והקצאות משתנות שצוינו כמקור
עבור יעד זה מצורפים גם ל- .MAKEFLAGS משתנה פנימי. אנא
שים לב להבדל בין יעד זה לבין .MAKEFLAGS משתנה פנימי:
ציון אפשרות או הקצאת משתנה כמקור ליעד זה
להשפיע על שניהם ה-makefile הנוכחי וכל התהליכים ש לעשות מבצע.

.MFLAGS זהה לעיל, עבור תאימות לאחור.

.NOTPARALLEL
השבת מצב מקבילי.

.NO_PARALLEL
זהה לעיל, עבור תאימות עם אחרים pmake גרסאות.

.להזמין המטרות הנקובות נעשות ברצף.

.נָתִיב המקורות הם ספריות שאותן יש לחפש אחר קבצים שלא נמצאו ב-
ספרייה נוכחית. אם לא צוין מקורות, כל שצוין קודם לכן
ספריות נמחקות. במידת האפשר, שימוש ב .נָתִיב מועדף על פני שימוש ב
מה היא VPATH משתנה

.נָתִיבסִיוֹמֶת
המקורות הם ספריות שאותן יש לחפש אחר קבצים עם סיומת לא
נמצא בספרייה הנוכחית. ה לעשות כלי השירות מחפש תחילה את הסיומת
נתיב חיפוש, לפני החזרה לנתיב ברירת המחדל אם הקובץ לא נמצא
שם. טופס זה נדרש עבור .LIBS ו .כולל לעבודה.

.מְזוּיָף החל .מְזוּיָף לייחס לכל מקורות שצוינו. מטרות עם זה
התכונה תמיד נחשבת לא מעודכנת.

.POSIX להתאים לעשותההתנהגות של התאמה למפרטי POSIX הרלוונטיים. (שימו לב לזה
משבית את התכונה "Remaking Makefiles").

.יקר ערך החל .יקר ערך לייחס לכל מקורות שצוינו. אם אין מקורות
שצוין, ה .יקר ערך התכונה מוחלת על כל יעד בקובץ.

.צדף בחר מעטפת אחרת. למקורות של יעד זה יש את הפורמט מפתח=ערך.
השמיים מפתח אחד מ:

נתיב ציין את הנתיב למעטפת החדשה.

שם ציין את השם של המעטפת החדשה. זה יכול להיות אחד מהשניים
שלוש קונכיות מובנות (ראה להלן) או כל שם אחר.

שֶׁקֶט ציין את פקודת המעטפת כדי לכבות את ההד.

הד ציין את פקודת המעטפת כדי להפעיל הדהוד.

לסנן בדרך כלל פגזים מדפיסים את פקודת ההד לפני כיבוי ההד.
זוהי המחרוזת המדויקת שתודפס על ידי המעטפת והיא
משמש לסינון פלט המעטפת כדי להסיר את פקודת הד כבוי.

echoFlag אפשרות המעטפת שמפעילה הדים.

errFlag אפשרות המעטפת להפעלת בדיקת שגיאות. אם בדיקת השגיאות פועלת,
המעטפת צריכה לצאת אם פקודה מחזירה סטטוס שאינו אפס.

hasErrCtl נכון אם למעטפת יש בקרת שגיאות.

לבדוק If hasErrCtl נכון אז זו פקודת המעטפת להפוך שגיאה
בודק. אם hasErrCtl הוא שקר אז זו תבנית פקודה
להדהוד פקודות שבדיקת שגיאות מושבתת עבורן. התבנית
חייב להכיל '%s'.

להתעלם If hasErrCtl נכון, זו פקודת המעטפת להפוך שגיאה
בודק. אם hasErrCtl הוא שקר, זוהי תבנית פקודה ל
בצע פקודה כך שתתעלם משגיאות. התבנית חייבת
מכיל '%s'.

מטא זוהי מחרוזת של תווים מטא של הקליפה.

בניינים זוהי מחרוזת שמחזיקה את כל הפקודות המובנות של המעטפת מופרדות
לפי ריקים. ה מטא ו בניינים משתמשים במחרוזות במצב compat.
כאשר שורת פקודה אינה מכילה תו מטא ואינה מתחילה עם
מעטפת מובנית, היא מבוצעת ישירות מבלי להפעיל מעטפת.
כאשר אחת מהמחרוזות הללו (או שתיהן) ריקות כל הפקודות
הוצא להורג דרך פגז.

unsetenv אם נכון, הסר את משתנה הסביבה ENV לפני ביצוע משתנה
פקודה. זה שימושי עבור מעטפת קורן (ksh).

ערכים שהם מחרוזות חייבים להיות מוקפים במירכאות כפולות. ערכים בוליאניים הם
שצוין כ-'T' או 'Y' (בכל מקרה) בפירוש נכון. כל ערך אחר נלקח
להתכוון שקר.

ישנם מספר שימושים ב- .צדף יַעַד:

· בחירת אחת מהקונכיות המובנות. זה נעשה רק על ידי ציון ה
שם הקליפה עם ה שם מילת מפתח. אפשר גם לשנות את
פרמטרים של המעטפת המובנית רק על ידי ציון מילות מפתח אחרות (למעט
ל נתיב).

· שימוש בקובץ הפעלה אחר עבור אחת מהקונכיות המובנות. זה נעשה על ידי
ציון הנתיב לקובץ ההפעלה עם ה- נתיב מילת מפתח. אם האחרון
הרכיב זהה לשם של המעטפת המובנית, לא צריך להיות שם
נָקוּב; אם הוא שונה, יש לתת את השם:

.SHELL: path="/usr/local/bin/sh"

בוחר את המעטפת המובנית "sh" אך יבצע אותה ממנה /usr/local/bin/sh.
כמו במקרה הקודם, אפשר לשנות פרמטרים של
מעטפת מובנית רק על ידי ציון אותם.

· שימוש במעטפת אחרת לגמרי. זה נעשה על ידי ציון כל מילות המפתח.

הקליפות המובנות הן "sh", "csh" ו-"ksh". כי ל-FreeBSD אין ksh in
/ סל, אין זה חכם לפרט שם="ksh" מבלי לציין גם נתיב.

.שקט החל .שקט לייחס לכל מקורות שצוינו. אם אין מקורות
שצוין, ה .שקט התכונה מוחלת על כל פקודה בקובץ.

.SUFFIXES כל מקור מציין סיומת ל לעשות. אם לא צוינו מקורות, כל אחד
סיומות שצוינו קודמות נמחקות.

.לְהַזהִיר כל מקור מציין דגל אזהרה כפי שתואר קודם לכן עבור -x הפקודה
אפשרות קו. דגלי אזהרה המצוינים בשורת הפקודה מקבלים עדיפות על פני
דגלים שצוינו בקובץ ה-makefile. כמו כן, דגלי אזהרה של שורת הפקודה נדחפים אל
תת יוצרת דרך משתני הסביבה MAKEFLAGS כך שדגל אזהרה
שצוין בשורת הפקודה ישפיע על כל תת-היוצרים. כמה דגלים יכולים
יצוין על סינגל .לְהַזהִיר היעד על ידי הפרדתם עם נקודות ריקות.

עושה מחדש MAKEFILES

אם המטרה המיוחדת .MAKEFILEDEPS קיים ב-Makefile, לעשות מאפשר את "Remaking
תכונת Makefiles. לאחר קריאת Makefile וכל הקבצים הכלולים באמצעות
.לִכלוֹל or .include הנחיות (מקור Makefiles) לעשות מחשיב כל מקור Makefile כקובץ
מטרה ומנסה לבנות אותה מחדש. חוקים מפורשים ומרומזים נבדקים וכל המקור
Makefiles מתעדכנים במידת הצורך. אם אחד מקבצי המקור של Makefile נבנה מחדש, לעשות
מופעל מחדש ממצב נקי.

כדי למנוע לולאות אינסופיות מתעלמים ממטרות המקור הבאות של Makefile:

· :: מטרות שאין להן דרישות קדם

· ! מטרות

· מטרות שיש .מְזוּיָף or .EXEC תכונות

· מטרות ללא דרישות מוקדמות וללא פקודות

בעת יצירה מחדש של מקור Makefile אפשרויות -t (מטרת מגע), -q (מצב שאילתה), ו -n (ללא מנהל)
לא ייכנסו לתוקף, אלא אם כן המקור Makefile צוין במפורש כמטרה ב לעשות
שורת הפקודה.

בנוסף, מערכת makefiles ו .לִסְמוֹך לא נחשבים כ-Makefiles שיכולים להיות
נבנה מחדש.

הסביבה

השמיים לעשות כלי השירות משתמש במשתני הסביבה הבאים, אם הם קיימים: MACHINE, MAKE,
MAKEFLAGS, MAKEOBJDIR, MAKEOBJDIRPREFIX ו-MAKESYSPATH.

השתמש ב-fmake באינטרנט באמצעות שירותי onworks.net