git-send-email - מקוון בענן

תָכְנִית:

שֵׁם

git-send-email - שלח אוסף של תיקונים כמיילים

תַקצִיר

סילון שלח אימייל [אפשרויות] ...
סילון שלח אימייל --dump-כינויים

תיאור

לוקח את התיקונים שניתנו בשורת הפקודה ושולח אותם במייל. ניתן לציין תיקונים
כקבצים, ספריות (שישלחו את כל הקבצים בספריה), או ישירות כ-a
רשימת גרסאות. במקרה האחרון, כל פורמט שמתקבל על ידי git-format-patch(1) ניתן לעבור
כדי git send-email.

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

ישנם שני פורמטים מקובלים עבור קבצי תיקון:

1. קבצים בפורמט mbox

זה מה git-format-patch(1) מייצר. רוב הכותרות ועיצובי MIME הם
התעלם.

2. הפורמט המקורי בו השתמש Greg Kroah-Hartman's send_lots_of_email.pl תסריט

פורמט זה מצפה שהשורה הראשונה של הקובץ תכיל את הערך "Cc:" ואת ה-
"נושא:" של ההודעה בתור השורה השנייה.

אפשרויות

מלחין
--להעיר
סקור וערוך כל תיקון שאתה עומד לשלוח. ברירת המחדל היא הערך של
sendemail.annotate. עיין בסעיף תצורה עבור sendemail.multiEdit.

--bcc= ,...
ציין ערך "עותק מוסתר:" עבור כל דוא"ל. ברירת המחדל היא הערך של sendemail.bcc.

ניתן לציין אפשרות זו מספר פעמים.

--cc= ,...
ציין ערך "עותק:" מתחיל עבור כל דוא"ל. ברירת המחדל היא הערך של sendemail.cc.

ניתן לציין אפשרות זו מספר פעמים.

--לְהַלחִין
הפעל עורך טקסט (ראה GIT_EDITOR ב git-var(1)) כדי לערוך הודעת היכרות
לסדרת הפאצ'ים.

מתי --לְהַלחִין בשימוש, git send-email ישתמש ב-From, Subject ו-In-Reply-To
כותרות שצוינו בהודעה. אם גוף ההודעה (מה שאתה מקליד אחרי ה
כותרות ושורה ריקה) מכיל רק שורות ריקות (או Git: קידומת), הסיכום
לא יישלחו, אך ייעשה שימוש בכותרות מאת, נושא ו-in-reply-to אלא אם כן
הוסר.

יתבקשו להזין כותרות חסרות ב-From או In-reply-To.

עיין בסעיף תצורה עבור sendemail.multiEdit.

--מ=
ציין את השולח של המיילים. אם לא מצוין בשורת הפקודה, הערך של
מה היא sendmail.from נעשה שימוש באפשרות תצורה. אם גם לא אפשרות שורת הפקודה
ולא sendmail.from מוגדרים, אז המשתמש יתבקש להזין את הערך. ברירת המחדל
עבור ההודעה תהיה הערך של GIT_AUTHOR_IDENT, או GIT_COMMITTER_IDENT אם זה
לא מוגדר, כפי שהוחזר על ידי "git var -l".

--in-reply-to=
הפוך את המייל הראשון (או את כל המיילים עם --no-thread) להופיע כתשובה לנתון
Message-Id, אשר נמנע מפריצת שרשורים כדי לספק סדרת תיקונים חדשה. השני
והודעות דוא"ל עוקבות יישלחו כתשובות בהתאם ל--[no]-chain-reply-to
הגדרה.

כך למשל כאשר -thread ו--no-chain-reply-to מצוינים, השני ו-
התיקונים הבאים יהיו תשובות לתיקון הראשון כמו באיור למטה
כאשר [PATCH v2 0/3] הוא תשובה ל-[PATCH 0/2]:

[תיקון 0/2] הנה מה שעשיתי...
[תיקון 1/2] ניקוי ובדיקות
[תיקון 2/2] יישום
[PATCH v2 0/3] הנה רול מחדש
[PATCH v2 1/3] נקה
[PATCH v2 2/3] בדיקות חדשות
[PATCH v2 3/3] יישום

הכרחי רק אם מוגדר גם --compose. אם --compose לא מוגדר, זה יהיה
מתבקש.

--נושא=
ציין את הנושא הראשוני של שרשור האימייל. הכרחי רק אם --compose הוא גם
מַעֲרֶכֶת. אם --compose לא מוגדר, זה יתבקש.

--to= ,...
ציין את הנמען הראשי של הודעות האימייל שנוצרו. באופן כללי, זה יהיה
מתחזק במעלה הזרם של הפרויקט המעורב. ברירת המחדל היא הערך של sendmail.to
ערך תצורה; אם זה לא צוין, ו--to-cmd לא צוין, זה יהיה
להתבקש.

ניתן לציין אפשרות זו מספר פעמים.

--8bit-encoding=
כאשר נתקלים בהודעה שאינה ASCII או נושא שאינו מצהיר על הקידוד שלה,
הוסף כותרות/ציטוטים כדי לציין שהוא מקודד . ברירת המחדל היא הערך של
מה היא sendemail.assume8bitEncoding; אם זה לא מצוין, זה יתבקש אם
נתקלים בקבצים שאינם ASCII.

שימו לב שלא נעשה כל נסיון לאמת את הקידוד.

--compose-encoding=
ציין את הקידוד של כתיבת ההודעה. ברירת המחדל היא הערך של
sendemail.composeencoding; אם זה לא מצוין, ההנחה היא UTF-8.

--transfer-encoding=(7bit|8bit|quoted-printable|base64)
ציין את קידוד ההעברה שישמש לשליחת ההודעה באמצעות SMTP. 7bit ייכשל
עם נתקל בהודעה שאינה ASCII. ציטוט-ניתן להדפסה יכול להיות שימושי כאשר
המאגר מכיל קבצים המכילים החזרות עגלה, אך יוצר את התיקון הגולמי למייל
קובץ (כפי שנשמר מ-MUA) הרבה יותר קשה לבדיקה ידנית. base64 הוא אפילו יותר טיפש
הוכחה, אבל גם אפילו יותר אטומה. ברירת המחדל היא הערך של
sendemail.transferEncoding ערך תצורה; אם זה לא מצוין, git ישתמש
8bit ולא להוסיף כותרת Content-Transfer-Encoding.

--xmailer, --no-xmailer
הוסף (או מנע הוספה) של הכותרת "X-Mailer:". כברירת מחדל, הכותרת מתווספת, אבל
ניתן לכבות אותו על ידי הגדרת משתנה התצורה sendemail.xmailer ל-false.

שליחה
---envelope-sender=
ציין את שולח המעטפה ששימש לשליחת המיילים. זה שימושי אם ברירת המחדל שלך
כתובת אינה הכתובת הרשומה לרשימה. על מנת להשתמש ב מ
כתובת, הגדר את הערך ל"אוטומטי". אם אתה משתמש בבינארי sendmail, אתה חייב
הרשאות מתאימות לפרמטר -f. ברירת המחדל היא הערך של
sendemail.envelopeSender משתנה תצורה; אם זה לא מצוין, בחירה ב-
שולח המעטפה נשאר ל-MTA שלך.

--smtp-encryption=
ציין גם את ההצפנה שבה יש להשתמש SSL or Tls. כל ערך אחר חוזר לרגיל
SMTP. ברירת המחדל היא הערך של sendemail.smtpEncryption.

--smtp-domain=
מציין את שם הדומיין המלא (FQDN) המשמש בפקודה HELO/EHLO ל-
שרת SMTP. שרתים מסוימים דורשים שה-FQDN יתאים לכתובת ה-IP שלך. אם לא מוגדר, git
שלח-דוא"ל מנסה לקבוע את ה-FQDN שלך באופן אוטומטי. ברירת המחדל היא הערך של
דומיין sendemail.smtp.

--smtp-auth=
רשימה מופרדת ברווחים לבנים של מנגנוני SMTP-AUTH מותרים. הגדרה זו מאלצת שימוש
רק את המנגנונים הרשומים. דוגמא:

$ git send-email --smtp-auth="כניסה רגילה GSSAPI" ...

אם לפחות אחד מהמנגנונים שצוינו תואם את אלה המפורסמים על ידי ה-SMTP
שרת ואם הוא נתמך על ידי ספריית SASL בשימוש, המנגנון משמש עבור
אימות. אם לא אחת sendemail.smtpAuth ולא --smtp-auth מצוין, הכל
ניתן להשתמש במנגנונים הנתמכים על ידי ספריית SASL.

--smtp-pass[= ]
סיסמה עבור SMTP-AUTH. הארגומנט הוא אופציונלי: אם לא צוין ארגומנט, אז
המחרוזת הריקה משמשת כסיסמה. ברירת המחדל היא הערך של sendemail.smtpPass,
אולם --smtp-pass תמיד עוקף את הערך הזה.

יתר על כן, אין צורך לציין סיסמאות בקובצי התצורה או בפקודה
קַו. אם צוין שם משתמש (עם --smtp-user או sendemail.smtpUser), אבל
לא צוינה סיסמה (עם --smtp-pass or sendemail.smtpPass), ואז א
הסיסמה מתקבלת באמצעות git-credential.

--smtp-server=
אם מוגדר, מציין את שרת ה-SMTP היוצא לשימוש (למשל smtp.example.com או IP גולמי
כתובת). לחלופין, הוא יכול לציין שם נתיב מלא של תוכנית דמוית sendmail
במקום זאת; התוכנית חייבת לתמוך באפשרות -i. ניתן לציין ערך ברירת מחדל על ידי ה
sendemail.smtpServer אפשרות תצורה; ברירת המחדל המובנית היא /usr/sbin/sendmail
or /usr/lib/sendmail אם תוכנית כזו זמינה, או מארח מקומי אחרת.

--smtp-server-port=
מציין יציאה שונה מיציאת ברירת המחדל (שרתי SMTP מאזינים בדרך כלל
יציאת smtp 25, אך עשויה גם להאזין ליציאת הגשה 587, או ליציאת ה-SSL smtp הנפוצה
465); גם שמות יציאות סמליים (למשל "הגשה" במקום 587) מתקבלים. ה
ניתן להגדיר יציאה גם עם ה- sendemail.smtpServerPort משתנה תצורה.

--smtp-server-option=
אם מוגדר, מציין את אפשרות שרת ה-SMTP היוצא לשימוש. ערך ברירת המחדל יכול להיות
שצוין על ידי sendemail.smtpServerOption אפשרות תצורה.

יש לחזור על האפשרות --smtp-server-option עבור כל אפשרות שאליה תרצה לעבור
השרת. כמו כן, יש להשתמש בשורות שונות בקבצי התצורה עבור כל אחת מהן
אוֹפְּצִיָה.

--smtp-ssl
כינוי מדור קודם עבור ---smtp-הצפנה SSL.

--smtp-ssl-cert-path
נתיב למאגר של אישורי CA מהימנים עבור אימות אישור SMTP SSL/TLS
(או ספרייה שעובדה על ידי c_rehash, או קובץ בודד המכיל
אישור אחד או יותר בפורמט PEM המשולבים יחדיו: ראה לאמת(1) -CAfile ו
-CApath למידע נוסף על אלה). הגדר אותו למחרוזת ריקה כדי להשבית
אימות תעודה. ברירת המחדל של הערך של sendemail.smtpsslcertpath
משתנה תצורה, אם מוגדר, או ברירת המחדל של ספריית ה-SSL הגיבוי
אחרת (שאמורה להיות הבחירה הטובה ביותר ברוב הפלטפורמות).

--smtp-user=
שם משתמש עבור SMTP-AUTH. ברירת המחדל היא הערך של sendemail.smtpUser; אם שם משתמש הוא
לא צוין (עם --smtp-user or sendemail.smtpUser), אז האימות אינו
ניסיתי.

--smtp-debug=0|1
אפשר (1) או השבת (0) פלט ניפוי באגים. אם מופעל, פקודות ותשובות SMTP יהיו
מודפס. שימושי לאיתור באגים של חיבור TLS ובעיות אימות.

אוטומציה
--to-cmd=
ציין פקודה לביצוע פעם אחת לכל קובץ תיקון שאמורה ליצור קובץ תיקון
ערכי "אל:" ספציפיים. הפלט של פקודה זו חייב להיות כתובת דוא"ל בודדת בכל שורה.
ברירת המחדל היא הערך של sendemail.tocmd ערך תצורה.

--cc-cmd=
ציין פקודה לביצוע פעם אחת לכל קובץ תיקון שאמורה ליצור קובץ תיקון
ערכי "עתק:" ספציפיים. הפלט של פקודה זו חייב להיות כתובת דוא"ל בודדת בכל שורה.
ברירת המחדל היא הערך של sendemail.ccCmd ערך תצורה.

--[no-]שרשרת-תשובת-ל
אם זה מוגדר, כל אימייל יישלח כמענה לאימייל הקודם שנשלח. אם
מושבת עם "--no-chain-reply-to", כל הודעות האימייל לאחר הראשון יישלחו כ
תשובות למייל הראשון שנשלח. כאשר משתמשים בזה, מומלץ שהראשון
הקובץ שניתן יהיה סקירה כללית של כל סדרת התיקון. מושבת כברירת מחדל, אבל ה
sendemail.chainReplyTo ניתן להשתמש במשתנה תצורה כדי להפעיל אותו.

--זהות=
זהות תצורה. כאשר ניתן, גורם לערכים ב- שלח אימייל.
תת-סעיף לקבל עדיפות על פני ערכים ב- שלח אימייל סָעִיף. ברירת המחדל
זהות היא הערך של sendemail.identity.

--[no-]חתום-off-by-cc
אם זה מוגדר, הוסף הודעות דוא"ל שנמצאו בשורות חתום על ידי: או עותק: לרשימת העותקים.
ברירת המחדל היא הערך של sendemail.signedoffbycc ערך תצורה; אם זה כן
לא מוגדר, ברירת המחדל היא --signed-off-by-cc.

--[no-]כריכת cc
אם זה מוגדר, הודעות אימייל נמצאות בכותרות Cc: בתיקון הראשון של הסדרה
(בדרך כלל המכתב המקדים) מתווספים לרשימת העותקים עבור כל סט דואר אלקטרוני. ברירת המחדל היא
את הערך של sendemail.cccover ערך תצורה; אם זה לא מצוין, ברירת המחדל היא
--no-cc-cover.

--[לא-]לכסות
אם זה מוגדר, הודעות דוא"ל נמצאות בכותרות אל: בתיקון הראשון של הסדרה
(בדרך כלל המכתב המקדים) מתווספים לרשימת אל עבור כל סט דואר אלקטרוני. ברירת המחדל היא
את הערך של sendemail.tocover ערך תצורה; אם זה לא מצוין, ברירת המחדל היא
--לא לכסות.

--suppress-cc=
ציין קטגוריה נוספת של נמענים כדי לדכא את ה-cc האוטומטי של:

· מחבר ימנע הכללת מחבר התיקון

· עצמי ימנע מלכלול את השולח

· cc ימנע הכללה של כל מי שהוזכר בשורות Cc בכותרת התיקון למעט
עבור עצמי (שימוש עצמי בשביל זה).

· bodycc ימנע הכללה של כל מי שהוזכר בשורות Cc בגוף התיקון (commit
הודעה) למעט עצמי (שימוש עצמי בשביל זה).

· יבבה ימנע הכללה של כל מי שהוזכר בשורות 'חתימה על ידי' למעט עצמי
(להשתמש עצמי בשביל זה).

· cccmd ימנע מהפעלת --cc-cmd.

· גוּף שווה יבבה + bodycc

· את כל ידכא את כל ערכי העתק האוטומטי.

ברירת המחדל היא הערך של sendemail.suppresscc ערך תצורה; אם זה כן
לא מוגדר, ברירת מחדל ל עצמי אם צוין --suppress-from, כמו גם גוּף if
--no-signed-off-cc צוין.

--[לא-]להדחיק-מ
אם זה מוגדר, אל תוסיף את כתובת מאת: לרשימה cc:. ברירת המחדל היא הערך של
sendemail.suppressFrom ערך תצורה; אם זה לא מצוין, ברירת המחדל היא
--לא-להדחיק-מ.

--[לא-]שרשור
אם זה מוגדר, הכותרות In-Reply-To ו-References יתווספו לכל אימייל
נשלח. האם כל מייל מתייחס למייל הקודם (שרשור עמוק לכל סילון
פורמט-תיקון ניסוח) או למייל הראשון (שרשור רדוד) כפוף
"--[לא-]תשובת-שרשרת".

אם מושבת עם "--no-thread", כותרות אלו לא יתווספו (אלא אם צוין עם
--בתשובה ל). ברירת המחדל היא הערך של sendmail.thread ערך תצורה; אם
שאינו מוגדר, ברירת המחדל היא --thread.

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

ניהול
--אשר=
אשר רגע לפני השליחה:

· תמיד תמיד יאשר לפני השליחה

· לעולם לא לעולם לא יאשר לפני השליחה

· cc יאשר לפני השליחה כאשר שליחה-אימייל נוספה אוטומטית כתובות
מהתיקון לרשימת העתקים

· לְהַלחִין יאשר לפני שליחת ההודעה הראשונה בעת שימוש ב--compose.

· המכונית שווה cc + לְהַלחִין

ברירת המחדל היא הערך של sendemail.confirm ערך תצורה; אם זה לא מוגדר,
ברירת מחדל ל המכונית אלא אם כן צוינה כל אחת מאפשרויות ההדחקה, ובמקרה זה
ברירת מחדל ל לְהַלחִין.

--ריצה יבשה
עשה הכל חוץ מלשלוח את המיילים.

--[no-]פורמט-תיקון
כאשר ארגומנט עשוי להיות מובן כהפניה או כשם קובץ, בחר לעשות זאת
להבין את זה כארגומנט תיקון פורמט (--פורמט-תיקון) או כשם קובץ
(--לא-פורמט-תיקון). כברירת מחדל, כאשר מתרחש התנגשות כזו, git send-email יעשה זאת
לְהִכָּשֵׁל.

--שֶׁקֶט
הפוך git-send-email פחות מילולי. שורה אחת לכל דוא"ל צריכה להיות כל הפלט.

--[לא-]לאמת
בצע בדיקות שפיות על מדבקות. נכון לעכשיו, אימות פירושו הדבר הבא:

· התריעו מפני תיקונים המכילים שורות ארוכות מ-998 תווים; זה נובע מ-SMTP
גבולות כפי שמתואר על ידי http://www.ietf.org/rfc/rfc2821.txt.

ברירת המחדל היא הערך של sendemail.validate; אם זה לא מוגדר, ברירת המחדל היא --לְאַמֵת.

--כּוֹחַ
שלח מיילים גם אם בדיקות בטיחות ימנעו זאת.

מֵידָע
--dump-כינויים
במקום הפעולה הרגילה, זרוק את שמות הכינויים הקצרניים מהמוגדר
קבצי כינוי, אחד בכל שורה בסדר אלפביתי. שימו לב, זה כולל רק את הכינוי
שם ולא כתובות האימייל המורחבות שלו. לִרְאוֹת sendemail.aliasesfile במשך יותר
מידע על כינויים.

תְצוּרָה

sendemail.aliasesFile
כדי להימנע מהקלדת כתובות דוא"ל ארוכות, הצבע על קובץ כינוי דוא"ל אחד או יותר.
אתה חייב גם לספק sendemail.aliasFileType.

sendemail.aliasFileType
פורמט הקובץ/ים המצוינים ב- sendemail.aliasesFile. חייב להיות אחד מהם כְּלַבלָב, mailrc,
אורן, בּוּקִיצָה, או גנוס, או שלח מייל.

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

שלח מייל

· כינויים וכתובות מצוטטות אינם נתמכים: שורות המכילות "
מתעלמים מהסמל.

· הפנייה מחדש לקובץ (/path/name) או pipe (|פקודה) אינה נתמכת.

· הכללת קובץ (:include: /path/name) אינה נתמכת.

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

sendemail.multiEdit
אם נכון (ברירת מחדל), מופע עורך יחיד יופק כדי לערוך קבצים שאתה צריך
ערוך (מתקן מתי --להעיר משמש, והסיכום מתי --לְהַלחִין משמש). אם
false, הקבצים יערכו בזה אחר זה, ויולידו עורך חדש בכל פעם.

sendemail.confirm
מגדיר את ברירת המחדל האם לאשר לפני השליחה. חייב להיות אחד מהם תמיד, לעולם לא,
cc, לְהַלחִין, או המכונית. לראות --לְאַשֵׁר בסעיף הקודם למשמעותם של אלה
ערכים.

דוגמא

השתמש gmail as מה היא SMTP שרת
להשתמש סילון שלח אימייל כדי לשלוח את התיקונים שלך דרך שרת ה-SMTP של GMail, ערוך
~ / .gitconfig כדי לציין את הגדרות החשבון שלך:

[שלח אימייל]
smtpEncryption = tls
smtpServer = smtp.gmail.com
smtpUser = [מוגן בדוא"ל]
smtpServerPort = 587

לאחר שההתחייבויות שלך מוכנות להישלח לרשימת התפוצה, הפעל את הפקודות הבאות:

$ git format-patch --אות כיסוי -M origin/master -o יוצא/
$ עריכה יוצא/0000-*
$ git send-email יוצא/*

הערה: מודולי ה-perl הבאים נדרשים Net::SMTP::SSL, MIME::Base64 ו-
Authen :: SASL

השתמש ב-git-send-email מקוון באמצעות שירותי onworks.net