gup - מקוון בענן

תָכְנִית:

שֵׁם

גאפ - א Group Update Pרוגרם שמקבל פקודות בדואר לעריכת קבוצת דיון
קובץ מנוי לשימוש מאוחר יותר על ידי מערכות חדשות כגון פונדק ו C-חדשות.

תחביר

גאפ [-hvP] -א נתיב_פעיל [-d home_directory] [-l log_path]
[-m reply_headers] [-n נתיב_קבוצות דיון]
[-s site_directory] [-M Mail_command]

תיאור

המטרה היחידה של גאפ היא להפוך את התהליך המייגע של עריכת בחירת קבוצות לאוטומטיות
דפוסים שהוגדרו בקבצי תצורת החדשות (למשל: ``חדשות פידים'' עבור פונדק ו-``sys''
ל C-חדשות).

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

גאפ מיועד להתקנה כתוכנת שרת דואר המוזנת באמצעות דואר נכנס
סטדין. גאפ מופעל בדרך כלל מקובץ .forward. לְמָשָׁל:

"|/.../bin/gup -Options...."

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

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

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

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

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

אפשרויות

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

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

-d home_directory
מגדיר גאפהספרייה הביתית. גאפ שינויים בספרייה זו בהקדם האפשרי
לאחר ההפעלה. אם אפשרות זו אינה קיימת, נעשה שימוש בספרייה הנוכחית.
גאפ מחפש את הקובץ ``config'' בספריית הבית שלו.

-h הדפס הודעת עזרה המציגה את אפשרויות שורת הפקודה, ואז צא.

-l log_path
תיעוד של כל הבקשות המשמעותיות נכתב לקובץ זה. אם השביל הוא
יחסית, אז זה יהיה יחסית ל גאפספריית הבית של; ראה את האפשרות -d).
גאפ חייב להיות מסוגל לכתוב לקובץ זה. אם ה -l אם כך, לא נעשה שימוש באפשרות גאפ
משתמש ב-stderr. זה שימושי למטרות בדיקה, אבל לא סביר שיהיה שימוש ב-
קובץ .forward.

-m reply_headers
מתי גאפ יוצר תגובת דואר זה יוצר רק את שורת הכותרת ``To:''.
אפשרות זו מגדירה את הנתיב של קובץ המכיל כותרת אחרת תואמת RFC882
קווים שמועברים לתוכנת הדואר (ראה אפשרות -M). למעשה, אם זה
הקובץ מכיל גוף העוקב אחר הכותרות, ואז זה יקדים כל טקסט
נוצר באמצעות גאפ. אם נתיב זה אינו נתיב מוחלט, אזי הוא יטופל כאל
ביחס ל גאפספריית הבית של (ראה את האפשרות -d).

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

-n נתיב_קבוצות דיון
אם קיים, קובץ קבוצות הדיון משמש כדי לנסות למצוא תיאור תואם של
קבוצת דיונים כשרשומה.

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

-s אתרים_מדריך
קובץ ``קבוצות'' ו-``אי הכללה'' של כל אתר ממוקמים בספרייה ייחודית עבור
כל אתר. ספריות אתרים אלו ממוקמות בספרייה המוגדרת עם זה
אוֹפְּצִיָה. אם זה ניתן כנתיב יחסי אז זה יהיה יחסית ל גאפהבית של
ספרייה (ראה את האפשרות -d). גאפ ינסה ליצור את הספרייה הזו אם כן
לא קיים.

-v הדפס את מספר הגרסה ומשתני זמן קומפילציה שונים, ואז צא.

פקודות

גאפ סורק את גוף הדואר לאיתור פקודות. מתעלמים משורות ריקות ומכל נתונים לאחר מכן
התו ``#'' נחשב כהערה. אסור להמשיך. הרבה מה
פקודות מקבלות דפוס כפרמטר. דפוס זה זהה לפורמט של
wildmat() דפוס; לִרְאוֹת wildmat (3) ). למעשה, גאפ משתמש בכוונה ב wildmat שגרה
מ-INN כדי להבטיח שמאפייני התאמת הדפוסים זהים.

פקודות חוקיות הן:

אתר שם אתר סיסמא
זֶה צריך להיות הפקודה הראשונה בדואר. שם אתר ו סיסמא חייב להתאים א
ערך בקובץ ``config''. רק אחד אתר הפקודה מותרת לכל דואר. כינויים:
"פתוח" ו"מארח".

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

לכלול דפוס
אל האני דפוס נבדק מול הקובץ הפעיל. אם זה תואם לפחות אחד
קבוצת דיונים, ה דפוס ממוקם בסוף קובץ ``קבוצה'' של האתר כקובץ
לכלול כְּנִיסָה. רק אחד דפוס עבור לכלול הפקודה מותרת. אם התבנית
מתאים לכל דבר ברשימת החרגות של האתר (ראה מסים) ואז ה-include
ייכשל. כינויים: "+" ו-"inc".

להוציא דפוס
אל האני דפוס נבדק מול הקובץ הפעיל. אם זה תואם לפחות אחד
קבוצת דיונים, ה דפוס ממוקם בסוף קובץ ``קבוצה'' של האתר כקובץ
להוציא כְּנִיסָה. רק אחד דפוס עבור להוציא הפקודה מותרת. כינויים: "-" ו
"exc".

רעל דפוס
אם דפוס תואם לפחות קבוצת דיון מוצלבת אחת המאמר לא יהיה
מתקבל גם אם מותר על ידי א לכלול הַצהָרָה. רק אחד דפוס עבור רעל
הפקודה מותרת.

לעזור צור הודעת עזרה קטנה המתארת ​​בקצרה כל פקודה. יש
מרומז יציאה עם פקודת העזרה ולכן אין טעם להציב פקודות אחרי
פקודת העזרה. כינוי: "ח".

רשימה רשום את כל הנוכחים לכלול ו להוציא תבניות בקובץ ``קבוצות'' של האתרים.
הפלט הוא בפורמט המתאים להזנה חזרה גאפ בשלב מאוחר יותר אם
צריך להיות. כינוי: "ל".

להסיר דפוס
מחק הכל לכלול, להוציא ו רעל דפוסים בקובץ ``קבוצות'' של האתר ש
להתאים את דפוס. ``מחק *'' היא דרך יעילה לניקוי כל הנוכחים
דפוסי.

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

מעבד

גאפ יש מספר שלבי עיבוד. שלב האתחול מורכב משינוי ל
ספריית הבית (ראה את האפשרות -d) ופתיחת קובץ היומן (ראה את האפשרות -l). בְּ
הפעם, גאפ מגדיר את כתובת הדואר הזמנית לתשובה לכתובת הדואר ``מעצור אחורי''
מוגדר מתי גאפ הורכב (בדרך כלל מנהל החדשות המקומיות).

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

לאחר עיבוד כל הכותרות, גוף המייל נבדק לאיתור פקודות.
הפקודה הראשונה צריך להיות ה אתר פקודה. כל מידע אחר גורם להודעת דואר שגיאה שנשלחה
לכתובת הדואר הזמנית לתשובה. אם ה אתר הפקודה מכילה שם תואם
ערך בקובץ ``config'', ולאחר מכן כתובת הדואר הזמנית לתשובה מוחלפת ב-
כתובת הדואר בקובץ ``config''.

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

פעם אחת תקף אתר הפקודה התקבלה, גאפ שינויים בספרייה של האתר ב
Sites_directory (ראה את האפשרות -s) מה שהופך את ה-Sites_directory ואת ספריית האתר בתור
נחוץ. שם הספרייה של האתר זהה לשם האתר. בהעדר ה
אפשרות זו תהיה:

$HOME/sites/$site

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

מהנקודה הזאת גאפ מקבל כל פקודה בכל סדר עד סוף הדואר,
פקודת יציאה פקודת עזרה או שגיאה חמורה במהלך העיבוד. אחרי כל הפקודות
עברו עיבוד, גאפ עדכון הוא קובץ ``קבוצות'' של האתר אם בוצעו שינויים.
עדכון זה כולל גיזום כל דפוס מיותר (אלא אם כן נעשה שימוש באפשרות -P). גאפ
כותב את הדפוסים החדשים ל- ``groups.new''. לאחר מכן הוא משנה את שמות ``groups'' ל-``group.old'' ו
סוף סוף משנה את השם של ``groups.new'' ל-``groups''. התוצאה של כל העיבוד הזה נשלחת בדואר
למנהל האתר שהוגדר בקובץ ``config''.

התצורה

גישה ל גאפ נשלט על ידי קובץ ``config'' ב גאפספריית הבית של (ראה את -d
אוֹפְּצִיָה). קובץ זה מכיל שורה אחת לכל אתר. כל שורה מכילה שלושה רווחים לבנים
אסימונים מופרדים. שם האתר, הסיסמה וכתובת הדואר של המנהל. רֵיק
מותרות שורות והערות עוקבות אחרי התו ``#''. גאפ משתמש פשוט מאוד
tokenizer, לכן אסור לצטט או להמשיך בקובץ זה.

שם האתר והסיסמה משמשים לבדיקת כניסה נכנסת אתר פקודה. הסיסמה יכולה להיות
מוצפן או בפנים טקסט רגיל לכן יש להגדיר בקפידה את ההרשאות כדי להגביל את הגישה. הנה
דוגמה לקובץ ``config''.

werple Fert5566a__$1 [מוגן בדוא"ל]
torps 34fkr_&&11)Zz [מוגן בדוא"ל]
uunet R_S_1@@*(A-\ [מוגן בדוא"ל]
.מבחן דש מסומן

אני מקווה שזה ברור אינטואיטיבית...

קבוצות

לכל אתר יש קובץ דפוסים משלו. קובץ זה נקרא ``קבוצות'' והוא ממוקם ב
הספרייה של האתר עצמו מתחת ל-Sites_directory (ראה את האפשרות -s). הקובץ הזה
מכיל תבנית אחת בכל שורה. לרשימות אי הכללה יש תו ``!'' קודם. הנה
דוּגמָה:

apana.*
!apana.lists.*
!apana.fido.*
!apana.vortex.*
alt.bbs.waffle
alt.cult-movies
alt.galactic-guide
alt.sport.באולינג
aus.*
!aus.ai
!aus.religion
!aus.radio
!aus.stats.s
...

בדרך כלל יש לשנות את הקובץ הזה רק על ידי גאפ, אבל בהנחה שאתה מספק לנעילה,
אין שום סיבה שתהליך אחר לא יוכל לשנות גם אותו. בְּכָל פַּעַם גאפ צריך להגיש בקשה
משתנה, הוא משנה את שם הקובץ הזה ל- ``groups.old'' לפני כתיבה מחדש של הקובץ ``groups''.
זה נותן לך מידה מסוימת של התאוששות.

מסים

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

דיאגנוסטיקה

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

הגבלות

גאפ אינו מבין ``דפוסי הפצה''. יש ליצור כל דפוס כזה ו
נשמר ללא תלות ב גאפ.

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