shush - מקוון בענן

תָכְנִית:

שֵׁם

shush - הפעל פקודה ובאופן אופציונלי דווח על הפלט שלה בדואר

תַקצִיר

לְהַשְׁתִיק [ -h | -V ]

לְהַשְׁתִיק [ -c dir ] [ -S | -s מתקן ] [ -vfmk ] שם [ ID ]

לְהַשְׁתִיק [ -c dir ] [ -H ל ] [ -R ל ] [ -T ל ] -ג שם [ stdout [ סטדרר ]]

לְהַשְׁתִיק [ -i | -u | -r ] [ -c dir ]

תיאור

לְהַשְׁתִיק מריץ פקודה ובאופן אופציונלי מדווח על הפלט שלה בדואר. זוהי עטיפה שימושית
סביב עבודות cron. כברירת מחדל, לְהַשְׁתִיק לא יפיק שום פלט בעת הפעלה כ
הכל (אם בכלל) מדווח בדואר. עם זאת, תצורה כמו גם קריטית
שגיאות ידווחו בשגיאה הסטנדרטית וב-syslog (אופציונלי). כי
מפריע לְהַשְׁתִיק יש השלכות קשות כולל אובדן סביר של תפוקה כלשהי מה-
הפקודה, האותות הנפוצים הבאים מתעלמים על ידי לְהַשְׁתִיק: SIGHUP, SIGINT, SIGQUIT
ו-SIGTERM. אם באמת רוצים להרוג מופע רץ של לְהַשְׁתִיק במקום להרוג
ניתן להשתמש בפקודה המנוהלת הפועל, SIGKILL ותשמש כתזכורת כיצד
פעולה כזו בדרך כלל אינה הולמת.

לפקודה שתופעל באמצעות לְהַשְׁתִיק, קובץ תצורה שם חייב להתקיים ב
ספריית הגדרות ($HOME/.shush כברירת מחדל). קובץ זה מגדיר כיצד הפקודה
יש להפעיל גם מתי לשלוח דוחות בדואר. לפרטים על זמין
פרמטרי תצורה, ראה את תְצוּרָה להלן.

ייתכן שקיימים שני קובצי תצורה נוספים: name.stdout ו name.stderr (כברירת מחדל).
קבצים אלה משמשים כדי להסתכל על הפלט הסטנדרטי ושגיאת התקן (בהתאמה)
שהופק על ידי הפקודה. לפרטים כיצד להשתמש בהם, עיין ב- פקודה תפוקה סעיף
לְהַלָן.

כאשר -C אפשרות מוגדרת, לְהַשְׁתִיק יטען רק את התצורה, באופן אופציונלי
לנתח את הפלט הסטנדרטי והשגיאה הסטנדרטית מהקבצים שצוינו ולבסוף
הפקת דוחות לדוגמה אם תרצה. זה עשוי לשמש גם להפקת דוחות אם לְהַשְׁתִיק
לא הצליח להסתיים כראוי בעת הפעלת פקודה. (הפלט הסטנדרטי והשגיאה מ
הפקודה נמצאת בדרך כלל בקבצים הממוקמים תחת /tmp.)

לְהַשְׁתִיק מסוגל לנהל crontab(5) ערכים המבוססים על תצורות שהוגדרו על ידי המשתמש.
ניתן לעשות זאת באחת משתי דרכים. אם קובץ בשם "לוח זמנים"קיים ב
ספריית התצורה, ולאחר מכן היא נקראת למידע על תזמון. כל שורה צריכה
מכיל ערך בודד המכיל שלושה שדות מופרדים על ידי רווחים לבנים. השדות הם
(לפי הסדר) שם המארח שעבורו הערך חל או התו "*" שיכלול את כולם
מארחים, התצורה שם, ולבסוף, מידע התזמון באותו פורמט
כפי שמשמש את לוח זמנים פרמטר (ראה להלן). כדי לציין א ID, להשתמש שם:ID כמו
שדה שני. אם אין קובץ בשם "לוח זמנים", לאחר מכן לְהַשְׁתִיק בודק את התצורה
ספריית קבצי תצורה ומוסיפה אותם לקבצי המשתמש הנוכחיים crontab(5) קובץ כ
המצוין על ידי הכלול לוח זמנים פרמטר (ראה להלן). קבצים ששמותיהם מתחילים בהם
מתעלמים מהתו "#" או הסוף בתו "~".

אפשרויות

-h הצג הודעת עזרה קצרה.

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

-c dir ציין את הספרייה שבה מאוחסנות התצורות.

-s מתקן
מגדיר את מתקן ה-syslog לשימוש עבור רישום.

-S השבת את רישום ה-syslog.

-v העתק הודעות יומן מידע לפלט הסטנדרטי.

-f מצב מהיר: כל מוגדר עיכוב אקראי מתעלמים.

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

-k שמור את קובצי יומן הפלט של הפקודה במקום למחוק אותם עם השלמתם.

-C בדוק את התצורה מבלי להפעיל שום פקודה.

-H ל שלח דוח HTML לדוגמה לנמענים שצוינו.

-R ל שלח דוח מועשר לדוגמה לנמענים שצוינו.

-T ל שלח דוח טקסט לדוגמה לנמענים שצוינו.

-i השתמש crontab(1) להתקין חדש crontab(5) קובץ עבור המשתמש הנוכחי. המשתמש
לא חייב להיות כבר א crontab(5) קובץ.

-u השתמש crontab(1) לעדכון של המשתמש הנוכחי crontab(5) קובץ, שחייב כבר
קיימים.

-r הסר כל ערך שנוסף על ידי -u אפשרות מהמשתמש הנוכחי crontab(5).

תְצוּרָה

לְהַשְׁתִיק קובצי תצורה מורכבים מקטע ראשי, מקטע(ים) דוחות ופרמטרים.
הסעיף הראשי מגדיר פרמטרים גלובליים וכן ברירות מחדל עבור דוחות. כל דיווח
הקטע מתחיל בשם הדוח בין סוגריים. שורות המתחילות ב-
מתעלמים מהתו "#". יש לציין פרמטרים פעם אחת בלבד. אם צוין
מספר פעמים, יתעלם מכל ההתרחשות מלבד ההתרחשות האחרונה, אלא אם צוין אחרת.
פרמטרים מוגדרים באמצעות התחביר הבא:

שם=ערך

או:

שם@המארח=ערך

או:

שם%ID=ערך

או לבסוף:

שם@המארח%ID=ערך

הפורמט השני והרביעי יתעלם אלא אם כן לְהַשְׁתִיק פועל על המצוין
שם מארח. הפורמט השלישי והרביעי מאפשר להגדיר מספר מופעים של יחיד
קובץ תצורה. קובצי תצורה כאלה דורשים מופע ID לפרט ב
כדי לרוץ. כל שורת תצורה המשתמשת בפורמט השלישי או הרביעי תתעלם אם
מה היא ID שנמצא בשורה זו אינו תואם את המופע ID נהג לרוץ לְהַשְׁתִיק.

הפרמטרים הבאים עשויים להופיע בחלק הראשי:

הפקודה
הפקודה בפועל להפעלה. לְהַשְׁתִיק מגדיר שני משתני סביבה לפני הפעלת ה
פקודה: SHUSH_NAME מוגדר שם, ו SHUSH_ID מוגדר ID.

config זה כברירת מחדל לנתיב המלא של קובץ התצורה הראשי. השניים האחרים
שמות קבצי תצורה מתקבלים על ידי הוספת ה-".stdout" ו-".stderr"
סיומות לערך של פרמטר זה.

לנעול אם מוגדר, פרמטר זה מורה לְהַשְׁתִיק כדי להשיג קובץ נעילה לפני הפעלת ה
הפקודה, ומגדיר את הפעולות שיש לנקוט במקרה שה קובץ נעילה מוחזק על ידי אחר
תהליך. הפורמט הוא רשימה מופרדת בפסיקים של פעולות. פעולות תקפות הן: א
משך הזמן (במהלכו לְהַשְׁתִיק צריך פשוט לחכות ולהמשיך לנסות להשיג את
קובץ נעילה), המחרוזת "בטל" (המציינת זאת לְהַשְׁתִיק צריך להפסיק לאלתר
אם קובץ נעילה כבר קיימת), המחרוזת "התעלם" (המציינת זאת לְהַשְׁתִיק צריך
להתעלם מקיים קובץ נעילה), המחרוזת "לולאה" (כדי לסמן מאיפה להתחיל שוב
כאשר כל הפעולות בוצעו) והמחרוזת "notify=" ואחריה דואר
כתובות שאליהן יש לשלוח מייל התראה. פעולות מבוצעות ב-
כדי שהם מסופקים, ו לְהַשְׁתִיק יחכה לנצח בניסיון להשיג את קובץ נעילה
לאחר שכל הפעולות בוצעו, אלא אם המחרוזת "לולאה" היא אחת המוגדרת
פעולות. ניתן לציין את משכי הזמן ביחידות של w(eeks), d(ays), h(ours),
m(inutes) או s(שניות). אם לא צוינה יחידה, ההנחה היא שזה דקות.

קובץ נעילה
כברירת מחדל, לְהַשְׁתִיק ישתמש בקובץ שנמצא באותה ספרייה כמו ה-
קובץ תצורה, ונקרא על שם התצורה ושמות המארח. מחליף
ניתן לציין את שם הקובץ באמצעות פרמטר זה.

lockmsg
אם מוגדר, מחרוזת זו תשמש כנושא עבור הודעות דואר של הודעות נעילה.
ברירת המחדל היא "[%u@%h] **בהמתנה** %N [%t]". ראה את MAIL נושא סעיף
פרטים על הפורמט.

נתיב לְהַשְׁתִיק אינו משנה את הסביבה, אלא כדי להגדיר את נתיב משתנה אם ה נתיב
הפרמטר מוגדר.

עיכוב אקראי
אם פרמטר זה מוגדר, לְהַשְׁתִיק ימתין עד פרק הזמן שצוין לפני
התחלת הפקודה אלא אם הופעלה עם ה- -f. יחידות זמן תקפות הן: s(שניות),
m(inutes), h(ours), d(ays), w(eeks). אם לא צוינה יחידה, ההנחה היא שכן
דקות.

לוח זמנים
זה מגדיר מתי להפעיל פקודה זו כעבודת cron, ב-a crontab(5) תואם
פוּרמָט. ניתן לציין מספר ערכים באמצעות התו ";" כמפריד.
ערכים עם קידומת התו "#" ידלגו. פרמטר זה לא
בשימוש ישיר על ידי לְהַשְׁתִיק כדי להפעיל את הפקודה, אך בשימוש על ידי -i ו -u אפשרויות.

שלח מייל
זה עשוי לשמש כדי לעקוף את הפקודה המשמשת לשליחת דואר.

פָּגָז כברירת מחדל, מעטפת בורן sh(1) משמש להפעלת ה הפקודה, המאפשר כל פגז
תחביר שיש להשתמש בו. ניתן להגדיר מעטפת חלופית באמצעות פרמטר זה.

statedir
זה מגדיר את הספרייה שבה הסטטוס של לְהַשְׁתִיק נשמר ומוגדר כברירת מחדל
ספריית ".state" תחת המקום שבו ממוקמת התצורה. נוצרת שגיאה
אם הספרייה לא קיימת אלא אם אפשרות זו לא הוגדרה. מגדיר את זה
אפשרות למחרוזת ריקה תמנע לְהַשְׁתִיק מלשמור את הסטטוס שלו. שלסט(1)
משתמש בקבצי מצב אלה כדי לדווח על מופעים פועלים של לְהַשְׁתִיק כמו גם קודם
רץ.

syslog פרמטר זה הוא רק בשימוש על ידי -i ו -u אפשרויות ואין לה השפעה אחרת על
לְהַשְׁתִיק. זה מאפשר לעקוף את מתקן ברירת המחדל של syslog המשמש לרישום ו
מוגדר בזמן הקומפילציה. אם נשאר ריק, זה דוחק את השימוש ב-syslog.

פסק זמן
פרמטר זה מאפשר לשלוט בכמה זמן הפקודה עשוי לרוץ. זה צריך להיות א
רשימת פעולות מופרדת בפסיק. פעולות חוקיות הן: משך זמן (במהלכו
לְהַשְׁתִיק צריך פשוט לחכות ל הפקודה לסיים), אות (או "SIGNAME"
או "-SIGNUMBER") שיש לשלוח אל הפקודהקבוצת התהליך של, אות
(או "=SIGNAME" או "=SIGNUMBER") שיש לשלוח אל פָּגָז נהג להשריץ
מה היא הפקודה, המחרוזת "לולאה" (כדי לסמן היכן להתחיל שוב כאשר כל הפעולות
בוצעו) והמחרוזת "notify=" ואחריה כתובות דואר שאליהן א
יש לשלוח דואר הודעה. הפעולות מבוצעות לפי הסדר שהן
בתנאי, ו לְהַשְׁתִיק יחכה לנצח אם ה הפקודה עדיין פועל פעם אחת
בוצעו פעולות אלא אם המחרוזת "לולאה" היא אחת מהפעולות המוגדרות.
ניתן לציין את משכי הזמן ביחידות של w(eeks), d(ays), h(ours), m(inutes) או
שניות). אם לא צוינה יחידה, ההנחה היא שזה דקות.

timeoutmsg
אם מוגדר, מחרוזת זו תשמש כנושא לדואר של הודעות על פסק זמן
הודעות. ברירת המחדל היא "[%u@%h] **TIMEOUT** %N [%t]". ראה את MAIL נושא
סעיף לפרטים על הפורמט.

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

ל, cc, BCC
לאן לשלוח את דוח הדואר.

נושא
נושא דוח הדואר. ראה את MAIL נושא סעיף לפרטים על
פורמט.

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

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

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

תפוקה (בעבר"סטדרר")

זֶה מגדיר אֵיך מה היא הפקודות תֶקֶן תפוקה ו תֶקֶן שגיאה יש לו נתפס ו
דיווח ל מה היא מִשׁתַמֵשׁ: "שגיאה תחילה", "מעורב", "ראשונים". מתי באמצעות "מעורב", מה היא
name.stderr תצורה פילה is התעלם. מתי באמצעות "שגיאה תחילה" or "בחוץ",
בנפרד דיווחים אולי להשתמש אחד of מה היא הבא שתיים נוסף אפשרויות "בלבד"
ו "בטעות".

פוּרמָט הודעות דואר שולחות את הפלט של הפקודה ניתן לשלוח בשלושה שונים
פורמטים: "טקסט" (ברירת המחדל), טקסט "מועשר" או "html".

סייזלימיט
כברירת מחדל, כל הפלט של ה- הפקודה נשלח בדואר דוחות. זֶה
ניתן להשתמש בפרמטר כדי להגביל את גודל הפלט הנכלל בדוח. הערה
שהגודל הכולל של הדואר שנשלח יהיה גדול יותר מכיוון שהמגבלה הזו לא משפיעה על
כותרות דואר. ניתן לציין את הגודל ביחידות של m, k, b, c (MB, KB, Bytes).
אם לא צוינה יחידה, ההנחה היא כי היא KB. מגבלה של אפס מעידה על כך
אין לקצץ את הפלט.

if דוח נשלח רק אם לא if מצב מצוין או אם צוין if
המצב נכון. תחביר התנאי מאפשר את האופרטורים הלוגיים הרגילים
("||", "&&", "!"), אופרטורים להשוואה ("==", "!=", "<", "<=", ">", ">=") ו
אופרטורים אריתמטיים בסיסיים ("+", "-"). מלבד מונים שהוגדרו על ידי ה
תצורה (ראה את פקודה תפוקה בסעיף להלן), המשתנים הבאים עשויים
לשמש:

$יציאה אם הפקודה הסתיימה כרגיל, זהו קוד היציאה שלה. אחרת, זה כן
שלילי ומציין את מספר האות שגרם לפקודה
terminate (לדוגמה -1 מציין אות מספר 1 שגרם לפקודה
לבטל, לסיים).

גודל $ גודל פלט (בבתים), זהה ל-"$outsize + $errsize"

גודל גדול של $
גודל (בבתים) של פלט סטנדרטי

$errsize
גודל (בבתים) של שגיאת תקן

$lines מספר פלט שורות

$מתאר
מספר קווי פלט סטנדרטיים

$errlines
מספר שורות שגיאה סטנדרטיות

זמן ריצה $
הפקודה זמן ריצה (בשניות)

$utime זמן המשתמש בשימוש על ידי הפקודה

$stime זמן המערכת בשימוש על ידי הפקודה

$tty 1 אם לְהַשְׁתִיק מופעל ממסוף (למשל באופן אינטראקטיבי), 0 אחרת.

MAIL נושאים

ה "lockmsg""timeoutmsg"ו"נושא" פרמטרים עשויים להכיל את האסימונים הבאים
אשר מורחבים כמתואר להלן:

%% הדמות

%h שם המארח

%
או "%- "

A חלקית שם מארח: A חיובי ספרה מצביע על אֵיך רב רכיבים of מה היא
לגמרי מוסמך המארח ל לִשְׁמוֹר; a שלילי ספרה מצביע על אֵיך רב
נגרר רכיבים of מה היא לגמרי מוסמך המארח ל לקצץ.

%i המופע ID

%n התצורה שם

%N התצורה שם ומופע ID

%r שם הדוח

%t הזמן שחלף.

%u שם המשתמש.

%U זיהוי המשתמש.

אם התו "%" נמצא ב-"נושא" פרמטר, ואז ה
"hostprefix"ו"תחילית משתמש"מתעלמים מפרמטרים.

פקודה תפוקה

לאחר הפקודה מסתיים, לְהַשְׁתִיק ישתמש בתוכן של name.stdout ו
name.stderr קבצים (אם הם קיימים) כדי להסתכל על הפלט המיוצר על ידי ה- הפקודה.

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

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

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

שורות המתחילות באות "#" נחשבות כהערות ומתעלמות מהן. על ידי
ברירת מחדל, נעשה שימוש בביטויים רגולריים סטנדרטיים, אלא אם השורה הראשונה היא "#pcre" שבה
נעשה שימוש בביטויים רגולריים תואמים ל-case Perl.

הסביבה וריאציות

בית אם -c אפשרות לא בשימוש, לְהַשְׁתִיק יחפש קבצי תצורה ב
$HOME/.shush.

SHUSH_SENDMAIL
אם מוגדר, זה אמור להצביע על שלח מייל(1) בינארי. משתנה זה עוקף
ה "שלח מייל" הגדרת התצורה ויש להשתמש בה בזהירות.

ספריית TMPDIR שבה נוצרים קבצים זמניים.

דוגמא

התצורה הבאה מריצה "shush -c /etc/shush -u" מדי יום בשעה 9:00, מעדכנת את המשתמש
(שורש) crontab:

command=shush -c /etc/shush -u
לוח זמנים=0 9 * * *
lock=notify=root root-logs, abort
פסק זמן=5m,loop,notify=root root-logs,15m
stderr=ראשון
פורמט=טקסט
Subject=Crontab עדכון יומי
[יומנים]
to=root-logs
[קוראים]
if=$exit != 0 || $outlines != 1 || $errsize > 0 || U
ל=שורש
פורמט=עשיר

התצורה המשויכת לפלט סטנדרטי היא:
אושוש: crontab מעודכן\.$
U^.+$

ולשגיאת תקן:
U^(.+)$

נעילה תוגדר בזמן הפעלת הפקודה, ודואר יישלח ל-"root" ו-"root-logs" אם
המנעול מוחזק על ידי תהליך אחר כאשר לְהַשְׁתִיק מתחיל, ובמקרה זה לְהַשְׁתִיק יבטל. א
דואר יישלח גם ל-"root" ו-"root-logs" אם "shush -c /etc/shush -u" פועל לעוד
מ-5 דקות, ולכל 15 דקות לאחר 5 הדקות הראשונות.

בסיום, הפלט יישלח תמיד ל-"root-logs". בנוסף, הפלט
יישלח ל-"root" אם התנאי "$exit != 0 || $outlines != 1 || $errsize > 0 ||
U" נכון. כדי שתנאי זה יהיה נכון, אחד מהדברים הבאים חייב להיות נכון: היציאה
הקוד אינו אפס, הפלט הסטנדרטי של הפקודה לא היה שורה אחת, היה פלט מופעל
שגיאת תקן או לבסוף, המונה "U" אינו אפס. שהמונה "U" יהיה לא
אפס, חייב להיות פלט בפלט סטנדרטי מלבד השורה "shush: crontab
מעודכן." לבסוף, כל שורת פלט שהופקה בשגיאה הסטנדרטית תוצג
מודגש במיילים שנשלחו ל-"root".

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