fetchmailconf - آنلاین در ابر

برنامه:

نام

fetchmail - واکشی نامه از یک سرور POP، IMAP، ETRN یا ODMR

خلاصه

fetchmail [گزینه...] [میل سرور ...]
fetchmailconf

شرح

fetchmail یک ابزار بازیابی و ارسال نامه است. نامه را از راه دور دریافت می کند
سرورهای پستی و آن را به سیستم تحویل ماشین محلی (مشتری) شما ارسال می کند. تو می توانی
سپس نامه های بازیابی شده را با استفاده از عوامل کاربر ایمیل معمولی مانند سگ(1) نارون قرمز(1) یا
پست(1) fetchmail ابزار را می توان در حالت شبح اجرا کرد تا به طور مکرر یک یا چند مورد نظرسنجی شود
سیستم ها در یک بازه زمانی مشخص

La fetchmail برنامه می تواند نامه را از سرورهایی که از هر یک از نامه های رایج پشتیبانی می کنند جمع آوری کند.
پروتکل های بازیابی: POP2 (میراثی که از نسخه بعدی حذف می شود)، POP3، IMAP2bis،
IMAP4 و IMAP4rev1. همچنین می تواند از پسوند ESMTP ETRN و ODMR استفاده کند. (RFC ها
توصیف همه این پروتکل ها در انتهای این صفحه راهنما فهرست شده است.)

در حالی که fetchmail اساساً برای استفاده بر روی پیوندهای TCP/IP درخواستی (مانند SLIP) در نظر گرفته شده است
یا اتصالات PPP)، همچنین ممکن است به عنوان یک عامل انتقال پیام برای سایت هایی مفید باشد که
به دلایل امنیتی از اجازه دادن به تراکنش های SMTP (با شروع فرستنده) با sendmail خودداری کنید.

پشتیبانی، عیب یابی
برای عیب یابی، ردیابی و اشکال زدایی، باید پرحرفی fetchmail را افزایش دهید
در واقع ببینید چه اتفاقی می افتد برای انجام این کار، لطفا اجرا کنید هر دو of la دو پیروی دستورات،
اضافه کردن تمام of la گزینه های شما می خواهید به طور معمول استفاده کنید.

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)، دارای دو
حالت های اساسی عملکرد برای هر حساب کاربری که از آن نامه ها را بازیابی می کند:
تک قطره- و چند قطره-حالت

در حالت تک قطره،
fetchmail فرض می کند که تمام پیام های موجود در حساب کاربر (صندوق پستی) در نظر گرفته شده است
برای یک گیرنده هویت گیرنده یا به صورت پیش‌فرض روی
کاربر محلی در حال اجرا fetchmail، یا باید به صراحت مشخص شود
در فایل پیکربندی

fetchmail زمانی که پیکربندی fetchmailrc حداکثر شامل حالت تک قطره باشد، از حالت تک قطره استفاده می کند
یک مشخصات کاربر محلی واحد برای یک حساب سرور معین.

در حالت چند قطره،
fetchmail فرض می کند که حساب سرور ایمیل در واقع حاوی نامه هایی است که برای آن در نظر گرفته شده است
هر تعداد گیرنده مختلف از این رو، fetchmail باید تلاش کرد استنباط کرد
"دریافت کننده پاکت" مناسب از سرصفحه های نامه هر پیام. در این
نحوه عملکرد، fetchmail تقریباً شبیه یک عامل انتقال نامه (MTA) است.

توجه داشته باشید که نه پروتکل های POP و نه IMAP برای استفاده در این روش در نظر گرفته نشده اند.
و از این رو اطلاعات پاکت اغلب به طور مستقیم در دسترس نیست. ISP باید
اطلاعات پاکت نامه را در برخی از هدر پیام ذخیره می کند و. ISP نیز باید ذخیره کند
یک کپی از پیام به ازای هر گیرنده در صورتی که هر یک از شرایط وجود ندارد
انجام شده، این فرآیند غیرقابل اعتماد است، زیرا fetchmail سپس باید متوسل شود
حدس زدن گیرنده(های) پاکت واقعی یک پیام. این معمولا برای
پیام‌های فهرست پستی و نامه‌های Bcc:d، یا نامه‌هایی برای چندین گیرنده در شما
دامنه.

fetchmail زمانی که بیش از یک کاربر محلی و/یا یک علامت عام وجود دارد از حالت چند قطره استفاده می کند
برای یک حساب سرور خاص در فایل پیکربندی مشخص شده است.

در حالت های ETRN و ODMR،
این ملاحظات اعمال نمی شود، زیرا این پروتکل ها بر اساس SMTP هستند که
اطلاعات صریح دریافت کننده پاکت را فراهم می کند. این پروتکل ها همیشه پشتیبانی می کنند
چندین گیرنده

با بازیابی هر پیام، fetchmail معمولاً آن را از طریق SMTP به پورت 25 بر روی آن تحویل می دهد
دستگاهی که روی آن در حال اجراست (localhost)، درست مثل اینکه در حال عبور از حالت عادی است
پیوند TCP/IP. fetchmail به سرور SMTP یک گیرنده پاکت نامه مشتق شده در
روشی که قبلا توضیح داده شد سپس نامه طبق MTA شما تحویل داده می شود
قوانین (معمولاً عامل انتقال نامه است ارسال پست الکترونیکی(8) exim(8) ، یا پسوند(8)). استناد کردن
MDA (نماینده تحویل نامه) سیستم شما وظیفه MTA شما است. تمام تحویل - کنترل
مکانیسم ها (مانند .رو به جلو فایل ها) معمولاً از طریق MTA و محلی سیستم شما در دسترس هستند
بنابراین عوامل تحویل طبق معمول اعمال خواهند شد.

اگر پیکربندی fetchmail شما یک MDA محلی تنظیم کند (گزینه --mda را ببینید)، از آن استفاده خواهد شد.
مستقیماً به جای مکالمه SMTP با پورت 25.

اگر برنامه fetchmailconf در دسترس است، به شما در راه اندازی و ویرایش a کمک می کند
پیکربندی fetchmailrc تحت سیستم پنجره X اجرا می شود و نیاز دارد که
زبان پایتون و جعبه ابزار Tk (با اتصالات پایتون) در سیستم شما وجود دارد. اگر
شما ابتدا fetchmail را برای حالت تک کاربره تنظیم می کنید، توصیه می شود از آن استفاده کنید
حالت مبتدی. حالت Expert کنترل کامل پیکربندی fetchmail از جمله
ویژگی های چند قطره ای در هر صورت، دکمه "Autoprobe" بیشتر به شما می گوید
پروتکل توانمندی که یک میل سرور معین پشتیبانی می کند و به شما در مورد مشکلات احتمالی آن هشدار می دهد
سرور

عمومی عمل

رفتار fetchmail توسط گزینه های خط فرمان و یک فایل کنترل اجرا کنترل می شود،
~/.fetchmailrc، نحوی که در بخش بعدی توضیح می دهیم (این فایل همان چیزی است که
fetchmailconf ویرایش برنامه). گزینه های خط فرمان لغو می شوند ~/.fetchmailrc اعلامیه ها

هر نام سروری که به دنبال گزینه های خط فرمان مشخص می کنید، خواهد بود
پرس و جو شد. اگر هیچ سروری را در خط فرمان مشخص نکرده‌اید، هر ورودی «نظرسنجی» در شما
~/.fetchmailrc فایل استعلام خواهد شد

برای تسهیل استفاده از fetchmail در اسکریپت ها و خطوط لوله، یک مقدار مناسب را برمی گرداند
کد خروج پس از پایان کار - کدهای خروج را در زیر ببینید.

گزینه های زیر رفتار را تغییر می دهند fetchmail. به ندرت لازم است مشخص شود
هر یک از این ها زمانی که شما کار می کنید .fetchmailrc تنظیم فایل

تقریباً همه گزینه ها دارای یک کلمه کلیدی متناظر هستند که می توان آنها را در a اعلام کرد
.fetchmailrc فایل.

برخی از گزینه‌های ویژه در اینجا پوشش داده نشده‌اند، اما در عوض در بخش‌های موجود مستند شده‌اند
AUTENTICATION و DAEMON MODE که در ادامه می آیند.

سوالات عمومی گزینه
-V | - نسخه
اطلاعات نسخه را برای کپی شما نمایش می دهد fetchmail. هیچ واکشی ایمیل وجود ندارد
انجام. در عوض، برای هر سرور مشخص شده، تمام اطلاعات گزینه ای که
محاسبه خواهد شد اگر fetchmail در حال اتصال به آن سرور نمایش داده می شود. هر
موارد غیر قابل چاپ در گذرواژه ها یا نام های رشته ای دیگر به صورت C-slashed نشان داده می شوند
سکانس های فرار این گزینه برای تأیید تنظیم بودن گزینه های شما مفید است
آنطور که شما آنها را می خواهید

-c | --بررسی
یک کد وضعیت برای نشان دادن اینکه آیا ایمیل در انتظار وجود دارد یا خیر، بازگردانید
واکشی یا حذف ایمیل (کدهای خروج را در زیر ببینید). این گزینه Daemon را خاموش می کند
حالت (که در آن بی فایده خواهد بود). با پرس و جوهای چندگانه خوب بازی نمی کند
سایت ها، و با ETRN یا ODMR کار نمی کند. اگر شما مثبت کاذب را برگردانید
نامه های خوانده شده اما حذف نشده را در صندوق پستی سرور خود بگذارید و پروتکل واکشی شما نمی تواند
پیام های نگهداری شده را از پیام های جدید بگویید. این بدان معنی است که با IMAP کار می کند، نه با
POP2، و گاهی اوقات ممکن است در زیر POP3 پوسته پوسته شود.

-s | --بی صدا
حالت بی صدا. تمام پیام‌های پیشرفت/وضعیت را که معمولاً به آنها بازتاب داده می‌شود، سرکوب می‌کند
خروجی استاندارد در حین واکشی (اما پیام های خطای واقعی را سرکوب نمی کند). در
گزینه --verbose این را لغو می کند.

-v | -- پرحرف
حالت پرمخاطب. همه پیام های کنترلی بین آنها ارسال شد fetchmail و میل سرور هستند
به stdout پژواک داد. لغو -- بی صدا. دوبرابر کردن این گزینه (-v -v) باعث اضافی می شود
اطلاعات تشخیصی باید چاپ شود

--nosoftbounce
(از نسخه 6.3.10، کلمه کلیدی: بدون softbounce تنظیم شود، از نسخه 6.3.10)
حالت پرش سخت. همه خطاهای تحویل دائمی باعث حذف پیام ها می شود
سرور بالادست، "بدون softbounce" را در زیر ببینید.

-- Softbounce
(از نسخه 6.3.10، کلمه کلیدی: تنظیم softbounce، از نسخه 6.3.10)
حالت پرش نرم. همه خطاهای تحویل دائمی باعث می شوند که پیام ها روی آن باقی بمانند
سرور بالادست اگر پروتکل از آن پشتیبانی کند. این انتخاب is on by به طور پیش فرض به
همخوانی داشتن تاریخی fetchmail مستندات، و به حالت جهش سخت تغییر خواهد کرد
نسخه fetchmail بعدی

در اختیار گزینه
-a | --همه | (از آنجا که v6.3.3) --فچال
(کلید واژه: fetchall، از نسخه 3.0)
هر دو پیام قدیمی (دیده شده) و جدید را از سرور ایمیل بازیابی کنید. پیش فرض به است
واکشی فقط پیام هایی که سرور علامت گذاری نکرده است. تحت POP3، این گزینه نیز وجود دارد
استفاده از RETR به جای TOP را مجبور می کند. توجه داشته باشید که بازیابی POP2 به گونه ای عمل می کند
--همه همیشه روشن است (حالت های شکست بازیابی را در زیر ببینید) و این گزینه ندارد
با ETRN یا ODMR کار کنید. در حالی که خط فرمان -a و --all و rcfile fetchall
گزینه ها برای مدت طولانی پشتیبانی می شوند، گزینه --fetchall خط فرمان بود
اضافه شده در نسخه 6.3.3.

-k | --نگاه داشتن
(کلید واژه: نگه داشتن)
پیام های بازیابی شده را در سرور پست الکترونیکی راه دور نگه دارید. به طور معمول، پیام ها حذف می شوند
پس از بازیابی آنها از پوشه موجود در میل سرور. مشخص کردن
نگه داشتن این گزینه باعث می شود که پیام های بازیابی شده در پوشه شما در سرور ایمیل باقی بماند.
این گزینه با ETRN یا ODMR کار نمی کند. در صورت استفاده با POP3، توصیه می شود
همچنین گزینه --uidl یا کلمه کلیدی uidl را مشخص کنید.

-K | -- نگهدار
(کلید واژه: 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 | -- پروتو | --پروتکل
(کلید واژه: proto[col])
پروتکل مورد استفاده در هنگام برقراری ارتباط با سرور پست الکترونیکی راه دور را مشخص کنید. اگر نه
پروتکل مشخص شده است، پیش فرض AUTO است. proto- ممکن است یکی از موارد زیر باشد:

AUTO IMAP، POP3، و POP2 را امتحان می کند (پرش از هر یک از این موارد که پشتیبانی از آنها انجام نشده است
گردآوری شده است).

POP2 Post Office Protocol 2 (موروثی، از نسخه بعدی حذف خواهد شد)

پروتکل 3 اداره پست POP3

APOP از POP3 با احراز هویت قدیمی چالش MD5 استفاده کنید. در نظر گرفته نشده است
مقاوم در برابر حملات انسان در وسط

RPOP از POP3 با احراز هویت RPOP استفاده کنید.

KPOP از POP3 با احراز هویت Kerberos V4 در پورت 1109 استفاده کنید.

SDPS از POP3 با پسوندهای SDPS اینترنت شیطان استفاده کنید.

IMAP IMAP2bis، IMAP4، یا IMAP4rev1 (fetchmail به طور خودکار آنها را شناسایی می کند
توانایی ها).

ETRN از گزینه ESMTP ETRN استفاده کنید.

ODMR از نمایه ESMTP رله نامه درخواستی استفاده کنید.

همه این جایگزین ها اساساً به یک روش کار می کنند (ارتباط با سرور استاندارد
دیمون ها برای واکشی نامه هایی که قبلاً به صندوق پستی در سرور تحویل داده شده است) به جز ETRN و ODMR.
حالت ETRN به شما امکان می‌دهد از یک سرور ESMTP سازگار (مانند ارسال ایمیل BSD در زمان انتشار) بپرسید
8.8.0 یا بالاتر) تا فوراً یک اتصال فرستنده-SMTP را به دستگاه مشتری خود باز کنید و
شروع به ارسال هر آیتم خطاب به دستگاه مشتری خود در صف سرور کنید
نامه تحویل نشده حالت ODMR به یک سرور با قابلیت ODMR نیاز دارد و مشابه آن کار می کند
ETRN، با این تفاوت که به ماشین کلاینت نیازی به داشتن DNS ثابت ندارد.

-U | --uidl
(کلید واژه: uidl)
استفاده اجباری از UIDL (فقط با POP3 موثر است). ردیابی اجباری «تازه» در سمت مشتری
از پیام ها (UIDL مخفف "فهرست شناسه منحصر به فرد" است و در RFC1939 توضیح داده شده است). استفاده کنید
با 'keep' برای استفاده از یک صندوق پستی به عنوان ارسال اخبار کودک برای گروهی از کاربران. حقیقت
پیام‌های مشاهده شده نادیده گرفته می‌شوند، ثبت می‌شود، مگر اینکه ثبت خطا از طریق آن انجام شود
syslog هنگام اجرا در حالت دیمون. توجه داشته باشید که fetchmail ممکن است به طور خودکار فعال شود
این گزینه بسته به قابلیت های سرور بالادست. همچنین توجه داشته باشید که این گزینه
ممکن است حذف شود و اجباری در نسخه fetchmail آینده فعال شود. همچنین ببینید:
--idfile.

-- بیکار (از آنجا که 6.3.3)
(کلمه کلیدی: بیکار، از قبل از 6.0.0)
استفاده از IDLE را فعال کنید (فقط با IMAP موثر است). توجه داشته باشید که این فقط با یکی کار می کند
پوشه در یک زمان معین در حالی که کلمه کلیدی rcfile بیکار برای a پشتیبانی شده بود
مدت زیادی است که گزینه --idle command-line در نسخه 6.3.3 اضافه شده است. استفاده از IDLE
به این معنی است که fetchmail به سرور IMAP می گوید که پیام های جدید را ارسال کند، بنابراین آنها
را می توان زودتر از آنچه که با نظرسنجی های معمولی امکان پذیر است بازیابی کرد.

-P | --سرویس
(کلید واژه: سرویس) از نسخه 6.3.0.
گزینه سرویس به شما امکان می دهد نام سرویسی را برای اتصال به آن تعیین کنید. تو می توانی
اگر پایگاه داده خدمات شما فاقد اطلاعات مورد نیاز است، یک عدد پورت اعشاری را در اینجا مشخص کنید
تکالیف پورت سرویس به مورد R12 سؤالات متداول و مستندات --ssl مراجعه کنید
جزئیات. این جایگزین گزینه قدیمی --port می شود.

--بندر
(کلید واژه: پورت)
نسخه منسوخ شده --service که نام سرویس را نمی گیرد. توجه داشته باشید: این گزینه
ممکن است از نسخه بعدی حذف شود.

--مدیر
(کلید واژه: اصلی)
گزینه اصلی به شما این امکان را می دهد که یک سرویس اصلی را برای متقابل مشخص کنید
احراز هویت. این برای POP3 یا IMAP با احراز هویت Kerberos 4 قابل اجرا است
فقط. برای Kerberos 5 یا GSSAPI اعمال نمی شود. این گزینه ممکن است در یک حذف شود
نسخه fetchmail آینده

-t | --تایم اوت
(کلید واژه: مهلت زمانی)
گزینه timeout به شما امکان می دهد یک مهلت زمانی بدون پاسخ سرور را در چند ثانیه تنظیم کنید. اگر یک
mailserver پیام تبریک ارسال نمی کند یا به دستورات داده شده پاسخ نمی دهد
تعداد ثانیه، fetchmail اتصال به آن قطع خواهد شد. بدون چنین
فاصله fetchmail ممکن است تا زمانی که زمان اتصال TCP به پایان برسد، در حال تلاش برای واکشی است
نامه از یک میزبان پایین، که ممکن است بسیار طولانی باشد. این امر به ویژه آزاردهنده خواهد بود
برای fetchmail در حال اجرا در پس زمینه یک مهلت پیش فرض وجود دارد که
fetchmail -V گزارش خواهد کرد. اگر یک اتصال داده شده، وقفه های زمانی زیادی دریافت کند
متوالی، fetchmail آن را گوه‌ای در نظر می‌گیرد و تلاش مجدد را متوقف می‌کند. کاربر تماس گیرنده
در صورت وقوع از طریق ایمیل مطلع خواهد شد.

با شروع fetchmail 6.3.10، مشتری SMTP از حداقل توصیه شده استفاده می کند
زمانی که منتظر سرور SMTP/LMTP است که با آن صحبت می کند، از RFC-5321 باز می شود.
می توانید بازه های زمانی را حتی بیشتر افزایش دهید، اما نمی توانید آنها را کوتاه کنید. این برای اجتناب است
یک موقعیت دردناک که در آن fetchmail با یک بازه زمانی کوتاه پیکربندی شده است (الف
دقیقه یا کمتر)، یک پیام طولانی (بسیاری مگابایت) را به MTA محلی ارسال می کند، که سپس
پاسخ دادن به "OK" بیشتر از مهلت زمانی طول می کشد، که در نهایت انجام می شود. که می شود
به این معنی که نامه به درستی تحویل داده می شود، اما fetchmail نمی تواند متوجه آن شود و بنابراین خواهد شد
این پیام بزرگ را بارها و بارها بازیابی کنید.

-- پلاگین
(کلید واژه: افزونه)
گزینه پلاگین به شما امکان می دهد از یک برنامه خارجی برای ایجاد TCP استفاده کنید
ارتباط. اگر می‌خواهید از ssh استفاده کنید یا به موارد خاصی نیاز دارید، این کار مفید است
راه اندازی فایروال این برنامه در $PATH جستجو می شود و می تواند به صورت اختیاری باشد
نام میزبان و پورت را به ترتیب با استفاده از "%h" و "%p" به عنوان آرگومان ارسال کرد (توجه داشته باشید
که منطق درونیابی نسبتاً ابتدایی است و این نشانه ها باید محدود شوند
با فاصله سفید یا ابتدای رشته یا انتهای رشته). Fetchmail به آن می نویسد
stdin پلاگین و خواندن از stdout پلاگین.

--از برق کشیدن
(کلید واژه: plugout)
مشابه گزینه افزونه بالا است، اما این یکی برای SMTP استفاده می شود
اتصالات.

-r | --پوشه
(کلید واژه: پوشه[ها])
باعث ایجاد یک پوشه نامه غیر پیش فرض مشخص شده در سرور ایمیل (یا با کاما جدا شده
لیست پوشه ها) بازیابی شود. نحو نام پوشه سرور است-
وابسته این گزینه در POP3، ETRN، یا ODMR در دسترس نیست.

-- ردیاب ها
(کلید واژه: ردیابی)
به fetchmail بگویید تا اطلاعات ردیابی را به شکل «حساب نظرسنجی %s» و
'پوشه %s' به خط Received که تولید می‌کند، جایی که قسمت‌های %s با آن جایگزین می‌شوند
نام راه دور کاربر، برچسب نظرسنجی و پوشه (صندوق پست) در صورت وجود
(هدر Received معمولاً شامل نام واقعی سرور نیز می شود). این میتواند باشد
برای تسهیل فیلتر کردن ایمیل بر اساس حسابی که از آن دریافت می شود استفاده می شود.
اطلاعات پوشه فقط از نسخه 6.3.4 نوشته شده است.

--ssl (کلید واژه: ssl)
با مذاکره باعث می شود که اتصال به ایمیل سرور از طریق SSL رمزگذاری شود
SSL مستقیماً پس از اتصال (حالت SSL-wrapped). استفاده از آن به شدت توصیه می شود
--sslcertck برای تأیید اعتبار گواهی های ارائه شده توسط سرور. لطفا ببینید
شرح --sslproto در زیر! اطلاعات بیشتر در دسترس است README.SSL
فایلی که با fetchmail ارسال می شود.

توجه داشته باشید که حتی اگر این گزینه حذف شود، fetchmail ممکن است همچنان با SSL درون باند مذاکره کند
برای POP3 یا IMAP، از طریق ویژگی STLS یا STARTTLS. می توانید از --sslproto استفاده کنید
گزینه ای برای اصلاح آن رفتار

اگر هیچ پورتی مشخص نشده باشد، اتصال به پورت شناخته شده آن انجام می شود
نسخه SSL پروتکل پایه. این به طور کلی یک پورت متفاوت از پورت است
توسط پروتکل پایه استفاده می شود. برای IMAP، این پورت 143 برای پروتکل شفاف و
پورت 993 برای پروتکل امن SSL. برای POP3، پورت 110 برای متن واضح است
و پورت 995 برای نوع رمزگذاری شده.

اگر سیستم شما فاقد ورودی های مربوطه از / و غیره / خدمات، نگاه کنید به
گزینه --service و شماره پورت عددی را همانطور که در قسمت قبلی داده شده است مشخص کنید
پاراگراف (مگر اینکه ISP شما را به پورت های مختلف هدایت کرده باشد که غیر معمول است
با این حال).

--sslcert
(کلید واژه: sslcert)
برای احراز هویت مشتری مبتنی بر گواهی. برخی از سرورهای رمزگذاری شده SSL نیاز دارند
کلیدها و گواهی های سمت مشتری برای احراز هویت. در بیشتر موارد، این است
اختیاری. این مکان گواهی کلید عمومی را مشخص می کند
در زمان برقراری جلسه SSL به سرور ارائه می شود. این نیست
اگر سرور به آن نیاز نداشته باشد، مورد نیاز است (اما ممکن است ارائه شود). ممکن است این باشد
همان فایل کلید خصوصی (کلید ترکیبی و فایل گواهی) اما اینطور نیست
توصیه شده. همچنین --sslkey را در زیر ببینید.

توجه: اگر از احراز هویت مشتری استفاده می کنید، نام کاربری از آن واکشی می شود
CommonName گواهی است و نام مجموعه با --user را لغو می کند.

--sslkey
(کلید واژه: sslkey)
نام فایل کلید خصوصی SSL سمت سرویس گیرنده را مشخص می کند. برخی از SSL رمزگذاری شده است
سرورها برای احراز هویت به کلیدهای سمت کلاینت و گواهی نیاز دارند. در بیشتر
موارد، این اختیاری است. این مکان کلید خصوصی مورد استفاده را مشخص می کند
در زمانی که جلسه SSL ایجاد می شود، تراکنش ها را با سرور امضا کنید. آی تی
اگر سرور به آن نیاز نداشته باشد، مورد نیاز نیست (اما ممکن است ارائه شود). ممکن است
همان فایل کلید عمومی (کلید ترکیبی و فایل گواهی) اما اینطور نیست
توصیه می شود.

اگر برای باز کردن قفل کلید به رمز عبور نیاز باشد، در آن زمان از آن خواسته می شود
درست قبل از ایجاد جلسه روی سرور. این می تواند باعث برخی شود
عوارض در حالت دیمون

همچنین --sslcert بالا را ببینید.

--sslproto
(کلید واژه: sslproto، توجه: تغییرات معنایی از نسخه 6.4.0)
این گزینه دارای کاربرد دوگانه است، خارج از رفتار fetchmail تاریخی. هر دو را کنترل می کند
نسخه پروتکل SSL/TLS و اگر --ssl مشخص نشده باشد، رفتار STARTTLS
(ارتقا پروتکل به یک اتصال SSL یا TLS درون باند). چند گزینه دیگر
اما ممکن است TLS را اجباری کند.

تنها در صورتی که این گزینه و --ssl هر دو برای یک نظرسنجی گم شوند، TLS فرصت طلبی وجود خواهد داشت
برای POP3 و IMAP، جایی که fetchmail سعی خواهد کرد به TLSv1 یا جدیدتر ارتقا یابد.

مقادیر شناسایی شده برای --sslproto در زیر آورده شده است. شما به طور معمول باید یکی از آنها را انتخاب کنید
گزینه های مذاکره خودکار، به عنوان مثالخودکاریا یکی از گزینه هایی که با علامت مثبت ختم می شود (+)
شخصیت. توجه داشته باشید که بسته به نسخه و پیکربندی کتابخانه OpenSSL، برخی گزینه ها وجود دارد
باعث ایجاد خطاهای زمان اجرا می شود زیرا نسخه های SSL یا TLS درخواستی توسط آن پشتیبانی نمی شوند
کتابخانه OpenSSL نصب شده خاص

''، رشته خالی
STARTTLS را غیرفعال کنید. اگر -ssl برای همان سرور داده شده است، یک خطا ثبت کنید و
وانمود کن که "خودکاربه جای آن استفاده شده بود.

'خودکار' (پیش فرض). از نسخه 6.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+'
از نسخه 6.4.0. به "fBauto" مراجعه کنید.

'TLS1.1'
از نسخه 6.4.0. به TLS نسخه 1.1 دقیقا نیاز است.

'TLS1.1+'
از نسخه 6.4.0. نیاز به TLS مذاکره خودکار TLSv1.1 یا جدیدتر.

'TLS1.2'
از نسخه 6.4.0. به TLS نسخه 1.2 دقیقا نیاز است.

'TLS1.2+'
از نسخه 6.4.0. نیاز به TLS مذاکره خودکار TLSv1.2 یا جدیدتر.

پارامترهای ناشناخته
با آنها یکسان رفتار می شودخودکار'.

توجه: به سختی نیاز به استفاده از چیزی غیر از '' (برای اجبار an
اتصال رمزگذاری نشده) یا «خودکار» (برای اجرای TLS).

--sslcertck
(کلید واژه: sslcertck)
باعث می شود fetchmail نیاز به استفاده از SSL/TLS داشته باشد و در صورت عدم امکان اتصال آن را قطع کند
با موفقیت در مورد SSL یا TLS مذاکره کنید، یا اگر نتواند با موفقیت تأیید و اعتبار سنجی کند
گواهی و آن را به یک لنگر اعتماد (یا گواهی ریشه قابل اعتماد) دنبال کنید. در
لنگرهای اعتماد به عنوان مجموعه‌ای از گواهی‌های مورد اعتماد محلی ارائه می‌شوند (به sslcertfile
و sslcertpath گزینه ها). اگر گواهی سرور قابل دریافت نیست یا نمی شود
امضا شده توسط یکی از افراد مورد اعتماد (مستقیم یا غیر مستقیم)، fetchmail خواهد شد
بدون توجه به اثر انگشت sslfingerprint گزینه.

توجه داشته باشید که CRL (لیست های ابطال گواهی) فقط در OpenSSL 0.9.7 پشتیبانی می شود.
و جدیدتر! ساعت سیستم شما نیز باید در هنگام استفاده از آن دقیق باشد
گزینه.

توجه داشته باشید که این رفتار اختیاری ممکن است به رفتار پیش‌فرض در fetchmail آینده تبدیل شود
نسخه ها

--sslcertfile
(کلمه کلیدی: sslcertfile، از نسخه 6.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 در دایرکتوری ابزار/زیر دایرکتوری است).
همچنین، پس از ارتقاء OpenSSL، ممکن است نیاز به اجرا داشته باشید c_rehash; به خصوص زمانی که
ارتقاء از 0.9.X به 1.0.0.

این می تواند علاوه بر داده شود --sslcertfile در بالا، که برای اولویت ببینید
قوانین.

توجه داشته باشید که استفاده از این گزینه اضافه کردن CA مورد اعتماد SSL پیش‌فرض را متوقف می‌کند
دایرکتوری گواهی ها مگر اینکه متغیر محیطی را تنظیم کنید
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS به یک مقدار غیر خالی

--sslcommonname <مشترک نام>
(کلید واژه: sslcommonname؛ از نسخه 6.3.9)
استفاده از این گزینه ممنوع است. قبل از استفاده از آن، با مدیر سایت تماس بگیرید
سرور بالادست خود را بخواهید و از یک گواهی SSL مناسب استفاده کنید. اگر که
نمی توان به دست آورد، از این گزینه می توان برای تعیین نام (CommonName) استفاده کرد
fetchmail در گواهی سرور انتظار می رود. یک سرور به درستی پیکربندی شده است
این را روی نام میزبانی که با آن به آن دسترسی دارید تنظیم کنید، و به طور پیش فرض fetchmail خواهد بود
به همان اندازه انتظار داشته باشید زمانی که CommonName روی مقدار دیگری تنظیم شده است از این گزینه استفاده کنید
از اخطار "عدم تطابق نام مشترک سرور" و فقط در صورتی که سرور بالادست باشد اجتناب کنید
نمی توان از گواهینامه های مناسب استفاده کرد.

--ssfingerprint
(کلید واژه: sslfingerprint)
اثر انگشت کلید سرور (یک هش MD5 از کلید) را به صورت هگزادسیمال مشخص کنید
علامت گذاری با دونقطه که گروه های دو رقمی را از هم جدا می کند. حروف اعداد هگز باید باشد
در حروف بزرگ این قالبی است که fetchmail برای گزارش اثر انگشت استفاده می کند
هنگامی که یک اتصال SSL برقرار می شود. وقتی این مورد مشخص شد، fetchmail خواهد شد
اثر انگشت کلید سرور را با اثر انگشت داده شده مقایسه کنید، و اتصال با شکست مواجه خواهد شد
اگر آنها با هم مطابقت ندارند، صرف نظر از اینکه sslcertck تنظیمات. اتصال نیز خواهد بود
اگر fetchmail نتواند گواهی SSL را از سرور دریافت کند، شکست می خورد. این میتواند باشد
برای جلوگیری از حملات man-in-the-middle استفاده می شود، اما اثر انگشت از سرور
باید از طریق یک کانال امن به دست آید یا تأیید شود، و مطمئناً نه از طریق آن
همان اتصال اینترنتی که fetchmail از آن استفاده می کند.

استفاده از این گزینه تا زمانی که از خطاهای تأیید گواهی چاپ جلوگیری می کند
--sslcertck تنظیم نشده است.

برای به دست آوردن اثر انگشت گواهی ذخیره شده در فایل cert.pem، سعی کنید:

openssl x509 -in cert.pem -noout -md5 -انگشت

برای جزئیات بیشتر ، ببینید x509(1ssl).

تحویل کنترل گزینه
-S | --smtphost
(کلید واژه: smtp[host])
یک لیست جستجو از میزبان ها برای ارسال نامه به (یک یا چند نام میزبان، کاما-
جدا از هم). میزبان ها به ترتیب لیست امتحان می شوند. اولین موردی که بالاست تبدیل به
هدف حمل و نقل برای اجرای فعلی اگر این گزینه مشخص نشده باشد،
"localhost" به عنوان پیش فرض استفاده می شود. هر نام میزبان ممکن است یک شماره پورت زیر داشته باشد
نام میزبان شماره پورت با یک اسلش از نام میزبان جدا می شود. را
پورت پیش فرض "smtp" است. اگر یک نام مسیر مطلق را مشخص کنید (با یک / شروع می شود)،
آن را به عنوان نام یک سوکت یونیکس که اتصالات LMTP را می پذیرد تفسیر می شود
(مانندی که توسط شبح Cyrus IMAP پشتیبانی می شود) مثال:

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

این گزینه را می توان با ODMR استفاده کرد و fetchmail را به یک رله بین ODMR تبدیل می کند
سرور و گیرنده SMTP یا LMTP.

-- fetchdomains
(کلید واژه: fetchdomains)
در حالت ETRN یا ODMR، این گزینه لیست دامنه هایی را که سرور باید باید مشخص کند
برای یک بار اتصال، نامه را ارسال کنید. پیش فرض FQDN است
ماشین در حال اجرا fetchmail.

-D | --smtpaddress
(کلید واژه: smtpaddress)
دامنه ای را که باید به آدرس های خطوط RCPT TO که به SMTP ارسال می شود، الحاق شود، مشخص کنید.
هنگامی که این مورد مشخص نیست، نام سرور SMTP (همانطور که توسط
--smtphost) برای SMTP/LMTP و 'localhost' برای سوکت UNIX/BSMTP استفاده می شود.

--smtpname
(کلید واژه: smtpname)
دامنه و کاربری را برای قرار دادن در خطوط RCPT TO که به SMTP ارسال می شود، مشخص کنید. در
کاربر پیش فرض کاربر محلی فعلی است.

-Z | -- ضد اسپم <nnn[، nnn]...>
(کلید واژه: آنتی اسپم)
لیستی از خطاهای عددی SMTP را مشخص می کند که باید به عنوان هرزنامه تفسیر شوند.
مسدود کردن پاسخ شنونده مقدار -1 این گزینه را غیرفعال می کند. برای
گزینه خط فرمان، مقادیر لیست باید با کاما از هم جدا شوند.

-m | --mda
(کلید واژه: mda)
این گزینه اجازه می دهد fetchmail از یک پیام یا نماینده تحویل محلی (MDA یا LDA) استفاده کنید
مستقیم، به جای ارسال از طریق SMTP یا LMTP.

برای جلوگیری از گم شدن نامه، از این گزینه فقط برای MDAهایی مانند maildrop یا MTAهایی مانند استفاده کنید
sendmail که با وضعیت غیر صفر در پر بودن دیسک و سایر خطاهای تحویل خارج می شود.
وضعیت غیر صفر به fetchmail می گوید که تحویل انجام نشد و از ارسال پیام جلوگیری می کند
از حذف شدن در سرور

If fetchmail به صورت روت در حال اجرا است، ضمن ارسال نامه، شناسه کاربری خود را تنظیم می کند
یک MDA به شرح زیر است: ابتدا محیط FETCHMAILUSER، LOGNAME و USER
متغیرها به این ترتیب بررسی می شوند. مقدار اولین متغیر از لیست او
که تعریف شده است (حتی اگر خالی باشد!) در پایگاه داده کاربران سیستم جستجو می شود. اگر
هیچ یک از متغیرها تعریف نشده است، fetchmail از شناسه کاربری واقعی استفاده می کند
آغاز شد با اگر یکی از متغیرها تعریف شده بود، اما کاربر اعلام کرد که وجود ندارد
یافت شد، fetchmail به عنوان روت به اجرا ادامه می‌دهد، بدون اینکه متغیرهای باقیمانده را بررسی کند
لیست. در عمل، این بدان معناست که اگر fetchmail را به عنوان root اجرا کنید (نه
توصیه می شود)، تعریف متغیر محیطی FETCHMAILUSER برای آن بسیار مفید است
کاربر را تنظیم کنید که MDA باید به عنوان اجرا شود. برخی از MDAها (مانند maildrop) طراحی شده اند
به setuid root و setuid به شناسه کاربری گیرنده، بنابراین شما از دست ندهید
حتی زمانی که fetchmail را به عنوان کاربر غیرمجاز اجرا می کنید، این قابلیت را دارد. را بررسی کنید
راهنمای MDA برای جزئیات.

برخی از MDAهای احتمالی عبارتند از/usr/sbin/sendmail -i -f %F -- %T" (توجه داشته باشید: چند تا
نسخه‌های ارسال‌میل قدیمی‌تر یا فروشنده اشتباه می‌کنند -- به جای آدرس
نشانگر برای علامت گذاری انتهای آرگومان های گزینه)، "/usr/bin/deliver" و
"/usr/bin/maildrop -d %T". آدرس های تحویل محلی در MDA درج خواهند شد
هر جا که یک %T قرار می دهید دستور دهید. آدرس از پیام ایمیل درج خواهد شد
جایی که یک %F قرار می دهید.

Do نه محصور کردن la %F or %T رشته in تنها نقل قول ها برای %T و %F، fetchmail
آدرس ها را پس از حذف هر نقل قول تکی (') قرار می دهد
ممکن است قبل از اینکه دستور MDA به پوسته ارسال شود شامل شود.

Do نه استفاده کنید an MDA استناد که اعزام می کند on la محتویات of به / رونوشت / رونوشت مخفی، پسندیدن
"sendmail -i -t" یا "qmail-inject"، حلقه‌های ایمیل ایجاد می‌کند و درست را به ارمغان می‌آورد.
خشم بسیاری از مدیران پست بر سر شما فرود آمد. این یکی از رایج ترین است
خطاهای پیکربندی!

همچنین ، انجام دهید نه سعی کنید حالت چند قطره ای را با یک MDA مانند maildrop که می تواند ترکیب کنید
فقط یک آدرس را بپذیرید، مگر اینکه بالادست شما یک کپی از پیام را در هر ذخیره کند
گیرنده و گیرنده پاکت نامه را در هدر منتقل می کند. شما نامه را از دست خواهید داد

مشهور تبلیغ کردن(1) پیکربندی بسته بسیار سخت است، دارای یک
رفتار بسیار ناخوشایند "سقوط به قانون بعدی" در مورد خطاهای تحویل (حتی
موارد موقت، مانند خارج شدن فضای دیسک اگر دیمون ایمیل کاربر دیگری از آن کپی کند
صندوق پستی در اطراف برای پاک کردن پیام های قدیمی)، بنابراین نامه شما به اشتباه ختم می شود
صندوق پست دیر یا زود پیکربندی مناسب procmail خارج از محدوده است
این سند. استفاده كردن پست پستی(1) معمولاً بسیار ساده تر است و بسیاری از کاربران آن را پیدا می کنند
نحو فیلتر استفاده شده توسط maildrop راحت تر قابل درک است.

در نهایت، ما قویاً توصیه می کنیم که این کار را انجام دهید نه از qmail-inject استفاده کنید. خط فرمان
رابط بدون ارائه مزایایی برای استفاده معمولی و fetchmail غیر استاندارد است
هیچ تلاشی برای انطباق با انحرافات qmail-inject از استاندارد انجام نمی دهد. مقداری
گزینه های خط فرمان و محیط qmail-inject در واقع خطرناک هستند و
می تواند باعث شکسته شدن رشته ها، پیام های تکراری شناسایی نشده و حلقه های ارسال شود.

--lmtp (کلید واژه: lmtp)
باعث تحویل از طریق LMTP (پروتکل محلی انتقال پست). هاست و پورت سرویس
باید به صراحت در هر میزبان در لیست شکار smtphost مشخص شود (به بالا مراجعه کنید)
این گزینه انتخاب شده است؛ پورت پیش فرض 25 (مطابق با RFC 2033) نخواهد بود
پذیرفته شود

--bsmtp
(کلید واژه: bsmtp)
نامه واکشی شده را به یک فایل BSMTP اضافه کنید. این به سادگی حاوی دستورات SMTP است که
معمولاً هنگام ارسال نامه به شنونده SMTP توسط fetchmail ایجاد می شود
اهریمن، دیو.

آرگومان '-' باعث می شود که دسته SMTP در خروجی استاندارد نوشته شود، که اینطور است
استفاده محدود: این فقط برای اشکال زدایی منطقی است، زیرا fetchmail معمولی است
خروجی در همان کانال پراکنده است، بنابراین برای ایمیل مناسب نیست
تحویل. این حالت ویژه ممکن است در نسخه بعدی حذف شود.

توجه داشته باشید که بازسازی خطوط MAIL FROM و RCPT TO توسط fetchmail چنین نیست
تضمین درستی؛ هشدارهای مورد بحث در زیر استفاده و سوء استفاده از چند قطره
صندوق پستی زیر اعمال می شود. این حالت قبل از --mda و SMTP/LMTP اولویت دارد.

-- بد سر {رد کردن|پذیرفتن}
(کلید واژه: bad-header؛ از نسخه 6.3.15)
مشخص کنید که fetchmail قرار است چگونه با پیام‌های دارای هدر بد، یعنی هدر برخورد کند
با نحو بد به طور سنتی، fetchmail چنین پیام هایی را رد می کند، اما برخی از آنها
توزیع کنندگان fetchmail را تغییر دادند تا آنها را بپذیرند. اکنون می توانید fetchmail را پیکربندی کنید
رفتار در هر سرور

منابع محدود کردن کنترل گزینه
-l | --حد
(کلید واژه: محدودیت)
یک آرگومان اندازه حداکثر هشتگانه را می گیرد که 0 پیش فرض و همچنین خاص است
مقدار تعیین کننده "بدون محدودیت". اگر غیر صفر باشد، پیام‌های بزرگ‌تر از این اندازه نمی‌شوند
واکشی می شود و روی سرور باقی می ماند (در جلسات پیش زمینه، پیشرفت
پیام‌ها متوجه می‌شوند که "بزرگ‌تر از اندازه" هستند). اگر پروتکل واکشی اجازه دهد (در
به ویژه، در IMAP یا POP3 بدون گزینه fetchall) پیام نخواهد بود
مشخص شده دیده می شود.

یک --Limit صریح 0 هر محدودیتی را که در فایل کنترل اجرای شما تنظیم شده است لغو می کند. این
گزینه برای کسانی است که به دلیل نیاز به کنترل دقیق زمان واکشی دارند
نرخ تلفن گران و متغیر

همراه با --limitflush، می توان از آن برای حذف پیام های بزرگ در انتظار استفاده کرد
یک سرور در حالت دیمون، اعلان‌های بزرگ‌تر برای کاربر تماس‌گیر پست می‌شوند
(گزینه --warnings را ببینید). این گزینه با ETRN یا ODMR کار نمی کند.

-w | -- هشدارها
(کلید واژه: هشدارها)
یک فاصله در ثانیه طول می کشد. وقتی زنگ میزنی fetchmail با گزینه "حد" در
حالت daemon، این بازه زمانی را که در آن هشدارها در مورد پیام‌های بزرگ‌تر داده می‌شود، کنترل می‌کند
برای کاربر تماس گیرنده (یا کاربری مشخص شده توسط گزینه 'postmaster') پست می شوند.
یکی از این اعلان‌ها همیشه در پایان اولین نظرسنجی پست می‌شود
پیام بزرگ تشخیص داده شد پس از آن، اطلاع رسانی مجدد تا زمانی که
پس از سپری شدن فاصله اخطار (در پایان مرحله اول انجام می شود
نظرسنجی زیر).

-b | -- محدودیت دسته ای
(کلید واژه: محدودیت دسته ای)
حداکثر تعداد پیام هایی که به شنونده SMTP ارسال می شود را مشخص کنید
قبل از اینکه اتصال عمداً از بین برود و دوباره ساخته شود (پیش‌فرض 0 است، به این معنی
بدون محدودیت). یک --batchlimit صریح 0 هر محدودیتی را که در اجرای شما تعیین شده است لغو می کند
فایل کنترل در حالی که ارسال پست الکترونیکی(8) معمولاً تحویل یک پیام را آغاز می کند
بلافاصله پس از دریافت پایان دهنده پیام، برخی از شنوندگان SMTP چنین نیستند
سریع. MTA ها دوست دارند لبخند زدن(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 ممکن است نتواند بلافاصله پس از اتمام بازگردانی مجدد وارد شود
- اگر این اتفاق بیفتد، ممکن است خطاهای «lock busy» را ببینید. اگر این گزینه را به an مشخص کنید
عدد صحیح N می گوید fetchmail فقط در هر N ام حذف حذف می شود. یک
آرگومان صفر حذف را به طور کامل سرکوب می کند (بنابراین هیچ حذفی انجام نخواهد شد
تا پایان اجرا). این گزینه با ETRN یا ODMR کار نمی کند.

تصدیق گزینه
-u | --کاربر | --نام کاربری
(کلید واژه: کاربر[نام])
شناسه کاربری را مشخص می کند که هنگام ورود به میل سرور استفاده می شود.
شناسایی مناسب کاربر هم به سرور و هم وابسته به کاربر است. پیشفرض
نام ورود شما در دستگاه مشتری است که در حال اجرا است fetchmail. USER را ببینید
AUTENTICATION در زیر برای توضیح کامل.

-I | --رابط
(کلید واژه: رابط)
نیاز دارید که یک دستگاه رابط خاص روشن باشد و دارای یک کنترل محلی یا راه دور خاص باشد
IPv4 (IPv6 هنوز توسط این گزینه پشتیبانی نمی شود) آدرس (یا محدوده) قبل از نظرسنجی.
غالبا fetchmail روی پیوند نقطه به نقطه TCP/IP گذرا استفاده می شود
مستقیماً از طریق SLIP یا PPP به یک میل سرور ایجاد می شود. که نسبتا امن است
کانال اما زمانی که سایر مسیرهای TCP/IP به سرور پست وجود دارد (مثلاً زمانی که پیوند
به یک ISP جایگزین متصل است)، نام کاربری و رمز عبور شما ممکن است آسیب پذیر باشد
جاسوسی (مخصوصاً زمانی که حالت دیمون به طور خودکار برای پست نظرسنجی می شود، ارسال الف
رمز عبور را از طریق شبکه در فواصل قابل پیش بینی پاک کنید). گزینه --interface ممکن است
برای جلوگیری از این امر استفاده شود. وقتی لینک مشخص شده بالا نیست یا به آن متصل نیست
یک آدرس IP منطبق، نظرسنجی حذف خواهد شد. قالب این است:

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

فیلد قبل از اولین اسلش نام رابط است (یعنی sl0، ppp0 و غیره). در
فیلد قبل از اسلش دوم آدرس IP قابل قبول است. میدان بعد از
اسلش دوم ماسکی است که محدوده ای از آدرس های IP را برای پذیرش مشخص می کند. اگر نه
ماسک موجود است 255.255.255.255 فرض می شود (یعنی مطابقت دقیق). این گزینه است
در حال حاضر فقط تحت لینوکس و FreeBSD پشتیبانی می شود. لطفا ببینید مانیتور بخش
در زیر برای اطلاعات خاص FreeBSD.

توجه داشته باشید که این گزینه ممکن است از نسخه fetchmail آینده حذف شود.

-M | -- مانیتور
(کلید واژه: مانیتور)
حالت Daemon می تواند باعث ایجاد پیوندهای گذرا شود که به طور خودکار پس از a حذف می شوند
دوره عدم فعالیت (به عنوان مثال پیوندهای PPP) به طور نامحدود باقی بماند. این گزینه
یک رابط TCP/IP سیستم را برای نظارت بر فعالیت شناسایی می کند. بعد از هر نظرسنجی
فاصله زمانی، اگر پیوند بالا است اما هیچ فعالیت دیگری در پیوند رخ نداده است، پس
نظرسنجی حذف خواهد شد با این حال، هنگامی که fetchmail توسط یک سیگنال بیدار می شود،
بررسی مانیتور نادیده گرفته می شود و نظرسنجی بدون قید و شرط انجام می شود. این گزینه است
در حال حاضر فقط تحت لینوکس و FreeBSD پشتیبانی می شود. برای مانیتور و رابط
گزینه هایی برای کارکردن برای کاربران غیر روت تحت FreeBSD، باینری fetchmail باید باشد
SGID kmem را نصب کرد. این یک حفره امنیتی است، اما fetchmail با آن اجرا می شود
GID موثر بر روی گروه kmem تنظیم شده است فقط زمانی که داده های رابط در حال وجود است
جمع آوری شده.

توجه داشته باشید که این گزینه ممکن است از نسخه fetchmail آینده حذف شود.

--
(کلید واژه: احراز هویت[enticate])
این گزینه به شما امکان می دهد نوع احراز هویت را مشخص کنید (به تأیید اعتبار کاربر مراجعه کنید
زیر برای جزئیات). مقادیر ممکن هستند هر, کلمه عبور, kerberos_v5, کربروس
(یا برای دقت طاقت فرسا، kerberos_v4), گساپی, 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 با مشتری استفاده می کنید
احراز هویت و مشخص کردن گساپی 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 نیز روشن باشد، یک نام
آرگومان فایل باید مجوزهای بازتر از 0700 نداشته باشد (u=rwx,g=,o=) در غیر این صورت
/dev/null.

-i | --idfile
(کلید واژه: idfile)
یک نام جایگزین برای فایل .fetchids که برای ذخیره UID پیام استفاده می شود، تعیین کنید. توجه داشته باشید:
از fetchmail 6.3.0، دسترسی نوشتن به دایرکتوری حاوی idfile است
لازم است، زیرا fetchmail یک فایل موقت می نویسد و نام آن را به محل فایل تغییر می دهد
idfile واقعی فقط در صورتی که فایل موقت با موفقیت نوشته شده باشد. این اجتناب می کند
کوتاه شدن فایل های id در هنگام اتمام فضای دیسک.

--pidfile
(کلید واژه: pidfile؛ از fetchmail نسخه 6.3.4)
مکان پیش فرض فایل PID را لغو کنید. پیش‌فرض: «محیط زیست» را در زیر ببینید.

-n | --نونونویسی
(کلید واژه: بدون بازنویسی)
به طور معمول، fetchmail هدرهای آدرس RFC-822 (به، از، رونوشت، رونوشت مخفی، و پاسخ به) را ویرایش می کند
در نامه واکشی شده به طوری که هر شناسه نامه محلی به سرور به طور کامل گسترش می یابد
آدرس ها (@ و نام میزبان ایمیل سرور اضافه شده است). این پاسخ ها را فعال می کند
مشتری باید به درستی مورد خطاب قرار گیرد (در غیر این صورت ممکن است پست‌کننده شما فکر کند
باید به کاربران محلی در دستگاه مشتری خطاب شود!). این گزینه غیرفعال می شود
بازنویسی (این گزینه برای آرام کردن افراد پارانوئید ارائه شده است
داشتن یک MTA ویرایش هدر ایمیل و می خواهید بدانید که آنها می توانند از آن جلوگیری کنند، اما اینطور است
به طور کلی ایده خوبی برای خاموش کردن بازنویسی نیست.) هنگام استفاده از ETRN یا ODMR،
گزینه بازنویسی بی اثر است.

-E | --پاكت نامه
(کلید واژه: پاکت نامه؛ فقط چند قطره)
در فایل پیکربندی، یک نحو پیشرفته استفاده می شود:
پاکت [ ]

این گزینه هدر را تغییر می دهد fetchmail فرض می کند که یک کپی از نامه را به همراه خواهد داشت
آدرس پاکت نامه به طور معمول این "X-Envelope-To" است. سرصفحه های دیگر که معمولاً یافت می شوند
برای حمل اطلاعات پاکت عبارتند از "X-Original-To" و "Delivered-To". در حال حاضر، از آن زمان
این هدرها استاندارد نیستند، تمرین متفاوت است. بحث را ببینید
مدیریت آدرس چند قطره در زیر. به عنوان یک مورد خاص، "پاکت "دریافت"" را فعال می کند
تجزیه خطوط دریافتی به سبک sendmail. این پیش فرض است، اما دلسرد شده است
زیرا کاملا قابل اعتماد نیست.

توجه داشته باشید که fetchmail انتظار دارد که خط دریافتی در قالب خاصی باشد: باید
حاوی "توسط میزبان برای نشانی"، جایی که میزبان باید با یکی از نام های سرور ایمیل مطابقت داشته باشد
که fetchmail برای حساب مورد نظر تشخیص می دهد.

آرگومان شمارش اختیاری (فقط در فایل پیکربندی موجود است) تعیین می کند
چه تعداد از خطوط سرصفحه از این نوع نادیده گرفته می شود. شمارش 1 به این معنی است: اولی را رد کنید،
دومی را بگیر شمارش 2 به این معنی است: اولی و دومی را رد کنید، سومی را بگیرید و
به زودی.

-Q | -- مجازی
(کلمه کلیدی: qvirtual؛ فقط چند قطره)
پیشوند رشته اختصاص داده شده به این گزینه از نام کاربری یافت شده حذف خواهد شد
در هدر مشخص شده با پاکت گزینه (قبل از انجام نام چند قطره
نقشه برداری یا بررسی محلی دامنه، در صورت وجود). این گزینه مفید است اگر
شما استفاده می کنید fetchmail برای جمع آوری نامه برای کل دامنه و ISP شما (یا
ارائه دهنده تغییر مسیر ایمیل شما) از qmail استفاده می کند. یکی از ویژگی های اساسی qmail
هست تحویل به: عنوان پیام. هر زمان که qmail پیامی را به محلی ارسال می کند
صندوق پستی نام کاربری و نام میزبان گیرنده پاکت نامه را در این خط قرار می دهد.
دلیل اصلی این امر جلوگیری از حلقه های ایمیل است. برای تنظیم qmail به نامه دسته ای
برای یک سایت قطع شده، ISP-mailhost معمولاً آن سایت را در خود قرار می دهد
فایل کنترل "Virtualhosts" بنابراین یک پیشوند به همه آدرس‌های ایمیل برای این کار اضافه می‌کند
سایت. این نتیجه در نامه ارسال شده به '[ایمیل محافظت شده]' داشتن یک
تحویل به: خط فرم:

تحویل به: [ایمیل محافظت شده]

ISP می تواند پیشوند 'mbox-userstr-' را هر چیزی که انتخاب می کند بسازد به جز رشته ای که با
نام میزبان کاربر محتمل است. با استفاده از گزینه "پاکت تحویل داده شده به:" می توانید بسازید
fetchmail به طور قابل اعتمادی گیرنده پاکت اصلی را شناسایی می کند، اما شما باید آن را پاک کنید
پیشوند 'mbox-userstr-' برای تحویل به کاربر صحیح. این گزینه برای همین است.

--configdump
را تجزیه کنید ~/.fetchmailrc فایل، هر گزینه خط فرمان مشخص شده را تفسیر کنید، و
یک گزارش پیکربندی را به خروجی استاندارد تخلیه کنید. گزارش پیکربندی یک داده است
تخصیص ساختار در زبان پایتون. این گزینه برای استفاده است
تعاملی ~/.fetchmailrc ویرایشگر مانند fetchmailconf، به زبان پایتون نوشته شده است.

حذف شده گزینه
-T | --netsec
قبل از نسخه 6.3.0 حذف شده بود، کتابخانه زیرین inet6_apps مورد نیاز بود
متوقف شده و دیگر در دسترس نیست.

USER احراز هویت و ثبت نام

همه حالت ها به جز ETRN نیاز به احراز هویت مشتری به سرور دارند. کاربر عادی
احراز هویت در fetchmail بسیار شبیه مکانیزم احراز هویت است اف تی پی(1)
شناسه کاربری و رمز عبور صحیح به سیستم امنیتی زیربنایی در سرور ایمیل بستگی دارد.

اگر میل سرور یک ماشین یونیکس است که در آن یک حساب کاربری معمولی دارید، شما
نام ورود به سیستم و رمز عبور معمولی با استفاده می شود fetchmail. اگر از همان نام ورود استفاده می کنید
در هر دو دستگاه سرور و کلاینت، لازم نیست نگران تعیین شناسه کاربری باشید
با -u گزینه -- رفتار پیش فرض استفاده از نام ورود به سیستم در دستگاه مشتری است
به عنوان شناسه کاربری در دستگاه سرور. اگر از نام دیگری برای ورود به سرور استفاده می کنید
ماشین، آن نام ورود را با عبارت مشخص کنید -u گزینه. به عنوان مثال اگر نام ورود شما 'jsmith' است
در ماشینی به نام "mailgrunt"، شما شروع می کنید fetchmail به شرح زیر است:

fetchmail -u jsmith mailgrunt

رفتار پیش فرض از fetchmail این است که از شما رمز عبور سرور ایمیل خود را قبل از
ارتباط برقرار می شود. این امن ترین راه برای استفاده است fetchmail و تضمین می کند که شما
رمز عبور به خطر نمی افتد. شما همچنین می توانید رمز عبور خود را در خود مشخص کنید
~/.fetchmailrc فایل. این در هنگام استفاده راحت است fetchmail در حالت دیمون یا با
اسکریپت.

با استفاده از netrc فایل ها
اگر رمز عبور را مشخص نکنید، و fetchmail نمی توان یکی از شما را استخراج کرد
~/.fetchmailrc فایل، آن را به دنبال یک ~/.netrc قبلاً در فهرست اصلی خود فایل کنید
درخواست یکی به صورت تعاملی؛ اگر ورودی مطابق با سرور پست الکترونیکی در آن فایل یافت شود،
رمز عبور استفاده خواهد شد. Fetchmail ابتدا به دنبال تطبیقی ​​در نام نظرسنجی می گردد. اگر پیدا کند
هیچ، از طریق نام مطابقت را بررسی می کند. را ببینید اف تی پی(1) صفحه مرد برای جزئیات
نحو از ~/.netrc فایل. برای نشان دادن یک مثال عملی، یک netrc. ممکن است به شکل زیر باشد:

ماشین hermes.example.org
ورود جو
رمز عبور فوق سری

اگر نیاز به ارائه بیشتر از آن دارید، می توانید این بلوک را با اطلاعات کاربری مختلف تکرار کنید
یک رمز عبور

این ویژگی ممکن است به شما امکان دهد از تکرار اطلاعات رمز عبور در بیش از یک رمز جلوگیری کنید
فایل.

در سرورهای پستی که حساب های کاربری معمولی را ارائه نمی دهند، شناسه کاربری و رمز عبور شما وجود دارد
معمولاً زمانی که برای صندوق پستی روی سرور درخواست می کنید توسط مدیر سرور اختصاص داده می شود.
اگر شناسه کاربری و رمز عبور صحیح را نمی دانید با سرپرست سرور خود تماس بگیرید
حساب صندوق پستی شما

POP3 متغیرها

نسخه‌های اولیه POP3 (RFC1081، RFC1225) از شکل خام مستقل پشتیبانی می‌کردند.
احراز هویت با استفاده از .rhosts فایل در سمت میل سرور تحت این نوع RPOP، a
شناسه ثابت برای هر کاربر معادل رمز عبور به صورت واضح از طریق پیوندی به یک رزرو شده ارسال شد
پورت، با دستور RPOP به جای PASS به سرور هشدار می دهد که باید کار خاصی انجام دهد
چک کردن. RPOP توسط fetchmail (می توانید «پروتکل RPOP» را برای داشتن آن مشخص کنید
برنامه ارسال "RPOP" به جای "PASS") اما استفاده از آن به شدت ممنوع است، و پشتیبانی می شود
از نسخه fetchmail آینده حذف خواهد شد. این تسهیلات در برابر جعل آسیب پذیر بود
و در RFC1460 برداشته شد.

RFC1460 احراز هویت APOP را معرفی کرد. در این نوع POP3، شما یک APOP را ثبت می کنید
رمز عبور در هاست سرور شما (در برخی از سرورها برنامه ای که برای انجام این کار نامیده می شود
popauth(8)). شما همان رمز عبور را در خود قرار داده اید ~/.fetchmailrc فایل. هر زمان fetchmail
وارد سیستم شوید، یک هش MD5 از رمز عبور شما و زمان خوشامدگویی سرور را به سرور ارسال می کند.
که می تواند آن را با بررسی پایگاه داده مجوز خود تأیید کند.

توجه داشته باشید که APOP is نه دیگر در نظر گرفته مقاوم در برابر مرد در وسط حملات

RETR or TOP
fetchmail تلاش می کند تا سرور باور کند پیام ها بازیابی نشده اند،
با استفاده از دستور TOP با تعداد زیادی خط در صورت امکان. TOP یک فرمان است
که هدر کامل و a را بازیابی می کند fetchmailمقدار مشخصی از خطوط بدن این است
اختیاری است و بنابراین توسط همه سرورها پیاده سازی نمی شود، و برخی از آنها شناخته شده اند که آن را پیاده سازی می کنند
نادرست با این حال، در بسیاری از سرورها، دستور RETR که پیام کامل را بازیابی می کند
با هدر و بدنه، پرچم "دیده" را تنظیم می کند (به عنوان مثال، در یک رابط وب)، در حالی که
دستور TOP این کار را نمی کند.

fetchmail اگر "fetchall" تنظیم شده باشد همیشه از دستور RETR استفاده می کند. fetchmail نیز استفاده خواهد کرد
اگر "keep" تنظیم شده باشد و "uidl" تنظیم نشده باشد، دستور RETR. سرانجام، fetchmail استفاده خواهد کرد
دستور RETR در سرورهای Maillennium POP3/PROXY (استفاده شده توسط Comcast) برای جلوگیری از TOP عمدی
تفسیر نادرست در این سرور که باعث خراب شدن پیام می شود.

در تمام موارد دیگر، fetchmail از دستور TOP استفاده خواهد کرد. این بدان معناست که در "نگهداری"
تنظیمات، اگر "TOP" مورد نظر باشد، باید "uidl" تنظیم شود.

توجه داشته باشید که این توضیحات برای نسخه فعلی fetchmail درست است، اما رفتار
ممکن است در نسخه های بعدی تغییر کند. به طور خاص، fetchmail ممکن است دستور RETR را ترجیح دهد
زیرا دستور TOP باعث ناراحتی زیادی در برخی از سرورها می شود و فقط اختیاری است.

متناوب احراز هویت تشکیل می دهد

اگر شما fetchmail با پشتیبانی Kerberos ساخته شده است و شما احراز هویت Kerberos را مشخص می کنید
(یا با --auth یا با .fetchmailrc انتخاب تصدیق کردن kerberos_v4) سعی خواهد کرد
در شروع هر پرس و جو، یک بلیط Kerberos از سرور پست دریافت کنید. توجه: اگر یکی از
نام نظرسنجی یا از طریق نام "hesiod" است، fetchmail سعی می کند از Hesiod برای جستجوی آن استفاده کند.
سرور پست الکترونیکی

اگر از POP3 یا IMAP با احراز هویت GSSAPI استفاده می کنید، fetchmail از سرور انتظار می رود
دارای قابلیت GSSAPI مطابق با RFC1731 یا RFC1734 هستند و از آن استفاده خواهند کرد. در حال حاضر این
فقط روی Kerberos V آزمایش شده است، بنابراین از شما انتظار می رود قبلاً یک بلیط اعطا کنید
بلیط. شما می توانید با استفاده از استاندارد نام کاربری متفاوت از نام اصلی خود را ارسال کنید
--کاربر فرمان یا توسط .fetchmailrc انتخاب کاربر.

اگر دیمون IMAP شما پاسخ PREAUTH را در خط خوشامدگویی خود برگرداند، fetchmail
به این نکته توجه کنید و از مرحله احراز هویت عادی صرف نظر کنید. این می تواند مفید باشد، به عنوان مثال اگر شما
imapd را به صراحت با استفاده از ssh شروع کنید. در این صورت می توانید مقدار احراز هویت را اعلام کنید
'ssh' در آن ورودی سایت متوقف شود fetchmail از درخواست رمز عبور هنگام شروع
است.

اگر از احراز هویت مشتری با TLS1 و شبح IMAP شما را برمی گرداند AUTH=EXTERNAL
پاسخ، fetchmail متوجه این موضوع می شود و از میانبر احراز هویت استفاده می کند و نخواهد کرد
رمز عبور را ارسال کنید در این حالت می توانید مقدار احراز هویت را "خارجی" اعلام کنید
در آن سایت متوقف شود fetchmail از درخواست رمز عبور هنگام راه اندازی.

اگر از POP3 استفاده می‌کنید و سرور یک چالش یکبار مصرف رمز عبور مطابق با آن را صادر می‌کند
RFC1938، fetchmail از رمز عبور شما به عنوان رمز عبور برای ایجاد موارد مورد نیاز استفاده می کند
واکنش. این امر از ارسال اسرار بدون رمزگذاری بر روی شبکه جلوگیری می کند.

احراز هویت RPA Compuserve پشتیبانی می شود. اگر در پشتیبانی کامپایل کنید، fetchmail
سعی خواهد کرد به جای ارسال رمز عبور، احراز هویت عبارت عبور RPA را انجام دهد
اگر "@compuserve.com" را در نام میزبان تشخیص دهد، روشن شود.

اگر از IMAP استفاده می کنید، احراز هویت NTLM مایکروسافت (که توسط Microsoft Exchange استفاده می شود)
پشتیبانی. اگر در پشتیبانی کامپایل کنید، fetchmail سعی خواهد کرد یک NTLM را انجام دهد
احراز هویت (به جای ارسال رمز عبور به صورت واضح) هر زمان که سرور بازگردد
AUTH=NTLM در پاسخ قابلیت آن. یک مقدار گزینه کاربر را که به نظر می رسد مشخص کنید
'user@domain': قسمت سمت چپ @ به عنوان نام کاربری و قسمت ارسال می شود
سمت راست به عنوان دامنه NTLM.

امن پریز لایه ها (SSL) و حمل و نقل لایه دوربین های مداربسته (TLS)
حمل و نقل علاوه بر این، بازیابی POP3 و IMAP همچنین می تواند با استفاده از SSL/TLS مذاکره کند.
STARTTLS (یا STLS).

توجه داشته باشید که fetchmail در حال حاضر از کتابخانه OpenSSL استفاده می کند که به شدت مستند نشده است.
بنابراین ممکن است شکست فقط به این دلیل رخ دهد که برنامه نویسان از الزامات OpenSSL آگاه نیستند
روز به عنوان مثال، از نسخه 6.3.16، fetchmail OpenSSL_add_all_algorithms() را فراخوانی می کند.
که برای پشتیبانی از گواهینامه ها با استفاده از SHA256 در OpenSSL 0.9.8 ضروری است -- این
اطلاعات عمیقاً در اسناد پنهان است و اصلاً آشکار نیست. لطفا نه
در گزارش شکست های ظریف SSL تردید کنید.

شما می توانید با تعیین گزینه هایی که با --ssl شروع می شوند، به خدمات رمزگذاری شده SSL دسترسی پیدا کنید
به عنوان --ssl، --sslproto، --sslcertck و دیگران. شما همچنین می توانید این کار را با استفاده از
گزینه های کاربر مربوطه در فایل fetchmailrc. برخی از خدمات مانند POP3 و
IMAP دارای پورت های مختلف شناخته شده ای است که برای سرویس های رمزگذاری شده SSL تعریف شده است. در
هنگامی که SSL فعال باشد و پورت واضحی وجود نداشته باشد، پورت های رمزگذاری شده به طور خودکار انتخاب می شوند
مشخص شده. همچنین گزینه --sslcertck command line یا sslcertck run run file گزینه
باید برای بررسی دقیق گواهی استفاده شود - زیر را ببینید.

اگر SSL پیکربندی نشده باشد، fetchmail معمولاً سعی می‌کند از STARTTLS استفاده کند.
STARTTLS را می توان با استفاده از --sslproto auto و با استفاده از --sslproto '' شکست داد.
اتصالات TLS از همان پورت نسخه رمزگذاری نشده پروتکل استفاده می کنند و مذاکره می کنند
TLS از طریق دستور ویژه. گزینه --sslcertck command line یا sslcertck run run file
باید برای بررسی دقیق گواهی استفاده شود - زیر را ببینید.

--sslcertck is توصیه شده: هنگام اتصال به سرور رمزگذاری شده SSL یا TLS، سرور
یک گواهی برای اعتبار سنجی به مشتری ارائه می دهد. گواهی برای تأیید بررسی می شود
که نام رایج در گواهی با نام سرور مورد تماس مطابقت دارد و
که تاریخ های معتبر و انقضا در گواهی نشان می دهد که در حال حاضر است
معتبر. اگر هر یک از این بررسی ها ناموفق باشد، یک پیام هشدار چاپ می شود، اما اتصال
ادامه می دهد. گواهی سرور نیازی به امضای هیچ گواهینامه خاصی ندارد
اختیار و ممکن است یک گواهی "خود امضا شده" باشد. اگر گزینه خط فرمان --sslcertck
یا از گزینه sslcertck run run file استفاده می شود، در عوض fetchmail در صورت وجود هر یک از این موارد لغو می شود
چک‌ها با شکست مواجه می‌شوند، زیرا باید فرض کنیم که در این مورد یک حمله مرد میانی وجود دارد
سناریو، از این رو fetchmail نباید رمزهای عبور متن واضح را در معرض نمایش بگذارد. استفاده از sslcertck یا
بنابراین گزینه --sslcertck توصیه می شود.

برخی از سرورهای رمزگذاری شده SSL ممکن است درخواست گواهی سمت کلاینت کنند. عمومی سمت مشتری
گواهی SSL و کلید SSL خصوصی ممکن است مشخص شود. در صورت درخواست سرور،
گواهی مشتری برای اعتبار سنجی به سرور ارسال می شود. برخی از سرورها ممکن است به یک معتبر نیاز داشته باشند
گواهی مشتری و ممکن است اتصالات را در صورت عدم ارائه گواهی یا اگر
گواهی معتبر نیست برخی از سرورها ممکن است نیاز به امضای گواهی سمت مشتری داشته باشند
یک مرجع صدور گواهینامه شناخته شده فرمت فایل های کلیدی و فایل های گواهی
این است که توسط کتابخانه های SSL اساسی (در حالت کلی OpenSSL) مورد نیاز است.

یک کلمه مراقبت در مورد استفاده از SSL: در حالی که در بالا ذکر شد راه اندازی با سرور خود امضا شده است
گواهی‌های بازیابی شده از طریق سیم‌ها می‌توانند شما را از یک استراق سمع غیرفعال محافظت کنند
در برابر یک مهاجم فعال کمکی نمی کند. واضح است که این یک پیشرفت نسبت به ارسال است
گذرواژه‌ها واضح هستند، اما باید توجه داشته باشید که حمله انسان در وسط بی‌اهمیت است
ممکن است (به ویژه با ابزارهایی مانند dsniff ⟨http://monkey.org/~dugsong/dsniff/⟩، ).
استفاده از بررسی دقیق گواهی با مرجع صدور گواهینامه به رسمیت شناخته شده توسط سرور و
مشتری، یا شاید یک تونل SSH (برای چند نمونه به زیر مراجعه کنید) ترجیح داده می شود
به طور جدی به امنیت صندوق پستی و رمزهای عبور خود اهمیت دهید.

ESMTP دانشگاه AUTH
fetchmail همچنین از احراز هویت به سرور ESMTP در سمت مشتری مطابق با پشتیبانی می کند
RFC 2554. می توانید یک جفت نام/رمز عبور برای استفاده با کلمات کلیدی 'esmtpname' تعیین کنید.
و 'esmtppassword'; اولی به طور پیش فرض به نام کاربری کاربر تماس گیرنده است.

اهریمن، دیو MODE

معرفی la روح پلید حالت
در حالت دیمون، fetchmail خود را در پس‌زمینه قرار می‌دهد و برای همیشه اجرا می‌شود و هر کدام را پرس و جو می‌کند
میزبان مشخص شده و سپس خواب برای یک بازه نظرسنجی مشخص.

راه افتادن la روح پلید حالت
راه های مختلفی برای کارکرد fetchmail در حالت دیمون وجود دارد. در خط فرمان،
--اهریمن، دیو or -d گزینه اجرا می شود fetchmail در حالت دیمون شما باید
یک آرگومان عددی را مشخص کنید که یک بازه نظرسنجی است (زمان انتظار پس از تکمیل a
کل چرخه نظرسنجی با آخرین سرور و قبل از شروع چرخه نظرسنجی بعدی با
سرور اول) در چند ثانیه.

مثال: به سادگی استناد کردن

fetchmail -d 900

بنابراین، از همه میزبان‌هایی که در شما توضیح داده شده است نظرسنجی می‌کند ~/.fetchmailrc فایل (به جز آنها
صراحتاً با فعل "پرش" حذف می شود) کمی کمتر از یک بار در هر 15 دقیقه
(دقیقا: 15 دقیقه + زمان نظرسنجی).

همچنین امکان تنظیم فاصله نظرسنجی در خود وجود دارد ~/.fetchmailrc فایل با گفتن
دیمون را تنظیم کنید '، جایی که یک عدد صحیح از ثانیه است. اگر انجام دهید
این، fetchmail همیشه در حالت دیمون شروع می شود مگر اینکه با دستور-
گزینه خط --daemon 0 یا -d0.

فقط یک فرآیند شبح برای هر کاربر مجاز است. در حالت دیمون، fetchmail برای هر
فایل قفل کاربر برای تضمین این امر. (با این حال می توانید تقلب کنید و FETCHMAILHOME را تنظیم کنید
متغیر محیطی برای غلبه بر این تنظیمات، اما در این صورت، مسئولیت شماست
تا مطمئن شوید که یک سرور را با دو فرآیند به طور همزمان نظرسنجی نمی کنید.)

بیداری la زمینه روح پلید
به طور معمول، فراخوانی fetchmail با دیمون در پس‌زمینه، یک سیگنال بیداری به
دیمون و بدون خروجی خارج می شود. سپس دیمون پس زمینه چرخه نظرسنجی بعدی خود را شروع می کند
بلافاصله. مستقیما. سیگنال بیدار شدن، SIGUSR1 نیز می تواند به صورت دستی ارسال شود. عمل بیداری
همچنین هر گونه پرچم "گوه ای" را که نشان می دهد اتصالات به دلیل شکست گوه خورده اند پاک می کند
احراز هویت یا وقفه های متعدد

پایان دادن la زمینه روح پلید
گزینه --ترک کردن یک فرآیند دیمون در حال اجرا را به جای بیدار کردن آن از بین می برد (اگر وجود داشته باشد
چنین فرآیندی وجود ندارد، fetchmail به شما اطلاع خواهد داد). اگر گزینه --quit آخرین بار در صفحه ظاهر شود
خط فرمان، fetchmail روند اجرای دیمون را از بین می برد و سپس از آن خارج می شود. در غیر این صورت،
fetchmail ابتدا یک فرآیند دیمون در حال اجرا را از بین می برد و سپس به اجرا با آن ادامه می دهد
گزینه های دیگر

مفید گزینه های برای روح پلید حالت
La -L or --ورود به سیستم فایل گزینه (کلمه کلیدی: set logfile) فقط موثر است
وقتی fetchmail جدا و در حالت دیمون است. توجه داشته باشید که la ورود به سیستم فایل باید وجود داشته باشد قبل از
fetchmail اجرا می شود، می توانید از آن استفاده کنید لمس(1) دستور با نام فایل به عنوان تنها آرگومان آن
برای ایجاد آن
این گزینه به شما امکان می‌دهد پیام‌های وضعیت را به یک فایل گزارش مشخص شده هدایت کنید (به دنبال موارد زیر باشید
گزینه با نام logfile). فایل لاگ برای الحاق باز می شود، بنابراین پیام های قبلی
حذف نمی شوند این در درجه اول برای اشکال زدایی تنظیمات مفید است. توجه داشته باشید که
fetchmail تشخیص نمی دهد که آیا لاگ فایل چرخانده شده است یا خیر، فایل لاگ فقط یک بار باز می شود
fetchmail شروع می شود. پس از چرخاندن فایل لاگ و قبل از آن باید fetchmail را مجددا راه اندازی کنید
فشرده سازی آن (در صورت وجود).

La --syslog گزینه (کلمه کلیدی: set syslog) به شما امکان می دهد وضعیت و پیام های خطا را تغییر مسیر دهید
منتشر شده به syslog(3) سیستم دیمون در صورت موجود بودن. پیام ها با شناسه ثبت می شوند
fetchmail، تسهیلات LOG_MAIL، و اولویت ها LOG_ERR, LOG_ALERT or LOG_INFO. این
گزینه برای ثبت وضعیت و پیام های خطا که وضعیت را نشان می دهد در نظر گرفته شده است
دیمون و نتایج هنگام واکشی نامه از سرور(های) پیام های خطا برای فرمان
گزینه های خط و تجزیه .fetchmailrc فایل هنوز در stderr یا در نوشته می شود
فایل لاگ مشخص شده در --nosyslog گزینه استفاده از syslog(3)، با فرض اینکه اینطور باشد
روشن در ~/.fetchmailrc فایل. این گزینه در شرایط خاص لغو می شود،
by --ورود به سیستم فایل (که ببینید).

La -N or -- گره جدا کردن گزینه پس‌زمینه و جدا شدن فرآیند دیمون را سرکوب می‌کند
از ترمینال کنترل آن این برای اشکال زدایی یا زمانی که fetchmail به عنوان اجرا می شود مفید است
فرزند یک فرآیند سرپرست مانند init انجام(8) یا Gerrit Pape's آن را اجرا کنید(8). توجه داشته باشید که این
همچنین باعث می شود که گزینه logfile نادیده گرفته شود.

توجه داشته باشید که هنگام اجرا در حالت daemon با نظرسنجی سرور POP2 یا IMAP2bis، خطاهای گذرا
(مانند خرابی DNS یا امتناع ارسال ایمیل) ممکن است گزینه fetchall را برای فعال کردن مجبور کند
مدت زمان دور بعدی رای گیری این یک ویژگی استحکام است. یعنی اگر الف
پیام واکشی می شود (و بنابراین توسط سرور پستی مشخص می شود) اما به صورت محلی تحویل داده نمی شود
به برخی از خطاهای گذرا، در چرخه نظرسنجی بعدی دوباره واکشی خواهد شد. (IMAP
منطق پیام ها را تا زمانی که تحویل داده نشود حذف نمی کند، بنابراین این مشکل ایجاد نمی شود.)

اگر لمس کنید یا تغییر دهید ~/.fetchmailrc فایل در حالی که fetchmail در حالت دیمون در حال اجرا است،
این در ابتدای چرخه نظرسنجی بعدی شناسایی خواهد شد. وقتی یک تغییر کرد
~/.fetchmailrc شناسایی می شود، fetchmail آن را دوباره می خواند و از ابتدا مجددا راه اندازی می شود (با استفاده از exec(2)؛
هیچ اطلاعات ایالتی در نمونه جدید حفظ نمی شود). توجه داشته باشید که اگر fetchmail نیاز داشته باشد
پرس و جو برای کلمه عبور، که اگر شما شکستن ~/.fetchmailrc نحو فایل، جدید
نمونه به آرامی و بی صدا در راه اندازی ناپدید می شود.

اداری OPTIONS

La -- رئیس پست گزینه (کلمه کلیدی: set postmaster) آخرین راه حل را مشخص می کند
نام کاربری که در صورتی که هیچ گیرنده محلی مشابهی وجود نداشته باشد، نامه چند قطره ای باید به آن ارسال شود
یافت. همچنین به عنوان مقصد نامه غیر قابل تحویل در صورتی که 'bouncemail' جهانی باشد استفاده می شود
اگر گزینه جهانی 'bouncemail' باشد، گزینه خاموش است و به علاوه برای نامه های مسدود شده از هرزنامه
خاموش است و گزینه جهانی 'spambounce' روشن است. این گزینه به طور پیش فرض برای کاربری است که فراخوانی کرده است
fetchmail. اگر کاربر فراخوانی root باشد، پیش فرض این گزینه کاربر است
"کارشناس پست". تنظیم postmaster روی رشته خالی باعث ایجاد چنین نامه هایی می شود که در بالا توضیح داده شد
باید دور انداخته شود - اما این معمولاً ایده بدی است. همچنین به توضیحات مربوطه مراجعه کنید
متغیر محیطی "FETCHMAILUSER" در بخش ENVIRONMENT زیر.

La -- بدون پرش مانند گزینه جهانی "set no bouncemail" عمل می کند که به آن مراجعه کنید.

La --نامرئی گزینه (کلمه کلیدی: set invisible) سعی می کند fetchmail را نامرئی کند.
به طور معمول، fetchmail مانند هر MTA دیگری رفتار می کند - یک هدر Received تولید می کند
در هر پیامی که مکان آن را در زنجیره انتقال توصیف می کند و آن را به MTA می گوید
فوروارد به که نامه از دستگاه fetchmail خود در حال اجرا است. اگر
گزینه invisible روشن است، هدر Received سرکوب شده است و fetchmail سعی می‌کند آن را جعل کند.
MTA آن را به سمت جلو هدایت می کند تا فکر کند مستقیماً از میزبان میل سرور آمده است.

La --showdots گزینه (کلمه کلیدی: set showdots) fetchmail را مجبور می کند تا نقاط پیشرفت را حتی نشان دهد
اگر خروجی به فایلی برود یا fetchmail در حالت کلامی نباشد. Fetchmail را نشان می دهد
هنگامی که در حالت --verbose اجرا می شود به طور پیش فرض نقطه ها را نشان می دهد و خروجی به کنسول می رود این گزینه است
در حالت خاموش نادیده گرفته شد.

با مشخص کردن -- ردیاب ها گزینه، می توانید از fetchmail بخواهید که اطلاعاتی را به آن اضافه کند
سرصفحه در فرم "نظرسنجی {label} حساب {user}" دریافت شد، که در آن {label} حساب است
برچسب (از فایل rc مشخص شده، به طور معمول ~/.fetchmailrc) و {user} نام کاربری است
که برای ورود به سرور ایمیل استفاده می شود. از این هدر می توان برای فیلتر کردن استفاده کرد
ایمیلی که در آن هیچ اطلاعات هدر مفیدی در دسترس نیست و می‌خواهید از آن ایمیل دیگری دریافت کنید
حساب‌هایی که در صندوق‌های پستی مختلف مرتب شده‌اند (مثلاً اگر شما دارید این اتفاق می‌افتد
حساب در همان سروری که یک لیست پستی اجرا می کند، و با استفاده از آن در لیست مشترک می شوند
آن حساب). به طور پیش فرض چنین هدری اضافه نمی شود. که در .fetchmailrc، این نامیده می شود
"ردیاب".

بازیابی شکست حالت ها

پروتکل ها fetchmail استفاده از مکالمه با سرورهای پستی در کنار ضد گلوله است. در حالت عادی
انتقال عملیات به پورت 25، هیچ پیامی هرگز حذف نشده است (یا حتی برای حذف علامت گذاری شده است)
در هاست تا زمانی که شنونده SMTP در سمت کلاینت تایید کند fetchmail که
پیام یا برای تحویل پذیرفته شده است یا به دلیل بلوک اسپم رد شده است.

با این حال، هنگام ارسال به MDA، احتمال خطا بیشتر است. برخی از MDA ها هستند
"ایمن" و به طور قابل اعتماد وضعیت غیر صفر را در هر خطای تحویل، حتی یک مورد به دلیل
محدودیت منابع موقت در پست پستی(1) برنامه به این صورت است. اکثر برنامه ها هم همینطور
طراحی شده به عنوان عوامل حمل و نقل پستی، مانند ارسال پست الکترونیکی(1)، از جمله بسته بندی sendmail
پست فیکس و exim(1). این برنامه ها یک تصدیق مثبت قابل اعتماد و می توانند به شما برگردانند
با گزینه mda بدون خطر از دست دادن نامه استفاده شود. با این حال، MDA های ناامن ممکن است 0 را برگردانند
حتی در صورت شکست تحویل اگر این اتفاق بیفتد، نامه را از دست خواهید داد.

حالت عادی از fetchmail این است که سعی کنید فقط پیام های "جدید" را بارگیری کنید و دست نخورده باقی بگذارید
پیام هایی (و حذف نشده) که قبلاً مستقیماً روی سرور خوانده اید (یا با a واکشی کرده اید
قبلی fetchmail --نگاه داشتن). اما ممکن است متوجه شوید که پیام هایی که قبلاً در آن خوانده اید
سرور در حال واکشی (و حذف) است، حتی زمانی که شما --all را مشخص نکرده باشید. وجود دارد
چندین دلیل ممکن است این اتفاق بیفتد

یکی می تواند این باشد که شما از POP2 استفاده می کنید. پروتکل POP2 شامل هیچ نمایشی از
وضعیت "جدید" یا "قدیمی" در پیام ها، بنابراین fetchmail باید همه پیام ها را به عنوان جدید در نظر بگیرند
زمان. اما POP2 منسوخ شده است، بنابراین بعید است.

یک مشکل بالقوه POP3 ممکن است سرورهایی باشد که پیام‌ها را در وسط صندوق‌های پستی وارد می‌کنند
(شایعه شده است که برخی از پیاده سازی های VMS از نامه این کار را انجام می دهند). در fetchmail کد فرض می کند
که پیام های جدید به انتهای صندوق پستی اضافه می شوند. وقتی این درست نیست ممکن است
برخی از پیام های قدیمی را به عنوان جدید و بالعکس در نظر بگیرید. استفاده از UIDL در هنگام تنظیم fastuidl 0 ممکن است
این مشکل را برطرف کنید، در غیر این صورت، تغییر به IMAP را در نظر بگیرید.

یکی دیگر از مشکلات POP3 این است که اگر نمی توانند در خانه کاربر فایل های tempfiles بسازند
دایرکتوری، برخی از سرورهای POP3 یک پاسخ غیرمستند را که باعث fetchmail می شود، پس می دهند
برای گزارش ساختگی "بدون نامه".

کد IMAP از وجود یا عدم وجود پرچم سرور \Seen برای تصمیم گیری در مورد یا عدم استفاده می کند
پیام جدیدی نیست این کار درستی نیست، fetchmail باید آن را بررسی کند
UIDVALIDIT و از UID استفاده کنید، اما هنوز این کار را انجام نمی دهد. تحت یونیکس، روی IMAP شما حساب می کند
سرور متوجه پرچم های وضعیت به سبک BSD است که توسط عوامل کاربر ایمیل تنظیم شده است و پرچم \Seen را تنظیم می کند.
در صورت لزوم از آنها همه سرورهای Unix IMAP که ما می شناسیم این کار را انجام می دهند، هرچند اینطور نیست
توسط RFC های IMAP مشخص شده است. اگر تا به حال به سروری برخورد کنید که این کار را نمی کند، علامت آن خواهد شد
پیام هایی که قبلاً در هاست خود خوانده اید برای سرور جدید به نظر می رسند. در این
مورد (بعید)، فقط پیام هایی که با آنها واکشی کرده اید fetchmail --نگاه داشتن هر دو حذف خواهند شد
و قدیمی علامت گذاری شد.

در حالت های ETRN و ODMR، fetchmail در واقع پیام ها را بازیابی نمی کند. در عوض، می پرسد
شنونده SMTP سرور برای شروع یک صف برای مشتری از طریق SMTP. بنابراین آن را
فقط پیام های ارسال نشده ارسال می کند.

هرزنامه فیلتر کردن

بسیاری از شنوندگان SMTP به مدیران اجازه می‌دهند تا «فیلترهای هرزنامه» را تنظیم کنند که ناخواسته را مسدود می‌کند
ایمیل از دامنه های مشخص شده خط MIL FROM یا DATA که این ویژگی را فعال می کند
ایجاد یک پاسخ SMTP که (متاسفانه) بسته به شنونده متفاوت است.

نسخه های جدیدتر از ارسال پست الکترونیکی کد خطای 571 را برگردانید.

با توجه به RFC2821، چیزی که صحیح است برای بازگشت در این شرایط 550 اینچ درخواست شده است
اقدام انجام نشد: صندوق پستی در دسترس نیست" (پیش نویس اضافه می کند: "[به عنوان مثال، صندوق پستی یافت نشد، نه
دسترسی، یا فرمان به دلایل سیاست رد شد].").

نسخه های قدیمی تر exim MTA 501 "خطای نحوی در پارامترها یا آرگومان ها" را برمی گرداند.

La پسوند MTA 554 را به عنوان پاسخ آنتی اسپم اجرا می کند.

Zmailer ممکن است کد با پاسخ 500 را رد کند (به دنبال آن یک کد وضعیت بهبودیافته که
حاوی اطلاعات بیشتری است).

کدهای برگرداندن که fetchmail به عنوان پاسخ های ضد هرزنامه تلقی می شود و پیام را نادیده می گیرد
با گزینه "antisspam" تنظیم کنید. این یکی از فقط سه شرایطی که تحت آن
fetchmail همیشه نامه را دور می زند (بقیه خطاهای 552 و 553 هستند که در زیر توضیح داده شده اند، و
حذف پیام‌های چند قطره‌شده با شناسه پیام قبلاً دیده شده است).

If fetchmail در حال واکشی از یک سرور IMAP، پاسخ آنتی اسپم شناسایی خواهد شد و
پیام بلافاصله پس از واکشی سرصفحه ها، بدون خواندن آن، رد می شود
بدنه ی پیام. بنابراین، شما برای دانلود پیام های هرزنامه هزینه ای نخواهید داشت.

به طور پیش فرض، لیست پاسخ های آنتی اسپم خالی است.

اگر هرزنامه گزینه سراسری روشن است، نامه‌هایی که از نظر هرزنامه مسدود شده‌اند، یک را راه‌اندازی می‌کنند
پیام پرش RFC1892/RFC1894 که به سازنده اطلاع می‌دهد که ما نامه‌ای از طرف را نمی‌پذیریم
آی تی. BUGS را نیز ببینید.

SMTP/ESMTP ERROR دستکاری

علاوه بر مسدود کردن هرزنامه که در بالا توضیح داده شد، fetchmail اقدامات خاصی را انجام می دهد - که ممکن است باشد
اصلاح شده توسط گزینه --softbounce — در کدهای پاسخ خطای SMTP/ESMTP زیر

452 (فضای ذخیره سازی سیستم کافی نیست)
پیام را برای بازیابی بعدی در صندوق پستی سرور بگذارید.

552 (پیام از حداکثر اندازه پیام بیشتر است)
پیام را از سرور حذف کنید. ارسال نامه برگشتی به مبتکر.

553 (دامنه ارسال نامعتبر)
پیام را از سرور حذف کنید. حتی سعی نکنید برای ارسال نامه برگشتی به
مبتکر

سایر خطاهای بزرگتر یا مساوی 500 باعث بازگشت ایمیل به مبدأ می شود، مگر اینکه
سرکوب شده توسط --softbounce. BUGS را نیز ببینید.

L' RUN کنترل فایل

روش ترجیحی برای تنظیم fetchmail نوشتن یک است .fetchmailrc فایل در خانه شما
دایرکتوری (شما می توانید این کار را به طور مستقیم، با یک ویرایشگر متن، یا غیر مستقیم از طریق انجام دهید fetchmailconf).
زمانی که بین آرگومان های خط فرمان و آرگومان های موجود در این تضاد وجود دارد
فایل، آرگومان های خط فرمان اولویت دارند.

برای محافظت از امنیت رمزهای عبور خود، ~/.fetchmailrc ممکن است به طور معمول بیشتر نداشته باشد
بیش از 0700 (u=rwx,g=,o=) مجوز. fetchmail شکایت خواهد کرد و در غیر این صورت خارج می شود (این
زمانی که --نسخه روشن است، چک سرکوب می شود.

شما می توانید .fetchmailrc فایل به عنوان لیستی از دستوراتی که باید اجرا شوند fetchmail is
بدون هیچ استدلالی تماس گرفت

دویدن کنترل نحو
نظرات با "#" شروع می شود و تا انتهای خط ادامه می یابد. در غیر این صورت فایل
متشکل از یک سری ورودی های سرور یا عبارت های گزینه سراسری در قالب آزاد،
نحو توکن گرا

چهار نوع نشانه وجود دارد: کلمات کلیدی دستور زبان، اعداد (یعنی دنباله های رقمی اعشاری)،
رشته های نقل قول نشده و رشته های نقل قول شده. یک رشته نقل‌قول‌شده با گیومه‌های دوبل و ممکن محدود می‌شود
حاوی فضای خالی (و ارقام نقل قول شده به عنوان یک رشته در نظر گرفته می شوند). توجه داشته باشید که رشته های نقل قول شده است
همچنین اگر در دو یا چند خط اجرا شود، کاراکترهای فید خط را شامل می شود، مگر اینکه شما
از بک اسلش برای پیوستن به خطوط استفاده کنید (به زیر مراجعه کنید). یک رشته بدون نقل قول هر فضای خالی محدود شده است
نشانه ای که نه عددی است، نه رشته ای نقل قول شده است و نه حاوی کاراکترهای خاص ',', ';',
':'، یا '='.

هر مقدار فضای خالی توکن ها را در ورودی های سرور جدا می کند، اما در غیر این صورت نادیده گرفته می شود. شما
ممکن است از دنباله‌های فرار بک اسلش استفاده کند (\n برای LF، \t برای HT، \b برای BS، \r برای CR، \nnn برای
اعشاری (که در آن nnn نمی تواند با 0 شروع شود)، \0OOO برای اکتال و \xhh برای هگز) تعبیه کردن
کاراکترهای غیر قابل چاپ یا جداکننده رشته ها در رشته ها. در رشته های نقل قول، یک بک اسلش
در انتهای یک خط باعث ایجاد بک اسلش و تغذیه خط می شود (LF یا NL، جدید
خط) کاراکتری که باید نادیده گرفته شود، به طوری که می توانید رشته های طولانی را بپیچید. بدون اسلش در
در انتهای خط، کاراکتر تغذیه خط بخشی از رشته می شود.

هشدار: در حالی که اینها شبیه توالی های فرار به سبک C هستند، یکسان نیستند. fetchmail
فقط از این هشت سبک پشتیبانی می کند. C از دنباله های فرار بیشتری پشتیبانی می کند که از
اسلش معکوس (\) و یک کاراکتر منفرد، اما از کدهای اعشاری پشتیبانی نمی کند و پشتیبانی نمی کند
به 0 پیشرو در نماد هشتی نیاز دارید. مثال: fetchmail \233 را به همان صورت تفسیر می کند
\xE9 (حرف کوچک لاتین e با حاد)، که در آن C \233 را به عنوان اکتال 0233 = \x9B تفسیر می کند
(CSI، معرفی کننده توالی کنترل).

هر ورودی سرور شامل یکی از کلیدواژه‌های «نظرسنجی» یا «پرش» و به دنبال آن یک سرور است
نام، به دنبال گزینه های سرور، و به دنبال آن هر تعداد کاربر (یا نام کاربری)
توضیحات و سپس گزینه های کاربر. توجه: شایع ترین علت خطاهای نحوی است
مخلوط کردن گزینه های کاربر و سرور یا قرار دادن گزینه های کاربر قبل از توضیحات کاربر.

برای سازگاری به عقب، کلمه "سرور" مترادف "نظرسنجی" است.

می‌توانید از کلیدواژه‌های نویز «و»، «با»، «دارا»، «می‌خواهد» و «گزینه‌ها» در هر جایی از
ورودی تا شبیه انگلیسی شود. آنها نادیده گرفته می شوند، اما می توانند ورودی ها را بسیار آسان تر کنند
برای خواندن در یک نگاه کاراکترهای نقطه گذاری ':', ';' و '،' نیز نادیده گرفته می شوند.

رای در مقابل پرش
فعل «نظرسنجی» به fetchmail می‌گوید که وقتی این میزبان بدون آرگومان اجرا می‌شود، پرس و جو کند. در
"پرش" فعل tells fetchmail این میزبان را نظرسنجی نکنید، مگر اینکه به صراحت در آن نامگذاری شده باشد
خط فرمان. (فعل "پرش" به شما امکان می دهد تا با خیال راحت ورودی های تست را آزمایش کنید، یا
به راحتی ورودی هاست هایی را که به طور موقت خاموش هستند غیرفعال کنید.)

کلمه کلیدی/گزینه خلاصه
در اینجا گزینه های قانونی وجود دارد. پسوند کلمات کلیدی محصور در کروشه اختیاری است.
موارد مربوط به گزینه های خط فرمان کوتاه با "-" و مناسب دنبال می شوند
نامه گزینه اگر گزینه فقط مربوط به یک حالت عملیاتی باشد، به عنوان یادداشت می شود
's' یا 'm' به ترتیب برای حالت تک قطره یا چند قطره.

در اینجا گزینه های جهانی قانونی وجود دارد:

عملکرد حالت انتخاب کلمه کلیدی
────────────────────────────────────────────────── ──────────────────
set daemon -d یک بازه نظرسنجی پس زمینه را تنظیم کنید
ثانیه صورت گرفت.
مجموعه پست مستر نام آخرین راه حل را بدهید
گیرنده نامه (پیش فرض: کاربر
در حال اجرا fetchmail، "postmaster" if
توسط کاربر ریشه اجرا می شود)
تنظیم bouncemail ایمیل خطای مستقیم به فرستنده
(به طور پیش فرض)
تنظیم no bouncemail ایمیل خطای مستقیم به محلی
مدیر پست (طبق
گزینه جهانی 'postmaster' در بالا).
بدون هرزنامه را تنظیم کنید نامه‌های مسدود شده با هرزنامه را ارسال نکنید
(پیش فرض)
تنظیم spambounce پرش ایمیل مسدود شده توسط هرزنامه مسدود شده
(طبق گفته کاربر 'antispam'
گزینه) بازگشت به مقصد به عنوان
نشان داده شده توسط 'bouncemail'
گزینه جهانی هشدار: نکن
از این برای بازگرداندن هرزنامه ها استفاده کنید
فرستنده - بیشتر هرزنامه ها ارسال می شود
با آدرس فرستنده نادرست و به این ترتیب
این گزینه به بی گناه آسیب می رساند
طرفداران
تنظیم بدون softbounce حذف برای همیشه غیر قابل تحویل
پست الکترونیکی استفاده از آن توصیه می شود
این گزینه در صورت پیکربندی
به طور کامل تست شده است
تنظیم softbounce به طور دائم غیر قابل تحویل نگه دارید
ایمیل به عنوان یک خطای موقت
رخ داده بود (پیش فرض).
تنظیم logfile -L نام یک فایل برای اضافه کردن خطا و
پیام های وضعیت به. فقط
موثر در حالت دیمون و اگر
fetchmail جدا می شود. در صورت موثر بودن،
نادیده گرفتن تنظیم syslog.
تنظیم idfile -i نام فایل برای ذخیره UID
لیست ها در
تنظیم syslog انجام خطا در ورود به سیستم
syslog(3). ممکن است توسط تنظیم
ورود به سیستم فایل.

تنظیم no syslog خاموش کردن خطای ورود به سیستم
syslog(3). (پیش فرض)
ویژگی های تنظیم مقدار رشته ای که توسط آن نادیده گرفته می شود
fetchmail (ممکن است توسط
اسکریپت های افزونه).

در اینجا گزینه های سرور قانونی وجود دارد:

عملکرد حالت انتخاب کلمه کلیدی
────────────────────────────────────────────────── ───────────────
از طریق تعیین نام DNS سرور ایمیل،
نام نظرسنجی مهم
proto[col] -p پروتکل را مشخص کنید (مورد
غیر حساس): POP2، POP3، IMAP،
APOP، KPOP
local[domains] m دامنه(های) مورد نظر را مشخص کنید
به عنوان محلی
پورت پورت سرویس TCP/IP را مشخص کنید
(منسوخ شده، به جای آن از «سرویس» استفاده کنید).
service -P نام سرویس را مشخص کنید (عددی
مقدار نیز مجاز است و
شماره پورت TCP/IP در نظر گرفته می شود).
authenticate نوع احراز هویت را تنظیم کنید (پیش‌فرض
"هر")
timeout -t زمان عدم فعالیت سرور در
ثانیه (پیش‌فرض 300)
envelope -E m هدر envelope-address را مشخص کنید
نام
بدون پاکت m جستجوی پاکت را غیرفعال کنید
نشانی
qvirtual -Q m پیشوند دامنه مجازی Qmail به
حذف از نام کاربری
aka m نام های جایگزین DNS را مشخص کنید
سرور پست الکترونیکی
رابط -من رابط(های) IP را مشخص می کنم که باید
آماده نظرسنجی سرور باشید
محل
monitor -M آدرس IP را برای نظارت مشخص کنید
فعالیت
افزونه دستور را مشخص کنید که از طریق آن
ایجاد اتصالات سرور
plugout دستور را مشخص کنید که از طریق آن
ایجاد ارتباط با شنونده
dns m جستجوی DNS را برای چند قطره فعال کنید
(به طور پیش فرض)
no dns m جستجوی DNS را برای چند قطره غیرفعال کنید
checkalias m مقایسه با آدرس IP برای
چند قطره
no checkalias m مقایسه با نام برای
چند قطره (پیش فرض)
uidl -U POP3 را برای استفاده از سمت مشتری مجبور می کند
UIDL (توصیه می شود)
no uidl استفاده از POP3 از سمت کلاینت را خاموش کنید
UIDL (پیش‌فرض)
فاصله زمانی فقط در هر نظرسنجی N این سایت را بررسی کنید
چرخه ها N یک آرگومان عددی است.
tracepolls اطلاعات ردیابی نظرسنجی را به
هدر دریافت شده
اصلی مجموعه Kerberos principal (فقط
مفید با IMAP و kerberos)
esmtpname نام را برای RFC2554 تنظیم کنید
احراز هویت به ESMTP
سرور
esmtppassword رمز عبور را برای RFC2554 تنظیم کنید
احراز هویت به ESMTP
سرور

bad-header چگونه با پیام های بد رفتار کنیم
سرتیتر. می تواند رد شود (پیش فرض) یا
تایید کنید.

در اینجا توضیحات و گزینه های قانونی کاربر آمده است:

عملکرد حالت انتخاب کلمه کلیدی
────────────────────────────────────────────────── ─────────────────
user[name] -u این توضیحات کاربر و
باید اول بعد از سرور باشد
توضیحات و پس از آن ممکن است
گزینه های سرور، و قبل از کاربر
گزینه.
این نام کاربری راه دور را در صورتی تنظیم می کند
خود یا به دنبال آن «آنجا» یا
نام کاربری محلی اگر دنبال شود
'اینجا'.
اتصال کاربر محلی و راه دور است
نام
برای اتصال کاربر محلی و راه دور
نام
pass[word] رمز عبور حساب راه دور را مشخص کنید
ssl اتصال به سرور از طریق
پروتکل پایه مشخص شده با استفاده از SSL
رمزگذاری
sslcert فایل را برای مشتری طرف
گواهی SSL عمومی
sslcertfile فایل را با CA قابل اعتماد مشخص کنید
گواهینامه ها
sslcertpath دایرکتوری c_rehash-ed را با مشخص کنید
گواهینامه های CA قابل اعتماد
sslkey فایل را برای مشتری طرف
کلید SSL خصوصی
پروتکل sslproto Force ssl برای اتصال
folder -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
خطوط از نامه های دریافتی
نوار تحویل داده شده به خطوط خارج از
نامه دریافتی
mimedecode تبدیل نقل قول-قابل چاپ به 8 بیت
در پیام های MIME
بیکار در حال انتظار برای پیام های جدید
بعد از هر نظرسنجی (فقط IMAP)
no keep -K پیام های دیده شده را از سرور حذف کنید
(به طور پیش فرض)
no flush همه پیام های دیده شده را پاک نکنید
قبل از پرس و جو (پیش فرض)
بدون واکشی فقط پیام های جدید را بازیابی کنید
(به طور پیش فرض)
بدون بازنویسی سرصفحه ها را بازنویسی نکنید
بدون stripcr آیا کالسکه برمی گرداند
(به طور پیش فرض)
بدون forcecr به اجبار کالسکه برگردد در
EOL (پیش‌فرض)
no pass8bits BODY=8BITMIME را به ESMTP مجبور نکنید
شنونده (پیش فرض)
بدون dropstatus سرصفحه های وضعیت را رها نکنید
(به طور پیش فرض)
بدون dropdelivered سرصفحه Delivered-To را رها نکنید
(به طور پیش فرض)
بدون mimedecode به نقل‌قول‌های قابل چاپ تبدیل نکنید
پیام‌های MIME 8 بیتی (پیش‌فرض)
بدون بیکار منتظر جدید نباشید
پیام ها بعد از هر نظرسنجی (IMAP
تنها)
limit -l محدودیت اندازه پیام را تنظیم کنید
warnings -w فاصله هشدار اندازه پیام را تنظیم کنید
batchlimit -b حداکثر # پیام برای بازارسال
تک اتصال
fetchlimit -B Max # پیام برای واکشی به صورت تکی
اتصال
fetchsizelimit حداکثر # اندازه پیام برای واکشی
معامله منفرد
fastuidl از جستجوی باینری برای اولین نادیده استفاده کنید
پیام (فقط POP3)
expunge -e در هر #ام یک exunge انجام دهید
پیام (فقط IMAP و POP3)
خواص مقدار رشته توسط نادیده گرفته می شود
fetchmail (ممکن است توسط
اسکریپت های افزونه)

همه گزینه های کاربر باید با توضیحات کاربر (گزینه کاربری یا نام کاربری) و به دنبال
تمام توضیحات و گزینه های سرور

در فایل fetchmailrc. ممکن است قبل از آرگومان رشته ای "envelope" یک فضای خالی وجود داشته باشد.
شماره جدا شده این عدد، در صورت مشخص شدن، تعداد چنین هدرهایی است که باید از آنها گذشت
(یعنی آرگومان 1 هدر دوم از نوع داده شده را انتخاب می کند). این زمانی است
مفید برای نادیده گرفتن هدرهای پاکت جعلی ایجاد شده توسط عامل تحویل محلی یک ISP یا
فورواردهای داخلی (به عنوان مثال از طریق سیستم های بازرسی پستی).

کلید واژه ها نه متناظر به گزینه سوئیچ
گزینه های 'folder' و 'smtphost' (برخلاف معادل های خط فرمان آنها) می توانند یک
لیستی از اسامی که پس از آنها با فاصله یا کاما جدا شده اند.

همه گزینه ها با آرگومان های خط فرمان آشکار مطابقت دارند، به جز موارد زیر: "از طریق"،
'فاصله'، 'با نام مستعار'، 'است'، 'به'، 'dns'/'بدون dns'، 'checkalias'/'بدون چکالیاس'، 'رمز عبور'،
"پیش اتصال"، "پس از اتصال"، "دامنه های محلی"، "stripcr"/"بدون stripcr"، "forcecr"/"خیر
forcecr'، 'pass8bits'/'no pass8bits' 'dropstatus/no dropstatus'، 'dropdelivered/no
dropdelived، «mimedecode/no mimedecode»، «بدون بی‌کار» و «بدون پاکت».

گزینه "از طریق" برای این است که اگر می خواهید بیش از یک پیکربندی داشته باشید که به آن اشاره می کند
همان سایت اگر وجود داشته باشد، آرگومان رشته ای به عنوان نام واقعی DNS در نظر گرفته می شود
میزبان ایمیل سرور برای پرس و جو. این آرگومان نظرسنجی را نادیده می گیرد، که پس از آن می تواند
به سادگی یک برچسب متمایز برای پیکربندی باشد (مثلاً آنچه که روی فرمان می دهید
خطی برای پرس و جوی صریح این میزبان).

گزینه "interval" (که یک آرگومان عددی را می گیرد) به شما امکان می دهد کمتر از یک سرور نظرسنجی کنید
اغلب از فاصله نظرسنجی اولیه. اگر می گویید "فاصله N" سرور این گزینه را دارد
پیوست شده است فقط از هر N بازه نظرسنجی پرس و جو می شود.

تک دراپ در مقابل چند قطره گزینه های
لطفا مطمئن شوید که قسمت عنوان شده را مطالعه کرده اید L' استفاده از و سو استفاده کردن OF چند قطره صندوق های پستی اگر شما
قصد استفاده از حالت چند قطره را دارند.

کلمات کلیدی "is" یا "to" نام(های) محلی (مشتری) (یا نام سرور) زیر را مرتبط می کنند.
به نگاشت نام کلاینت که با =) با نام کاربری mailserver در ورودی جدا شده است. اگر یک
فهرست is/to دارای «*» به عنوان نام خانوادگی است، اسامی ناشناخته به سادگی ارسال می شوند. توجه داشته باشید
که تا زمانی که fetchmail نسخه 6.3.4 شامل، این لیست ها فقط می توانند شامل بخش های محلی باشند
نام کاربری (fetchmail فقط به قسمت قبل از علامت @ نگاه می کند). fetchmail
نسخه های 6.3.5 و جدیدتر از آدرس های کامل در سمت چپ این نگاشت ها پشتیبانی می کنند.
و آنها بر هر گونه "localdomains"، "aka"، "via" یا نگاشتهای مشابه اولویت دارند.

یک نام محلی واحد می تواند برای پشتیبانی از تغییر مسیر ایمیل شما در زمانی که نام کاربری شما در آن قرار دارد استفاده شود
ماشین سرویس گیرنده با نام شما در سرور ایمیل متفاوت است. وقتی تنها یک تک وجود دارد
نام محلی، نامه بدون توجه به دریافت پیام به آن نام کاربری محلی ارسال می شود.
سرصفحه‌های به، رونوشت و رونوشت مخفی. در این مورد، fetchmail هرگز جستجوی DNS انجام نمی دهد.

هنگامی که بیش از یک نام محلی (یا نگاشت نام) وجود دارد، fetchmail به پاکت نگاه می کند
هدر، در صورت پیکربندی، و در غیر این صورت در سرصفحه های Received، To، Cc و Bcc بازیابی شده
نامه (این حالت چند قطره ای است). به دنبال آدرس هایی با قسمت های نام میزبان می گردد که مطابقت دارند
نام نظرسنجی شما یا گزینه های "از طریق"، "معروف" یا "localdomains" و معمولاً برای
قسمت‌های نام میزبان که DNS به آن می‌گوید نام مستعار سرور ایمیل هستند. بحث را ببینید
'dns'، 'checkalias'، 'localdomains'، و 'aka' برای جزئیات مربوط به نحوه تطبیق آدرس ها
رسیدگی شده

If fetchmail نمی تواند با نام کاربری سرور پست الکترونیکی یا آدرس های دامنه محلی مطابقت داشته باشد
منعکس شود. به طور معمول به فرستنده بازگردانده می شود، اما اگر 'bouncemail' جهانی باشد
گزینه خاموش است، در عوض نامه به مدیر پست محلی می رود. (به "مدیر پست" مراجعه کنید
گزینه جهانی). BUGS را نیز ببینید.

گزینه «dns» (معمولاً روشن) نحوه آدرس‌های صندوق‌های پستی چند قطره‌ای را کنترل می‌کند
بررسی شد. روشن، منطق را قادر می‌سازد تا هر آدرس میزبانی را که با 'aka' یا مطابقت ندارد بررسی کند
با جستجوی آن با DNS، اعلامیه 'localdomains'. زمانی که نام کاربری ایمیل سرور است
شناسایی می شود که به قسمت نام میزبان منطبق متصل است، نگاشت محلی آن به لیست اضافه می شود
گیرندگان محلی

گزینه «checkalias» (معمولاً خاموش) جستجوهای انجام شده توسط کلمه کلیدی «dns» را گسترش می دهد.
در حالت چند قطره، راهی برای مقابله با MTA های راه دور که خود را با استفاده از آن شناسایی می کنند، ارائه می دهد
نام متعارف آنها، در حالی که آنها با استفاده از نام مستعار نظرسنجی می شوند. وقتی چنین سروری نظرسنجی می شود،
چک می کند تا آدرس پاکت را استخراج کند، و fetchmail به تحویل با استفاده از
سرصفحه‌های To/Cc/Bcc (به زیر «سرصفحه در مقابل آدرس‌های پاکت» را ببینید). با مشخص کردن این گزینه
دستور می دهد fetchmail برای بازیابی تمام آدرس های IP مرتبط با هر دو نام نظرسنجی
و نام مورد استفاده توسط MTA راه دور و مقایسه آدرس های IP. این
در شرایطی که سرور راه دور تحت نام متعارف متداول قرار می گیرد مفید است
تغییراتی که در غیر این صورت نیاز به تغییراتی در فایل rc دارد. 'checkalias' ندارد
اگر "بدون dns" در فایل rc مشخص شده باشد اثر می گذارد.

گزینه "aka" برای استفاده با صندوق پستی چند قطره ای است. این به شما امکان می دهد یک لیست را از قبل اعلام کنید
نام مستعار DNS برای یک سرور. این یک هک بهینه سازی است که به شما امکان داد و ستد فضا را می دهد
برای سرعت چه زمانی fetchmail، در حین پردازش یک صندوق پستی چند قطره ای، از طریق پیام عبور می کند
سرصفحه‌هایی که به دنبال نام‌های سرور پست می‌گردند، از پیش اعلام می‌کنند که نام‌های معمولی می‌توانند آن را ذخیره کنند
نیاز به انجام جستجوی DNS. توجه: نام‌هایی که به عنوان آرگومان برای "aka" می‌دهید، مطابقت دارند
پسوندها -- اگر "معروف به netaxs.com" را مشخص کنید (مثلاً) ، این فقط با نام میزبان مطابقت ندارد
netaxs.com، اما هر نام میزبانی که به ".netaxs.com" ختم می شود؛ مانند (بگوییم) pop3.netaxs.com
و mail.netaxs.com.

گزینه "localdomains" به شما امکان می دهد لیستی از دامنه هایی را که fetchmail باید اعلام کنید
محلی را در نظر بگیرید هنگامی که fetchmail در حال تجزیه خطوط آدرس در حالت های چند قطره است، و a
بخش انتهایی نام میزبان با دامنه محلی اعلام شده مطابقت دارد، آن آدرس ارسال می شود
از طریق شنونده یا MDA بدون تغییر (نگاشتهای نام محلی هستند نه کاربردی).

اگر از 'localdomains' استفاده می کنید، ممکن است لازم باشد 'no envelope' را نیز مشخص کنید که
غیرفعال می کند fetchmailتلاش عادی برای استنباط آدرس پاکت از خط دریافتی
یا هدر X-Envelope-To یا هر سرصفحه ای که قبلاً توسط 'envelope' تنظیم شده است. اگر شما
"بدون پاکت" را در ورودی پیش‌فرض تنظیم کنید، می‌توانید آن را در ورودی‌های جداگانه لغو کنید
با استفاده از پاکت نامه '. به عنوان یک مورد خاص، "پاکت "دریافت"" را بازیابی می کند
تجزیه پیش فرض خطوط دریافتی

La کلمه عبور گزینه به آرگومان رشته ای نیاز دارد که رمز عبوری است که باید با آن استفاده شود
سرور ورودی

کلمه کلیدی "پیش اتصال" به شما امکان می دهد یک فرمان پوسته را مشخص کنید تا درست قبل از آن اجرا شود
هر زمان fetchmail یک ارتباط سرور ایمیل برقرار می کند. این ممکن است مفید باشد اگر شما هستید
تلاش برای راه اندازی اتصالات POP ایمن با کمک SSH(1). اگر فرمان
وضعیت غیر صفر را برمی گرداند، نظرسنجی آن ایمیل سرور لغو می شود.

به طور مشابه، کلمه کلیدی 'postconnect' به طور مشابه به شما امکان می دهد یک دستور پوسته را مشخص کنید
درست بعد از هر بار قطع شدن اتصال سرور ایمیل اجرا می شود.

گزینه "forcecr" کنترل می کند که آیا خطوطی که فقط با LF خاتمه می یابند CRLF داده می شوند یا خیر
فسخ قبل از ارسال به بیان دقیق، RFC821 به این نیاز دارد، اما تعداد کمی MTA
الزام آن را اجرا کنید تا این گزینه معمولاً خاموش باشد (فقط یکی از این MTA، qmail، در آن موجود است
استفاده قابل توجه در زمان نوشتن).

گزینه «stripcr» کنترل می‌کند که آیا بازگرداندن نامه‌های بازیابی شده حذف شود یا خیر.
قبل از ارسال آن معمولاً لازم نیست این را تنظیم کنید، زیرا به طور پیش فرض روی آن تنظیم شده است
«روشن» (برداشتن CR فعال است) وقتی MDA اعلام شده است اما «خاموش» (CR stripping)
غیرفعال) هنگامی که ارسال از طریق SMTP است. اگر «stripcr» و «forcecr» هر دو روشن هستند، «stripcr»
لغو خواهد شد.

گزینه "pass8bits" برای مقابله با برنامه های پست الکترونیکی مایکروسافت وجود دارد که احمقانه به یک سیلی می زند.
"Content-Transfer-Encoding: 7bit" روی همه چیز. با این گزینه خاموش (پیش فرض) و
چنین هدری وجود دارد، fetchmail BODY=7BIT را به شنونده ای با قابلیت ESMTP اعلام می کند. این
در واقع با استفاده از مجموعه کاراکترهای 8 بیتی ISO یا KOI-8 پیام‌ها را با مشکل مواجه می‌کند
با از بین بردن بیت های بالای همه کاراکترها، گیج شوید. اگر «pass8bits» روشن باشد،
fetchmail مجبور است BODY=8BITMIME را به هر شنونده ای با قابلیت ESMTP اعلام کند. اگر
شنونده 8 بیتی تمیز است (همانطور که همه موارد اصلی در حال حاضر هستند) احتمالاً چیز درستی خواهد بود
نتيجه

گزینه "dropstatus" کنترل می کند که آیا خطوط وضعیت غیرخالی و X-Mozilla-Status هستند یا خیر.
در نامه‌های واکشی شده (پیش‌فرض) نگهداری یا دور انداخته شده است. حفظ آنها به MUA شما اجازه می دهد
ببینید چه پیام هایی (در صورت وجود) در سرور مشخص شده اند. از طرفی می تواند
برخی از اعلان‌کننده‌های ایمیل جدید را گیج کنید، که فرض می‌کنند هر چیزی که در آن خط وضعیت وجود دارد، وجود دارد
دیده شده. (توجه: خطوط وضعیت خالی درج شده توسط برخی از سرورهای POP باگ هستند
بدون قید و شرط کنار گذاشته شده است.)

گزینه 'dropdelivered' کنترل می کند که آیا سرصفحه های Delivered-To در واکشی نگه داشته شوند یا خیر
پست (پیش فرض) یا دور انداخته شده است. این هدرها توسط ایمیل سرورهای Qmail و Postfix اضافه می شوند
به منظور جلوگیری از حلقه‌های ایمیل
در همان دامنه با احتیاط استفاده کنید.

گزینه "mimedecode" کنترل می کند که آیا پیام های MIME با استفاده از رمزگذاری قابل چاپ نقل قول ارسال می شود یا خیر
به طور خودکار به داده های 8 بیتی خالص تبدیل می شوند. اگر نامه را به ESMTP تحویل می دهید
شنونده 8 بیتی قادر و تمیز (که شامل تمام MTAهای اصلی مانند sendmail می شود)، سپس
این به طور خودکار سرصفحه ها و داده های پیام قابل چاپ با نقل قول را به داده های 8 بیتی تبدیل می کند.
درک آن را هنگام خواندن نامه آسان تر می کند. اگر برنامه های ایمیل شما می دانند که چگونه با آن برخورد کنند
با پیام های MIME، پس این گزینه مورد نیاز نیست. گزینه mimedecode خاموش است
به طور پیش فرض، زیرا انجام تبدیل RFC2047 روی هدرها، اطلاعات مجموعه کاراکترها را دور می اندازد
و اگر رمزگذاری هدرها با کدگذاری بدنه متفاوت باشد، می تواند منجر به نتایج بد شود.

گزینه "idle" برای استفاده با سرورهای IMAP در نظر گرفته شده است که از RFC2177 IDLE پشتیبانی می کنند.
پسوند فرمان، اما به شدت به آن نیاز ندارد. اگر فعال است، و fetchmail
تشخیص می دهد که IDLE پشتیبانی می شود، یک IDLE در پایان هر نظرسنجی صادر می شود. این اراده
به سرور IMAP بگویید اتصال را باز نگه دارد و هنگام ارسال نامه جدید به مشتری اطلاع دهد
در دسترس. اگر IDLE پشتیبانی نمی شود، fetchmail آن را با انتشار دوره ای شبیه سازی می کند
NOOP. اگر نیاز به نظرسنجی مکرر از یک پیوند دارید، IDLE می تواند با حذف TCP/IP پهنای باند را ذخیره کند.
وصل می شود و دنباله های LOGIN/LOGOUT. از سوی دیگر، یک اتصال IDLE تقریبا می خورد
تمام وقت fetchmail شما است، زیرا هرگز اتصال را قطع نمی کند و به دیگران اجازه نمی دهد
نظرسنجی انجام می شود مگر اینکه زمان سرور IDLE را به پایان برساند. همچنین با چندگانه کار نمی کند
پوشه ها؛ فقط اولین پوشه مورد نظرسنجی قرار خواهد گرفت.

گزینه 'properties' یک مکانیسم توسعه است. یک آرگومان رشته ای می گیرد که این است
توسط خود fetchmail نادیده گرفته شد. آرگومان رشته ممکن است برای ذخیره پیکربندی استفاده شود
اطلاعات برای اسکریپت هایی که به آن نیاز دارند. به طور خاص، خروجی "--configdump"
گزینه ویژگی های مرتبط با ورودی کاربر را به راحتی در دسترس پایتون قرار می دهد
اسکریپت

متفرقه دویدن کنترل گزینه
کلمات "اینجا" و "آنجا" اهمیتی شبیه به انگلیسی دارند. به طور معمول کاربر اریک
esr است به این معنی است که نامه برای کاربر راه دور 'eric' باید به 'esr' تحویل داده شود، اما
می‌توانید با گفتن «user eric there is esr here» این را واضح‌تر کنید، یا با گفتن آن را برعکس کنید
'user esr در اینجا اریک است'

شناسه‌های پروتکل قانونی برای استفاده با کلمه کلیدی «پروتکل» عبارتند از:

خودکار (یا AUTO) (میراثی که از نسخه بعدی حذف می شود)
pop2 (یا POP2) (میراثی که از نسخه بعدی حذف می شود)
pop3 (یا POP3)
sdps (یا SDPS)
imap (یا IMAP)
apop (یا APOP)
kpop (یا KPOP)

انواع احراز هویت قانونی عبارتند از 'any'، 'password'، 'kerberos'، 'kerberos_v4'، 'kerberos_v5'
و 'gssapi'، 'cram-md5'، 'otp'، 'msn' (فقط برای POP3)، 'ntlm'، 'ssh'، 'external' (فقط
IMAP). نوع "گذرواژه" احراز هویت با ارسال عادی رمز عبور را مشخص می کند
(رمز عبور ممکن است متن ساده یا مشمول رمزگذاری خاص پروتکل مانند CRAM- باشد.
MD5)؛ 'kerberos' می گوید fetchmail سعی کنید در شروع هر یک بلیط Kerberos بگیرید
به جای آن پرس و جو کنید و یک رشته دلخواه را به عنوان رمز عبور ارسال کنید. و 'gssapi' به fetchmail می گوید
برای استفاده از احراز هویت GSSAPI. برای اطلاعات بیشتر به توضیحات کلمه کلیدی 'auth' مراجعه کنید.

تعیین «kpop» پروتکل POP3 را روی پورت 1109 با احراز هویت Kerberos V4 تنظیم می‌کند.
این پیش فرض ها ممکن است توسط گزینه های بعدی لغو شوند.

برخی از عبارات گزینه سراسری وجود دارد: 'set logfile' به دنبال آن یک رشته یکسان است
جهانی مشخص شده توسط --logfile. یک گزینه --logfile در خط فرمان این گزینه را لغو می کند. توجه داشته باشید
که --logfile تنها در صورتی موثر است که fetchmail خود را از ترمینال و از ترمینال جدا کند
logfile قبل از اجرای fetchmail وجود دارد و در این مورد --syslog را لغو می کند.
همچنین، 'set daemon' بازه نظرسنجی را به صورت --daemon تنظیم می کند. این را می توان با الف نادیده گرفت
گزینه خط فرمان --daemon. به ویژه --daemon 0 را می توان برای ایجاد پیش زمینه استفاده کرد
عمل. عبارت «set postmaster» آدرسی را تعیین می‌کند که چند قطره ایمیل به آن ارسال می‌شود
اگر مطابقت محلی وجود نداشته باشد، پیش‌فرض است. در نهایت، 'set syslog' پیام های ورود به سیستم را ارسال می کند
syslogd(8).

اشکال زدایی FETCHMAIL

واکشی ایمیل توفنده
راه های مختلفی وجود دارد که fetchmail ممکن است "خراش" کند، یعنی عملیات را به طور ناگهانی متوقف کند و
بر خلاف انتظار. «خرابی» معمولاً به یک وضعیت خطایی اشاره دارد که نرم افزار انجام نداده است
به خودی خود رسیدگی کند یک حالت خرابی شناخته شده "عیب قطعه بندی" یا "سیگنال 11" یا
"SIGSEGV" یا فقط "segfault" به اختصار. اینها می تواند ناشی از سخت افزار یا نرم افزار باشد
چالش ها و مسائل. Segfault های ناشی از نرم افزار معمولاً می توانند به راحتی و به صورت یکسان بازتولید شوند
مکان، در حالی که اگر کامپیوتر دوباره راه اندازی شود، خطاهای سخت افزاری می توانند از بین بروند، یا
برای چند ساعت خاموش می شود و ممکن است در مکان های تصادفی اتفاق بیفتد حتی اگر از آن استفاده کنید
نرم افزار به همین صورت

برای حل خطاهای سخت افزاری، قطعه معیوب را پیدا کنید و تعمیر یا تعویض کنید
آی تی. سوالات متداول Sig11 ⟨http://www.bitwizard.nl/sig11/⟩ ممکن است در جزئیات به شما کمک کند.

برای حل خطاهای ناشی از نرم‌افزار، توسعه‌دهندگان ممکن است به یک «پشت ردیابی» نیاز داشته باشند.

را قادر می سازد fetchmail هسته تخلیه
به‌طور پیش‌فرض، fetchmail حذف‌های اصلی را سرکوب می‌کند، زیرا ممکن است حاوی رمزهای عبور و موارد دیگر باشد
اطلاعات حساس. برای اشکال‌زدایی خرابی‌های fetchmail، به‌دست آوردن یک «پس‌ترس پشته» از
یک کمپرسی اصلی اغلب سریع‌ترین راه برای حل مشکل و هنگام ارسال مشکل است
در یک لیست پستی، توسعه دهندگان ممکن است از شما درخواست کنند که یک "بازگشت".

1. برای بدست آوردن بک تریس مفید، fetchmail باید بدون حذف شدن نصب شود
نمادهای تلفیقی آن متأسفانه اکثر بسته های باینری نصب شده هستند
stripped، و فایل های اصلی از برنامه های حذف نماد بی ارزش هستند. بنابراین ممکن است نیاز داشته باشید
fetchmail را دوباره کامپایل کنید در بسیاری از سیستم ها می توانید تایپ کنید

فایل "which fetchmail".

برای اینکه بفهمیم fetchmail دارای نماد حذف شده است یا خیر. اگر مال شما خالی بود، خوب،
ادامه دهید، اگر حذف شد، ابتدا باید کد منبع را دوباره کامپایل کنید. شما نمی کنید
معمولاً برای رفع اشکال باید fetchmail را نصب کنید.

2. محیط پوسته‌ای که fetchmail را شروع می‌کند باید core dumps را فعال کند. کلید این است
"حداکثر اندازه هسته (فایل)" که معمولاً می تواند با ابزاری به نام "limit" یا پیکربندی شود.
"اولیمیت". برای جزئیات بیشتر به اسناد پوسته خود مراجعه کنید. در پوسته محبوب bash،
"ulimit -Sc unlimited" اجازه می‌دهد که هسته اصلی تخلیه شود.

3. شما باید به fetchmail نیز بگویید تا اجازه تخلیه هسته را بدهد. برای انجام این کار، fetchmail را با اجرا کنید
la -d0 -v گزینه ها. همچنین اضافه کردن آن اغلب ساده تر است --nosyslog -N نیز هست.

در نهایت، شما باید خرابی را بازتولید کنید. شما فقط می توانید fetchmail را از دایرکتوری شروع کنید
جایی که با تایپ کردن آن را کامپایل کردید ./fetchmail، بنابراین خط فرمان کامل با شروع خواهد شد
./fetchmail -Nvd0 --nosyslog و شاید گزینه های دیگر خود را لیست کنید.

پس از خرابی، دیباگر خود را اجرا کنید تا هسته dump را بدست آورید. اشکال زدا اغلب خواهد بود
GNU GDB، سپس می توانید تایپ کنید (مسیرها را در صورت لزوم تنظیم کنید) gdb ./fetchmail fetchmail.core و
سپس، پس از راه اندازی GDB و خواندن تمام فایل های آن، تایپ کنید ردیابی کامل، ذخیره کنید
خروجی (کپی و چسباندن انجام می شود، بک ردیابی توسط یک انسان خوانده می شود) و سپس تایپ کنید ترک به
gdb را ترک کنید توجه داشته باشید: در برخی از سیستم ها، فایل های اصلی نام های متفاوتی دارند، ممکن است حاوی باشند
یک عدد به جای نام برنامه، یا شماره و نام، اما معمولا دارای "هسته" است.
به عنوان بخشی از نام آنها

اثر متقابل با RFC 822

هنگام تلاش برای تعیین آدرس مبدا یک پیام، fetchmail به بررسی آن می پردازد
سرصفحه ها به ترتیب زیر:

راه برگشت:
ارسال مجدد: (اگر حاوی @ یا ! نباشد نادیده گرفته می شود)
فرستنده: (اگر حاوی @ یا ! نباشد نادیده گرفته می شود)
ارسال مجدد-از:
از جانب:
پاسخ دادن به:
ظاهرا-از:

آدرس مبدأ برای ورود به سیستم و برای تنظیم آدرس MAIL FROM زمانی استفاده می شود
ارسال به SMTP این سفارش برای مقابله با ظرافت با دریافت لیست پستی در نظر گرفته شده است
پیام ها در حالت چند قطره هدف این است که اگر یک آدرس محلی وجود نداشته باشد،
پیام پرش کورکورانه به نویسنده یا خود لیست بازگردانده نمی شود، بلکه بیشتر است
به مدیر لیست (که کمتر آزاردهنده است).

در حالت چند قطره، سرصفحه های مقصد به صورت زیر پردازش می شوند: اول، fetchmail به نظر می رسد
برای هدر مشخص شده توسط گزینه 'پاکت' به منظور تعیین محلی
آدرس گیرنده. اگر آدرس نامه به بیش از یک گیرنده باشد، خط دریافت شده است
هیچ اطلاعاتی در مورد آدرس گیرنده نخواهد داشت.

سپس fetchmail به دنبال خطوط Resent-To:، Resent-Cc: و Resent-Bcc: می گردد. اگر آنها
وجود داشته باشند، آنها باید حاوی گیرندگان نهایی باشند و بر آنها ارجحیت داشته باشند
به:/Cc:/BCC: همتایان. اگر خطوط Resent-* وجود نداشته باشند، To:، Cc:، Bcc: و
ظاهراً به: خطوط جستجو می شوند. (وجود Resent-To: به معنای آن است
شخص ارجاع شده توسط آدرس To: قبلاً نسخه اصلی آن را دریافت کرده است
پست.)

پیکربندی مثال ها

توجه داشته باشید که اگرچه در بسیاری از مثال‌های زیر اعلان‌های رمز عبور وجود دارد،
این عمدتا برای اهداف توضیحی است. توصیه می‌کنیم جفت‌های حساب/رمز عبور را ذخیره کنید
فایل $HOME/.netrc شما، که در آن نه تنها توسط fetchmail بلکه توسط می توان از آنها استفاده کرد اف تی پی(1) و
برنامه های دیگر

قالب اصلی این است:

نظرسنجی نام ارائهکننده پروتکل پروتکل نام کاربری نام کلمه عبور PASSWORD

مثال:

نظرسنجی pop.provider.net پروتکل pop3 نام کاربری "jsmith" رمز عبور "secret1"

یا با استفاده از چند اختصار:

نظرسنجی pop.provider.net پروتو pop3 کاربر "jsmith" رمز عبور "secret1"

ممکن است چندین سرور فهرست شود:

نظرسنجی pop.provider.net پروتو pop3 کاربر "jsmith" پاس "secret1"
نظرسنجی other.provider.net پروتو pop2 کاربر "John.Smith" پاس "My^Hat"

در اینجا همان نسخه با فضای خالی بیشتر و کلمات نویز وجود دارد:

نظرسنجی pop.provider.net proto pop3
کاربر "jsmith" با رمز عبور Secret1 در اینجا "jsmith" است.
نظرسنجی other.provider.net proto pop2:
کاربر "John.Smith" با رمز عبور "My^Hat" در اینجا "John.Smith" است.

اگر نیاز دارید که فضای خالی را در یک رشته پارامتر وارد کنید یا دومی را با یک عدد شروع کنید،
رشته را در دو گیومه قرار دهید. بدین ترتیب:

نظرسنجی mail.provider.net با پروتو pop3:
کاربر "jsmith" رمز عبور "4u" دارد اما شما نمی توانید این را کرک کنید.
jws اینجاست و mda "/bin/mail" را می خواهد

ممکن است یک توضیح اولیه سرور داشته باشید که به جای کلمه کلیدی «پیش‌فرض» قرار دارد
"نظرسنجی" به دنبال یک نام. چنین رکوردی به عنوان پیش فرض برای همه پرس و جوها تفسیر می شود
استفاده کنید. ممکن است توسط توضیحات سرور جداگانه بازنویسی شود. بنابراین، می توانید بنویسید:

به طور پیش فرض proto pop3
کاربر "jsmith"
نظرسنجی pop.provider.net
عبور از "secret1"
نظرسنجی mail.provider.net
کاربر "jjsmith" دارای رمز عبور "secret2" است.

امکان تعیین بیش از یک کاربر در هر سرور وجود دارد. کلمه کلیدی 'کاربر' منجر به a
توضیحات کاربر، و هر مشخصات کاربر در یک ورودی چند کاربره باید شامل آن باشد.
مثالی در اینجا آورده شده است:

poll pop.provider.net proto pop3 port 3111
کاربر "jsmith" با پاس "secret1" در اینجا "اسمیت" است
کاربر جونز با پاس "secret2" در اینجا "jjones" است

این نام کاربری محلی 'smith' را با نام کاربری pop.provider.net 'jsmith' مرتبط می کند و
نام کاربری محلی 'jjones' با نام کاربری pop.provider.net 'jones'. نامه برای 'جونز'
پس از دانلود روی سرور نگهداری می شود.

در اینجا یک پیکربندی بازیابی ساده برای یک صندوق پستی چند قطره به نظر می رسد:

نظرسنجی pop.provider.net:
ارسال نامه کاربر با pass secret1 به golux 'hurkle'='happy' اینجا snark

این می گوید که صندوق پستی حساب 'maildrop' در سرور یک جعبه چند قطره است و
که پیام های موجود در آن باید برای نام های کاربر سرور 'golux'، 'hurkle'، و
'snark'. همچنین مشخص می کند که "golux" و "snark" نام یکسانی روی مشتری دارند
مانند سرور، اما نامه برای کاربر سرور 'hurkle' باید به کاربر مشتری تحویل داده شود
'خوشحال'.

توجه داشته باشید که واکشی، تا نسخه 6.3.4، مشخصات کامل user@domain را مجاز نمی دانست
در اینجا، اینها هرگز مطابقت ندارند. واکشی ایمیل 6.3.5 و جدیدتر از user@domain پشتیبانی می کند
مشخصات در سمت چپ نقشه کاربر.

در اینجا نمونه ای از نوع دیگری از اتصال چند قطره ای آورده شده است:

نظرسنجی pop.provider.net localdomains loonytoons.org toons.org
پاکت X-Envelope-To
پست الکترونیکی کاربر با pass secret1 به * در اینجا

این همچنین می گوید که صندوق پستی حساب 'maildrop' در سرور یک جعبه چند قطره است.
به fetchmail می گوید که هر آدرسی در دامنه های loonytoons.org یا toons.org (از جمله
آدرس های زیر دامنه مانند '[ایمیل محافظت شده]') باید از طریق به
شنونده محلی SMTP بدون تغییر. اگر این کار را می کنید مراقب حلقه های نامه باشید!

در اینجا یک نمونه پیکربندی با استفاده از ssh و گزینه افزونه آورده شده است. پرس و جوها انجام می شود
مستقیماً روی stdin و stdout imapd از طریق ssh. توجه داشته باشید که در این تنظیمات، IMAP
احراز هویت را می توان نادیده گرفت.

نظرسنجی mailhost.net با پروتو ایمپ:
پلاگین "ssh %h /usr/sbin/imapd" auth ssh;
کاربر esr در اینجا esr است

L' استفاده از و سو استفاده کردن OF چند قطره صندوق های پستی

از ویژگی گیرندگان چندگانه محلی با احتیاط استفاده کنید -- ممکن است گاز بگیرد. همه چند قطره
ویژگی ها در حالت های ETRN و ODMR بی اثر هستند.

همچنین، توجه داشته باشید که در حالت چند قطره، ایمیل های تکراری سرکوب می شوند. یک قطعه نامه است
اگر شناسه پیام مشابه پیام بلافاصله قبل باشد، تکراری در نظر گرفته می شود
و بیش از یک مخاطب چنین اجراهایی از پیام‌ها ممکن است هنگام کپی‌هایی از a ایجاد شوند
پیام خطاب به چندین کاربر به یک جعبه چند قطره تحویل داده می شود.

سربرگ در مقابل پاکت آدرس
مشکل اساسی این است که با قرار دادن ایمیل سرور شما، نامه چند نفر را در یک پرتاب می کند
یک صندوق پستی، ممکن است اطلاعات بالقوه حیاتی در مورد هر کدام را دور انداخته باشید
ایمیل در واقع به ("آدرس پاکت" بر خلاف هدر آدرس داده شد
آدرس‌های موجود در هدرهای RFC822 To/Cc - Bcc در انتهای دریافت کننده موجود نیست).
این "آدرس پاکت" آدرسی است که برای تغییر مسیر نامه به درستی نیاز دارید.

بعضی وقتها fetchmail می تواند آدرس پاکت را استنباط کند. اگر میل سرور MTA باشد ارسال پست الکترونیکی
و مرسوله نامه فقط یک گیرنده داشت، MTA یک بند "by/for" خواهد نوشت.
که مخاطب پاکت را در هدر Received خود قرار می دهد. اما این به طور قابل اعتماد کار نمی کند
برای سایر MTAها، و نه اگر بیش از یک گیرنده وجود داشته باشد. به صورت پیش فرض، fetchmail جستجو میکند
آدرس پاکت در این خطوط؛ می توانید این پیش فرض را با -E "Received" یا بازیابی کنید
"پاکت دریافت شد".

As a بهتر جایگزین، برخی از شنوندگان SMTP و/یا سرورهای پستی یک هدر در هر کدام قرار می دهند
پیام حاوی یک کپی از آدرس پاکت. این هدر (در صورت وجود) است
اغلب «X-Original-To»، «Delivered-To» یا «X-Envelope-To». فرض Fetchmail در مورد
این را می توان با -E یا گزینه 'پاکت' تغییر داد. توجه داشته باشید که یک پاکت نامه بنویسید
هدر از این نوع نام گیرندگان (از جمله گیرندگان کپی کور) را در معرض دید قرار می دهد.
همه گیرندگان پیام ها، بنابراین بالادست باید یک کپی از پیام را در هر ذخیره کند
گیرنده برای جلوگیری از تبدیل شدن به یک مشکل حفظ حریم خصوصی.

Postfix، از نسخه 2.0، یک هدر X-Original-To: می نویسد که حاوی یک کپی از
پاکت نامه همانطور که دریافت شد

Qmail و Postfix معمولاً پس از تحویل پیام، سرصفحه "Delivered-To" می نویسند
قرقره نامه و از آن برای جلوگیری از حلقه های نامه استفاده کنید. دامنه های مجازی Qmail با این حال پیشوند خواهند بود
نام کاربری با رشته ای که معمولاً با دامنه کاربر مطابقت دارد. برای حذف این پیشوند
می توانید از گزینه -Q یا 'qvirtual' استفاده کنید.

گاهی متأسفانه هیچ کدام از این روش ها جواب نمی دهد. این نقطه زمانی است که شما
باید با ISP خود تماس بگیرید و از آنها بخواهید که چنین هدر پاکتی را ارائه دهند، و شما باید
در این شرایط از چند قطره استفاده نکنید. وقتی همه آنها شکست می خورند، fetchmail باید دوباره روی آن بیفتد
محتویات سرصفحه‌های To/Cc (سرصفحه‌های رونوشت مخفی در دسترس نیستند - به زیر مراجعه کنید) سعی کنید تعیین کنید
مخاطبان گیرنده -- و اینها غیرقابل اعتماد هستند. به ویژه، نرم افزار لیست پستی
اغلب نامه را فقط با آدرس پخش لیست در سرصفحه To ارسال می کند.

توجه داشته باشید که a آینده نسخه of fetchmail ممکن است برداشتن به/رایگان تجزیه!

چه زمانی fetchmail نمی تواند یک آدرس گیرنده را استنباط کند که محلی است و گیرنده مورد نظر
آدرس هر کسی غیر از کاربر فراخوان کننده fetchmail بود، پست اراده دریافت کنید کم شده. این چیزی است که
بدون اطلاعات پاکت مناسب، ویژگی چند قطره را خطرناک می کند.

یک مشکل مرتبط این است که وقتی یک پیام ایمیل را کورکورانه کپی می کنید، اطلاعات Bcc وجود دارد
انجام فقط به عنوان آدرس پاکت نامه (از سربرگ ها توسط نامه ارسال شده حذف می شود
سرور، بنابراین fetchmail تنها در صورتی می تواند آن را ببیند که هدر X-Envelope-To وجود داشته باشد). بنابراین، کور-
کپی کردن برای کسی که ایمیل را از طریق پیوند چند قطره fetchmail دریافت می کند با شکست مواجه می شود مگر اینکه این
میزبان میل سرور به طور معمول X-Envelope-To یا یک هدر معادل آن را در پیام ها می نویسد.
پست نامه شما

In در نهایت، پستی liste و کپی کپی پست می توان فقط کار if la سرور شما هستید واکشی
از جانب

(1) پرده یک کپی کنید of la پیام برای گیرنده in خود را دامنه و

(2) سوابق la پاکت اطلاعات in a ویژه هدر (X-Original-To, تحویل به،
X-Envelope-To).

خوب راه ها به استفاده کنید چند قطره صندوق های پستی
از چندین نام محلی می توان برای مدیریت یک لیست پستی از سمت مشتری a استفاده کرد
fetchmail مجموعه. فرض کنید نام شما 'esr' است و می خواهید هر دو نام خود را انتخاب کنید
پست کنید و یک لیست پستی به نام (مثلاً) "fetchmail-friends" نگه دارید، و می خواهید آن را نگه دارید
لیست نام مستعار در دستگاه مشتری شما.

در سرور خود، می توانید با نام مستعار 'fetchmail-friends' به 'esr'; سپس، در شما .fetchmailrc,
اعلام «به esr fetchmail-friends here». سپس، هنگامی که ایمیل شامل 'fetchmail-friends' به عنوان
یک آدرس محلی واکشی می شود، نام لیست به لیست گیرندگان اضافه می شود
شنونده SMTP شما می بیند. بنابراین به صورت محلی تحت گسترش مستعار قرار خواهد گرفت. حتما
'esr' را در گسترش نام مستعار محلی fetchmail-friends بگنجانید، در غیر این صورت هرگز ایمیل را نخواهید دید
فقط به لیست ارسال می شود. همچنین مطمئن شوید که شنونده شما گزینه "me-too" را تنظیم کرده است
(گزینه خط فرمان -oXm sendmail یا اعلان OXm) بنابراین نام شما از آن حذف نشود
گسترش نام مستعار در پیام هایی که ارسال می کنید.

اما این ترفند خالی از اشکال نیست. شما شروع به دیدن این زمانی که یک پیام است
می آید که فقط به لیست پستی شما خطاب می شود نه محلی اعلام کرده اند
نام. هر یک از این پیام‌ها دارای یک هدر «X-Fetchmail-Warning» است که تولید می‌شود
زیرا fetchmail نمی تواند یک نام محلی معتبر در آدرس های گیرنده پیدا کند. چنین
پیام ها به طور پیش فرض (همانطور که در بالا توضیح داده شد) برای ارسال به کاربر محلی در حال اجرا است
fetchmail، اما برنامه راهی برای دانستن اینکه واقعاً کار درستی است ندارد.

بد راه ها به توهین چند قطره صندوق های پستی
صندوق پست چند قطره و fetchmail سرویس دهی به چندین کاربر در حالت دیمون با هم ترکیب نمی شوند. در
مشکل، مجدداً، نامه‌ای از فهرست‌های پستی است که معمولاً فردی ندارد
آدرس گیرنده روی آن مگر اینکه fetchmail می تواند یک آدرس پاکت استنباط، چنین نامه ای خواهد شد
فقط به حسابی که fetchmail را اجرا می کند (احتمالاً روت) بروید. همچنین، کاربران کور کپی شده هستند
به احتمال زیاد هرگز ایمیل آنها را نبینند.

اگر وسوسه شدید استفاده کنید fetchmail برای بازیابی نامه برای چندین کاربر از یک نامه واحد
از طریق POP یا IMAP رها کنید، دوباره فکر کنید (و قسمت آدرس هدر و پاکت را دوباره بخوانید
در بالا). هوشمندانه تر است که فقط اجازه دهید نامه در صف سرور پست الکترونیکی قرار گیرد و از آن استفاده کند
حالت‌های ETRN یا ODMR fetchmail برای راه‌اندازی SMTP ارسال‌های دوره‌ای (البته، به این معنی است که
شما باید بیشتر از دوره انقضای سرور ایمیل نظرسنجی کنید). اگر نمی توانید
این را ترتیب دهید، سعی کنید یک فید UUCP تنظیم کنید.

اگر شما کاملا باید برای این منظور از multidrop استفاده کنید، مطمئن شوید که سرور ایمیل شما یک علامت می نویسد
هدر envelope-address که fetchmail می تواند ببیند. وگرنه تو اراده از دست دادن نامه و آن اراده
برای تعقیب شما برگرد

سرعت بالا Up چند قطره بررسی
به طور معمول، زمانی که چندین کاربر اعلام می شوند fetchmail آدرس های گیرنده را به عنوان استخراج می کند
در بالا توضیح داده شد و هر قسمت میزبان را با DNS بررسی می کند تا ببیند آیا نام مستعار آن است یا خیر
سرور پست الکترونیکی اگر چنین است، نگاشت نام شرح داده شده در اعلان "به ... اینجا" انجام می شود
و پست به صورت محلی تحویل داده شد.

این یک روش راحت اما در عین حال کند است. برای سرعت بخشیدن به آن، نام مستعار mailserver را از قبل اعلام کنید
با "معروف"؛ اینها قبل از انجام جستجوهای DNS بررسی می شوند. اگر مطمئن هستید با نام مستعار خود
لیست شامل تمام نام مستعار DNS سرور پست الکترونیکی (و همه نام های MX که به آن اشاره می کنند - توجه داشته باشید
این ممکن است در یک نسخه آینده تغییر کند) می توانید برای سرکوب جستجوهای DNS "بدون dns" را اعلام کنید
به طور کامل و فقط مسابقه با لیست آکا

SOCKS

پشتیبانی از socks4/5 یک است گردآوری زمان گزینه پیکربندی پس از کامپایل، fetchmail
همیشه از کتابخانه های جوراب و پیکربندی سیستم شما استفاده می کند، هیچ اجرا وجود ندارد.
زمان در fetchmail تغییر می کند - اما هنوز هم می توانید SOCKS را پیکربندی کنید: می توانید تعیین کنید که کدام
فایل پیکربندی SOCKS در SOCKS_CONF متغیر محیطی.

به عنوان مثال، اگر می خواهید به طور کلی از پروکسی SOCKS عبور کنید و fetchmail داشته باشید.
مستقیماً وصل شوید، برای مثال می‌توانید SOCKS_CONF=/dev/null را در محیط ارسال کنید
(گزینه های خط فرمان معمول خود را - در صورت وجود - به انتهای این خط اضافه کنید):

env SOCKS_CONF=/dev/null fetchmail

خروج کد ها

برای تسهیل استفاده از fetchmail در اسکریپت های پوسته، یک کد وضعیت خروج به آن برگردانده می شود
نشانی از آنچه در طول یک اتصال داده شده رخ داده است.

کدهای خروجی که توسط fetchmail به شرح زیر است:

0 یک یا چند پیام با موفقیت بازیابی شد (یا اگر گزینه -c بود
انتخاب شدند، در انتظار یافت شدند اما بازیابی نشدند).

1 هیچ نامه ای در انتظار بازیابی وجود نداشت. (ممکن است نامه های قدیمی هنوز در آن وجود داشته باشد
سرور اما برای بازیابی انتخاب نشده است.) اگر نمی خواهید "بدون نامه" یک خطا باشد
شرط (مثلاً برای کارهای cron)، از یک پوسته سازگار با POSIX استفاده کنید و اضافه کنید

|| [$؟ -eq 1 ]

تا انتهای خط فرمان fetchmail، توجه داشته باشید که 0 دست نخورده باقی می ماند، نقشه های 1
به 0، و همه کدهای دیگر را به 1 نشان می دهد. همچنین مورد #C8 را در پرسش های متداول ببینید.

2 هنگام تلاش برای باز کردن سوکت برای بازیابی نامه، خطایی روی داد. اگر شما
نمی دانم سوکت چیست، نگران آن نباشید - فقط به عنوان یک سوکت رفتار کنید
"خطای غیر قابل جبران". این خطا همچنین می تواند به این دلیل باشد که یک پروتکل fetchmail می خواهد
to use در /etc/services فهرست نشده است.

3 مرحله احراز هویت کاربر ناموفق بود. این معمولاً به این معنی است که یک شناسه کاربری بد،
رمز عبور یا شناسه APOP مشخص شد. یا ممکن است به این معنی باشد که سعی کرده اید fetchmail را اجرا کنید
در شرایطی که ورودی استاندارد متصل به ترمینال و
نتوانست رمز عبور گمشده را درخواست کند.

4 نوعی خطای پروتکل کشنده شناسایی شد.

5 یک خطای نحوی در آرگومان های به وجود داشت fetchmail، یا قبل یا بعد از اتصال
دستور شکست خورد.

6 فایل کنترل اجرا دارای مجوزهای بدی بود.

7 یک وضعیت خطایی توسط سرور گزارش شده است. همچنین می تواند شلیک کند اگر fetchmail
زمانی که منتظر سرور بودید به پایان رسید.

8 خطای حذف سمت مشتری. این یعنی fetchmail یا یک کپی دیگر از
خود در حال حاضر در حال اجرا است، یا به گونه ای شکست خورده است که مطمئن نیست که دیگری
کپی در حال اجراست

9 مرحله احراز هویت کاربر ناموفق بود زیرا سرور به "قفل مشغول است" پاسخ داد. تلاش كردن
دوباره بعد از مکثی کوتاه! این خطا برای همه پروتکل ها اجرا نمی شود
برای همه سرورها اگر برای سرور شما اجرا نشود، "3" به جای آن بازگردانده می شود.
به بالا نگاه کن. ممکن است هنگام صحبت با qpopper یا سرورهای دیگری که می توانند بازگردانده شوند
با "قفل مشغول" یا متن مشابه حاوی کلمه "قفل" پاسخ دهید.

10 The fetchmail هنگام تلاش برای باز کردن یا تراکنش درگاه SMTP اجرا نشد.

11 خطای مرگبار DNS. Fetchmail هنگام انجام جستجوی DNS در با خطا مواجه شد
راه اندازی شد و نتوانست ادامه یابد.

12 فایل دسته ای BSMTP باز نشد.

13 نظرسنجی با محدودیت واکشی خاتمه یافت (به گزینه --fetchlimit مراجعه کنید).

14 نشانگر مشغول بودن سرور.

23 خطای داخلی شما باید پیامی در مورد خطای استاندارد با جزئیات ببینید.

24 - 26، 28، 29
این کدهای داخلی هستند و نباید به صورت خارجی ظاهر شوند.

چه زمانی fetchmail بیش از یک هاست را پرس و جو می کند، اگر وضعیت بازگشت 0 است هر پرس و جو با موفقیت
نامه بازیابی شده در غیر این صورت وضعیت خطای بازگشتی مربوط به آخرین میزبانی است که پرس و جو شده است.

با استفاده از خدمات onworks.net از fetchmailconf به صورت آنلاین استفاده کنید