popclient - Online nel cloud

PROGRAMMA:

NOME

fetchmail - recupera la posta da un server POP, IMAP, ETRN o ODMR

SINOSSI

recuperare la posta [opzione...] [server email...]
fetchmailconf

DESCRIZIONE

recuperare la posta è un'utilità di recupero e inoltro della posta; recupera la posta da remoto
server di posta e lo inoltra al sistema di consegna della macchina locale (client). Puoi
quindi gestisci la posta recuperata usando normali agenti utente di posta come cane bastardo(1), olmo(1) o
posta(1). Il recuperare la posta l'utilità può essere eseguita in modalità demone per interrogare ripetutamente uno o più
sistemi a intervalli prestabiliti.

. recuperare la posta programma può raccogliere la posta dai server che supportano uno qualsiasi dei comuni
protocolli di recupero: POP2 (legacy, da rimuovere dalla versione futura), POP3, IMAP2bis,
IMAP4 e IMAP4rev1. Può anche utilizzare l'estensione ESMTP ETRN e ODMR. (Le RFC
che descrivono tutti questi protocolli sono elencati alla fine di questa pagina di manuale.)

Mentre recuperare la posta è pensato principalmente per essere utilizzato su collegamenti TCP/IP su richiesta (come SLIP
o connessioni PPP), può essere utile anche come agente di trasferimento messaggi per siti che
rifiutare per motivi di sicurezza di consentire transazioni SMTP (avviate dal mittente) con sendmail.

SUPPORTO, RISOLUZIONE DEI PROBLEMI
Per la risoluzione dei problemi, la traccia e il debug, è necessario aumentare la verbosità di fetchmail per
effettivamente vedere cosa succede. Per farlo, per favore corri entrambi of , il Tutto i seguenti comandi,
l'aggiunta di contro tutti i of , il Opzioni tu normalmente utilizzare.

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

(Questa riga di comando stampa in inglese come fetchmail interpreta la tua configurazione.)

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

(Questa riga di comando esegue effettivamente fetchmail con un output inglese dettagliato.)

Vedi anche l'articolo #G3 nelle FAQ di fetchmail ⟨http://fetchmail.berlios.de/fetchmail-FAQ.html#S3⟩

Puoi omettere la parte LC_ALL=C sopra se vuoi l'output nella lingua locale (se
supportato). Tuttavia, se stai postando su mailing list, lascialo dentro
i manutentori non capiscono necessariamente la tua lingua, usa l'inglese.

CONCETTI
If recuperare la posta viene utilizzato con un server POP o IMAP (ma non con ETRN o ODMR), ne ha due
modalità operative fondamentali per ogni account utente da cui si recupera la posta:
singola goccia- E multigoccia-modalità.

In modalità singledrop,
recuperare la posta presuppone che tutti i messaggi nell'account dell'utente (casella di posta) siano destinati
per un unico destinatario. L'identità del destinatario verrà impostata automaticamente su
utente locale attualmente in esecuzione recuperare la posta, o dovrà essere specificato esplicitamente
nel file di configurazione.

recuperare la posta usa la modalità singledrop quando la configurazione di fetchmailrc contiene al massimo
una singola specifica utente locale per un determinato account del server.

In modalità multidrop,
recuperare la posta presuppone che l'account del server di posta contenga effettivamente la posta destinata
un numero qualsiasi di destinatari diversi. Perciò, recuperare la posta deve tentare di dedurre
il corretto "destinatario della busta" dalle intestazioni di posta di ciascun messaggio. In questo
modalità di funzionamento, recuperare la posta assomiglia quasi a un agente di trasferimento di posta (MTA).

Si noti che né i protocolli POP né IMAP erano destinati a essere utilizzati in questo modo,
e quindi le informazioni sulla busta spesso non sono direttamente disponibili. L'ISP deve
memorizza le informazioni sulla busta in qualche intestazione del messaggio e. L'ISP deve anche memorizzare
una copia del messaggio per destinatario. Se una delle condizioni non è
soddisfatta, questo processo è inaffidabile, perché recuperare la posta deve quindi ricorrere a
indovinare i veri destinatari della busta di un messaggio. Questo di solito fallisce per
messaggi della mailing list e Ccn:d mail, o posta per più destinatari nel tuo
dominio.

recuperare la posta usa la modalità multidrop quando più di un utente locale e/o un carattere jolly è
specificato per un particolare account del server nel file di configurazione.

Nelle modalità ETRN e ODMR,
queste considerazioni non valgono, in quanto questi protocolli sono basati su SMTP, che
fornisce informazioni esplicite sul destinatario della busta. Questi protocolli supportano sempre
più destinatari.

Quando ogni messaggio viene recuperato, recuperare la posta normalmente lo consegna tramite SMTP alla porta 25 del
macchina su cui è in esecuzione (localhost), proprio come se fosse passato su un normale
Collegamento TCP/IP. recuperare la posta fornisce al server SMTP un destinatario della busta derivato nel
modo descritto in precedenza. La posta verrà quindi consegnata in base ai tuoi MTA
regole (l'agente di trasferimento di posta è solitamente sendmail(8), exim(8), o postfix(8)). Invocare
l'MDA (Mail Delivery Agent) del tuo sistema è compito del tuo MTA. Tutto il controllo della consegna
meccanismi (come .inoltrare file) normalmente disponibili tramite il sistema MTA e local
gli agenti di consegna saranno quindi applicati come di consueto.

Se la configurazione di fetchmail imposta un MDA locale (vedi l'opzione --mda), verrà utilizzato
direttamente invece di parlare SMTP alla porta 25.

Se il programma fetchmailconf è disponibile, ti assisterà nell'impostazione e nella modifica di un
configurazione di fetchmailrc. Funziona sotto il sistema X Window e richiede che il
linguaggio Python e il toolkit Tk (con collegamenti Python) siano presenti sul tuo sistema. Se
stai prima configurando fetchmail per la modalità utente singolo, si consiglia di utilizzare
Modalità principiante. La modalità esperto fornisce il controllo completo della configurazione di fetchmail, incluso
le caratteristiche multidrop. In entrambi i casi, il pulsante "Autoprobe" ti dirà di più
protocollo compatibile supportato da un determinato server di posta e avvisa di potenziali problemi con questo
server.

GENERALE FUNZIONAMENTO

Il comportamento di recuperare la posta è controllato dalle opzioni della riga di comando e da un file di controllo dell'esecuzione,
~/.fetchmailrc, la cui sintassi verrà descritta in una sezione successiva (questo file è ciò che
fetchmailconf modifiche del programma). Le opzioni della riga di comando sovrascrivono ~/.fetchmailrc dichiarazioni.

Ogni nome di server che specifichi seguendo le opzioni sulla riga di comando sarà
interrogato. Se non specifichi alcun server sulla riga di comando, ogni voce 'sondaggio' nel tuo
~/.fetchmailrc file verrà interrogato.

Per facilitare l'uso di recuperare la posta negli script e nelle pipeline, restituisce un'appropriata
codice di uscita al termine - vedere CODICI DI USCITA di seguito.

Le seguenti opzioni modificano il comportamento di recuperare la posta. Raramente è necessario specificare
uno di questi una volta che hai un lavoro .fetchmailrc file impostato.

Quasi tutte le opzioni hanno una parola chiave corrispondente che può essere utilizzata per dichiararle in a
.fetchmailrc file.

Alcune opzioni speciali non sono trattate qui, ma sono invece documentate nelle sezioni su
AUTENTICAZIONE e MODALITÀ DAEMON che seguono.

Informazioni Opzioni
-V | --versione
Visualizza le informazioni sulla versione per la tua copia di recuperare la posta. Nessun recupero della posta è
eseguita. Invece, per ogni server specificato, tutte le informazioni sull'opzione che
sarebbe calcolato se recuperare la posta si stavano connettendo a quel server. Qualunque
i non stampabili nelle password o in altri nomi di stringhe sono mostrati come barra rovesciata tipo C
sequenze di fuga Questa opzione è utile per verificare che le tue opzioni siano impostate
nel modo in cui li vuoi.

-c | --dai un'occhiata
Restituire un codice di stato per indicare se c'è posta in attesa, senza effettivamente
recupero o eliminazione della posta (vedi CODICI DI USCITA di seguito). Questa opzione disattiva il demone
modalità (in cui sarebbe inutile). Non funziona bene con le query multiple
siti e non funziona con ETRN o ODMR. Restituirà un falso positivo se tu
lascia la posta letta ma non eliminata nella casella di posta del server e il tuo protocollo di recupero non può
dire messaggi conservati da quelli nuovi. Ciò significa che funzionerà con IMAP, non con
POP2, e può occasionalmente sfaldarsi sotto POP3.

-s | --silenzioso
Modalità silenziosa. Sopprime tutti i messaggi di avanzamento/stato a cui normalmente si fa eco
output standard durante un recupero (ma non sopprime i messaggi di errore effettivi). Il
L'opzione --verbose lo sovrascrive.

-v | --verboso
Modalità dettagliata. Tutti i messaggi di controllo passati tra recuperare la posta e il server di posta sono
echeggiato a stdout. Sostituzioni --silenzioso. Raddoppiare questa opzione (-v -v) provoca extra
informazioni diagnostiche da stampare.

--nosoftbounce
(dalla v6.3.10, Parola chiave: non impostare il softbounce, dalla v6.3.10)
Modalità di rimbalzo duro. Tutti gli errori di consegna permanenti causano l'eliminazione dei messaggi da
il server upstream, vedere "nessun softbounce" di seguito.

--rimbalzo morbido
(dalla v6.3.10, Parola chiave: set softbounce, dalla v6.3.10)
Modalità di rimbalzo morbido. Tutti gli errori di consegna permanenti fanno sì che i messaggi vengano lasciati sul
server upstream se il protocollo lo supporta. Questo opzione is on by difetto a
stile storico recuperare la posta documentazione, e sarà cambiato in modalità hard bounce in
la prossima versione di fetchmail.

Smaltimento Opzioni
-a | --tutti | (da v6.3.3) --raccolta
(Parola chiave: recupera, dalla v3.0)
Recupera sia i vecchi (visti) che i nuovi messaggi dal server di posta. L'impostazione predefinita è
recupera solo i messaggi che il server non ha contrassegnato come visti. Sotto POP3, anche questa opzione
impone l'uso di RETR anziché di TOP. Nota che il recupero POP2 si comporta come se
--all è sempre attivo (vedi MODALITÀ DI ERRORE DI RECUPERO più avanti) e questa opzione no
lavorare con ETRN o ODMR. Mentre la riga di comando -a e --all e fetchall rcfile
le opzioni sono state supportate per molto tempo, l'opzione della riga di comando --fetchall era
aggiunto nella v6.3.3.

-k | --mantenere
(Parola chiave: mantenere)
Conserva i messaggi recuperati sul server di posta remoto. Normalmente, i messaggi vengono cancellati
dalla cartella sul server di posta dopo che sono stati recuperati. Specificando il
mantenere L'opzione fa sì che i messaggi recuperati rimangano nella cartella sul server di posta.
Questa opzione non funziona con ETRN o ODMR. Se utilizzato con POP3, è consigliato
per specificare anche l'opzione --uidl o la parola chiave uidl.

-K | --nokeep
(Parola chiave: nokeep)
Elimina i messaggi recuperati dal server di posta remoto. Questa opzione forza il recupero
posta da cancellare. Potrebbe essere utile se hai specificato un valore predefinito di mantenere in
il tuo .fetchmailrc. Questa opzione è forzata con ETRN e ODMR.

-F | --sciacquone
(Parola chiave: a filo)
Solo POP3/IMAP. Questa è un'opzione pericolosa e può causare la perdita della posta quando viene utilizzata
impropriamente. Elimina i vecchi messaggi (visti) dal server di posta prima di recuperarli
nuovo messaggio. Attenzione: Ciò può causare la perdita della posta se controlli la tua posta con altri
client di fetchmail e fa in modo che fetchmail elimini un messaggio che non aveva mai
recuperato prima. Può anche causare la perdita della posta se il server di posta contrassegna il messaggio
visualizzato dopo il recupero (server IMAP2). Probabilmente non dovresti usare questa opzione in
il tuo file di configurazione Se lo usi con POP3, devi usare l'opzione 'uidl'.
Quello che probabilmente vuoi è l'impostazione predefinita: se non specifichi '-k', allora
fetchmail cancellerà automaticamente i messaggi dopo che la consegna è andata a buon fine.

--limitflush
Solo POP3/IMAP, dalla versione 6.3.0. Elimina i messaggi di grandi dimensioni dal server di posta
prima di ricevere nuovi messaggi. Il limite di dimensione deve essere specificato separatamente con
l'opzione --limit. Questa opzione non funziona con ETRN o ODMR.

Protocollo e domanda Opzioni
-p | --proto | --protocollo
(Parola chiave: protocollo[col])
Specificare il protocollo da utilizzare durante la comunicazione con il server di posta remoto. se no
è specificato il protocollo, il valore predefinito è AUTO. proto può essere uno dei seguenti:

AUTO Prova IMAP, POP3 e POP2 (saltando quelli per i quali il supporto non ha
stato compilato in).

POP2 Post Office Protocol 2 (precedente, da rimuovere dalla versione futura)

POP3 protocollo postale 3

APOP Usa POP3 con l'autenticazione sfida MD5 vecchio stile. Non considerato
resistente agli attacchi man-in-the-middle.

RPOP Usa POP3 con autenticazione RPOP.

KPOP Usa POP3 con autenticazione Kerberos V4 sulla porta 1109.

SDPS Usa POP3 con le estensioni SDPS di Demon Internet.

IMAP IMAP2bis, IMAP4 o IMAP4rev1 (recuperare la posta rileva automaticamente il loro
capacità).

ETRN Utilizzare l'opzione ESMTP ETRN.

ODMR Utilizzare il profilo ESMTP di inoltro della posta su richiesta.

Tutte queste alternative funzionano sostanzialmente allo stesso modo (comunicando con un server standard
demoni per recuperare la posta già consegnata a una casella di posta sul server) eccetto ETRN e ODMR.
La modalità ETRN ti consente di chiedere a un server ESMTP conforme (come BSD sendmail al rilascio
8.8.0 o versioni successive) per aprire immediatamente una connessione mittente-SMTP alla macchina client e
iniziare a inoltrare tutti gli elementi indirizzati alla macchina client nella coda del server di
posta non consegnata. La modalità ODMR richiede un server compatibile con ODMR e funziona in modo simile a
ETRN, tranne per il fatto che non richiede che la macchina client disponga di un DNS statico.

-U | --uidl
(Parola chiave: uidl)
Forza l'uso dell'UIDL (valido solo con POP3). Forza il monitoraggio lato client della "novità"
di messaggi (UIDL sta per "elenco ID univoco" ed è descritto in RFC1939). Utilizzo
con 'mantieni' per utilizzare una casella di posta come notiziario per bambini per un gruppo di utenti. Il fatto
che i messaggi visualizzati vengono saltati viene registrato, a meno che la registrazione degli errori non venga eseguita tramite
syslog durante l'esecuzione in modalità demone. Nota che fetchmail potrebbe attivarsi automaticamente
questa opzione dipende dalle capacità del server upstream. Nota anche che questa opzione
potrebbe essere rimosso e forzatamente abilitato in una futura versione di fetchmail. Guarda anche:
--idfile.

--oziare (da 6.3.3)
(Parola chiave: inattivo, da prima della 6.0.0)
Abilita uso IDLE (valido solo con IMAP). Nota che funziona solo con uno
cartella in un determinato momento. Mentre la parola chiave idle rcfile era stata supportata per a
molto tempo, l'opzione della riga di comando --idle è stata aggiunta nella versione 6.3.3. Uso inattivo
significa che fetchmail dice al server IMAP di inviare un avviso di nuovi messaggi, quindi loro
può essere recuperato prima di quanto sarebbe possibile con sondaggi regolari.

-P | --servizio
(Parola chiave: servizio) Dalla versione 6.3.0.
L'opzione di servizio consente di specificare un nome di servizio a cui connettersi. Puoi
specificare un numero di porta decimale qui, se il database dei servizi non dispone di quanto richiesto
incarichi portuali di servizio. Vedere l'articolo FAQ R12 e la documentazione --ssl per
particolari. Questo sostituisce la vecchia opzione --port.

--porta
(Parola chiave: porto)
Versione obsoleta di --service che non accetta nomi di servizio. Nota: questa opzione
potrebbe essere rimosso da una versione futura.

--principale
(Parola chiave: principale)
L'opzione principale consente di specificare un'entità servizio per mutuo
autenticazione. Questo è applicabile a POP3 o IMAP con autenticazione Kerberos 4
soltanto. Non si applica a Kerberos 5 o GSSAPI. Questa opzione può essere rimossa in a
futura versione di fetchmail.

-t | --tempo scaduto
(Parola chiave: timeout)
L'opzione timeout consente di impostare un timeout di mancata risposta del server in secondi. Se un
il server di posta non invia un messaggio di saluto o non risponde ai comandi per il dato
numero di secondi, recuperare la posta interromperà la connessione ad esso. Senza tale a
timeout recuperare la posta potrebbe bloccarsi fino al timeout della connessione TCP, cercando di recuperare
posta da un host inattivo, che potrebbe essere molto lungo. Questo sarebbe particolarmente fastidioso
per recuperare la posta in esecuzione in background. C'è un timeout predefinito che
fetchmail -V riporterà. Se una determinata connessione riceve troppi timeout in
successione, fetchmail lo considererà bloccato e smetterà di riprovare. L'utente chiamante
verrà avvisato via e-mail se ciò accade.

A partire da fetchmail 6.3.10, il client SMTP utilizza il minimo consigliato
timeout da RFC-5321 durante l'attesa del server SMTP/LMTP con cui sta parlando.
Puoi aumentare ulteriormente i timeout, ma non puoi accorciarli. Questo è da evitare
una situazione dolorosa in cui fetchmail è stato configurato con un breve timeout (a
minuto o meno), invia un messaggio lungo (molti MByte) all'MTA locale, che quindi
impiega più tempo del timeout per rispondere "OK", cosa che alla fine accadrà; che avrebbe
significa che la posta viene consegnata correttamente, ma fetchmail non può notarla e quindi lo farà
ripeti questo grande messaggio più e più volte.

--collegare
(Parola chiave: plug-in)
L'opzione plugin ti permette di usare un programma esterno per stabilire il TCP
connessione. Questo è utile se vuoi usare ssh o hai bisogno di qualcosa di speciale
configurazione del firewall. Il programma verrà cercato in $PATH e può essere facoltativamente
passato il nome host e la porta come argomenti usando rispettivamente "%h" e "%p" (nota
che la logica di interpolazione è piuttosto primitiva e questi token devono essere limitati
per spazi bianchi o all'inizio della stringa o alla fine della stringa). Fetchmail scriverà a
lo stdin del plugin e leggere dallo stdout del plugin.

--plug-out
(Parola chiave: plug-in)
Identica all'opzione plugin sopra, ma questa è usata per l'SMTP
connessioni.

-r | --cartella
(Parola chiave: cartella[s])
Causa una cartella di posta non predefinita specificata sul server di posta (o separata da virgole
elenco di cartelle) da recuperare. La sintassi del nome della cartella è server-
dipendente. Questa opzione non è disponibile in POP3, ETRN o ODMR.

--tracepoll
(Parola chiave: tracepolls)
Dire a fetchmail di eseguire il polling delle informazioni nella forma 'account di polling %s' e
'cartella %s' alla riga Received che genera, dove le parti %s sono sostituite da
il nome remoto dell'utente, l'etichetta del sondaggio e la cartella (casella di posta) ove disponibile
(l'intestazione Received normalmente include anche il vero nome del server). Questo può essere
utilizzato per facilitare il filtraggio della posta in base all'account da cui viene ricevuta.
Le informazioni sulla cartella vengono scritte solo dalla versione 6.3.4.

--ssl (Parola chiave: ssl)
Fa sì che la connessione al server di posta venga crittografata tramite SSL, negoziando
SSL direttamente dopo la connessione (modalità con wrapping SSL). Si consiglia vivamente di utilizzare
--sslcertck per convalidare i certificati presentati dal server. Si prega di vedere il
descrizione di --sslproto sotto! Maggiori informazioni sono disponibili nella LEGGIMI.SSL
file fornito con fetchmail.

Nota che anche se questa opzione viene omessa, fetchmail può comunque negoziare SSL in banda
per POP3 o IMAP, tramite la funzione STLS o STARTTLS. Puoi usare --sslproto
opzione per modificare quel comportamento.

Se non viene specificata alcuna porta, viene tentata la connessione alla porta ben nota del
Versione SSL del protocollo di base. Questa è generalmente una porta diversa dalla porta
utilizzato dal protocollo di base. Per IMAP, questa è la porta 143 per il protocollo chiaro e
porta 993 per il protocollo protetto SSL; per POP3, è la porta 110 per il testo in chiaro
e la porta 995 per la variante crittografata.

Se nel tuo sistema mancano le voci corrispondenti da /etc/services, Vedere la
opzione --service e specificare il numero di porta numerico come indicato in precedenza
paragrafo (a meno che il tuo ISP non ti abbia indirizzato a porte diverse, il che è raro
però).

--sslcert
(Parola chiave: sslcert)
Per l'autenticazione client basata su certificato. Alcuni server crittografati SSL richiedono
chiavi lato client e certificati per l'autenticazione. Nella maggior parte dei casi, questo è
opzionale. Questo specifica la posizione del certificato di chiave pubblica da
presentato al server nel momento in cui viene stabilita la sessione SSL. Non è
richiesto (ma può essere fornito) se il server non lo richiede. Potrebbe essere il
stesso file della chiave privata (chiave combinata e file del certificato) ma non lo è
consigliato. Vedi anche --sslkey sotto.

NOTA: Se utilizzi l'autenticazione client, il nome utente viene recuperato dal
CommonName del certificato e sovrascrive il nome impostato con --user.

--tasto ssl
(Parola chiave: chiave ssl)
Specifica il nome file della chiave SSL privata lato client. Alcuni SSL crittografati
i server richiedono chiavi e certificati lato client per l'autenticazione. Nella maggior parte dei casi
casi, questo è facoltativo. Questo specifica la posizione della chiave privata usata per
firmare le transazioni con il server nel momento in cui viene stabilita la sessione SSL. Esso
non è richiesto (ma può essere fornito) se il server non lo richiede. Può essere
lo stesso file della chiave pubblica (chiave combinata e file del certificato) ma non lo è
raccomandato.

Se è richiesta una password per sbloccare la chiave, verrà richiesta al momento
appena prima di stabilire la sessione sul server. Questo può causare alcuni
complicazioni in modalità demone.

Vedi anche --sslcert sopra.

--sslproto
(Parola chiave: sslproto, NOTA: modifiche semantiche dalla v6.4.0)
Questa opzione ha un duplice uso, al di fuori del comportamento storico di fetchmail. Controlla entrambi
la versione del protocollo SSL/TLS e, se --ssl non è specificato, il comportamento STARTTLS
(aggiornando il protocollo a una connessione SSL o TLS in banda). Alcune altre opzioni
può tuttavia rendere TLS obbligatorio.

Solo se questa opzione e --ssl mancano entrambe per un sondaggio, ci sarà TLS opportunistico
per POP3 e IMAP, dove fetchmail tenterà di eseguire l'aggiornamento a TLSv1 o successivo.

Di seguito sono riportati i valori riconosciuti per --sslproto. Normalmente dovresti scegliere uno dei
opzioni di negoziazione automatica, ad esempio 'auto' o una delle opzioni che terminano con un più (+)
carattere. Nota che, a seconda della versione e della configurazione della libreria OpenSSL, alcune opzioni
causare errori di runtime perché le versioni SSL o TLS richieste non sono supportate dal
particolare libreria OpenSSL installata.

'', la stringa vuota
Disabilita STARTTLS. Se --ssl viene fornito per lo stesso server, registra un errore e
fingere che 'auto' era stato usato invece.

'auto' (predefinito). Dalla versione 6.4.0. Richiedi TLS. Negozia automaticamente TLSv1 o versione successiva, disabilita
Declassamento SSLv3. (fetchmail 6.3.26 e versioni precedenti hanno negoziato tutto automaticamente
protocolli supportati dalla loro libreria OpenSSL, incluso il SSLv3 danneggiato.

'SSL23'
vedere 'auto'.

'SSL3' Richiedi esattamente SSLv3. SSLv3 è danneggiato, non supportato su tutti i sistemi, evitare
se possibile. Ciò consentirà a fetchmail di negoziare solo SSLv3 ed è il
solo modo oltre 'SSL3+' per fare in modo che fetchmail 6.4.0 o successivo permetta SSLv3.

'SSL3+'
uguale a 'auto', ma consenti anche SSLv3. Questo è l'unico modo inoltre
'SSL3' per fare in modo che fetchmail 6.4.0 o successivo permetta SSLv3.

'TLS1'Richiede TLSv1. Questo non negozia TLSv1.1 o successivo ed è sconsigliato.
Sostituisci con TLS1+ a meno che quest'ultimo non soffochi il tuo server.

'TLS1+'
Dalla versione 6.4.0. Vedi 'fBauto'.

'TLS1.1'
Dalla versione 6.4.0. Richiedi esattamente TLS v1.1.

'TLS1.1+'
Dalla versione 6.4.0. Richiedi TLS. Negozia automaticamente TLSv1.1 o versione successiva.

'TLS1.2'
Dalla versione 6.4.0. Richiedi esattamente TLS v1.2.

'TLS1.2+'
Dalla versione 6.4.0. Richiedi TLS. Negozia automaticamente TLSv1.2 o versione successiva.

Parametri non riconosciuti
sono trattati come 'auto'.

NOTA: non dovresti quasi mai aver bisogno di usare qualcosa di diverso da '' (per forzare an
connessione non crittografata) o 'auto' (per applicare TLS).

--sslcertck
(Parola chiave: sslcertck)
Fa sì che fetchmail richieda l'utilizzo di SSL/TLS e si disconnette se non è possibile
negoziare con successo SSL o TLS, o se non può verificare e convalidare con successo
il certificato e seguirlo fino a un trust anchor (o certificato radice attendibile). Il
i trust anchor sono dati come un insieme di certificati fidati locali (vedi il sslcertfile
e percorsocertificato opzioni). Se il certificato del server non può essere ottenuto o non lo è
firmato da uno dei fidati (direttamente o indirettamente), fetchmail lo farà
disconnettersi, indipendentemente dal ssimpronta digitale opzione.

Nota che le CRL (liste di revoche di certificati) sono supportate solo in OpenSSL 0.9.7
e più recente! Anche il tuo orologio di sistema dovrebbe essere ragionevolmente preciso quando lo usi
opzione.

Nota che questo comportamento facoltativo potrebbe diventare un comportamento predefinito in fetchmail futuro
versioni.

--sslcertfile
(Parola chiave: sslcertfile, dalla v6.3.17)
Imposta il file utilizzato da fetchmail per cercare i certificati locali. Il valore predefinito è vuoto.
Questo può essere dato in aggiunta a --sslcertpath di seguito, e i certificati specificati in
--sslcertfile saranno processati prima di quelli in --sslcertpath. L'opzione può essere
usato in aggiunta a --sslcertpath.

Il file è un file di testo. Contiene la concatenazione di certificati CA attendibili
in formato PEM.

Nota che l'utilizzo di questa opzione sopprimerà il caricamento della CA attendibile SSL predefinita
file certificates a meno che non imposti la variabile di ambiente
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS ad un valore non vuoto.

--sslcertpath
(Parola chiave: sslcertpath)
Imposta la directory utilizzata da fetchmail per cercare i certificati locali. L'impostazione predefinita è
la directory predefinita di OpenSSL. La directory deve essere sottoposta ad hashing nel modo OpenSSL
se lo aspetta - ogni volta che aggiungi o modifichi un certificato nella directory, devi
per utilizzare il c_rehash tool (che viene fornito con OpenSSL nella sottodirectory tools/).
Inoltre, dopo gli aggiornamenti di OpenSSL, potrebbe essere necessario eseguire c_rehash; in particolare quando
aggiornamento da 0.9.X a 1.0.0.

Questo può essere dato in aggiunta a --sslcertfile sopra, che vedi per la precedenza
regole.

Nota che l'utilizzo di questa opzione sopprimerà l'aggiunta della CA attendibile SSL predefinita
directory certificates a meno che non imposti la variabile d'ambiente
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS ad un valore non vuoto.

--sslnomecomune <comune nome>
(Parola chiave: sslnomecomune; dalla v6.3.9)
L'uso di questa opzione è sconsigliato. Prima di utilizzarlo, contattare l'amministratore di
il tuo server upstream e chiedi di utilizzare un certificato SSL appropriato. Se quello
non può essere raggiunto, questa opzione può essere utilizzata per specificare il nome (CommonName) che
fetchmail si aspetta sul certificato del server. Un server configurato correttamente sarà
impostalo sul nome host con cui viene raggiunto e per impostazione predefinita fetchmail lo farà
aspettati altrettanto. Usa questa opzione quando CommonName è impostato su un altro valore, a
evitare l'avviso "Server CommonName mismatch" e solo se il server upstream
non è possibile utilizzare certificati appropriati.

--ssl'impronta digitale
(Parola chiave: ssfingerprint)
Specificare l'impronta digitale della chiave del server (un hash MD5 della chiave) in esadecimale
notazione con due punti che separano gruppi di due cifre. Le cifre esadecimali della lettera devono essere
in maiuscolo. Questo è il formato utilizzato da fetchmail per segnalare l'impronta digitale
quando viene stabilita una connessione SSL. Quando viene specificato, fetchmail lo farà
confronta l'impronta digitale della chiave del server con quella fornita e la connessione fallirà
se non corrispondono, indipendentemente dal sslcertck collocamento. La connessione sarà anche
fallisce se fetchmail non può ottenere un certificato SSL dal server. Questo può essere
utilizzato per prevenire attacchi man-in-the-middle, ma l'impronta digitale dal server
deve essere ottenuto o verificato su un canale sicuro, e certamente non sul
stessa connessione Internet che utilizzerebbe fetchmail.

L'utilizzo di questa opzione impedirà la stampa di errori di verifica del certificato purché
--sslcertck non è impostato.

Per ottenere l'impronta digitale di un certificato archiviato nel file cert.pem, provare:

openssl x509 -in cert.pem -noout -md5 -impronta digitale

Per dettagli, vedi x509(1ssl).

Spedizione Controllate Opzioni
-S | --smthost
(Parola chiave: smtp[host])
Specificare un elenco di ricerca di host a cui inoltrare la posta (uno o più nomi host, virgola-
separato). Gli host vengono provati in ordine di elenco; il primo che sale diventa il
destinazione di inoltro per l'esecuzione corrente. Se questa opzione non è specificata,
'localhost' è usato come predefinito. Ogni nome host può avere un numero di porta seguente
il nome dell'ospite. Il numero di porta è separato dal nome host da una barra; il
la porta predefinita è "smtp". Se specifichi un nome di percorso assoluto (che inizia con una /),
verrà interpretato come il nome di un socket UNIX che accetta connessioni LMTP
(come è supportato dal demone Cyrus IMAP) Esempio:

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

Questa opzione può essere utilizzata con ODMR e renderà fetchmail un relay tra l'ODMR
server e ricevitore SMTP o LMTP.

--fetchdomains
(Parola chiave: fetchdomains)
In modalità ETRN o ODMR, questa opzione specifica l'elenco di domini che il server dovrebbe
spedire la posta per una volta che la connessione è stata invertita. L'impostazione predefinita è l'FQDN del
macchina in funzione recuperare la posta.

-D | --smtindirizzo
(Parola chiave: smtpaddress)
Specificare il dominio da aggiungere agli indirizzi nelle righe RCPT TO inviate a SMTP.
Quando non è specificato, il nome del server SMTP (come specificato da
--smtphost) viene utilizzato per SMTP/LMTP e 'localhost' viene utilizzato per socket UNIX/BSMTP.

--nome smtp
(Parola chiave: nomesmtp)
Specificare il dominio e l'utente da inserire nelle righe RCPT TO inviate a SMTP. Il
l'utente predefinito è l'utente locale corrente.

-Z | --anti-spam <nn[, nnn]...>
(Parola chiave: antispam)
Specifica l'elenco degli errori numerici SMTP che devono essere interpretati come spam-
bloccare la risposta dell'ascoltatore. Un valore di -1 disabilita questa opzione. Per il
opzione della riga di comando, i valori dell'elenco devono essere separati da virgole.

-m | --mda
(Parola chiave: mda)
Questa opzione consente recuperare la posta utilizzare un messaggio o un agente di consegna locale (MDA o LDA)
direttamente, anziché inoltrare tramite SMTP o LMTP.

Per evitare di perdere la posta, usa questa opzione solo con MDA come maildrop o MTA come
sendmail che esce con uno stato diverso da zero su disco pieno e altri errori di consegna;
lo stato diverso da zero indica a fetchmail che la consegna è fallita e impedisce il messaggio
dall'eliminazione sul server.

If recuperare la posta è in esecuzione come root, imposta il suo ID utente durante la consegna della posta
un MDA come segue: in primo luogo, l'ambiente FETCHMAILUSER, LOGNAME e USER
le variabili vengono controllate in questo ordine. Il valore della prima variabile della sua lista
che è definito (anche se è vuoto!) viene cercato nel database degli utenti di sistema. Se
nessuna delle variabili è definita, fetchmail utilizzerà l'ID utente reale che era
iniziato con. Se una delle variabili è stata definita, ma l'utente ha dichiarato che non lo è
trovato, fetchmail continua a funzionare come root, senza controllare le variabili rimanenti su
la lista. In pratica, questo significa che se esegui fetchmail come root (non
consigliato), è molto utile definire la variabile d'ambiente FETCHMAILUSER a
impostare l'utente con cui eseguire l'MDA. Alcuni MDA (come maildrop) sono progettati
essere setuid root e setuid all'id utente del destinatario, in modo da non perdere
funzionalità in questo modo anche quando si esegue fetchmail come utente non privilegiato. Controlla il
Manuale di MDA per i dettagli.

Alcuni possibili MDA sono "/usr/sbin/sendmail -i -f %F -- %T" (Nota: alcuni diversi
errore delle versioni precedenti o del fornitore di sendmail -- per un indirizzo, piuttosto che per un
indicatore per contrassegnare la fine degli argomenti dell'opzione), "/usr/bin/deliver" e
"/usr/bin/maildrop -d %T". Gli indirizzi di consegna locali verranno inseriti nell'MDA
comando ovunque metti un %T; verrà inserito l'indirizzo Da del messaggio di posta
dove metti un %F.

Do NON allegare , il %F or %T stringa in singolo citazioni! Sia per %T che per %F, fetchmail
racchiude gli indirizzi tra virgolette singole ('), dopo aver rimosso le virgolette singole che
può contenere, prima che il comando MDA venga passato alla shell.

Do NON uso an MDA invocazione che spedizioni on , il testuali of A/Cc/Ccn, piace
"sendmail -i -t" o "qmail-inject", creerà loop di posta e porterà il just
l'ira di molti direttori delle poste scese sulla tua testa. Questo è uno dei più frequenti
errori di configurazione!

Inoltre, fallo non è un prova a combinare la modalità multidrop con un MDA come maildrop che può
accetta solo un indirizzo, a meno che il tuo upstream non memorizzi una copia del messaggio per
destinatario e trasporta il destinatario della busta in un'intestazione; perderai la posta

Il noto procmail(1) il pacchetto è molto difficile da configurare correttamente, ha un
comportamento molto sgradevole "fall through to the next rule" sugli errori di consegna (anche
quelli temporanei, come lo spazio su disco se il demone di posta di un altro utente copia il
casella di posta in giro per eliminare i vecchi messaggi), quindi la tua posta finirà nel posto sbagliato
casella di posta prima o poi. La corretta configurazione di procmail è al di fuori dell'ambito di
questo documento. Usando la posta(1) di solito è molto più semplice e molti utenti trovano il
sintassi del filtro utilizzata da maildrop più facile da capire.

Infine, ti consigliamo vivamente di farlo non è un usa qmail-inject. La riga di comando
l'interfaccia non è standard senza fornire vantaggi per l'uso tipico e fetchmail
non fa alcun tentativo di adattarsi alle deviazioni di qmail-inject dallo standard. Alcuni
delle opzioni della riga di comando e dell'ambiente di qmail-inject sono in realtà pericolose e
può causare thread interrotti, messaggi duplicati non rilevati e loop di inoltro.

--lmtp (Parola chiave: lmtp)
Causa la consegna tramite LMTP (Local Mail Transfer Protocol). Un host e una porta di servizio
devono obbligatoriamente: essere esplicitamente specificato su ciascun host nell'elenco di ricerca smtphost (vedi sopra) if
questa opzione è selezionata; la porta predefinita 25 (in conformità con RFC 2033) no
essere accettato.

--bsmtp
(Parola chiave: bsmtp)
Aggiungi la posta recuperata a un file BSMTP. Questo contiene semplicemente i comandi SMTP che
verrebbe normalmente generato da fetchmail quando passa la posta a un ascoltatore SMTP
demone.

Un argomento di '-' fa sì che il batch SMTP venga scritto sull'output standard, che è
di uso limitato: questo ha senso solo per il debug, perché fetchmail è regolare
l'output è inframmezzato sullo stesso canale, quindi questo non è adatto per la posta
consegna. Questa modalità speciale potrebbe essere rimossa in una versione successiva.

Nota che la ricostruzione di fetchmail delle righe MAIL FROM e RCPT TO non lo è
corretto garantito; le avvertenze discusse sotto L'USO E L'ABUSO DI MULTIDROP
Si applicano le MAILBOX sottostanti. Questa modalità ha la precedenza su --mda e SMTP/LMTP.

--bad-intestazione {rifiuto|accettato}
(Parola chiave: intestazione errata; dalla v6.3.15)
Specifica come fetchmail dovrebbe trattare i messaggi con intestazioni errate, ad esempio intestazioni
con una cattiva sintassi. Tradizionalmente, fetchmail ha rifiutato tali messaggi, ma alcuni
i distributori hanno modificato fetchmail per accettarli. Ora puoi configurare fetchmail
comportamento per server.

Gestione Limitare Controllate Opzioni
-l | --limite
(Parola chiave: limite)
Accetta un argomento di dimensione massima dell'ottetto, dove 0 è il valore predefinito e anche lo speciale
valore che designa "nessun limite". Se diverso da zero, i messaggi più grandi di questa dimensione non lo faranno
essere recuperato e sarà lasciato sul server (nelle sessioni in primo piano, lo stato di avanzamento
i messaggi noteranno che sono "sovradimensionati"). Se il protocollo di recupero lo consente (in
in particolare, sotto IMAP o POP3 senza l'opzione fetchall) il messaggio non sarà
segnato visto.

Un --limit esplicito di 0 sovrascrive qualsiasi limite impostato nel file di controllo della corsa. Questo
l'opzione è destinata a coloro che hanno bisogno di controllare rigorosamente il tempo di recupero a causa di
tariffe telefoniche costose e variabili.

In combinazione con --limitflush, può essere utilizzato per eliminare i messaggi di grandi dimensioni in attesa
un server. In modalità demone, le notifiche oversize vengono inviate all'utente chiamante
(vedi l'opzione --warnings). Questa opzione non funziona con ETRN o ODMR.

-w | --avvertenze
(Parola chiave: avvisi)
Richiede un intervallo in secondi. Quando chiami recuperare la posta con un'opzione 'limite' in
modalità demone, controlla l'intervallo con cui gli avvisi sui messaggi sovradimensionati
vengono spediti all'utente chiamante (o all'utente specificato dall'opzione 'postmaster').
Una di queste notifiche viene sempre inviata alla fine del primo sondaggio che il
viene rilevato un messaggio di dimensioni eccessive. Successivamente, la nuova notifica viene soppressa fino al
trascorso l'intervallo di avviso (avrà luogo alla fine del primo
successivo sondaggio).

-b | --limite batch
(Parola chiave: limite di batch)
Specificare il numero massimo di messaggi che verranno spediti a un ascoltatore SMTP
prima che la connessione venga deliberatamente abbattuta e ricostruita (il valore predefinito è 0, il che significa
Senza limiti). Un --batchlimit esplicito di 0 sovrascrive qualsiasi limite impostato nella tua esecuzione
file di controllo. Mentre sendmail(8) normalmente avvia la consegna di un messaggio
subito dopo aver ricevuto il terminatore del messaggio, alcuni ascoltatori SMTP non lo sono
richiesta. Agli MTA piace smail(8) può attendere che la presa di erogazione venga spenta per
consegnare. Questo può produrre fastidiosi ritardi quando recuperare la posta sta elaborando molto grande
lotti. L'impostazione del limite batch su una dimensione diversa da zero impedirà questi ritardi.
Questa opzione non funziona con ETRN o ODMR.

-B | --fetchlimit
(Parola chiave: fetchlimit)
Limita il numero di messaggi accettati da un determinato server in un singolo sondaggio. Di
di default non c'è limite. Un --fetchlimit esplicito di 0 sovrascrive qualsiasi limite impostato
nel file di controllo della corsa. Questa opzione non funziona con ETRN o ODMR.

--fetchsizelimit
(Parola chiave: fetchsizelimit)
Limita il numero di dimensioni dei messaggi accettati da un determinato server in un singolo
transazione. Questa opzione è utile per ridurre il ritardo nel download del primo
mail quando ci sono troppe mail nella casella di posta. Per impostazione predefinita, il limite è 100.
Se impostato su 0, le dimensioni di tutti i messaggi vengono scaricate all'inizio. Questa opzione non
non funziona con ETRN o ODMR. Per POP3, l'unico valore valido diverso da zero è 1.

--fastuidl
(Parola chiave: fastuidl)
Esegui una ricerca binaria anziché lineare per il primo UID invisibile. La ricerca binaria evita
scaricando gli UID di tutte le mail. Ciò consente di risparmiare tempo (specialmente in modalità demone)
dove scaricare lo stesso insieme di UID in ogni sondaggio è uno spreco di larghezza di banda. Il
il numero 'n' indica quanto raramente dovrebbe essere eseguita una ricerca lineare. In modalità demone,
la ricerca lineare viene utilizzata una volta seguita da ricerche binarie nei sondaggi 'n-1' se 'n' è
maggiore di 1; la ricerca binaria viene sempre utilizzata se 'n' è 1; la ricerca lineare è sempre
usato se 'n' è 0. In modalità non demone, la ricerca binaria è usata se 'n' è 1; altrimenti
viene utilizzata la ricerca lineare. Il valore predefinito di 'n' è 4. Questa opzione funziona con POP3
solo.

-e | --eliminare
(Parola chiave: cancellare)
Fare in modo che le cancellazioni vengano rese definitive dopo un determinato numero di messaggi. Sotto
POP2 o POP3, fetchmail non può rendere definitive le eliminazioni senza inviare QUIT e terminare
la sessione -- con questa opzione attiva, fetchmail interromperà un lungo recupero della posta
sessione in più sottosessioni, inviando QUIT dopo ogni sottosessione. Questo è un
buona difesa contro i cali di linea sui server POP3. Sotto IMAP, recuperare la posta normalmente
emette un comando EXPUNGE dopo ogni eliminazione per forzare l'eliminazione
fatto subito. Questo è più sicuro quando la tua connessione al server è instabile e
costoso, in quanto evita di inviare nuovamente la posta duplicata dopo un hit di linea. Tuttavia, su
cassette postali di grandi dimensioni il sovraccarico della reindicizzazione dopo ogni messaggio può sbattere il server
piuttosto difficile, quindi se la tua connessione è affidabile è bene fare meno cancellazioni
frequentemente. Si noti inoltre che alcuni server impongono un ritardo di alcuni secondi dopo
ogni uscita, quindi fetchmail potrebbe non essere in grado di rientrare immediatamente dopo un'eliminazione
-- potresti vedere errori di "blocco occupato" se ciò accade. Se specifichi questa opzione su an
intero N, dice recuperare la posta per emettere eliminazioni solo su ogni ennesima eliminazione. Un
l'argomento zero sopprime completamente le eliminazioni (quindi non verrà eseguita nessuna eliminazione
fino a fine corsa). Questa opzione non funziona con ETRN o ODMR.

Autenticazione Opzioni
-u | --utente | --nome utente
(Parola chiave: utente[nome])
Specifica l'identificazione dell'utente da utilizzare quando si accede al server di posta.
L'identificazione utente appropriata dipende sia dal server che dall'utente. Il predefinito
è il tuo nome di accesso sul computer client in esecuzione recuperare la posta. Vedi UTENTE
AUTENTICAZIONE di seguito per una descrizione completa.

-I | --interfaccia
(Parola chiave: interfaccia)
Richiedere che un dispositivo di interfaccia specifico sia attivo e disponga di uno specifico locale o remoto
IPv4 (IPv6 non è ancora supportato da questa opzione) indirizzo (o intervallo) prima del polling.
Frequentemente recuperare la posta viene utilizzato su un collegamento TCP/IP punto-punto transitorio
stabilito direttamente su un server di posta tramite SLIP o PPP. Questo è relativamente sicuro
canale. Ma quando esistono altri percorsi TCP/IP al server di posta (ad esempio quando il collegamento
è connesso a un ISP alternativo), il nome utente e la password potrebbero essere vulnerabili a
snooping (specialmente quando la modalità demone esegue automaticamente il polling per la posta, spedizione a
cancellare la password in rete a intervalli prevedibili). L'opzione --interface può
essere usato per impedirlo. Quando il collegamento specificato non è attivo o non è connesso a
un indirizzo IP corrispondente, il polling verrà saltato. Il formato è:

interfaccia/iii.iii.iii.iii[/mmm.mmm.mmm.mmm]

Il campo prima della prima barra è il nome dell'interfaccia (es. sl0, ppp0 ecc.). Il
campo prima della seconda barra è l'indirizzo IP accettabile. Il campo dopo il
la seconda barra è una maschera che specifica un intervallo di indirizzi IP da accettare. se no
mask è presente 255.255.255.255 si presume (cioè una corrispondenza esatta). Questa opzione è
attualmente supportato solo sotto Linux e FreeBSD. Si prega di vedere il monitore pagina
di seguito per informazioni specifiche su FreeBSD.

Nota che questa opzione potrebbe essere rimossa da una futura versione di fetchmail.

-M | --tenere sotto controllo
(Parola chiave: monitor)
La modalità demone può causare collegamenti transitori che vengono automaticamente rimossi dopo a
periodo di inattività (es. link PPP) per rimanere attivo a tempo indeterminato. Questa opzione
identifica un'interfaccia TCP/IP del sistema da monitorare per l'attività. Dopo ogni sondaggio
intervallo, se il collegamento è attivo ma non si è verificata alcuna altra attività sul collegamento, allora
il sondaggio verrà saltato. Tuttavia, quando fetchmail viene svegliato da un segnale, il
il controllo del monitor viene saltato e il sondaggio viene eseguito incondizionatamente. Questa opzione è
attualmente supportato solo sotto Linux e FreeBSD. Per il monitore e interfaccia
opzioni per funzionare per utenti non root sotto FreeBSD, il binario fetchmail deve essere
installato SGID kmem. Questa sarebbe una falla di sicurezza, ma fetchmail funziona con il
GID effettivo impostato su quello del gruppo kmem esclusivamente quando i dati dell'interfaccia sono in corso
raccolto.

Nota che questa opzione potrebbe essere rimossa da una futura versione di fetchmail.

--auth
(Parola chiave: auth[enticare])
Questa opzione ti permette di specificare un tipo di autenticazione (vedi AUTENTICAZIONE UTENTE
sotto per i dettagli). I valori possibili sono in qualsiasi, password, kerberos_v5, kerberos
(o, per esattezza straziante, kerberos_v4), gsapi, cram-md5, otp, ntlm, MSN
(solo per POP3), esterno (solo IMAP) e SSH. Quando in qualsiasi (l'impostazione predefinita) è
specificato, fetchmail prova i primi metodi che non richiedono una password (ESTERNO,
GSSAPI, KERBEROS IV, KERBEROS 5); quindi cerca metodi che mascherano la tua password
(CRAM-MD5, NTLM, X-OTP - si noti che MSN è supportato solo per POP3, ma non
autosonda); e solo se il server non supporta nessuno di questi spedirà il tuo
password in chiaro. Altri valori possono essere usati per forzare varie autenticazioni
metodi (SSH sopprime l'autenticazione ed è quindi utile per IMAP PREAUTH).
(esterno sopprime l'autenticazione ed è quindi utile per IMAP EXTERNAL). Qualunque
valore diverso da password, cram-md5, ntlm, MSN or otp sopprime il normale di fetchmail
richiesta di una password. Specificare SSH quando si utilizza una protezione end-to-end
connessione come un tunnel ssh; specificare esterno quando usi TLS con il client
autenticazione e specifica gsapi or kerberos_v4 se stai usando un protocollo
variante che impiega GSSAPI o K4. La scelta del protocollo KPOP seleziona automaticamente
Autenticazione Kerberos. Questa opzione non funziona con ETRN. Servizio GSSAPI
i nomi sono in linea con le registrazioni RFC-2743 e IANA, vedere Sicurezza generica
Service Application Program Interface (GSSAPI)/Kerberos/Simple Authentication e
Nomi dei servizi del livello di sicurezza (SASL) ⟨http://www.iana.org/assignments/
gssapi-nome-servizio/⟩.

Miscellanea Opzioni
-f | --fetchmailrc
Specificare un nome non predefinito per il ~/.fetchmailrc eseguire il file di controllo. Il percorso
l'argomento deve essere "-" (un singolo trattino, che significa leggere la configurazione da
input standard) o un nome di file. A meno che non sia attiva anche l'opzione --version, un nome
l'argomento file deve avere autorizzazioni non più aperte di 0700 (u=rwx,g=,o=) oppure essere
/dev/nullo.

-i | --idfile
(Parola chiave: idfile)
Specificare un nome alternativo per il file .fetchids utilizzato per salvare gli UID dei messaggi. NOTA:
a partire da fetchmail 6.3.0, l'accesso in scrittura alla directory contenente il file id è
richiesto, poiché fetchmail scrive un file temporaneo e lo rinomina al posto di
real idfile solo se il file temporaneo è stato scritto con successo. Questo evita
il troncamento degli idfile quando si esaurisce lo spazio su disco.

--pidfile
(Parola chiave: pidfile; da fetchmail v6.3.4)
Sostituisci la posizione predefinita del file PID. Default: vedi "AMBIENTE" di seguito.

-n | --norewrite
(Parola chiave: nessuna riscrittura)
Normalmente, recuperare la posta modifica le intestazioni degli indirizzi RFC-822 (A, Da, Cc, Ccn e Rispondi a)
nella posta recuperata in modo che tutti gli ID di posta locali sul server vengano espansi al massimo
gli indirizzi (@ e il nome host del server di posta vengono aggiunti). Ciò abilita le risposte su
il client per essere indirizzato correttamente (altrimenti il ​​tuo mailer potrebbe pensare che
dovrebbe essere indirizzato agli utenti locali sulla macchina client!). Questa opzione disabilita
la riscrittura. (Questa opzione è fornita per pacificare le persone che sono paranoiche su
avere un MTA modificare le intestazioni della posta e voler sapere che possono impedirlo, ma lo è
generalmente non è una buona idea disattivare effettivamente la riscrittura.) Quando si utilizza ETRN o ODMR,
l'opzione di riscrittura è inefficace.

-E | --Busta
(Parola chiave: busta; solo Multidrop)
Nel file di configurazione viene utilizzata una sintassi avanzata:
busta [ ]

Questa opzione cambia l'intestazione recuperare la posta presume che porterà una copia della posta
indirizzo della busta. Normalmente questo è 'X-Envelope-To'. Altre intestazioni tipicamente trovate
per trasportare le informazioni sulla busta sono 'X-Original-To' e 'Delivered-To'. Ora, poiché
queste intestazioni non sono standardizzate, la pratica varia. Vedi la discussione di
gestione degli indirizzi multidrop di seguito. Come caso speciale, 'busta "Ricevuta"' abilita
analisi delle linee ricevute in stile sendmail. Questa è l'impostazione predefinita, ma scoraggiato
perché non è completamente affidabile.

Nota che fetchmail si aspetta che la riga Received sia in un formato specifico: deve
contenere "da host da indirizzo", dove host deve corrispondere a uno dei nomi del server di posta
che fetchmail riconosce per l'account in questione.

L'argomento opzionale count (disponibile solo nel file di configurazione) determina
quante righe di intestazione di questo tipo vengono saltate. Un conteggio di 1 significa: salta il primo,
prendi il secondo. Un conteggio di 2 significa: salta il primo e il secondo, prendi il terzo e
presto.

-Q | --qvirtuale
(Parola chiave: qvirtual; solo Multidrop)
Il prefisso della stringa assegnato a questa opzione verrà rimosso dal nome utente trovato
nell'intestazione specificata con il busta opzione (prima fare il nome multidrop
mappatura o controllo del dominio locale, se applicabile). Questa opzione è utile se
tu stai usando recuperare la posta per raccogliere la posta per un intero dominio e il tuo ISP (o
il tuo provider di reindirizzamento della posta) sta utilizzando qmail. Una delle caratteristiche di base di qmail
Europe è Spedito a: intestazione del messaggio. Ogni volta che qmail consegna un messaggio a un locale
casella di posta mette il nome utente e il nome host del destinatario della busta su questa riga.
La ragione principale di ciò è prevenire i loop di posta. Per configurare qmail in batch mail
per un sito disconnesso l'ISP-mailhost avrà normalmente messo quel sito nel suo
File di controllo "Virtualhosts" in modo che aggiunga un prefisso a tutti gli indirizzi di posta per questo
posto. Ciò risulta nella posta inviata a '[email protected]' avere un
Spedito a: riga del modulo:

Spedito a: [email protected]

L'ISP può rendere il prefisso 'mbox-userstr-' qualsiasi cosa scelgano tranne una stringa che corrisponda al
il nome host dell'utente è probabile. Usando l'opzione 'busta consegnata a:' puoi fare
fetchmail identifica in modo affidabile il destinatario della busta originale, ma devi rimuovere il
Prefisso 'mbox-userstr-' da consegnare all'utente corretto. Ecco a cosa serve questa opzione.

--configdump
Analizza il ~/.fetchmailrc file, interpretare qualsiasi opzione della riga di comando specificata e
eseguire il dump di un rapporto di configurazione sull'output standard. Il rapporto di configurazione è un dato
assegnazione di strutture nel linguaggio Python. Questa opzione è pensata per essere utilizzata con
un interattivo ~/.fetchmailrc editor come fetchmailconf, scritto in Python.

rimosso Opzioni
-T | --netsec
Rimossa prima della versione 6.3.0, la libreria inet6_apps sottostante richiesta era stata
interrotto e non è più disponibile.

UTENTE AUTENTICAZIONE E CRITTOGRAFIA

Tutte le modalità tranne ETRN richiedono l'autenticazione del client sul server. Utente normale
autenticazione in recuperare la posta è molto simile al meccanismo di autenticazione di FTP(1). Il
ID utente e password corretti dipendono dal sistema di sicurezza sottostante sul server di posta.

Se il server di posta è una macchina Unix su cui hai un normale account utente, il tuo
nome di accesso e password normali vengono utilizzati con recuperare la posta. Se usi lo stesso nome di accesso
sia sul server che sulle macchine client, non devi preoccuparti di specificare un ID utente
con la -u opzione -- il comportamento predefinito è usare il tuo nome di accesso sul computer client
come ID utente sulla macchina server. Se utilizzi un nome di accesso diverso sul server
macchina, specificare quel nome di login con il -u opzione. ad es. se il tuo nome di accesso è 'jsmith'
su una macchina chiamata 'mailgrunt', inizieresti recuperare la posta come segue:

fetchmail -u jsmith mailgrunt

Il comportamento predefinito di recuperare la posta è quello di richiedere la password del server di posta prima del
la connessione è stabilita. Questo è il modo più sicuro di usare recuperare la posta e assicura che il tuo
la password non sarà compromessa. Puoi anche specificare la tua password nel tuo
~/.fetchmailrc file. Questo è comodo quando si utilizza recuperare la posta in modalità demone o con
script.

utilizzando rete file
Se non si specifica una password e recuperare la posta non puoi estrarne uno dal tuo
~/.fetchmailrc file, cercherà a ~ / .netrc file nella tua directory home prima
richiederne uno in modo interattivo; se in quel file viene trovata una voce che corrisponde al server di posta,
verrà utilizzata la password. Fetchmail prima cerca una corrispondenza sul nome del sondaggio; se trova
nessuno, verifica la corrispondenza del nome di via. Vedi il FTP(1) pagina man per i dettagli del
sintassi di ~ / .netrc file. Per mostrare un esempio pratico, un .netrc potrebbe assomigliare a questo:

macchina hermes.example.org
accedi joe
password top secret

Puoi ripetere questo blocco con informazioni utente diverse se devi fornire più di
una password.

Questa funzione può consentire di evitare la duplicazione delle informazioni sulla password in più di una
file.

Sui server di posta che non forniscono account utente ordinari, l'ID utente e la password sono
solitamente assegnato dall'amministratore del server quando si richiede una casella di posta sul server.
Contatta l'amministratore del server se non conosci l'ID utente e la password corretti per
il tuo account di posta.

POP3 VARIANTI

Le prime versioni di POP3 (RFC1081, RFC1225) supportavano una forma grezza di indipendente
autenticazione utilizzando il .rhost file sul lato server di posta. Sotto questa variante RPOP, a
l'ID fisso per utente equivalente a una password è stato inviato in chiaro su un collegamento a un riservato
port, con il comando RPOP anziché PASS per avvisare il server che dovrebbe fare qualcosa di speciale
controllo. RPOP è supportato da recuperare la posta (puoi specificare 'protocollo RPOP' per avere il
programma invia 'RPOP' piuttosto che 'PASS') ma il suo utilizzo è fortemente sconsigliato e supporta
verrà rimosso da una futura versione di fetchmail. Questa struttura era vulnerabile allo spoofing
ed è stato ritirato in RFC1460.

RFC1460 ha introdotto l'autenticazione APOP. In questa variante di POP3, registri un APOP
password sull'host del tuo server (su alcuni server, il programma per farlo si chiama
popo(8)). Hai messo la stessa password nel tuo ~/.fetchmailrc file. Ogni volta recuperare la posta
accede, invia un hash MD5 della tua password e il tempo di saluto del server al server,
che può verificarlo controllando il suo database di autorizzazione.

Note: che pop is no più a lungo considerato resistente contro di man-in-the-middle attacchi.

INDIETRO or TOP
recuperare la posta fa alcuni sforzi per far credere al server che i messaggi non sono stati recuperati,
utilizzando il comando TOP con un numero elevato di righe quando possibile. TOP è un comando
che recupera l'intestazione completa e a recuperare la posta-quantità specificata di linee del corpo. è
opzionale e quindi non implementato da tutti i server, e alcuni sono noti per implementarlo
impropriamente. Su molti server, tuttavia, il comando RETR che recupera il messaggio completo
con intestazione e corpo, imposta il flag "visto" (ad esempio, in un'interfaccia web), mentre il
Il comando TOP non lo fa.

recuperare la posta utilizzerà sempre il comando RETR se è impostato "fetchall". recuperare la posta userà anche
il comando RETR se "keep" è impostato e "uidl" non è impostato. Finalmente, recuperare la posta userà il
Comando RETR sui server Maillennium POP3/PROXY (usato da Comcast) per evitare un TOP deliberato
errata interpretazione in questo server che causa il danneggiamento dei messaggi.

In tutti gli altri casi, recuperare la posta userà il comando TOP. Ciò implica che in "mantenere"
impostazioni, "uidl" deve essere impostato se si desidera "TOP".

Note: che questa descrizione è vera per la versione corrente di fetchmail, ma il comportamento
potrebbe cambiare nelle versioni future. In particolare, fetchmail potrebbe preferire il comando RETR
perché il comando TOP causa molto dolore su alcuni server ed è solo facoltativo.

ALTERNATIVA AUTENTICAZIONE FORME

Se la tua recuperare la posta è stato creato con il supporto Kerberos e si specifica l'autenticazione Kerberos
(o con --auth o the .fetchmailrc opzione autenticare kerberos_v4) proverà a
ottenere un ticket Kerberos dal server di posta all'inizio di ogni query. Nota: se il
pollname o tramite nome è 'hesiod', fetchmail proverà a usare Hesiod per cercare il
server email.

Se utilizzi POP3 o IMAP con autenticazione GSSAPI, recuperare la posta si aspetterà che il server
dispone della funzionalità GSSAPI conforme a RFC1731 o RFC1734 e la utilizzerà. Attualmente questo
è stato testato solo su Kerberos V, quindi ci si aspetta che tu abbia già una concessione di biglietti
biglietto. Puoi passare un nome utente diverso dal tuo nome principale utilizzando lo standard
--utente comando o dal .fetchmailrc opzione Utente.

Se il tuo demone IMAP restituisce la risposta PREAUTH nella sua riga di saluto, fetchmail lo farà
nota questo e salta il normale passaggio di autenticazione. Questo può essere utile, ad esempio se tu
avvia imapd esplicitamente usando ssh. In questo caso puoi dichiarare il valore di autenticazione
'ssh' su quella voce del sito per fermarsi .fetchmail dal chiederti una password all'avvio
su.

Se utilizzi l'autenticazione client con TLS1 e il tuo demone IMAP restituisce il AUT=ESTERNO
risposta, fetchmail lo noterà e utilizzerà la scorciatoia di autenticazione e non lo farà
inviare la passphrase. In questo caso puoi dichiarare il valore di autenticazione 'esterno'
su quel sito per fermarsi recuperare la posta dal chiederti una password all'avvio.

Se stai utilizzando POP3 e il server emette una verifica della password una tantum conforme a
RFC1938, recuperare la posta utilizzerà la tua password come passphrase per generare la richiesta
risposta. Questo evita l'invio di segreti in rete non crittografati.

L'autenticazione RPA di Compuserve è supportata. Se compili nel supporto, recuperare la posta
proverà a eseguire un'autenticazione con passphrase RPA invece di inviare la password
en clair se rileva "@compuserve.com" nel nome host.

Se stai utilizzando IMAP, l'autenticazione NTLM di Microsoft (utilizzata da Microsoft Exchange) è
supportato. Se compili nel supporto, recuperare la posta proverà a eseguire un NTLM
autenticazione (invece di inviare la password en clair) ogni volta che il server ritorna
AUTH=NTLM nella sua risposta di capacità. Specifica un valore dell'opzione utente che assomigli a
'user@domain': la parte a sinistra di @ verrà passata come nome utente e parte
a destra come dominio NTLM.

Assicurate presa di corrente Livelli (SSL) e Transport Strato Sicurezza (TLS)
trasporto. Inoltre, il recupero POP3 e IMAP può anche negoziare SSL/TLS tramite
STARTTLS (o STLS).

Nota che fetchmail attualmente utilizza la libreria OpenSSL, che è gravemente sottodocumentata,
quindi possono verificarsi errori solo perché i programmatori non sono a conoscenza dei requisiti di OpenSSL
della giornata. Ad esempio, dalla v6.3.16, fetchmail chiama OpenSSL_add_all_algorithms(),
che è necessario per supportare i certificati che utilizzano SHA256 su OpenSSL 0.9.8 -- questo
le informazioni sono profondamente nascoste nella documentazione e per nulla ovvie. Per favore non farlo
esitare a segnalare sottili errori SSL.

È possibile accedere ai servizi crittografati SSL specificando le opzioni che iniziano con --ssl, come
come --ssl, --sslproto, --sslcertck e altri. Puoi farlo anche usando il
opzioni utente corrispondenti nel file .fetchmailrc. Alcuni servizi, come POP3 e
IMAP, hanno diverse porte ben note definite per i servizi crittografati SSL. Il
le porte crittografate verranno selezionate automaticamente quando SSL è abilitato e nessuna porta esplicita è
specificato. Inoltre, la riga di comando --sslcertck o l'opzione sslcertck esegui il file di controllo
dovrebbe essere usato per forzare il controllo rigoroso del certificato - vedere sotto.

Se SSL non è configurato, fetchmail di solito tenterà opportunisticamente di utilizzare STARTTLS.
STARTTLS può essere applicato usando --sslproto auto e sconfitto usando --sslproto ''.
Le connessioni TLS utilizzano la stessa porta della versione non crittografata del protocollo e negoziano
TLS tramite comando speciale. La riga di comando --sslcertck o l'opzione del file di controllo dell'esecuzione di sslcertck
dovrebbe essere usato per forzare il controllo rigoroso del certificato - vedere sotto.

--sslcertck is consigliato: Quando ci si connette a un server crittografato SSL o TLS, il server
presenta un certificato al client per la convalida. Il certificato viene controllato per verificare
che il nome comune nel certificato corrisponda al nome del server contattato e
che le date di validità e di scadenza nel certificato indicano che è attualmente
valido. Se uno di questi controlli fallisce, viene stampato un messaggio di avviso, ma la connessione
continua. Il certificato del server non deve essere firmato da alcun Certificante specifico
Autorità e può essere un certificato "autofirmato". Se l'opzione della riga di comando --sslcertck
o sslcertck esegui l'opzione file di controllo, fetchmail verrà invece interrotto se uno di questi
i controlli falliscono, perché deve presumere che ci sia un attacco man-in-the-middle in questo
scenario, quindi fetchmail non deve esporre password in chiaro. Uso di sslcertck o
L'opzione --sslcertck è quindi consigliata.

Alcuni server crittografati SSL possono richiedere un certificato lato client. Un pubblico lato client
È possibile specificare il certificato SSL e la chiave SSL privata. Se richiesto dal server, il
certificato client viene inviato al server per la convalida. Alcuni server potrebbero richiedere una valida
certificato client e può rifiutare le connessioni se non viene fornito un certificato o se il
certificato non valido. Alcuni server potrebbero richiedere che i certificati lato client siano firmati da
un'autorità di certificazione riconosciuta. Il formato per i file chiave e i file di certificato
è quello richiesto dalle librerie SSL sottostanti (OpenSSL nel caso generale).

Una parola di attenzione sull'uso di SSL: mentre sopra menzionato l'installazione con server autofirmato
i certificati recuperati via cavo possono proteggerti da un intercettatore passivo, è
non aiuta contro un attaccante attivo. È chiaramente un miglioramento rispetto all'invio del
password in chiaro, ma dovresti essere consapevole che un attacco man-in-the-middle è banalmente
possibile (in particolare con strumenti come dsniff ⟨http://monkey.org/~dugsong/dsniff/, ).
Utilizzo di un rigoroso controllo dei certificati con un'autorità di certificazione riconosciuta dal server e
client, o forse di un tunnel SSH (vedi sotto per alcuni esempi) è preferibile se tu
preoccuparti seriamente della sicurezza della tua casella di posta e delle password.

ESMTP AUTH
recuperare la posta supporta anche l'autenticazione al server ESMTP lato client secondo
RFC 2554. È possibile specificare una coppia nome/password da utilizzare con le parole chiave 'esmtpname'
e 'esmtppassword'; il primo per impostazione predefinita è il nome utente dell'utente chiamante.

DEMONE MODE

Presentiamo , il demone modo
In modalità demone, recuperare la posta si mette in secondo piano e corre all'infinito, interrogando ciascuno
host specificato e quindi inattivo per un determinato intervallo di polling.

Partenza , il demone modo
Esistono diversi modi per far funzionare fetchmail in modalità demone. Sulla riga di comando,
--demone or -d l'opzione funziona recuperare la posta in modalità demone. Devi
specifica un argomento numerico cheèun intervallo di polling (tempo di attesa dopo aver completato a
intero ciclo di polling con l'ultimo server e prima di iniziare il successivo ciclo di polling con il
primo server) in secondi.

Esempio: semplicemente invocando

fetchmail -d 900

effettuerà quindi il polling di tutti gli host descritti nel tuo ~/.fetchmailrc file (tranne quelli
esplicitamente escluso con il verbo 'skip') un po' meno spesso di una volta ogni 15 minuti
(esattamente: 15 minuti + tempo impiegato dal sondaggio).

È anche possibile impostare un intervallo di polling nel tuo ~/.fetchmailrc file dicendo
'imposta demone' ', dove è un numero intero di secondi. Se fate
questo, fetchmail si avvierà sempre in modalità demone a meno che non lo sovrascrivi con il comando-
opzione riga --daemon 0 o -d0.

È consentito un solo processo demone per utente; in modalità demone, recuperare la posta imposta un per-
lockfile utente per garantire questo. (Puoi comunque barare e impostare FETCHMAILHOME
variabile d'ambiente per superare questa impostazione, ma in tal caso è tua responsabilità
per assicurarti di non eseguire il polling dello stesso server con due processi contemporaneamente.)

Risveglio , il sfondo demone
Normalmente, chiamare fetchmail con un demone in background invia un segnale di sveglia al
demone e si chiude senza output. Il demone in background inizia quindi il suo prossimo ciclo di polling
subito. Il segnale di sveglia, SIGUSR1, può essere inviato anche manualmente. L'azione del risveglio
cancella anche qualsiasi flag "incuneato" che indica che le connessioni si sono incuneate a causa di un errore
autenticazione o più timeout.

Terminare , il sfondo demone
L'opzione --uscire ucciderà un processo demone in esecuzione invece di riattivarlo (se c'è
nessun processo del genere, recuperare la posta ti avviserà). Se l'opzione --quit appare per ultima sul
riga di comando, recuperare la posta ucciderà il processo demone in esecuzione e poi si chiuderà. Altrimenti,
recuperare la posta prima ucciderà un processo demone in esecuzione e poi continuerà a funzionare con il
altre opzioni.

Utile Opzioni da demone modo
. -L or --file di log opzione (parola chiave: set logfile) è efficace solo
quando fetchmail è scollegato e in modalità demone. Notare che , il file di log devono obbligatoriamente: esistere prima
fetchmail viene eseguito, puoi usare il toccare(1) comando con il nome del file come unico argomento
per crearlo.
Questa opzione ti consente di reindirizzare i messaggi di stato in un file di registro specificato (segui le istruzioni
opzione con il nome del file di registro). Il file di registro è aperto per l'aggiunta, quindi i messaggi precedenti
non vengono cancellati. Ciò è utile principalmente per il debug delle configurazioni. Notare che
fetchmail non rileva se il file di registro viene ruotato, il file di registro viene aperto solo una volta quando
fetchmail si avvia. Devi riavviare fetchmail dopo aver ruotato il file di registro e prima
comprimendolo (se applicabile).

. --syslog opzione (parola chiave: set syslog) consente di reindirizzare i messaggi di stato e di errore
emesso al syslog(3) demone di sistema se disponibile. I messaggi vengono registrati con un ID di
recuperare la posta, la struttura LOG_MAILe priorità LOG_ERR, LOG_ALERT or LOG_INFO. Questo
l'opzione è destinata alla registrazione dello stato e dei messaggi di errore che indicano lo stato del
demone e i risultati durante il recupero della posta dai server. Messaggi di errore per il comando
opzioni di riga e l'analisi del .fetchmailrc i file sono ancora scritti su stderr o su
file di registro specificato. Il --nosyslog l'opzione disattiva l'uso di syslog(3), supponendo che sia
acceso nel ~/.fetchmailrc file. Questa opzione viene ignorata, in determinate situazioni,
by --file di log (che vede).

. -N or --nodetach l'opzione sopprime lo sfondo e il distacco del processo demone
dal suo terminale di controllo. Questo è utile per il debug o quando fetchmail viene eseguito come
figlio di un processo supervisore come init(8) o di Gerrit Pape eseguirlo(8). Nota che questo
fa sì che anche l'opzione logfile venga ignorata.

Si noti che durante l'esecuzione in modalità demone durante il polling di un server POP2 o IMAP2bis, errori transitori
(come errori DNS o rifiuti di consegna sendmail) possono forzare l'opzione fetchall su per
la durata del successivo ciclo di polling. Questa è una caratteristica di robustezza. Significa che se a
il messaggio viene recuperato (e quindi contrassegnato come visto dal server di posta) ma non consegnato localmente a causa
a qualche errore transitorio, verrà recuperato nuovamente durante il successivo ciclo di polling. (L'IMAP
la logica non elimina i messaggi finché non vengono consegnati, quindi questo problema non si pone.)

Se si tocca o si modifica il ~/.fetchmailrc file mentre fetchmail è in esecuzione in modalità demone,
questo verrà rilevato all'inizio del successivo ciclo di polling. Quando un cambiato
~/.fetchmailrc viene rilevato, fetchmail lo rilegge e si riavvia da zero (usando exec(2);
nessuna informazione sullo stato viene conservata nella nuova istanza). Nota che se fetchmail ha bisogno di
query per le password, di questo se si rompe il ~/.fetchmailrc sintassi del file, la nuova
l'istanza svanirà dolcemente e silenziosamente all'avvio.

AMMINISTRATIVO VERSIONI

. --direttore delle poste opzione (parola chiave: set postmaster) specifica l'ultima risorsa
nome utente a cui inoltrare la posta multidrop se nessun destinatario locale corrispondente può essere
trovato. Viene anche utilizzato come destinazione della posta non recapitabile se il 'bouncemail' global
l'opzione è disattivata e inoltre per la posta bloccata dallo spam se l'opzione globale 'bouncemail' è
off e l'opzione globale 'spambounce' è attiva. Questa opzione è predefinita per l'utente che ha invocato
recuperare la posta. Se l'utente che invoca è root, l'impostazione predefinita di questa opzione è l'utente
'postino'. L'impostazione di postmaster sulla stringa vuota provoca tale posta come descritto sopra
da scartare - questa però di solito è una cattiva idea. Vedi anche la descrizione del
Variabile di ambiente 'FETCHMAILUSER' nella sezione AMBIENTE di seguito.

. --nessun rimbalzo si comporta come l'opzione globale "set no bouncemail", che vedi.

. --invisibile opzione (parola chiave: set invisibile) cerca di rendere invisibile fetchmail.
Normalmente, fetchmail si comporta come qualsiasi altro MTA: genera un'intestazione Received
in ogni messaggio che descrive il suo posto nella catena di trasmissione, e dice al MTA che
inoltra a che la posta proviene dalla macchina su cui fetchmail stesso è in esecuzione. Se la
l'opzione invisibile è attiva, l'intestazione Received viene soppressa e fetchmail tenta di falsificarla
MTA inoltra a pensare che provenga direttamente dall'host del server di posta.

. --showdots opzione (parola chiave: set showdots) forza fetchmail a mostrare i punti di avanzamento pari
se l'output va in un file o fetchmail non è in modalità dettagliata. Fetchmail mostra il
punti per impostazione predefinita quando viene eseguito in modalità --verbose e l'output va in console. Questa opzione è
ignorato in modalità --silent.

Specificando il --tracepoll opzione, puoi chiedere a fetchmail di aggiungere informazioni al
Intestazione ricevuta nel modulo "sondaggio {label} account {user}", dove {label} è l'account
label (dal rcfile specificato, normalmente ~/.fetchmailrc) e {user} è il nome utente
che viene utilizzato per accedere al server di posta. Questa intestazione può essere utilizzata per filtrare
e-mail in cui non sono disponibili informazioni utili sull'intestazione e si desidera la posta da diversi
account ordinati in diverse caselle di posta (questo potrebbe, ad esempio, verificarsi se si dispone di un
account sullo stesso server che esegue una mailing list e sono iscritti alla lista utilizzando
quel conto). L'impostazione predefinita non è l'aggiunta di tali intestazioni. In .fetchmailrc, questo è chiamato
'tracesondaggi'.

RECUPERO FALLIMENTO MODALITA '

I protocolli recuperare la posta gli usi per parlare con i server di posta sono quasi a prova di proiettile. Nella normalità
operazione di inoltro alla porta 25, nessun messaggio viene mai cancellato (o anche contrassegnato per la cancellazione)
sull'host fino a quando il listener SMTP sul lato client non ha riconosciuto di recuperare la posta che
il messaggio è stato accettato per la consegna o rifiutato a causa di un blocco spam.

Durante l'inoltro a un MDA, tuttavia, c'è più possibilità di errore. Alcuni MDA sono
"sicuro" e restituisce in modo affidabile uno stato diverso da zero per qualsiasi errore di consegna, anche uno dovuto a
limiti temporanei delle risorse. Il la posta(1) il programma è così; così sono la maggior parte dei programmi
progettati come agenti di trasporto della posta, come sendmail(1), incluso il wrapper sendmail di
suffisso e exim(1). Questi programmi restituiscono un riconoscimento positivo affidabile e possono
essere utilizzato con l'opzione mda senza rischio di perdita di posta. Gli MDA non sicuri, tuttavia, possono restituire 0
anche in caso di mancata consegna. Se ciò accade, perderai la posta.

La modalità normale di recuperare la posta è provare a scaricare solo i "nuovi" messaggi, lasciandoli intatti
(e non cancellati) i messaggi che hai già letto direttamente sul server (o recuperato con a
precedente recuperare la posta --mantenere). Ma potresti scoprire che i messaggi che hai già letto sul
server vengono recuperati (ed eliminati) anche quando non specifichi --all. Ci sono
diversi motivi per cui ciò può accadere.

Uno potrebbe essere che stai usando POP2. Il protocollo POP2 non include alcuna rappresentazione di
Stato 'nuovo' o 'vecchio' nei messaggi, quindi recuperare la posta deve trattare tutti i messaggi come nuovi tutti i
tempo. Ma POP2 è obsoleto, quindi è improbabile.

Un potenziale problema POP3 potrebbe essere server che inseriscono messaggi nel mezzo delle cassette postali
(si dice che alcune implementazioni VMS di posta lo facciano). Il recuperare la posta codice presuppone
che i nuovi messaggi vengano aggiunti alla fine della casella di posta; quando questo non è vero può essere
trattare alcuni vecchi messaggi come nuovi e viceversa. L'utilizzo di UIDL durante l'impostazione di fastuidl 0 potrebbe
risolvere questo problema, altrimenti, prendere in considerazione il passaggio a IMAP.

Ancora un altro problema POP3 è che se non possono creare file temporanei nella casa dell'utente
directory, alcuni server POP3 restituiranno una risposta non documentata che causa fetchmail
per segnalare falsamente "Nessuna posta".

Il codice IMAP utilizza la presenza o l'assenza del flag del server \Seen per decidere se o
non un messaggio è nuovo. Questa non è la cosa giusta da fare, fetchmail dovrebbe controllare il
UIDVALIDITY e usa UID, ma non lo fa ancora. Sotto Unix, conta sul tuo IMAP
server per notare i flag di stato in stile BSD impostati dagli agenti utente di posta e impostare il flag \Seen
da loro quando appropriato. Tutti i server Unix IMAP che conosciamo lo fanno, anche se non lo è
specificato dalle RFC IMAP. Se mai inciampi su un server che non lo fa, il sintomo lo farà
sia che i messaggi che hai già letto sul tuo host sembreranno nuovi per il server. In questo
(improbabile), solo i messaggi con cui hai recuperato recuperare la posta --mantenere saranno entrambi non cancellati
e segnato vecchio.

Nelle modalità ETRN e ODMR, recuperare la posta non recupera effettivamente i messaggi; invece, chiede
il listener SMTP del server per avviare una coda scaricata dal client tramite SMTP. Pertanto è
invia solo messaggi non consegnati.

SPAM FILTRO

Molti listener SMTP consentono agli amministratori di impostare "filtri antispam" che bloccano gli indesiderati
email da domini specificati. Una riga MAIL FROM o DATA che attiva questa funzione sarà
suscitare una risposta SMTP che (purtroppo) varia a seconda dell'ascoltatore.

Versioni più recenti di sendmail restituire un codice di errore di 571.

Secondo RFC2821, la cosa corretta da restituire in questa situazione è 550 "Richiesti
azione non eseguita: casella di posta non disponibile" (la bozza aggiunge "[Eg, casella di posta non trovata, no
accesso o comando rifiutato per motivi di policy].").

Versioni precedenti di exim MTA restituisce 501 "Errore di sintassi nei parametri o negli argomenti".

. postfix MTA esegue 554 come risposta antispam.

Zmailer può rifiutare il codice con una risposta 500 (seguita da un codice di stato avanzato che
contiene maggiori informazioni).

Codici di ritorno che recuperare la posta tratta come risposte antispam e scarta il messaggio può essere
impostato con l'opzione 'antispam'. Questo è uno dei esclusivamente tre circostanze in base alle quali
fetchmail scarta mai la posta (gli altri sono gli errori 552 e 553 descritti di seguito, e
la soppressione dei messaggi multidrop con un ID messaggio già visto).

If recuperare la posta sta recuperando da un server IMAP, la risposta antispam verrà rilevata e
il messaggio rifiutato subito dopo che le intestazioni sono state recuperate, senza leggere il
corpo del messaggio. Pertanto, non pagherai per il download di corpi di messaggi di spam.

Per impostazione predefinita, l'elenco delle risposte antispam è vuoto.

Se l' spam l'opzione globale è attiva, la posta bloccata dallo spam attiva e
RFC1892/RFC1894 messaggio di rimbalzo che informa il mittente che non accettiamo posta da
esso. Vedi anche BUG.

SMTP/ESMTP ERRORE TRATTAMENTO

Oltre al blocco dello spam descritto sopra, fetchmail esegue azioni speciali, che potrebbero essere
modificato dall'opzione --softbounce — sui seguenti codici di risposta di errore SMTP/ESMTP

452 (memoria di sistema insufficiente)
Lascia il messaggio nella casella di posta del server per un successivo recupero.

552 (il messaggio supera la dimensione massima fissa del messaggio)
Elimina il messaggio dal server. Invia bounce-mail all'originatore.

553 (dominio di invio non valido)
Elimina il messaggio dal server. Non provare nemmeno a inviare bounce-mail al
originatore.

Altri errori maggiori o uguali a 500 attivano il rimbalzo della posta all'origine, a meno che
soppresso da --softbounce. Vedi anche BUG.

IL CORRERE CONTROLLO RISORSE

Il modo migliore per impostare fetchmail è scrivere a .fetchmailrc file a casa tua
directory (puoi farlo direttamente, con un editor di testo, o indirettamente tramite fetchmailconf).
Quando c'è un conflitto tra gli argomenti della riga di comando e gli argomenti in questo
file, gli argomenti della riga di comando hanno la precedenza.

Per proteggere la sicurezza delle tue password, il tuo ~/.fetchmailrc normalmente potrebbe non averne di più
di 0700 (u=rwx,g=,o=) permessi; recuperare la posta si lamenterà e uscirà altrimenti (questo
il controllo è soppresso quando --version è attivo).

Puoi leggere il .fetchmailrc file come un elenco di comandi da eseguire quando recuperare la posta is
chiamato senza argomenti.

Correre Controllate Sintassi
I commenti iniziano con un '#' e si estendono fino alla fine della riga. Altrimenti il ​​file
consiste in una serie di voci del server o dichiarazioni di opzioni globali in un formato libero,
sintassi orientata al token.

Ci sono quattro tipi di token: parole chiave grammaticali, numeri (cioè sequenze di cifre decimali),
stringhe senza virgolette e stringhe tra virgolette. Una stringa tra virgolette è delimitata da virgolette doppie e può
contengono spazi bianchi (e le cifre tra virgolette vengono trattate come una stringa). Nota che le stringhe tra virgolette
conterrà anche caratteri di avanzamento riga se attraversano due o più righe, a meno che tu non sia
usa una barra rovesciata per unire le righe (vedi sotto). Una stringa senza virgolette è qualsiasi delimitata da spazi
token che non è né numerico, né stringa tra virgolette né contiene i caratteri speciali ',', ';',
':' o '='.

Qualsiasi quantità di spazi bianchi separa i token nelle voci del server, ma viene altrimenti ignorata. Voi
può utilizzare sequenze di escape con barra rovesciata (\n per LF, \t per HT, \b per BS, \r per CR, \nnn da
decimale (dove nnn non può iniziare con 0), \0O per ottale, e \xhh per esadecimale) da incorporare
caratteri non stampabili o delimitatori di stringhe nelle stringhe. Nelle stringhe tra virgolette, una barra rovesciata
alla fine di una riga causerà la barra rovesciata stessa e l'avanzamento della riga (LF o NL, nuovo
line) da ignorare, in modo da poter avvolgere stringhe lunghe. Senza la barra rovesciata a
la fine della riga, il carattere di avanzamento della riga diventerebbe parte della stringa.

Attenzione: sebbene queste assomiglino a sequenze di escape in stile C, non sono la stessa cosa. fetchmail
supporta solo questi otto stili. C supporta più sequenze di escape che consistono in
barra rovesciata (\) e un singolo carattere, ma non supporta i codici decimali e non lo fa
richiedono lo 0 iniziale in notazione ottale. Esempio: fetchmail interpreta \233 come
\xE9 (lettera latina e minuscola con acuto), dove C interpreterebbe \233 come ottale 0233 = \x9B
(CSI, introduttore di sequenze di controllo).

Ogni voce del server è costituita da una delle parole chiave "sondaggio" o "salta", seguita da un server
nome, seguito dalle opzioni del server, seguito da un numero qualsiasi di utente (o nome utente)
descrizioni, seguite dalle opzioni utente. Nota: la causa più comune di errori di sintassi è
confondendo le opzioni utente e server o mettendo le opzioni utente prima delle descrizioni utente.

Per compatibilità con le versioni precedenti, la parola "server" è sinonimo di "sondaggio".

Puoi utilizzare le parole chiave non significative "e", "con", "ha", "desidera" e "opzioni" ovunque in un
voce per farlo assomigliare all'inglese. Vengono ignorati, ma possono rendere le voci molto più facili
da leggere a colpo d'occhio. I caratteri di punteggiatura ':', ';' e anche ',' vengono ignorati.

Sondaggio vs. Saltare
Il verbo 'poll' dice a fetchmail di interrogare questo host quando viene eseguito senza argomenti. Il
'saltare' verbo dice recuperare la posta non interrogare questo host a meno che non sia esplicitamente nominato sul
riga di comando. (Il verbo 'salta' ti permette di sperimentare con le voci di prova in modo sicuro, oppure
disabilitare facilmente le voci per gli host che sono temporaneamente inattivi.)

Parola chiave/Opzione Sintesi
Ecco le opzioni legali. I suffissi delle parole chiave racchiusi tra parentesi quadre sono facoltativi.
Quelle corrispondenti a brevi opzioni della riga di comando sono seguite da '-' e dall'appropriato
lettera di opzione. Se l'opzione è rilevante solo per una singola modalità di funzionamento, è indicata come
's' o 'm' rispettivamente per modalità singledrop o multidrop.

Ecco le opzioni legali globali:

Funzione della modalità di ottimizzazione delle parole chiave
? ?
set daemon -d Imposta un intervallo di polling in background in
secondi.
set postmaster Dai il nome dell'ultima risorsa
destinatario della posta (predefinito: utente
in esecuzione fetchmail, "postmaster" se
eseguito dall'utente root)
imposta bouncemail Inviare un messaggio di errore al mittente
(Default)
set no bouncemail Mail di errore diretta al locale
postmaster (come da
opzione globale 'postmaster' sopra).
set no spambounce Non rimbalzare la posta bloccata dallo spam
(predefinito).
imposta spambounce Rimbalza posta bloccata spam
(secondo l'utente 'antispam'
opzione) torna a destinazione come
indicato dal 'bouncemail'
opzione globale. Avvertenza: non farlo
usa questo per rimandare lo spam a
il mittente: viene inviata la maggior parte dello spam
con indirizzo del mittente falso e quindi
questa opzione fa male innocente
astanti.
imposta nessun softbounce Elimina definitivamente non recapitabile
posta. Si consiglia di utilizzare
questa opzione se la configurazione
è stato accuratamente testato.
imposta softbounce Mantieni permanentemente non recapitabile
posta come se fosse un errore temporaneo
si fosse verificato (predefinito).
set logfile -L Nome di un file a cui aggiungere l'errore e
messaggi di stato a. Soltanto
efficace in modalità demone e se
fetchmail si stacca. Se efficace,
sostituisce set syslog.
set idfile -i Nome del file per memorizzare l'UID
elenchi in.
set syslog Effettua il log degli errori
syslog(3). Può essere sovrascritto da set
file di log.

set no syslog Disattiva la registrazione degli errori
syslog(3). (predefinito)
set properties Valore stringa che viene ignorato da
fetchmail (può essere usato da
script di estensione).

Ecco le opzioni del server legale:

Funzione della modalità di ottimizzazione delle parole chiave
? ?
tramite Specifica il nome DNS del server di posta,
sovrascrivendo il nome del sondaggio
proto[col] -p Specifica il protocollo (caso
insensibile): POP2, POP3, IMAP,
APOP, KPOP
local[domains] m Specificare i domini da considerare
come locale
port Specificare la porta del servizio TCP/IP
(obsoleto, utilizzare invece 'servizio').
service -P Specifica il nome del servizio (un numero
anche il valore è consentito e
considerato un numero di porta TCP/IP).
auth[enticate] Imposta il tipo di autenticazione (predefinito
'qualunque')
timeout -t Timeout di inattività del server in
secondi (predefinito 300)
busta -E m Specifica l'intestazione dell'indirizzo della busta
Nome
nessuna busta m Disabilita ricerca busta
indirizzo
qvirtual -Q m Qmail prefisso del dominio virtuale a
rimuovi dal nome utente
alias m Specifica nomi DNS alternativi di
server email
interfaccia -specifico l'interfaccia o le interfacce IP che devono
essere pronto per il sondaggio del server da prendere
posto
monitor -M Specifica l'indirizzo IP da monitorare
attività
plugin Specifica il comando attraverso il quale
effettuare connessioni al server.
plugout Specificare il comando attraverso il quale
stabilire connessioni con gli ascoltatori.
dns m Abilita ricerca DNS per multidrop
(Default)
no dns m Disabilita la ricerca DNS per multidrop
checkalias m Fai il confronto per indirizzo IP per
multigoccia
no checkalias m Fai il confronto per nome per
multidrop (predefinito)
uidl -U Forza POP3 a usare lato client
UIDL (consigliato)
no uidl Disattiva l'uso POP3 del lato client
UIDL (predefinito)
intervallo Controlla questo sito solo ogni N sondaggi
cicli; N è un argomento numerico.
tracepolls Aggiungi le informazioni di tracciamento del sondaggio a
l'intestazione Ricevuta
principal Imposta Kerberos principal (solo
utile con IMAP e kerberos)
esmtpname Imposta il nome per RFC2554
autenticazione all'ESMTP
server.
esmtppassword Imposta la password per RFC2554
autenticazione all'ESMTP
server.

bad-header Come trattare i messaggi con un cattivo
intestazione. Può essere rifiutato (predefinito) o
accettare.

Ecco le descrizioni e le opzioni legali dell'utente:

Funzione della modalità di ottimizzazione delle parole chiave
? ?
utente[nome] -u Questa è la descrizione dell'utente e
deve venire prima dopo il server
descrizione e dopo possibile
opzioni del server e prima dell'utente
opzioni.
Imposta il nome utente remoto se da
stesso o seguito da 'là', o
il nome utente locale se seguito da
'qui'.
è Connetti utente locale e remoto
nomi
per connettere utenti locali e remoti
nomi
pass[word] Specifica la password dell'account remoto
ssl Connettiti al server tramite
protocollo di base specificato utilizzando SSL
crittografia
sslcert Specifica il file per cliente lato
certificato SSL pubblico
sslcertfile Specifica il file con una CA attendibile
certificato
sslcertpath Specifica la directory c_rehash-ed con
certificati CA attendibili.
sslkey Specifica il file per cliente lato
chiave SSL privata
sslproto Forza il protocollo ssl per la connessione
folder -r Specifica la cartella remota da interrogare
smtphost -S Specifica gli host smtp a cui inoltrare
fetchdomains m Specifica i domini per i quali mail
dovrebbe essere recuperato
smtpaddress -D Specifica il dominio da inserire
Linee RCPT TO
smtpname Specifica l'utente e il dominio da essere
inserire nelle righe RCPT TO
antispam -Z Specifica quali sono i ritorni SMTP
interpretati come blocchi della politica antispam
mda -m Specifica MDA per la consegna locale
bsmtp -o Specifica il file batch BSMTP da aggiungere
a
preconnect Comando da eseguire prima di ogni
veloce
postconnect Comando da eseguire dopo ogni
veloce
keep -k Non eliminare i messaggi visti da
server (per POP3, uidl è
consigliato)
flush -F Elimina tutti i messaggi visti prima
interrogazione (PERICOLOSO)
limitflush Elimina tutti i messaggi di grandi dimensioni
prima di interrogare
fetchall -a Recupera tutti i messaggi visti o
non è un
riscrivi Riscrivi gli indirizzi di destinazione per
risposta (predefinito)
stripcr Ritorni a capo strip dalle estremità
di linee
forcecr Forza i ritorni del carrello alle estremità di
Linee

pass8bits Forza BODY=8BITMIME su ESMTP
ascoltatore
Dropstatus Stato della striscia e X-Mozilla-Status
righe fuori dalla posta in arrivo
strisce consegnate consegnate a linee fuori da
posta in arrivo
codice mime Converti quotato-stampabile in 8-bit
nei messaggi MIME
inattivo Inattivo in attesa di nuovi messaggi
dopo ogni sondaggio (solo IMAP)
no keep -K Elimina i messaggi visti dal server
(Default)
no flush Non svuotare tutti i messaggi visti
prima di interrogare (predefinito)
nessun recupero Recupera solo i nuovi messaggi
(Default)
nessuna riscrittura Non riscrivere le intestazioni
no stripcr Non rimuovere i ritorni a capo
(Default)
no forcecr Non forzare i ritorni a capo a
EOL (predefinito)
no pass8bits Non forzare BODY=8BITMIME su ESMTP
ascoltatore (predefinito)
no dropstatus Non rilasciare le intestazioni di stato
(Default)
no dropdelivered Non rilasciare le intestazioni Delivered-To
(Default)
nessun codice mime Non convertire quotato-stampabile in
8 bit nei messaggi MIME (predefinito)
no inattivo Non inattivo in attesa di nuovo
messaggi dopo ogni sondaggio (IMAP
solo)
limit -l Imposta il limite della dimensione del messaggio
warnings -w Imposta l'intervallo di avviso della dimensione del messaggio
batchlimit -b Max # messaggi da inoltrare in
connessione singola
fetchlimit -B Max # messaggi da recuperare in singolo
collegano
fetchsizelimit Max # dimensioni dei messaggi da recuperare
singola transazione
fastuidl Usa la ricerca binaria per i primi non visti
messaggio (solo POP3)
expunge -e Esegue un expunge ogni #th
messaggio (solo IMAP e POP3)
proprietà Il valore della stringa viene ignorato da
fetchmail (può essere usato da
script di estensione)

Tutte le opzioni utente devono iniziare con una descrizione utente (opzione utente o nome utente) e seguire
tutte le descrizioni e le opzioni del server.

Nel file .fetchmailrc, l'argomento della stringa 'envelope' può essere preceduto da uno spazio bianco-
numero separato. Questo numero, se specificato, è il numero di tali intestazioni da saltare
(ovvero, un argomento di 1 seleziona la seconda intestazione del tipo dato). Questo è qualche volta
utile per ignorare le intestazioni di buste fasulle create dall'agente di consegna locale di un ISP o
inoltri interni (attraverso sistemi di ispezione della posta, ad esempio).

Parole Non Corrispondente A Opzione Switches
Le opzioni "cartella" e "smtphost" (a differenza dei loro equivalenti da riga di comando) possono richiedere un
elenco di nomi separati da spazi o virgole che li seguono.

Tutte le opzioni corrispondono agli ovvi argomenti della riga di comando, eccetto quanto segue: 'via',
'interval', 'aka', 'is', 'to', 'dns'/'no dns', 'checkalias'/'no checkalias', 'password',
'preconnect', 'postconnect', 'localdomains', 'stripcr'/'no stripcr', 'forcecr'/'no
forcecr', 'pass8bits'/'no pass8bits' 'dropstatus/no dropstatus', 'dropdelivered/no
dropdelivered', 'mimedecode/no mimedecode', 'no inattivo' e 'nessuna busta'.

L'opzione 'via' è per se vuoi avere più di una configurazione che punta al
stesso sito. Se è presente, l'argomento stringa verrà preso come il nome DNS effettivo di
l'host del server di posta da interrogare. Questo sovrascriverà l'argomento del sondaggio, che può quindi
essere semplicemente un'etichetta distinta per la configurazione (ad esempio cosa daresti al comando
riga per interrogare esplicitamente questo host).

L'opzione 'intervallo' (che accetta un argomento numerico) ti consente di interrogare meno un server
frequentemente rispetto all'intervallo di polling di base. Se dici 'intervallo N' il server questa opzione
è collegato a verrà interrogato solo ogni N intervalli di polling.

Goccia singola vs. Multigoccia Opzioni
Assicurati di leggere la sezione intitolata IL USO E ABUSO OF MULTIGOCCIA MAILBOX se tu
intende utilizzare la modalità multidrop.

Le parole chiave "is" o "to" associano i seguenti nomi (o nomi server) locali (client)
alle mappature nome-client separati da =) con il nome utente del server di posta nella voce. Se uno
is/to list ha '*' come cognome, i nomi non riconosciuti vengono semplicemente passati. Nota
che fino a quando recuperare la posta versione 6.3.4 inclusa, questi elenchi possono contenere solo parti locali
di nomi utente (fetchmail esaminerebbe solo la parte prima del segno @). recuperare la posta
le versioni 6.3.5 e successive supportano gli indirizzi completi sul lato sinistro di queste mappature,
e hanno la precedenza su qualsiasi 'localdomains', 'aka', 'via' o mappature simili.

Un singolo nome locale può essere utilizzato per supportare il reindirizzamento della tua posta quando il tuo nome utente sul
la macchina client è diversa dal tuo nome sul server di posta. Quando c'è solo un singolo
nome locale, la posta viene inoltrata a quel nome utente locale indipendentemente dal messaggio ricevuto,
Intestazioni A, Cc e Ccn. In questo caso, recuperare la posta non esegue mai ricerche DNS.

Quando è presente più di un nome locale (o mappatura dei nomi), recuperare la posta guarda la busta
intestazione, se configurata, e altrimenti nelle intestazioni Received, To, Cc e Ccn di Recuperato
mail (questa è la 'modalità multidrop'). Cerca indirizzi con parti del nome host che corrispondono
il nome del sondaggio o le opzioni 'via', 'aka' o 'localdomains', e di solito anche per
parti del nome host che DNS gli dice sono alias del server di posta. Vedi la discussione di
'dns', 'checkalias', 'localdomains' e 'aka' per i dettagli su come sono gli indirizzi corrispondenti
gestito.

If recuperare la posta non può corrispondere a nessun nome utente del server di posta o indirizzo di dominio locale, la posta lo farà
essere rimbalzato. Normalmente verrà rimbalzato al mittente, ma se il 'bouncemail' globale
l'opzione è disattivata, la posta andrà invece al postmaster locale. (vedi il 'postmaster'
opzione globale). Vedi anche BUG.

L'opzione 'dns' (normalmente attiva) controlla il modo in cui sono gli indirizzi delle cassette postali multidrop
controllato. On, abilita la logica per controllare ogni indirizzo host che non corrisponde a un 'aka' or
dichiarazione 'localdomains' cercandola con DNS. Quando un nome utente del server di posta è
riconosciuto collegato a una parte del nome host corrispondente, la sua mappatura locale viene aggiunta all'elenco di
destinatari locali.

L'opzione 'checkalias' (normalmente disattivata) estende le ricerche eseguite dalla parola chiave 'dns'
in modalità multidrop, fornendo un modo per far fronte a MTA remoti che si identificano utilizzando
il loro nome canonico, mentre vengono interrogati utilizzando un alias. Quando un tale server viene interrogato,
i controlli per estrarre l'indirizzo della busta falliscono e recuperare la posta ritorna alla consegna utilizzando il
Intestazioni To/Cc/Ccn (vedi sotto 'Indirizzi intestazione vs. busta'). Specificando questa opzione
istruisce recuperare la posta per recuperare tutti gli indirizzi IP associati sia al nome del sondaggio
e il nome utilizzato dall'MTA remoto e per eseguire un confronto degli indirizzi IP. Questo
è utile in situazioni in cui il server remoto subisce frequenti nomi canonici
modifiche, che altrimenti richiederebbero modifiche al file rc. 'checkalias' non ha
effetto se 'no dns' è specificato nel rcfile.

L'opzione "aka" è per l'uso con caselle di posta multidrop. Ti permette di pre-dichiarare una lista
di alias DNS per un server. Questo è un trucco di ottimizzazione che ti permette di scambiare spazio
per la velocità. quando recuperare la posta, durante l'elaborazione di una casella di posta multidrop, striscia attraverso il messaggio
intestazioni che cercano i nomi del server di posta, pre-dichiarando quelli comuni da cui salvarlo
dover fare ricerche DNS. Nota: i nomi che dai come argomenti a 'aka' sono abbinati come
suffissi: se specifichi (diciamo) 'aka netaxs.com', questo corrisponderà non solo a un nome host
netaxs.com, ma qualsiasi nome host che termina con '.netaxs.com'; come (diciamo) pop3.netaxs.com
e mail.netaxs.com.

L'opzione 'localdomains' ti permette di dichiarare un elenco di domini che fetchmail dovrebbe
considerare locale. Quando fetchmail sta analizzando le linee di indirizzo in modalità multidrop e a
il segmento finale di un nome host corrisponde a un dominio locale dichiarato, quell'indirizzo viene passato
fino all'ascoltatore o all'MDA inalterato (le mappature dei nomi locali sono non è un applicato).

Se stai usando 'localdomains', potresti anche dover specificare 'nessuna busta', che
disattiva recuperare la postaè il normale tentativo di dedurre un indirizzo di busta dalla riga Received
o X-Envelope-To header o qualunque intestazione sia stata precedentemente impostata da 'envelope'. Se tu
imposta 'nessuna busta' nella voce di default è possibile annullarla nelle singole voci
usando "busta" '. Come caso speciale, 'busta "Ricevuta"' ripristina il
analisi predefinita delle righe ricevute.

. password l'opzione richiede un argomento stringa, che è la password da usare con il
server di ingresso.

La parola chiave 'preconnect' consente di specificare un comando shell da eseguire appena prima
ogni volta recuperare la posta stabilisce una connessione al server di posta. Questo può essere utile se lo sei
tentare di stabilire connessioni POP sicure con l'aiuto di SSH(1). Se il comando
restituisce uno stato diverso da zero, il polling di quel server di posta verrà interrotto.

Allo stesso modo, la parola chiave 'postconnect' ti consente di specificare un comando shell da essere
eseguito subito dopo ogni interruzione di una connessione al server di posta.

L'opzione 'forcecr' controlla se le righe terminate solo da LF ricevono CRLF
terminazione prima dell'inoltro. A rigor di termini RFC821 richiede questo, ma pochi MTA
imporre il requisito it in modo che questa opzione sia normalmente disattivata (solo uno di questi MTA, qmail,èin
uso significativo al momento della scrittura).

L'opzione 'stripcr' controlla se i ritorni a capo vengono rimossi dalla posta recuperata
prima che venga inoltrato. Normalmente non è necessario impostarlo, perché il valore predefinito è
'on' (rimozione CR abilitata) quando c'è un MDA dichiarato ma 'off' (rimozione CR
disabilitato) quando l'inoltro avviene tramite SMTP. Se 'stripcr' e 'forcecr' sono entrambi attivi, 'stripcr'
sovrascriverà.

L'opzione 'pass8bits' esiste per far fronte ai programmi di posta Microsoft che schiaffeggiano stupidamente a
"Content-Transfer-Encoding: 7bit" su tutto. Con questa opzione disattivata (impostazione predefinita) e
tale intestazione presente, recuperare la posta dichiara BODY=7BIT a un listener compatibile con ESMTP; questo
causa problemi per i messaggi che utilizzano effettivamente set di caratteri ISO a 8 bit o KOI-8, il che lo farà
essere confuso facendo spogliare i bit alti di tutti i personaggi. Se 'pass8bits' è attivo,
recuperare la posta è costretto a dichiarare BODY=8BITMIME a qualsiasi listener compatibile con ESMTP. Se la
l'ascoltatore è pulito a 8 bit (come lo sono tutti i principali ora) la cosa giusta probabilmente lo sarà
risultato.

L'opzione 'dropstatus' controlla se le linee Status e X-Mozilla-Status non sono vuote
conservato nella posta recuperata (impostazione predefinita) o scartato. Conservarli consente al tuo MUA di
vedere quali messaggi (se presenti) sono stati contrassegnati come visti sul server. D'altra parte, può
confondere alcuni notificatori di nuova posta, che presumono che qualsiasi cosa con una riga di stato al suo interno abbia
stato visto. (Nota: le linee di stato vuote inserite da alcuni server POP difettosi sono
scartato incondizionatamente.)

L'opzione 'dropdelivered' controlla se le intestazioni Delivered-To verranno mantenute nel recupero
mail (impostazione predefinita) o scartato. Queste intestazioni vengono aggiunte dai server di posta di Qmail e Postfix
per evitare loop di posta ma potresti intralciarti se provi a "rispecchiare" un server di posta
all'interno dello stesso dominio. Usare con cautela.

L'opzione 'mimedecode' controlla se i messaggi MIME utilizzano la codifica stampabile tra virgolette
vengono automaticamente convertiti in dati puri a 8 bit. Se stai consegnando la posta a un ESMTP-
ascoltatore capace, pulito a 8 bit (che include tutti i principali MTA come sendmail), quindi
questo convertirà automaticamente le intestazioni e i dati dei messaggi stampabili tra virgolette in dati a 8 bit,
rendendo più facile la comprensione durante la lettura della posta. Se i tuoi programmi di posta elettronica sanno come comportarsi
con messaggi MIME, questa opzione non è necessaria. L'opzione Mimecode è disattivata da
predefinito, perché la conversione RFC2047 sulle intestazioni elimina le informazioni sul set di caratteri
e può portare a cattivi risultati se la codifica delle intestazioni è diversa dalla codifica del corpo.

L'opzione 'idle' è pensata per essere utilizzata con i server IMAP che supportano l'RFC2177 IDLE
l'estensione del comando, ma non la richiede strettamente. Se è abilitato e fetchmail
rileva che IDLE è supportato, verrà emesso un IDLE alla fine di ogni sondaggio. Questo sarà
dire al server IMAP di mantenere la connessione aperta e avvisare il client quando arriva nuova posta
a disposizione. Se IDLE non è supportato, fetchmail lo simulerà emettendo periodicamente
NOOP. Se hai bisogno di interrogare frequentemente un collegamento, IDLE può risparmiare larghezza di banda eliminando TCP/IP
si connette e sequenze di LOGIN/LOGOUT. D'altra parte, una connessione IDLE mangerà quasi
tutto il tempo di fetchmail, perché non interromperà mai la connessione e consentirà ad altri
i polling si verificano a meno che il server non scada l'IDLE. Inoltre non funziona con più
cartelle; solo la prima cartella verrà interrogata.

L'opzione "proprietà" è un meccanismo di estensione. Prende un argomento stringa, che è
ignorato da fetchmail stesso. L'argomento stringa può essere usato per memorizzare la configurazione
informazioni per gli script che lo richiedono. In particolare, l'output di '--configdump'
l'opzione renderà le proprietà associate a una voce utente prontamente disponibili per un Python
script.

Miscellanea Correre Controllate Opzioni
Le parole "qui" e "là" hanno un significato simile all'inglese. Normalmente "utente eric"
is esr' significherebbe che la posta per l'utente remoto 'eric' deve essere consegnata a 'esr', ma
puoi renderlo più chiaro dicendo "user eric there is esr here" o invertire dicendo
'utente esr qui c'è eric là'

Gli identificatori di protocollo legale da utilizzare con la parola chiave "protocollo" sono:

auto (o AUTO) (legacy, da rimuovere dalla versione futura)
pop2 (o POP2) (legacy, da rimuovere dalla versione futura)
pop3 (o POP3)
SDPS (o SDPS)
imap (o IMAP)
apop (o APOP)
kpop (o KPOP)

I tipi di autenticazione legale sono 'any', 'password', 'kerberos', 'kerberos_v4', 'kerberos_v5'
e 'gssapi', 'cram-md5', 'otp', 'msn' (solo per POP3), 'ntlm', 'ssh', 'external' (solo
IMAP). Il tipo 'password' specifica l'autenticazione tramite la normale trasmissione di una password
(la password può essere in testo semplice o soggetta a crittografia specifica del protocollo come in CRAM-
MD5); 'kerberos' racconta recuperare la posta per cercare di ottenere un biglietto Kerberos all'inizio di ciascuno
interrogare invece e inviare una stringa arbitraria come password; e 'gssapi' dice a fetchmail
per utilizzare l'autenticazione GSSAPI. Per ulteriori informazioni, vedere la descrizione della parola chiave 'auth'.

Specificando 'kpop' si imposta il protocollo POP3 sulla porta 1109 con autenticazione Kerberos V4.
Queste impostazioni predefinite possono essere sovrascritte da opzioni successive.

Ci sono alcune istruzioni di opzione globale: 'set logfile' seguito da una stringa imposta lo stesso
globale specificato da --logfile. Un'opzione della riga di comando --logfile sovrascriverà questo. Nota
che --logfile è efficace solo se fetchmail si stacca dal terminale e il
logfile esiste già prima dell'esecuzione di fetchmail e in questo caso sovrascrive --syslog.
Inoltre, 'set daemon' imposta l'intervallo di polling come fa --daemon. Questo può essere sovrascritto da a
riga di comando --daemon opzione; in particolare --daemon 0 può essere usato per forzare il primo piano
operazione. L'istruzione 'set postmaster' imposta l'indirizzo a cui inviare la posta in multidrop
default se non ci sono corrispondenze locali. Infine, 'set syslog' invia i messaggi di registro a
syslogd(8).

DEBUG RICERCA

Recupera posta crash
Ci sono vari modi in cui fetchmail può "arrestarsi in modo anomalo", ovvero interrompere improvvisamente l'operazione e
inaspettatamente. Un "crash" di solito si riferisce a una condizione di errore che il software non ha
gestire da solo. Una modalità di guasto ben nota è "errore di segmentazione" o "segnale 11" o
"SIGSEGV" o semplicemente "segfault" in breve. Questi possono essere causati dall'hardware o dal software
i problemi. I segfault indotti dal software di solito possono essere riprodotti facilmente e nello stesso modo
posizione, mentre i segfault indotti dall'hardware possono scomparire se il computer viene riavviato, oppure
spento per alcune ore e può accadere in luoghi casuali anche se si utilizza il
software allo stesso modo.

Per risolvere i segfault causati dall'hardware, trovare il componente difettoso e ripararlo o sostituirlo
esso. Le domande frequenti sul Sig11 ⟨http://www.bitwizard.nl/sig11/⟩ potrebbe aiutarti con i dettagli.

Per risolvere i segfault indotti dal software, gli sviluppatori potrebbero aver bisogno di uno "stack backtrace".

Abilitare recuperare la posta core discariche
Per impostazione predefinita, fetchmail sopprime i core dump poiché potrebbero contenere password e altro
informazione sensibile. Per il debug di arresti anomali di fetchmail, ottenere uno "stack backtrace" da
un core dump è spesso il modo più rapido per risolvere il problema e quando si pubblica il problema
su una mailing list, gli sviluppatori potrebbero chiederti un "backtrace".

1. Per ottenere backtrace utili, fetchmail deve essere installato senza essere rimosso
suoi simboli di compilazione. Sfortunatamente, la maggior parte dei pacchetti binari installati sono
spogliati e i file principali di programmi privi di simboli sono inutili. Quindi potrebbe essere necessario
ricompilare fetchmail. Su molti sistemi, puoi digitare

file `che fetchmail`

per scoprire se fetchmail è stato privato dei simboli o meno. Se il tuo non era spogliato, bene,
procedi, se è stato rimosso, devi prima ricompilare il codice sorgente. Tu non
di solito è necessario installare fetchmail per eseguirne il debug.

2. L'ambiente shell che avvia fetchmail deve abilitare i core dump. La chiave è il
"dimensione massima del core (file)" che di solito può essere configurata con uno strumento chiamato "limite" o
"limitato". Per i dettagli, vedere la documentazione della propria shell. Nella famosa shell bash,
"ulimit -Sc illimitato" consentirà il core dump.

3. Devi anche dire a fetchmail di consentire i core dump. Per fare ciò, esegui fetchmail con
, il -d0 -v opzioni. Spesso è anche più facile aggiungere --nosyslog -N come pure.

Infine, è necessario riprodurre l'arresto anomalo. Puoi semplicemente avviare fetchmail dalla directory
dove l'hai compilato digitando ./preleva posta, quindi la riga di comando completa inizierà con
./preleva posta -Nvd0 --nosyslog e magari elenca le tue altre opzioni.

Dopo l'arresto anomalo, esegui il debugger per ottenere il core dump. Il debugger sarà spesso
GNU GDB, puoi quindi digitare (regolare i percorsi secondo necessità) gdb ./preleva posta fetchmail.core e
quindi, dopo che GDB si è avviato e ha letto tutti i suoi file, digitare backtraccia pieno, salva il
output (copia e incolla andrà bene, il backtrace verrà letto da un essere umano) e quindi digita smettere a
lascia gdb. Nota: su alcuni sistemi, i file principali hanno nomi diversi, potrebbero contenere
un numero invece del nome del programma, o numero e nome, ma di solito avrà "core"
come parte del loro nome.

INTERAZIONE CON RFC 822

Quando si tenta di determinare l'indirizzo di origine di un messaggio, fetchmail esamina
intestazioni nel seguente ordine:

Return-Path:
Resent-Sender: (ignorato se non contiene @ o !)
Mittente: (ignorato se non contiene @ o !)
Rispedito-Da:
A partire da:
Rispondi a:
Apparentemente-Da:

L'indirizzo di origine viene utilizzato per la registrazione e per impostare l'indirizzo MAIL FROM quando
inoltro a SMTP. Questo ordine ha lo scopo di far fronte con grazia alla ricezione di mailing list
messaggi in modalità multidrop. L'intento è che se un indirizzo locale non esiste, il
il messaggio di rimbalzo non verrà restituito alla cieca all'autore o alla lista stessa, ma piuttosto
al gestore della lista (che è meno fastidioso).

In modalità multidrop, le intestazioni di destinazione vengono elaborate come segue: Primo, fetchmail guarda
per l'intestazione specificata dall'opzione 'busta' per determinare il locale
indirizzo del destinatario. Se la posta è indirizzata a più di un destinatario, la riga Ricevuta
non conterrà alcuna informazione relativa agli indirizzi dei destinatari.

Quindi fetchmail cerca le righe Resent-To:, Resent-Cc: e Resent-Bcc:. Se essi
esistono, dovrebbero contenere i destinatari finali e avere la precedenza sui loro
A:/Cc:/Ccn: controparti. Se le righe Resent-* non esistono, le A:, Cc:, Bcc: e
Apparentemente-To: si cercano linee. (La presenza di un Resent-To: viene interpretata per implicare che
la persona indicata dall'A: indirizzo ha già ricevuto la copia originale del
posta.)

CONFIGURAZIONE ESEMPI

Nota che sebbene ci siano dichiarazioni di password in molti degli esempi seguenti,
questo è principalmente a scopo illustrativo. Ti consigliamo di riporre le coppie account/password in
il tuo file $HOME/.netrc, dove possono essere usati non solo da fetchmail ma da FTP(1) e
altri programmi.

Il formato base è:

sondaggio NOME DEL SERVER protocollo PROTOCOLLO nome utente NOME password PASSWORD

Esempio:

poll pop.provider.net protocollo pop3 nome utente "jsmith" password "secret1"

Oppure, usando alcune abbreviazioni:

sondaggio pop.provider.net proto pop3 utente "jsmith" password "secret1"

Possono essere elencati più server:

sondaggio pop.provider.net proto pop3 utente "jsmith" pass "segreto1"
sondaggio altro.provider.net proto pop2 utente "John.Smith" pass "My^Hat"

Ecco la stessa versione con più spazi bianchi e alcune parole non significative:

sondaggio pop.provider.net proto pop3
l'utente "jsmith", con password secret1, è "jsmith" qui;
sondaggio altro.provider.net proto pop2:
l'utente "John.Smith", con password "My^Hat", è "John.Smith" qui;

Se è necessario includere spazi in una stringa di parametri o avviare quest'ultima con un numero,
racchiudere la stringa tra virgolette. Così:

sondaggio mail.provider.net con proto pop3:
l'utente "jsmith" ha la password "4u ma non puoi crak questo"
è jws qui e vuole mda "/bin/mail"

Potresti avere una descrizione iniziale del server guidata dalla parola chiave 'predefiniti' invece di
'sondaggio' seguito da un nome. Tale record viene interpretato come predefinito per tutte le query a
utilizzo. Può essere sovrascritto dalle descrizioni dei singoli server. Quindi potresti scrivere:

default proto pop3
utente "jsmith"
sondaggio pop.provider.net
passare "segreto1"
sondaggio mail.provider.net
l'utente "jjsmith" ha la password "secret2"

È possibile specificare più di un utente per server. La parola chiave "utente" porta a
descrizione utente e ogni specifica utente in una voce multiutente deve includerla.
Ecco un esempio:

sondaggio pop.provider.net proto pop3 porta 3111
l'utente "jsmith" con pass "secret1" è "smith" qui
l'utente jones con pass "secret2" è "jjones" qui tieni

Questo associa il nome utente locale 'smith' con il nome utente pop.provider.net 'jsmith' e
il nome utente locale 'jjones' con il nome utente pop.provider.net 'jones'. Posta per 'jones'
viene mantenuto sul server dopo il download.

Ecco come appare una semplice configurazione di recupero per una cassetta postale multidrop:

sondaggio pop.provider.net:
maildrop utente con pass secret1 a golux 'hurkle'='happy' snark qui

Questo dice che la casella di posta dell'account 'maildrop' sul server è una casella multidrop e
che i messaggi in esso contenuti dovrebbero essere analizzati per i nomi utente del server "golux", "hurkle" e
'critica'. Specifica inoltre che "golux" e "snark" hanno lo stesso nome sul client
come sul server, ma la posta per l'utente server 'hurkle' dovrebbe essere consegnata all'utente client
'Felice'.

Note: che recupera posta, fino alla versione 6.3.4, NON consentiva le specifiche complete utente@dominio
qui, questi non corrisponderebbero mai. Recupera posta 6.3.5 e successivi supportano user@domain
specifiche sul lato sinistro di una mappatura utente.

Ecco un esempio di un altro tipo di connessione multidrop:

sondaggio pop.provider.net localdomains loonytoons.org toons.org
busta X-Busta-To
maildrop utente con pass secret1 a * qui

Questo dice anche che la casella di posta dell'account 'maildrop' sul server è una casella multidrop.
Dice a fetchmail che qualsiasi indirizzo nei domini loonytoons.org o toons.org (incluso
indirizzi di sottodominio come '[email protected]') dovrebbe essere passato a
listener SMTP locale senza modifiche. Fai attenzione ai loop di posta se lo fai!

Ecco un esempio di configurazione utilizzando ssh e l'opzione plugin. Le query sono fatte
direttamente sullo stdin e stdout di imapd tramite ssh. Nota che in questa configurazione, IMAP
l'autenticazione può essere saltata.

sondaggio mailhost.net con proto imap:
plugin "ssh %h /usr/sbin/imapd" auth ssh;
l'utente esr è esr qui

IL USO E ABUSO OF MULTIGOCCIA MAILBOX

Usa la funzione di più destinatari locali con cautela: può mordere. Tutto multidrop
le funzioni sono inefficaci nelle modalità ETRN e ODMR.

Inoltre, tieni presente che in modalità multidrop i messaggi duplicati vengono soppressi. Un pezzo di posta è
considerato duplicato se ha lo stesso ID messaggio del messaggio immediatamente precedente
e più di un destinatario. Tali esecuzioni di messaggi possono essere generate quando copie di a
i messaggi indirizzati a più utenti vengono consegnati a una casella multidrop.

testata vs. Busta indirizzi
Il problema fondamentale è che facendo in modo che il tuo server di posta getti la posta di più persone in un
singola casella postale, potresti aver buttato via informazioni potenzialmente vitali su chi ciascuno
pezzo di posta era effettivamente indirizzato a (l'"indirizzo della busta", al contrario dell'intestazione
indirizzi nelle intestazioni RFC822 To/Cc - il Ccn non è disponibile all'estremità ricevente).
Questo "indirizzo busta" è l'indirizzo di cui hai bisogno per reindirizzare correttamente la posta.

A volte recuperare la posta può dedurre l'indirizzo della busta. Se l'MTA del server di posta è sendmail
e l'invio ha avuto un solo destinatario, l'MTA avrà scritto una clausola "by/for"
che fornisce il destinatario della busta nella sua intestazione Received. Ma questo non funziona in modo affidabile
per altri MTA, né se vi è più di un destinatario. Per impostazione predefinita, recuperare la posta cerca
indirizzi delle buste in queste righe; puoi ripristinare questo valore predefinito con -E "Ricevuto" o
"busta ricevuta".

As a better alternativa, alcuni listener SMTP e/o server di posta inseriscono un'intestazione in ciascuno
messaggio contenente una copia degli indirizzi della busta. Questa intestazione (quando esiste) è
spesso "X-Original-To", "Delivered-To" o "X-Envelope-To". L'ipotesi di Fetchmail su
questo può essere cambiato con l'opzione -E o 'envelope'. Nota che scrivere una busta
un'intestazione di questo tipo espone i nomi dei destinatari (inclusi i destinatari in copia nascosta) a
tutti i destinatari dei messaggi, quindi l'upstream deve memorizzare una copia del messaggio per
destinatario per evitare che diventi un problema di privacy.

Postfix, dalla versione 2.0, scrive un'intestazione X-Original-To: che contiene una copia del file
busta così come è stata ricevuta.

Qmail e Postfix generalmente scrivono un'intestazione 'Delivered-To' al momento della consegna del messaggio a
lo spool di posta e usarlo per evitare loop di posta. I domini virtuali di Qmail, tuttavia, avranno il prefisso
il nome utente con una stringa che normalmente corrisponde al dominio dell'utente. Per rimuovere questo prefisso
puoi usare l'opzione -Q o 'qvirtual'.

A volte, purtroppo, nessuno di questi metodi funziona. Questo è il punto in cui tu
dovresti contattare il tuo ISP e chiedere loro di fornire tale intestazione della busta, e dovresti
non utilizzare il multidrop in questa situazione. Quando falliscono tutti, fetchmail deve ricorrere a
contenuto delle intestazioni To/Cc (le intestazioni Ccn non sono disponibili - vedi sotto) per provare a determinare
destinatari del destinatario -- e questi sono inaffidabili. In particolare, software di mailing list
spesso spedisce la posta con solo l'indirizzo di trasmissione dell'elenco nell'intestazione A.

Note: che a futuro versione of recuperare la posta può rimuovere A/Cc analisi!

Quando recuperare la posta non può dedurre un indirizzo del destinatario che è locale e il destinatario previsto
l'indirizzo era qualcuno diverso dall'utente che ha invocato fetchmail, mail andrete a ottenere perduto. Questo è ciò
rende rischiosa la funzione multidrop senza informazioni adeguate sulla busta.

Un problema correlato è che quando si copia alla cieca un messaggio di posta, le informazioni Ccn sono
svolta esclusivamente come indirizzo della busta (viene rimosso dalle intestazioni dalla posta di invio
server, quindi fetchmail può vederlo solo se è presente un'intestazione X-Envelope-To). Così, cieco-
la copia a qualcuno che riceve posta tramite un collegamento multidrop di fetchmail fallirà a meno che il
l'host del server di posta scrive regolarmente X-Envelope-To o un'intestazione equivalente nei messaggi in
la tua posta.

In conclusione, mailing list e Ccn'd mail può esclusivamente lavoro if , il server sei recupero
da

(1) negozi prima copia of , il messaggio per destinatario in il tuo dominio e

(2) record , il busta generali in a la nostra speciale testata (X-Originale-To, Spedito a,
X-Busta-To).

Buone modi A Usa il Multigoccia Caselle di posta
È possibile utilizzare più nomi locali per amministrare una mailing list dal lato client di a
recuperare la posta collezione. Supponiamo che il tuo nome sia "esr" e che entrambi vogliate scegliere il vostro
posta e mantieni una mailing list chiamata (diciamo) "fetchmail-friends", e tu vuoi mantenere
l'elenco degli alias sul computer client.

Sul tuo server, puoi usare l'alias 'fetchmail-friends' in 'esr'; poi, nel tuo .fetchmailrc,
dichiarare 'a esr fetchmail-friends qui'. Quindi, quando la posta include 'fetchmail-friends' come
viene recuperato un indirizzo locale, il nome dell'elenco verrà aggiunto all'elenco dei destinatari
il tuo ascoltatore SMTP vede. Pertanto subirà un'espansione alias a livello locale. Essere sicuri di
includi 'esr' nell'espansione dell'alias locale di fetchmail-friends, o non vedrai mai la posta
inviato solo alla lista. Assicurati anche che il tuo ascoltatore abbia impostato l'opzione "anch'io"
(opzione della riga di comando -oXm di sendmail o dichiarazione OXm) in modo che il tuo nome non venga rimosso da
espansioni di alias nei messaggi che invii.

Questo trucco non è esente da problemi, tuttavia. Inizierai a vederlo quando un messaggio
arriva che è indirizzato solo a una mailing list che fai non è un hanno dichiarato come un locale
nome. Ciascuno di questi messaggi presenterà un'intestazione "X-Fetchmail-Warning" che viene generata
perché fetchmail non riesce a trovare un nome locale valido negli indirizzi dei destinatari. Tale
messaggi predefiniti (come descritto sopra) per essere inviati all'utente locale in esecuzione
recuperare la posta, ma il programma non ha modo di sapere che in realtà è la cosa giusta.

Piscina modi A Abuso Multigoccia Caselle di posta
Cassette postali multidrop e recuperare la posta servire più utenti in modalità demone non si mescolano. Il
il problema, ancora una volta, è la posta dalle mailing list, che in genere non ha un individuo
indirizzo del destinatario su di esso. Salvo che recuperare la posta può dedurre un indirizzo di busta, tale posta lo farà
vai solo all'account che esegue fetchmail (probabilmente root). Inoltre, gli utenti copiati alla cieca sono
molto probabilmente non vedrà mai la loro posta.

Se sei tentato di usare recuperare la posta per recuperare la posta per più utenti da una singola posta
drop via POP o IMAP, ripensaci (e rileggi la sezione sugli indirizzi di intestazione e busta
sopra). Sarebbe più intelligente lasciare la posta nella coda del server di posta e usarla
le modalità ETRN o ODMR di fetchmail per attivare periodicamente gli invii SMTP (ovviamente questo significa
devi interrogare più frequentemente del periodo di scadenza del server di posta). Se non puoi
organizzare questo, provare a impostare un feed UUCP.

Se assolutamente devono obbligatoriamente: usa il multidrop per questo scopo, assicurati che il tuo server di posta scriva an
intestazione dell'indirizzo della busta che fetchmail può vedere. altrimenti tu andrete a perdere la posta ed è andrete a
tornare a perseguitarti.

eccesso di velocità Up Multigoccia Controllo
Normalmente, quando vengono dichiarati più utenti recuperare la posta estrae gli indirizzi dei destinatari come
descritto sopra e controlla ogni parte host con DNS per vedere se è un alias del
server email. In tal caso, le mappature dei nomi descritte nella dichiarazione "to... here" sono eseguite
e la posta consegnata localmente.

Questo è un metodo comodo ma anche lento. Per velocizzarlo, pre-dichiarare gli alias del server di posta
con 'aka'; questi vengono controllati prima che vengano eseguite le ricerche DNS. Se sei sicuro che il tuo aka
l'elenco contiene contro tutti i Alias ​​DNS del server di posta (e tutti i nomi MX che puntano ad esso - nota
questo potrebbe cambiare in una versione futura) puoi dichiarare "no dns" per sopprimere le ricerche DNS
interamente e esclusivamente partita contro la lista aka.

SOCKS

Il supporto per calzini4/5 è un compilare tempo opzione di configurazione. Una volta compilato, fetchmail
utilizzerà sempre le librerie e la configurazione dei calzini sul tuo sistema, non ci sono
interruttori orari in fetchmail - ma puoi ancora configurare SOCKS: puoi specificare quale
Il file di configurazione SOCKS viene utilizzato nel CALZE_CONF variabile d'ambiente.

Ad esempio, se volessi ignorare del tutto il proxy SOCKS e avere fetchmail
connettersi direttamente, puoi semplicemente passare SOCKS_CONF=/dev/null nell'ambiente, ad esempio
(aggiungi le tue solite opzioni della riga di comando - se presenti - alla fine di questa riga):

env SOCKS_CONF=/dev/null fetchmail

EXIT CODICI

Per facilitare l'uso di recuperare la posta negli script di shell, viene restituito un codice di stato di uscita a
dare un'indicazione di ciò che è accaduto durante una determinata connessione.

I codici di uscita restituiti da recuperare la posta sono come segue:

0 Uno o più messaggi sono stati recuperati con successo (o, se l'opzione -c era
selezionati, sono stati trovati in attesa ma non recuperati).

1 Non c'era posta in attesa di recupero. (Potrebbe esserci stata della vecchia posta ancora sul
server ma non selezionato per il recupero.) Se non si desidera che "nessuna posta" sia un errore
condizione (ad esempio, per lavori cron), utilizzare una shell conforme a POSIX e aggiungere

|| [$? -eq 1]

alla fine della riga di comando di fetchmail, nota che questo lascia 0 intatto, mappe 1
su 0 e mappa tutti gli altri codici su 1. Vedi anche l'articolo #C8 nelle FAQ.

2 Si è verificato un errore durante il tentativo di aprire un socket per recuperare la posta. Se tu
non so cos'è una presa, non preoccuparti -- trattala come un
'errore irreversibile'. Questo errore può anche essere dovuto al fatto che un protocollo fetchmail lo vuole
da usare non è elencato in /etc/services.

3 La fase di autenticazione dell'utente non è riuscita. Questo di solito significa che un ID utente errato,
è stata specificata la password o l'ID APOP. Oppure potrebbe significare che hai provato a eseguire fetchmail
in circostanze in cui non disponeva di un ingresso standard collegato a un terminale e
non è stato possibile richiedere una password mancante.

4 È stato rilevato un errore irreversibile del protocollo.

5 C'era un errore di sintassi negli argomenti per recuperare la posta, o un pre o post-connessione
comando non riuscito.

6 Il file di controllo della corsa aveva permessi non validi.

7 Si è verificata una condizione di errore segnalata dal server. Può anche sparare se recuperare la posta
timeout durante l'attesa del server.

8 Errore di esclusione lato client. Questo significa recuperare la posta o trovato un'altra copia di
stesso già in esecuzione, o si è guastato in modo tale da non essere sicuro se un altro
la copia è in esecuzione.

9 Il passaggio di autenticazione dell'utente non è riuscito perché il server ha risposto "blocco occupato". Provare
di nuovo dopo una breve pausa! Questo errore non è implementato per tutti i protocolli, né
per tutti i server. Se non implementato per il tuo server, verrà invece restituito "3",
vedi sopra. Può essere restituito quando si parla con qpopper o altri server che possono
rispondi con "blocco occupato" o un testo simile contenente la parola "blocco".

Il 10 recuperare la posta l'esecuzione non è riuscita durante il tentativo di aprire una porta SMTP o una transazione.

11 Errore DNS irreversibile. Fetchmail ha riscontrato un errore durante l'esecuzione di una ricerca DNS su
avvio e non è stato possibile procedere.

12 Impossibile aprire il file batch BSMTP.

13 Sondaggio terminato da un limite di recupero (vedere l'opzione --fetchlimit).

14 Indicazione server occupato.

23 Errore interno. Dovresti vedere un messaggio sull'errore standard con i dettagli.

24-26, 28, 29
Questi sono codici interni e non dovrebbero apparire esternamente.

Quando recuperare la posta interroga più di un host, lo stato di ritorno è 0 se in qualsiasi query con successo
posta recuperata. In caso contrario, lo stato di errore restituito è quello dell'ultimo host interrogato.

Utilizzare popclient online utilizzando i servizi onworks.net