llvm-ar-3.8 - מקוון בענן

תָכְנִית:

שֵׁם

llvm-ar - LLVM ארכיון

תַקצִיר

llvm-ar [-]{dmpqrtx}[Rabfikou] [relpos] [ספירה] [קבצים...]

תיאור

אל האני llvm-ar הפקודה דומה לכלי השירות הנפוץ של Unix, ar. זה מאחסן כמה קבצים
ביחד לקובץ אחד. הכוונה לכך היא לייצר ספריות ארכיון על ידי LLVM
bitcode שניתן לקשר לתוכנית LLVM. עם זאת, הארכיון יכול להכיל כל סוג
של קובץ. כברירת מחדל, llvm-ar יוצר טבלת סמלים שהופכת את הקישור למהיר יותר כי
יש לעיין רק בטבלת הסמלים, לא בכל חבר קובץ בודד של
ארכיון.

אל האני llvm-ar ניתן להשתמש בפקודה לקרוא קבצי ארכיון בסגנון SVR4, GNU ו-BSD. למרות זאת,
כרגע זה יכול לכתוב רק בפורמט GNU. אם נעשה שימוש בארכיון בסגנון SVR4 או BSD
עם r (להחליף) או q פעולות (עדכון מהיר), הארכיון ישוחזר ב
פורמט GNU.

הנה איפה llvm-ar יוצא מקודמו ar יישומים:

סמל טבלתי
השאלה היא איך? llvm-ar תומך בקבצי bitcode. טבלת הסמלים שהיא יוצרת היא בפורמט GNU ו
כולל גם קבצי מקור וגם קובצי bitcode.

ארוך נתיבים
כיום llvm-ar יכול לקרוא שמות קבצים ארוכים של GNU ו-BSD, אבל כותב רק ארכיונים עם
פורמט GNU.

אפשרויות

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

הפעולות והשינויים מוסברים בסעיפים שלהלן. הסט המינימלי של
options הוא לפחות אופרטור אחד ושם הארכיון. בדרך כלל מסתיימים קבצי ארכיון
עם .a סיומת, אבל זה לא נדרש. בעקבות ה שם ארכיון מגיעה רשימה של
קבצים שמציינים את החברים הספציפיים בארכיון לניתוח. אם ה קבצים אוֹפְּצִיָה
לא צוין, זה בדרך כלל אומר "אף אחד" או "כל" החברים, בהתאם ל
פעולה.

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

m[abi]
העבר קבצים ממיקום אחד בארכיון לאחר. ה a, b, ו i חלים שינויים
למבצע הזה. ה קבצים כולם יועברו למיקום שניתנו על ידי השינויים.
אם לא נעשה שימוש בשינויים, הקבצים יועברו לסוף הארכיון. אם לא
קבצים מצוינים, הארכיון לא השתנה.

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

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

ר[אבו]
החלף או הוספה של חברי קובץ. ה a, b, ו u שינויים חלים על פעולה זו.
פעולה זו תחליף את הקיים קבצים או הכנס אותם בסוף הארכיון אם
הם לא קיימים. אם לא קבצים מצוינים, הארכיון לא השתנה.

טֵלֶוִיזִיָה]
הדפס את תוכן העניינים. ללא כל משנה, פעולה זו רק מדפיסה את
שמות החברים לפלט הסטנדרטי. עם ה v מַתקֵן, llvm-ar גם הדפסים
את סוג הקובץ (B=bitcode, S=טבלת סימנים, ריק=קובץ רגיל), מצב ההרשאה,
הבעלים והקבוצה, הגודל והתאריך. אם בכלל קבצים מצוינים, הרישום הוא
רק עבור הקבצים האלה. אם לא קבצים מצוינים, תוכן העניינים למכלול
הארכיון מודפס.

x[oP]
חלץ את חברי הארכיון בחזרה לקבצים. ה o השינוי חל על פעולה זו. זֶה
הפעולה מאחזרת את המצוין קבצים מהארכיון וכותב אותם בחזרה אל
מערכת הקבצים של מערכת ההפעלה. אם לא קבצים מצוינים, הארכיון כולו הוא
לחלץ.

משנים (פעולה ספֵּצִיפִי)
השינויים שלהלן הם ספציפיים לפעולות מסוימות. עיין בסעיף התפעול (למעלה)
כדי לקבוע אילו משנה חלים על אילו פעולות.

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

[b]
בעת הכנסה או העברה של קבצי חברים, אפשרות זו מציינת את היעד של החדש
קבצים כמו שהם לפני ה relpos חבר. אם relpos לא נמצא, הקבצים ממוקמים
בסוף הארכיון. משנה זה זהה ל- i שינוי.

[אני]
מילה נרדפת ל- b אוֹפְּצִיָה.

[או]
בעת חילוץ קבצים, אפשרות זו תגרום llvm-ar לשמר את המקור
זמני שינוי של הקבצים שהוא כותב.

[u]
בעת החלפת קבצים קיימים בארכיון, החלף רק את הקבצים שיש להם זמן
חותמת מאשר חותמת הזמן של החבר בארכיון.

משנים (גנרית)
ניתן להחיל את המשתנים להלן על כל פעולה.

[c]
לכל הפעולות, llvm-ar תמיד יצור את הארכיון אם הוא לא קיים.
בדרך כלל, llvm-ar ידפיס הודעת אזהרה המציינת שהארכיון נמצא
נוצר. שימוש בשינוי זה מכבה את האזהרה הזו.

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

[S]
השינוי הזה הוא ההפך מה- s מַתקֵן. זה מורה llvm-ar לא לבנות את
טבלת סמלים. אם שניהם s ו S משמשים, השינוי האחרון שיתרחש באפשרויות יעשה זאת
לנצח.

[V]
משנה זה מורה llvm-ar להיות מילולי לגבי מה שהוא עושה. כל עריכה
פעולה שננקטה נגד הארכיון תיצור שורת פלט האומרת מה יש
בוצע.

תקנים

אל האני llvm-ar תוכנית השירות מיועדת לספק ערכת-על של IEEE Std 1003.2 (POSIX.2)
פונקציונליות עבור ar. llvm-ar יכול לקרוא גם ארכיונים SVR4 וגם BSD4.4 (או Mac OS X). אם ה
f משנה ניתן ל- x or r פעולות אז llvm-ar יכתוב SVR4 תואם
אַרְכִיוֹן. בלי השינוי הזה, llvm-ar יכתוב ארכיונים תואמים BSD4.4 שיש להם
שמות ארוכים מיד אחרי הכותרת ומצוינים באמצעות סימון "#1/ddd" עבור ה-
שם בכותרת.

קובץ פורמט

פורמט הקובץ עבור קבצי LLVM Archive דומה לזה של ארכיון BSD 4.4 או Mac OSX
קבצים. למעשה, פרט לטבלת הסמלים, ה ar פקודות על אותן מערכות הפעלה
אמור להיות מסוגל לקרוא קבצי ארכיון LLVM. הפרטים של פורמט הקובץ להלן.

כל ארכיון מתחיל במספר הקסם של הארכיון שהוא שמונת התווים הניתנים להדפסה
"! n" כאשר n מייצג את תו השורה החדשה (0x0A). בעקבות המספר הקסום,
הקובץ מורכב מאיברים באורך שווה שמתחילים בכותרת ארכיון ומסתיימים ב
תו ריפוד במידת הצורך (כדי שהאורך יהיה אחיד). כל חבר בקובץ מורכב
של כותרת (מוגדרת להלן), "שם קובץ ארוך" אופציונלי שהסתיים בשורה חדשה וה-
תוכן הקובץ.

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

שם - char[16]
שדה זה של הכותרת מספק את שמו של חבר הארכיון. אם השם ארוך יותר
יותר מ-15 תווים או מכיל תו לוכסן (/), אז השדה הזה מכיל #1/nnn
איפה nnn מספק את אורך השם וה- #1/ הוא מילולי. במקרה זה, ה
השם האמיתי של הקובץ מסופק ב- nnn בתים מיד אחרי הכותרת.
אם השם הוא 15 תווים או פחות, הוא כלול ישירות בשדה זה ו
מסתיים עם תו לוכסן (/).

תאריך - char[12]
שדה זה מספק את תאריך השינוי של הקובץ בצורה עשרונית
מספר מקודד המספק את מספר השניות מאז התקופה (מאז 00:00:00 ינואר
1, 1970) לפי מפרטי Posix.

uid - char[6]
שדה זה מספק את מזהה המשתמש של הקובץ המקודד כמחרוזת ASCII עשרונית. זֶה
שדה עשוי להיות לא הגיוני במיוחד במערכות שאינן יוניקס. ב-Unix, זה אותו ערך כמו
השדה st_uid של המבנה הסטטיסטי המוחזר על ידי ה- stat(2) קריאה למערכת ההפעלה.

gid - char[6]
שדה זה מספק את מזהה הקבוצה של הקובץ המקודד כמחרוזת ASCII עשרונית. זֶה
שדה עשוי להיות לא הגיוני במיוחד במערכות שאינן יוניקס. ב-Unix, זה אותו ערך כמו
השדה st_gid של המבנה הסטטיסטי המוחזר על ידי ה- stat(2) קריאה למערכת ההפעלה.

מצב - char[8]
שדה זה מספק את מצב הגישה של הקובץ המקודד כמחרוזת ASCII אוקטלית. זֶה
שדה עשוי להיות לא הגיוני במיוחד במערכות שאינן יוניקס. ב-Unix, זה אותו ערך כמו
השדה st_mode של המבנה הסטטיסטי המוחזר על ידי ה- stat(2) קריאה למערכת ההפעלה.

גודל - char[10]
שדה זה מספק את גודל הקובץ, בבתים, המקודד כמחרוזת ASCII עשרונית.

fmag - char[2]
שדה זה הוא מספר הקסם של חבר קובץ הארכיון. התוכן שלו הוא תמיד השניים
תווים חזרה לתקתק (0x60) ושורה חדשה (0x0A). זה מספק תועלת מידה מסוימת ב
זיהוי קבצי ארכיון שנפגמו.

offset - מספר שלם של 32 סיביות מקודד vbr
פריט ההיסט מספק את ההיסט לקובץ הארכיון שבו נמצא חבר ה-bitcode
מאוחסן המשויך לסמל. ערך ההיסט הוא 0 מבוסס בתחילת
חבר הקובץ ה"רגיל" הראשון. כדי לגזור את קיזוז הקובץ בפועל של החבר, אתה
חייב להוסיף את מספר הבתים שתפוסים על ידי חתימת הקובץ (8 בתים) והסמל
שולחנות. הערך של פריט זה מקודד באמצעות קידוד קצב סיביות משתנה להפחתה
גודל טבלת הסמלים. קידוד קצב סיביות משתנה משתמש בביט הגבוה (0x80) של
כל בייט כדי לציין אם יש עוד בתים לעקוב. 7 הביטים הנותרים בכל אחד
בתים לשאת ביטים מהערך. לבייט האחרון אין את ה-High Bit מוגדר.

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

סמל - מערך תווים
פריט הסמל מספק את הטקסט של הסמל המשויך ל- לקזז. ה
הסמל אינו מסתיים על ידי שום תו. אורכו מסופק על ידי אורך שדה.
שים לב שמותר (אך לא חכם) להשתמש בתווים שאינם מודפסים (אפילו 0x00) ב-
סֵמֶל. זה מאפשר קידודים מרובים של שמות סמלים.

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

If llvm-ar מצליח, הוא ייצא עם 0. שגיאת שימוש, מביאה לקוד יציאה של 1. A
שגיאה קשה (בדרך כלל מערכת קבצים) גורמת לקוד יציאה של 2. שונות או לא ידוע
שגיאות גורמות לקוד יציאה של 3.

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