apt-ftparchive - מקוון בענן

תָכְנִית:

שֵׁם

apt-ftparchive - כלי ליצירת קבצי אינדקס

תַקצִיר

apt-ftparchive [-dsq] [--md5] [--delink] [--לקריאה בלבד] [--תוכן] [--קֶשֶׁת ארכיטקטורה]
[-o=config_string] [-c=config_file]
{חבילות נתיב... [לעקוף קובץ [תחילית נתיב]] |
מקורות נתיב... [לעקוף קובץ [תחילית נתיב]] | תוכן נתיב |
לשחרר נתיב | לִיצוֹר config_file סעיף... | לְנַקוֹת config_file |
{-v | --version} | {-h | --עֶזרָה}}

תיאור

apt-ftparchive הוא כלי שורת הפקודה שיוצר את קבצי האינדקס ש-APT משתמש בהם
לגשת למקור הפצה. קבצי האינדקס צריכים להיווצר על בסיס אתר המקור
על התוכן של אותו אתר.

apt-ftparchive הוא קבוצת על של חבילות סריקה dpkg(1) תוכנית, המשלבת את כולה
פונקציונליות באמצעות פקודת החבילות. הוא מכיל גם מחולל קבצי תוכן,
תוכן, ואמצעי משוכלל ל'תסריט' את תהליך היצירה להשלמתו
ארכיון.

כְּלַפֵּי פְּנִים apt-ftparchive יכול לעשות שימוש בבסיסי נתונים בינאריים כדי לשמור את התוכן של .deb
קובץ והוא אינו מסתמך על תוכנות חיצוניות כלשהן מלבד מופעלת דחיסת(1). כאשר עושים מלא
ליצור אותו אוטומטית מבצע בדיקות שינוי קבצים ובונה את הדחוס הרצוי
קבצי פלט.

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

חבילות
הפקודה packages יוצרת קובץ חבילה מעץ ספריות. זה לוקח את
ספריה נתונה ומחפשת בה באופן רקורסיבי אחר קבצי .deb, תוך פולטת רשומת חבילה
ל-stdout עבור כל אחד. פקודה זו שווה בערך ל חבילות סריקה dpkg(1).

האפשרות --db ניתן להשתמש כדי לציין DB מטמון בינארי.

מקורות
הפקודה sources יוצרת קובץ אינדקס מקור מעץ ספריות. זה לוקח את
ספריה נתונה ומחפשת בה באופן רקורסיבי קבצי .dsc, ופולטת רשומת מקור
ל-stdout עבור כל אחד. פקודה זו שווה בערך ל מקורות סריקה dpkg(1).

אם צוין קובץ עקיפה אזי יחפשו קובץ עקיפה של מקור
הרחבה של .src. ניתן להשתמש באפשרות --source-override כדי לשנות את המקור
לעקוף את הקובץ שישמש.

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

האפשרות --db ניתן להשתמש כדי לציין DB מטמון בינארי.

לשחרר
פקודת השחרור יוצרת קובץ שחרור מעץ ספריות. זה רקורסיבי
מחפש בספרייה הנתונה אחר קבצי חבילות ומקורות לא דחוסים וקבצים כאלה
דחוס עם מופעלת דחיסת, bzip2 or lzma כמו גם קבצי Release ו-md5sum.txt כברירת מחדל
(APT::FTPArchive::Release::Default-Patterns). דפוסי שמות נוספים יכולים להיות
נוסף על ידי רישום שלהם ב-APT::FTPARchive::Release::Patterns. לאחר מכן הוא כותב ל-stdout
קובץ שחרור המכיל (כברירת מחדל) תקציר MD5, SHA1, SHA256 ו-SHA512 עבור כל אחד מהם
קובץ.

הערכים עבור שדות המטא-נתונים הנוספים בקובץ השחרור לקוחים מה-
משתנים מתאימים תחת APT::FTPARchive::Release, למשל
APT::FTPARchive::Release::Origin. השדות הנתמכים הם: Origin, Label, Suite,
גרסה, שם קוד, תאריך, תקף-עד, ארכיטקטורות, רכיבים, תיאור.

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

לְנַקוֹת
הפקודה clean מסדרת את מסדי הנתונים המשמשים את קובץ התצורה הנתון על ידי
הסרת רשומות שאינן נחוצות עוד.

LA לִיצוֹר תְצוּרָה

הפקודה create משתמשת בקובץ תצורה כדי לתאר את הארכיונים שאליהם הולכים
להיווצר. זה עוקב אחר פורמט תצורת ISC טיפוסי כפי שניתן לראות בכלי ISC כמו
bind 8 ו-dhcpd. apt.conf(5) מכיל תיאור של התחביר. שימו לב שה-
יצירת תצורה מנותחת בצורה חלקית, אבל apt.conf(5) מנותח בעץ
דֶרֶך. זה משפיע רק על אופן הטיפול בתג ההיקף.

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

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

ArchiveDir
מציין את השורש של ארכיון ה-FTP, בתצורת דביאן סטנדרטית זהו ה-
ספרייה המכילה את צמתים ls-LR ו- dist.

OverrideDir
מציין את המיקום של קבצי העקיפה.

CacheDir
מציין את המיקום של קבצי המטמון.

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

בְּרִירַת מֶחדָל סעיף
הסעיף ברירת מחדל מציין ערכי ברירת מחדל והגדרות השולטות בפעולת
הגנרטור. חלקים אחרים עשויים לעקוף את ברירת המחדל האלה עם הגדרה לכל מקטע.

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

חבילות::הרחבות
מגדיר את רשימת ברירת המחדל של סיומות קבצים שהם קובצי חבילה. זה כברירת מחדל ל
'.deb'.

מקורות::Compress
זה דומה ל- Packages::Compress חוץ מזה שהוא שולט בדחיסה עבור ה
קבצי מקורות.

מקורות::הרחבות
מגדיר את רשימת ברירת המחדל של סיומות קבצים שהם קובצי מקור. זה כברירת מחדל ל
'.dsc'.

תוכן::דחס
זה דומה ל- Packages::Compress חוץ מזה שהוא שולט בדחיסה עבור ה
קבצי תוכן.

תרגום::דחס
זה דומה ל- Packages::Compress חוץ מזה שהוא שולט בדחיסה עבור ה
Translation-en קובץ מאסטר.

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

Filemode
מציין את המצב של כל קבצי האינדקס שנוצרו. ברירת המחדל היא 0644. כל קבצי האינדקס
מוגדרים למצב זה ללא קשר ל-umask.

תיאור ארוך
מציין אם יש לכלול תיאורים ארוכים בקובץ החבילות או לפצל
לצאת לקובץ מאסטר Translation-en.

TreeDefault סעיף
מגדיר ברירת מחדל ספציפית למקטעי עץ. כל המשתנים הללו הם משתני החלפה
והמחרוזות $(DIST), $(SECTION) ו-$(ARCH) יוחלפו בהתאמה שלהם
ערכים.

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

תוכן גיל
שולט במספר הימים שבו מותר לבדוק קובץ תוכן מבלי לשנות.
אם מגבלה זו עוברת, ה-mtime של קובץ התוכן מתעדכן. מקרה זה יכול להתרחש
אם קובץ החבילה משתנה באופן שלא יביא לתוכן חדש
קובץ [לעקוף עריכה למשל]. השהייה מותרת בתקווה ש-.debs חדשים יהיו
להיות מותקן, מצריך קובץ חדש בכל מקרה. ברירת המחדל היא 10, היחידות הן בימים.

מַדרִיך
מגדיר את החלק העליון של עץ ספריות ה-.deb. ברירת מחדל ל
$(DIST)/$(SECTION)/binary-$(ARCH)/

SrcDirectory
מגדיר את החלק העליון של עץ ספריות חבילת המקור. ברירת מחדל ל
$(DIST)/$(SECTION)/source/

חבילות
מגדיר את קובץ חבילות הפלט. ברירת המחדל היא $(DIST)/$(SECTION)/binary-$(ARCH)/Packages

מקורות
מגדיר את קובץ מקורות הפלט. ברירת המחדל היא $(DIST)/$(SECTION)/source/Sources

תרגום
מגדיר את הפלט Translation-en master file עם התיאורים הארוכים אם כן
לא ייכלל בקובץ החבילות. ברירת מחדל ל
$(DIST)/$(SECTION)/i18n/Translation-en

קידומת פנימית
מגדיר את קידומת הנתיב שגורמת לקישור סימלי להיחשב כקישור פנימי במקום זאת
של קישור חיצוני. ברירת המחדל היא $(DIST)/$(SECTION)/

תוכן
מגדיר את קובץ תוכן הפלט. ברירת המחדל היא $(DIST)/$(SECTION)/Contents-$(ARCH). אם
הגדרה זו גורמת למיפוי של מספר קובצי חבילות לקובץ Contents בודד (כמו שהוא
ברירת המחדל) אז apt-ftparchive ישלב את קובצי החבילה יחד
באופן אוטומטי.

תוכן::כותרת
מגדיר את קובץ הכותרת להתייצב לפני פלט התוכן.

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

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

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

עֵץ סעיף
קטע העץ מגדיר עץ קבצי דביאן סטנדרטי המורכב מספריית בסיס,
לאחר מכן מספר חלקים בספריית הבסיס הזו ולבסוף מספר ארכיטקטורות בכל אחד מהם
סָעִיף. הנתיב המדויק שבו נעשה שימוש מוגדר על ידי משתנה ה-Directory Substitution.

הקטע Tree לוקח תג scope שמגדיר את המשתנה $(DIST) ומגדיר את השורש של
העץ (הנתיב הוא קידומת של ArchiveDir). בדרך כלל זוהי הגדרה כגון
dists/jessie.

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

בעת עיבוד קטע עץ apt-ftparchive מבצע פעולה דומה ל:

כי אני בסעיפים לעשות
עבור j באדריכלות לעשות
צור עבור DIST=scope SECTION=i ARCH=j

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

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

תיאור ארוך
מציין אם יש לכלול תיאורים ארוכים בקובץ החבילות או לפצל
לצאת לקובץ מאסטר Translation-en.

BinOverride
מגדיר את קובץ העקיפה הבינארי. קובץ העקיפה מכיל סעיף, עדיפות ו
פרטי כתובת מתחזק.

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

ExtraOverride
מגדיר את קובץ העקיפה הנוסף הבינארי.

SrcExtraOverride
מגדיר את קובץ העקיפה הנוסף של המקור.

BinDirectory סעיף
מקטע bindirectory מגדיר עץ ספריות בינאריות ללא מבנה מיוחד. ה
תג scope מציין את המיקום של הספרייה הבינארית וההגדרות דומות ל
קטע העץ ללא משתני החלפה או הגדרות SectionArchitecture.

חבילות
מגדיר את פלט קובץ החבילות.

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

תוכן
מגדיר את פלט קובץ התוכן (אופציונלי).

BinOverride
מגדיר את קובץ העקיפה הבינארי.

SrcOverride
מגדיר את קובץ דריסת המקור.

ExtraOverride
מגדיר את קובץ העקיפה הנוסף הבינארי.

SrcExtraOverride
מגדיר את קובץ העקיפה הנוסף של המקור.

BinCacheDB
מגדיר את המטמון DB.

PathPrefix
מוסיף נתיב לכל נתיבי הפלט.

רשימת קבצים, SourceFileList
מציין את קובץ רשימת הקבצים.

LA בינארי עקוף קובץ

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

הצורה הכללית של שדה התחזוקה היא:

ישן [// oldn]* => חדש

או בפשטות,

חדש

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

LA מקור עקוף קובץ

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

LA תוֹסֶפֶת עקוף קובץ

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

אפשרויות

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

--md5, --sha1, --sha256, --sha512
צור את סכום הבדיקה הנתון. אפשרויות אלה פועלות כברירת מחדל, כאשר הן מושבתות
קבצי אינדקס שנוצרו לא יכללו את שדות ה-checksum במידת האפשר. תְצוּרָה
פריטים: APT::FTPARchive::סכום בדיקה ו-APT::FTPARchive::מדד::סכום בדיקה איפה מדד יכול
להיות חבילות, מקורות או שחרור ו סכום בדיקה יכול להיות MD5, SHA1, SHA256 או SHA512.

-d, --db
השתמש ב-DB מטמון בינארי. אין לזה השפעה על הפקודה ליצור. תְצוּרָה
פריט: APT::FTPARchive::DB.

-q, --שֶׁקֶט
שֶׁקֶט; מייצר פלט המתאים לרישום, תוך השמטת מחווני התקדמות. עוד ש'
יפיק יותר שקט עד מקסימום 2. אתה יכול גם להשתמש -q=# להגדיר את השקט
רמה, עוקף את קובץ התצורה. פריט תצורה: שקט.

--delink
בצע ביטול קישור. אם נעשה שימוש בהגדרה External-Links אז אפשרות זו למעשה
מאפשר ביטול קישור של הקבצים. ברירת המחדל היא פועלת וניתן לכבות אותה עם
--אין ביטול קישור. פריט תצורה: APT::FTPARchive::DeLinkAct.

--תוכן
בצע יצירת תוכן. כאשר אפשרות זו מוגדרת ומתקיימים אינדקסים של חבילות
נוצר עם קובץ שמור DB אז גם רישום הקובץ יחולץ ויישמר ב
ה-DB לשימוש מאוחר יותר. בעת שימוש בפקודה genereer אפשרות זו מאפשרת גם את
יצירת קבצי תוכן כלשהם. ברירת המחדל מופעלת. פריט תצורה:
APT::FTPARchive::תוכן.

-s, --עקוף מקור
בחר את קובץ דריסת המקור לשימוש עם פקודת המקורות. פריט תצורה:
APT::FTPARchive::SourceOverride.

--לקריאה בלבד
הפוך את מסדי הנתונים המטמון לקריאה בלבד. פריט תצורה: APT::FTPARchive::ReadOnlyDB.

-a, --קֶשֶׁת
קבל בפקודות החבילות והתוכן רק קבצי חבילה התואמים *_arch.deb or
*_all.deb במקום כל קבצי החבילה בנתיב הנתון. פריט תצורה:
APT::FTPARchive::Architecture.

APT::FTPARchive::AlwaysStat
apt-ftparchive(1) מאחסן כמה שיותר של מטא נתונים בקובץ cachedb. אם חבילות כן
הידור מחדש ו/או פורסם מחדש עם אותה גרסה שוב, זה יוביל לבעיות
מכיוון שייעשה שימוש במטא-נתונים המאוחסנים במטמון המיושנים כעת כמו גודל וסיכומי ביקורת. עם זה
האפשרות מופעלת זה לא יקרה יותר מכיוון שייבדק אם הקובץ היה
השתנה. שים לב שאפשרות זו מוגדרת ל"שקר" כברירת מחדל מכיוון שלא מומלץ לעשות זאת
העלה ריבוי גרסאות/בניינים של חבילה עם אותו מספר גרסה, כך בתיאוריה
לאף אחד לא יהיו הבעיות האלה ולכן כל הבדיקות הנוספות האלה חסרות תועלת.

APT::FTPARchive::LongDescription
ברירת המחדל של אפשרות תצורה זו היא "true" ויש להגדיר אותה רק ל-"false" אם
ארכיון שנוצר עם apt-ftparchive(1) מספק גם קבצי תרגום. ציין זאת
ניתן ליצור את קובץ המאסטר Translation-en רק בפקודה gener.

-h, - עזרה
הצג סיכום שימוש קצר.

-v, --גִרְסָה
הצג את גרסת התוכנית.

-c, --config-file
קובץ תצורה; ציין קובץ תצורה לשימוש. התוכנית תקרא את
קובץ תצורת ברירת המחדל ולאחר מכן קובץ תצורה זה. אם הגדרות תצורה
צריך להגדיר לפני ניתוח ברירת המחדל של קובצי התצורה ציין קובץ עם
מה היא APT_CONFIG משתנה הסביבה. לִרְאוֹת apt.conf(5) למידע תחביר.

-o, --אוֹפְּצִיָה
הגדר אפשרות תצורה; פעולה זו תגדיר אפשרות תצורה שרירותית. ה
תחביר הוא -o Foo::Bar=בר. -o ו --אוֹפְּצִיָה ניתן להשתמש מספר פעמים להגדרה
אפשרויות שונות.

דוגמאות

כדי ליצור קובץ חבילות דחוס עבור ספרייה המכילה חבילות בינאריות (.deb):

apt-ftparchive חבילות בספרייה | מופעלת דחיסת > Packages.gz

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