מתוך הויקי של ג'נטו.

מדריך התקנה זה הוא תרגום של מדריך הויקי האנגלי בנושא.

תוכן המדריך מוגן בזכויות יוצרים של כותבי המדריך המקורי.

התרגום בוצע באישור הרשיון שבו פורסם המסמך המקורי, Creative Commons - Attribution / Share Alike.

על התרגום חלים אותם תנאי רשיון כמו למקור התוכן. המדריך תורגם על ידי oc666.

[עריכה] EMERGE

פרק: פורטאג' (Portage).

עדכון: יוני 2003.

תרגום: יוני 2006.

[עריכה] שם

emerge - ממשק שורת פקודה למערכת הפורטאג'.

תרגום ישיר לעברית: אִימֵרְג'.

פירוש המושג לעברית: הופיע, התגלה, צץ.

[עריכה] תקציר

emerge [פעולה] [אפשרויות] [ebuild | קובץ tbz2 | תלות | מחלקה] ...

emerge --sync | --info | --version

emerge --search something

emerge --help [system | config | sync]

[עריכה] תיאור

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

[עריכה] EBUILDS, קבצי TBZ2, מחלקות ו-תלויות

emerge קודם כל מתקין חבילות. תוכל להורות על התקנת חבילות באחת מארבע הדרכים האפשריות: class, tbz2file, ebuild או dependency.

[עריכה] ebuild

ebuild חייבת להיות שם ספריית חבילת פורטאג' נכונה ללא גירסה או קטגוריה, כמו portage או python. שתי הקטגוריות ומספרי הגירסאות יכולות להיות בשימוש כתוספת, כמו sys-apps/portage או python-2.2.1-r2=. פקודת emerge מתעלמת מקו נטוי (סלאש) של הנתיב כך שניתן להשתמש בהשלמה אוטומטית של שם הקובץ. ה-ebuild יכול להיות גם שם קובץ כמו usr/portage/app-admin/python/python-2.2.1-r2.ebuild/.

[עריכה] קובץ TBZ2

קובץ TBZ2 חייב להיות קובץ tbz2 תקני שנוצר ע"י אחת מן הפקודות הבאות:

ebuild <package>-<version>.ebuild package

emerge --buildpkg [category/]<package>

quickpkg /var/db/pkg/<category>/<package>

[עריכה] מחלקה

מחלקות חבילה הן דרך קצרה לקבוצה של חבילות. כרגע נתמכות שתי מחלקות: system או world. המחלקה system מפנה לקבוצה של חבילות שהכרחיות עבור המערכת כדי שהיא תרוץ כיאות. המחלקה world מכילה את system ביחד עם כל שאר החבילות שקיימות בקובץ var/lib/portage/world/ (ראה פרק קבצים בהמשך לעוד מידע בנושא). שים לב שפקודות אלה באות ביחד עם הפרמטר update--.

[עריכה] תלות

תלות מתארת גבולות על חבילה שתרצה להתקין. ראה גם פורטאג'(5) למידע נוסף על רכיבים אלו (מכונים atoms בעגה המקצועית). לדוגמא, dev-lang/python-2.2.1=< מתאים לגירסא האחרונה האפשרית של Python גדולה או שווה לגירסא 2.2.1. בדומה לכך, dev-lang/python-2.0> מתאים לגירסה האחרונה האפשרית של Python לפני 2.0.

[עריכה] פעולות

[עריכה] ללא שום פרמטר

אם שום פרמטר אינו רשום בפקודה, הפעולה שתתבצע היא התקנת החבילות עם כל התלויות של כל חבילה. הארגומנטים יכולים להיות classes, tbz2s, ebuilds או dependencies. שים לב שתצטרך להשתמש בפרמטר usepkg-- אם תרצה להתקין באמצעות tbz2. החבילות שתרשום בפקודה יתווספו לסוף הקובץ world וכך הם יילקחו בחשבון בעת עדכון.

[עריכה] clean-- (קיצור: c-)

מנקה את המערכת ע"י הסרה של חבילות שלא משפיעות על שימושיות המערכת. הארגומנטים יכולים להיות classes, tbz2s, ebuilds או dependencies. לדוגמא, הפקודה emerge clean binutils ינקה גירסאות ישנות של binutils; הפקודה emerge --clean net-www/mozilla-0.9.9-r2 מנקה את הגירסה הספציפית של מוזילה. לרוב זה בטוח לשימוש.

[עריכה] depclean--

קובע לאילו חבילות מותקנות במערכת אין סיבה להיות שם. emerge מייצר רשימה של חבילות שאמורות להיות מותקנות במערכת ע"י בדיקה של רשימת חבילות system והקובץ world. לאחר מכן הוא משווה רשימה זו לרשימה האמיתית המותקנת במערכת; כל החבילות שאינן תואמות הן חבילות שהמערכת לא זקוקה להם יותר והמערכת מסירה אותם לאחר פסק זמן קצר.

[עריכה] info--

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

[עריכה] metadata--

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

[עריכה] nocolor--

מוודא שלא יווצר פלט בצבעים.

[עריכה] prune-- (קיצור: P-)

פעולה זו מנסה להסיר הכל ולהשאיר אך ורק את הגירסה האחרונה שמותקנת במערכת. מכיוון שהפקודה לא עובדת כיאות עם גירסאות מרובות, היזהר! כמו כן, היא לא בודקת תלויות, לכן, היא עלולה להסיר חבילות חיוניות לעבודה התקינה של המערכת. מומלץ להשתמש ב-clean-- במקום אלא אם אתה יודע מה אתה עושה. הארגומנטים יכולים להיות classes, tbz2s, ebuilds או dependencies - ראה clean-- למעלה עבור דוגמאות. ראה הוזהרת!.

[עריכה] regen--

גורם לפורטאג' לבדוק ולעדכן את מטמון התלויות של כל ה-ebuild-ים בעץ הפורטאג'. המטמון נועד לזרז את החיפוש והבניה של עצי התלויות. הפקודה לא מומלצת עבור משתמשי rsync מכיוון ש-rsync מעדכן את המטמון באמצעות מטמון צד-שרת. אם אינך יודע את ההבדל בין 'משתמש rsync' לבין משתמש אחר, אתה 'משתמש rsync' :). משתמשי rsync אמורים להריץ בפשטות emerge --sync כדי לעדכן את המטמון. לאחר עדכון הפורטאג', משתמשי rsync יכולים למצוא את הפקודה emerge --metadata יעילה ע"מ לבנות המטמון מחדש כפי שהפורטאג' עושה בסיום פעולת הסנכרון.

[עריכה] search-- (קיצור s-)

מחפש התאמה עבור המחרוזת בעץ הפורטאג'. מחרוזת החיפוש היא ביטוי רגולרי. הנה כמה דוגמאות:

emerge --search "^kde"

emerge --search "gcc$"

emerge --search "office"

אם תרצה לחפש גם בתיאור החבילה, השתמש באופציה searchdesc--.

[עריכה] sync--

מעדכן את עץ הפורטאג' עם אחד משרתי rsync.gentoo.org (אתרי mirrors).

[עריכה] unmerge-- (קיצור C-)

מסיר את כל החבילות המתאימות. פעולה זו לא בודקת תלויות, לכן, היא עלולה להסיר חבילות חיוניות לעבודה התקינה של המערכת. הארגומנטים יכולים להיות classes, tbz2s, ebuilds או dependencies - ראה clean-- למעלה עבור דוגמאות.

[עריכה] config--

מריץ פעולות ספציפיות אשר נדרשות להרצה לאחר פעולה ההתקנה (emerge). בד"כ, זה מריץ קובץ אתחול הגדרות או אתחול דומה אחר אשר המשתמש ירצה להריץ.

[עריכה] אופציות

[עריכה] ask-- (קיצור a-)

לפני ביצוע ההתקנה, מציג את ה-ebuilds וקבצי ה-tbz2 שיותקנו, באותו פורמט של האופציה pretend--; לאחר מכן שואל אם תרצה להמשיך בהתקנה או להפסיק. שימוש באופציה זו הרבה יותר יעיל מהאופציה pretend-- ורק לאחר מכן להריץ את ההתקנה בלי האופציה pretend--, מכיוון שהתלויות יחושבו אך ורק פעם אחת.

[עריכה] buildpkg-- (קיצור b-)

מורה ל-emerge לבנות חבילות בינאריות עבור כל ה-ebuilds שיותקנו בנוסף להתקנה החבילות. שימושי לתחזוקה או אם אתה מנהל מספר מערכות ג'נטו (נבנה פעם אחת והתקנת tbz2s היכן שתרצה). החבילה תיווצר בספריה PKGDIR}/All}$. אופציה תחליפית עבור חבילות שמותקנות כבר במערכת היא שימוש באופציה quickpkg, שיוצרת קובץ tbz2 ממערכת הקבצים הקיימת.

[עריכה] buildpkgonly-- (קיצור B-)

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

[עריכה] changelog-- (קיצור l-)

השתמש בזה בצירוף עם האופציה pretend--. זה יראה את דו"ח השינויים (ChangeLog) עבור כל החבילות שיעודכנו.

[עריכה] debug-- (קיצור d-)

מורה ל-emerge לרוץ בשיטת ניטור (debug). בשיטה זו סביבת הבניה של שורת הפקודה תרוץ עם האופציה x-, וכך יפלט מידע ניטור נוסף לאמצעי הפלט (stdout). אופציה זו מצוינת למציאת שגיאות תחביר של קבצי ההרצה.

[עריכה] deep-- (קיצור D-)

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

[עריכה] emptytree-- (קיצור: e-)

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

[עריכה] fetchonly-- (קיצור: f-)

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

[עריכה] fetch-all-uri-- (קיצור: F-)

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

[עריכה] getbinpkg-- (קיצור: g-)

משתמש בשרת והמיקום שמוגדר ב-PORTAGE_BINHOST (ראה גם make.conf), פורטאג' יוריד את כל המידע מכל חבילה בינארית שתימצא וישתמש במידע זה כדי לבנות רשימת תלויות. אופציה זו שימושית עם k- (השתמש בזוג האופציות gK- עבור התקנה בינארית בלבד).

[עריכה] getbinpkgonly-- (קיצור: G-)

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

[עריכה] help-- (קיצור: h-)

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

[עריכה] newuse-- (קיצור N-)

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

[עריכה] noconfmem--

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

[עריכה] nodeps-- (קיצור: O-)

מתקין את החבילות ללא כל תלות.

[עריכה] noreplace-- (קיצור: n-)

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

[עריכה] nospinner--

מנטרל את ה-spinner של הממשק. ה-spinner פעיל כאשר הטרמינל הוא מסוג TTY. דגל זה לא פעיל ללא זה.

[עריכה] oneshot-- (קיצור: 1-)

מתקין באופן רגיל, אבל לא מוסיף את החבילה לקובץ הפרופיל world בשביל לעדכן את החבילה בהמשך.

[עריכה] onlydeps (קיצור: o-)

מתקין (או מדמה התקנה) רק את התלויות של החבילות שציינת ולא את החבילה שציינת.

[עריכה] pretend-- (קיצור: p-)

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

N = חבילה חדשה (לא הותקנה עדיין) [New]

S = חבילה חדשה, אבל גירסה אחרת כבר קיימת (התקנת גירסה חדשה לצד גירסה ישנה) [Slot]

U = עדכון חבילה (שינוי גירסה) [Update]

D = ירידה בגירסה (הגירסה הטובה למערכת שלך הינה גירסה ישנה יותר) [Downgrade]

R = החלפה (התקנת אותה גירסה) [Replace]

F = מוגן הורדה (יש להוריד ידני) [Fetch]

f = מוגן הורדה (אך הורד כבר) [fetched]

B = חסום ע"י חבילה אחרת שהותקנה במערכת [Blocked]

[עריכה] quiet-- (קיצור: q-)

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

[עריכה] resume--

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

[עריכה] searchdesc-- (קיצור: S-)

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

[עריכה] skipfirst--

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

[עריכה] tree-- (קיצור: t-)

מראה את עץ התלויות עבור המטרה לפי זיהוי התלויות. זה שימושי רק בצירוף עם emptytree-- או update-- ו-deep.

[עריכה] update-- (קיצור: u-)

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

[עריכה] upgradeonly (קיצור: U-)

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

[עריכה] usepkg-- (קיצור k-)

מורה להתקנה להשתמש בחבילות בינאריות (מ-PKGDIR$) אם זה אפשרי, זה קרוב לוודאי יחסוך זמן קימפוk. אופציה זו שימושית להתקנה מכונן תקליטורים; תוכל לייצא את PKGDIR=/mnt/cdrom/packages ואז להשתמש באופציה כדי להורות להתקנה "למשוך" את החבילות הבינאריות מכונן התקליטורים בכדי שהתלויות יהיו נכונות.

[עריכה] usepkgonly-- (קיצור: K-)

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

[עריכה] verbose-- (קיצור: v-)

מורה להתקנה לרוץ במצב מורחב (verbose). כרגע, דגל זה גורם להתקנה לפלוט מידע שגיאות GNU, אם ישנם כאלה, ולהציג את דגלי ה-USE בשימוש כל חבילה שתותקן כאשר מדמים התקנה (בעזרת האופציה pretend--).

[עריכה] version-- (קיצור: V-)

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

[עריכה] פלט

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

[blocks B ] app-text/dos2unix (from pkg app-text/hd2u-0.8.0)

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

[ebuild N ] app-games/qstat-25c

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

[ebuild NS ] dev-libs/glib-2.4.7

ישנה גירסה מותקנת של החבילה glib, אבל גירסה אחרת חדשה יותר תותקן לחוד (SLOT).

[ebuild R ] sys-apps/sed-4.0.5

Sed 4.0.5 כבר הותקנה, אבל אם תריץ את הפקודה פורטאג' יתקין מחדש את החבילה הספציפית (sed במקרה זה).

[ebuild F ] media-video/realplayer-8-r6

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

[ebuild f ] media-video/realplayer-8-r6

קבצי חבילת realplayer כבר הורדו.

[ebuild U ] net-fs/samba-2.2.8 [2.2.7a]

Samba 2.2.7a כבר מותקן ויוכל להתעדכן לגירסה 2.2.8.

[ebuild UD] media-libs/libgd-1.8.4 [2.0.11]

Libgd 2.0.11 כבר הותקן, אבל אם תריץ את הפקודה פורטאג' יוריד עבורך את הגירסה ל-1.8.4.

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

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

[ebuild U-] x11-base/xfree-4.3.0 [4.2.99.902]

הסימן '-' מייצג חוסר במידע על התקנת Xfree בנוסף לגירסה קיימת (SLOT). זה יקרה כאשר גירסה קודמת שהותקנה הותקנה מחוץ לפורטאג' (לא בעזרת הפקודה emerge) או שהיא מאוד ישנה (כזאת ישנה ש"חריץ" [SLOT] כבר אינו קיים). בכל מקרה, גירסה חדשה יותר של Xfree אפשרית לעדכון.

[ebuild U ] sys-devel/distcc-2.16 [2.13-r1] -gtk +ipv6* (-selinux)

הפלט "gtk-" משקף את המצב של משתנה ה-USE כאשר מתקינים את distcc. כאן נראה ש-distcc יכול להשתמש במשתנה ה-USE בשם gtk, אבל ההגדרה הנוכחית שלך מנטרלת אופציה זו. זה אומר שתמיכה אופציונאלית עבור gtk לא תאופשר ב-distcc כאשר תתקין את האחרון. הכוכבית מראה שדגלי ה-USE השתנו מאז הפעם האחרונה שהחבילה הותקנה. במקרה זה, ipv6 מאופשר אבל בפעם האחרונה הוא נוטרל. דגל ה-USE בסוגריים, כמו selinux-, כל הזמן מנוטרל וזה מראה שהדגל אינו מאופשר לגירסה הנוכחית של פרופיל המערכת.