fetchmail - Интернет в облаке

ПРОГРАММА:

ИМЯ

fetchmail - получать почту с сервера с поддержкой POP, IMAP, ETRN или ODMR

СИНТАКСИС

Fetchmail [вариант...] [почтовый сервер...]
fetchmailconf

ОПИСАНИЕ

Fetchmail утилита для поиска и пересылки почты; он получает почту с удаленного
почтовых серверов и пересылает его в систему доставки вашей локальной (клиентской) машины. Вы можете
затем обработайте полученную почту, используя обычные почтовые пользовательские агенты, такие как остолоп(1) вяз(1) или
Почта(1). Fetchmail утилиту можно запустить в режиме демона для многократного опроса одного или нескольких
системы с заданным интервалом.

В Fetchmail программа может собирать почту с серверов, поддерживающих любую из распространенных почтовых
протоколы извлечения: POP2 (устаревший, будет удален из будущих выпусков), POP3, IMAP2bis,
IMAP4 и IMAP4rev1. Он также может использовать расширение ESMTP ETRN и ODMR. (RFC
описания всех этих протоколов перечислены в конце этой страницы руководства.)

В то время как Fetchmail в первую очередь предназначен для использования по каналам TCP / IP по запросу (например, SLIP
или соединения PPP), он также может быть полезен в качестве агента передачи сообщений для сайтов, которые
отказать по соображениям безопасности разрешить (инициированные отправителем) SMTP-транзакции с sendmail.

ПОДДЕРЖКА, УСТРАНЕНИЕ
Для устранения неполадок, отслеживания и отладки вам необходимо повысить уровень детализации fetchmail до
на самом деле посмотреть, что происходит. Для этого запустите изоферменты печени of два после команды,
добавить ВСЕ of кредита вы бы нормально использовать.

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

(Эта командная строка выводит на английском, как fetchmail понимает вашу конфигурацию.)

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

(Эта командная строка фактически запускает fetchmail с подробным выводом на английском языке.)

Также см. Пункт G3 в FAQ по fetchmail ⟨http://fetchmail.berlios.de/fetchmail-FAQ.html# G3⟩

Вы можете опустить часть LC_ALL = C выше, если хотите вывод на местном языке (если
поддерживается). Однако, если вы отправляете сообщения в списки рассылки, оставьте это.
Сопровождающие не обязательно понимают ваш язык, используйте английский.

КОНЦЕПЦИИ
If Fetchmail используется с POP или IMAP-сервером (но не с ETRN или ODMR), у него есть два
основные режимы работы для каждой учетной записи пользователя, из которой он получает почту:
одиночная капля- а также многоточечный-Режим.

В однокадровом режиме
Fetchmail предполагает, что все сообщения в учетной записи (почтовом ящике) пользователя предназначены
для одного получателя. Личность получателя по умолчанию будет
локальный пользователь, выполняющий в данный момент Fetchmail, или его нужно будет явно указать
в файле конфигурации.

Fetchmail использует singleledrop-mode, когда конфигурация fetchmailrc содержит не более
спецификация единственного локального пользователя для данной учетной записи сервера.

В многоточечном режиме
Fetchmail предполагает, что учетная запись почтового сервера действительно содержит почту, предназначенную для
любое количество разных получателей. Следовательно, Fetchmail должен попытаться вывести
правильный «получатель конверта» из почтовых заголовков каждого сообщения. В этом
режим работы, Fetchmail почти напоминает агента пересылки почты (MTA).

Обратите внимание, что ни протоколы POP, ни IMAP не предназначены для использования таким образом,
и, следовательно, информация на конверте часто недоступна напрямую. Интернет-провайдер должен
хранит информацию о конверте в заголовке сообщения и. Интернет-провайдер также должен хранить
одна копия сообщения на каждого получателя. Если какое-либо из условий не выполнено
выполнено, этот процесс ненадежен, потому что Fetchmail должен тогда прибегнуть к
угадать истинного получателя (ей) конверта. Обычно это не удается
сообщения из списка рассылки и скрытая копия: 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 доступен, он поможет вам в настройке и редактировании
конфигурация fetchmailrc. Он работает в системе X Window и требует, чтобы
язык Python и инструментарий Tk (с привязками Python) присутствуют в вашей системе. Если
вы сначала настраиваете fetchmail для однопользовательского режима, рекомендуется использовать
Режим новичка. Экспертный режим обеспечивает полный контроль над конфигурацией fetchmail, включая
многоточечные функции. В любом случае кнопка «Автопробег» расскажет вам больше всего.
протокол, поддерживаемый данным почтовым сервером, и предупредить вас о потенциальных проблемах с этим
сервера.

ОБЩАЯ ИНФОРМАЦИЯ РАБОТА

Поведение Fetchmail управляется параметрами командной строки и файлом управления запуском,
~ / .fetchmailrc, синтаксис которого мы опишем в следующем разделе (этот файл
fetchmailconf редактирует программу). Переопределение параметров командной строки ~ / .fetchmailrc деклараций.

Каждое имя сервера, которое вы укажете после параметров в командной строке, будет
запрошен. Если вы не укажете серверы в командной строке, каждая запись «опрос» в вашем
~ / .fetchmailrc файл будет запрошен.

Чтобы облегчить использование Fetchmail в скриптах и ​​конвейерах возвращает соответствующий
код выхода при завершении - см. КОДЫ ВЫХОДА ниже.

Следующие параметры изменяют поведение Fetchmail. Редко нужно указывать
любой из них, если у вас есть рабочий .fetchmailrc файл настроен.

Почти все параметры имеют соответствующее ключевое слово, которое можно использовать для объявления их в
.fetchmailrc .

Некоторые специальные параметры здесь не рассматриваются, но вместо этого описаны в разделах
АУТЕНТИФИКАЦИЯ и РЕЖИМ DAEMON, которые следуют ниже.

Общие Возможности
-V | --версия
Отображает информацию о версии вашей копии Fetchmail. Не получать почту
выполненный. Вместо этого для каждого указанного сервера вся информация о параметрах, которая
будет вычислено, если Fetchmail были подключены к этому серверу. Любой
непечатаемые в паролях или других строковых именах отображаются как C-подобные символы с обратной косой чертой
escape-последовательности. Эта опция полезна для проверки того, что ваши параметры установлены
так, как вы хотите.

-c | --проверить
Верните код состояния, чтобы указать, есть ли ожидающая почта, без фактического
получение или удаление почты (см. КОДЫ ВЫХОДА ниже). Эта опция отключает демон
режим (в котором было бы бесполезно). Это плохо работает с запросами к нескольким
сайты и не работает с ETRN или ODMR. Он вернет ложное срабатывание, если вы
оставьте прочитанную, но восстановленную почту в почтовом ящике вашего сервера, и ваш протокол выборки не сможет
отличить сохраненные сообщения от новых. Это означает, что он будет работать с IMAP, а не с
POP2, а иногда и сбой под POP3.

-s | --тихий
Бесшумный режим. Подавляет все сообщения о прогрессе / состоянии, которые обычно выводятся эхом на
стандартный вывод во время выборки (но не подавляет фактические сообщения об ошибках). В
Параметр --verbose отменяет это.

-v | --подробный
Подробный режим. Все контрольные сообщения прошли между Fetchmail и почтовый сервер
откликнулся на стандартный вывод. Переопределяет - тихо. Удвоение этой опции (-v -v) вызывает дополнительные
диагностическая информация для печати.

--nosoftbounce
(начиная с v6.3.10, ключевое слово: не устанавливать softbounce, начиная с v6.3.10)
Жесткий режим отскока. Все постоянные ошибки доставки приводят к удалению сообщений из
вышестоящий сервер, см. «без мягких отказов» ниже.

--softbounce
(начиная с версии 6.3.10, ключевое слово: установить softbounce, начиная с версии 6.3.10)
Режим мягкого отскока. Все постоянные ошибки доставки приводят к тому, что сообщения остаются на
вышестоящий сервер, если протокол поддерживает это. Эти вариант is on by по умолчанию в
совпадение исторический Fetchmail документация, и будет переведен в режим жесткого отскока через
следующий выпуск fetchmail.

Распоряжение Возможности
-a | --все | (поскольку v6.3.3) --fetchall
(Ключевое слово: fetchall, начиная с версии 3.0)
Получать как старые (просмотренные), так и новые сообщения с почтового сервера. По умолчанию
получать только сообщения, которые сервер не пометил как видимые. В POP3 этот параметр также
заставляет использовать RETR, а не TOP. Обратите внимание, что получение POP2 ведет себя так, как если бы
--all всегда включен (см. ниже РЕЖИМЫ ПОВТОРНОГО ОТКАЗА), и этот параметр не
работать с ETRN или ODMR. В то время как -a и --all командная строка и извлекаемый rcfile
параметры поддерживаются в течение длительного времени, параметр командной строки --fetchall был
добавлено в v6.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])
Укажите протокол, который будет использоваться при связи с удаленным почтовым сервером. Если нет
протокол указан, по умолчанию - АВТО. прото может быть одним из следующих:

АВТО Пробует IMAP, POP3 и POP2 (пропуская любой из них, для которого не поддерживается
был скомпилирован в).

POP2 Post Office Protocol 2 (устаревший, будет удален из будущего выпуска)

POP3 Почтовый протокол 3

APOP Используйте POP3 со старомодной аутентификацией MD5-challenge. Считается не
устойчивы к атакам «злоумышленник посередине».

RPOP Используйте POP3 с аутентификацией RPOP.

KPOP Используйте POP3 с аутентификацией Kerberos V4 на порту 1109.

SDPS Используйте POP3 с расширениями SDPS Demon Internet.

IMAP IMAP2bis, IMAP4 или IMAP4rev1 (Fetchmail автоматически обнаруживает их
возможности).

ETRN Используйте опцию ESMTP ETRN.

ODMR Используйте профиль ESMTP ретрансляции почты по требованию.

Все эти альтернативы работают в основном одинаково (связь со стандартным сервером
демоны для получения почты, уже доставленной в почтовый ящик на сервере), кроме ETRN и ODMR.
Режим ETRN позволяет вам запрашивать совместимый сервер ESMTP (например, BSD sendmail при выпуске
8.8.0 или выше), чтобы немедленно открыть SMTP-соединение отправителя с клиентским компьютером и
начать пересылку любых элементов, адресованных вашему клиентскому компьютеру, в очереди сервера
недоставленное письмо. Для режима ODMR требуется сервер с поддержкой ODMR, и он работает аналогично
ETRN, за исключением того, что он не требует, чтобы на клиентском компьютере был статический DNS.

-U | --uidl
(Ключевое слово: uidl)
Принудительное использование UIDL (действует только с POP3). Принудительное отслеживание "новизны" на стороне клиента
сообщений (UIDL означает «список уникальных идентификаторов» и описан в RFC1939). Использовать
с 'keep', чтобы использовать почтовый ящик как новостную рассылку для группы пользователей. Факт
пропущенные просмотренные сообщения регистрируются, если регистрация ошибок не выполняется через
syslog при работе в режиме демона. Обратите внимание, что fetchmail может автоматически включать
этот вариант зависит от возможностей вышестоящего сервера. Также обратите внимание, что эта опция
может быть удален и принудительно включен в будущей версии fetchmail. Смотрите также:
--идентификатор.

--праздный (поскольку 6.3.3)
(Ключевое слово: idle, начиная с версии 6.0.0)
Включите использование IDLE (действует только с IMAP). Обратите внимание, что это работает только с одним
папку в заданное время. Хотя ключевое слово idle rcfile поддерживалось для
Долгое время опция командной строки --idle была добавлена ​​в версии 6.3.3. IDLE использование
означает, что fetchmail сообщает серверу IMAP отправлять уведомления о новых сообщениях, поэтому они
могут быть получены раньше, чем при обычных опросах.

-P | --услуга
(Ключевое слово: service) Начиная с версии 6.3.0.
Параметр службы позволяет указать имя службы для подключения. Вы можете
укажите здесь десятичный номер порта, если в базе данных ваших сервисов отсутствуют необходимые
назначения сервисных портов. См. Пункт R12 часто задаваемых вопросов и документацию --ssl для
Детали. Это заменяет старую опцию --port.

--порт
(Ключевое слово: порт)
Устаревшая версия --service, которая не принимает имена сервисов. Примечание: этот вариант
может быть удален из будущей версии.

--главный
(Ключевое слово: главный)
Параметр «Принципал» позволяет указать принципала-службы для взаимного
аутентификация. Это применимо к POP3 или IMAP с аутентификацией Kerberos 4.
Только. Это не относится к Kerberos 5 или GSSAPI. Эта опция может быть удалена в
будущая версия fetchmail.

-t | - тайм-аут
(Ключевое слово: тайм-аут)
Параметр тайм-аута позволяет установить тайм-аут отсутствия ответа сервера в секундах. Если
почтовый сервер не отправляет приветственное сообщение и не отвечает на команды для данного
количество секунд, Fetchmail сбросит соединение с ним. Без такого
Тайм-аут Fetchmail может зависнуть до тех пор, пока не истечет время ожидания TCP-соединения, пытаясь получить
письмо от неработающего хоста, которое может быть очень длинным. Это было бы особенно неприятно
для Fetchmail работает в фоновом режиме. По умолчанию установлен тайм-аут, который
fetchmail -V сообщит. Если данное соединение получает слишком много тайм-аутов в
последовательность, fetchmail сочтет его заблокированным и прекратит попытки. Вызывающий пользователь
будут уведомлены по электронной почте, если это произойдет.

Начиная с fetchmail 6.3.10, клиент SMTP использует рекомендуемый минимум
таймауты из RFC-5321 при ожидании сервера SMTP / LMTP, с которым он разговаривает.
Вы можете увеличить таймауты еще больше, но не можете их сократить. Это чтобы избежать
болезненная ситуация, когда fetchmail был настроен с коротким таймаутом (
минута или меньше), отправляет длинное сообщение (много МБ) в локальный MTA, который затем
требуется больше времени, чем время ожидания, чтобы ответить «ОК», что в конечном итоге и произойдет; это было бы
означает, что почта доставляется правильно, но fetchmail не может этого заметить и, следовательно,
возвращайте это большое сообщение снова и снова.

--плагин
(Ключевое слово: плагин)
Опция плагина позволяет вам использовать внешнюю программу для установки TCP
связь. Это полезно, если вы хотите использовать ssh или вам нужны специальные
настройка межсетевого экрана. Программа будет найдена в $ PATH и при желании может быть
передал имя хоста и порт в качестве аргументов, используя соответственно «% h» и «% p» (примечание
что логика интерполяции довольно примитивна, и эти токены должны быть ограничены
пробелом, началом или концом строки). Fetchmail напишет на
стандартный ввод плагина и считывание из стандартного вывода плагина.

--отключить
(Ключевое слово: плагин)
Идентично варианту плагина выше, но он используется для SMTP
соединений.

-r | --папка
(Ключевое слово: папка [ы])
Вызывает указанную почтовую папку не по умолчанию на почтовом сервере (или через запятую
список папок) для получения. Синтаксис имени папки - серверный.
зависимый. Эта опция недоступна для POP3, ETRN или ODMR.

--tracepolls
(Ключевое слово: трассировки)
Скажите fetchmail, что нужно запрашивать информацию трассировки в форме 'polling account% s' и
'folder% 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 для зашифрованного варианта.

Если в вашей системе отсутствуют соответствующие записи из / etc / servicesСм.
--service и укажите числовой номер порта, как указано в предыдущем
параграф (если ваш интернет-провайдер не направил вас на другие порты, что редко
тем не мение).

--sslcert
(Ключевое слово: sslcert)
Для аутентификации клиента на основе сертификата. Некоторые серверы с шифрованием SSL требуют
ключи и сертификаты на стороне клиента для аутентификации. В большинстве случаев это
по желанию. Это указывает расположение сертификата открытого ключа, который будет
предоставляется серверу во время установления сеанса SSL. Нет
требуется (но может быть предоставлен), если сервер не требует этого. Это может быть
тот же файл, что и закрытый ключ (комбинированный файл ключа и сертификата), но это не
рекомендуемые. См. Также --sslkey ниже.

ПРИМЕЧАНИЕ: Если вы используете аутентификацию клиента, имя пользователя берется из
CommonName сертификата и переопределяет имя, заданное с помощью --user.

--sslkey
(Ключевое слово: sslkey)
Задает имя файла закрытого ключа SSL на стороне клиента. Некоторые зашифрованные SSL
серверам требуются ключи и сертификаты на стороне клиента для аутентификации. В большинстве
случаях это необязательно. Это указывает расположение закрытого ключа, используемого для
подписывать транзакции с сервером во время установления сеанса SSL. Это
не требуется (но может быть предоставлен), если сервер не требует этого. Это может быть
тот же файл, что и открытый ключ (комбинированный файл ключа и сертификата), но это не
рекомендуется.

Если для разблокировки ключа требуется пароль, он будет запрошен во время
непосредственно перед установкой сеанса связи с сервером. Это может вызвать некоторые
сложности в режиме демона.

Также см. --Sslcert выше.

--sslпрото
(Ключевое слово: 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, зарегистрируйте ошибку и
притвориться, что 'автоматический'вместо этого использовалось.

'автоматический' (дефолт). Начиная с v6.4.0. Требовать TLS. Автосогласование TLSv1 или новее, отключить
Переход на более раннюю версию SSLv3. (fetchmail 6.3.26 и старше автоматически согласовывают все
протоколы, поддерживаемые их библиотекой OpenSSL, включая неработающий SSLv3).

'SSL23'
видеть 'автоматический'.

'SSL3«Требовать SSLv3 точно. SSLv3 не работает, поддерживается не во всех системах, избегайте
если возможно. Это заставит fetchmail согласовывать только SSLv3, и это
единственный способ кроме 'SSL3 +', чтобы fetchmail 6.4.0 или новее разрешил SSLv3.

'SSL3 +'
такой же как 'автоматический', но также разрешить SSLv3. Это единственный способ кроме
'SSL3', чтобы fetchmail 6.4.0 или новее разрешил SSLv3.

'TLS1'Требовать TLSv1. Это не согласовывает TLSv1.1 или новее и не рекомендуется.
Замените на TLS1 +, если последний не заглушает ваш сервер.

'TLS1 +'
Начиная с v6.4.0. См. FBauto.

'TLS1.1'
Начиная с v6.4.0. Точно требуйте TLS v1.1.

'TLS1.1 +'
Начиная с v6.4.0. Требовать TLS. Автосогласование TLSv1.1 или новее.

'TLS1.2'
Начиная с v6.4.0. Точно требуйте TLS v1.2.

'TLS1.2 +'
Начиная с v6.4.0. Требовать TLS. Автосогласование TLSv1.2 или новее.

Неизвестные параметры
рассматриваются так же, как 'автоматический'.

ПРИМЕЧАНИЕ: вам вряд ли когда-либо понадобится использовать что-либо, кроме '' (чтобы заставить
незашифрованное соединение) или «авто» (для принудительного использования TLS).

--sslcertck
(Ключевое слово: sslcertck)
Заставляет fetchmail требовать использования SSL / TLS и отключаться, если он не может
успешно согласовать SSL или TLS, или если он не может успешно проверить и подтвердить
сертификат и следуйте за ним до якоря доверия (или доверенного корневого сертификата). В
якоря доверия представлены в виде набора локальных доверенных сертификатов (см. sslcertfile
и sslcertpath параметры). Если сертификат сервера не может быть получен или
подписанный одним из доверенных (прямо или косвенно), fetchmail будет
отключиться, независимо от отпечаток пальца опцию.

Обратите внимание, что CRL (списки отзыва сертификатов) поддерживаются только в OpenSSL 0.9.7.
и новее! Ваши системные часы также должны быть достаточно точными при использовании этого
опцию.

Обратите внимание, что это необязательное поведение может стать поведением по умолчанию в будущем fetchmail.
версий.

--sslcertfile
(Ключевое слово: sslcertfile, начиная с версии 6.3.17)
Устанавливает файл, который fetchmail использует для поиска локальных сертификатов. По умолчанию пусто.
Это может быть дано в дополнение к --sslcertpath ниже, и сертификаты, указанные в
--sslcertfile будут обработаны раньше, чем в --sslcertpath. Вариант может быть
используется в дополнение к --sslcertpath.

Файл представляет собой текстовый файл. Он содержит объединение доверенных сертификатов CA
в формате PEM.

Обратите внимание, что использование этой опции подавляет загрузку доверенного центра сертификации SSL по умолчанию.
файл сертификатов, если вы не установите переменную среды
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS к непустому значению.

--sslcertpath
(Ключевое слово: sslcertpath)
Устанавливает каталог, который fetchmail использует для поиска локальных сертификатов. По умолчанию
ваш каталог OpenSSL по умолчанию. Каталог должен быть хеширован способом OpenSSL
ожидает этого - каждый раз, когда вы добавляете или изменяете сертификат в каталоге, вам нужно
использовать c_rehash инструмент (который поставляется с OpenSSL в подкаталоге tools /).
Кроме того, после обновлений OpenSSL вам может потребоваться запустить c_rehash; особенно когда
обновление с 0.9.X до 1.0.0.

Это может быть дано в дополнение к --sslcertfile выше, см. приоритет
правила.

Обратите внимание, что использование этого параметра подавит добавление доверенного центра сертификации SSL по умолчанию.
каталог сертификатов, если вы не установите переменную среды
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS к непустому значению.

--sslcommonname <общий имя>
(Ключевое слово: sslcommonname; начиная с версии 6.3.9)
Использование этой опции не рекомендуется. Перед его использованием обратитесь к администратору
ваш вышестоящий сервер и попросите использовать соответствующий сертификат SSL. Если это
не может быть достигнуто, эту опцию можно использовать для указания имени (CommonName), которое
fetchmail ожидает сертификата сервера. Правильно настроенный сервер будет
установите для него имя хоста, по которому он достигается, и по умолчанию fetchmail будет
ожидайте столько же. Используйте эту опцию, когда CommonName имеет другое значение, чтобы
избегать предупреждения "Несоответствие общего имени сервера" и только в том случае, если вышестоящий сервер
нельзя заставить использовать надлежащие сертификаты.

--sslfingerprint
(Ключевое слово: sslfingerprint)
Укажите отпечаток ключа сервера (хеш MD5 ключа) в шестнадцатеричном формате.
запись с двоеточиями, разделяющими группы из двух цифр. Буквенные шестнадцатеричные цифры должны быть
в верхнем регистре. Это формат, который fetchmail использует для сообщения об отпечатке пальца.
когда установлено SSL-соединение. Когда это указано, fetchmail будет
сравните отпечаток ключа сервера с заданным, и соединение не удастся
если они не совпадают, независимо от sslcertck параметр. Связь также будет
завершиться ошибкой, если fetchmail не может получить сертификат SSL с сервера. Это может быть
используется для предотвращения атак типа "злоумышленник посередине", но отпечаток пальца с сервера
должны быть получены или проверены по безопасному каналу, а не через
то же подключение к Интернету, которое будет использовать fetchmail.

Использование этого параметра предотвратит ошибки проверки сертификата печати до тех пор, пока
--sslcertck не установлен.

Чтобы получить отпечаток сертификата, хранящегося в файле cert.pem, попробуйте:

openssl x509 -in cert.pem -noout -md5 -отпечаток пальца

Подробнее см. x509(1ссл).

Приемка Control Возможности
-S | --smtphost
(Ключевое слово: smtp [хост])
Укажите список хостов для пересылки почты (одно или несколько имен хостов, запятая-
разделены). Хосты проверяются в порядке списка; первый, который поднимается, становится
цель переадресации для текущего прогона. Если этот параметр не указан,
По умолчанию используется localhost. Каждое имя хоста может иметь номер порта после
имя хоста. Номер порта отделяется от имени хоста косой чертой; в
порт по умолчанию - "smtp". Если вы укажете абсолютный путь (начинающийся с /),
он будет интерпретироваться как имя сокета UNIX, принимающего LMTP-соединения.
(например, поддерживается демоном Cyrus IMAP) Пример:

--smtphost сервер1, сервер2 / 2525, сервер3, / var / imap / socket / lmtp

Эта опция может использоваться с ODMR и сделает fetchmail ретранслятором между ODMR.
сервер и приемник SMTP или LMTP.

--fetchdomains
(Ключевое слово: fetchdomains)
В режиме ETRN или ODMR этот параметр указывает список доменов, которые сервер должен
отправить почту за раз, когда связь изменится. По умолчанию используется полное доменное имя
машина работает Fetchmail.

-D | --smtpaddress
(Ключевое слово: smtpaddress)
Укажите домен, который будет добавлен к адресам в строках RCPT TO, отправленных на SMTP.
Если это не указано, имя SMTP-сервера (как указано
--smtphost) используется для SMTP / LMTP, а 'localhost' используется для сокета UNIX / BSMTP.

--smtpname
(Ключевое слово: smtpname)
Укажите домен и пользователя, которые будут помещены в строки RCPT TO, отправляемые на SMTP. В
пользователь по умолчанию - текущий локальный пользователь.

-Z | --антиспам <ннн[, ннн] ...>
(Ключевое слово: антиспам)
Задает список числовых ошибок SMTP, которые следует интерпретировать как спам-
заблокировать ответ от слушателя. Значение -1 отключает эту опцию. Для
параметр командной строки, значения списка должны быть разделены запятыми.

-m | --мда
(Ключевое слово: mda)
Эта опция позволяет Fetchmail использовать агент доставки сообщений или местной доставки (MDA или LDA)
напрямую, а не пересылать через SMTP или LMTP.

Чтобы избежать потери почты, используйте эту опцию только с MDA, например maildrop, или MTA, например
sendmail с ненулевым статусом при заполнении диска и другие ошибки доставки;
ненулевой статус сообщает fetchmail, что доставка не удалась, и предотвращает отправку сообщения
от удаления на сервере.

If Fetchmail работает как root, он устанавливает свой идентификатор пользователя при доставке почты через
MDA следующим образом: во-первых, среда FETCHMAILUSER, LOGNAME и USER
переменные проверяются в этом порядке. Значение первой переменной из его списка
который определен (даже если он пустой!) ищется в базе данных пользователей системы. Если
ни одна из переменных не определена, fetchmail будет использовать реальный идентификатор пользователя, который был
началось с. Если одна из переменных была определена, но пользователь заявил, что ее нет
найдено, fetchmail продолжает работать от имени пользователя root, не проверяя оставшиеся переменные на
список. Фактически это означает, что если вы запустите fetchmail от имени пользователя root (а не
рекомендуется), наиболее полезно определить переменную среды FETCHMAILUSER для
установить пользователя, от имени которого должен запускаться MDA. Некоторые MDA (например, maildrop) разработаны
быть setuid root и setuid для идентификатора пользователя получателя, чтобы вы не потеряли
такая функциональность даже при запуске fetchmail от имени непривилегированного пользователя. Проверить
Подробности в руководстве MDA.

Некоторые возможные MDA: "/ usr / sbin / sendmail -i -f% F -% T "(Примечание: некоторые несколько
ошибка более старых версий sendmail или версий sendmail - для адреса, а не для
индикатор для обозначения конца аргументов опции), "/ usr / bin / delivery" и
"/ usr / bin / maildrop -d% T". Адреса местной доставки будут вставлены в MDA.
команда везде, где вы помещаете% T; будет вставлен адрес отправителя почтового сообщения
где вы помещаете% F.

Do НЕ заключать %F or %T string in одинарной цитаты! Для% T и% F fetchmail
заключают адреса в одинарные кавычки ('), после удаления одинарных кавычек они
может содержать до того, как команда MDA будет передана оболочке.

Do НЕ использование an MDA вызов который депеши on фактов of Кому / Копия / СК, " У аборигенов
"sendmail -i -t" или "qmail-inject", он создаст петли почты и принесет только
гнев многих почтмейстеров обрушился на вашу голову. Это один из самых частых
ошибки конфигурации!

Также сделайте попробуйте совместить многоточечный режим с MDA, например maildrop, который может
принимать только один адрес, если только ваш апстрим не хранит одну копию сообщения на
получатель и переносит получателя конверта в заголовок; вы потеряете почту.

Хорошо известный Procmail(1) пакет очень сложно правильно настроить, он имеет
очень неприятное поведение "переходить к следующему правилу" при ошибках доставки (даже
временные, например, нехватка места на диске, если почтовый демон другого пользователя копирует
почтовый ящик, чтобы удалить старые сообщения), поэтому ваша почта окажется в неправильном
почтовый ящик рано или поздно. Правильная конфигурация procmail выходит за рамки
этот документ. С использованием почтовый адрес для(1) обычно намного проще, и многие пользователи находят
синтаксис фильтра, используемый maildrop, легче понять.

Наконец, мы настоятельно рекомендуем вам сделать используйте qmail-inject. Командная строка
интерфейс нестандартный, не дающий преимуществ для типичного использования, а fetchmail
не делает никаких попыток учесть отклонения qmail-inject от стандарта. Некоторые
параметров командной строки и среды qmail-inject на самом деле опасны и
может вызвать разорванные потоки, необнаруженные повторяющиеся сообщения и петли пересылки.

--lmtp (Ключевое слово: lmtp)
Вызвать доставку через LMTP (Local Mail Transfer Protocol). Хост и порт службы
должен быть явно указанным на каждом хосте в списке поиска smtphost (см. выше), если
этот вариант выбран; порт 25 по умолчанию не будет (в соответствии с RFC 2033)
быть принятым.

--bsmtp
(Ключевое слово: bsmtp)
Добавить полученную почту в файл BSMTP. Он просто содержит команды SMTP, которые
обычно генерируется fetchmail при передаче почты слушателю SMTP
демон.

Аргумент '-' приводит к тому, что пакет SMTP будет записан в стандартный вывод, который
ограниченного использования: это имеет смысл только для отладки, потому что обычный fetchmail
вывод перемежается по одному и тому же каналу, поэтому это не подходит для почты
Доставка. Этот специальный режим может быть удален в более позднем выпуске.

Обратите внимание, что реконструкция строк MAIL FROM и RCPT TO в fetchmail не
гарантированно правильный; предостережения, обсуждаемые в разделе ИСПОЛЬЗОВАНИЕ И ЗЛОУПОТРЕБЛЕНИЕ MULTIDROP
ПОЧТОВЫЕ ЯЩИКИ применяются ниже. Этот режим имеет приоритет перед --mda и SMTP / LMTP.

--плохой заголовок {отклонить | принять}
(Ключевое слово: bad-header; начиная с версии 6.3.15)
Укажите, как fetchmail должен обрабатывать сообщения с плохими заголовками, то есть заголовками.
с плохим синтаксисом. Обычно fetchmail отклоняет такие сообщения, но некоторые
распространители модифицировали fetchmail, чтобы принимать их. Теперь вы можете настроить fetchmail
поведение на сервере.

Ресурс Ограничивать Control Возможности
-l | - предел
(Ключевое слово: предел)
Принимает аргумент максимального размера октета, где 0 - значение по умолчанию, а также специальный
значение, обозначающее «без ограничений». Если ненулевое значение, сообщения большего размера не будут
будут извлечены и останутся на сервере (в сеансах переднего плана прогресс
сообщения будут отмечать, что они "негабаритные"). Если протокол выборки разрешает (в
в частности, в IMAP или POP3 без опции fetchall) сообщение не будет
отмечен видел.

Явный параметр --limit, равный 0, отменяет любые ограничения, установленные в вашем файле управления запуском. Этот
опция предназначена для тех, кому необходимо строго контролировать время выборки из-за
дорогие и переменные телефонные тарифы.

В сочетании с --limitflush его можно использовать для удаления сообщений большого размера, ожидающих
сервер. В режиме демона вызывающему пользователю отправляются уведомления о превышении размера.
(см. параметр --warnings). Эта опция не работает с ETRN или ODMR.

-w | - предупреждения
(Ключевое слово: предупреждения)
Делает интервал в секундах. Когда ты звонишь Fetchmail с опцией "limit" в
режим демона, это контролирует интервал, через который предупреждения о сообщениях слишком большого размера
отправляются по почте вызывающему пользователю (или пользователю, указанному в опции «postmaster»).
Одно такое уведомление всегда отправляется по почте в конце первого опроса, который
обнаружено негабаритное сообщение. После этого повторное уведомление подавляется до тех пор, пока
по истечении интервала предупреждения (это произойдет в конце первого
следующий опрос).

-b | --batchlimit
(Ключевое слово: batchlimit)
Укажите максимальное количество сообщений, которые будут отправлены прослушивателю SMTP.
до того, как соединение будет намеренно разорвано и восстановлено (по умолчанию 0, что означает
нет ограничений). Явное значение --batchlimit, равное 0, отменяет любые ограничения, установленные в вашем прогоне.
контрольный файл. В то время как Отправить письмо(8) обычно инициирует доставку сообщения
сразу после получения терминатора сообщения некоторые SMTP-слушатели не так
незамедлительный. MTA как Smail(8) может подождать, пока розетка доставки не отключится, чтобы
доставлять. Это может вызвать раздражающие задержки, когда Fetchmail обрабатывает очень большие
партии. Установка ограничения пакета на некоторый ненулевой размер предотвратит эти задержки.
Эта опция не работает с ETRN или ODMR.

-B | --fetchlimit
(Ключевое слово: fetchlimit)
Ограничьте количество сообщений, принимаемых с данного сервера в одном опросе. К
по умолчанию ограничений нет. Явный параметр --fetchlimit, равный 0, отменяет любые установленные ограничения.
в вашем файле управления запуском. Эта опция не работает с ETRN или ODMR.

--fetchsizelimit
(Ключевое слово: fetchsizelimit)
Ограничьте количество размеров сообщений, принимаемых с данного сервера за один
сделка. Эта опция полезна для уменьшения задержки при загрузке первого
mail, когда в почтовом ящике слишком много писем. По умолчанию ограничение составляет 100.
Если установлено значение 0, размеры всех сообщений загружаются в начале. Этот вариант делает
не работают с ETRN или ODMR. Для POP3 единственное допустимое ненулевое значение - 1.

--fastuidl
(Ключевое слово: fastuidl)
Выполните двоичный вместо линейного поиска первого невидимого UID. Бинарный поиск избегает
загрузка UID всех писем. Это экономит время (особенно в режиме демона)
где загрузка одного и того же набора UID в каждом опросе является пустой тратой полосы пропускания. В
число «n» указывает, насколько редко следует выполнять линейный поиск. В режиме демона
линейный поиск используется один раз с последующим двоичным поиском в опросах 'n-1', если 'n'
больше 1; бинарный поиск всегда используется, если «n» равно 1; линейный поиск всегда
используется, если «n» равно 0. В режиме, отличном от демона, двоичный поиск используется, если «n» равно 1; иначе
используется линейный поиск. Значение по умолчанию - 4. Этот параметр работает с POP3.
только.

-e | --выпустить
(Ключевое слово: удалить)
Сделайте так, чтобы удаления были окончательными после определенного количества сообщений. Под
POP2 или POP3, fetchmail не может завершить удаление без отправки QUIT и завершения
сеанс - с этой опцией fetchmail прервет долгое получение почты
сеанс на несколько подсессий, отправляя QUIT после каждого подсеанса. Это
хорошая защита от пропадания линии на серверах POP3. В IMAP Fetchmail нормально
выдает команду EXPUNGE после каждого удаления, чтобы принудительное удаление
сделано немедленно. Это наиболее безопасно, когда ваше соединение с сервером нестабильно и
дорого, так как позволяет избежать повторной отправки дубликатов писем после попадания в строку. Однако на
большие почтовые ящики накладные расходы на повторную индексацию после того, как каждое сообщение может захлопнуть сервер
довольно сложно, поэтому, если ваше соединение надежное, лучше удалять меньше
часто. Также обратите внимание, что некоторые серверы применяют задержку в несколько секунд после
каждый выход, поэтому fetchmail не сможет вернуться сразу после удаления
- в этом случае вы можете увидеть ошибку «блокировка занята». Если вы укажете эту опцию для
целое число N, это говорит Fetchmail выдавать только стирание при каждом N-ом удалении. An
нулевой аргумент подавляет удаление полностью (так что никаких удалений производиться не будет.
до конца пробега). Эта опция не работает с ETRN или ODMR.

Аутентификация Возможности
-u | --Пользователь | --имя пользователя
(Ключевое слово: пользователь [имя])
Задает идентификатор пользователя, который будет использоваться при входе на почтовый сервер.
Соответствующая идентификация пользователя зависит как от сервера, так и от пользователя. По умолчанию
это ваше имя для входа на клиентскую машину, на которой запущен Fetchmail. См. ПОЛЬЗОВАТЕЛЬ
АУТЕНТИЧНОСТЬ ниже для полного описания.

-I | --интерфейс
(Ключевое слово: интерфейс)
Требовать, чтобы определенное интерфейсное устройство было включено и имело определенное локальное или удаленное
IPv4 (IPv6 пока не поддерживается этой опцией) адрес (или диапазон) перед опросом.
Часто Fetchmail используется по переходному каналу TCP / IP точка-точка
устанавливается непосредственно на почтовый сервер через SLIP или PPP. Это относительно безопасный
канал. Но когда существуют другие маршруты TCP / IP к почтовому серверу (например, когда ссылка
подключен к альтернативному интернет-провайдеру), ваше имя пользователя и пароль могут быть уязвимы для
отслеживание (особенно когда режим демона автоматически опрашивает почту, отправляя
снимать пароль по сети через предсказуемые промежутки времени). Параметр --interface может
использоваться, чтобы предотвратить это. Когда указанная ссылка не работает или не подключена к
соответствующий IP-адрес, опрос будет пропущен. Формат:

интерфейс / iii.iii.iii.iii [/mmm.mmm.mmm.mmm]

Поле перед первой косой чертой - это имя интерфейса (например, sl0, ppp0 и т. Д.). В
поле перед второй косой чертой - допустимый IP-адрес. Поле после
вторая косая черта - это маска, определяющая диапазон принимаемых IP-адресов. Если нет
маска присутствует 255.255.255.255 предполагается (т.е. точное совпадение). Этот вариант
в настоящее время поддерживается только в Linux и FreeBSD. Пожалуйста, посмотрите монитор .
ниже для конкретной информации о FreeBSD.

Обратите внимание, что этот параметр может быть удален из будущей версии fetchmail.

-M | --монитор
(Ключевое слово: монитор)
Режим демона может вызвать временные ссылки, которые автоматически отключаются после
период бездействия (например, связи PPP), чтобы оставаться в рабочем состоянии бесконечно. Этот вариант
определяет системный интерфейс TCP / IP, активность которого необходимо отслеживать. После каждого опроса
интервал, если ссылка активна, но никаких других действий по ссылке не произошло, то
опрос будет пропущен. Однако, когда fetchmail просыпается по сигналу,
проверка монитора пропускается и опрос проходит безоговорочно. Этот вариант
в настоящее время поддерживается только в Linux и FreeBSD. Для монитор и интерфейс
для работы с пользователями без полномочий root под FreeBSD, двоичный файл fetchmail должен быть
установил SGID kmem. Это была бы дыра в безопасности, но fetchmail работает с
эффективный GID установлен на группу kmem Важно когда данные интерфейса
собраны.

Обратите внимание, что этот параметр может быть удален из будущей версии fetchmail.

--аут
(Ключевое слово: auth [enticate])
Эта опция позволяет вам указать тип аутентификации (см. АУТЕНТИФИКАЦИЯ ПОЛЬЗОВАТЕЛЯ
ниже для подробностей). Возможные значения: любой, password, 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, но не
автопробирование); и только если сервер не поддерживает ни одну из них, он отправит ваш
пароль en clair. Другие значения могут использоваться для принудительной аутентификации.
методы (SSH подавляет аутентификацию и, таким образом, полезен для IMAP PREAUTH).
(и, что лучший способ подавляет аутентификацию и, таким образом, полезен для ВНЕШНЕГО IMAP). Любой
значение, отличное от password, Cram-md5, NTLM, MSN or OTP подавляет нормальный
запрос пароля. Указать SSH когда вы используете сквозной безопасный
соединение, такое как туннель ssh; указать и, что лучший способ когда вы используете TLS с клиентом
аутентификация и указать гсапи or kerberos_v4 если вы используете протокол
вариант, использующий GSSAPI или K4. При выборе протокола KPOP автоматически выбираются
Проверка подлинности Kerberos. Эта опция не работает с ETRN. Сервис GSSAPI
имена соответствуют RFC-2743 и регистрации IANA, см. Generic Security
Программный интерфейс служебных приложений (GSSAPI) / Kerberos / Простая проверка подлинности и
Имена служб уровня безопасности (SASL) ⟨http://www.iana.org/assignments/
gssapi-сервис-имена /⟩.

Прочее Возможности
-f | --fetchmailrc
Укажите имя не по умолчанию для ~ / .fetchmailrc запустить контрольный файл. Путь
аргумент должен быть либо "-" (одиночное тире, означающее чтение конфигурации из
стандартный ввод) или имя файла. Если также не включена опция --version, именованный
аргумент файла должен иметь разрешения не более open, чем 0700 (u = rwx, g =, o =), иначе он должен быть
/ dev / null.

-i | --idfile
(Ключевое слово: idfile)
Укажите альтернативное имя файла .fetchids, используемого для сохранения UID сообщений. ЗАМЕТКА:
начиная с fetchmail 6.3.0, доступ на запись к каталогу, содержащему файл idfile,
требуется, так как fetchmail записывает временный файл и переименовывает его на место
настоящий idfile, только если временный файл был успешно записан. Это позволяет избежать
усечение idfiles при нехватке места на диске.

--pidfile
(Ключевое слово: pidfile; начиная с fetchmail v6.3.4)
Замените расположение по умолчанию для файла PID. По умолчанию: см. «ОКРУЖАЮЩАЯ СРЕДА» ниже.

-n | --norewrite
(Ключевое слово: без перезаписи)
Как правило, Fetchmail редактирует заголовки адресов RFC-822 (To, From, Cc, Bcc и Reply-To)
в полученной почте, чтобы любые почтовые идентификаторы, локальные для сервера, были расширены до полного
адреса (добавляются @ и имя хоста почтового сервера). Это позволяет отвечать на
клиент должен быть адресован правильно (иначе ваша почтовая программа может подумать, что они
следует адресовать локальным пользователям на клиентской машине!). Эта опция отключает
переписать. (Эта опция предназначена для успокоения людей, которые параноидально относятся к
иметь MTA редактировать заголовки писем и знать, что они могут предотвратить это, но это
вообще не рекомендуется отключать перезапись.) При использовании ETRN или ODMR,
опция перезаписи неэффективна.

-E | --конверт
(Ключевое слово: конверт; только многоточечный)
В файле конфигурации используется расширенный синтаксис:
конверт [ ]

Эта опция меняет заголовок Fetchmail предполагает, что будет иметь копию почтового
адрес конверта. Обычно это «X-Envelope-To». Другие типичные заголовки
для переноса информации на конверте используются «X-Original-To» и «Delivered-To». Теперь, поскольку
эти заголовки не стандартизированы, практика варьируется. См. Обсуждение
многоточечная обработка адресов ниже. В особом случае "конверт" Получено "позволяет
парсинг строк Received в стиле sendmail. Это значение по умолчанию, но не рекомендуется
потому что это не совсем надежно.

Обратите внимание, что fetchmail ожидает, что строка Received будет в определенном формате: она должна
содержать " кашель для адрес", где кашель должно соответствовать одному из имен почтового сервера
который fetchmail распознает для рассматриваемой учетной записи.

Необязательный аргумент count (доступен только в файле конфигурации) определяет
сколько таких строк заголовка пропущено. 1 означает: пропустить первое,
возьми второй. Счет 2 означает: пропустить первое и второе, взять третье и
так далее.

-Q | --qвиртуальный
(Ключевое слово: qvirtual; только многоточечный)
Префикс строки, присвоенный этой опции, будет удален из найденного имени пользователя.
в заголовке, указанном с помощью конверт вариант (до делает многоточечное имя
сопоставление или проверка локального домена, если применимо). Эта опция полезна, если
ты используешь Fetchmail для сбора почты для всего домена и вашего интернет-провайдера (или
ваш провайдер перенаправления почты) использует qmail. Одна из основных функций qmail
это Доставлен в: Заголовок сообщения. Каждый раз, когда qmail доставляет сообщение локальному
mailbox он помещает в эту строку имя пользователя и имя хоста получателя конверта.
Основная причина этого - предотвращение зацикливания почты. Чтобы настроить qmail для пакетной почты
для отключенного сайта ISP-mailhost обычно помещает этот сайт в свой
Управляющий файл Virtualhosts, чтобы он добавлял префикс ко всем почтовым адресам для этого
сайт. Это приводит к тому, что письмо отправляется на[электронная почта защищена]' иметь
Доставлен в: строка формы:

Доставлен в: [электронная почта защищена]

Интернет-провайдер может сделать префикс mbox-userstr- любым по своему усмотрению, кроме строки, соответствующей
имя хоста пользователя. Используя опцию «Конверт Доставлен-Кому:», вы можете сделать
fetchmail надежно идентифицирует исходного получателя конверта, но вы должны удалить
Префикс mbox-userstr- для доставки правильному пользователю. Для этого и предназначена эта опция.

--configdump
Разобрать ~ / .fetchmailrc файл, интерпретировать любые указанные параметры командной строки и
выгрузить отчет о конфигурации на стандартный вывод. Отчет о конфигурации - это данные
присвоение структуры на языке Python. Эта опция предназначена для использования с
интерактивный ~ / .fetchmailrc редактор как fetchmailconf, написанный на Python.

удален Возможности
-T | --netsec
Удалена до версии 6.3.0, необходимая базовая библиотека inet6_apps была
снят с производства и больше не доступен.

USER АВТОРИЗАЦИЯ И ENCRYPTION / ШИФРОВАНИЕ

Все режимы, кроме ETRN, требуют аутентификации клиента на сервере. Обычный пользователь
аутентификация в Fetchmail очень похож на механизм аутентификации FTP(1).
правильный идентификатор пользователя и пароль зависят от базовой системы безопасности на почтовом сервере.

Если почтовый сервер - это машина Unix, на которой у вас есть обычная учетная запись пользователя, ваш
обычные логин и пароль используются с Fetchmail. Если вы используете то же имя для входа
как на сервере, так и на клиентских машинах вам не нужно беспокоиться об указании идентификатора пользователя
с -u option - поведение по умолчанию - использовать ваше имя для входа на клиентском компьютере
как идентификатор пользователя на сервере. Если вы используете другое имя для входа на сервер
машины, укажите это имя входа с помощью -u вариант. например, если ваше имя для входа - jsmith
на машине с именем mailgrunt вы должны запустить Fetchmail следующим образом:

fetchmail -u jsmith mailgrunt

Поведение по умолчанию Fetchmail запрашивать пароль почтового сервера перед
соединение установлено. Это самый безопасный способ использования Fetchmail и гарантирует, что ваш
пароль не будет скомпрометирован. Вы также можете указать свой пароль в своем
~ / .fetchmailrc файл. Это удобно при использовании Fetchmail в режиме демона или с
скриптов.

. Netrc файлов
Если вы не укажете пароль, и Fetchmail не могу извлечь ни одного из ваших
~ / .fetchmailrc файл, он будет искать ~ / .netrc файл в вашем домашнем каталоге перед
запрос в интерактивном режиме; если в этом файле найдена запись, соответствующая почтовому серверу,
будет использован пароль. Fetchmail сначала ищет совпадение по названию опроса; если он найдет
нет, он проверяет совпадение по имени перехода. Увидеть FTP(1) справочная страница для получения подробной информации о
синтаксис ~ / .netrc файл. Чтобы показать практический пример, .netrc может выглядеть так:

машина hermes.example.org
логин джо
пароль topsecret

Вы можете повторить этот блок с другой информацией о пользователе, если вам нужно предоставить больше, чем
один пароль.

Эта функция может позволить вам избежать дублирования информации о пароле более чем в одном
.

На почтовых серверах, которые не предоставляют учетные записи обычных пользователей, ваш идентификатор пользователя и пароль
обычно назначается администратором сервера, когда вы подаете заявку на получение почтового ящика на сервере.
Обратитесь к администратору сервера, если вы не знаете правильный идентификатор пользователя и пароль для
ваш почтовый ящик.

POP3 ВАРИАНТЫ

Ранние версии POP3 (RFC1081, RFC1225) поддерживали грубую форму независимого
аутентификация с использованием .rhosts файл на стороне почтового сервера. В этом варианте RPOP
фиксированный идентификатор пользователя, эквивалентный паролю, был отправлен в открытом виде по ссылке на зарезервированный
порт, с помощью команды RPOP, а не PASS, чтобы предупредить сервер о том, что он должен выполнить специальные
проверка. RPOP поддерживается Fetchmail (вы можете указать 'протокол RPOP', чтобы
программа отправляет 'RPOP', а не 'PASS'), но ее использование настоятельно не рекомендуется, и поддержка
будет удален из будущей версии fetchmail. Этот объект был уязвим для спуфинга
и был отозван в RFC1460.

RFC1460 представил аутентификацию APOP. В этом варианте POP3 вы регистрируете APOP
пароль на вашем сервере (на некоторых серверах программа для этого называется
попаут(8)). Вы вводите тот же пароль в свой ~ / .fetchmailrc файл. Каждый раз Fetchmail
входит в систему, он отправляет на сервер хэш MD5 вашего пароля и время приветствия сервера,
который может проверить это, проверив свою базу данных авторизации.

Внимание который АПОП is нет дольше считается стойкий против которого выступает большинство исследователей в области общественного здравоохранения. человек-в-середине атаки.

РЕТР or Топовый объект
Fetchmail прилагает некоторые усилия, чтобы заставить сервер поверить, что сообщения не были получены,
используя команду TOP с большим количеством строк, когда это возможно. TOP - это команда
который извлекает полный заголовок и Fetchmail-указанное количество линий тела. это
необязательный и, следовательно, реализуется не всеми серверами, и известно, что некоторые его реализуют
неправильно. Однако на многих серверах команда RETR, которая получает полное сообщение
с заголовком и телом устанавливает флаг "просмотрено" (например, в веб-интерфейсе), тогда как
Команда TOP этого не делает.

Fetchmail всегда будет использовать команду RETR, если установлено "fetchall". Fetchmail также будет использовать
команда RETR, если "keep" установлено, а "uidl" не установлено. Наконец-то, Fetchmail будет использовать
Команда RETR на серверах Maillennium POP3 / PROXY (используемых Comcast), чтобы избежать преднамеренного ТОП
неправильное толкование на этом сервере, которое вызывает повреждение сообщения.

Во всех остальных случаях Fetchmail будет использовать команду TOP. Это означает, что в "keep"
настройки, "uidl" должен быть установлен, если требуется "TOP".

Внимание что это описание верно для текущей версии fetchmail, но поведение
может измениться в будущих версиях. В частности, fetchmail может предпочесть команду RETR
потому что команда TOP вызывает много проблем на некоторых серверах и является необязательной.

АЛЬТЕРНАТИВНЫЙ АВТОРИЗАЦИЯ ФОРМЫ

Если ваш Fetchmail был построен с поддержкой Kerberos, и вы указываете аутентификацию Kerberos
(либо с --auth, либо с .fetchmailrc вариант проверять подлинность kerberos_v4) он попытается
получать билет Kerberos с почтового сервера в начале каждого запроса. Примечание: если
pollname или via name - 'hesiod', fetchmail попытается использовать Hesiod для поиска
почтовый сервер.

Если вы используете POP3 или IMAP с аутентификацией GSSAPI, Fetchmail будет ожидать, что сервер
иметь возможность GSSAPI, соответствующую RFC1731 или RFC1734, и будет ее использовать. В настоящее время это
был протестирован только на Kerberos V, поэтому ожидается, что у вас уже есть выдача билетов
проездной билет. Вы можете передать имя пользователя, отличное от вашего основного имени, используя стандартный
--Пользователь команда или .fetchmailrc вариант пользователь.

Если ваш демон IMAP возвращает ответ PREAUTH в своей строке приветствия, fetchmail будет
обратите внимание на это и пропустите обычный шаг аутентификации. Это может быть полезно, например, если вы
запустить imapd явно с помощью ssh. В этом случае вы можете объявить значение аутентификации
'ssh' в записи этого сайта, чтобы остановить .fetchmail от запроса пароля при запуске
вверх.

Если вы используете аутентификацию клиента с TLS1 и ваш демон IMAP возвращает AUTH = ВНЕШНИЙ
ответ, fetchmail заметит это и будет использовать ярлык аутентификации и не
отправьте кодовую фразу. В этом случае вы можете объявить значение аутентификации "внешним".
на этом сайте, чтобы остановиться Fetchmail от запроса пароля при запуске.

Если вы используете POP3, и сервер выдает запрос одноразового пароля в соответствии с
RFC1938, Fetchmail будет использовать ваш пароль как парольную фразу для генерации необходимого
отклик. Это позволяет избежать отправки секретов по сети в незашифрованном виде.

Поддерживается аутентификация Compuserve RPA. Если вы компилируете в поддержку, Fetchmail
попытается выполнить аутентификацию по ключевой фразе RPA вместо отправки пароля
en clair, если он обнаруживает "@ compuserve.com" в имени хоста.

Если вы используете IMAP, проверка подлинности Microsoft NTLM (используется Microsoft Exchange)
поддерживается. Если вы компилируете в поддержку, Fetchmail попытается выполнить NTLM
аутентификация (вместо отправки пароля en clair) всякий раз, когда сервер возвращает
AUTH = NTLM в ответе о возможностях. Укажите значение параметра пользователя, которое выглядит как
'user @ domain': часть слева от @ будет передана как имя пользователя, а часть
справа как домен NTLM.

Безопасность Розетка Слои (SSL) и Транспорт Слой Охрана (ТЛС)
транспорт. Кроме того, повторное получение 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 или параметр файла управления запуском sslcertck
следует использовать для принудительной проверки сертификатов - см. ниже.

Если SSL не настроен, fetchmail обычно пытается использовать STARTTLS.
STARTTLS может быть применен с помощью --sslproto auto и отменен с помощью --sslproto ''.
Подключения TLS используют тот же порт, что и незашифрованная версия протокола, и согласовывают
TLS с помощью специальной команды. Командная строка --sslcertck или параметр файла управления запуском sslcertck
следует использовать для принудительной проверки сертификатов - см. ниже.

--sslcertck is рекомендуемые: При подключении к серверу с шифрованием SSL или TLS сервер
представляет сертификат клиенту для проверки. Сертификат проверяется для проверки
что общее имя в сертификате совпадает с именем сервера, с которым связываются, и
что даты вступления в силу и истечения срока действия сертификата указывают на то, что он в настоящее время
действительный. Если какая-либо из этих проверок завершилась неудачно, выводится предупреждающее сообщение, но соединение
продолжается. Сертификат сервера не должен быть подписан какой-либо конкретной Сертифицирующей
Авторитет и может быть «самоподписанный» сертификат. Если параметр командной строки --sslcertck
или используется параметр файла управления запуском sslcertck, 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; в первом случае по умолчанию используется имя вызывающего пользователя.

ДЕЙМОН РЕЖИМ

Вводя демон Режим
В режиме демона Fetchmail помещается в фоновый режим и работает вечно, запрашивая каждый
указанный хост, а затем спит в течение заданного интервала опроса.

Начало демон Режим
Есть несколько способов заставить fetchmail работать в режиме демона. В командной строке
- демон or -d вариант работает Fetchmail в режиме демона. Вы должны
укажите числовой аргумент, который представляет собой интервал опроса (время ожидания после завершения
весь цикл опроса с последним сервером и перед запуском следующего цикла опроса с
первый сервер) за секунды.

Пример: просто вызов

fetchmail -d 900

будет опрашивать все хосты, описанные в вашем ~ / .fetchmailrc файл (кроме тех
явно исключено с помощью глагола 'пропустить') немного реже, чем раз в 15 минут
(точно: 15 минут + время опроса).

Также можно установить интервал опроса в вашем ~ / .fetchmailrc файл, сказав
'установить демон ', куда целое число секунд. Если вы это сделаете
при этом fetchmail всегда будет запускаться в режиме демона, если вы не переопределите его с помощью команды -
строчный параметр --daemon 0 или -d0.

Каждому пользователю разрешен только один процесс-демон; в режиме демона, Fetchmail создает пер-
файл блокировки пользователя, чтобы гарантировать это. (Однако вы можете обмануть и установить FETCHMAILHOME
переменная среды, чтобы преодолеть этот параметр, но в этом случае это ваша ответственность
чтобы убедиться, что вы не опрашиваете один и тот же сервер двумя процессами одновременно.)

Пробуждение фон демон
Обычно вызов fetchmail с демоном в фоновом режиме отправляет сигнал пробуждения на
демон и завершает работу без вывода. Затем фоновый демон начинает свой следующий цикл опроса.
немедленно. Сигнал пробуждения SIGUSR1 также можно отправить вручную. Пробуждающее действие
также сбрасывает все «заклинившие» флаги, указывающие на то, что соединения заблокированы из-за сбоя.
аутентификация или множественные тайм-ауты.

Нагрузочный фон демон
Опция --покидать убьет запущенный процесс демона вместо того, чтобы разбудить его (если есть
нет такого процесса, Fetchmail уведомит вас). Если опция --quit появляется последней в
командная строка, Fetchmail убьет запущенный процесс демона, а затем выйдет. Иначе,
Fetchmail сначала убьет запущенный процесс демона, а затем продолжит работу с
другие варианты.

Полезное кредита для демон Режим
В -L or --лог-файл опция (ключевое слово: установить файл журнала) эффективна только
когда fetchmail отключен и находится в режиме демона. Обратите внимание, что журнальный файл должен существовать до
fetchmail запущен, вы можете использовать трогать(1) команда с именем файла в качестве единственного аргумента
чтобы создать его.
Этот параметр позволяет перенаправлять сообщения о состоянии в указанный файл журнала (следуйте
вариант с именем файла журнала). Файл журнала открывается для добавления, поэтому предыдущие сообщения
не удаляются. Это в первую очередь полезно для отладки конфигураций. Обратите внимание, что
fetchmail не определяет, поворачивается ли файл журнала, файл журнала открывается только один раз, когда
fetchmail запускается. Вам необходимо перезапустить fetchmail после ротации файла журнала и до
сжимая его (если применимо).

В --syslog опция (ключевое слово: set syslog) позволяет перенаправлять сообщения о статусе и ошибках
выпущен в системный журнал(3) системный демон, если он доступен. Сообщения регистрируются с идентификатором
Fetchmail, объект LOG_MAIL, и приоритеты ЛОГ_ERR, ЛОГ_АЛЕРТ or ЛОГ_ИНФО. Это
опция предназначена для регистрации статуса и сообщений об ошибках, которые указывают статус
демон и результаты при получении почты с сервера (ов). Сообщения об ошибках для команды
параметры строки и разбор .fetchmailrc файл по-прежнему записывается в stderr или в
указанный файл журнала. В --nosyslog опция отключает использование системный журнал(3), предполагая, что это
включен в ~ / .fetchmailrc файл. Эта опция отменяется в определенных ситуациях,
by --лог-файл (которые видят).

В -N or --nodetach опция подавляет фоновую работу и отсоединение процесса демона
со своего терминала управления. Это полезно для отладки или когда fetchmail работает как
дочерний процесс супервизора, например инициализации(8) или Геррита Папа запустить его(8). Обратите внимание, что это
также игнорирует параметр файла журнала.

Обратите внимание, что при работе в режиме демона при опросе сервера POP2 или IMAP2bis временные ошибки
(например, сбои DNS или отказы в доставке sendmail) могут принудительно включить опцию fetchall для
продолжительность следующего цикла опроса. Это особенность надежности. Это означает, что если
сообщение получено (и, таким образом, помечено как видимое почтовым сервером), но не доставлено локально из-за
из-за некоторой временной ошибки он будет повторно выбран во время следующего цикла опроса. (IMAP
логика не удаляет сообщения, пока они не доставлены, поэтому эта проблема не возникает.)

Если вы коснетесь или измените ~ / .fetchmailrc файл, пока fetchmail работает в режиме демона,
это будет обнаружено в начале следующего цикла опроса. Когда изменился
~ / .fetchmailrc обнаружен, fetchmail перечитывает его и перезапускается с нуля (используя Exec(2);
в новом экземпляре информация о состоянии не сохраняется). Обратите внимание, что если fetchmail необходимо
запрос паролей, в том числе, если вы нарушите ~ / .fetchmailrc синтаксис файла, новый
Экземпляр мягко и бесшумно исчезнет при запуске.

АДМИНИСТРАТИВНЫЕ ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

В - почтмейстер option (keyword: set postmaster) указывает последнее средство
имя пользователя, на которое будет пересылаться многоточечная почта, если не может быть найден соответствующий локальный получатель
нашел. Он также используется в качестве адресата недоставленной почты, если глобальная
опция выключена и дополнительно для сообщений, заблокированных спамом, если глобальный параметр 'bouncemail' установлен
выкл и глобальная опция 'spambounce' включена. По умолчанию этот параметр установлен для пользователя, который вызвал
Fetchmail. Если вызывающий пользователь - root, то по умолчанию эта опция - user
"почтмейстер". Установка postmaster на пустую строку вызывает такую ​​почту, как описано выше
быть отброшенным - однако обычно это плохая идея. См. Также описание
Переменная среды FETCHMAILUSER в разделе ОКРУЖЕНИЕ ниже.

В --nobounce ведет себя как глобальная опция "не указывать почту возврата", которую см.

В - невидимый option (ключевое слово: установить невидимым) пытается сделать fetchmail невидимым.
Обычно fetchmail ведет себя так же, как и любой другой MTA - он генерирует заголовок Received.
в каждое сообщение, описывающее его место в цепочке передачи, и сообщает MTA об этом
пересылает на то, что почта пришла с машины, на которой работает сама fetchmail. Если
невидимый параметр включен, заголовок Received подавляется, и fetchmail пытается подделать
MTA пересылает его, думая, что оно пришло непосредственно с хоста почтового сервера.

В --showdots option (keyword: set showdots) заставляет fetchmail показывать даже точки прогресса
если вывод идет в файл или fetchmail не в подробном режиме. Fetchmail показывает
точки по умолчанию при запуске в режиме --verbose и вывод идет на консоль. Этот вариант
игнорируется в --silent режиме.

Указав --tracepolls вариант, вы можете попросить fetchmail добавить информацию в
Получен заголовок в форме "опрос {label} account {user}", где {label} - это аккаунт
метка (из указанного rcfile, обычно ~ / .fetchmailrc) и {user} - имя пользователя
который используется для входа на почтовый сервер. Этот заголовок можно использовать для фильтрации
электронное письмо, в котором нет полезной информации в заголовке, и вы хотите получать почту из разных
учетные записи, отсортированные по разным почтовым ящикам (например, это может произойти, если у вас есть
учетной записи на том же сервере, на котором запущен список рассылки, и подписаны на этот список с помощью
этот аккаунт). По умолчанию такой заголовок не добавляется. В .fetchmailrc, это называется
"трассировки".

ВОЗВРАЩЕНИЕ FAILURE РЕЖИМЫ

Протоколы Fetchmail использование для общения с почтовыми серверами почти неуязвимо. В нормальном
перенаправление операции на порт 25, ни одно сообщение никогда не удаляется (или даже не помечается для удаления)
на хосте, пока прослушиватель SMTP на стороне клиента не подтвердит Fetchmail который
сообщение было либо принято к доставке, либо отклонено из-за блокировки спама.

Однако при пересылке на MDA существует большая вероятность ошибки. Некоторые MDA
'безопасно' и надежно возвращать ненулевой статус при любой ошибке доставки, даже если она возникла из-за
временные ограничения ресурсов. В почтовый адрес для(1) программа такая; как и большинство программ
разработаны как агенты по транспортировке почты, такие как Отправить письмо(1), включая оболочку sendmail для
Постфикс и Exim(1). Эти программы дают надежное положительное подтверждение и могут
использоваться с опцией mda без риска потери почты. Однако небезопасные MDA могут возвращать 0
даже при сбое доставки. Если это произойдет, вы потеряете почту.

Нормальный режим Fetchmail пытаться загружать только «новые» сообщения, не трогая
(и восстановленные) сообщения, которые вы уже прочитали непосредственно на сервере (или получили с помощью
предыдущий Fetchmail --хранить). Но вы можете обнаружить, что сообщения, которые вы уже прочитали на
сервер загружается (и удаляется), даже если вы не укажете --all. Есть
это может произойти по нескольким причинам.

Возможно, вы используете POP2. Протокол POP2 не содержит представления
"новое" или "старое" состояние в сообщениях, поэтому Fetchmail должен рассматривать все сообщения как новые все
время. Но протокол POP2 устарел, так что это маловероятно.

Потенциальной проблемой POP3 могут быть серверы, вставляющие сообщения в середину почтовых ящиков.
(ходят слухи, что это делают некоторые реализации почты VMS). В Fetchmail код предполагает
что новые сообщения добавляются в конец почтового ящика; когда это неправда, это может
рассматривать некоторые старые сообщения как новые и наоборот. Использование UIDL при установке fastuidl 0 может
исправьте это, в противном случае подумайте о переходе на IMAP.

Еще одна проблема POP3 заключается в том, что если они не могут создавать временные файлы в доме пользователя,
каталог, некоторые серверы POP3 вернут недокументированный ответ, вызывающий fetchmail
ложно сообщить "Нет почты".

Код IMAP использует наличие или отсутствие флага сервера \ Seen, чтобы решить, следует ли
не сообщение новое. Это неправильно, fetchmail должен проверить
UIDVALIDITY и использовать UID, но пока этого не делает. В Unix он рассчитывает на ваш IMAP
сервер, чтобы заметить флаги состояния в стиле BSD, установленные почтовыми пользовательскими агентами, и установить флаг \ Seen
от них, когда это необходимо. Все известные нам серверы Unix IMAP делают это, хотя это и не так.
указанные в IMAP RFC. Если вы когда-нибудь наткнетесь на сервер, который этого не сделает, симптом исчезнет.
будь то сообщения, которые вы уже прочитали на своем хосте, будут выглядеть на сервере новыми. В этом
(маловероятный) случай, только сообщения, которые вы получили с Fetchmail --хранить будут оба восстановлены
и помечены как старые.

В режимах ETRN и ODMR, Fetchmail фактически не извлекает сообщения; вместо этого он спрашивает
прослушиватель SMTP сервера для запуска очистки очереди к клиенту через SMTP. Поэтому это
отправляет только недоставленные сообщения.

СПАМ ФИЛЬТРАЦИЯ

Многие прослушиватели SMTP позволяют администраторам устанавливать «спам-фильтры», которые блокируют нежелательные запросы.
электронная почта с указанных доменов. Строка MAIL FROM или DATA, которая запускает эту функцию, будет
вызвать ответ SMTP, который (к сожалению) зависит от слушателя.

Более новые версии Отправить письмо вернуть код ошибки 571.

Согласно RFC2821, правильная вещь, которую нужно вернуть в этой ситуации, - это 550 "Запрошено.
действие не выполнено: почтовый ящик недоступен »(в черновике добавлено:« [Например, почтовый ящик не найден, нет
доступ или команда отклонена по политическим причинам]. ").

Более старые версии Exim MTA возвращает 501 «Синтаксическая ошибка в параметрах или аргументах».

В постфикс MTA запускает 554 в качестве ответа на спам.

Змайлер может отклонить код с ответом 500 (за которым следует расширенный код состояния,
содержит дополнительную информацию).

Коды возврата, которые Fetchmail обрабатывает как антиспамовые ответы и отклоняет сообщение может быть
установлен с опцией «антиспам». Это один из Важно три обстоятельства, при которых
fetchmail всегда отбрасывает почту (другие ошибки - это ошибки 552 и 553, описанные ниже, и
подавление многоточечных сообщений с уже увиденным идентификатором сообщения).

If Fetchmail загружается с сервера IMAP, будет обнаружен ответ антиспама и
сообщение отклонено сразу после получения заголовков, без чтения
тело сообщения. Таким образом, вы не будете платить за скачивание тел спамерских сообщений.

По умолчанию список ответов антиспама пуст.

Если же линия индикатора спамбаунс глобальная опция включена, почта, заблокированная спамом, вызывает
RFC1892 / RFC1894 сообщение об отказе, информирующее отправителя о том, что мы не принимаем почту от
Это. См. Также ОШИБКИ.

SMTP / ESMTP ОШИБКА ОБРАЩЕНИЕ

Помимо блокировки спама, описанной выше, fetchmail выполняет особые действия, которые могут быть
изменен параметром --softbounce - для следующих кодов ответов об ошибках SMTP / ESMTP

452 (недостаточно памяти в системе)
Оставьте сообщение в почтовом ящике сервера для последующего использования.

552 (сообщение превышает установленный максимальный размер сообщения)
Удалите сообщение с сервера. Отправить сообщение о недоставке отправителю.

553 (неверный домен отправителя)
Удалите сообщение с сервера. Даже не пытайтесь отправить сообщение о недоставке на адрес
оригинатор.

Другие ошибки, превышающие или равные 500, вызывают возврат почты отправителю, если только
подавляется --softbounce. См. Также ОШИБКИ.

БЕГ КОНТРОЛЬ ФАЙЛОВ

Предпочтительный способ настройки fetchmail - написать .fetchmailrc файл в вашем доме
каталог (вы можете сделать это напрямую, с помощью текстового редактора или косвенно через fetchmailconf).
Когда есть конфликт между аргументами командной строки и аргументами в этом
файла, аргументы командной строки имеют приоритет.

Чтобы защитить безопасность ваших паролей, ваш ~ / .fetchmailrc обычно не может быть больше
чем 0700 (u = rwx, g =, o =) разрешений; Fetchmail будет жаловаться и выйдет в противном случае (это
проверка подавляется, когда включена --version).

Вы можете прочитать .fetchmailrc файл в виде списка команд, которые будут выполняться, когда Fetchmail is
вызывается без аргументов.

Run Control Синтаксис
Комментарии начинаются с символа «#» и продолжаются до конца строки. В противном случае файл
состоит из серии записей сервера или операторов глобальных опций в свободном формате,
токен-ориентированный синтаксис.

Есть четыре вида токенов: ключевые слова грамматики, числа (т.е. последовательности десятичных цифр),
строки без кавычек и строки в кавычках. Строка в кавычках заключена в двойные кавычки и может
содержат пробелы (а цифры в кавычках рассматриваются как строка). Обратите внимание, что строки в кавычках
также будет содержать символы перевода строки, если они пересекают две или более строк, если вы не
используйте обратную косую черту для соединения строк (см. ниже). Строка без кавычек - это любые разделенные пробелами
токен, который не является ни числовым, ни строковым кавычками, ни содержит специальные символы ',', ';',
':' или '='.

Любое количество пробелов разделяет токены в записях сервера, но в остальном игнорируется. Ты
могут использовать escape-последовательности с обратной косой чертой (\ n для LF, \ t для HT, \ b для BS, \ r для CR, \NNN для
десятичный (где nnn не может начинаться с 0), \ 0ооо для восьмеричного и \ xhh для шестнадцатеричного) вставлять
непечатаемые символы или разделители строк в строках. В строках в кавычках обратная косая черта
в самом конце строки вызовет обратную косую черту и перевод строки (LF или NL, новый
line), который следует игнорировать, чтобы можно было переносить длинные строки. Без обратной косой черты на
в конце строки символ перевода строки станет частью строки.

Внимание! хотя они напоминают escape-последовательности в стиле C, они не совпадают. fetchmail
поддерживает только эти восемь стилей. C поддерживает больше escape-последовательностей, которые состоят из
обратная косая черта (\) и один символ, но не поддерживает десятичные коды и не поддерживает
требуется начальный 0 в восьмеричной системе счисления. Пример: fetchmail интерпретирует \ 233 так же, как
\ xE9 (строчная латинская буква e с острым ударением), где C интерпретирует \ 233 как восьмеричное 0233 = \ x9B
(CSI, интродьюсер управляющей последовательности).

Каждая запись сервера состоит из одного из ключевых слов "опрос" или "пропустить", за которым следует сервер.
имя, за которым следуют параметры сервера, за которым следует любое количество пользователей (или имя пользователя)
описания, за которыми следуют параметры пользователя. Примечание: наиболее частой причиной синтаксических ошибок является
смешивание параметров пользователя и сервера или размещение параметров пользователя перед описанием пользователя.

Для обратной совместимости слово «сервер» является синонимом слова «опрос».

Вы можете использовать ключевые слова шума "и", "с", "имеет", "хочет" и "параметры" в любом месте
запись, чтобы он напоминал английский. Они игнорируются, но могут значительно упростить запись
читать с первого взгляда. Знаки пунктуации ':', ';' и ',' также игнорируются.

Голосование против Пропускать
Глагол 'poll' указывает fetchmail запрашивать этот хост, когда он запускается без аргументов. В
глагол "пропустить" говорит Fetchmail не опрашивать этот хост, если он явно не указан в
командная строка. (Глагол 'пропустить' позволяет безопасно экспериментировать с тестовыми записями, или
легко отключить записи для хостов, которые временно не работают.)

Ключевое слово / вариант Итого
Вот легальные варианты. Суффиксы ключевых слов, заключенные в квадратные скобки, необязательны.
Те, которые соответствуют коротким параметрам командной строки, сопровождаются '-' и соответствующим
вариант письма. Если опция актуальна только для одного режима работы, она отмечается как
's' или 'm' для одно- или многоточечного режима соответственно.

Вот легальные глобальные варианты:

Функция режима выбора ключевого слова
───────────────────────────────────────────────────── ──────────────────
set daemon -d Установить интервал фонового опроса в
секунд.
set postmaster Дайте название последней инстанции
получатель почты (по умолчанию: пользователь
работает fetchmail, "postmaster", если
запускается пользователем root)
установить bouncemail Прямое сообщение об ошибке отправителю
(По умолчанию)
установить no bouncemail Прямое сообщение об ошибке на локальный
почтмейстер (согласно
глобальная опция postmaster выше).
установить no spambounce Не возвращать почту, заблокированную спамом
(по умолчанию).
установить spambounce Отказаться от заблокированной почты, заблокированной спамом
(согласно пользователю "антиспама"
вариант) обратно в пункт назначения как
обозначается "bouncemail"
глобальный вариант. Предупреждение: не
используйте это, чтобы отправить спам обратно в
отправитель - рассылается больше всего спама
с ложным адресом отправителя и, следовательно,
этот вариант вредит невиновным
прохожих.
установить без softbounce Удалить окончательно не доставляемый
Почта. Рекомендуется использовать
этот вариант, если конфигурация
был тщательно протестирован.
установить softbounce Сделать невозможным доставку навсегда
почта как бы временная ошибка
произошло (по умолчанию).
установить файл журнала -L Имя файла для добавления ошибки и
статусные сообщения для. Только
эффективен в режиме демона и если
fetchmail отсоединяется. Если эффективно,
переопределения набор системный журнал.
установить idfile -i Имя файла для хранения UID
списки в.
установить системный журнал Выполнить регистрацию ошибок через
системный журнал(3). Может быть отменено набор
журнальный файл.

set no syslog Отключить регистрацию ошибок через
системный журнал(3). (дефолт)
установить свойства Строковое значение, которое игнорируется
fetchmail (может использоваться
сценарии расширения).

Вот варианты легального сервера:

Функция режима выбора ключевого слова
───────────────────────────────────────────────────── ────────────────
через Укажите DNS-имя почтового сервера,
приоритетное имя опроса
proto [col] -p Указать протокол (регистр
нечувствительный): POP2, POP3, IMAP,
АПОП, КПОП
local [домены] m Укажите домен (ы) для рассмотрения
как местный
порт Укажите порт службы TCP / IP
(устарело, используйте вместо этого "сервис").
service -P Укажите имя службы (числовое
значение также допускается и
считается номером порта TCP / IP).
auth [enticate] Установить тип аутентификации (по умолчанию
'любой')
timeout -t Тайм-аут бездействия сервера в
секунды (по умолчанию 300)
envelope -E m Указать заголовок адреса конверта
имя
нет конверта m Отключить поиск конверта
адрес
qvirtual -Q m Префикс виртуального домена Qmail для
удалить из имени пользователя
aka m Укажите альтернативные DNS-имена
почтовый сервер
interface -Я указываю IP-интерфейсы, которые должны
быть готовым к опросу сервера, чтобы принять
место
monitor -M Укажите IP-адрес для отслеживания
деятельность
плагин Укажите команду, с помощью которой
сделать подключения к серверу.
plugout Укажите команду, с помощью которой
сделать подключения слушателей.
dns m Включить поиск DNS для многоточечного подключения
(По умолчанию)
no dns m Отключить поиск DNS для многоточечного подключения
checkalias m Провести сравнение по IP-адресу для
многоточечный
нет контрольных точек m Сделать сравнение по имени для
многоточечный (по умолчанию)
uidl -U Заставить POP3 использовать на стороне клиента
UIDL (рекомендуется)
no uidl Отключить использование протокола POP3 на стороне клиента
UIDL (по умолчанию)
интервал Проверять этот сайт только каждые N опросов
циклы; N - числовой аргумент.
tracepolls Добавить информацию об отслеживании опроса в
Полученный заголовок
принципал Установить принципала Kerberos (только
полезно с IMAP и kerberos)
esmtpname Установить имя для RFC2554
аутентификация на ESMTP
сервера.
esmtppassword Установить пароль для RFC2554
аутентификация на ESMTP
сервера.

bad-header Как относиться к сообщениям с плохим
заголовок. Может быть отклонено (по умолчанию) или
принимаем.

Вот описания и варианты законных пользователей:

Функция режима выбора ключевого слова
──────────────────────────────────────────────────── ──────────────────
user [name] -u Это описание пользователя и
должен быть первым после сервера
описание и после возможно
параметры сервера и перед пользователем
настройки.
Он устанавливает имя удаленного пользователя, если
сам или за которым следует 'там', или
имя локального пользователя, если за ним следует
'здесь'.
Подключить локального и удаленного пользователя
имена
Подключить локального и удаленного пользователя
имена
pass [word] Укажите пароль удаленной учетной записи
ssl Подключиться к серверу через
указанный базовый протокол с использованием SSL
шифрование
sslcert Укажите файл для клиент сторона
публичный сертификат SSL
sslcertfile Укажите файл с доверенным ЦС
сертификаты
sslcertpath Укажите каталог c_rehash-ed с помощью
доверенные сертификаты ЦС.
sslkey Укажите файл для клиент сторона
закрытый ключ SSL
sslproto Принудительно использовать протокол ssl для подключения
папка -r Указать удаленную папку для запроса
smtphost -S Укажите хост (ы) smtp для пересылки
fetchdomains m Укажите домены, для которых
должен быть доставлен
smtpaddress -D Укажите домен, который нужно добавить
RCPT TO линии
smtpname Укажите пользователя и домен, которые будут
вставьте строки RCPT TO
antispam -Z Укажите, что возвращает SMTP
интерпретируется как блоки спам-политики
mda -m Указать MDA для локальной доставки
bsmtp -o Указать пакетный файл BSMTP для добавления
в
preconnect Команда, выполняемая перед каждым
связи
postconnect Команда, выполняемая после каждого
связи
keep -k Не удалять просмотренные сообщения из
сервер (для POP3 uidl
рекомендуемые)
flush -F Очистить все увиденные сообщения перед
запрос (ОПАСНО)
limitflush Очистить все сообщения большого размера
перед запросом
fetchall -a Получить все сообщения, просмотренные или

перезаписать Перезаписать адреса назначения для
ответ (по умолчанию)
stripcr Полоса возврата каретки с концов
линий
forcecr Принудительный возврат каретки на концах
линий

pass8bits Force BODY = 8BITMIME для ESMTP
слушатель
dropstatus Strip Status и X-Mozilla-Status
строки из входящей почты
dropdelivered Строка с доставкой из
входящие сообщения на почте
mimedecode Преобразование цитируемой печати в 8-битное
в сообщениях MIME
простаивает Ожидание новых сообщений
после каждого опроса (только IMAP)
no keep -K Удалять просмотренные сообщения с сервера
(По умолчанию)
no flush Не сбрасывать все просмотренные сообщения
перед запросом (по умолчанию)
no fetchall Получать только новые сообщения
(По умолчанию)
без перезаписи Не перезаписывать заголовки
no stripcr Не снимать возврат каретки
(По умолчанию)
no forcecr Не выполнять принудительный возврат каретки в
EOL (по умолчанию)
нет pass8bits Не принудительно использовать BODY = 8BITMIME для ESMTP
слушатель (по умолчанию)
no dropstatus Не сбрасывать заголовки статуса
(По умолчанию)
no dropdelivered Не отбрасывать заголовки Delivered-To
(По умолчанию)
нет mimedecode Не конвертировать цитируемый-печатный в
8 бит в сообщениях MIME (по умолчанию)
нет простоя Не бездействовать в ожидании нового
сообщения после каждого опроса (IMAP
только)
limit -l Установить ограничение на размер сообщения
warnings -w Установить интервал предупреждения о размере сообщения
batchlimit -b Максимальное количество сообщений для пересылки
одиночное соединение
fetchlimit -B Максимальное количество сообщений для получения за один
соединяться
fetchsizelimit Макс. # размер сообщения для извлечения
разовая транзакция
fastuidl Использовать двоичный поиск для первого невидимого
сообщение (только POP3)
expunge -e Выполнять удаление каждого # -го
сообщение (только IMAP и POP3)
свойства Строковое значение игнорируется
fetchmail (может использоваться
сценарии расширения)

Все параметры пользователя должны начинаться с описания пользователя (имя пользователя или имя пользователя) и следовать
все описания и опции сервера.

В файле .fetchmailrc строковому аргументу "конверт" может предшествовать пробел -
разделенное число. Это число, если указано, представляет собой количество таких заголовков, которые нужно пропустить.
(то есть аргумент 1 выбирает второй заголовок данного типа). Это когда-нибудь
полезно для игнорирования фальшивых заголовков конвертов, созданных локальным агентом доставки интернет-провайдера, или
внутренние пересылки (например, через системы проверки почты).

Ключевые слова Не соответствующий к Опция Коммутаторы
Параметры 'folder' и 'smtphost' (в отличие от их эквивалентов в командной строке) могут принимать
Список имен, следующих за ними, разделенных пробелами или запятыми.

Все параметры соответствуют очевидным аргументам командной строки, за исключением следующих: 'via',
'interval', 'aka', 'is', 'to', 'dns' / 'no dns', 'checkalias' / 'no checkalias', 'пароль',
'preconnect', 'postconnect', 'localdomains', 'stripcr' / 'no stripcr', 'forcecr' / 'нет
forcecr ',' pass8bits '/' no pass8bits '' dropstatus / no dropstatus ',' dropdelivered / no
dropdelivered »,« mimedecode / no mimedecode »,« без простоя »и« без конверта ».

Параметр 'via' предназначен, если вы хотите иметь более одной конфигурации, указывающей на
тот же сайт. Если он присутствует, строковый аргумент будет принят как фактическое DNS-имя
хост почтового сервера для запроса. Это переопределит аргумент опроса, который затем может
просто быть отдельной меткой для конфигурации (например, что вы дали бы в команде
строка для явного запроса этого хоста).

Параметр 'interval' (который принимает числовой аргумент) позволяет вам опрашивать сервер меньше
чаще, чем основной интервал опроса. Если вы говорите "интервал N", сервер этот параметр
прикреплен к, будет запрашиваться только каждые N интервалов опроса.

Одиночная капля против Многоточечный кредита
Убедитесь, что вы прочитали раздел под названием ИСПОЛЬЗОВАНИЕ И ЗЛОУПОТРЕБЛЕНИЕ OF МУЛЬТИДРОП Почтовые ящики если вы
намереваются использовать многоточечный режим.

Ключевые слова 'is' или 'to' связывают следующее локальное (клиентское) имя (имена) (или имя сервера
в сопоставления имени клиента, разделенные знаком =) с именем пользователя почтового сервера в записи. Если
В списке is / to list в качестве фамилии стоит '*', неизвестные имена просто передаются. Примечание
это до тех пор, пока Fetchmail версия 6.3.4 включительно, эти списки могут содержать только локальные части
имен пользователей (fetchmail будет смотреть только на часть до знака @). Fetchmail
версии 6.3.5 и новее поддерживают полные адреса в левой части этих сопоставлений,
и они имеют приоритет над любыми сопоставлениями «localdomains», «aka», «via» или аналогичными.

Одно локальное имя может использоваться для поддержки перенаправления вашей почты, когда ваше имя пользователя
клиентская машина отличается от вашего имени на почтовом сервере. Когда есть только один
локальное имя, почта пересылается на это локальное имя пользователя независимо от полученного сообщения,
Заголовки To, Cc и Bcc. В этом случае, Fetchmail никогда не выполняет поиск в DNS.

Когда существует более одного локального имени (или сопоставления имен), Fetchmail смотрит на конверт
заголовок, если он настроен, и в противном случае в заголовках Received, To, Cc и Bcc полученного
mail (это «многоточечный режим»). Он ищет адреса с совпадающими частями имени хоста.
ваше имя опроса или ваши параметры 'via', 'aka' или 'localdomains', а также обычно для
Части имени хоста, которые DNS сообщает ему, являются псевдонимами почтового сервера. См. Обсуждение
'dns', 'checkalias', 'localdomains' и 'aka' для получения подробной информации о том, как совпадают адреса.
обработано.

If Fetchmail не может совпадать с именами пользователей почтовых серверов или адресами локальных доменов, почта будет
быть отброшенным. Обычно он будет возвращен отправителю, но если 'bouncemail' глобальный
опция выключена, вместо этого почта будет отправляться местному почтмейстеру. (см. "почтмейстер"
глобальный вариант). См. Также ОШИБКИ.

Опция 'dns' (обычно включена) контролирует способ передачи адресов из многоточечных почтовых ящиков.
проверил. Включено, это позволяет логике проверять каждый адрес хоста, который не соответствует 'aka' или
объявление localdomains, просмотрев его с помощью DNS. Когда имя пользователя почтового сервера
распознается прикрепленным к соответствующей части имени хоста, его локальное отображение добавляется в список
местные получатели.

Опция 'checkalias' (обычно выключена) расширяет поиск, выполняемый ключевым словом 'dns'
в многоточечном режиме, предоставляя способ справиться с удаленными MTA, которые идентифицируют себя с помощью
их каноническое имя, при опросе с использованием псевдонима. Когда такой сервер опрашивается,
проверки на извлечение адреса конверта завершаются неудачно, и Fetchmail возвращается к доставке с помощью
Заголовки To / Cc / Bcc (см. Ниже «Адреса заголовков и конвертов»). Указание этой опции
инструктирует Fetchmail для получения всех IP-адресов, связанных с именем опроса
и имя, используемое удаленным MTA, и для сравнения IP-адресов. Этот
пригодится в ситуациях, когда удаленный сервер получает частое каноническое имя
изменения, которые в противном случае потребовали бы изменений в rcfile. checkalias не имеет
эффект, если в rcfile указано «no dns».

Параметр «ака» предназначен для использования с многоточечными почтовыми ящиками. Это позволяет вам предварительно объявить список
DNS-псевдонимов для сервера. Это оптимизационный прием, позволяющий торговать пространством.
для скорости. Когда Fetchmail, обрабатывая многоточечный почтовый ящик, пресмыкается через сообщение
заголовки, ищущие имена почтового сервера, предварительно объявив общие, могут спасти его от
необходимость выполнять поиск в DNS. Примечание: имена, которые вы указываете в качестве аргументов для 'aka', сопоставляются как
суффиксы - если вы укажете (скажем) 'aka netaxs.com', это будет соответствовать не только имени хоста
netaxs.com, но любое имя хоста, заканчивающееся на .netaxs.com; например, pop3.netaxs.com
и mail.netaxs.com.

Опция 'localdomains' позволяет вам объявить список доменов, которые fetchmail должен
считают местным. Когда fetchmail анализирует адресные строки в многоточечном режиме, а
конечный сегмент имени хоста соответствует объявленному локальному домену, этот адрес передается
через прослушиватель или MDA без изменений (сопоставления локальных имен применяемый).

Если вы используете «локальные домены», вам также может потребоваться указать «без конверта», что
отключает Fetchmailобычная попытка вывести адрес конверта из строки Received
или заголовок X-Envelope-To, или любой другой заголовок, ранее установленный параметром envelope. если ты
установить 'без конверта' в записи по умолчанию, это можно отменить в отдельных записях
используя конверт '. В особом случае конверт "Получено" восстанавливает
анализ полученных строк по умолчанию.

В password опция требует строкового аргумента, который является паролем, который будет использоваться с
сервер записи.

Ключевое слово preconnect позволяет указать команду оболочки, которая будет выполняться непосредственно перед
каждый раз Fetchmail устанавливает соединение с почтовым сервером. Это может быть полезно, если вы
пытается установить безопасные POP-соединения с помощью SSH(1). Если команда
возвращает ненулевой статус, опрос этого почтового сервера будет прерван.

Точно так же ключевое слово postconnect аналогичным образом позволяет вам указать команду оболочки, которая будет
выполняется сразу после каждого разрыва соединения с почтовым сервером.

Опция 'forcecr' определяет, будут ли строки, заканчивающиеся только LF, получать CRLF
прекращение до пересылки. Строго говоря, RFC821 требует этого, но несколько MTA
обеспечить соблюдение требования, поэтому эта опция обычно отключена (только один такой MTA, qmail, находится в
значительное использование на момент написания).

Опция 'stripcr' определяет, удаляются ли символы возврата каретки из полученной почты.
прежде, чем он будет отправлен. Обычно нет необходимости устанавливать это, потому что по умолчанию это
'on' (удаление CR включено), если MDA объявлено, но 'off' (удаление CR
отключено) при пересылке через SMTP. Если 'stripcr' и 'forcecr' включены, 'stripcr'
переопределит.

Параметр 'pass8bits' существует для того, чтобы справиться с почтовыми программами Microsoft, которые тупо шлепают
"Content-Transfer-Encoding: 7bit" для всего. Если этот параметр выключен (по умолчанию) и
такой заголовок присутствует, Fetchmail объявляет BODY = 7BIT слушателю, поддерживающему ESMTP; это
вызывает проблемы для сообщений, на самом деле использующих 8-битные наборы символов ISO или KOI-8, которые будут
быть искаженным из-за удаления старших битов всех символов. Если "pass8bits" включен,
Fetchmail принудительно объявляет BODY = 8BITMIME любому слушателю, поддерживающему ESMTP. Если
слушатель 8-битный (как и все основные сейчас), правильная вещь, вероятно,
результат.

Параметр dropstatus определяет, будут ли непустые строки Status и X-Mozilla-Status
сохраняется в полученной почте (по умолчанию) или отбрасывается. Их сохранение позволяет вашему MUA
посмотреть, какие сообщения (если есть) были отмечены как видимые на сервере. С другой стороны, это может
сбивают с толку некоторые уведомители о новой почте, которые предполагают, что все, в чем есть строка состояния, имеет
был замечен. (Примечание: пустые строки состояния, вставленные некоторыми ошибочными POP-серверами,
безоговорочно отвергнут.)

Параметр dropdelivered определяет, будут ли заголовки Delivered-To сохраняться в извлеченных
mail (по умолчанию) или отброшено. Эти заголовки добавляются почтовыми серверами Qmail и Postfix.
во избежание зацикливания почты, но может помешать вам, если вы попытаетесь "отразить" почтовый сервер
в том же домене. Используйте с осторожностью.

Параметр mimedecode определяет, будут ли сообщения MIME использовать кодировку с возможностью печати в кавычках.
автоматически преобразуются в чистые 8-битные данные. Если вы доставляете почту на ESMTP-
способный 8-битный чистый слушатель (который включает в себя все основные MTA, такие как sendmail), затем
это автоматически преобразует заголовки сообщений и данные с возможностью печати в кавычки в 8-битные данные,
облегчая понимание при чтении почты. Если ваши почтовые программы знают, что делать
с сообщениями MIME эта опция не нужна. Параметр mimedecode отключен
по умолчанию, потому что выполнение преобразования RFC2047 в заголовках отбрасывает информацию о наборе символов
и может привести к плохим результатам, если кодировка заголовков отличается от кодировки тела.

Параметр idle предназначен для использования с серверами IMAP, поддерживающими IDLE RFC2177.
расширение команды, но не требует его строго. Если он включен, и fetchmail
обнаруживает, что IDLE поддерживается, в конце каждого опроса выдается IDLE. Это будет
сообщить серверу IMAP, что соединение должно оставаться открытым, и уведомить клиента о поступлении новой почты.
доступный. Если IDLE не поддерживается, fetchmail будет имитировать его, периодически выдавая
НООП. Если вам нужно часто опрашивать ссылку, IDLE может сэкономить полосу пропускания, исключив TCP / IP.
подключает и последовательности ВХОД / ВЫХОД. С другой стороны, IDLE соединение сожрет почти
все время вашего fetchmail, потому что он никогда не разорвет соединение и не позволит другим
опросы происходят до тех пор, пока сервер не истечет время ожидания IDLE. Он также не работает с несколькими
папки; будет опрошена только первая папка.

Параметр «Свойства» - это механизм расширения. Он принимает строковый аргумент, который
игнорируется самой fetchmail. Строковый аргумент может использоваться для хранения конфигурации
информация для скриптов, которые этого требуют. В частности, вывод --configdump
опция сделает свойства, связанные с записью пользователя, легко доступными для Python
скрипты.

Прочее Run Control Возможности
Слова «здесь» и «там» имеют полезное английское значение. Обычно пользователь eric
is esr 'означало бы, что почта для удаленного пользователя' eric 'должна быть доставлена' esr ', но
вы можете прояснить это, сказав «пользователь Эрик, здесь есть esr», или отмените это, сказав
'пользователь esr вот здесь Эрик там'

Допустимые идентификаторы протокола для использования с ключевым словом protocol:

auto (или AUTO) (устаревшая версия, будет удалена из будущего выпуска)
pop2 (или POP2) (устаревшая версия, будет удалена из будущего выпуска)
pop3 (или POP3)
sdps (или SDPS)
imap (или IMAP)
апоп (или апоп)
kpop (или KPOP)

Допустимые типы аутентификации: any, password, kerberos, kerberos_v4, kerberos_v5.
и 'gssapi', 'cram-md5', 'otp', 'msn' (только для POP3), 'ntlm', 'ssh', 'external' (только
IMAP). Тип 'пароль' определяет аутентификацию путем обычной передачи пароля.
(пароль может быть простым текстом или подлежать шифрованию, зависящему от протокола, как в CRAM-
MD5); Керберос говорит Fetchmail чтобы попытаться получить билет Kerberos в начале каждого
запрос вместо этого и отправьте произвольную строку в качестве пароля; а gssapi сообщает fetchmail
использовать аутентификацию GSSAPI. См. Описание ключевого слова auth для получения дополнительной информации.

Указание «kpop» устанавливает протокол POP3 через порт 1109 с аутентификацией Kerberos V4.
Эти значения по умолчанию могут быть отменены более поздними параметрами.

Есть несколько операторов глобальных опций: 'set logfile', за которым следует строка, устанавливает то же самое
global определяется параметром --logfile. Параметр командной строки --logfile переопределит это. Примечание
этот --logfile эффективен только в том случае, если fetchmail отсоединяется от терминала и
файл журнала уже существует до запуска fetchmail, и в этом случае он переопределяет --syslog.
Кроме того, set daemon устанавливает интервал опроса, как это делает --daemon. Это может быть отменено
опция командной строки --daemon; в частности --daemon 0 можно использовать для принудительного включения переднего плана
операция. Оператор set postmaster устанавливает адрес, по которому многоточечная почта
значения по умолчанию, если нет локальных совпадений. Наконец, set syslog отправляет сообщения журнала в
syslogd(8).

ОТЛАДКА ПОЧТА

fetchmail грохот
Есть несколько причин, по которым fetchmail может "аварийно завершить работу", т.е. внезапно остановить работу и
неожиданно. "Сбой" обычно относится к состоянию ошибки, которое не выполнялось программным обеспечением.
обрабатывать сама по себе. Хорошо известным режимом отказа является «ошибка сегментации», или «сигнал 11», или
«SIGSEGV» или просто «segfault» для краткости. Они могут быть вызваны аппаратным или программным обеспечением.
проблемы. Программно-индуцированные ошибки сегментации обычно легко и быстро воспроизводятся.
место, в то время как аппаратные ошибки сегментации могут исчезнуть, если компьютер будет перезагружен, или
отключен на несколько часов и может произойти в случайных местах, даже если вы используете
программное обеспечение точно так же.

Для решения проблем, связанных с аппаратным обеспечением, найдите неисправный компонент и отремонтируйте или замените
Это. Часто задаваемые вопросы о Sig11 ⟨http://www.bitwizard.nl/sig11/⟩ Может помочь вам с деталями.

Для решения проблем с ошибками, вызванных программным обеспечением, разработчикам может потребоваться «трассировка стека».

Включение Fetchmail ядро свалках
По умолчанию fetchmail подавляет дампы ядра, поскольку они могут содержать пароли и другие данные.
конфиденциальная информация. Для отладки сбоев fetchmail получение «трассировки стека» от
дамп ядра часто является самым быстрым способом решения проблемы, и при публикации вашей проблемы
в списке рассылки разработчики могут попросить вас «проследить историю».

1. Для получения полезных трассировок необходимо установить fetchmail без удаления
его символы компиляции. К сожалению, большинство установленных бинарных пакетов
stripped, а файлы ядра из программ с удаленными символами бесполезны. Так что вам может понадобиться
перекомпилируйте fetchmail. Во многих системах вы можете ввести

файл `который fetchmail`

чтобы узнать, был ли fetchmail лишен символов или нет. Если у тебя была распашонка, хорошо,
продолжить, если он был удален, вам нужно сначала перекомпилировать исходный код. Ты не делай
обычно требуется установить fetchmail для его отладки.

2. В среде оболочки, запускающей fetchmail, необходимо разрешить дампы ядра. Ключ - это
"максимальный размер ядра (файла)", который обычно можно настроить с помощью инструмента с именем "limit" или
«улимит». Подробности смотрите в документации к вашей оболочке. В популярной оболочке bash
"ulimit -Sc unlimited" разрешит дамп ядра.

3. Вам также необходимо указать fetchmail, чтобы он разрешал дампы ядра. Для этого запустите fetchmail с
-d0 -v параметры. Часто бывает проще добавить --nosyslog -N так же.

Наконец, вам нужно воспроизвести аварию. Вы можете просто запустить fetchmail из каталога
где вы его скомпилировали, набрав ./fetchmail, поэтому полная командная строка будет начинаться с
./fetchmail -Nvd0 --nosyslog и, возможно, перечислите другие варианты.

После сбоя запустите отладчик, чтобы получить дамп ядра. Отладчик часто
GNU GDB, затем вы можете ввести (при необходимости скорректировать пути) GDB ./fetchmail fetchmail.core и
затем, после того, как GDB запустится и прочитает все его файлы, введите обратный след полный, спасти
вывод (скопируйте и вставьте, след будет читать человек), а затем введите выход в
оставить gdb. Примечание: в некоторых системах основные файлы имеют разные имена, они могут содержать
номер вместо имени программы или номер и имя, но обычно в нем будет слово "core"
как часть их имени.

ВЗАИМОДЕЙСТВИЕ RFC 822

При попытке определить адрес отправителя сообщения fetchmail просматривает
заголовки в следующем порядке:

Return-Path:
Resent-Sender: (игнорируется, если он не содержит @ или!)
Отправитель: (игнорируется, если он не содержит @ или!)
Resent-от:
От:
Ответить на:
Видимо-От:

Исходный адрес используется для регистрации и установки адреса MAIL FROM, когда
пересылка на SMTP. Этот заказ предназначен для того, чтобы изящно справиться с получением списка рассылки.
сообщения в многоточечном режиме. Цель состоит в том, что если локальный адрес не существует,
сообщение о недоставке не будет возвращено вслепую автору или самому списку, а скорее
в диспетчер списков (что меньше раздражает).

В многоточечном режиме заголовки адресатов обрабатываются следующим образом: Сначала fetchmail просматривает
для заголовка, указанного параметром "конверт", чтобы определить локальный
адрес получателя. Если письмо адресовано более чем одному получателю, в строке «Получено»
не будет содержать никакой информации об адресах получателей.

Затем fetchmail ищет строки Resent-To :, Resent-Cc: и Resent-Bcc :. Если они
существуют, они должны содержать конечных получателей и иметь приоритет перед их
Кому: / Копия: / Скрытая копия: копии. Если строки Resent- * не существуют, то поля To :, Cc :, Bcc: и
Судя по всему-To: ищутся строчки. (Наличие Resent-To: подразумевает, что
лицо, на которое ссылается адрес "Кому:", уже получило оригинал
Почта.)

КОНФИГУРАЦИЯ ПРИМЕРЫ

Обратите внимание, что хотя во многих приведенных ниже примерах есть объявления паролей,
это в основном для иллюстративных целей. Мы рекомендуем хранить пары учетная запись / пароль в
ваш файл $ HOME / .netrc, где они могут использоваться не только fetchmail, но и FTP(1) и
другие программы.

Базовый формат:

голосование НАЗВАНИЕ СЕРВЕРА протокол ПРОТОКОЛ username ИМЯ password PASSWORD

Пример:

опрос протокола pop.provider.net pop3 имя пользователя "jsmith" пароль "secret1"

Или, используя некоторые сокращения:

опрос pop.provider.net proto pop3 пользователь "jsmith" пароль "secret1"

Могут быть перечислены несколько серверов:

опрос pop.provider.net proto pop3 пользователь "jsmith" передать "secret1"
опрос other.provider.net proto 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 с помощью proto pop3:
у пользователя "jsmith" есть пароль "4u, но вы не можете это сделать"
находится здесь jws и хочет, чтобы mda "/ bin / mail"

У вас может быть начальное описание сервера, озаглавленное ключевым словом defaults вместо
"опрос", за которым следует имя. Такая запись интерпретируется как значение по умолчанию для всех запросов к
использовать. Он может быть перезаписан отдельными описаниями серверов. Итак, вы могли написать:

по умолчанию proto pop3
пользователь "jsmith"
опрос pop.provider.net
передать "secret1"
опрос mail.provider.net
у пользователя "jjsmith" есть пароль "secret2"

На каждый сервер можно указать более одного пользователя. Ключевое слово "пользователь" ведет к
описание пользователя, и каждая пользовательская спецификация в многопользовательской записи должна включать его.
Вот пример:

опрос pop.provider.net proto pop3 порт 3111
пользователь "jsmith" с пропуском "secret1" здесь "smith"
пользователь jones с пропуском "secret2" is "jjones" здесь сохраните

Это связывает локальное имя пользователя smith с именем пользователя pop.provider.net jsmith и
локальное имя пользователя jjones с именем пользователя pop.provider.net jones. Почта для 'jones'
после загрузки сохраняется на сервере.

Вот как выглядит простая конфигурация извлечения для многоточечного почтового ящика:

опрос pop.provider.net:
пользователь maildrop с pass secret1 для golux 'hurkle' = 'happy' snark здесь

Это говорит о том, что почтовый ящик учетной записи maildrop на сервере является многоточечным ящиком, и
что сообщения в нем должны быть проанализированы на предмет имен пользователей сервера 'golux', 'hurkle' и
'snark'. Кроме того, он указывает, что у «golux» и «snark» одно и то же имя на клиенте.
как на сервере, но почта для пользователя сервера 'Hurkle' должна доставляться пользователю-клиенту
'счастливый'.

Внимание который почта, до версии 6.3.4 НЕ допускались полные спецификации user @ domain
здесь они никогда не совпадают. fetchmail 6.3.5 и новее поддерживают user @ domain
спецификации в левой части отображения пользователя.

Вот пример другого типа многоточечного соединения:

опрос pop.provider.net localdomains loonytoons.org toons.org
конверт X-Envelope-To
пользователь maildrop с секретом от 1 до * здесь

Это также говорит о том, что почтовый ящик учетной записи maildrop на сервере является многоточечным ящиком.
Он сообщает fetchmail, что любой адрес в доменах loonytoons.org или toons.org (включая
адреса субдоменов, например '[электронная почта защищена]') следует передать в
локальный прослушиватель SMTP без изменений. Остерегайтесь зацикливания почты, если вы это сделаете!

Вот пример конфигурации с использованием ssh и опции плагина. Запросы сделаны
непосредственно на stdin и stdout imapd через ssh. Обратите внимание, что в этой настройке IMAP
аутентификацию можно пропустить.

опрос mailhost.net с помощью proto imap:
плагин "ssh% h / usr / sbin / imapd" auth ssh;
пользователь esr здесь esr

ИСПОЛЬЗОВАНИЕ И ЗЛОУПОТРЕБЛЕНИЕ OF МУЛЬТИДРОП Почтовые ящики

С осторожностью используйте функцию множественных локальных получателей - она ​​может укусить. Все многоточечные
функции неэффективны в режимах ETRN и ODMR.

Также обратите внимание, что в многоточечном режиме дублирование писем подавляется. Письмо
считается дубликатом, если он имеет тот же идентификатор сообщения, что и сообщение, непосредственно предшествующее
и более одного адресата. Такие серии сообщений могут быть созданы, когда копии
сообщения, адресованные нескольким пользователям, доставляются в многоточечный ящик.

заголовок против Конверт адреса
Основная проблема заключается в том, что если ваш почтовый сервер перебрасывает почту нескольких людей в один
один почтовый ящик, вы, возможно, выбросили потенциально важную информацию о том, кто каждый
письмо было адресовано на (адрес конверта, а не заголовок
адреса в заголовках RFC822 To / Cc - скрытая копия недоступна на принимающей стороне).
Этот «адрес в конверте» - это адрес, который вам нужен для правильного перенаправления почты.

Иногда Fetchmail можно узнать адрес конверта. Если почтовый сервер MTA Отправить письмо
и у почтового отправления был только один получатель, MTA будет писать пункт "для / для"
который указывает адресата конверта в заголовок Received. Но это не работает надежно
для других MTA, а также при наличии более одного получателя. По умолчанию, Fetchmail ищет
адреса конвертов в этих строках; вы можете восстановить это значение по умолчанию с помощью -E "Получено" или
"конверт получен".

As a better альтернатива, некоторые прослушиватели SMTP и / или почтовые серверы вставляют заголовок в каждый
сообщение, содержащее копию адресов в конверте. Этот заголовок (если он существует)
часто «Кому-оригинал», «Кому доставлен» или «Кому-конверту». Предположение Fetchmail о
это можно изменить с помощью опции -E или 'envelope'. Обратите внимание, что написание конверта
заголовок такого типа раскрывает имена получателей (включая получателей скрытых копий)
все получатели сообщений, поэтому восходящий поток должен хранить одну копию сообщения на
получатель, чтобы избежать проблем с конфиденциальностью.

Postfix, начиная с версии 2.0, записывает заголовок X-Original-To :, который содержит копию
конверт в том виде, в котором он был получен.

Qmail и Postfix обычно пишут заголовок Delivered-To при доставке сообщения в
почтовую катушку и используйте ее, чтобы избежать зацикливания почты. Однако виртуальные домены Qmail будут иметь префикс
имя пользователя со строкой, которая обычно соответствует домену пользователя. Чтобы удалить этот префикс
вы можете использовать опцию -Q или qvirtual.

Иногда, к сожалению, ни один из этих методов не работает. Это тот момент, когда вы
следует связаться с вашим интернет-провайдером и попросить его предоставить такой заголовок конверта, и вам следует
не используйте многоточечный режим в этой ситуации. Когда все они терпят неудачу, fetchmail должен вернуться к
содержимое заголовков To / Cc (заголовки Bcc недоступны - см. ниже), чтобы попытаться определить
адресаты получателя - а они ненадежны. В частности, программное обеспечение для рассылки
часто отправляет почту только со списком широковещательных адресов в заголовке «Кому».

Внимание который a в будущем версия of Fetchmail май удаление Кому / Копия разбор!

После появления Fetchmail не может определить адрес получателя, который является локальным, и предполагаемый получатель
адрес был кем угодно, кроме вызывающего пользователя fetchmail, почта предусматривает получить потерял. Это то, что
делает использование многоточечного соединения рискованным без надлежащей информации о конверте.

Связанная проблема заключается в том, что при слепом копировании почтового сообщения информация скрытой копии
проводятся Важно как адрес конверта (он удаляется из заголовков отправляющим письмом
server, поэтому fetchmail может видеть его, только если есть заголовок X-Envelope-To). Таким образом, слепой-
копирование тому, кто получает почту по многоточечной ссылке fetchmail, не удастся, если
хост почтового сервера обычно записывает X-Envelope-To или эквивалентный заголовок в сообщения в
ваш maildrop.

In заключение, рассылки списки и Скрытая копия почта Важно работает if сервер Вы выборка
к

(1) магазины one копия of сообщение для получатель in домен и

(2) учет конверт информация in a особый заголовок (X-Оригинал-To, Доставлен в,
X-конверт-Кому).

Хорошо пути к Используйте Многоточечный Почтовые ящики
Для управления списком рассылки со стороны клиента можно использовать несколько локальных имен.
Fetchmail коллекция. Предположим, вас зовут 'esr', и вы оба хотите взять свой собственный
mail и поддерживать список рассылки, называемый (скажем) "fetchmail-friends", и вы хотите, чтобы
список псевдонимов на вашем клиентском компьютере.

На вашем сервере вы можете использовать псевдоним «fetchmail-friends» для «esr»; тогда в вашем .fetchmailrc,
объявить "esr fetchmail-friends здесь". Затем, когда почта включает "fetchmail-friends" как
выбирается локальный адрес, имя списка будет добавлено к списку получателей
ваш слушатель SMTP видит. Поэтому псевдоним будет расширяться локально. Обязательно
включите 'esr' в расширение локального псевдонима fetchmail-friends, иначе вы никогда не увидите почту
отправлено только в список. Также убедитесь, что у вашего слушателя установлен параметр "я тоже"
(параметр командной строки sendmail -oXm или объявление OXm), чтобы ваше имя не было удалено из
расширения псевдонимов в отправляемых вами сообщениях.

Однако этот трюк не лишен проблем. Вы начнете это видеть, когда появится сообщение
приходит, который адресован только списку рассылки, который вы делаете заявили как местный
имя. Каждое такое сообщение будет содержать заголовок X-Fetchmail-Warning, который создается.
потому что fetchmail не может найти допустимое локальное имя в адресах получателей. Такой
сообщения по умолчанию (как описано выше) отправляются локальному пользователю, выполняющему
Fetchmail, но программа не знает, что это действительно правильно.

Плохой пути к Злоупотребление Многоточечный Почтовые ящики
Многоточечные почтовые ящики и Fetchmail обслуживание нескольких пользователей в режиме демона не смешивается. В
проблема, опять же, - это письма из списков рассылки, в которых обычно нет индивидуальных
адрес получателя на нем. Пока не Fetchmail можно вывести адрес конверта, такая почта будет
заходите только в учетную запись, на которой запущен fetchmail (возможно, root). Кроме того, слепые пользователи
очень вероятно, что их почту вообще не увидят.

Если у вас возникнет соблазн использовать Fetchmail для получения почты для нескольких пользователей из одной почты
сбросьте через POP или IMAP, подумайте еще раз (и перечитайте раздел об адресах заголовка и конверта
выше). Было бы разумнее просто позволить почте оставаться в очереди почтового сервера и использовать
Режимы ETRN или ODMR в fetchmail для периодической отправки SMTP-рассылок (конечно, это означает
вы должны опрашивать чаще, чем истекает срок действия почтового сервера). Если ты не можешь
устроить это, попробуйте настроить канал UUCP.

Если вы абсолютно должен используйте для этой цели многоточечный режим, убедитесь, что ваш почтовый сервер пишет
Заголовок адреса конверта, который может видеть fetchmail. В противном случае вы предусматривает потерять почту и это предусматривает
вернуться, чтобы преследовать вас.

Превышение скорости Up Многоточечный Контроль
Обычно, когда объявляется несколько пользователей Fetchmail извлекает адреса получателей как
описанный выше, и проверяет каждую часть хоста с помощью DNS, чтобы убедиться, что это псевдоним
почтовый сервер. Если да, то сопоставления имен, описанные в объявлении "в ... здесь", выполняются.
и почта доставлена ​​на месте.

Это удобный, но медленный метод. Чтобы ускорить это, предварительно объявите псевдонимы почтового сервера
с «ака»; они проверяются перед выполнением поиска DNS. Если вы уверены, что ваша ака
список содержит ВСЕ DNS-псевдонимы почтового сервера (и все имена MX, указывающие на него - примечание
это может измениться в будущей версии) вы можете объявить 'no dns', чтобы подавить поиск DNS
полностью и Важно матч против списка ака.

НОСКИ

Поддержка socks4 / 5 - это компилировать время вариант конфигурации. После компиляции fetchmail
всегда будет использовать библиотеки и конфигурацию socks в вашей системе, нет запуска -
переключатели времени в 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 в FAQ.

2 Произошла ошибка при попытке открыть сокет для получения почты. если ты
не знаю, что такое сокет, не беспокойтесь об этом - просто рассматривайте это как
"неустранимая ошибка". Эта ошибка также может быть вызвана тем, что протокол fetchmail хочет
для использования не указан в / etc / services.

3 Ошибка аутентификации пользователя. Обычно это означает, что неправильный идентификатор пользователя,
был указан пароль или идентификатор APOP. Или это может означать, что вы пытались запустить fetchmail
при обстоятельствах, когда у него не было стандартного ввода, подключенного к терминалу и
не может запросить отсутствующий пароль.

4 Обнаружена фатальная ошибка протокола.

5 В аргументах к Fetchmail, или до или после подключения
команда не удалась.

6 У файла управления запуском были недопустимые разрешения.

7 Сервер сообщил об ошибке. Также может стрелять, если Fetchmail
время ожидания сервера истекло.

8 Ошибка исключения на стороне клиента. Это означает Fetchmail либо нашел другую копию
сам уже работает, или отказал таким образом, что не уверен, что другой
копия работает.

9 Шаг аутентификации пользователя завершился неудачно, поскольку сервер ответил «блокировка занята». Пытаться
снова после небольшой паузы! Эта ошибка реализована не для всех протоколов и не для всех.
для всех серверов. Если это не реализовано для вашего сервера, вместо этого будет возвращено "3",
см. выше. Может быть возвращено при разговоре с qpopper или другими серверами, которые могут
ответьте сообщением «блокировка занята» или другим подобным текстом, содержащим слово «блокировка».

10 Fetchmail Ошибка запуска при попытке открыть порт SMTP или транзакцию.

11 Неустранимая ошибка DNS. Fetchmail обнаружил ошибку при выполнении поиска DNS на
запуск и не удалось продолжить.

12 Не удалось открыть командный файл BSMTP.

13 Опрос завершен лимитом выборки (см. Параметр --fetchlimit).

14 Индикация занятости сервера.

23 Внутренняя ошибка. Вы должны увидеть сообщение о стандартной ошибке с подробностями.

24 - 26 28 г.
Это внутренние коды, которые не должны отображаться снаружи.

После появления Fetchmail запрашивает более одного хоста, статус возврата - 0, если любой запрос успешно
получил почту. В противном случае возвращается статус ошибки последнего запрошенного хоста.

Используйте fetchmail в Интернете с помощью сервисов onworks.net