fetchmail - מקוון בענן

תָכְנִית:

שֵׁם

fetchmail - אחזר דואר משרת בעל יכולת POP, IMAP, ETRN או ODMR

תַקצִיר

fetchmail [אוֹפְּצִיָה...] [שרת דואר...]
fetchmailconf

תיאור

fetchmail הוא כלי עזר לאחזור והעברת דואר; זה מביא דואר מרחוק
שרתי דואר ומעביר אותו למערכת המסירה המקומית (הלקוח) שלך. אתה יכול
ואז לטפל בדואר שאוחזר באמצעות סוכני משתמש דואר רגילים כגון כְּלַבלָב(1), בּוּקִיצָה(1) או
Mail(1). ה fetchmail ניתן להפעיל את כלי השירות במצב דמון כדי לסקור שוב ושוב אחד או יותר
מערכות במרווח מסוים.

השמיים fetchmail התוכנית יכולה לאסוף דואר משרתים התומכים בכל אחד מהדואר הנפוצים-
פרוטוקולי אחזור: POP2 (מורשת, להסרה מהגרסה העתידית), POP3, IMAP2bis,
IMAP4, ו-IMAP4rev1. זה יכול גם להשתמש בתוסף ESMTP ETRN ו-ODMR. (ה-RFCs
המתארים את כל הפרוטוקולים הללו מופיעים בסוף דף מדריך זה.)

בעוד fetchmail מיועד בעיקר לשימוש על גבי קישורי TCP/IP לפי דרישה (כגון SLIP
או חיבורי PPP), זה עשוי להיות שימושי גם כסוכן העברת הודעות עבור אתרים אשר
לסרב מטעמי אבטחה להתיר (ביוזמת השולח) עסקאות SMTP עם sendmail.

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

env LC_ALL=C fetchmail -V -v --nodetach --nosyslog

(שורת פקודה זו מדפיסה באנגלית כיצד fetchmail מבין את התצורה שלך.)

env LC_ALL=C fetchmail -vvv --nodetach --nosyslog

(שורת פקודה זו למעשה מריץ את fetchmail עם פלט באנגלית מילולי.)

ראה גם פריט #G3 בשאלות הנפוצות של fetchmail ⟨http://fetchmail.berlios.de/fetchmail-FAQ.html#G3⟩

אתה יכול להשמיט את החלק LC_ALL=C למעלה אם אתה רוצה פלט בשפה המקומית (אם
נתמך). עם זאת, אם אתה מפרסם לרשימות תפוצה, אנא השאר את זה
מתחזקים לא בהכרח מבינים את השפה שלך, אנא השתמש באנגלית.

מושגים
If fetchmail משמש עם שרת POP או IMAP (אך לא עם ETRN או ODMR), יש לו שניים
דרכי פעולה בסיסיות עבור כל חשבון משתמש שממנו הוא מאחזר דואר:
טיפה אחת- ו multidrop-מצב.

במצב ירידה בודדת,
fetchmail מניח שכל ההודעות בחשבון המשתמש (תיבת הדואר) מיועדות
עבור נמען יחיד. זהות הנמען תהיה ברירת המחדל של
משתמש מקומי מבצע כעת fetchmail, או שיהיה צורך לציין במפורש
בקובץ התצורה.

fetchmail משתמש במצב singledrop כאשר תצורת fetchmailrc מכילה לכל היותר
מפרט משתמש מקומי יחיד עבור חשבון שרת נתון.

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

שימו לב שלא פרוטוקולי POP או IMAP נועדו לשימוש באופן זה,
ומכאן שמידע המעטפה לרוב אינו זמין ישירות. ספק האינטרנט חייב
מאחסן את פרטי המעטפה בכותרת הודעה כלשהי ו. ספק האינטרנט חייב גם לאחסן
עותק אחד של ההודעה לכל נמען. אם אחד מהתנאים לא
מילא, תהליך זה אינו אמין, כי fetchmail אז צריך לפנות
מנחש את מקבלי המעטפה האמיתיים של הודעה. זה בדרך כלל נכשל עבור
הודעות רשימת תפוצה ודואר Bcc:d, או דואר למספר נמענים שלך
תחום.

fetchmail משתמש במצב multidrop כאשר יש יותר ממשתמש מקומי אחד ו/או תו כללי
שצוין עבור חשבון שרת מסוים בקובץ התצורה.

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

כאשר כל הודעה מאוחזרת, fetchmail בדרך כלל מספק אותו דרך SMTP ליציאה 25 ב-
מכונה שהיא פועלת עליה (localhost), ממש כאילו היא מועברת דרך רגילה
קישור TCP/IP. fetchmail מספק לשרת ה-SMTP נמען מעטפה שמקורו ב-
באופן שתואר קודם לכן. לאחר מכן, הדואר יימסר בהתאם ל-MTA שלך
כללים (סוכן העברת הדואר הוא בדרך כלל שלח מייל(8), אקסים(8), או פוסט(8)). קורא
ה-MDA (סוכן משלוח דואר) של המערכת שלך הוא חובתו של ה-MTA שלך. כל בקרת המסירה
מנגנונים (כגון .קָדִימָה קבצים) זמינים בדרך כלל דרך מערכת MTA ומקומי
לפיכך, סוכני משלוח יופעלו כרגיל.

אם תצורת ה-fetchmail שלך מגדירה MDA מקומי (ראה את האפשרות --mda), היא תשמש
ישירות במקום לדבר SMTP ליציאה 25.

אם התוכנית fetchmailconf זמין, הוא יסייע לך בהגדרה ועריכה של א
תצורת fetchmailrc. זה פועל תחת מערכת X windows ודורש כי
שפת Python וערכת הכלים Tk (עם כריכות Python) קיימות במערכת שלך. אם
אתה מגדיר תחילה fetchmail למצב של משתמש יחיד, מומלץ להשתמש
מצב מתחיל. מצב מומחה מספק שליטה מלאה בתצורת fetchmail, כולל
תכונות ריבוי טיפות. בכל מקרה, כפתור 'בדיקה אוטומטית' יגיד לך הכי הרבה
פרוטוקול בעל יכולת ששרת דואר נתון תומך בו, ומזהיר אותך מפני בעיות אפשריות עם זה
שרת.

כללי פעולה

ההתנהגות של fetchmail נשלט על ידי אפשרויות שורת הפקודה וקובץ בקרה הפעלה,
~/.fetchmailrc, שאת התחביר שלו אנו מתארים בסעיף מאוחר יותר (קובץ זה הוא מה ש-
fetchmailconf עריכות בתוכנית). אפשרויות שורת הפקודה עוקפות ~/.fetchmailrc הצהרות.

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

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

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

כמעט לכל האפשרויות יש מילת מפתח מתאימה שבה ניתן להשתמש כדי להכריז עליהן ב
.fetchmailrc קובץ.

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

כללי אפשרויות
-V | --גִרְסָה
מציג את פרטי הגרסה עבור העותק שלך של fetchmail. אין שליפת דואר
מְבוּצָע. במקום זאת, עבור כל שרת שצוין, כל מידע האפשרויות ש
יחושב אם fetchmail היו מתחברים לשרת זה מוצג. כל
רכיבים שאינם ניתנים להדפסה בסיסמאות או בשמות מחרוזות אחרים מוצגים כאחורי C-דמוי
רצפי בריחה. אפשרות זו שימושית לאימות שהאפשרויות שלך מוגדרות
כמו שאתה רוצה אותם.

-c | --חשבון
החזר קוד סטטוס כדי לציין אם יש דואר ממתין, בלי למעשה
אחזור או מחיקת דואר (ראה קודי יציאה למטה). אפשרות זו מכבה את daemon
מצב (בו זה יהיה חסר תועלת). זה לא משחק טוב עם שאילתות לכמה
אתרים, ואינו עובד עם ETRN או ODMR. זה יחזיר חיובי שגוי אם אתה
השאר דואר שנקרא אך לא נמחק בתיבת הדואר של השרת שלך ופרוטוקול האחזור שלך לא יכול
ספר הודעות שמורות מהודעות חדשות. זה אומר שזה יעבוד עם IMAP, לא יעבוד עם
POP2, ועלול להתקלף מדי פעם תחת POP3.

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

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

--nosoftbounce
(מאז v6.3.10, מילת מפתח: הגדר ללא softbounce, מאז v6.3.10)
מצב הקפצה קשה. כל שגיאות המסירה הקבועות גורמות למחיקת הודעות
השרת במעלה הזרם, ראה "ללא softbounce" להלן.

--קפיצה רכה
(מאז v6.3.10, מילת מפתח: הגדר softbounce, מאז v6.3.10)
מצב הקפצה רכה. כל שגיאות המסירה הקבועות גורמות להשאיר הודעות ב-
שרת במעלה הזרם אם הפרוטוקול תומך בכך. זֶה אוֹפְּצִיָה is on by ברירת מחדל ל
להתאים היסטורי fetchmail תיעוד, וישתנה למצב הקפצה קשה ב
המהדורה הבאה של fetchmail.

רשות אפשרויות
-a | --את כל | (מאז v6.3.3) --להביא
(מילת מפתח: fetchall, מאז v3.0)
אחזר גם הודעות ישנות (נראות) וגם חדשות משרת הדואר. ברירת המחדל היא ל
אחזר רק הודעות שהשרת לא סימן שנראו. תחת POP3, אפשרות זו גם
מאלץ את השימוש ב-RETR ולא ב-TOP. שים לב ששליפה של POP2 מתנהגת כאילו
--הכל תמיד פועל (ראה מצבי כשל אחזור למטה) והאפשרות הזו לא
לעבוד עם ETRN או ODMR. בעוד שורת הפקודה -a ו--all ו-fetchall rcfile
אפשרויות נתמכו במשך זמן רב, אפשרות שורת הפקודה --fetchall הייתה
נוסף בגרסה 6.3.3.

-k | --לִשְׁמוֹר
(מילת מפתח: לשמור)
שמור הודעות שאוחזרו בשרת הדואר המרוחק. בדרך כלל, הודעות נמחקות
מהתיקיה בשרת הדואר לאחר אחזורם. ציון ה
לשמור האפשרות גורמת להודעות שאוחזרו להישאר בתיקייה שלך בשרת הדואר.
אפשרות זו אינה פועלת עם ETRN או ODMR. אם משתמשים ב-POP3, מומלץ
כדי לציין גם את האפשרות --uidl או מילת המפתח uidl.

-K | --nokeep
(מילת מפתח: nokeep)
מחק הודעות שאוחזרו משרת הדואר המרוחק. אפשרות זו מאלצת אחזור
דואר שיימחק. זה עשוי להיות שימושי אם ציינת ברירת מחדל של לשמור in
שֶׁלְךָ .fetchmailrc. אפשרות זו נאלצת עם ETRN ו-ODMR.

-F | --סומק
(מילת מפתח: שטיפה)
POP3/IMAP בלבד. זוהי אפשרות מסוכנת ועלולה לגרום לאובדן דואר בעת שימוש
באופן לא תקין. הוא מוחק הודעות ישנות (שנראו) משרת הדואר לפני האחזור
הודעות חדשות. אַזהָרָה: זה עלול לגרום לאובדן דואר אם תבדוק את הדואר שלך עם אחרים
לקוחות מאשר fetchmail, ולגרום ל-fetchmail למחוק הודעה שמעולם לא הייתה
הביאו לפני. זה יכול גם לגרום לאובדן דואר אם שרת הדואר מסמן את ההודעה
נראה לאחר שליפה (שרתי IMAP2). אתה כנראה לא צריך להשתמש באפשרות זו ב
קובץ התצורה שלך. אם אתה משתמש בו עם POP3, עליך להשתמש באפשרות 'uidl'.
מה שאתה כנראה רוצה הוא הגדרת ברירת המחדל: אם אתה לא מציין '-k', אז
fetchmail ימחק אוטומטית הודעות לאחר מסירה מוצלחת.

--limitflush
POP3/IMAP בלבד, מאז גרסה 6.3.0. מחק הודעות גדולות מדי משרת הדואר
לפני אחזור הודעות חדשות. יש לציין את מגבלת הגודל בנפרד עם
אפשרות --limit. אפשרות זו אינה פועלת עם ETRN או ODMR.

פרוטוקול ו שאלה אפשרויות
-p | --פרוטו | --נוהל
(מילת מפתח: פרוטו[קול])
ציין את הפרוטוקול לשימוש בעת תקשורת עם שרת הדואר המרוחק. אם לא
צוין פרוטוקול, ברירת המחדל היא AUTO. פרוטו עשוי להיות אחד מהבאים:

AUTO מנסה IMAP, POP3 ו-POP2 (מדלג על כל אחד מאלה שעבורם לא הייתה תמיכה
חובר ב).

POP2 Post Office Protocol 2 (מורשת, יוסר מהגרסה העתידית)

POP3 Post Office Protocol 3

APOP השתמש ב-POP3 עם אימות מיושן באתגר MD5. נחשב שלא
עמיד בפני התקפות אדם-באמצע.

RPOP השתמש ב-POP3 עם אימות RPOP.

KPOP השתמש ב-POP3 עם אימות Kerberos V4 ביציאה 1109.

SDPS השתמש ב-POP3 עם הרחבות SDPS של Demon Internet.

IMAP IMAP2bis, IMAP4 או IMAP4rev1 (fetchmail מזהה אותם באופן אוטומטי
יכולות).

ETRN השתמש באפשרות ESMTP ETRN.

ODMR השתמש בפרופיל ESMTP של ממסר דואר לפי דרישה.

כל החלופות הללו פועלות בעצם באותו אופן (תקשורת עם שרת סטנדרטי
דמונים כדי להביא דואר שכבר נמסר לתיבת דואר בשרת) מלבד ETRN ו-ODMR.
מצב ETRN מאפשר לך לשאול שרת ESMTP תואם (כגון BSD sendmail בשחרור
8.8.0 ומעלה) כדי לפתוח מיד חיבור שולח-SMTP למחשב הלקוח שלך ו
התחל להעביר את כל הפריטים הממוענים למחשב הלקוח שלך בתור של השרת של
דואר שלא נמסר. מצב ODMR דורש שרת בעל יכולת ODMR ופועל באופן דומה לזה
ETRN, פרט לכך שהוא אינו מחייב את מחשב הלקוח שיהיה לו DNS סטטי.

-U | --uidl
(מילת מפתח: uidl)
כפוי שימוש ב-UIDL (יעיל רק עם POP3). לאלץ מעקב בצד הלקוח של 'חדשות'
של הודעות (UIDL מייצג "רישום מזהה ייחודי" ומתואר ב-RFC1939). להשתמש
עם 'שמור' כדי להשתמש בתיבת דואר כדיחה חדשותית לתינוק עבור קבוצת משתמשים. העובדה
שדילוג על הודעות שנראו נרשם, אלא אם כן מתבצעת רישום שגיאה
syslog בזמן הפעלה במצב daemon. שים לב ש-fetchmail עשוי להפעיל באופן אוטומטי
אפשרות זו בהתאם ליכולות השרת במעלה הזרם. שימו לב גם לאפשרות זו
ניתן להסיר ולהפעיל בכפייה בגרסת fetchmail עתידית. ראה גם:
--idfile.

--לְהִתְבַּטֵל (מאז 6.3.3)
(מילת מפתח: סרק, מאז לפני 6.0.0)
אפשר שימוש ב-IDLE (יעיל רק עם IMAP). שימו לב שזה עובד עם אחד בלבד
תיקייה בזמן נתון. בעוד שמילת המפתח rcfile בטלה נתמכה עבור a
זמן רב, אפשרות שורת הפקודה --idle נוספה בגרסה 6.3.3. שימוש בטלה
אומר ש-fetchmail אומר לשרת ה-IMAP לשלוח הודעה על הודעות חדשות, אז הם
ניתן לאחזר מוקדם יותר ממה שניתן עם סקרים רגילים.

-P | --שֵׁרוּת
(מילת מפתח: שירות) מאז גרסה 6.3.0.
אפשרות השירות מאפשרת לך לציין שם שירות להתחבר אליו. אתה יכול
ציין כאן מספר יציאה עשרוני, אם מסד הנתונים של השירותים שלך חסר את הדרוש
הקצאות שירות-נמל. עיין בפריט השאלות הנפוצות R12 ובתיעוד --ssl עבור
פרטים. זה מחליף את האפשרות הישנה יותר --port.

--נמל
(מילת מפתח: יציאה)
גרסה מיושנת של --service שאינה לוקחת שמות שירותים. הערה: אפשרות זו
עשוי להיות מוסר מגרסה עתידית.

--קֶרֶן
(מילת מפתח: מנהל)
האפשרות הראשית מאפשרת לך לציין מנהל שירות עבור הדדי
אימות. זה חל על POP3 או IMAP עם אימות Kerberos 4
רק. זה לא חל על Kerberos 5 או GSSAPI. ניתן להסיר אפשרות זו ב-a
גרסת fetchmail עתידית.

-t | --פסק זמן
(מילת מפתח: פסק זמן)
אפשרות הזמן הקצוב מאפשרת לך להגדיר פסק זמן של אי תגובה של השרת בשניות. אם
שרת הדואר אינו שולח הודעת ברכה או מגיב לפקודות עבור הנתון
מספר שניות, fetchmail יבטל את החיבור אליו. בלי כזה
פסק זמן fetchmail עלול להיתקע עד פסק הזמן של חיבור ה-TCP, מנסה לאחזר
דואר מארח למטה, שעשוי להיות ארוך מאוד. זה יהיה מעצבן במיוחד
עבור fetchmail פועל ברקע. קיים פסק זמן ברירת מחדל אשר
fetchmail -V ידווח. אם חיבור נתון מקבל יותר מדי זמן קצוב
succession, fetchmail יחשב את זה כדחוס ויפסיק לנסות שוב. המשתמש המתקשר
יקבל הודעה באימייל אם זה יקרה.

החל מ-fetchmail 6.3.10, לקוח ה-SMTP משתמש במינימום המומלץ
פסק זמן מ-RFC-5321 בזמן ההמתנה לשרת ה-SMTP/LMTP אליו הוא מדבר.
אתה יכול להגדיל את פסקי הזמן אפילו יותר, אבל אתה לא יכול לקצר אותם. זה כדי להימנע
מצב כואב שבו fetchmail הוגדר עם פסק זמן קצר (א
דקה או פחות), שולחת הודעה ארוכה (MBytes רבים) ל-MTA המקומי, אשר לאחר מכן
לוקח יותר מפסק הזמן להגיב "בסדר", מה שבסופו של דבר יהיה; זה יהיה
פירושו שהדואר מועבר כראוי, אך fetchmail לא יכול להבחין בכך וכך יעשה זאת
לשחזר את ההודעה הגדולה הזו שוב ושוב.

--חיבור
(מילת מפתח: תוסף)
אפשרות הפלאגין מאפשרת לך להשתמש בתוכנה חיצונית להקמת ה-TCP
חיבור. זה שימושי אם אתה רוצה להשתמש ב-ssh, או צריך משהו מיוחד
הגדרת חומת אש. התוכנית תיבדק ב-$PATH ויכולה להיות
העביר את שם המארח והיציאה כארגומנטים באמצעות "%h" ו-"%p" בהתאמה (הערה
שהלוגיקת האינטרפולציה היא פרימיטיבית למדי, ויש להגביל את האסימונים הללו
לפי רווח לבן או תחילת מחרוזת או סוף מחרוזת). Fetchmail יכתוב אל
הסטדין של הפלאגין וקראו מהסטדאוט של התוסף.

--נתק
(מילת מפתח: plugout)
זהה לאפשרות הפלאגין שלמעלה, אך זו משמשת עבור ה-SMTP
קשרים.

-r | --תיקייה
(מילת מפתח: תיקיות[ות])
גורם לתיקיית דואר שצוינה שאינה ברירת מחדל בשרת הדואר (או מופרדת בפסיקים
רשימת התיקיות) שיש לאחזר. התחביר של שם התיקיה הוא שרת-
תלוי. אפשרות זו אינה זמינה תחת POP3, ETRN או ODMR.

-- סקרי עקבות
(מילת מפתח: עקבות)
תגיד ל-fetchmail לסקר מידע על מעקב בצורת 'חשבון סקר %s' ו
'תיקייה %s' לשורה שהתקבלה שהיא מייצרת, שבה חלקי %s מוחלפים על ידי
שם המרוחק של המשתמש, תווית הסקר והתיקיה (תיבת הדואר) אם זמינים
(הכותרת Received כוללת בדרך כלל גם את השם האמיתי של השרת). זה יכול להיות
משמש כדי להקל על סינון דואר בהתבסס על החשבון שממנו הוא מתקבל.
מידע התיקיה נכתב רק מגרסה 6.3.4.

--ssl (מילת מפתח: ssl)
גורם לחיבור לשרת הדואר להיות מוצפן באמצעות SSL, על ידי משא ומתן
SSL ישירות לאחר החיבור (מצב עטוף SSL). מומלץ מאוד להשתמש
--sslcertck כדי לאמת את האישורים שהוצגו על ידי השרת. אנא ראה את
תיאור של --sslproto למטה! מידע נוסף זמין ב- README.SSL
קובץ שנשלח עם fetchmail.

שים לב שגם אם אפשרות זו נשמטת, fetchmail עדיין עשוי לנהל משא ומתן על SSL בתוך הלהקה
עבור POP3 או IMAP, דרך תכונת STLS או STARTTLS. אתה יכול להשתמש ב- --sslproto
אפשרות לשנות התנהגות זו.

אם לא צוין יציאה, ניסיון החיבור ליציאה הידועה של ה-
גרסת SSL של פרוטוקול הבסיס. זה בדרך כלל יציאה שונה מהנמל
בשימוש על ידי פרוטוקול הבסיס. עבור IMAP, זוהי יציאה 143 עבור פרוטוקול ברור ו
יציאה 993 עבור פרוטוקול מאובטח SSL; עבור POP3, זה יציאה 110 עבור הטקסט הברור
ויציאה 995 עבור הגרסה המוצפנת.

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

--sslcert
(מילת מפתח: sslcert)
עבור אימות לקוח מבוסס אישור. חלק משרתי SSL מוצפנים דורשים
מפתחות ואישורים בצד הלקוח לאימות. ברוב המקרים, זהו
אופציונאלי. זה מציין את המיקום של אישור המפתח הציבורי
מוצג לשרת בזמן הקמת הפעלת SSL. זה לא
נדרש (אך עשוי להיות מסופק) אם השרת אינו דורש זאת. יכול להיות שזה ה
אותו קובץ כמו המפתח הפרטי (משולב מפתח וקובץ אישור) אבל זה לא
מוּמלָץ. ראה גם --sslkey למטה.

הערה: אם אתה משתמש באימות לקוח, שם המשתמש יובא מה-
ה-CommonName של האישור ודובר את השם שהוגדר עם --user.

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

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

ראה גם --sslcert למעלה.

--sslproto
(מילת מפתח: sslproto, הערה: שינויים סמנטיים מאז v6.4.0)
לאפשרות זו יש שימוש כפול, מתוך התנהגות היסטורית של fetchmail. זה שולט בשניהם
גרסת פרוטוקול SSL/TLS, ואם לא צוין --ssl, התנהגות STARTTLS
(שדרוג הפרוטוקול לחיבור SSL או TLS בפס). כמה אפשרויות אחרות
עם זאת, עשוי להפוך את TLS לחובה.

רק אם אפשרות זו וגם --ssl חסרים לסקר, יהיה TLS אופורטוניסטי
עבור POP3 ו-IMAP, שבהם fetchmail ינסה לשדרג ל-TLSv1 או חדש יותר.

ערכים מוכרים עבור --sslproto ניתנים להלן. אתה צריך בדרך כלל לבחור אחד מה
אפשרויות משא ומתן אוטומטי, כלומר 'המכונית' או אחת מהאפשרויות המסתיימות בפלוס (+)
אופי. שים לב שבהתאם לגרסת ספריית OpenSSL ותצורה, כמה אפשרויות
לגרום לשגיאות זמן ריצה מכיוון שגרסאות ה-SSL או TLS המבוקשות אינן נתמכות על ידי
ספריית OpenSSL המותקנת במיוחד.

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

'המכונית' (ברירת מחדל). מאז v6.4.0. דורש TLS. ניהול משא ומתן אוטומטי של TLSv1 או חדש יותר, השבת
שדרוג לאחור של SSLv3. (fetchmail 6.3.26 ומעלה ניהל משא ומתן אוטומטי על כולם
פרוטוקולים שבהם תמכה ספריית OpenSSL שלהם, כולל ה-SSLv3 השבור).

'SSL23'
לראות'המכונית'.

'SSL3' דורש SSLv3 בדיוק. SSLv3 מקולקל, לא נתמך בכל המערכות, הימנע
את זה אם אפשר. זה יגרום ל-fetchmail לנהל משא ומתן על SSLv3 בלבד, והוא
רק דרך חוץ מזה'SSL3+' לקבל אישור Fetchmail 6.4.0 או חדש יותר SSLv3.

'SSL3+'
כמו 'המכונית', אבל אפשר גם SSLv3. זו הדרך היחידה חוץ מזה
'SSL3' לקבל אישור Fetchmail 6.4.0 או חדש יותר SSLv3.

'TLS1' דורש TLSv1. זה לא מנהל משא ומתן על TLSv1.1 או גרסה חדשה יותר, והוא לא מעודד.
החלף ב-TLS1+ אלא אם האחרון חונק את השרת שלך.

'TLS1+'
מאז v6.4.0. ראה 'fBauto'.

'TLS1.1'
מאז v6.4.0. דורש TLS v1.1 בדיוק.

'TLS1.1+'
מאז v6.4.0. דורש TLS. ניהול משא ומתן אוטומטי TLSv1.1 או חדש יותר.

'TLS1.2'
מאז v6.4.0. דורש TLS v1.2 בדיוק.

'TLS1.2+'
מאז v6.4.0. דורש TLS. ניהול משא ומתן אוטומטי TLSv1.2 או חדש יותר.

פרמטרים לא מזוהים
מתייחסים כמו 'המכונית'.

הערה: כמעט ולא צריך להשתמש בשום דבר אחר מלבד '' (כדי להכריח
חיבור לא מוצפן) או 'אוטומטי' (כדי לאכוף TLS).

--sslcertck
(מילת מפתח: sslcertck)
גורם ל-fetchmail לדרוש שימוש ב-SSL/TLS ולהתנתק אם לא ניתן
לנהל מו"מ מוצלח של SSL או TLS, או אם אין אפשרות לאמת ולאמת בהצלחה
האישור ועקבו אחריו לעוגן אמון (או אישור שורש מהימן). ה
עוגני אמון ניתנים כקבוצה של תעודות מהימנות מקומיות (ראה את sslcertfile
ו sslcertpath אפשרויות). אם לא ניתן להשיג את אישור השרת או לא
חתום על ידי אחד מהאמינים (במישרין או בעקיפין), fetchmail יהיה
ניתוק, ללא קשר ל טביעת אצבע sslf אוֹפְּצִיָה.

שים לב ש-CRL (רשימות ביטול אישורים) נתמכות רק ב-OpenSSL 0.9.7
וחדש יותר! גם שעון המערכת שלך צריך להיות מדויק למדי בעת השימוש הזה
אוֹפְּצִיָה.

שים לב שהתנהגות אופציונלית זו עשויה להפוך להתנהגות ברירת מחדל ב-fetchmail עתידי
גרסות.

--sslcertfile
(מילת מפתח: sslcertfile, מאז v6.3.17)
מגדיר את הקובץ ש-fetchmail משתמש בו כדי לחפש אישורים מקומיים. ברירת המחדל ריקה.
זה יכול להינתן בנוסף --sslcertpath להלן, ותעודות המפורטות ב
--sslcertfile יטופל לפני הנכנסים --sslcertpath. האפשרות יכולה להיות
משמש בנוסף ל --sslcertpath.

הקובץ הוא קובץ טקסט. הוא מכיל שרשור של אישורי CA מהימנים
בפורמט PEM.

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

--sslcertpath
(מילת מפתח: sslcertpath)
מגדיר את הספרייה ש-fetchmail משתמשת בו כדי לחפש אישורים מקומיים. ברירת המחדל היא
ספריית ברירת המחדל של OpenSSL. הספרייה חייבת להיות מוארכת כמו OpenSSL
מצפה לזה - בכל פעם שאתה מוסיף או משנה אישור בספרייה, אתה צריך
להשתמש c_rehash כלי (שמגיע עם OpenSSL בספריית המשנה tools/).
כמו כן, לאחר שדרוגי OpenSSL, ייתכן שתצטרך להפעיל c_rehash; במיוחד מתי
שדרוג מ-0.9.X ל-1.0.0.

זה יכול להינתן בנוסף --sslcertfile לעיל, אשר ראה בעדיפות
כללים.

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

--sslcommonname <נפוץ שם>
(מילת מפתח: sslcommonname; מאז v6.3.9)
השימוש באפשרות זו אינו מעודד. לפני השימוש בו, פנה למנהל המערכת של
השרת במעלה הזרם שלך ובקש להשתמש באישור SSL מתאים. אם זה
לא ניתן להשיג, ניתן להשתמש באפשרות זו כדי לציין את השם (CommonName) כי
fetchmail מצפה באישור השרת. שרת מוגדר כהלכה יעשה זאת
יש להגדיר את זה לשם המארח שבאמצעותו מגיעים אליו, וכברירת מחדל fetchmail יהיה
לצפות באותה מידה. השתמש באפשרות זו כאשר CommonName מוגדר לערך אחר, to
הימנע מהאזהרת "Server CommonName dismatch" ורק אם השרת במעלה הזרם
לא ניתן להשתמש באישורים מתאימים.

--sslfprinting
(מילת מפתח: sslfingerprint)
ציין את טביעת האצבע של מפתח השרת (hash MD5 של המפתח) בהקסדצימלי
סימון עם נקודתיים המפרידים בין קבוצות של שתי ספרות. ספרות הקשת האותיות חייבות להיות
באותיות גדולות. זהו הפורמט שבו משתמש fetchmail כדי לדווח על טביעת האצבע
כאשר נוצר חיבור SSL. כאשר זה יצוין, fetchmail יעשה זאת
השווה את טביעת האצבע של מפתח השרת לזו הנתונה, והחיבור ייכשל
אם הם לא תואמים, ללא קשר ל sslcertck הגדרה. החיבור יהיה גם
נכשל אם fetchmail לא יכול להשיג אישור SSL מהשרת. זה יכול להיות
משמש למניעת התקפות אדם-באמצע, אבל טביעת האצבע מהשרת
צריך להשיג או לאמת בערוץ מאובטח, ובוודאי לא דרך
אותו חיבור לאינטרנט ש-fetchmail ישתמש בו.

שימוש באפשרות זו ימנע שגיאות אימות אישור הדפסה כל עוד
--sslcertck לא מוגדר.

כדי לקבל את טביעת האצבע של תעודה המאוחסנת בקובץ cert.pem, נסה:

openssl x509 -in cert.pem -noout -md5 -טביעת אצבע

לפרטים ראו x509(1ssl).

מסירה שליטה אפשרויות
-S | --smtphost
(מילת מפתח: smtp[מארח])
ציין רשימת ציד של מארחים שאליהם יש להעביר דואר (שם מארח אחד או יותר, פסיק-
מופרד). מארחים מנסים לפי סדר רשימה; הראשון שעולה הופך ל-
יעד העברה לריצה הנוכחית. אם אפשרות זו לא צוינה,
'localhost' משמש כברירת המחדל. לכל שם מארח עשוי להיות מספר יציאה הבא
שם המארח. מספר היציאה מופרד משם המארח באמצעות קו נטוי; ה
יציאת ברירת המחדל היא "smtp". אם תציין שם נתיב מוחלט (מתחיל ב-/),
זה יתפרש כשם של שקע UNIX המקבל חיבורי LMTP
(כגון שנתמך על ידי דמון Cyrus IMAP) דוגמה:

--smtphost server1,server2/2525,server3,/var/imap/socket/lmtp

ניתן להשתמש באפשרות זו עם ODMR, ותהפוך את fetchmail לממסר בין ה-ODMR
שרת ומקלט SMTP או LMTP.

--fetchdomains
(מילת מפתח: fetchdomains)
במצב ETRN או ODMR, אפשרות זו מציינת את רשימת הדומיינים שהשרת צריך
לשלוח דואר לרגע שהחיבור מסובב. ברירת המחדל היא FQDN של
מכונה פועלת fetchmail.

-D | --כתובת smtpad
(מילת מפתח: smtpaddress)
ציין את הדומיין שיש לצרף לכתובות בקווי RCPT TO שנשלחו ל-SMTP.
כאשר זה לא מצוין, שם שרת ה-SMTP (כפי שצוין על ידי
--smtphost) משמש עבור SMTP/LMTP ו-'localhost' משמש עבור שקע UNIX/BSMTP.

--smtpname
(מילת מפתח: smtpname)
ציין את הדומיין והמשתמש שיש לשים ב-RCPT TO שורות שנשלחו ל-SMTP. ה
משתמש ברירת המחדל הוא המשתמש המקומי הנוכחי.

-Z | --אנטי - ספאם <nnn[, nn]...>
(מילת מפתח: אנטי ספאם)
מציין את רשימת שגיאות ה-SMTP המספריות שיש לפרש כספאם-
לחסום תגובה מהמאזין. ערך של -1 משבית אפשרות זו. בשביל ה
אפשרות שורת הפקודה, ערכי הרשימה צריכים להיות מופרדים בפסיקים.

-m | --mda
(מילת מפתח: mda)
אפשרות זו מאפשרת fetchmail השתמש בהודעה או בסוכן משלוח מקומי (MDA או LDA)
ישירות, במקום להעביר דרך SMTP או LMTP.

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

If fetchmail פועל כשורש, הוא מגדיר את מזהה המשתמש שלו בזמן שליחת דואר דרך
MDA באופן הבא: ראשית, סביבת FETCHMAILUSER, LOGNAME ו-USER
משתנים נבדקים בסדר זה. הערך של המשתנה הראשון מהרשימה שלו
שמוגדר (גם אם הוא ריק!) נחפש במסד הנתונים של המשתמשים של המערכת. אם
אף אחד מהמשתנים אינו מוגדר, fetchmail ישתמש במזהה המשתמש האמיתי שהיה
התחיל עם. אם אחד המשתנים הוגדר, אך המשתמש ציין שלא
נמצא, fetchmail ממשיך לפעול כשורש, מבלי לבדוק את המשתנים הנותרים
הרשימה. מעשית, זה אומר שאם אתה מפעיל fetchmail בתור root (לא
מומלץ), הכי שימושי להגדיר את משתנה הסביבה FETCHMAILUSER ל
הגדר את המשתמש שה-MDA יפעל בתור. כמה MDAs (כגון maildrop) מתוכננים
להיות setuid root ו-setuid למזהה המשתמש של הנמען, כדי שלא תאבד
פונקציונליות בדרך זו גם בעת הפעלת fetchmail כמשתמש חסר הרשאות. בדוק את ה
מדריך מד"א לפרטים.

כמה מד"א אפשריים הם "/usr/sbin/sendmail -i -f %F -- %T" (הערה: כמה כמה
טעות ישנה יותר או של ספק של גרסאות sendmail -- עבור כתובת, במקום כתובת
מחוון לסימון סוף ארגומנטים של האפשרות), "/usr/bin/deliver" ו
"/usr/bin/maildrop -d %T". כתובות משלוח מקומיות יוכנסו למד"א
פקודה בכל מקום שתציב %T; כתובת מאת הודעת הדואר תוכנס
איפה אתה מציב %F.

Do לא לְצַרֵף מה היא %F or %T מחרוזת in יחיד ציטוטים! עבור %T וגם עבור %F, fetchmail
מקיף את הכתובות במרכאות בודדות ('), לאחר הסרת מרכאות בודדות שהן
עשוי להכיל, לפני העברת פקודת מד"א לקליפה.

Do לא להשתמש an מד"א קְרִיאָה זֶה משלוחים on מה היא תוכן of אל/עותק/עותק מוסתר, כמו
"sendmail -i -t" או "qmail-inject", זה יצור לולאות דואר ויביא את ה-just
כעסם של מנהלי דואר רבים על ראשך. זהו אחד השכיחים ביותר
שגיאות תצורה!

כמו כן, עשה לֹא נסה לשלב מצב מולטי-דרופ עם MDA כגון maildrop שיכול
קבל רק כתובת אחת, אלא אם כן ה-upstream שלך מאחסן עותק אחד של ההודעה לכל
נמען ומעביר את מקבל המעטפה בכותרת עליונה; אתה תאבד דואר.

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

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

--lmtp (מילת מפתח: lmtp)
גורם למשלוח באמצעות LMTP (פרוטוקול העברת דואר מקומי). מארח שירות ונמל
צריך יצוין במפורש על כל מארח ברשימת smtphost hunt (ראה למעלה) אם
אפשרות זו נבחרת; יציאת ברירת המחדל 25 לא תהיה (בהתאם ל-RFC 2033).
להתקבל.

--bsmtp
(מילת מפתח: bsmtp)
הוסף דואר שאוחזר לקובץ BSMTP. זה פשוט מכיל את פקודות ה-SMTP ש
בדרך כלל נוצר על ידי fetchmail בעת העברת דואר למאזין SMTP
דמון.

ארגומנט של '-' גורם לכתיבה של אצווה SMTP לפלט סטנדרטי, כלומר
שימוש מוגבל: זה הגיוני רק עבור ניפוי באגים, מכיוון ש-fetchmail רגיל
הפלט מפוזר באותו ערוץ, כך שזה לא מתאים לדואר
מְסִירָה. ייתכן שהמצב המיוחד הזה יוסר במהדורה מאוחרת יותר.

שימו לב שהשחזור של fetchmail של שורות MAIL FROM ו-RCPT TO לא
מובטח נכון; הסתייגויות הנדונות תחת השימוש והשימוש לרעה ב-MULTIDROP
תיבות הדואר למטה חלות. למצב זה יש עדיפות לפני --mda ו-SMTP/LMTP.

--ראש רע {דחה|קבל}
(מילת מפתח: bad-header; מאז v6.3.15)
ציין כיצד fetchmail אמור להתייחס להודעות עם כותרות גרועות, כלומר כותרות
עם תחביר גרוע. באופן מסורתי, fetchmail דחה הודעות כאלה, אבל חלקן
המפיצים שינו את fetchmail כדי לקבל אותם. כעת אתה יכול להגדיר את ה-fetchmail
התנהגות לכל שרת.

משאב הגבול שליטה אפשרויות
-l | --לְהַגבִּיל
(מילת מפתח: הגבלה)
לוקח ארגומנט גודל אוקטטה מקסימלי, כאשר 0 הוא ברירת המחדל וגם המיוחד
ערך המציין "ללא גבול". אם לא אפס, הודעות גדולות מגודל זה לא יעשו זאת
יובא ויושאר בשרת (במפגשי חזית, ההתקדמות
הודעות יציינו שהן "גדולות מדי"). אם פרוטוקול האחזור מאפשר (ב
במיוחד, תחת IMAP או POP3 ללא אפשרות fetchall) ההודעה לא תהיה
מסומן שנראה.

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

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

-w | --אזהרות
(מילת מפתח: אזהרות)
לוקח מרווח בשניות. כשאתה מתקשר fetchmail עם אפשרות 'מגבלה' ב
מצב daemon, זה שולט במרווח שבו אזהרות לגבי הודעות גדולות מדי
נשלחים בדואר למשתמש המתקשר (או למשתמש שצוין על ידי האפשרות 'מנהל הדואר').
הודעה אחת כזו נשלחת תמיד בדואר בסוף הסקר הראשון שבו
זוהתה הודעה גדולה מדי. לאחר מכן, ההודעה מחדש נדחית עד
לאחר חלוף מרווח האזהרה (זה יתקיים בסוף הראשון
בעקבות הסקר).

-b | --מגבלת אצווה
(מילת מפתח: אצווה)
ציין את המספר המרבי של הודעות שיישלחו למאזין SMTP
לפני שהחיבור נקרע ונבנה מחדש בכוונה (ברירת המחדל היא 0, כלומר
אין גבול). --batchlimit מפורש של 0 עוקף כל מגבלה שהוגדרה בריצה שלך
קובץ בקרה. בזמן שלח מייל(8) בדרך כלל יוזם מסירת הודעה
מיד לאחר קבלת מסיים ההודעות, חלק מהמאזינים ל-SMTP אינם כאלה
מיידי. MTAs כמו לחייך(8) עשוי להמתין עד כיבוי שקע המשלוח
לִמְסוֹר. זה עלול לייצר עיכובים מעצבנים כאשר fetchmail עיבוד גדול מאוד
קבוצות. הגדרת מגבלת האצווה לגודל שאינו אפס תמנע עיכובים אלה.
אפשרות זו אינה פועלת עם ETRN או ODMR.

-B | --fetchlimit
(מילת מפתח: fetchlimit)
הגבל את מספר ההודעות המתקבלות משרת נתון בסקר יחיד. על ידי
ברירת מחדל אין גבול. --fetchlimit מפורש של 0 עוקף כל מגבלה שהוגדרה
בקובץ בקרת הריצה שלך. אפשרות זו אינה פועלת עם ETRN או ODMR.

--fetchsizelimit
(מילת מפתח: fetchsizelimit)
הגבל את מספר הגדלים של הודעות המתקבלות משרת נתון ביחיד
עִסקָה. אפשרות זו שימושית בהפחתת העיכוב בהורדת הראשון
דואר כאשר יש יותר מדי מיילים בתיבת הדואר. כברירת מחדל, המגבלה היא 100.
אם מוגדר ל-0, הגדלים של כל ההודעות יורדו בהתחלה. אפשרות זו כן
לא עובד עם ETRN או ODMR. עבור POP3, הערך התקף היחיד שאינו אפס הוא 1.

--fastuidl
(מילת מפתח: fastuidl)
בצע חיפוש בינארי במקום חיפוש ליניארי עבור ה-UID הראשון שלא נראה. חיפוש בינארי נמנע
הורדת ה-UID של כל הדואר. זה חוסך זמן (במיוחד במצב דמון)
כאשר הורדת אותה קבוצה של UID בכל סקר היא בזבוז של רוחב פס. ה
מספר 'n' מציין באיזו נדירות יש לבצע חיפוש ליניארי. במצב דמון,
חיפוש ליניארי משמש פעם אחת ואחריו חיפושים בינאריים בסקרים 'n-1' אם 'n' הוא
גדול מ-1; תמיד נעשה שימוש בחיפוש בינארי אם 'n' הוא 1; חיפוש לינארי הוא תמיד
משמש אם 'n' הוא 0. במצב שאינו דמון, נעשה שימוש בחיפוש בינארי אם 'n' הוא 1; אחרת
נעשה שימוש בחיפוש לינארי. ערך ברירת המחדל של 'n' הוא 4. אפשרות זו פועלת עם POP3
בלבד.

-e | -- למחוק
(מילת מפתח: למחוק)
דאג שהמחיקות ייעשו סופיות לאחר מספר נתון של הודעות. תַחַת
POP2 או POP3, fetchmail לא יכול להפוך את המחיקות לסופיות מבלי לשלוח QUIT ולסיים
ההפעלה -- עם אפשרות זו מופעלת, fetchmail ישבור אחזור דואר ארוך
הפגישה למספר תת-הפעלות, שולחת QUIT לאחר כל תת-מפגש. זה
הגנה טובה מפני נפילות קו בשרתי POP3. תחת IMAP, fetchmail בדרך כלל
מוציא פקודת EXPUNGE לאחר כל מחיקה כדי לאלץ את המחיקה
נעשה מיד. זה הכי בטוח כאשר החיבור שלך לשרת מתקלקל ו
יקר, מכיוון שהוא מונע שליחת דואר כפול מחדש לאחר פגיעה בשורה. עם זאת, על
תיבות דואר גדולות, התקורה של הוספה מחדש לאינדקס לאחר כל הודעה יכולה להטיח את השרת
די קשה, אז אם החיבור שלך אמין, טוב לעשות פחות מחיקה
בתדירות גבוהה. שים לב גם ששרתים מסוימים אוכפים עיכוב של כמה שניות לאחר מכן
כל יציאה, כך ש-fetchmail לא יוכל לחזור מיד לאחר מחיקה
-- ייתכן שתראה שגיאות "נעול תפוס" אם זה יקרה. אם תציין אפשרות זו ל- an
מספר שלם N, זה אומר fetchmail להוציא מחיקה רק בכל מחיקה Nth. א
ארגומנט של אפס מדכא ביטולים לחלוטין (לכן לא יבוצעו ביטולים כלל
עד סוף הריצה). אפשרות זו אינה פועלת עם ETRN או ODMR.

אימות אפשרויות
-u | --מִשׁתַמֵשׁ | --שם משתמש
(מילת מפתח: משתמש[שם])
מציין את זיהוי המשתמש שישמש בעת הכניסה לשרת הדואר.
זיהוי המשתמש המתאים תלוי בשרת וגם במשתמש. ברירת המחדל
הוא שם הכניסה שלך במחשב הלקוח שפועל fetchmail. ראה USER
אימות למטה לתיאור מלא.

-I | --מִמְשָׁק
(מילת מפתח: ממשק)
דרוש שהתקן ממשק ספציפי יהיה פעיל ובעל מכשיר מקומי או מרוחק ספציפי
כתובת (או טווח) IPv4 (IPv6 עדיין לא נתמך על ידי אפשרות זו) לפני הסקר.
לעתים קרובות fetchmail משמש על קישור TCP/IP חולף מנקודה לנקודה
הוקם ישירות לשרת דואר באמצעות SLIP או PPP. זה בטוח יחסית
עָרוּץ. אבל כאשר קיימים נתיבי TCP/IP אחרים לשרת הדואר (למשל כאשר הקישור
מחובר לספק אינטרנט חלופי), שם המשתמש והסיסמה שלך עשויים להיות פגיעים
חטטנות (במיוחד כאשר מצב דמון סוקר אוטומטית עבור דואר, משלוח א
סיסמה ברורה דרך הרשת במרווחים צפויים). האפשרות --ממשק עשויה
לשמש כדי למנוע זאת. כאשר הקישור שצוין אינו פתוח או אינו מחובר אליו
כתובת IP תואמת, ההשאלה תידלג. הפורמט הוא:

interface/iii.iii.iii.iii[/mmm.mmm.mmm.mmm]

השדה לפני הלוכסן הראשון הוא שם הממשק (כלומר sl0, ppp0 וכו'). ה
השדה לפני הלוכסן השני הוא כתובת ה-IP המקובלת. השדה שאחרי ה
קו נטוי שני הוא מסכה שמציינת טווח של כתובות IP שיש לקבל. אם לא
מסכה קיימת. ההנחה היא 255.255.255.255 (כלומר התאמה מדויקת). אפשרות זו היא
כרגע נתמך רק תחת Linux ו- FreeBSD. אנא ראה את צג סעיף
להלן מידע ספציפי על FreeBSD.

שימו לב שאפשרות זו תוסר מגרסת fetchmail עתידית.

-M | --לפקח
(מילת מפתח: צג)
מצב Daemon יכול לגרום לקישורים חולפים אשר יוסרו אוטומטית לאחר א
תקופה של חוסר פעילות (למשל קישורי PPP) כדי להישאר ללא הגבלת זמן. אפשרות זו
מזהה ממשק TCP/IP מערכת למעקב אחר פעילות. אחרי כל סקר
מרווח, אם הקישור קיים אך לא התרחשה פעילות אחרת בקישור, אז
הסקר ידלג. עם זאת, כאשר fetchmail מתעורר על ידי אות, ה
בדיקת המוניטור מדלגת והסקר עובר ללא תנאי. אפשרות זו היא
כרגע נתמך רק תחת Linux ו- FreeBSD. בשביל ה צג ו ממשק
אפשרויות לעבוד עבור משתמשי שורש שאינם משתמשים תחת FreeBSD, הקובץ הבינארי של fetchmail חייב להיות
מותקן SGID kmem. זה יהיה חור אבטחה, אבל fetchmail פועל עם
GID יעיל מוגדר לזה של קבוצת kmem רק כאשר נתוני ממשק נמצאים
נאסף.

שימו לב שאפשרות זו תוסר מגרסת fetchmail עתידית.

--auth
(מילת מפתח: אימות [enticate])
אפשרות זו מאפשרת לך לציין סוג אימות (ראה אימות משתמש
להלן לפרטים). הערכים האפשריים הם כל, סיסמא, kerberos_v5, kerberos
(או, ליתר דיוק, kerberos_v4), gssapi, cram-md5, Otp, ntlm, MSN
(רק עבור POP3), חיצוני (רק IMAP) ו ssh. כאשר כל (ברירת המחדל) היא
שצוין, fetchmail מנסה שיטות ראשונות שאינן דורשות סיסמה (EXTERNAL,
GSSAPI, KERBEROS IV, KERBEROS 5); לאחר מכן הוא מחפש שיטות שמסתירות את הסיסמה שלך
(CRAM-MD5, NTLM, X-OTP - שימו לב ש-MSN נתמך רק עבור POP3, אך לא
בדיקה אוטומטית); ורק אם השרת לא תומך באף אחד מאלה הוא ישלח את שלך
סיסמה ברורה. ניתן להשתמש בערכים אחרים כדי לכפות אימות שונים
שיטות (ssh מדכא אימות ולכן שימושי עבור IMAP PREAUTH).
(חיצוני מדכא אימות ולכן שימושי עבור IMAP EXTERNAL). כל
ערך אחר מאשר סיסמא, cram-md5, ntlm, MSN or Otp מדכא את הרגיל של fetchmail
שאלת סיסמה. לפרט ssh כאשר אתה משתמש במאבטח מקצה לקצה
חיבור כגון מנהרת ssh; לפרט חיצוני כאשר אתה משתמש ב-TLS עם הלקוח
אימות וציון gssapi or kerberos_v4 אם אתה משתמש בפרוטוקול
גרסה שמשתמשת ב-GSSAPI או K4. בחירה בפרוטוקול KPOP בוחרת אוטומטית
אימות Kerberos. אפשרות זו לא עובדת עם ETRN. שירות GSSAPI
השמות תואמים לרישומי RFC-2743 ו-IANA, ראה אבטחה כללית
ממשק תוכנית יישום שירות (GSSAPI)/Kerberos/אימות פשוט ו
שמות שירות שכבת אבטחה (SASL) ⟨http://www.iana.org/assignments/
gssapi-service-names/⟩.

שונות אפשרויות
-f | --fetchmailrc
ציין שם שאינו ברירת מחדל עבור ~/.fetchmailrc להפעיל קובץ בקרה. שם הנתיב
הארגומנט חייב להיות "-" (מקף בודד, כלומר לקרוא את התצורה ממנה
קלט רגיל) או שם קובץ. אלא אם כן האפשרות --version מופעלת גם היא, a name
לארגומנט הקובץ חייב להיות הרשאות פתוחות יותר מ-0700 (u=rwx,g=,o=) או להיות
/dev/null.

-i | --idfile
(מילת מפתח: idfile)
ציין שם חלופי לקובץ .fetchids המשמש לשמירת מזהי UID של הודעות. הערה:
מאז fetchmail 6.3.0, גישת כתיבה לספרייה המכילה את ה-idfile הוא
נדרש, מכיוון ש-fetchmail כותב קובץ זמני ומשנה את שמו למקום ה-
real idfile רק אם הקובץ הזמני נכתב בהצלחה. זה נמנע
חיתוך של קבצי id כאשר נגמר שטח הדיסק.

--pidfile
(מילת מפתח: pidfile; מאז fetchmail v6.3.4)
תעקוף את מיקום ברירת המחדל של קובץ ה-PID. ברירת מחדל: ראה "סביבה" למטה.

-n | --לכתוב
(מילת מפתח: אין שכתוב)
בדרך כלל, fetchmail עורך כותרות כתובות RFC-822 (אל, מאת, עותק, עותק מוסתר ותשובה ל)
בדואר שאוחזר כך שכל מזהי הדואר המקומיים לשרת יורחב למלא
כתובות (@ ושם המארח של שרת הדואר מצורפים). זה מאפשר להפעיל תשובות
הלקוח יקבל מענה נכון (אחרת יכול הדואר שלך לחשוב שהם
יש לפנות למשתמשים מקומיים במחשב הלקוח!). אפשרות זו מבטלת
השכתוב. (אפשרות זו ניתנת כדי להרגיע אנשים שהם פרנואידים לגביהם
שיש MTA לערוך כותרות דואר ורוצה לדעת שהם יכולים למנוע זאת, אבל זה כן
בדרך כלל לא רעיון טוב לכבות את השכתוב.) בעת שימוש ב-ETRN או ODMR,
אפשרות השכתוב אינה יעילה.

-E | --מַעֲטָפָה
(מילת מפתח: מעטפה; ריבוי שחרורים בלבד)
בקובץ התצורה, נעשה שימוש בתחביר משופר:
מעטפה [ ]

אפשרות זו משנה את הכותרת fetchmail מניח שישא עותק של הדואר
כתובת המעטפה. בדרך כלל זה 'X-Envelope-To'. כותרות אחרות שנמצאות בדרך כלל
לשאת פרטי מעטפה הם 'X-Original-To' ו-'Delivered-To'. עכשיו, מאז
כותרות אלו אינן סטנדרטיות, התרגול משתנה. ראה את הדיון ב
טיפול בכתובות מרובות למטה. כמקרה מיוחד, 'מעטפה "התקבלה"' מאפשר
ניתוח של שורות שהתקבלו בסגנון sendmail. זו ברירת המחדל, אבל מיואש
כי זה לא אמין לגמרי.

שים לב ש-fetchmail מצפה ששורת Received תהיה בפורמט מסוים: הוא חייב
מכילים "על ידי המארח ל כתובת", איפה המארח חייב להתאים לאחד משמות שרת הדואר
ש-fetchmail מזהה עבור החשבון המדובר.

ארגומנט הספירה האופציונלי (זמין רק בקובץ התצורה) קובע
כמה שורות כותרות מהסוג הזה מדלגות. ספירה של 1 פירושה: לדלג על הראשון,
לקחת את השני. ספירה של 2 פירושה: לדלג על הראשון והשני, לקחת את השלישי, ו
כן הלאה.

-Q | --קווירטואלי
(מילת מפתח: qvirtual; Multidrop בלבד)
קידומת המחרוזת שהוקצתה לאפשרות זו תוסר משם המשתמש שנמצא
בכותרת שצוינה עם ה- מעטפה האפשרות (לפני עושה שם ריבוי טיפות
מיפוי או בדיקת תחום מקומי, אם אחד מהם רלוונטי). אפשרות זו שימושית אם
אתה משתמש fetchmail כדי לאסוף את הדואר עבור דומיין שלם ו-ISP שלך (או
ספק ניתוב הדואר שלך) משתמש ב-qmail. אחת התכונות הבסיסיות של qmail
האם ה הועבר ל: כותרת ההודעה. בכל פעם ש-qmail מעביר הודעה למקומי
תיבת הדואר היא שמה את שם המשתמש ושם המארח של מקבל המעטפה בשורה זו.
הסיבה העיקרית לכך היא מניעת לולאות דואר. כדי להגדיר qmail לדואר אצווה
עבור אתר מנותק, ISP-mailhost יכניס את האתר הזה בדרך כלל לאתר שלו
קובץ הבקרה 'Virtualhosts' כך שהוא יוסיף קידומת לכל כתובות הדואר עבור זה
אֲתַר. זה גורם לדואר שנשלח אל '[מוגן בדוא"ל]' שיש א
הועבר ל: שורת הטופס:

הועבר ל: [מוגן בדוא"ל]

ספק שירותי האינטרנט יכול להפוך את הקידומת 'mbox-userstr-' לכל דבר שיבחר מלבד מחרוזת התואמת את
סביר להניח ששם מארח משתמש. על ידי שימוש באפשרות 'מעטפה מסירה אל:' אתה יכול לעשות
fetchmail מזהה באופן אמין את נמען המעטפה המקורית, אבל אתה צריך להסיר את
קידומת 'mbox-userstr-' כדי להעביר למשתמש הנכון. בשביל זה נועדה האפשרות הזו.

--configdump
ניתוח ה ~/.fetchmailrc קובץ, לפרש את כל אפשרויות שורת הפקודה שצוינו, וכן
זרוק דוח תצורה לפלט סטנדרטי. דוח התצורה הוא נתונים
הקצאת מבנה בשפה Python. אפשרות זו מיועדת לשימוש עם
אינטראקטיבי ~/.fetchmailrc עורך כמו fetchmailconf, כתוב בפייתון.

הוסר אפשרויות
-T | --netsec
הוסרה לפני גרסה 6.3.0, ספריית inet6_apps הדרושה הוסרה
הופסק ואינו זמין יותר.

משתמש אישור ו הקבלה

כל המצבים מלבד ETRN דורשים אימות של הלקוח לשרת. משתמש רגיל
אימות ב fetchmail דומה מאוד למנגנון האימות של FTP(1). ה
מזהה המשתמש והסיסמה הנכונים תלויים במערכת האבטחה הבסיסית בשרת הדואר.

אם שרת הדואר הוא מכשיר יוניקס שבו יש לך חשבון משתמש רגיל, שלך
שם כניסה וסיסמה רגילים משמשים עם fetchmail. אם אתה משתמש באותו שם התחברות
גם בשרת וגם במחשבי הלקוח, אינך צריך לדאוג לגבי ציון מזהה משתמש
עם -u אפשרות -- התנהגות ברירת המחדל היא להשתמש בשם ההתחברות שלך במחשב הלקוח
בתור מזהה המשתמש במחשב השרת. אם אתה משתמש בשם התחברות אחר בשרת
מכונה, ציין את שם הכניסה עם ה- -u אוֹפְּצִיָה. למשל אם שם הכניסה שלך הוא 'jsmith'
במחשב בשם 'mailgrunt', היית מתחיל fetchmail באופן הבא:

fetchmail -u jsmith mailgrunt

התנהגות ברירת המחדל של fetchmail הוא לבקש ממך את סיסמת שרת הדואר שלך לפני
נוצר חיבור. זוהי הדרך הבטוחה ביותר לשימוש fetchmail ומבטיח כי שלך
הסיסמה לא תיפגע. אתה יכול גם לציין את הסיסמה שלך ב-
~/.fetchmailrc קוֹבֶץ. זה נוח בעת השימוש fetchmail במצב דמון או עם
תסריטים.

שימוש netrc קבצים
אם לא תציין סיסמה, ו fetchmail לא יכול לחלץ אחד מהם
~/.fetchmailrc קובץ, הוא יחפש א ~/.netrc קובץ בספריית הבית שלך לפני
בקשה אינטראקטיבית; אם נמצא ערך התואם לשרת הדואר בקובץ הזה,
הסיסמה תשמש. Fetchmail מחפש תחילה התאמה לשם הסקר; אם ימצא
אין, הוא בודק התאמה ב-via name. ראה את FTP(1) דף אדם לפרטים על
תחביר של ~/.netrc קוֹבֶץ. כדי להציג דוגמה מעשית, ‎.netrc עשוי להיראות כך:

machine hermes.example.org
התחבר ג'ו
סיסמה סודית ביותר

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

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

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

POP3 וריאנטים

גרסאות מוקדמות של POP3 (RFC1081, RFC1225) תמכו בצורה גסה של עצמאית
אימות באמצעות ה rhosts קובץ בצד שרת הדואר. תחת גרסת RPOP זו, א
מזהה קבוע לכל משתמש שווה ערך לסיסמה נשלח בצורה ברורה דרך קישור לשמור
port, עם הפקודה RPOP ולא PASS כדי להתריע לשרת שהוא צריך לעשות מיוחד
בודק. RPOP נתמך על ידי fetchmail (אתה יכול לציין 'פרוטוקול RPOP' כדי לקבל את
תוכנית לשלוח 'RPOP' במקום 'PASS') אבל השימוש בו מומלץ מאוד, ותמיכה
יוסר מגרסת fetchmail עתידית. מתקן זה היה חשוף לזיוף
והוסר ב-RFC1460.

RFC1460 הציג אימות APOP. בגרסה זו של POP3, אתה רושם APOP
סיסמה במארח השרת שלך (בשרתים מסוימים, התוכנית לעשות זאת נקראת
popauth(8)). אתה מכניס את אותה הסיסמה שלך ~/.fetchmailrc קוֹבֶץ. בכל פעם fetchmail
מתחבר, הוא שולח MD5 hash של הסיסמה שלך וזמן הברכה של השרת לשרת,
שיכול לאמת אותו על ידי בדיקת מסד הנתונים של ההרשאות שלו.

הערות זֶה פופ is לא עוד נחשב עמיד בפני נגד איש באמצע התקפות.

Ret or מרבית
fetchmail עושה כמה מאמצים לגרום לשרת להאמין שהודעות לא אוחזרו,
על ידי שימוש בפקודה TOP עם מספר רב של שורות במידת האפשר. TOP היא פקודה
שמחזיר את הכותרת המלאה ואת א fetchmail-כמות מוגדרת של קווי גוף. זה
אופציונלי ולכן לא מיושם על ידי כל השרתים, וידוע שחלקם מיישמים זאת
באופן לא תקין. עם זאת, בשרתים רבים, פקודת RETR אשר מאחזרת את ההודעה המלאה
עם כותרת וגוף, מגדיר את הדגל "נראה" (לדוגמה, בממשק אינטרנט), בעוד שה
פקודת TOP לא עושה את זה.

fetchmail תמיד ישתמש בפקודה RETR אם "fetchall" מוגדר. fetchmail ישתמש גם
הפקודה RETR אם "keep" מוגדרת ו-"uidl" לא מוגדרת. סוף כל סוף, fetchmail ישתמש ב-
פקודת RETR בשרתי Maillennium POP3/PROXY (בשימוש על ידי Comcast) כדי למנוע TOP מכוון
פרשנות שגויה בשרת זה הגורמת לשחיתות הודעות.

בכל שאר המקרים, fetchmail ישתמש בפקודה TOP. זה מרמז שב"שמור"
הגדרות, יש להגדיר "uidl" אם רוצים "TOP".

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

להחליף אישור טפסים

אם בקשת fetchmail נבנה עם תמיכת Kerberos ואתה מציין אימות Kerberos
(או עם --auth או עם .fetchmailrc אוֹפְּצִיָה לאמת kerberos_v4) זה ינסה
קבל כרטיס Kerberos משרת הדואר בתחילת כל שאילתה. הערה: אם אחת מהן
pollname או via name הוא 'hesiod', fetchmail ינסה להשתמש בהסיוד כדי לחפש את
שרת דואר.

אם אתה משתמש ב-POP3 או IMAP עם אימות GSSAPI, fetchmail יצפה מהשרת
בעלי יכולת GSSAPI תואמת RFC1731 או RFC1734, וישתמשו בה. כרגע זה
נבדק רק ב-Kerberos V, כך שצפוי כבר לקבל כרטיס
כַּרְטִיס. אתה יכול להעביר שם משתמש שונה מהשם הראשי שלך באמצעות התקן
--מִשׁתַמֵשׁ פקודה או על ידי .fetchmailrc אוֹפְּצִיָה המשתמש.

אם דמון ה-IMAP שלך מחזיר את תגובת PREAUTH בשורת הברכה שלו, fetchmail
שימו לב לכך ודלג על שלב האימות הרגיל. זה יכול להיות שימושי, למשל אם אתה
התחל את imapd במפורש באמצעות ssh. במקרה זה אתה יכול להצהיר על ערך האימות
'ssh' בכניסה לאתר זה כדי לעצור .fetchmail מלבקש ממך סיסמה כשהיא מתחילה
למעלה.

אם אתה משתמש באימות לקוח עם TLS1 ודמון ה-IMAP שלך מחזיר את AUTH=חיצוני
בתגובה, fetchmail יבחין בכך וישתמש בקיצור הדרך לאימות ולא יעשה זאת
לשלוח את ביטוי הסיסמה. במקרה זה אתה יכול להצהיר על ערך האימות 'חיצוני'
באתר זה לעצור fetchmail מלבקש ממך סיסמה כשהיא מופעלת.

אם אתה משתמש ב-POP3, והשרת מנפיק אתגר חד פעמי של סיסמה בהתאם
RFC1938, fetchmail ישתמש בסיסמה שלך כביטוי סיסמה כדי ליצור את הדרוש
תְגוּבָה. זה ימנע שליחת סודות דרך הרשת ללא מוצפן.

אימות RPA של Compuserve נתמך. אם אתה מקמפל בתמיכה, fetchmail
ינסה לבצע אימות ביטוי RPA במקום לשלוח את הסיסמה
en clair אם הוא מזהה "@compuserve.com" בשם המארח.

אם אתה משתמש ב-IMAP, אימות ה-NTLM של Microsoft (בשימוש על ידי Microsoft Exchange).
נתמך. אם אתה מקמפל בתמיכה, fetchmail ינסה לבצע NTLM
אימות (במקום לשלוח את הסיסמה באופן ברור) בכל פעם שהשרת חוזר
AUTH=NTLM בתגובת היכולת שלו. ציין ערך אפשרות משתמש שנראה כך
'user@domain': החלק משמאל ל-@ יועבר כשם המשתמש והחלק
מימין כדומיין NTLM.

לאבטח שֶׁקַע שכבות (SSL) ו תחבורה שִׁכבָה אבטחה (TLS)
תַחְבּוּרָה. בנוסף, אחזור POP3 ו-IMAP יכול גם לנהל משא ומתן על SSL/TLS באמצעות
STARTTLS (או STLS).

שים לב ש-fetchmail משתמש כרגע בספריית OpenSSL, שהיא מאוד לא מתועדת,
כך שכשלים עלולים להתרחש רק בגלל שהמתכנתים אינם מודעים לדרישת OpenSSL
של היום. לדוגמה, מאז v6.3.16, fetchmail קורא ל-OpenSSL_add_all_algorithms(),
הכרחי כדי לתמוך בתעודות באמצעות SHA256 ב-OpenSSL 0.9.8 -- זה
המידע חבוי עמוק בתיעוד ואינו מובן מאליו כלל. בבקשה אל
תהססו לדווח על כשלי SSL עדינים.

אתה יכול לגשת לשירותי SSL מוצפנים על ידי ציון האפשרויות שמתחילות ב--ssl, כגון
כמו --ssl, --sslproto, --sslcertck ואחרים. אתה יכול גם לעשות זאת באמצעות
אפשרויות המשתמש המתאימות בקובץ .fetchmailrc. שירותים מסוימים, כגון POP3 ו
ל-IMAP, יש יציאות ידועות שונות המוגדרות עבור שירותי SSL מוצפנים. ה
יציאות מוצפנות ייבחרו אוטומטית כאשר SSL מופעל ואין יציאה מפורשת
נָקוּב. כמו כן, אפשרות שורת הפקודה --sslcertck או sslcertck הפעלת קובץ בקרה
יש להשתמש כדי לכפות בדיקת אישורים קפדנית - ראה להלן.

אם SSL אינו מוגדר, fetchmail בדרך כלל ינסה להשתמש ב-STARTTLS באופן אופורטוניסטי.
STARTTLS ניתן לאכוף באמצעות --sslproto auto ולהביס אותו באמצעות --sslproto ''.
חיבורי TLS משתמשים באותה יציאה כמו הגרסה הלא מוצפנת של הפרוטוקול ומנהלים משא ומתן
TLS באמצעות פקודה מיוחדת. אפשרות שורת הפקודה --sslcertck או sslcertck run file control
יש להשתמש כדי לכפות בדיקת אישורים קפדנית - ראה להלן.

--sslcertck is מוּמלָץ: בעת חיבור לשרת מוצפן SSL או TLS, השרת
מציג אישור ללקוח לצורך אימות. האישור נבדק לאימות
שהשם הנפוץ בתעודה תואם לשם השרת שאליו פונים ו
שתאריכי תוקף ותפוגה בתעודה מצביעים על כך שזה נכון
תָקֵף. אם אחת מהבדיקות הללו נכשלת, מודפסת הודעת אזהרה, אך החיבור
ממשיך. אישור השרת אינו חייב להיות חתום על ידי אישור ספציפי כלשהו
סמכות ועשויה להיות תעודת "חתומה עצמית". אם אפשרות שורת הפקודה --sslcertck
או בשימוש באפשרות sslcertck run control file, fetchmail במקום זאת יבטל אם אחד מאלה
בדיקות נכשלות, כי היא חייבת להניח שיש בזה התקפת איש-באמצע
תרחיש, לפיכך אסור ל-fetchmail לחשוף סיסמאות ברורות. שימוש ב-sslcertck or
לכן מומלץ להשתמש באפשרות --sslcertck.

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

מילה של דאגה לגבי השימוש ב-SSL: בעוד שהוזכר לעיל הגדרה עם שרת חתום עצמי
אישורים שנשלפו על החוטים יכולים להגן עליך מפני מצותת פסיבית, זה
לא עוזר נגד תוקף פעיל. ברור שזה שיפור לעומת שליחת ה
סיסמאות ברורות, אך עליך להיות מודע לכך שהתקפה של אדם באמצע היא טריוויאלית
אפשרי (במיוחד עם כלים כגון dsniff ⟨http://monkey.org/~dugsong/dsniff/⟩, ).
שימוש בבדיקת תעודות קפדנית עם רשות אישורים המוכרת על ידי שרת ו
לקוח, או אולי של מנהרת SSH (ראה להלן כמה דוגמאות) עדיף אם אתה
דואגים ברצינות לאבטחת תיבת הדואר והסיסמאות שלך.

ESMTP AUTH
fetchmail תומך גם באימות לשרת ESMTP בצד הלקוח לפי
RFC 2554. אתה יכול לציין זוג שם/סיסמה לשימוש עם מילות המפתח 'esmtpname'
ו-'esmtppassword'; הראשון מוגדר כברירת מחדל בשם המשתמש של המשתמש המתקשר.

דיימון MODE

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

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

דוגמה: פשוט קורא

fetchmail -d 900

לכן, יסקר את כל המארחים המתוארים ברשומה שלך ~/.fetchmailrc קובץ (חוץ מאלה
לא נכלל במפורש עם הפועל 'דלג') קצת פחות מפעם אחת בכל 15 דקות
(בדיוק: 15 דקות + זמן שהסקר לוקח).

אפשר גם להגדיר מרווח סקרים ב- שלך ~/.fetchmailrc קובץ באמירה
'קבע דמון ', איפה הוא מספר שלם של שניות. אם אתה כן
זה, fetchmail תמיד יתחיל במצב daemon אלא אם תעקוף אותו עם הפקודה-
אפשרות קו --daemon 0 או -d0.

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

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

סיום מה היא רקע דמון
האפשרות --לְהַפְסִיק יהרוג תהליך דמון פועל במקום להעיר אותו (אם יש
אין תהליך כזה, fetchmail יודיע לך). אם האפשרות --quit מופיעה אחרונה ב-
שורת פקודה, fetchmail יהרוג את תהליך הדמון הפועל ואז ייסגר. אחרת,
fetchmail יהרוג תחילה תהליך דמון פועל ולאחר מכן ימשיך לרוץ עם ה-
אפשרויות אחרות.

מוֹעִיל אפשרויות ל דמון מצב
השמיים -L or --קובץ לוג אפשרות (מילת מפתח: הגדר קובץ לוג) יעילה בלבד
כאשר fetchmail מנותק ובמצב daemon. ציין זאת מה היא קובץ לוג צריך להתקיים לפני
fetchmail מופעל, אתה יכול להשתמש ב- לגעת(1) פקודה עם שם הקובץ כארגומנט היחיד שלו
ליצור אותו.
אפשרות זו מאפשרת לך להפנות מחדש הודעות סטטוס לקובץ יומן מוגדר (עקוב אחר ה
אפשרות עם שם קובץ היומן). קובץ היומן נפתח להוספה, אז הודעות קודמות
לא נמחקים. זה שימושי בעיקר עבור ניפוי תצורות. ציין זאת
fetchmail אינו מזהה אם קובץ היומן מסובב, קובץ היומן נפתח רק פעם אחת כאשר
fetchmail מתחיל. עליך להפעיל מחדש את fetchmail לאחר סיבוב קובץ היומן ולפני כן
דחיסה (אם רלוונטי).

השמיים --syslog אפשרות (מילת מפתח: הגדר syslog) מאפשרת לך להפנות מחדש הודעות מצב והודעות שגיאה
שנפלט ל syslog(3) דמון המערכת אם זמין. הודעות נרשמות עם מזהה של
fetchmail, המתקן LOG_MAIL, וסדרי עדיפויות LOG_ERR, LOG_ALERT or LOG_INFO. זֶה
האפשרות מיועדת לרישום סטטוס והודעות שגיאה המציינות את המצב של
daemon והתוצאות בזמן שליפת דואר מהשרת/ים. הודעות שגיאה עבור פקודה
אפשרויות קו וניתוח של .fetchmailrc הקובץ עדיין נכתב ל-stderr, או ל-
קובץ היומן שצוין. ה --nosyslog אפשרות מכבה את השימוש ב syslog(3), בהנחה שכן
מופעל ב- ~/.fetchmailrc קוֹבֶץ. אפשרות זו מבוטלת, במצבים מסוימים,
by --קובץ לוג (אשר רואים).

השמיים -N or --צמתים אפשרות מדכאת רקע וניתוק של תהליך הדמון
ממסוף הבקרה שלו. זה שימושי עבור ניפוי באגים או כאשר fetchmail פועל בתור
ילד של תהליך מפקח כגון init(8) או של חריט פאפ תריץ את זה(8). שימו לב שזה
גם גורם להתעלמות מאפשרות ה-logfile.

שים לב שבזמן הפעלה במצב דמון סקר שרת POP2 או IMAP2bis, שגיאות חולפות
(כגון כשלים ב-DNS או סירובים למשלוח דואר) עלולים לאלץ את אפשרות ה-fetchall להפעיל עבור
משך מחזור הסקרים הבא. זוהי תכונת חוסן. זה אומר שאם א
ההודעה נלקחת (ולכן מסומנת כששרת הדואר נראית) אך לא נמסרת באופן מקומי בשל
לשגיאה חולפת כלשהי, הוא יובא מחדש במהלך מחזור הסקר הבא. (ה-IMAP
לוגיקה לא מוחקת הודעות עד שהן נשלחות, אז בעיה זו לא מתעוררת.)

אם תיגע או תשנה את ~/.fetchmailrc קובץ בזמן ש-fetchmail פועל במצב daemon,
זה יתגלה בתחילת מחזור הסקר הבא. כאשר השתנה
~/.fetchmailrc מזוהה, fetchmail קורא אותו מחדש ומתחיל מחדש מאפס (באמצעות Exec(2);
לא נשמר מידע על המדינה במקרה החדש). שימו לב שאם צריך fetchmail
שאילתה עבור סיסמאות, של זה אם אתה שובר את ~/.fetchmailrc תחביר הקובץ, החדש
מופע ייעלם ברכות ובשקט בעת ההפעלה.

מנהלי אפשרויות

השמיים --מְנַהֵל דוֹאָר אפשרות (מילת מפתח: הגדר postmaster) מציינת את המוצא האחרון
שם משתמש שאליו יש להעביר דואר רב-דרופ אם לא יכול להיות נמען מקומי תואם
מצאתי. הוא משמש גם כיעד של דואר שלא ניתן למסירה אם ה'דואר חוזר' גלובלי
האפשרות כבויה ובנוסף לדואר חסום דואר זבל אם האפשרות הגלובלית 'דואר חוזר' היא
כבוי והאפשרות הגלובלית 'ספאם' מופעלת. אפשרות זו מוגדרת כברירת מחדל למשתמש שהפעיל
fetchmail. אם המשתמש המזמין הוא root, אז ברירת המחדל של אפשרות זו היא המשתמש
'מְנַהֵל דוֹאָר'. הגדרת postmaster למחרוזת הריקה גורמת לדואר כזה כמתואר לעיל
להיזרק - עם זאת, זה בדרך כלל רעיון רע. ראה גם את התיאור של
משתנה הסביבה 'FETCHMAILUSER' בסעיף ENVIRONMENT להלן.

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

השמיים --בלתי נראה option (מילת מפתח: set invisible) מנסה להפוך את fetchmail לבלתי נראה.
בדרך כלל, fetchmail מתנהג כמו כל MTA אחר -- הוא יוצר כותרת Received
לכל הודעה המתארת ​​את מקומה בשרשרת השידור, ואומרת זאת ל-MTA
מעביר לזה שהדואר הגיע מהמחשב fetchmail עצמו פועל. אם ה
האפשרות בלתי נראה מופעלת, הכותרת Received מדוכאת ו-fetchmail מנסה לזייף את
MTA זה מעביר לחשוב שזה הגיע ישירות מהמארח של שרת הדואר.

השמיים --נקודות שואו אפשרות (מילת מפתח: הגדר נקודות שואו) מאלצת את fetchmail להציג אפילו נקודות התקדמות
אם הפלט עובר לקובץ או ש-fetchmail אינו במצב מילולי. Fetchmail מציג את
נקודות כברירת מחדל כאשר הם פועלים במצב --verbose ו הפלט עובר לקונסולה. אפשרות זו היא
התעלמו במצב --שקט.

על ידי ציון ה -- סקרי עקבות אפשרות, אתה יכול לבקש מ-fetchmail להוסיף מידע ל-
הכותרת שהתקבלה בטופס "חשבון {תווית} סקר {משתמש}", כאשר {תווית} הוא החשבון
תווית (מתוך rcfile שצוין, בדרך כלל ~/.fetchmailrc) ו-{user} הוא שם המשתמש
המשמש לכניסה לשרת הדואר. ניתן להשתמש בכותרת זו לביצוע סינון
דוא"ל שבו אין מידע כותרת שימושי זמין ואתה רוצה דואר שונה
חשבונות ממוינים בתיבות דואר שונות (זה יכול, למשל, להתרחש אם יש לך
חשבון באותו שרת שמפעיל רשימת דיוור, והם רשומים לרשימה באמצעות
החשבון הזה). ברירת המחדל היא לא להוסיף כותרת כזו. ב .fetchmailrc, זה נקרא
'סקרי עקב'.

שְׁלִיפָה כישלון מצבים

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

עם זאת, בעת העברה למד"א, יש יותר סיכוי לטעות. כמה מד"א כן
'בטוח' ולהחזיר באופן אמין סטטוס שאינו אפס על כל שגיאת מסירה, אפילו אחת עקב
מגבלות משאבים זמניות. ה מיילדרופ(1) התוכנית היא כזו; כך גם רוב התוכניות
מעוצבים כסוכני הובלת דואר, כגון שלח מייל(1), כולל עטיפת sendmail של
Postfix ו אקסים(1). תוכניות אלה מחזירות הכרה חיובית אמינה ויכולות
לשמש עם אפשרות mda ללא סיכון לאובדן דואר. עם זאת, מד"א לא בטוח עלול להחזיר 0
אפילו על כשל מסירה. אם זה יקרה, תאבד דואר.

המצב הרגיל של fetchmail הוא לנסות להוריד רק הודעות 'חדשות', להשאיר ללא נגיעה
(ובוטלו) הודעות שכבר קראת ישירות בשרת (או שלפת עם א
קודם fetchmail --לִשְׁמוֹר). אבל אתה עשוי לגלות שהודעות שכבר קראת ב-
שרת נשלפים (ונמחקים) גם כאשר אתה לא מציין --all. יש
כמה סיבות שזה יכול לקרות.

אחד יכול להיות שאתה משתמש ב-POP2. פרוטוקול POP2 אינו כולל ייצוג של
מצב 'חדש' או 'ישן' בהודעות, אז fetchmail חייב להתייחס לכל ההודעות כחדשות כל
זְמַן. אבל POP2 מיושן, אז זה לא סביר.

בעיית POP3 אפשרית עשויה להיות שרתים שמכניסים הודעות באמצע תיבות הדואר
(לפי השמועות יש מימושי VMS של דואר שעושים זאת). ה fetchmail הקוד מניח
שהודעות חדשות מצורפות לקצה תיבת הדואר; כשזה לא נכון זה עלול
להתייחס לכמה הודעות ישנות כחדשות ולהיפך. שימוש ב-UIDL תוך הגדרת fastuidl 0 עשוי
תקן זאת, אחרת, שקול לעבור ל-IMAP.

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

קוד ה-IMAP משתמש בנוכחות או בהיעדר דגל השרת \Seen כדי להחליט אם או
אין הודעה חדשה. זה לא הדבר הנכון לעשות, fetchmail צריך לבדוק את
UIDVALIDITY והשתמש ב-UID, אבל זה עדיין לא עושה את זה. תחת Unix, זה נסמכת על ה-IMAP שלך
שרת להבחין בדגלי הסטטוס בסגנון BSD שהוגדרו על ידי סוכני משתמשי דואר ולהגדיר את הדגל \Seen
מהם כשמתאים. כל שרתי ה-IMAP של Unix שאנו מכירים עושים זאת, אם כי זה לא
שצוין על ידי IMAP RFCs. אם אי פעם תמעד על שרת שלא, הסימפטום יעשה זאת
להיות שהודעות שכבר קראת במארח שלך ייראו חדשות בשרת. בזה
מקרה (לא סביר), רק הודעות שאיתן איתן fetchmail --לִשְׁמוֹר שניהם יבוטלו
ומסומן ישן.

במצבי ETRN ו-ODMR, fetchmail לא ממש מאחזר הודעות; במקום זאת, הוא שואל
מאזין ה-SMTP של השרת כדי להתחיל הורדת תור ללקוח באמצעות SMTP. לכן זה
שולח רק הודעות שלא נמסרו.

דואר זבל סינון

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

גרסאות חדשות יותר של שלח מייל החזר קוד שגיאה של 571.

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

גרסאות ישנות יותר של אקסים MTA return 501 "שגיאת תחביר בפרמטרים או ארגומנטים".

השמיים פוסט MTA מפעיל את 554 כתגובה נגד ספאם.

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

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

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

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

אם דואר זבל האפשרות הגלובלית מופעלת, דואר שחסם דואר זבל מפעיל an
הודעת הקפצה RFC1892/RFC1894 המודיעה למקור כי איננו מקבלים דואר מ
זה. ראה גם באגים.

SMTP/ESMTP ERROR מטפל

מלבד חסימת הספאם המתוארת לעיל, fetchmail נוקטת בפעולות מיוחדות - אולי
שונה על ידי האפשרות --softbounce — בקודי תגובת השגיאה הבאים של SMTP/ESMTP

452 (אחסון מערכת לא מספיק)
השאר את ההודעה בתיבת הדואר של השרת לאחזור מאוחר יותר.

552 (ההודעה חורגת מגודל ההודעה המקסימלי הקבוע)
מחק את ההודעה מהשרת. שלח דואר חוזר למקור.

553 (דומיין שולח לא חוקי)
מחק את ההודעה מהשרת. אל תנסה אפילו לשלוח דואר חוזר ל-
יוֹזֵם.

שגיאות אחרות גדולות או שוות ל-500 מפעילות דואר חוזר למקור, אלא אם כן
מדוכא על ידי --softbounce. ראה גם באגים.

LA לָרוּץ בקרה לפני ואחרי הטיפול קובץ

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

כדי להגן על אבטחת הסיסמאות שלך, שלך ~/.fetchmailrc ייתכן שבדרך כלל אין יותר
מ-0700 (u=rwx,g=,o=) הרשאות; fetchmail יתלונן ויצא אחרת (זה
הסימון מדוכא כאשר --version פועל).

אתה יכול לקרוא את .fetchmailrc קובץ כרשימה של פקודות שיש לבצע כאשר fetchmail is
התקשר ללא ויכוחים.

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

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

כל כמות של רווחים מפרידים בין אסימונים בכניסות שרת, אך מתעלמים ממנה. אתה
עשוי להשתמש ברצפי בריחה לאחור (\n עבור LF, \t עבור HT, \b עבור BS, \r עבור CR, \nnn ל
עשרוני (כאשר nnn לא יכול להתחיל עם 0), \0ooo עבור אוקטלי, ו-\xhh עבור hex) כדי להטביע
תווים שאינם ניתנים להדפסה או תווי מחרוזת במחרוזות. במחרוזות מובאות, קו נטוי לאחור
ממש בסוף שורה יגרום לאחור עצמו ולהזנת השורה (LF או NL, חדש
line) תו שיש להתעלם ממנו, כדי שתוכל לעטוף מחרוזות ארוכות. ללא קו נטוי ב
בסוף השורה, תו הזנת השורה יהפוך לחלק מהמחרוזת.

אַזהָרָה: בעוד אלה דומים לרצפי בריחה בסגנון C, הם אינם זהים. fetchmail
תומך רק בשמונה הסגנונות הללו. C תומך ברצפי בריחה נוספים המורכבים מהם
קו נטוי אחורי (\) ותו בודד, אך אינו תומך בקודים עשרוניים ואינו
דורשים את ה-0 המוביל בסימון אוקטלי. דוגמה: fetchmail מפרש את \233 אותו דבר כמו
\xE9 (אות קטנה בלטינית e עם חריפה), כאשר C יפרש את \233 כאוקטלי 0233 = \x9B
(CSI, מציג רצף בקרה).

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

עבור תאימות לאחור, המילה 'שרת' היא מילה נרדפת ל'סקר'.

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

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

מילת מפתח/אפשרות <br> סיכום
להלן האפשרויות המשפטיות. סיומות של מילות מפתח המוקפות בסוגריים מרובעים הן אופציונליות.
אלה המתאימות לאפשרויות שורת פקודה קצרות עוקבות אחרי '-' והמתאימה
מכתב אופציה. אם האפשרות רלוונטית רק למצב פעולה בודד, היא מצוינת כ
's' או 'm' עבור מצב טיפה בודדת או ריבוי ירידה, בהתאמה.

להלן האפשרויות הגלובליות החוקיות:

פונקציית מצב אופטימיזציה של מילות מפתח
────────────────────────────────────────────────── ──────────────────
set daemon -d הגדר מרווח סקר רקע ב
שניות.
set postmaster תן את שם המוצא האחרון
נמען דואר (ברירת מחדל: משתמש
הפעלת fetchmail, "postmaster" if
מופעל על ידי משתמש השורש)
הגדר bouncemail דואר שגיאה ישיר לשולח
(ברירת מחדל)
set no bouncemail דואר שגיאה ישיר למקומון
מנהל הדואר (לפי ה
אפשרות גלובלית 'פוסט מאסטר' למעלה).
set no spambounce אל תחזיר דואר חסום דואר זבל
(בְּרִירַת מֶחדָל).
set spambounce דואר חסום דואר חסום דואר חסום
(לפי המשתמש 'אנטי ספאם'
אפשרות) חזרה אל היעד כ
מסומן על ידי 'דואר חוזר'
אפשרות גלובלית. אזהרה: אל תעשה
השתמש בזה כדי להחזיר אליו דואר זבל
השולח - רוב הספאם נשלח
עם כתובת שולח כוזבת וכך
אפשרות זו פוגעת בחפים מפשע
עוברי אורח.
set no softbounce מחק בלתי ניתן למסירה לצמיתות
דוֹאַר. מומלץ להשתמש
אפשרות זו אם התצורה
נבדק ביסודיות.
הגדר softbounce שמור לא ניתן למסירה לצמיתות
דואר כאילו שגיאה זמנית
התרחש (ברירת מחדל).
set logfile -L שם של קובץ להוספת שגיאה ו
הודעות סטטוס ל. רק
יעיל במצב דמון ואם
fetchmail מתנתק. אם יעיל,
מבטל סט syslog.
set idfile -i שם הקובץ לאחסון UID
רשימות ב.
set syslog בצע שגיאה בכניסה
syslog(3). עשוי להיות עוקף על ידי סט
קובץ לוג.

set no syslog כבה את שגיאת הכניסה
syslog(3). (בְּרִירַת מֶחדָל)
הגדר מאפיינים ערך מחרוזת שמתעלם ממנו
fetchmail (עשוי לשמש על ידי
סקריפטים של הרחבה).

להלן אפשרויות השרת החוקיות:

פונקציית מצב אופטימיזציה של מילות מפתח
────────────────────────────────────────────────── ───────────────
דרך ציין את שם ה-DNS של שרת הדואר,
עוקף את שם הסקר
proto[col] -p ציין פרוטוקול (מקרה
לא רגיש): POP2, POP3, IMAP,
APOP, KPOP
local[domains] m ציין דומיינים שיש להתייחס אליהם
בתור מקומי
יציאה ציין יציאת שירות TCP/IP
(מיושן, השתמש ב'שירות' במקום זאת).
service -P ציין את שם השירות (מספרי
ערך מותר גם ו
נחשב למספר יציאת TCP/IP).
auth[enticate] הגדר סוג אימות (ברירת מחדל
'כל')
פסק זמן -t פסק זמן של חוסר פעילות שרת ב
שניות (ברירת מחדל 300)
מעטפה -E m ציין את הכותרת של כתובת המעטפה
שם
ללא מעטפה ז השבת את החיפוש אחר מעטפה
כתובת
qvirtual -Q m Qmail קידומת דומיין וירטואלי ל
להסיר משם משתמש
aka m ציין שמות DNS חלופיים של
שרת דואר
ממשק -אני מציין ממשקי IP שחייבים
להיות מוכן לסקר שרת
מקום
monitor -M ציין כתובת IP למעקב
פעילות
תוסף ציין פקודה שדרכה
ליצור חיבורי שרת.
plugout ציין פקודה שדרכה
ליצור קשרי מאזינים.
dns m הפעל חיפוש DNS עבור ריבוי דרופ
(ברירת מחדל)
no dns m השבת את חיפוש ה-DNS עבור ריבוי דרופ
checkalias m עשה השוואה לפי כתובת IP עבור
multidrop
ללא צ'קאליים מ. עשה השוואה לפי שם עבור
multidrop (ברירת מחדל)
uidl -U כפה על POP3 להשתמש בצד הלקוח
UIDLs (מומלץ)
no uidl כבה את השימוש ב-POP3 בצד הלקוח
UIDLs (ברירת מחדל)
מרווח בדוק רק את האתר הזה בכל סקר N
מחזורים; N הוא ארגומנט מספרי.
tracepolls הוסף מידע על מעקב אחר סקר
הכותרת שהתקבלה
מנהל הגדר את מנהלת Kerberos (בלבד
שימושי עם IMAP ו-kerberos)
esmtpname הגדר שם עבור RFC2554
אימות ל-ESMTP
שרת.
esmtppassword הגדר סיסמה עבור RFC2554
אימות ל-ESMTP
שרת.

bad-header כיצד להתייחס להודעות עם רע
כּוֹתֶרֶת. ניתן לדחות (ברירת מחדל) או
לקבל.

להלן תיאורי המשתמש החוקיים והאפשרויות:

פונקציית מצב אופטימיזציה של מילות מפתח
────────────────────────────────────────────────── ─────────────────
user[name] -u זהו תיאור המשתמש ו
חייב לבוא ראשון אחרי השרת
תיאור ואחרי אפשרי
אפשרויות שרת, ולפני המשתמש
אפשרויות.
זה מגדיר את שם המשתמש המרוחק אם על ידי
עצמו או ואחריו 'שם', או
שם המשתמש המקומי אם אחריו
'פה'.
הוא Connect משתמש מקומי ומרוחק
שמות
לחיבור משתמש מקומי ומרוחק
שמות
pass[word] ציין סיסמת חשבון מרוחק
ssl התחבר לשרת דרך
פרוטוקול בסיס שצוין באמצעות SSL
הצף
sslcert ציין קובץ עבור לקוחות צד
תעודת SSL ציבורית
sslcertfile ציין קובץ עם CA מהימן
תעודות
sslcertpath ציין את ספריית c_rehash-ed עם
אישורי CA מהימנים.
sslkey ציין קובץ עבור לקוחות צד
מפתח SSL פרטי
sslproto Force ssl פרוטוקול לחיבור
תיקייה -r ציין תיקיה מרוחקת לשאילתה
smtphost -S ציין מארחי smtp להעברתם
fetchdomains m ציין דומיינים עבור איזה דואר
צריך להביא
smtpaddress -D ציין את הדומיין שיש להכניס אליו
RCPT TO קווים
smtpname ציין את המשתמש והדומיין
שים בקווים RCPT TO
antispam -Z ציין מהן החזרות SMTP
מתפרשים כחסימות מדיניות דואר זבל
mda -m ציין MDA למשלוח מקומי
bsmtp -o ציין קובץ אצווה BSMTP לצירוף
ל
פקודה חיבור מראש שתתבצע לפני כל אחת
הקשר
פקודה postconnect שתתבצע לאחר כל אחת
הקשר
keep -k אל תמחק הודעות שנראו מ
שרת (עבור POP3, uidl הוא
מוּמלָץ)
flush -F בטל את כל ההודעות שנראו בעבר
שאילתה (מסוכן)
limitflush לשטוף את כל ההודעות הגדולות
לפני שאילתה
fetchall -a אחזר את כל ההודעות בין אם נראו או
לֹא
שכתוב שכתוב כתובות יעד עבור
תשובה (ברירת מחדל)
stripcr עגלת רצועה חוזרת מהקצוות
של קווים
forcecr כוח כרכרה חוזרת בקצות
קווים

pass8bits כפה על BODY=8BITMIME ל-ESMTP
מאזין
dropstatus Strip Status ו-X-Mozilla-Status
שורות מתוך דואר נכנס
dropdelivered רצועה נמסרה-לקווים מחוץ
דואר נכנס
mimedecode המר ציטוטים להדפסה ל-8 סיביות
בהודעות MIME
סרק סרק ממתין להודעות חדשות
לאחר כל סקר (IMAP בלבד)
no keep -K מחק הודעות שנראו מהשרת
(ברירת מחדל)
no flush אל תבטל את כל ההודעות שנראו
לפני שאילתה (ברירת מחדל)
no fetchall אחזר רק הודעות חדשות
(ברירת מחדל)
אין לשכתב אל תכתוב מחדש כותרות
no stripcr אל תפשיט החזרות מרכבה
(ברירת מחדל)
no forcecr אל תאלץ החזרות מרכבה בשעה
EOL (ברירת מחדל)
אין pass8bits אל תאלץ את BODY=8BITMIME ל-ESMTP
מאזין (ברירת מחדל)
no dropstatus אל תפיל את כותרות הסטטוס
(ברירת מחדל)
no dropdelivered אל תפיל את הכותרות של Delivered-To
(ברירת מחדל)
no mimedecode אל תמיר ציטוטים-ניתנים להדפסה ל
8 סיביות בהודעות MIME (ברירת מחדל)
אין סרק אל תבטל מחכה לחדש
הודעות לאחר כל סקר (IMAP
בלבד)
limit -l הגדר מגבלת גודל הודעה
אזהרות -w הגדר מרווח אזהרה בגודל ההודעה
batchlimit -b מקסימום # הודעות להעברה
חיבור יחיד
fetchlimit -B מקסימום # הודעות לאחזור ביחיד
לְחַבֵּר
fetchsizelimit # גדלים מקסימליים של הודעות לאחזור
עסקה אחת
fastuidl השתמש בחיפוש בינארי עבור הראשון שלא נראה
הודעה (POP3 בלבד)
מחק -e בצע מחיקה בכל #
הודעה (IMAP ו-POP3 בלבד)
מאפיינים מערך המחרוזת מתעלם על ידי
fetchmail (עשוי לשמש על ידי
סקריפטים של הרחבה)

כל אפשרויות המשתמש חייבות להתחיל בתיאור משתמש (אפשרות משתמש או שם משתמש) ו לעקוב
כל תיאורי השרת והאפשרויות.

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

מילות מפתח לֹא תוֹאֵם ל אפשרות מתגים
האפשרויות 'תיקייה' ו-'smtphost' (בניגוד למקבילות שורת הפקודה שלהן) יכולות לקחת א
רשימה מופרדת ברווח או בפסיק של שמות שאחריהם.

כל האפשרויות מתאימות לארגומנטים הברורים של שורת הפקודה, מלבד הדברים הבאים: 'via',
'interval', 'aka', 'is', 'to', 'dns'/'no dns', 'checkalias'/'no checkalias', 'password',
'preconnect', 'postconnect', 'localdomains', 'stripcr'/'no stripcr', 'forcecr'/'no
forcecr', 'pass8bits'/'no pass8bits' 'dropstatus/no dropstatus', 'dropdelivered/no
dropdelivered', 'mimedecode/ללא mimedecode', 'ללא סרק' ו-'ללא מעטפה'.

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

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

סינגלדרופ לעומת Multidrop אפשרויות
אנא הקפד לקרוא את הסעיף שכותרתו LA להשתמש ו התעללות OF MULTIDROP תיבות דואר אם אתה
מתכוון להשתמש במצב ריבוי ירידה.

מילות המפתח 'יש' או 'אל' מקשרות את השמות המקומיים (הלקוח) הבאים (או שם השרת)
למיפויי שם לקוח מופרדים ב-=) עם שם המשתמש של שרת הדואר בערך. אם
ל-is/to list יש '*' כשם המשפחה שלו, שמות לא מזוהים פשוט מועברים. הערה
כי עד fetchmail גרסה 6.3.4 כולל, רשימות אלו יכולות להכיל רק חלקים מקומיים
של שמות משתמשים (fetchmail יסתכל רק על החלק שלפני הסימן @). fetchmail
גרסאות 6.3.5 ואילך תומכות בכתובות מלאות בצד שמאל של מיפויים אלה,
והם מקבלים עדיפות על פני כל 'localdomains', 'aka', 'via' או מיפויים דומים.

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

כאשר יש יותר משם מקומי אחד (או מיפוי שמות), fetchmail מסתכל על המעטפה
כותרת, אם מוגדרת, ואחרת בכותרות שהתקבל, אל, עותק ועותק מוסתר של אוחזר
דואר (זהו 'מצב multidrop'). הוא מחפש כתובות עם חלקי שם מארח התואמים
שם הסקר שלך או האפשרויות 'via', 'aka' או 'localdomains' שלך, ובדרך כלל גם עבור
חלקי שם מארח ש-DNS אומר לו שהם כינויים של שרת הדואר. ראה את הדיון ב
'dns', 'checkalias', 'localdomains' ו-'aka' לפרטים על אופן התאמת הכתובות
מטופל.

If fetchmail לא יכול להתאים לאף שמות משתמש של שרת דואר או כתובות מקומיות, הדואר יהיה
להקפיץ. בדרך כלל זה יוחזר לשולח, אבל אם ה-'bouncemail' גלובלי
האפשרות כבויה, הדואר יעבור למנהל הדואר המקומי במקום זאת. (ראה 'מנהל הדואר'
אפשרות גלובלית). ראה גם באגים.

האפשרות 'dns' (בדרך כלל פועלת) שולטת באופן שבו כתובות מתיבות דואר מרובות
בָּדוּק. פועל, זה מאפשר לוגיקה לבדוק כל כתובת מארח שאינה תואמת 'aka' או
הצהרת 'localdomains' על ידי חיפוש זה עם DNS. כאשר שם משתמש של שרת דואר הוא
מזוהה מצורף לחלק שם מארח תואם, המיפוי המקומי שלו מתווסף לרשימה של
נמענים מקומיים.

אפשרות ה-'checkalias' (כבוי בדרך כלל) מרחיבה את החיפושים שבוצעו על ידי מילת המפתח 'dns'
במצב multidrop, המספק דרך להתמודד עם MTAs מרוחקים המזהים את עצמם באמצעות
שמם הקנוני, בזמן שהם נשאלים באמצעות כינוי. כאשר שרת כזה מושאל,
בדיקות לחילוץ כתובת המעטפה נכשלות, וכן fetchmail חוזר למשלוח באמצעות
כותרות אל/עותק/עותק מוסתר (ראה להלן 'כותרות לעומת כתובות מעטפה'). ציון אפשרות זו
מורה fetchmail כדי לאחזר את כל כתובות ה-IP המשויכות לשני שם הסקר
והשם המשמש את ה-MTA המרוחק וכדי לבצע השוואה בין כתובות ה-IP. זֶה
שימושי במצבים שבהם השרת המרוחק עובר שם קנוני תכוף
שינויים, שאחרת ידרשו שינויים בקובץ rcfile. ל'checkalias' אין
אפקט אם 'אין dns' מצוין ב-rcfile.

אפשרות ה'aka' מיועדת לשימוש עם תיבות דואר מרובות. זה מאפשר לך להכריז מראש על רשימה
של כינויי DNS עבור שרת. זוהי פריצת אופטימיזציה המאפשרת לך לסחור בשטח
עבור מהירות. מתי fetchmail, תוך כדי עיבוד תיבת דואר רב-דרופ, חודר דרך ההודעה
כותרות שמחפשות את השמות של שרת הדואר, הכרזה מראש על שמות נפוצים יכולה להציל אותו
צריך לעשות חיפושי DNS. הערה: השמות שאתה נותן כארגומנטים ל-'aka' תואמים כ
סיומות -- אם תציין (נניח) 'aka netaxs.com', זה יתאים לא רק לשם מארח
netaxs.com, אבל כל שם מארח שמסתיים ב-'.netaxs.com'; כגון (נניח) pop3.netaxs.com
ו-mail.netaxs.com.

האפשרות 'localdomains' מאפשרת לך להכריז על רשימה של דומיינים ש-fetchmail צריך
לשקול מקומי. כאשר fetchmail מנתח שורות כתובת במצבי ריבוי ירידה, וכן א
קטע נגרר של שם מארח תואם לדומיין מקומי מוצהר, כתובת זו מועברת
דרך למאזין או למד"א ללא שינוי (מיפויי שמות מקומיים הם לֹא מיושם).

אם אתה משתמש ב-'localdomains', ייתכן שיהיה עליך לציין גם 'ללא מעטפה', אשר
משבית fetchmailהניסיון הרגיל של להסיק כתובת מעטפה מהשורה שהתקבלה
או כותרת X-Envelope-To או כל כותרת שהוגדרה בעבר על ידי 'מעטפה'. אם אתה
הגדר 'ללא מעטפה' בערך ברירת המחדל אפשר לבטל זאת בערכים בודדים
באמצעות 'מעטפה' '. כמקרה מיוחד, 'מעטפה "התקבלה"' משחזרת את
ניתוח ברירת מחדל של שורות שהתקבלו.

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

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

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

האפשרות 'forcecr' שולטת אם קווים המסתיימים על ידי LF בלבד מקבלים CRLF
סיום לפני העברה. באופן קפדני RFC821 דורש זאת, אך מעט MTAs
לאכוף את הדרישה כך שהאפשרות הזו בדרך כלל כבויה (רק MTA אחד כזה, qmail, נמצא בפנים
שימוש משמעותי בזמן הכתיבה).

האפשרות 'stripcr' שולטת אם החזרות עגלה יוסרו מהדואר שאוחזר
לפני שהוא מועבר. בדרך כלל אין צורך להגדיר זאת, כי זה כברירת מחדל
'מופעל' (הפשטת CR מופעלת) כאשר יש מד"א מוצהר אך 'כבוי' (הפשטת CR
מושבת) כאשר ההעברה מתבצעת באמצעות SMTP. אם 'stripcr' וגם 'forcecr' פועלים, 'stripcr'
יעקוף.

האפשרות 'pass8bits' קיימת כדי להתמודד עם תוכניות דואר של מיקרוסופט שמטירות בטיפשות א
"קידוד העברת תוכן: 7 ביט" על הכל. עם אפשרות זו כבויה (ברירת המחדל) ו
כותרת כזו קיימת, fetchmail מכריז על BODY=7BIT למאזין בעל יכולת ESMTP; זֶה
גורם לבעיות עבור הודעות שמשתמשות בפועל במערכות תווים של 8-bit ISO או KOI-8, מה שכן
להיות משובש על ידי הסרת החלקים הגבוהים של כל התווים. אם 'pass8bits' פועל,
fetchmail נאלץ להכריז על BODY=8BITMIME לכל מאזין בעל יכולת ESMTP. אם ה
המאזין הוא 8 סיביות נקי (כמו כל הגדולים עכשיו) הדבר הנכון יהיה כנראה
תוֹצָאָה.

האפשרות 'דרופסטטוס' שולטת אם שורות סטטוס ו-X-Mozilla-Status לא ריקות
נשמר בדואר שנלקח (ברירת המחדל) או נמחק. שמירה עליהם מאפשרת ל-MUA שלך
ראה אילו הודעות (אם בכלל) סומנו שנראו בשרת. מצד שני, זה יכול
לבלבל כמה מודיעי דואר חדש, אשר מניחים שכל דבר שיש בו שורת סטטוס
נראה. (הערה: שורות המצב הריקות שהוכנסו על ידי כמה שרתי POP באגים הם
נזרק ללא תנאי.)

האפשרות 'דרופ-delivered' שולטת אם הכותרות של Delivered-To יישמרו באחזור
דואר (ברירת המחדל) או נמחק. כותרות אלו מתווספות על ידי שרתי דואר Qmail ו-Postfix
על מנת להימנע מלולאות דואר אך עלול להפריע לך אם תנסה "לשקף" שרת דואר
בתוך אותו תחום. השתמש בזהירות.

האפשרות 'mimedecode' שולטת אם הודעות MIME משתמשות בקידוד הניתן להדפסה בציטוטים
מומרים אוטומטית לנתונים טהורים של 8 סיביות. אם אתה שולח דואר ל-ESMTP-
מאזין בעל יכולת נקייה של 8 סיביות (שכוללת את כל ה-MTAs העיקריים כמו sendmail), ואז
זה ימיר באופן אוטומטי כותרות ונתונים של הודעות ניתנות להדפסה לנתונים של 8 סיביות,
מה שמקל על ההבנה בעת קריאת דואר. אם תוכנות הדואר האלקטרוני שלך יודעות להתמודד
עם הודעות MIME, אין צורך באפשרות זו. אפשרות mimedecode כבויה ב
ברירת מחדל, כי ביצוע המרת RFC2047 בכותרות זורקת מידע על ערכת תווים
ויכול להוביל לתוצאות רעות אם הקידוד של הכותרות שונה מהקידוד של הגוף.

אפשרות ה'בטל' מיועדת לשימוש עם שרתי IMAP התומכים ב-RFC2177 IDLE
הרחבת פקודה, אך אינה דורשת זאת בהחלט. אם זה מופעל, ו-fetchmail
מזהה ש-IDLE נתמך, יונפק IDLE בסוף כל סקר. זה יהיה
אמור לשרת ה-IMAP להחזיק את החיבור פתוח ולהודיע ​​ללקוח כאשר דואר חדש מגיע
זמין. אם IDLE אינו נתמך, fetchmail ידמה אותו על ידי הנפקה מעת לעת
לא. אם אתה צריך לסקור קישור לעתים קרובות, IDLE יכול לחסוך רוחב פס על ידי ביטול TCP/IP
מתחבר ורצפי LOGIN/LOGOUT. מצד שני, חיבור IDLE יאכל כמעט
כל הזמן של ה-fetchmail שלך, כי הוא לעולם לא ינתק את החיבור ויאפשר אחרים
סקרים שיתרחשו אלא אם השרת קצוב זמן קצוב ל-IDLE. זה גם לא עובד עם מרובה
תיקיות; רק התיקיה הראשונה אי פעם תישאל.

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

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

מזהי פרוטוקול חוקי לשימוש עם מילת המפתח 'פרוטוקול' הם:

אוטומטי (או AUTO) (מורשת, להסרה מהגרסה העתידית)
pop2 (או POP2) (מורשת, להסרה מהגרסה העתידית)
pop3 (או POP3)
sdps (או SDPS)
imap (או IMAP)
apop (או APOP)
kpop (או KPOP)

סוגי אימות משפטיים הם 'כל', 'סיסמה', 'kerberos', 'kerberos_v4', 'kerberos_v5'
ו-'gssapi', 'cram-md5', 'otp', 'msn' (רק עבור POP3), 'ntlm', 'ssh', 'external' (רק
IMAP). סוג 'סיסמה' מציין אימות באמצעות שידור רגיל של סיסמה
(הסיסמה עשויה להיות טקסט רגיל או כפופה להצפנה ספציפית לפרוטוקול כמו ב-CRAM-
MD5); 'קרברוס' מספר fetchmail כדי לנסות להשיג כרטיס Kerberos בתחילת כל אחד
שאילתה במקום, ושלח מחרוזת שרירותית כסיסמה; ו-'gssapi' אומר ל-fetchmail
כדי להשתמש באימות GSSAPI. עיין בתיאור של מילת המפתח 'הסמכה' למידע נוסף.

ציון 'kpop' מגדיר פרוטוקול POP3 על יציאה 1109 עם אימות Kerberos V4.
ברירות מחדל אלה עשויות להידרוס על ידי אפשרויות מאוחרות יותר.

יש כמה הצהרות אפשרויות גלובליות: 'הגדר קובץ יומן' ואחריו מחרוזת קובעת אותו הדבר
גלובלי שצוין על ידי --logfile. אפשרות שורת פקודה --logfile תעקוף זאת. הערה
ש--logfile יעיל רק אם fetchmail מנתק את עצמו מהמסוף ומה-
logfile כבר קיים לפני הפעלת fetchmail, והוא מחליף את --syslog במקרה זה.
כמו כן, 'set daemon' מגדיר את מרווח הסקר כפי ש--daemon עושה. ניתן לעקוף זאת על ידי א
שורת הפקודה --דימון אפשרות; במיוחד ניתן להשתמש ב--daemon 0 כדי לכפות חזית
פעולה. ההצהרה 'קבע postmaster' מגדירה את הכתובת שאליה דואר ריבוי זרוק
ברירת המחדל אם אין התאמות מקומיות. לבסוף, 'קבע syslog' שולח הודעות יומן אל
syslogd(8).

פיתרון FETCHMAIL

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

לפתרון תקלות שנגרמו על ידי חומרה, מצא את הרכיב הפגום ותקן או החלף
זה. השאלות הנפוצות של Sig11 ⟨http://www.bitwizard.nl/sig11/⟩ עשוי לעזור לך בפרטים.

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

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

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

קובץ `which fetchmail`

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

2. סביבת המעטפת שמתחילה את fetchmail צריכה לאפשר dump cores. המפתח הוא ה
"גודל ליבה (קובץ) מקסימלי" שבדרך כלל ניתן להגדיר עם כלי בשם "limit" או
"ulimit". עיין בתיעוד של המעטפת שלך לפרטים. בשריון הפופולרי,
"ulimit -Sc unlimited" יאפשר את dump הליבה.

3. אתה צריך להגיד גם ל-fetchmail לאפשר dump cores. כדי לעשות זאת, הפעל את fetchmail עם
מה היא -ד0 -v אפשרויות. לרוב קל יותר להוסיף גם --nosyslog -N גם כן.

לבסוף, אתה צריך לשחזר את ההתרסקות. אתה יכול פשוט להתחיל fetchmail מהספרייה
איפה הידור אותו על ידי הקלדה ./fetchmail, אז שורת הפקודה המלאה תתחיל עם
./fetchmail -Nvd0 --nosyslog ואולי תפרט את האפשרויות האחרות שלך.

לאחר הקריסה, הפעל את מאתר הבאגים שלך כדי להשיג את dump הליבה. מאתר הבאגים יהיה לעתים קרובות
GNU GDB, לאחר מכן תוכל להקליד (להתאים נתיבים לפי הצורך) gdb ./fetchmail fetchmail.core ו
לאחר מכן, לאחר הפעלת GDB וקרא את כל הקבצים שלו, הקלד אחזור מלא, תשמור את
פלט (העתק והדבק יתאים, העקיבה לאחור ייקרא על ידי אדם) ולאחר מכן הקלד להפסיק ל
לעזוב gdb. הערה: במערכות מסוימות, לקבצי הליבה יש שמות שונים, הם עשויים להכיל
מספר במקום שם התוכנית, או מספר ושם, אבל בדרך כלל יהיה לו "ליבה"
כחלק משמם.

אינטראקציה עִם RFC 822

כאשר מנסים לקבוע את כתובת המקור של הודעה, fetchmail מסתכל
כותרות לפי הסדר הבא:

נתיב החזרה:
שולח מחדש: (מתעלם אם הוא אינו מכיל @ או !)
השולח: (התעלם אם הוא אינו מכיל @ או !)
מתרעם-מאת:
מ:
להגיב ל:
כנראה-מאת:

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

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

ואז fetchmail מחפש את השורות Resent-To:, Resent-Cc: ו-Resent-Bcc:. אם הם
קיימים, הם צריכים להכיל את הנמענים הסופיים ושיהיה להם עדיפות על פניהם
To:/Cc:/Bcc: עמיתים. אם השורות Resent-* אינן קיימות, ה-To:, Cc:, Bcc: ו
כנראה-ל: מחפשים קווים. (הנוכחות של מתרעם-אל: משמעה זאת
האדם שהופנה על ידי הכתובת אל: כבר קיבל את העותק המקורי של
דוֹאַר.)

תְצוּרָה דוגמאות

שימו לב שלמרות שיש הצהרות סיסמאות בהרבה מהדוגמאות שלהלן,
זה בעיקר למטרות המחשה. אנו ממליצים לאחסן צמדי חשבון/סיסמה פנימה
קובץ $HOME/.netrc שלך, שבו ניתן להשתמש בהם לא רק על ידי fetchmail אלא על ידי FTP(1) ו
תוכניות אחרות.

הפורמט הבסיסי הוא:

בו שם שרת פרוטוקול נוהל שם משתמש שֵׁם סיסמא סיסמא

דוגמא:

poll pop.provider.net פרוטוקול pop3 שם משתמש "jsmith" סיסמה "secret1"

או, באמצעות כמה קיצורים:

סקר pop.provider.net proto pop3 משתמש "jsmith" סיסמת "secret1"

שרתים מרובים עשויים להיות רשומים:

סקר pop.provider.net פרוטו pop3 משתמש "jsmith" עובר את "secret1"
סקר other.provider.net proto pop2 משתמש "John.Smith" עובר את "My^Hat"

הנה אותה גרסה עם יותר רווח לבן וכמה מילות רעש:

סקר pop.provider.net פרוטו pop3
המשתמש "jsmith", עם סיסמה secret1, הוא "jsmith" כאן;
סקר other.provider.net פרוטו pop2:
המשתמש "John.Smith", עם הסיסמה "My^Hat", הוא "John.Smith" כאן;

אם אתה צריך לכלול רווח לבן במחרוזת פרמטר או להתחיל את האחרון עם מספר,
תחום את המחרוזת במירכאות כפולות. לכן:

סקר mail.provider.net עם פרוטו pop3:
למשתמש "jsmith" יש את הסיסמה "4u אבל אתה לא יכול לשחרר את זה"
האם jws כאן ורוצה את mda "/bin/mail"

ייתכן שיש לך תיאור שרת ראשוני שבראשו מילת המפתח 'ברירות מחדל' במקום
'סקר' ואחריו שם. רשומה כזו מתפרשת כברירת מחדל עבור כל השאילתות
להשתמש. זה עשוי להיחלף על ידי תיאורי שרת בודדים. אז אתה יכול לכתוב:

ברירת המחדל של proto pop3
משתמש "jsmith"
סקר pop.provider.net
להעביר את "סוד1"
סקר mail.provider.net
למשתמש "jjsmith" יש את הסיסמה "secret2"

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

poll pop.provider.net פרוטו pop3 יציאת 3111
המשתמש "jsmith" עם המעבר "secret1" הוא "smith" כאן
משתמש ג'ונס עם המעבר "secret2" הוא "jjones" כאן לשמור

זה משייך את שם המשתמש המקומי 'smith' עם שם המשתמש pop.provider.net 'jsmith' ו
שם המשתמש המקומי 'jjones' עם שם המשתמש pop.provider.net 'jones'. דואר עבור 'ג'ונס'
נשמר בשרת לאחר ההורדה.

כך נראית תצורת אחזור פשוטה עבור תיבת דואר מרובת שחרורים:

סקר pop.provider.net:
user maildrop with pass secret1 to golux 'hurkle'='happy' snark כאן

זה אומר שתיבת הדואר של החשבון 'maildrop' בשרת היא תיבת ריבוי דרופ, ו
שיש לנתח הודעות בו עבור שמות המשתמש 'golux', 'hurkle' ו-
'לחרבן'. זה מציין עוד של-'golux' ו-'snark' יש את אותו השם על הלקוח
כמו בשרת, אבל דואר עבור משתמש השרת 'hurkle' אמור להימסר למשתמש הלקוח
'שַׂמֵחַ'.

הערות זֶה fetchmail, עד גרסה 6.3.4, לא אפשרו מפרטים מלאים של user@domain
כאן, אלה לעולם לא יתאימו. fetchmail 6.3.5 ואילך תומך user@domain
מפרטים בצד שמאל של מיפוי משתמש.

הנה דוגמה לסוג אחר של חיבור ריבוי טיפות:

סקר pop.provider.net localdomains loonytoons.org toons.org
מעטפה X-Envelope-To
דואר של משתמש עם מעבר סוד1 ל-* כאן

זה גם אומר שתיבת הדואר של החשבון 'maildrop' בשרת היא תיבת ריבוי דרופ.
זה אומר ל-fetchmail שכל כתובת בדומיינים loonytoons.org או toons.org (כולל
כתובות תת-דומיין כמו '[מוגן בדוא"ל]') יש להעביר ל-
מאזין SMTP מקומי ללא שינוי. היזהר מלולאות דואר אם אתה עושה זאת!

הנה דוגמה לתצורה באמצעות ssh ואפשרות הפלאגין. השאילתות נעשות
ישירות על ה-stdin וה-stdout של imapd דרך ssh. שים לב שבהגדרה זו, IMAP
ניתן לדלג על אימות.

סקר mailhost.net עם פרוטו imap:
תוסף "ssh %h /usr/sbin/imapd" auth ssh;
משתמש esr הוא esr כאן

LA להשתמש ו התעללות OF MULTIDROP תיבות דואר

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

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

כותרת לעומת מעטפה כתובות
הבעיה הבסיסית היא ששרת הדואר שלך משליך דואר של כמה אנשים ב-a
תיבת דואר יחידה, ייתכן שזרקת מידע חיוני על מי כל אחד
פיסת הדואר הופנתה למעשה אל ('כתובת המעטפה', בניגוד לכותרת
כתובות בכותרות RFC822 To/Cc - ה-Bcc אינו זמין בקצה המקבל).
'כתובת מעטפה' זו היא הכתובת הדרושה לך על מנת לנתב מחדש דואר כראוי.

לִפְעָמִים fetchmail יכול להסיק את כתובת המעטפה. אם שרת הדואר MTA הוא שלח מייל
ולפריט הדואר היה רק ​​נמען אחד, ה-MTA יכתוב סעיף 'by/for'
שנותן את הנמען של המעטפה לתוך הכותרת שקיבלה. אבל זה לא עובד בצורה מהימנה
עבור MTAs אחרים, וגם לא אם יש יותר מנמען אחד. כברירת מחדל, fetchmail מחפש
כתובות מעטפה בשורות אלה; אתה יכול לשחזר ברירת מחדל זו באמצעות -E "Received" או
'התקבלה מעטפה'.

As a מוטב אלטרנטיבה, כמה מאזיני SMTP ו/או שרתי דואר מכניסים כותרת לכל אחד מהם
הודעה המכילה עותק של כתובות המעטפה. כותרת זו (כאשר היא קיימת) היא
לעתים קרובות 'X-Original-To', 'Delivered-To' או 'X-Envelope-To'. ההנחה של Fetchmail לגבי
ניתן לשנות זאת עם האפשרות -E או 'מעטפה'. שימו לב שכתיבת מעטפה
כותרת מהסוג הזה חושפת את שמות הנמענים (כולל נמענים בעותק עיוור) ל
כל מקבלי ההודעות, כך שהמעלה חייבת לאחסן עותק אחד של ההודעה לכל
נמען כדי להימנע מלהפוך לבעיית פרטיות.

Postfix, מאז גרסה 2.0, כותב כותרת X-Original-To: המכילה עותק של
מעטפה כפי שהתקבלה.

Qmail ו-Postfix בדרך כלל כותבים כותרת 'נשלח אל' עם מסירת ההודעה
את סליל הדואר והשתמש בו כדי להימנע מלולאות דואר. עם זאת, דומיינים וירטואליים של Qmail יקדמו
שם המשתמש עם מחרוזת התואמת בדרך כלל לדומיין של המשתמש. כדי להסיר קידומת זו
אתה יכול להשתמש באפשרות -Q או 'qvirtual'.

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

הערות זֶה a עתיד גרסה of fetchmail אולי להסיר אל/עותק ניתוח!

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

בעיה קשורה היא שכאשר אתה מעתיק הודעת דואר עיוור, המידע מוסתר
נשא רק ככתובת מעטפה (היא מוסרת מהכותרות בדואר השולח
שרת, כך ש-fetchmail יכול לראות אותו רק אם יש כותרת X-Envelope-To). לפיכך, עיוור-
העתקה למישהו שמקבל דואר דרך קישור multidrop fetchmail תיכשל אלא אם כן
מארח שרת הדואר כותב באופן שגרתי X-Envelope-To או כותרת מקבילה להודעות ב
טיפת הדואר שלך.

In לבסוף, דיוור רשימות ו עותק מוסתר דואר יכול רק לעבוד if מה היא שרת אתה מַקסִים
החל מ-

(1) חנויות אחד העתק of מה היא הודעה עבור מקבל in שֶׁלְךָ תחום ו

(2) רשום מה היא מעטפה מידע in a מיוחד כותרת (X-Original-To, הועבר ל,
X-Envelope-To).

טוב דרכים ל השתמש Multidrop תיבות דואר
ניתן להשתמש במספר שמות מקומיים לניהול רשימת תפוצה מצד הלקוח של a
fetchmail אוסף. נניח ששמך הוא 'esr', ואתה רוצה שניהם לאסוף את שלך
שלח ותחזק רשימת תפוצה בשם (נניח) "fetchmail-friends", ואתה רוצה לשמור
רשימת הכינויים במחשב הלקוח שלך.

בשרת שלך, אתה יכול לכינוי 'fetchmail-friends' ל'esr'; לאחר מכן, אצלך .fetchmailrc,
הצהיר 'לחברי fetchmail של esr כאן'. לאחר מכן, כאשר דואר כולל 'fetchmail-friends' as
כתובת מקומית מתקבלת, שם הרשימה יצורף לרשימת הנמענים
מאזין ה-SMTP שלך רואה. לכן הוא יעבור התרחבות כינוי מקומית. להיות בטוח ש
כלול 'esr' בהרחבת הכינוי המקומי של fetchmail-friends, אחרת לעולם לא תראה דואר
נשלח רק לרשימה. ודא גם שלמאזין שלך מוגדרת האפשרות "גם אני".
(אפשרות שורת הפקודה -oXm של sendmail או הצהרת OXm) כך שהשם שלך לא יוסר מ-
הרחבות כינוי בהודעות שאתה שולח.

עם זאת, הטריק הזה אינו חף מבעיות. אתה תתחיל לראות את זה כשתישלח הודעה
מגיע שממוען רק לרשימת תפוצה שאתה עושה לֹא הכריזו כמקומיים
שֵׁם. כל הודעה כזו תכלול כותרת 'X-Fetchmail-Warning' שנוצרת
כי fetchmail לא יכול למצוא שם מקומי חוקי בכתובות הנמענים. כגון
הודעות ברירת המחדל (כפי שתואר לעיל) נשלחות למשתמש המקומי הפועל
fetchmail, אבל לתוכנית אין דרך לדעת שזה בעצם הדבר הנכון.

רע דרכים ל התעללות Multidrop תיבות דואר
Multidrop תיבות דואר ו fetchmail משרת מספר משתמשים במצב daemon אין לערבב. ה
הבעיה, שוב, היא דואר מרשימות תפוצה, שבדרך כלל אין בהן אדם
כתובת הנמען על זה. אֶלָא אִם fetchmail יכול להסיק כתובת למעטפה, דואר כזה יהיה
לך רק לחשבון שמריץ fetchmail (כנראה root). כמו כן, משתמשים עיוורים הם
סביר להניח שלעולם לא יראה את הדואר שלהם בכלל.

אם אתה מתפתה להשתמש fetchmail לאחזר דואר עבור משתמשים מרובים ממייל בודד
זרוק דרך POP או IMAP, תחשוב שוב (וקרא שוב את הסעיף על כתובות כותרת ומעטפה
מֵעַל). זה יהיה חכם יותר פשוט לתת לדואר לשבת בתור של שרת הדואר ולהשתמש בו
מצבי ETRN או ODMR של fetchmail להפעלת שליחות SMTP מעת לעת (כמובן, זה אומר
עליך לבצע סקר בתדירות גבוהה יותר מתקופת התפוגה של שרת הדואר). אם אתה לא יכול
ארגן זאת, נסה להגדיר עדכון UUCP.

אם אתה בהחלט צריך השתמש ב-multidrop למטרה זו, ודא ששרת הדואר שלך כותב an
כותרת כתובת המעטפה ש-fetchmail יכול לראות. אחרת אתה יצטרך לאבד דואר וזה יצטרך
לחזור לרדוף אותך.

נְהִיגָה בִּמְהִירוּת מוּפרֶזֶת Up Multidrop בדיקה
בדרך כלל, כאשר מצהירים על מספר משתמשים fetchmail מחלץ כתובות נמענים כ
שתואר לעיל ובודק כל חלק מארח עם DNS כדי לראות אם זה כינוי של
שרת דואר. אם כן, מיפויי השמות המתוארים בהצהרת "ל...כאן" נעשים
והדואר שנמסר באופן מקומי.

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

גרביים

תמיכה בגרביים4/5 היא א לעבד זמן אפשרות תצורה. לאחר הידור, fetchmail
תמיד ישתמש בספריות הגרביים ובתצורה במערכת שלך, אין ריצה-
מתגי זמן ב-fetchmail - אבל אתה עדיין יכול להגדיר SOCKS: אתה יכול לציין איזה
קובץ התצורה SOCKS משמש ב- SOCKS_CONF משתנה הסביבה.

לדוגמה, אם רצית לעקוף את ה-proxy של SOCKS לגמרי ולהשתמש ב-fetchmail
להתחבר ישירות, אתה יכול פשוט להעביר SOCKS_CONF=/dev/null בסביבה, למשל
(הוסף את אפשרויות שורת הפקודה הרגילות שלך - אם קיימות - לסוף שורה זו):

env SOCKS_CONF=/dev/null fetchmail

יְצִיאָה קודים

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

קודי היציאה שהוחזרו על ידי fetchmail הם כדלקמן:

0 הודעה אחת או יותר אוחזרו בהצלחה (או, אם האפשרות -c הייתה
נבחרו, נמצאו ממתינים אך לא אוחזרו).

1 לא היה דואר שהמתין לאחזור. (ייתכן שעדיין היה דואר ישן ב-
שרת אך לא נבחר לאחזור.) אם אינך רוצה ש"אין דואר" יהיה שגיאה
condition (לדוגמה, עבור עבודות cron), השתמש במעטפת תואמת POSIX והוסף

|| [$? -eq 1 ]

לסוף שורת הפקודה fetchmail, שים לב שזה משאיר 0 ללא נגיעה, מפות 1
ל-0, וממפה את כל שאר הקודים ל-1. ראה גם פריט #C8 בשאלות הנפוצות.

2 אירעה שגיאה בעת ניסיון לפתוח שקע כדי לאחזר דואר. אם אתה
לא יודע מה זה שקע, אל תדאג בקשר לזה - פשוט התייחס לזה כאל
'שגיאה בלתי ניתנת לשחזור'. שגיאה זו יכולה להיות גם בגלל שפרוטוקול fetchmail רוצה
לשימוש אינו מופיע ב-/etc/services.

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

4 זוהתה שגיאת פרוטוקול קטלנית כלשהי.

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

6 לקובץ בקרת הריצה היו הרשאות שגויות.

7 אירעה מצב שגיאה שדווח על ידי השרת. יכול גם לירות אם fetchmail
תם הזמן הקצוב בזמן ההמתנה לשרת.

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

9 שלב אימות המשתמש נכשל מכיוון שהשרת הגיב "נעול תפוס". לְנַסוֹת
שוב לאחר הפסקה קצרה! שגיאה זו אינה מיושמת עבור כל הפרוטוקולים, וגם לא
עבור כל השרתים. אם לא מיושם עבור השרת שלך, "3" יוחזר במקום זאת,
ראה לעיל. עשוי להיות מוחזר כאשר מדברים עם qpopper או שרתים אחרים שיכולים
הגיבו ב"נעול תפוס" או טקסט דומה המכיל את המילה "נעול".

10 fetchmail ההפעלה נכשלה בעת ניסיון לפתוח יציאת SMTP או עסקה.

11 שגיאת DNS קטלנית. Fetchmail נתקל בשגיאה בעת ביצוע בדיקת DNS ב
אתחול ולא יכול היה להמשיך.

לא ניתן היה לפתוח קובץ אצווה 12 BSMTP.

13 הסקר הסתיים על ידי מגבלת אחזור (ראה את האפשרות --fetchlimit).

14 חיווי שרת תפוס.

23 שגיאה פנימית. אתה אמור לראות הודעה על שגיאה רגילה עם פרטים.

24 - 26, 28, 29
אלו הם קודים פנימיים ואסור להופיע חיצונית.

מתי fetchmail שאילתות יותר ממארח ​​אחד, סטטוס ההחזרה הוא 0 אם כל שאילתה בהצלחה
דואר שאוחזר. אחרת, מצב השגיאה המוחזר הוא של המארח האחרון שנשאל.

השתמש ב-fetchmail באופן מקוון באמצעות שירותי onworks.net