git-cat-file - מקוון בענן

תָכְנִית:

שֵׁם

git-cat-file - ספק תוכן או מידע על סוג וגודל עבור אובייקטי מאגר

תַקצִיר

סילון קובץ חתול (-t [--allow-unknown-type]| -s [--allow-unknown-type]| -e | -p | | --textconv)
סילון קובץ חתול (--batch | ---batch-check) [--follow-symlinks]

תיאור

בצורתה הראשונה, הפקודה מספקת את התוכן או את סוג האובייקט ב-
מאגר. הסוג נדרש אלא אם כן -t or -p משמש למציאת סוג האובייקט, או -s is
משמש כדי למצוא את גודל האובייקט, או --textconv נעשה שימוש (מה שמרמז על סוג "בלוב").

בצורה השנייה, רשימה של אובייקטים (מופרדים על ידי הזנות שורות) מסופקת ב-stdin, ו
ה-SHA-1, הסוג והגודל של כל אובייקט מודפסים על stdout.

אפשרויות

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

-t
במקום התוכן, הצג את סוג האובייקט המזוהה על ידי .

-s
במקום התוכן, הצג את גודל האובייקט המזוהה על ידי .

-e
לדכא את כל הפלט; במקום צא עם סטטוס אפס אם קיים והוא תקף
אובייקט.

-p
להדפיס יפה את התוכן של על סמך סוגו.


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

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

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

---batch-check, --batch-check=
הדפס מידע על אובייקט עבור כל אובייקט המסופק ב-stdin. לא ניתן לשלב עם
כל אופציה או טיעון אחר. עיין בסעיף פלט אצווה להלן לפרטים.

--אצווה-כל-אובייקטים
במקום לקרוא רשימה של אובייקטים ב-stdin, בצע את פעולת האצווה המבוקשת
על כל האובייקטים במאגר וכל מאגרי אובייקטים חלופיים (לא רק נגישים
חפצים). מחייב לציין --batch או --batch-check. שימו לב שהאובייקטים הם
ביקרו לפי סדר מיון לפי ה-hash שלהם.

--בַּלָם
בדרך כלל פלט אצווה נשטף לאחר פלט של כל אובייקט, כך שתהליך יכול
לקרוא ולכתוב באופן אינטראקטיבי מ-cat-file. עם אפשרות זו, הפלט משתמש ברגיל
חציצה של סטדיו; זה הרבה יותר יעיל כשמשתמשים ב--batch-check ב-large
מספר חפצים.

--allow-unknown-type
אפשר -s או -t לבצע שאילתות על אובייקטים שבורים/פגומים מסוג לא ידוע.

--עקוב אחר קישורים סימנים
עם --batch או --batch-check, עקוב אחר סימלינקים בתוך המאגר בעת בקשה
אובייקטים עם ביטויי SHA-1 מורחבים מהצורה tree-ish:path-in-tree. במקום
לספק פלט על הקישור עצמו, לספק פלט על האובייקט המקושר אל. אם
קישור סימלי מצביע מחוץ לעץ-איש (למשל קישור אל /foo או קישור ברמת השורש אל
../foo), החלק של הקישור שנמצא מחוץ לעץ יודפס.

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

לא ניתן (כרגע) להשתמש באפשרות זו אלא אם נעשה שימוש ב--batch או --batch-check.

לדוגמה, שקול מאגר git המכיל:

f: קובץ המכיל "hello\n"
קישור: קישור סימול ל-f
dir/link: קישור סימול ל-../f
plink: קישור סימן ל-../f
alink: קישור סימן אל / etc / passwd

עבור קובץ f רגיל, הד HEAD:f | git cat-file --batch ידפיס

ce013625030ba8dba906f756967f9e9ca394464a blob 6

והד HEAD:קישור | git cat-file --batch --follow-symlinks ידפיס אותו דבר
דבר, כמו HEAD:dir/link, שכן שניהם מצביעים על HEAD:f.

ללא --follow-symlinks, אלה ידפיסו נתונים על ה-Symlink עצמו. בתוך ה
במקרה של HEAD:link, תראה

4d1ae35ba2c8ec712fa2a379db44ad639ca277bd blob 1

גם ה-plink וגם alink מצביעים מחוץ לעץ, כך שהם ידפיסו בהתאמה:

קישור סימלי 4
../ו

קישור סימלי 11
/ etc / passwd

תפוקה

If -t מצוין, אחד מה .

If -s מצוין, הגודל של בבתים.

If -e מצוין, אין פלט.

If -p מצוין, התוכן של מודפסים יפה.

אם מצוין, התוכן הגולמי (אם כי לא דחוס) של יהיה
חזר.

אצווה תפוקה

אם ניתנת --batch או --batch-check, cat-file יקרא אובייקטים מ-stdin, אחד בכל שורה,
ולהדפיס מידע עליהם. כברירת מחדל, הקו כולו נחשב כאובייקט,
כאילו הוא ניזון ל git-rev-parse(1).

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

שם אובייקט
שם האובייקט בן 40 הקושים של האובייקט.

סוג אובייקט
סוג האובייקט (זהה לדו"חות cat-file -t).

גודל אובייקט
הגודל, בבתים, של האובייקט (זהה לדוחות ה-cat-file).

גודל אובייקט:דיסק
הגודל, בבתים, שהאובייקט תופס בדיסק. עיין בהערה לגבי גדלי בדיסק
בסעיף CAVEATS למטה.

דלתאבסיס
אם האובייקט מאוחסן כדלתא בדיסק, זה מתרחב ל-40-hex sha1 של ה-
אובייקט בסיס דלתא. אחרת, מתרחב ל- null sha1 (40 אפסים). ראה אזהרות למטה.

שאר
אם נעשה שימוש באטום זה במחרוזת הפלט, קווי הקלט מפוצלים בראשון
גבול רווח לבן. כל הדמויות לפני הרווח הלבן הזה נחשבות ל-
שם אובייקט; תווים לאחר אותה ריצה ראשונה של רווח לבן (כלומר, "שאר" ה-
line) יוצאים במקום אטום %(rest).

אם לא צוין פורמט, פורמט ברירת המחדל הוא %(objectname) %(objecttype)
%(גודל אובייקט).

אם צוין --batch, מידע האובייקט מלווה בתוכן האובייקט
(המורכב מ-%(objectsize) בתים), ואחריו שורה חדשה.

לדוגמה, --אצווה ללא פורמט מותאם אישית ייצור:

SP SP LF
LF

בעוד --batch-check='%(objectname) %(objecttype)' ייצור:

SP LF

אם צוין שם ב-stdin שלא ניתן לפתור לאובייקט במאגר,
אז cat-file יתעלם מכל פורמט מותאם אישית וידפיס:

SP חסר LF

אם נעשה שימוש ב--follow-symlinks, ו-Symlink במאגר מצביע מחוץ ל-
מאגר, אז cat-file יתעלם מכל פורמט מותאם אישית וידפיס:

סימלינק SP LF
LF

ה-Symlink יהיה מוחלט (מתחיל ב-/), או יחסי לשורש העץ.
לדוגמה, אם dir/link מצביע על ../../foo, אז יהיה ../פו. הוא
גודל ה-Symlink בבתים.

אם נעשה שימוש ב--follow-symlinks, הודעות השגיאה הבאות יוצגו:

SP חסר LF

מודפס כאשר ה-Symlink הראשוני המבוקש אינו קיים.

SP משתלשל LF
LF

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

לולאה SP LF
LF

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

notdir SP LF
LF

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

מערות

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

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

GIT

חלק מ סילון(1) סוויטה

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