getconfposix - מקוון בענן

תָכְנִית:

שֵׁם

getconf - קבל ערכי תצורה

תַקצִיר

getconf [מפרט -v] system_var

getconf [מפרט -v] path_var שם נתיב

תיאור

בטופס התקציר הראשון, ה getconf השירות יכתוב לפלט הסטנדרטי את
הערך של המשתנה שצוין על ידי system_var אופרנד.

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

הערך של כל משתנה תצורה ייקבע כאילו התקבל על ידי
קורא לפונקציה שממנה היא מוגדרת זמינה בנפח זה של
POSIX.1-2008 או לפי נפח ממשקי המערכת של POSIX.1-2008 (ראה את הפעולות
סָעִיף). הערך ישקף את התנאים בסביבת ההפעלה הנוכחית.

אפשרויות

אל האני getconf כלי השירות יתאים לנפח הגדרות הבסיס של POSIX.1-2008, סעיף
12.2, שירות תחביר הנחיות.

האפשרות הבאה תהיה נתמכת:

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

אם הפקודה:

getconf _POSIX_V7_ILP32_OFF32

אינו כותב "−1\n" or "לא מוגדר\n" לפלט סטנדרטי, ואז פקודות של
טופס:

getconf −v POSIX_V7_ILP32_OFF32 ...

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

אם הפקודה:

getconf _POSIX_V7_ILP32_OFFBIG

אינו כותב "−1\n" or "לא מוגדר\n" לפלט סטנדרטי, ואז פקודות של
טופס:

getconf −v POSIX_V7_ILP32_OFFBIG ...

לקבוע ערכים עבור משתני תצורה התואמים את
POSIX_V7_ILP32_OFFBIG סביבת קומפילציה שצוינה ב c99, המורחב
תיאור.

אם הפקודה:

getconf _POSIX_V7_LP64_OFF64

אינו כותב "−1\n" or "לא מוגדר\n" לפלט סטנדרטי, ואז פקודות של
טופס:

getconf −v POSIX_V7_LP64_OFF64 ...

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

אם הפקודה:

getconf _POSIX_V7_LPBIG_OFFBIG

אינו כותב "−1\n" or "לא מוגדר\n" לפלט סטנדרטי, ואז פקודות של
טופס:

getconf −v POSIX_V7_LPBIG_OFFBIG ...

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

אופרנדים

האופרנדים הבאים יהיו נתמכים:

path_var שם של משתנה תצורה. כל המשתנים בעמודה משתנה
של הטבלה בתיאור של fpathconf() הפונקציה המוגדרת ב-
נפח ממשקי מערכת של POSIX.1-2008, ללא הסוגרים המצורפים, יהיה
נתמך. היישום עשוי להוסיף משתנים מקומיים אחרים.

שם נתיב שם נתיב שעבורו המשתנה שצוין על ידי path_var יש לקבוע.

system_var
שם של משתנה תצורה. כל המשתנים הבאים יהיו
נתמך:

* השמות בעמודת המשתנה של הטבלה בתיאור של ה
sysconf() פונקציה בנפח ממשקי המערכת של POSIX.1-2008, למעט
עבור הערכים התואמים ל-_SC_CLK_TCK, _SC_GETGR_R_SIZE_MAX, וכן
_SC_GETPW_R_SIZE_MAX, ללא הסוגרים התוחמים.

לצורך תאימות עם גרסאות קודמות, שמות המשתנים הבאים יהיו
נתמך גם: POSIX2_C_BIND POSIX2_C_DEV POSIX2_CHAR_TERM
POSIX2_FORT_DEV POSIX2_FORT_RUN POSIX2_LOCALEDEF POSIX2_SW_DEV POSIX2_UPE
POSIX2_VERSION

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

* שמות הקבועים הסמליים המשמשים כ- שם טיעון של
confstr() פונקציה בנפח ממשקי המערכת של POSIX.1-2008, ללא
הקידומת _CS_.

* שמות הקבועים הסמליים הרשומים תחת הכותרות ``מקסימום
ערכים'' ו-''ערכים מינימליים'' בתיאור של כותרת
בכרך Base Definitions של POSIX.1-2008, ללא המצורף
פלטה.

לצורך תאימות עם גרסאות קודמות, שמות המשתנים הבאים יהיו
נתמך גם: POSIX2_BC_BASE_MAX POSIX2_BC_DIM_MAX POSIX2_BC_SCALE_MAX
POSIX2_BC_STRING_MAX POSIX2_COLL_WEIGHTS_MAX POSIX2_EXPR_NEST_MAX
POSIX2_LINE_MAX POSIX2_RE_DUP_MAX

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

היישום עשוי להוסיף ערכים מקומיים נוספים.

STDIN

לא בשימוש.

קלט קבצים

אין.

הסביבה וריאציות

משתני הסביבה הבאים ישפיעו על הביצוע של getconf:

שפה ספק ערך ברירת מחדל עבור משתני הבינאום שאינם מוגדרים או
ריק. (ראה את הכרך של הגדרות הבסיס של POSIX.1-2008, סעיף 8.2,
בינאום משתנים בעד הבכורה של בינאום
משתנים המשמשים לקביעת הערכים של קטגוריות מקומיות.)

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

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

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

NLSPATH קבע את המיקום של קטלוגי הודעות לעיבוד של LC_MESSAGES.

אסינכרוני אירועים

בְּרִירַת מֶחדָל.

STDOUT

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

"%s\n", <ערך>

אחרת, אם המשתנה שצוין מוגדר במערכת, ערכו ייכתב
במתכונת הבאה:

"%d\n", <ערך>

אם המשתנה שצוין חוקי, אך אינו מוגדר במערכת, getconf יכתוב
באמצעות הפורמט הבא:

"לא מוגדר\n"

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

STDERR

השגיאה הסטנדרטית תשמש רק עבור הודעות אבחון.

תפוקה קבצים

אין.

מורחבים תיאור

אין.

יְצִיאָה סטָטוּס

יוחזרו ערכי היציאה הבאים:

0 המשתנה שצוין תקף ונכתב מידע על מצבו הנוכחי
בְּהַצלָחָה.

>0 אירעה שגיאה.

השלכות OF שגיאות

בְּרִירַת מֶחדָל.

אל האני הבא סעיפים יש לו אִינפוֹרמָטִיבִי.

בקשה נוהג

אין.

דוגמאות

הדוגמה הבאה ממחישה את הערך של {NGROUPS_MAX}:

getconf NGROUPS_MAX

הדוגמה הבאה ממחישה את הערך של {NAME_MAX} עבור ספרייה ספציפית:

getconf NAME_MAX / usr

הדוגמה הבאה מראה כיצד להתמודד ביתר זהירות עם תוצאות שיכולות להיות
לא מוגדר:

if value=$(getconf PATH_MAX / usr); אז
if [ "$value" = "לא מוגדר" ]; אז
הד PATH_MAX in / usr is לֹא קָבוּעַ.
אחר
הד PATH_MAX in / usr is ערך $.
fi
אחר
הד שְׁגִיאָה in getconf.
fi

Rationalale

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

פונקציונליות זו של getconf לא יתווסף כראוי על ידי פקודה אחרת כגון:

grep היה /etc/conf

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

גרסאות הצעה מוקדמות של getconf צוין סטטוס יציאה 1 כאשר המשתנה שצוין היה
תקף, אך לא מוגדר במערכת. מחרוזת הפלט "לא מוגדר" משמש כעת כדי לציין
מקרה זה עם קוד יציאה 0 כי כל כך הרבה דברים תלויים בקוד יציאה של אפס כאשר an
כלי השירות שהופעל הצליח.

FUTURE כיוונים

אין.

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