fetchmailconf - Online di Cloud

PROGRAM:

NAMA

fetchmail - mengambil email dari server berkemampuan POP, IMAP, ETRN, atau ODMR

RINGKASAN

ambil surat [pilihan...] [server surat...]
ambilmailconf

DESKRIPSI

ambil surat adalah utilitas pengambilan dan penerusan surat; itu mengambil email dari jarak jauh
server surat dan meneruskannya ke sistem pengiriman mesin (klien) lokal Anda. Kamu bisa
kemudian tangani email yang diambil menggunakan agen pengguna email biasa seperti anjing kampung(1) elm(1) atau
surat(1). Itu ambil surat utilitas dapat dijalankan dalam mode daemon untuk berulang kali melakukan polling satu atau lebih
sistem pada interval tertentu.

The ambil surat program dapat mengumpulkan email dari server yang mendukung salah satu
protokol pengambilan: POP2 (warisan, akan dihapus dari rilis mendatang), POP3, IMAP2bis,
IMAP4, dan IMAP4rev1. Itu juga dapat menggunakan ekstensi ESMTP ETRN dan ODMR. (RFC
menjelaskan semua protokol ini tercantum di akhir halaman manual ini.)

Sementara ambil surat terutama dimaksudkan untuk digunakan melalui tautan TCP/IP sesuai permintaan (seperti SLIP
atau koneksi PPP), mungkin juga berguna sebagai agen transfer pesan untuk situs yang
menolak untuk alasan keamanan untuk mengizinkan (dimulai pengirim) transaksi SMTP dengan sendmail.

DUKUNG, PEMECAHAN MASALAH
Untuk pemecahan masalah, penelusuran, dan debugging, Anda perlu meningkatkan verbositas fetchmail untuk
benar-benar melihat apa yang terjadi. Untuk melakukan itu, silakan jalankan kedua of itu dua berikut perintah,
menambahkan semua of itu Pilihan kamu akan biasanya digunakan.

env LC_ALL=C ambil email -V -v --nodetach --nosyslog

(Baris perintah ini mencetak dalam bahasa Inggris bagaimana fetchmail memahami konfigurasi Anda.)

env LC_ALL=C ambil email -vvv --nodetach --nosyslog

(Baris perintah ini sebenarnya menjalankan fetchmail dengan keluaran bahasa Inggris verbose.)

Lihat juga item #G3 di FAQ fetchmailhttp://fetchmail.berlios.de/fetchmail-FAQ.html#G3⟩

Anda dapat menghilangkan bagian LC_ALL=C di atas jika Anda ingin output dalam bahasa lokal (jika
didukung). Namun jika Anda memposting ke milis, silakan tinggalkan
pengelola belum tentu mengerti bahasa Anda, harap gunakan bahasa Inggris.

KONSEP
If ambil surat digunakan dengan server POP atau IMAP (tetapi tidak dengan ETRN atau ODMR), ia memiliki dua
mode operasi dasar untuk setiap akun pengguna dari mana ia mengambil email:
satu tetes- Dan banyak titik-mode.

Dalam mode singledrop,
ambil surat mengasumsikan bahwa semua pesan di akun pengguna (kotak surat) dimaksudkan
untuk satu penerima. Identitas penerima akan default ke
pengguna lokal saat ini mengeksekusi ambil surat, atau perlu ditentukan secara eksplisit
dalam file konfigurasi.

ambil surat menggunakan mode singledrop ketika konfigurasi fetchmailrc berisi paling banyak
spesifikasi pengguna lokal tunggal untuk akun server tertentu.

Dalam mode multidrop,
ambil surat mengasumsikan bahwa akun server surat benar-benar berisi surat yang ditujukan untuk
sejumlah penerima yang berbeda. Karena itu, ambil surat harus berusaha menyimpulkan
"penerima amplop" yang tepat dari header email setiap pesan. Di dalam
modus operasi, ambil surat hampir menyerupai agen transfer surat (MTA).

Perhatikan bahwa baik protokol POP maupun IMAP tidak dimaksudkan untuk digunakan dengan cara ini,
dan karenanya informasi amplop seringkali tidak tersedia secara langsung. ISP harus
menyimpan informasi amplop di beberapa header pesan dan. ISP juga harus menyimpan
satu salinan pesan per penerima. Jika salah satu kondisi tidak
terpenuhi, proses ini tidak dapat diandalkan, karena ambil surat kemudian harus menggunakan
menebak penerima amplop yang sebenarnya dari sebuah pesan. Ini biasanya gagal untuk
pesan milis dan email Bcc:d, atau email untuk beberapa penerima di
domain.

ambil surat menggunakan mode multidrop ketika lebih dari satu pengguna lokal dan/atau wildcard adalah
ditentukan untuk akun server tertentu dalam file konfigurasi.

Dalam mode ETRN dan ODMR,
pertimbangan ini tidak berlaku, karena protokol ini didasarkan pada SMTP, yang
memberikan informasi penerima amplop eksplisit. Protokol ini selalu mendukung
beberapa penerima.

Saat setiap pesan diambil, ambil surat biasanya mengirimkannya melalui SMTP ke port 25 di
mesin yang sedang berjalan (localhost), seolah-olah sedang dilewatkan di atas normal
tautan TCP/IP. ambil surat menyediakan server SMTP dengan penerima amplop yang berasal dari
cara yang dijelaskan sebelumnya. Surat kemudian akan dikirimkan sesuai dengan MTA Anda
aturan (Agen Pengiriman Surat biasanya kirim email(8) exim(8), atau postfix(8)). Memanggil
MDA (Mail Delivery Agent) sistem Anda adalah tugas MTA Anda. Semua kontrol pengiriman
mekanisme (seperti .maju file) biasanya tersedia melalui sistem Anda MTA dan lokal
agen pengiriman karena itu akan diterapkan seperti biasa.

Jika konfigurasi fetchmail Anda menetapkan MDA lokal (lihat opsi --mda), itu akan digunakan
langsung daripada berbicara SMTP ke port 25.

Jika programnya ambilmailconf tersedia, ini akan membantu Anda dalam mengatur dan mengedit a
konfigurasi fetchmailrc. Ini berjalan di bawah sistem jendela X dan mengharuskan
bahasa Python dan toolkit Tk (dengan binding Python) ada di sistem Anda. Jika
Anda pertama kali menyiapkan fetchmail untuk mode pengguna tunggal, disarankan agar Anda menggunakan
Modus pemula. Mode ahli memberikan kontrol penuh atas konfigurasi fetchmail, termasuk
fitur multidrop. Dalam kedua kasus tersebut, tombol 'Autoprobe' akan memberi tahu Anda paling banyak
protokol yang mampu yang didukung oleh server surat tertentu, dan memperingatkan Anda tentang potensi masalah dengan itu
Server.

UMUM OPERASI

Perilaku ambil surat dikendalikan oleh opsi baris perintah dan menjalankan file kontrol,
~/.fetchmailrc, sintaks yang kami jelaskan di bagian selanjutnya (file ini adalah apa yang
ambilmailconf pengeditan program). Opsi baris perintah menimpa ~/.fetchmailrc deklarasi.

Setiap nama server yang Anda tentukan mengikuti opsi pada baris perintah akan menjadi
bertanya. Jika Anda tidak menentukan server apa pun di baris perintah, setiap entri 'jajak pendapat' di
~/.fetchmailrc file akan ditanyakan.

Untuk memudahkan penggunaan ambil surat dalam skrip dan saluran pipa, ia mengembalikan yang sesuai
kode keluar setelah penghentian -- lihat KODE KELUAR di bawah.

Opsi berikut mengubah perilaku ambil surat. Jarang diperlukan untuk menentukan
salah satu dari ini setelah Anda bekerja .fetchmailrc berkas diatur.

Hampir semua opsi memiliki kata kunci yang sesuai yang dapat digunakan untuk mendeklarasikannya dalam a
.fetchmailrc file.

Beberapa opsi khusus tidak tercakup di sini, tetapi didokumentasikan di bagian tentang
AUTHENTICATION dan DAEMON MODE yang mengikuti.

Umum Opsi
-V | --Versi: kapan
Menampilkan informasi versi untuk salinan ambil surat. Tidak ada pengambilan surat
dilakukan. Sebagai gantinya, untuk setiap server yang ditentukan, semua informasi opsi yang
akan dihitung jika ambil surat terhubung ke server itu ditampilkan. Setiap
yang tidak dapat dicetak dalam kata sandi atau nama string lainnya ditampilkan sebagai garis miring terbalik seperti C
urutan pelarian. Opsi ini berguna untuk memverifikasi bahwa opsi Anda telah disetel
seperti yang Anda inginkan.

-c | --memeriksa
Kembalikan kode status untuk menunjukkan apakah ada email yang menunggu, tanpa benar-benar
mengambil atau menghapus email (lihat KODE KELUAR di bawah). Opsi ini mematikan daemon
mode (di mana itu tidak akan berguna). Itu tidak cocok dengan kueri ke banyak
situs, dan tidak bekerja dengan ETRN atau ODMR. Ini akan mengembalikan positif palsu jika Anda
biarkan email terbaca tetapi tidak terhapus di kotak surat server Anda dan protokol pengambilan Anda tidak bisa
kirim pesan yang disimpan dari yang baru. Ini berarti akan bekerja dengan IMAP, tidak bekerja dengan
POP2, dan terkadang dapat terkelupas di bawah POP3.

-s | --diam
Mode diam. Menekan semua pesan progres/status yang biasanya digemakan ke
keluaran standar selama pengambilan (tetapi tidak menekan pesan kesalahan yang sebenarnya). NS
--verbose opsi menimpa ini.

-v | --bertele-tele
Modus verbose. Semua pesan kontrol diteruskan antara ambil surat dan server surat adalah
bergema ke stdout. Mengganti --silent. Menggandakan opsi ini (-v -v) menyebabkan tambahan
informasi diagnostik yang akan dicetak.

--nosoftbounce
(sejak v6.3.10, Kata Kunci: tidak mengatur softbounce, sejak v6.3.10)
Mode pantulan keras. Semua kesalahan pengiriman permanen menyebabkan pesan dihapus dari
server upstream, lihat "tidak ada softbounce" di bawah.

--pantulan lembut
(sejak v6.3.10, Kata kunci: set softbounce, sejak v6.3.10)
Mode pantulan lembut. Semua kesalahan pengiriman permanen menyebabkan pesan tertinggal di
server upstream jika protokol mendukung itu. Kredensial mikro Option is on by kegagalan untuk
pertandingan bersejarah ambil surat dokumentasi, dan akan diubah ke mode bouncing keras di
rilis fetchmail berikutnya.

Pembuangan Opsi
-a | --semua | (sejak v6.3.3) --ambil
(Kata kunci: fetchall, sejak v3.0)
Ambil pesan lama (terlihat) dan baru dari server surat. Standarnya adalah untuk
ambil hanya pesan yang belum ditandai oleh server sebagai terlihat. Di bawah POP3, opsi ini juga
memaksa penggunaan RETR daripada TOP. Perhatikan bahwa pengambilan POP2 berperilaku seolah-olah
--semua selalu aktif (lihat MODE KEGAGALAN RETRIEVAL di bawah) dan opsi ini tidak
bekerja dengan ETRN atau ODMR. Sedangkan baris perintah -a dan --all dan fetchall rcfile
opsi telah didukung untuk waktu yang lama, opsi baris perintah --fetchall adalah
ditambahkan di v6.3.3.

-k | --menyimpan
(Kata kunci: simpan)
Simpan pesan yang diambil di server surat jauh. Biasanya, pesan dihapus
dari folder di server surat setelah diambil. Menentukan
menjaga opsi menyebabkan pesan yang diambil tetap berada di folder Anda di server surat.
Opsi ini tidak bekerja dengan ETRN atau ODMR. Jika digunakan dengan POP3, disarankan
untuk juga menentukan opsi --uidl atau kata kunci uidl.

-K | --tidak menjaga
(Kata kunci: nokeep)
Hapus pesan yang diambil dari server surat jauh. Opsi ini memaksa diambil
surat yang akan dihapus. Mungkin berguna jika Anda telah menentukan default dari menjaga in
Tujuan .fetchmailrc. Opsi ini dipaksakan dengan ETRN dan ODMR.

-F | --menyiram
(Kata kunci: flush)
POP3/IMAP saja. Ini adalah opsi yang berbahaya dan dapat menyebabkan kehilangan email saat digunakan
tidak tepat. Itu menghapus pesan lama (terlihat) dari server surat sebelum mengambil
pesan baru. Peringatan: Ini dapat menyebabkan kehilangan email jika Anda memeriksa email Anda dengan orang lain
klien daripada fetchmail, dan menyebabkan fetchmail menghapus pesan yang belum pernah
diambil sebelumnya. Itu juga dapat menyebabkan kehilangan email jika server email menandai pesan
terlihat setelah pengambilan (server IMAP2). Anda mungkin tidak boleh menggunakan opsi ini di
file konfigurasi Anda. Jika Anda menggunakannya dengan POP3, Anda harus menggunakan opsi 'uidl'.
Yang mungkin Anda inginkan adalah pengaturan default: jika Anda tidak menentukan '-k', maka
fetchmail akan otomatis menghapus pesan setelah pengiriman berhasil.

--batasflush
Hanya POP3/IMAP, sejak versi 6.3.0. Hapus pesan berukuran besar dari server surat
sebelum mengambil pesan baru. Batas ukuran harus ditentukan secara terpisah dengan
opsi --limit. Opsi ini tidak bekerja dengan ETRN atau ODMR.

Protokol dan Pertanyaan Opsi
-p | --proto | --protokol
(Kata kunci: proto[kol])
Tentukan protokol yang akan digunakan saat berkomunikasi dengan server surat jauh. Jika tidak
protokol ditentukan, standarnya adalah OTOMATIS. prototipe mungkin salah satu dari berikut ini:

AUTO Mencoba IMAP, POP3, dan POP2 (melewati salah satu dari ini yang belum didukung
telah dikompilasi).

POP2 Post Office Protocol 2 (warisan, akan dihapus dari rilis mendatang)

Protokol Kantor Pos POP3 3

APOP Gunakan POP3 dengan otentikasi tantangan MD5 kuno. Dianggap tidak
tahan terhadap serangan man-in-the-middle.

RPOP Gunakan POP3 dengan otentikasi RPOP.

KPOP Gunakan POP3 dengan otentikasi Kerberos V4 pada port 1109.

SDPS Gunakan POP3 dengan ekstensi SDPS Demon Internet.

IMAP IMAP2bis, IMAP4, atau IMAP4rev1 (ambil surat secara otomatis mendeteksi
kemampuan).

ETRN Gunakan opsi ESMTP ETRN.

ODMR Gunakan profil ESMTP Relai Surat Sesuai Permintaan.

Semua alternatif ini pada dasarnya bekerja dengan cara yang sama (berkomunikasi dengan server standar
daemon untuk mengambil email yang sudah dikirim ke kotak surat di server) kecuali ETRN dan ODMR.
Mode ETRN memungkinkan Anda untuk meminta server ESMTP yang sesuai (seperti sendmail BSD saat rilis
8.8.0 atau lebih tinggi) untuk segera membuka koneksi pengirim-SMTP ke mesin klien Anda dan
mulai meneruskan item apa pun yang ditujukan ke mesin klien Anda di antrean server
surat yang tidak terkirim. Mode ODMR memerlukan server berkemampuan ODMR dan bekerja mirip dengan
ETRN, kecuali bahwa itu tidak memerlukan mesin klien untuk memiliki DNS statis.

-U | --uidl
(Kata kunci: uidl)
Paksa penggunaan UIDL (hanya efektif dengan POP3). Paksa pelacakan 'kebaruan' sisi klien
pesan (UIDL singkatan dari "daftar ID unik" dan dijelaskan dalam RFC1939). Menggunakan
dengan 'keep' untuk menggunakan kotak surat sebagai berita bayi untuk sekelompok pengguna. Faktanya
bahwa pesan yang terlihat dilewati akan dicatat, kecuali jika kesalahan pencatatan dilakukan melalui
syslog saat berjalan dalam mode daemon. Perhatikan bahwa fetchmail dapat diaktifkan secara otomatis
opsi ini tergantung pada kemampuan server upstream. Perhatikan juga bahwa opsi ini
dapat dihapus dan dipaksa diaktifkan di versi fetchmail yang akan datang. Lihat juga:
--file id.

--menganggur (sejak 6.3.3)
(Kata kunci: menganggur, sejak sebelum 6.0.0)
Aktifkan penggunaan IDLE (hanya efektif dengan IMAP). Perhatikan bahwa ini hanya berfungsi dengan satu
folder pada waktu tertentu. Sementara kata kunci rcfile idle telah didukung untuk a
lama, opsi baris perintah --idle ditambahkan di versi 6.3.3. penggunaan IDLE
artinya fetchmail memberi tahu server IMAP untuk mengirim pemberitahuan pesan baru, jadi mereka
dapat diambil lebih cepat daripada yang mungkin dilakukan dengan jajak pendapat biasa.

-P | --melayani
(Kata kunci: layanan) Sejak versi 6.3.0.
Opsi layanan memungkinkan Anda menentukan nama layanan yang akan disambungkan. Kamu bisa
tentukan nomor port desimal di sini, jika basis data layanan Anda tidak memiliki yang diperlukan
penugasan service-port. Lihat item FAQ R12 dan dokumentasi --ssl untuk
rincian. Ini menggantikan opsi --port yang lebih lama.

--Pelabuhan
(Kata kunci: pelabuhan)
Versi usang --service yang tidak menggunakan nama layanan. Catatan: pilihan ini
dapat dihapus dari versi mendatang.

--Kepala Sekolah
(Kata kunci: kepala sekolah)
Opsi utama memungkinkan Anda untuk menentukan prinsip layanan untuk mutual
autentikasi. Ini berlaku untuk POP3 atau IMAP dengan otentikasi Kerberos 4
hanya. Ini tidak berlaku untuk Kerberos 5 atau GSSAPI. Opsi ini dapat dihapus dalam
versi fetchmail mendatang.

-t | --waktu habis
(Kata kunci: batas waktu)
Opsi batas waktu memungkinkan Anda untuk mengatur batas waktu server-nonrespons dalam hitungan detik. Jika sebuah
mailserver tidak mengirim pesan ucapan atau menanggapi perintah untuk yang diberikan
jumlah detik, ambil surat akan memutuskan koneksi ke sana. Tanpa seperti itu
batas waktu ambil surat mungkin hang sampai koneksi TCP habis, mencoba mengambil
mail dari host down, yang mungkin sangat panjang. Ini akan sangat mengganggu
untuk ambil surat berjalan di latar belakang. Ada batas waktu default yang
fetchmail -V akan melaporkan. Jika koneksi yang diberikan menerima terlalu banyak batas waktu dalam
berturut-turut, fetchmail akan menganggapnya terjepit dan berhenti mencoba lagi. Pengguna yang menelepon
akan diberitahukan melalui email jika hal ini terjadi.

Dimulai dengan fetchmail 6.3.10, klien SMTP menggunakan minimum yang disarankan
batas waktu dari RFC-5321 sambil menunggu server SMTP/LMTP yang diajak bicara.
Anda dapat meningkatkan batas waktu lebih banyak lagi, tetapi Anda tidak dapat mempersingkatnya. Ini untuk menghindari
situasi yang menyakitkan di mana fetchmail telah dikonfigurasi dengan batas waktu yang singkat (a
menit atau kurang), mengirimkan pesan panjang (banyak MBytes) ke MTA lokal, yang kemudian
membutuhkan waktu lebih lama dari batas waktu untuk merespons "OK", yang pada akhirnya akan terjadi; itu akan
berarti surat terkirim dengan benar, tetapi fetchmail tidak dapat melihatnya dan karenanya akan
ambil kembali pesan besar ini berulang-ulang.

--plugin
(Kata kunci: plugin)
Opsi plugin memungkinkan Anda menggunakan program eksternal untuk membuat TCP
koneksi. Ini berguna jika Anda ingin menggunakan ssh, atau membutuhkan sesuatu yang khusus
pengaturan firewall. Program akan dicari di $PATH dan secara opsional dapat menjadi
meneruskan nama host dan port sebagai argumen masing-masing menggunakan "%h" dan "%p" (catatan
bahwa logika interpolasi agak primitif, dan token ini harus dibatasi
dengan spasi putih atau awal string atau akhir string). Fetchmail akan menulis ke
stdin plugin dan baca dari stdout plugin.

--cabut
(Kata kunci: plug out)
Identik dengan opsi plugin di atas, tetapi yang ini digunakan untuk SMTP
koneksi.

-r | --map
(Kata kunci: folder[s])
Menyebabkan folder surat non-default tertentu di server surat (atau dipisahkan koma
daftar folder) yang akan diambil. Sintaks dari nama folder adalah server-
bergantung. Opsi ini tidak tersedia di bawah POP3, ETRN, atau ODMR.

--tracepoll
(Kata kunci: tracepoll)
Beri tahu fetchmail untuk melakukan polling informasi jejak dalam bentuk 'akun polling %s' dan
'folder %s' ke baris Received yang dihasilkannya, di mana bagian %s digantikan oleh
nama jarak jauh pengguna, label polling, dan folder (kotak surat) jika tersedia
(header Received juga biasanya menyertakan nama asli server). Ini bisa jadi
digunakan untuk memfasilitasi pemfilteran surat berdasarkan akun yang menerimanya.
Informasi folder hanya ditulis sejak versi 6.3.4.

--ssl (Kata kunci: ssl)
Menyebabkan koneksi ke server email dienkripsi melalui SSL, dengan bernegosiasi
SSL langsung setelah terhubung (mode terbungkus SSL). Sangat disarankan untuk digunakan
--sslcertck untuk memvalidasi sertifikat yang disajikan oleh server. Silakan lihat
deskripsi --sslproto di bawah ini! Informasi lebih lanjut tersedia di README.SSL
file yang dikirimkan dengan fetchmail.

Perhatikan bahwa meskipun opsi ini dihilangkan, fetchmail masih dapat menegosiasikan SSL dalam-band
untuk POP3 atau IMAP, melalui fitur STLS atau STARTTLS. Anda dapat menggunakan --sslproto
pilihan untuk mengubah perilaku itu.

Jika tidak ada port yang ditentukan, koneksi dicoba ke port terkenal dari
Versi SSL dari protokol dasar. Ini umumnya merupakan port yang berbeda dari port
digunakan oleh protokol dasar. Untuk IMAP, ini adalah port 143 untuk protokol yang jelas dan
port 993 untuk protokol aman SSL; untuk POP3, ini adalah port 110 untuk teks yang jelas
dan port 995 untuk varian terenkripsi.

Jika sistem Anda tidak memiliki entri yang sesuai dari / etc / services, lihat
--service opsi dan tentukan nomor port numerik seperti yang diberikan sebelumnya
paragraf (kecuali ISP Anda telah mengarahkan Anda ke port yang berbeda, yang tidak umum
Namun).

--sslcert
(Kata kunci: sslcert)
Untuk otentikasi klien berbasis sertifikat. Beberapa server terenkripsi SSL memerlukan
kunci sisi klien dan sertifikat untuk otentikasi. Dalam kebanyakan kasus, ini adalah
opsional. Ini menentukan lokasi sertifikat kunci publik yang akan
disajikan ke server pada saat sesi SSL dibuat. Bukan itu
diperlukan (tetapi dapat disediakan) jika server tidak memerlukannya. Mungkin itu
file yang sama dengan kunci pribadi (kunci gabungan dan file sertifikat) tetapi ini bukan
direkomendasikan. Lihat juga --sslkey di bawah ini.

CATATAN: Jika Anda menggunakan otentikasi klien, nama pengguna diambil dari
CommonName sertifikat dan menimpa nama yang ditetapkan dengan --user.

--sslkey
(Kata kunci: sslkey)
Menentukan nama file kunci SSL pribadi sisi klien. Beberapa SSL terenkripsi
server memerlukan kunci sisi klien dan sertifikat untuk otentikasi. Di sebagian besar
kasus, ini opsional. Ini menentukan lokasi kunci pribadi yang digunakan untuk
menandatangani transaksi dengan server pada saat sesi SSL dibuat. Dia
tidak diperlukan (tetapi mungkin disediakan) jika server tidak memerlukannya. Itu mungkin
file yang sama dengan kunci publik (kunci gabungan dan file sertifikat) tetapi ini bukan
direkomendasikan.

Jika kata sandi diperlukan untuk membuka kunci, itu akan diminta pada saat itu
sesaat sebelum membuat sesi ke server. Ini dapat menyebabkan beberapa
komplikasi dalam mode daemon.

Lihat juga --sslcert di atas.

--sslproto
(Kata kunci: sslproto, CATATAN: perubahan semantik sejak v6.4.0)
Opsi ini memiliki penggunaan ganda, di luar perilaku fetchmail historis. Ini mengontrol keduanya
versi protokol SSL/TLS dan, jika --ssl tidak ditentukan, perilaku STARTTLS
(memutakhirkan protokol ke koneksi SSL atau TLS in-band). Beberapa pilihan lain
namun dapat membuat TLS wajib.

Hanya jika opsi ini dan --ssl tidak ada untuk polling, akan ada TLS oportunistik
untuk POP3 dan IMAP, di mana fetchmail akan mencoba untuk meningkatkan ke TLSv1 atau yang lebih baru.

Nilai yang diakui untuk --sslproto diberikan di bawah ini. Anda biasanya harus memilih salah satu dari
opsi negosiasi otomatis, yaitu 'mobil' atau salah satu opsi yang diakhiri dengan plus (+)
karakter. Perhatikan bahwa tergantung pada versi dan konfigurasi perpustakaan OpenSSL, beberapa opsi
menyebabkan kesalahan run-time karena versi SSL atau TLS yang diminta tidak didukung oleh
perpustakaan OpenSSL yang diinstal tertentu.

'', string kosong
Nonaktifkan STARTTLS. Jika --ssl diberikan untuk server yang sama, catat kesalahan dan
berpura-pura itu 'mobil' telah digunakan sebagai gantinya.

'mobil' (bawaan). Sejak v6.4.0. Memerlukan TLS. Negosiasi otomatis TLSv1 atau yang lebih baru, nonaktifkan
Penurunan versi SSLv3. (fetchmail 6.3.26 dan yang lebih lama memiliki semua negosiasi otomatis
protokol yang didukung oleh pustaka OpenSSL mereka, termasuk SSLv3 yang rusak.

'SSL23'
Lihat 'mobil'.

'SSL3' Memerlukan SSLv3 persis. SSLv3 rusak, tidak didukung di semua sistem, hindari
itu jika memungkinkan. Ini akan membuat fetchmail hanya menegosiasikan SSLv3, dan merupakan
satu-satunya cara selain 'SSL3+' agar fetchmail 6.4.0 atau yang lebih baru mengizinkan SSLv3.

'SSL3+'
sama dengan 'mobil', tetapi izinkan SSLv3 juga. Ini adalah satu-satunya cara selain
'SSL3' agar fetchmail 6.4.0 atau yang lebih baru mengizinkan SSLv3.

'TLS1' Memerlukan TLSv1. Ini tidak menegosiasikan TLSv1.1 atau yang lebih baru, dan tidak disarankan.
Ganti dengan TLS1+ kecuali yang terakhir mencekik server Anda.

'TLS1+'
Sejak v6.4.0. Lihat 'fBaauto'.

'TLS1.1'
Sejak v6.4.0. Memerlukan TLS v1.1 dengan tepat.

'TLS1.1+'
Sejak v6.4.0. Memerlukan TLS. Negosiasi otomatis TLSv1.1 atau yang lebih baru.

'TLS1.2'
Sejak v6.4.0. Memerlukan TLS v1.2 dengan tepat.

'TLS1.2+'
Sejak v6.4.0. Memerlukan TLS. Negosiasi otomatis TLSv1.2 atau yang lebih baru.

Parameter tidak dikenal
diperlakukan sama dengan 'mobil'.

CATATAN: Anda hampir tidak perlu menggunakan apa pun selain '' (untuk memaksa
koneksi tidak terenkripsi) atau 'otomatis' (untuk menerapkan TLS).

--slcertck
(Kata kunci: sslcertck)
Menyebabkan fetchmail mengharuskan SSL/TLS digunakan dan memutuskan sambungan jika tidak dapat
berhasil menegosiasikan SSL atau TLS, atau jika tidak berhasil memverifikasi dan memvalidasi
sertifikat dan ikuti ke jangkar kepercayaan (atau sertifikat root tepercaya). NS
jangkar kepercayaan diberikan sebagai satu set sertifikat tepercaya lokal (lihat file sslcert
dan jalan pintas pilihan). Jika sertifikat server tidak dapat diperoleh atau tidak
ditandatangani oleh salah satu yang tepercaya (langsung atau tidak langsung), fetchmail akan
putuskan, terlepas dari sidik jari .

Perhatikan bahwa CRL (daftar pencabutan sertifikat) hanya didukung di OpenSSL 0.9.7
dan lebih baru! Jam sistem Anda juga harus cukup akurat saat menggunakan ini
.

Perhatikan bahwa perilaku opsional ini dapat menjadi perilaku default di fetchmail mendatang
versi.

--slcertfile
(Kata kunci: sslcertfile, sejak v6.3.17)
Menyetel file yang digunakan fetchmail untuk mencari sertifikat lokal. Defaultnya kosong.
Ini dapat diberikan selain --sslcertpath di bawah ini, dan sertifikat yang ditentukan dalam
--slcertfile akan diproses sebelum yang di --sslcertpath. Pilihannya bisa
digunakan selain --sslcertpath.

File tersebut adalah file teks. Ini berisi rangkaian sertifikat CA tepercaya
dalam bentuk PEM.

Perhatikan bahwa menggunakan opsi ini akan menekan pemuatan CA tepercaya SSL default
file sertifikat kecuali Anda mengatur variabel lingkungan
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS ke nilai yang tidak kosong.

--sslcertpath
(Kata kunci: sslcertpath)
Menyetel direktori yang digunakan fetchmail untuk mencari sertifikat lokal. Standarnya adalah
direktori default OpenSSL Anda. Direktori harus di-hash dengan cara OpenSSL
mengharapkannya - setiap kali Anda menambah atau mengubah sertifikat di direktori, Anda perlu
untuk menggunakan c_rehash alat (yang datang dengan OpenSSL di alat/ subdirektori).
Juga, setelah peningkatan OpenSSL, Anda mungkin perlu menjalankan c_rehash; terutama ketika
upgrade dari 0.9.X ke 1.0.0.

Ini dapat diberikan selain --slcertfile di atas, yang melihat untuk didahulukan
aturan.

Perhatikan bahwa menggunakan opsi ini akan menekan penambahan CA tepercaya SSL default
direktori sertifikat kecuali Anda mengatur variabel lingkungan
FETCHMAIL_INCLUDE_DEFAULT_X509_CA_CERTS ke nilai yang tidak kosong.

--sslnama umum <umum nama>
(Kata kunci: sslcommonname; sejak v6.3.9)
Penggunaan opsi ini tidak disarankan. Sebelum menggunakannya, hubungi administrator
server upstream Anda dan meminta sertifikat SSL yang tepat untuk digunakan. Jika itu
tidak dapat dicapai, opsi ini dapat digunakan untuk menentukan nama (CommonName) yang
fetchmail harapkan pada sertifikat server. Server yang dikonfigurasi dengan benar akan
atur ini ke nama host yang digunakan untuk mencapainya, dan secara default fetchmail akan
berharap sebanyak. Gunakan opsi ini ketika CommonName diatur ke beberapa nilai lain, untuk
hindari peringatan "Server CommonName mismatch", dan hanya jika server upstream
tidak dapat dibuat untuk menggunakan sertifikat yang tepat.

--sslfinger
(Kata kunci: sslfingerprint)
Tentukan sidik jari kunci server (hash MD5) dalam heksadesimal
notasi dengan titik dua yang memisahkan kelompok dua digit. Digit hex huruf harus
dalam huruf besar. Ini adalah format yang digunakan fetchmail untuk melaporkan sidik jari
ketika koneksi SSL dibuat. Ketika ini ditentukan, fetchmail akan
bandingkan sidik jari kunci server dengan yang diberikan, dan koneksi akan gagal
jika mereka tidak cocok, terlepas dari slcertck pengaturan. Koneksi juga akan
gagal jika fetchmail tidak dapat memperoleh sertifikat SSL dari server. Ini bisa jadi
digunakan untuk mencegah serangan man-in-the-middle, tetapi sidik jari dari server
perlu diperoleh atau diverifikasi melalui saluran yang aman, dan tentu saja tidak melalui
koneksi Internet yang sama yang akan digunakan fetchmail.

Menggunakan opsi ini akan mencegah kesalahan verifikasi sertifikat pencetakan selama
--sslcertck tidak disetel.

Untuk mendapatkan sidik jari dari sertifikat yang disimpan dalam file cert.pem, coba:

openssl x509 -in cert.pem -noout -md5 -sidik jari

Untuk detailnya, lihat x509(1ssl).

Sampel kontrol Opsi
-S | --smtphost
(Kata kunci: smtp[host])
Tentukan daftar pencarian host untuk meneruskan email ke (satu atau lebih nama host, koma-
terpisah). Host dicoba dalam urutan daftar; yang pertama naik menjadi
meneruskan target untuk lari saat ini. Jika opsi ini tidak ditentukan,
'localhost' digunakan sebagai default. Setiap nama host mungkin memiliki nomor port berikut
nama tuan rumah. Nomor port dipisahkan dari nama host dengan garis miring; NS
port default adalah "smtp". Jika Anda menentukan nama jalur absolut (diawali dengan /),
itu akan ditafsirkan sebagai nama soket UNIX yang menerima koneksi LMTP
(seperti yang didukung oleh daemon Cyrus IMAP) Contoh:

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

Opsi ini dapat digunakan dengan ODMR, dan akan menjadikan fetchmail sebagai relai antara ODMR
server dan penerima SMTP atau LMTP.

--mengambildomain
(Kata kunci: fetchdomains)
Dalam mode ETRN atau ODMR, opsi ini menentukan daftar domain yang harus dimiliki server
mengirim surat untuk sekali koneksi berbalik. Standarnya adalah FQDN dari
mesin berjalan ambil surat.

-D | --alamat smt
(Kata kunci: smtpaddress)
Tentukan domain yang akan ditambahkan ke alamat di jalur RCPT TO yang dikirim ke SMTP.
Jika ini tidak ditentukan, nama server SMTP (seperti yang ditentukan oleh
--smtphost) digunakan untuk SMTP/LMTP dan 'localhost' digunakan untuk soket UNIX/BSMTP.

--namasmtp
(Kata kunci: smtpname)
Tentukan domain dan pengguna yang akan dimasukkan ke dalam jalur RCPT TO yang dikirimkan ke SMTP. NS
pengguna default adalah pengguna lokal saat ini.

-Z | --antispam <nnn[, nn]...>
(Kata kunci: antispam)
Menentukan daftar kesalahan SMTP numerik yang akan ditafsirkan sebagai spam-
memblokir respon dari pendengar. Nilai -1 menonaktifkan opsi ini. Untuk
opsi baris perintah, nilai daftar harus dipisahkan dengan koma.

-m | --mda
(Kata kunci: mda)
Opsi ini memungkinkan ambil surat menggunakan Pesan atau Agen Pengiriman Lokal (MDA atau LDA)
langsung, bukan meneruskan melalui SMTP atau LMTP.

Untuk menghindari kehilangan email, gunakan opsi ini hanya dengan MDA seperti maildrop atau MTA seperti
sendmail yang keluar dengan status bukan nol pada disk-full dan kesalahan pengiriman lainnya;
status bukan nol memberi tahu fetchmail bahwa pengiriman gagal dan mencegah pesan
agar tidak terhapus di server.

If ambil surat berjalan sebagai root, ia menetapkan id penggunanya saat mengirimkan email melalui
sebuah MDA sebagai berikut: Pertama, lingkungan FETCHMAILUSER, LOGNAME, dan USER
variabel diperiksa dalam urutan ini. Nilai variabel pertama dari daftarnya
yang didefinisikan (bahkan jika kosong!) akan dicari di database pengguna sistem. Jika
tidak ada variabel yang ditentukan, fetchmail akan menggunakan id pengguna yang sebenarnya
dimulai dengan. Jika salah satu variabel didefinisikan, tetapi pengguna menyatakan tidak ada
ditemukan, fetchmail terus berjalan sebagai root, tanpa memeriksa variabel yang tersisa di
Daftar. Secara praktis, ini berarti jika Anda menjalankan fetchmail sebagai root (bukan
direkomendasikan), akan sangat berguna untuk mendefinisikan variabel lingkungan FETCHMAILUSER untuk
atur pengguna yang harus dijalankan oleh MDA. Beberapa MDA (seperti maildrop) dirancang
untuk di setuid root dan setuid ke user id penerima, agar tidak rugi
fungsionalitas dengan cara ini bahkan ketika menjalankan fetchmail sebagai pengguna yang tidak memiliki hak istimewa. Periksalah
Manual MDA untuk detailnya.

Beberapa kemungkinan MDA adalah "/usr/sbin/sendmail -i -f %F -- %T" (Catatan: beberapa beberapa
kesalahan versi sendmail lama atau vendor -- untuk sebuah alamat, bukan sebuah
indikator untuk menandai akhir argumen opsi), "/usr/bin/deliver" dan
"/usr/bin/maildrop -d %T". Alamat pengiriman lokal akan dimasukkan ke dalam MDA
perintah di mana pun Anda menempatkan %T; alamat Dari pesan email akan dimasukkan
di mana Anda menempatkan %F.

Do JANGAN melampirkan itu %F or %T string in tunggal kutipan! Untuk %T dan %F, fetchmail
melampirkan alamat dalam tanda kutip tunggal ('), setelah menghapus tanda kutip tunggal mereka
mungkin berisi, sebelum perintah MDA diteruskan ke shell.

Do JANGAN menggunakan an MDA doa bahwa kiriman on itu isi of Kepada/Cc/Bcc, 'like'
"sendmail -i -t" atau "qmail-inject", itu akan membuat loop surat dan membawa just
murka banyak postmaster di atas kepala Anda. Ini adalah salah satu yang paling sering
kesalahan konfigurasi!

Juga, lakukan tidak coba gabungkan mode multidrop dengan MDA seperti maildrop yang bisa
hanya menerima satu alamat, kecuali hulu Anda menyimpan satu salinan pesan per
penerima dan mengirimkan penerima amplop dalam sebuah header; Anda akan kehilangan surat.

Yang terkenal procmail(1) paket sangat sulit dikonfigurasi dengan benar, ia memiliki
perilaku "jatuh ke aturan berikutnya" yang sangat buruk pada kesalahan pengiriman (bahkan
yang sementara, seperti ruang disk habis jika daemon email pengguna lain menyalinnya
kotak surat di sekitar untuk membersihkan pesan lama), sehingga surat Anda akan berakhir salah
kotak surat cepat atau lambat. Konfigurasi procmail yang tepat berada di luar cakupan
dokumen ini. Menggunakan kiriman surat(1) biasanya jauh lebih mudah, dan banyak pengguna menemukan
sintaks filter yang digunakan oleh maildrop lebih mudah dipahami.

Akhirnya, kami sangat menyarankan Anda melakukannya tidak menggunakan qmail-inject. Baris perintah
antarmuka non-standar tanpa memberikan manfaat untuk penggunaan biasa, dan fetchmail
tidak berusaha untuk mengakomodasi penyimpangan qmail-inject dari standar. Beberapa
baris perintah dan opsi lingkungan qmail-inject sebenarnya berbahaya dan
dapat menyebabkan utas terputus, pesan duplikat yang tidak terdeteksi, dan loop penerusan.

--lmtp (Kata kunci: lmtp)
Penyebab pengiriman melalui LMTP (Local Mail Transfer Protocol). Tuan rumah dan pelabuhan layanan
harus secara eksplisit ditentukan pada setiap host dalam daftar perburuan smtphost (lihat di atas) jika
opsi ini dipilih; port default 25 akan (sesuai dengan RFC 2033) tidak
diterima.

--bsmtp
(Kata kunci: bsmtp)
Tambahkan email yang diambil ke file BSMTP. Ini hanya berisi perintah SMTP yang
biasanya akan dihasilkan oleh fetchmail saat meneruskan email ke pendengar SMTP
daemon.

Argumen '-' menyebabkan batch SMTP ditulis ke output standar, yaitu
penggunaan terbatas: ini hanya masuk akal untuk debugging, karena fetchmail reguler
keluaran diselingi pada saluran yang sama, jadi ini tidak cocok untuk surat
pengiriman. Mode khusus ini dapat dihapus pada rilis berikutnya.

Perhatikan bahwa rekonstruksi fetchmail dari jalur MAIL FROM dan RCPT TO bukanlah
dijamin benar; peringatan yang dibahas di bawah PENGGUNAAN DAN PENYALAHGUNAAN MULTIDROP
KOTAK SURAT di bawah ini berlaku. Mode ini didahulukan sebelum --mda dan SMTP/LMTP.

--header buruk {tolak|terima}
(Kata kunci: bad-header; sejak v6.3.15)
Tentukan bagaimana fetchmail seharusnya memperlakukan pesan dengan header yang buruk, yaitu header
dengan sintaks yang buruk. Secara tradisional, fetchmail telah menolak pesan seperti itu, tetapi beberapa
distributor memodifikasi fetchmail untuk menerimanya. Anda sekarang dapat mengonfigurasi fetchmail
perilaku per server.

Sumber batas kontrol Opsi
-l | --membatasi
(Kata kunci: batas)
Mengambil argumen ukuran oktet maksimum, di mana 0 adalah default dan juga spesial
nilai yang menunjuk "tanpa batas". Jika bukan nol, pesan yang lebih besar dari ukuran ini tidak akan
diambil dan akan ditinggalkan di server (di sesi latar depan, progres
pesan akan mencatat bahwa mereka "kebesaran"). Jika protokol pengambilan mengizinkan (dalam
tertentu, di bawah IMAP atau POP3 tanpa opsi fetchall) pesan tidak akan
ditandai terlihat.

Eksplisit --limit 0 mengesampingkan batasan apa pun yang ditetapkan dalam file kontrol jalankan Anda. Ini
opsi ini ditujukan bagi mereka yang perlu mengontrol waktu pengambilan secara ketat karena
tarif telepon yang mahal dan bervariasi.

Dikombinasikan dengan --limitflush, dapat digunakan untuk menghapus pesan yang terlalu besar yang menunggu
sebuah server. Dalam mode daemon, pemberitahuan ukuran besar dikirimkan ke pengguna yang menelepon
(lihat opsi --warnings). Opsi ini tidak bekerja dengan ETRN atau ODMR.

-w | --peringatan
(Kata kunci: peringatan)
Mengambil interval dalam hitungan detik. Ketika Anda menelepon ambil surat dengan opsi 'batas' di
mode daemon, ini mengontrol interval peringatan tentang pesan yang terlalu besar
dikirimkan ke pengguna yang menelepon (atau pengguna yang ditentukan oleh opsi 'postmaster').
Salah satu pemberitahuan tersebut selalu dikirimkan pada akhir jajak pendapat pertama bahwa
pesan berukuran besar terdeteksi. Setelah itu, pemberitahuan ulang ditekan sampai
setelah interval peringatan berlalu (itu akan terjadi di akhir yang pertama
mengikuti polling).

-b | --batchlimit
(Kata kunci: batchlimit)
Tentukan jumlah maksimum pesan yang akan dikirimkan ke pendengar SMTP
sebelum koneksi sengaja dirobohkan dan dibangun kembali (default ke 0, artinya
tidak terbatas). Eksplisit --batchlimit 0 mengesampingkan batasan apa pun yang ditetapkan dalam proses Anda
berkas kendali. Ketika kirim email(8) biasanya memulai pengiriman pesan
segera setelah menerima terminator pesan, beberapa pendengar SMTP tidak begitu
mengingatkan. MTA suka smail(8) dapat menunggu sampai soket pengiriman dimatikan untuk
mengantarkan. Ini dapat menghasilkan penundaan yang mengganggu ketika ambil surat sedang diproses sangat besar
batch. Menetapkan batas batch ke beberapa ukuran bukan nol akan mencegah penundaan ini.
Opsi ini tidak bekerja dengan ETRN atau ODMR.

-B | --batas pengambilan
(Kata kunci: fetchlimit)
Batasi jumlah pesan yang diterima dari server tertentu dalam satu polling. Oleh
default tidak ada batasan. Eksplisit --fetchlimit dari 0 mengesampingkan batasan apa pun yang ditetapkan
di file kontrol jalankan Anda. Opsi ini tidak bekerja dengan ETRN atau ODMR.

--fetchsizelimit
(Kata kunci: fetchsizelimit)
Batasi jumlah ukuran pesan yang diterima dari server tertentu dalam satu
transaksi. Opsi ini berguna untuk mengurangi penundaan dalam mengunduh yang pertama
mail ketika ada terlalu banyak mail di kotak surat. Secara default, batasnya adalah 100.
Jika diatur ke 0, ukuran semua pesan diunduh di awal. Opsi ini tidak
tidak bekerja dengan ETRN atau ODMR. Untuk POP3, satu-satunya nilai bukan nol yang valid adalah 1.

--fastuidl
(Kata kunci: fastuidl)
Lakukan pencarian biner alih-alih pencarian linier untuk UID pertama yang tidak terlihat. Pencarian biner dihindari
mengunduh UID semua email. Ini menghemat waktu (terutama dalam mode daemon)
di mana mengunduh kumpulan UID yang sama di setiap polling adalah pemborosan bandwidth. NS
angka 'n' menunjukkan seberapa jarang pencarian linier harus dilakukan. Dalam mode daemon,
pencarian linier digunakan sekali diikuti oleh pencarian biner dalam jajak pendapat 'n-1' jika 'n' adalah
lebih besar dari 1; pencarian biner selalu digunakan jika 'n' adalah 1; pencarian linier selalu
digunakan jika 'n' adalah 0. Dalam mode non-daemon, pencarian biner digunakan jika 'n' adalah 1; sebaliknya
pencarian linier digunakan. Nilai default 'n' adalah 4. Opsi ini berfungsi dengan POP3
saja.

-e | --menghapus
(Kata kunci: hapus)
Atur agar penghapusan menjadi final setelah sejumlah pesan tertentu. Dibawah
POP2 atau POP3, fetchmail tidak dapat membuat penghapusan final tanpa mengirim QUIT dan mengakhiri
sesi -- dengan opsi ini aktif, fetchmail akan menghentikan pengambilan email yang lama
sesi menjadi beberapa sub-sesi, mengirimkan QUIT setelah setiap sub-sesi. Ini adalah sebuah
pertahanan yang baik terhadap penurunan garis di server POP3. Di bawah IMAP, ambil surat biasanya
mengeluarkan perintah EXPUNGE setelah setiap penghapusan untuk memaksa penghapusan menjadi
dilakukan segera. Ini paling aman ketika koneksi Anda ke server tidak stabil dan
mahal, karena menghindari pengiriman ulang email duplikat setelah mencapai satu baris. Namun, pada
kotak surat besar overhead pengindeksan ulang setelah setiap pesan dapat membanting server
cukup sulit, jadi jika koneksi Anda dapat diandalkan, ada baiknya untuk mengurangi pengeluaran
sering. Perhatikan juga bahwa beberapa server memberlakukan penundaan beberapa detik setelahnya
masing-masing berhenti, jadi fetchmail mungkin tidak dapat langsung masuk kembali setelah penghapusan
-- Anda mungkin melihat kesalahan "kunci sibuk" jika ini terjadi. Jika Anda menentukan opsi ini ke
bilangan bulat N, itu memberitahu ambil surat untuk hanya mengeluarkan penghapusan pada setiap penghapusan ke-N. NS
argumen nol menekan penghapusan seluruhnya (jadi tidak ada penghapusan sama sekali yang akan dilakukan
sampai akhir perjalanan). Opsi ini tidak bekerja dengan ETRN atau ODMR.

Otentikasi Opsi
-u | --pengguna | --nama pengguna
(Kata kunci: pengguna[nama])
Menentukan identifikasi pengguna yang akan digunakan saat masuk ke server surat.
Identifikasi pengguna yang tepat bergantung pada server dan pengguna. Standarnya
adalah nama login Anda di mesin klien yang sedang berjalan ambil surat. Lihat PENGGUNA
Otentikasi di bawah ini untuk deskripsi lengkap.

-I | --antarmuka
(Kata kunci: antarmuka)
Mengharuskan perangkat antarmuka tertentu dan memiliki lokal atau jarak jauh tertentu
IPv4 (IPv6 belum didukung oleh opsi ini) alamat (atau rentang) sebelum pemungutan suara.
Sering ambil surat digunakan melalui tautan TCP/IP point-to-point sementara
dibuat langsung ke server surat melalui SLIP atau PPP. Itu relatif aman
saluran. Tetapi ketika ada rute TCP/IP lain ke server surat (mis
terhubung ke ISP alternatif), nama pengguna dan kata sandi Anda mungkin rentan terhadap
mengintai (terutama ketika mode daemon secara otomatis melakukan polling untuk surat, pengiriman dan)
hapus kata sandi melalui internet pada interval yang dapat diprediksi). Opsi --interface mungkin
digunakan untuk mencegah hal ini. Ketika tautan yang ditentukan tidak aktif atau tidak terhubung ke
alamat IP yang cocok, polling akan dilewati. Formatnya adalah:

antarmuka/iii.iii.iii.iii[/mmm.mmm.mmm.mmm]

Bidang sebelum garis miring pertama adalah nama antarmuka (yaitu sl0, ppp0 dll.). NS
bidang sebelum garis miring kedua adalah alamat IP yang dapat diterima. Lapangan setelah
garis miring kedua adalah topeng yang menentukan kisaran alamat IP untuk diterima. Jika tidak
topeng hadir 255.255.255.255 diasumsikan (yaitu sama persis). Pilihan ini adalah
saat ini hanya didukung di Linux dan FreeBSD. Silakan lihat Monitor bagian
untuk di bawah ini untuk informasi spesifik FreeBSD.

Perhatikan bahwa opsi ini dapat dihapus dari versi fetchmail yang akan datang.

-M | --memantau
(Kata kunci: monitor)
Mode daemon dapat menyebabkan tautan sementara yang secara otomatis dihapus setelah a
periode tidak aktif (misalnya tautan PPP) untuk tetap aktif tanpa batas waktu. Pilihan ini
mengidentifikasi antarmuka TCP/IP sistem yang akan dipantau aktivitasnya. Setelah setiap jajak pendapat
interval, jika tautan aktif tetapi tidak ada aktivitas lain yang terjadi pada tautan, maka
polling akan dilewati. Namun, saat fetchmail dibangunkan oleh sinyal,
pemeriksaan monitor dilewati dan jajak pendapat berjalan tanpa syarat. Pilihan ini adalah
saat ini hanya didukung di Linux dan FreeBSD. Untuk Monitor dan antarmuka
opsi untuk bekerja untuk pengguna non-root di bawah FreeBSD, biner fetchmail harus
diinstal SGID kmem. Ini akan menjadi lubang keamanan, tetapi fetchmail berjalan dengan
GID efektif diatur ke grup kmem hanya ketika data antarmuka sedang
dikumpulkan.

Perhatikan bahwa opsi ini dapat dihapus dari versi fetchmail yang akan datang.

--auth
(Kata kunci: auth[memikat])
Opsi ini memungkinkan Anda untuk menentukan jenis otentikasi (lihat USER AUTHENTICATION
di bawah ini untuk rincian). Nilai yang mungkin adalah Apa pun, kata sandi, kerberos_v5, Kerberos
(atau, untuk ketepatan yang menyiksa, kerberos_v4), gssapi, menjejalkan-md5, otp, ntlm, msn
(hanya untuk POP3), luar (hanya IMAP) dan ssh. Ketika Apa pun (default) adalah
ditentukan, fetchmail mencoba metode pertama yang tidak memerlukan kata sandi (EKSTERNAL,
GSSAPI, KERBEROS IV, KERBEROS 5); kemudian mencari metode yang menutupi kata sandi Anda
(CRAM-MD5, NTLM, X-OTP - perhatikan bahwa MSN hanya didukung untuk POP3, tetapi tidak
pemeriksaan otomatis); dan hanya jika server tidak mendukung salah satu dari itu, server akan mengirimkan
kata sandi en clair. Nilai lain dapat digunakan untuk memaksa berbagai otentikasi
metode (ssh menekan otentikasi dan dengan demikian berguna untuk IMAP PREAUTH).
(luar menekan otentikasi dan dengan demikian berguna untuk IMAP EKSTERNAL). Setiap
nilai selain kata sandi, menjejalkan-md5, ntlm, msn or otp menekan normal fetchmail
pertanyaan untuk kata sandi. Menentukan ssh saat Anda menggunakan pengaman ujung-ke-ujung
koneksi seperti terowongan ssh; menentukan luar saat Anda menggunakan TLS dengan klien
otentikasi dan tentukan gssapi or kerberos_v4 jika Anda menggunakan protokol
varian yang menggunakan GSSAPI atau K4. Memilih protokol KPOP secara otomatis memilih
Otentikasi Kerberos. Opsi ini tidak bekerja dengan ETRN. layanan GSSAPI
nama sesuai dengan pendaftaran RFC-2743 dan IANA, lihat Keamanan Generik
Antarmuka Program Aplikasi Layanan (GSSAPI)/Kerberos/Otentikasi Sederhana dan
Nama Layanan Lapisan Keamanan (SASL)http://www.iana.org/assignments/
nama-layanan-gssapi/⟩.

bermacam-macam Opsi
-f | --fetchmailrc
Tentukan nama non-default untuk ~/.fetchmailrc menjalankan file kontrol. Nama jalannya
argumen harus berupa "-" (satu tanda hubung, artinya membaca konfigurasi dari
input standar) atau nama file. Kecuali opsi --version juga aktif, sebuah bernama
argumen file harus memiliki izin tidak lebih terbuka dari 0700 (u=rwx,g=,o=) atau
/dev/null.

-i | --file id
(Kata kunci: idfile)
Tentukan nama alternatif untuk file .fetchids yang digunakan untuk menyimpan UID pesan. CATATAN:
sejak fetchmail 6.3.0, akses tulis ke direktori yang berisi idfile adalah
diperlukan, karena fetchmail menulis file sementara dan mengganti namanya menjadi
idfile asli hanya jika file sementara telah berhasil ditulis. Ini menghindari
pemotongan idfiles saat kehabisan ruang disk.

--pidfile
(Kata kunci: pidfile; sejak fetchmail v6.3.4)
Ganti lokasi default file PID. Default: lihat "LINGKUNGAN" di bawah.

-n | --tidak menulis ulang
(Kata kunci: tidak ada penulisan ulang)
Biasanya, ambil surat mengedit header alamat RFC-822 (Ke, Dari, Cc, Bcc, dan Balas-Ke)
dalam surat yang diambil sehingga setiap ID surat lokal ke server diperluas hingga penuh
alamat (@ dan nama host server surat ditambahkan). Ini memungkinkan balasan aktif
klien untuk ditangani dengan benar (jika tidak, pengirim pesan Anda mungkin berpikir mereka
harus ditujukan kepada pengguna lokal di mesin klien!). Opsi ini menonaktifkan
penulisan ulang. (Pilihan ini disediakan untuk menenangkan orang-orang yang paranoid tentang
memiliki header email edit MTA dan ingin tahu mereka dapat mencegahnya, tetapi itu
umumnya bukan ide yang baik untuk benar-benar mematikan penulisan ulang.) Saat menggunakan ETRN atau ODMR,
opsi penulisan ulang tidak efektif.

-E | --amplop
(Kata kunci: amplop; Hanya multidrop)
Dalam file konfigurasi, sintaks yang disempurnakan digunakan:
amplop [ ]

Opsi ini mengubah tajuk ambil surat mengasumsikan akan membawa salinan surat
alamat amplop. Biasanya ini adalah 'X-Envelope-To'. Header lain yang biasanya ditemukan
untuk membawa informasi amplop adalah 'X-Original-To' dan 'Delivered-To'. Sekarang, sejak
tajuk ini tidak standar, praktiknya bervariasi. Lihat pembahasan
penanganan alamat multidrop di bawah ini. Sebagai kasus khusus, 'amplop "Diterima"' memungkinkan
penguraian baris Received gaya sendmail. Ini adalah default, tetapi tidak disarankan
karena tidak sepenuhnya dapat diandalkan.

Perhatikan bahwa fetchmail mengharapkan baris yang diterima berada dalam format tertentu: Harus
mengandung "oleh tuan rumah untuk alamat", di mana tuan rumah harus cocok dengan salah satu nama server surat
yang dikenali fetchmail untuk akun yang dimaksud.

Argumen penghitungan opsional (hanya tersedia di file konfigurasi) menentukan
berapa banyak baris header semacam ini dilewati. Hitungan 1 berarti: lewati yang pertama,
ambil yang kedua. Hitungan 2 berarti: lewati yang pertama dan kedua, ambil yang ketiga, dan
begitu seterusnya.

-Q | --qvirtual
(Kata kunci: qvirtual; Hanya multidrop)
Awalan string yang ditetapkan untuk opsi ini akan dihapus dari nama pengguna yang ditemukan
di header yang ditentukan dengan amplop pilihan (sebelum melakukan multidrop nama
pemetaan atau pemeriksaan domain lokal, jika ada). Opsi ini berguna jika
Anda menggunakan ambil surat untuk mengumpulkan email untuk seluruh domain dan ISP Anda (atau
penyedia pengalihan email Anda) menggunakan qmail. Salah satu fitur dasar qmail
adalah Dikirim ke: judul pesan. Setiap kali qmail mengirimkan pesan ke lokal
kotak surat itu menempatkan nama pengguna dan nama host penerima amplop di baris ini.
Alasan utama untuk ini adalah untuk mencegah loop email. Untuk mengatur qmail ke surat batch
untuk situs yang terputus, ISP-mailhost biasanya akan memasukkan situs itu ke dalam
File kontrol 'Virtualhosts' sehingga akan menambahkan awalan ke semua alamat email untuk ini
lokasi. Ini menghasilkan email yang dikirim ke '[email dilindungi]' memiliki sebuah
Dikirim ke: baris formulir:

Dikirim ke: [email dilindungi]

ISP dapat membuat awalan 'mbox-userstr-' apa pun yang mereka pilih kecuali string yang cocok dengan
nama host pengguna mungkin. Dengan menggunakan opsi 'amplop Dikirim-Ke:' Anda dapat membuat
fetchmail dengan andal mengidentifikasi penerima amplop asli, tetapi Anda harus menghapusnya
awalan 'mbox-userstr-' untuk dikirimkan ke pengguna yang benar. Untuk itulah opsi ini.

--configdump
Mengurai ~/.fetchmailrc file, menafsirkan opsi baris perintah apa pun yang ditentukan, dan
membuang laporan konfigurasi ke output standar. Laporan konfigurasi adalah data
tugas struktur dalam bahasa Python. Opsi ini dimaksudkan untuk digunakan dengan
sebuah interaktif ~/.fetchmailrc editor suka ambilmailconf, ditulis dengan Python.

Dihapus Opsi
-T | --netsec
Dihapus sebelum versi 6.3.0, pustaka inet6_apps dasar yang diperlukan telah
dihentikan dan tidak lagi tersedia.

PENGGUNA AUTENTIKASI DAN ENKRIPSI

Semua mode kecuali ETRN memerlukan otentikasi klien ke server. Pengguna biasa
otentikasi di ambil surat sangat mirip dengan mekanisme otentikasi dari ftp(1). Itu
ID pengguna dan kata sandi yang benar tergantung pada sistem keamanan yang mendasarinya di server surat.

Jika server surat adalah mesin Unix di mana Anda memiliki akun pengguna biasa, Anda
nama login dan kata sandi biasa digunakan dengan ambil surat. Jika Anda menggunakan nama login yang sama
di server dan mesin klien, Anda tidak perlu khawatir tentang menentukan id pengguna
pada pengatur terkenal. Pengatur ini menawarkan bantuan hukum kepada traderapabila trader berselisih dengan broker yang terdaftar dengan mereka. -u option -- perilaku defaultnya adalah menggunakan nama login Anda di mesin klien
sebagai user-id pada mesin server. Jika Anda menggunakan nama login yang berbeda di server
mesin, tentukan nama login itu dengan -u pilihan. misalnya jika nama login Anda adalah 'jsmith'
pada mesin bernama 'mailgrunt', Anda akan memulai ambil surat sebagai berikut:

ambil email -u jsmith mailgrunt

Perilaku default dari ambil surat adalah untuk meminta kata sandi server surat Anda sebelum
koneksi dibuat. Ini adalah cara paling aman untuk digunakan ambil surat dan memastikan bahwa Anda
kata sandi tidak akan dikompromikan. Anda juga dapat menentukan kata sandi Anda di
~/.fetchmailrc mengajukan. Ini nyaman saat menggunakan ambil surat dalam mode daemon atau dengan
script.

Menggunakan netrc arsip
Jika Anda tidak menentukan kata sandi, dan ambil surat tidak dapat mengekstrak satu dari Anda
~/.fetchmailrc file, itu akan mencari ~/.netrc file di direktori home Anda sebelumnya
meminta satu secara interaktif; jika entri yang cocok dengan server surat ditemukan di file itu,
password yang akan digunakan. Fetchmail pertama-tama mencari kecocokan pada nama polling; jika ditemukan
tidak ada, ia memeriksa kecocokan melalui nama. Lihat ftp(1) halaman manual untuk detail dari
sintaks dari ~/.netrc mengajukan. Untuk menunjukkan contoh praktis, .netrc mungkin terlihat seperti ini:

mesin hermes.example.org
masuk joe
rahasia kata sandi

Anda dapat mengulangi blok ini dengan informasi pengguna yang berbeda jika Anda perlu memberikan lebih dari
satu kata sandi.

Fitur ini memungkinkan Anda untuk menghindari duplikasi informasi kata sandi di lebih dari satu
file.

Pada server surat yang tidak menyediakan akun pengguna biasa, ID pengguna dan kata sandi Anda adalah
biasanya diberikan oleh administrator server ketika Anda mengajukan permohonan untuk kotak surat di server.
Hubungi administrator server Anda jika Anda tidak mengetahui ID pengguna dan kata sandi yang benar untuk
akun kotak surat Anda.

POP3 VARIAN

Versi awal POP3 (RFC1081, RFC1225) mendukung bentuk independen yang kasar
otentikasi menggunakan .rhosts file di sisi server surat. Di bawah varian RPOP ini, a
ID per pengguna tetap yang setara dengan kata sandi dikirim dengan jelas melalui tautan ke yang dipesan
port, dengan perintah RPOP daripada PASS untuk memperingatkan server bahwa ia harus melakukan hal khusus
memeriksa. RPOP didukung oleh ambil surat (Anda dapat menentukan 'protokol RPOP' untuk memiliki
program mengirim 'RPOP' daripada 'LULUS') tetapi penggunaannya sangat tidak disarankan, dan mendukung
akan dihapus dari versi fetchmail mendatang. Fasilitas ini rentan terhadap spoofing
dan ditarik di RFC1460.

RFC1460 memperkenalkan otentikasi APOP. Dalam varian POP3 ini, Anda mendaftarkan APOP
kata sandi di host server Anda (pada beberapa server, program untuk melakukan ini disebut
popauth(8)). Anda memasukkan kata sandi yang sama di ~/.fetchmailrc mengajukan. Setiap kali ambil surat
masuk, ia mengirimkan hash MD5 kata sandi Anda dan waktu salam server ke server,
yang dapat memverifikasinya dengan memeriksa database otorisasinya.

Note bahwa SEBUAH LETUSAN is tidak lagi dianggap tahan terhadap laki-laki di tengah serangan.

RETR or TOP
ambil surat melakukan beberapa upaya untuk membuat server percaya bahwa pesan belum diambil,
dengan menggunakan perintah TOP dengan sejumlah besar baris bila memungkinkan. TOP adalah perintah
yang mengambil header lengkap dan a ambil surat-Jumlah garis tubuh tertentu. Dia
opsional dan karena itu tidak diimplementasikan oleh semua server, dan beberapa diketahui mengimplementasikannya
tidak tepat. Namun, di banyak server, perintah RETR yang mengambil pesan lengkap
dengan header dan body, menyetel flag "terlihat" (misalnya, dalam antarmuka web), sedangkan
Perintah TOP tidak melakukan itu.

ambil surat akan selalu menggunakan perintah RETR jika "fetchall" disetel. ambil surat juga akan menggunakan
perintah RETR jika "keep" disetel dan "uidl" tidak disetel. Akhirnya, ambil surat akan menggunakan
Perintah RETR pada server Maillennium POP3/PROXY (digunakan oleh Comcast) untuk menghindari TOP yang disengaja
salah tafsir di server ini yang menyebabkan kerusakan pesan.

Dalam semua kasus lain, ambil surat akan menggunakan perintah TOP. Ini menyiratkan bahwa dalam "menjaga"
setup, "uidl" harus diatur jika "TOP" diinginkan.

Note bahwa deskripsi ini benar untuk versi fetchmail saat ini, tetapi perilakunya
dapat berubah di versi mendatang. Secara khusus, fetchmail mungkin lebih menyukai perintah RETR
karena perintah TOP menyebabkan banyak kesedihan di beberapa server dan hanya opsional.

BERGANTIAN AUTENTIKASI FORMULIR

Jika Anda ambil surat dibangun dengan dukungan Kerberos dan Anda menentukan otentikasi Kerberos
(baik dengan --auth atau .fetchmailrc Option mengotentikasi kerberos_v4) itu akan mencoba untuk
dapatkan tiket Kerberos dari server surat di awal setiap kueri. Catatan: jika salah satu dari
pollname atau melalui nama adalah 'hesiod', fetchmail akan mencoba menggunakan Hesiod untuk mencari
server surat.

Jika Anda menggunakan POP3 atau IMAP dengan autentikasi GSSAPI, ambil surat akan mengharapkan server untuk
memiliki kemampuan GSSAPI yang sesuai dengan RFC1731- atau RFC1734, dan akan menggunakannya. Saat ini
hanya diuji pada Kerberos V, jadi Anda diharapkan sudah memiliki pemberian tiket
tiket. Anda dapat memberikan nama pengguna yang berbeda dari nama utama Anda menggunakan standar
--pengguna perintah atau oleh .fetchmailrc Option pemakai.

Jika daemon IMAP Anda mengembalikan respons PREAUTH di baris ucapannya, fetchmail akan
perhatikan ini dan lewati langkah otentikasi normal. Ini bisa berguna, misalnya jika Anda
mulai imapd secara eksplisit menggunakan ssh. Dalam hal ini Anda dapat mendeklarasikan nilai otentikasi
'ssh' pada entri situs itu untuk berhenti .fetchmail dari meminta kata sandi saat dimulai
up.

Jika Anda menggunakan otentikasi klien dengan TLS1 dan daemon IMAP Anda mengembalikan AUTH=EKSTERNAL
tanggapan, fetchmail akan melihat ini dan akan menggunakan pintasan otentikasi dan tidak akan
mengirim kata sandi. Dalam hal ini Anda dapat mendeklarasikan nilai otentikasi 'eksternal'
di situs itu untuk berhenti ambil surat dari meminta kata sandi Anda saat memulai.

Jika Anda menggunakan POP3, dan server mengeluarkan tantangan kata sandi satu kali sesuai dengan
RFC1938, ambil surat akan menggunakan kata sandi Anda sebagai frasa sandi untuk menghasilkan yang diperlukan
tanggapan. Ini menghindari pengiriman rahasia melalui jaringan yang tidak terenkripsi.

Otentikasi RPA Compuserve didukung. Jika Anda mengkompilasi dalam dukungan, ambil surat
akan mencoba melakukan otentikasi frasa sandi RPA alih-alih mengirim kata sandi
en clair jika mendeteksi "@compuserve.com" di nama host.

Jika Anda menggunakan IMAP, otentikasi NTLM Microsoft (digunakan oleh Microsoft Exchange) adalah
didukung. Jika Anda mengkompilasi dalam dukungan, ambil surat akan mencoba melakukan NTLM
otentikasi (alih-alih mengirim kata sandi en clair) setiap kali server kembali
AUTH=NTLM dalam respons kapabilitasnya. Tentukan nilai opsi pengguna yang terlihat seperti
'pengguna@domain': bagian di sebelah kiri @ akan diteruskan sebagai nama pengguna dan bagian
ke kanan sebagai domain NTLM.

Aman Stopkontak Lapisan (SSL) dan angkutan Lapisan Security (TLS)
mengangkut. Selain itu, pengambilan POP3 dan IMAP juga dapat menegosiasikan SSL/TLS melalui
STARTTLS (atau STLS).

Perhatikan bahwa fetchmail saat ini menggunakan perpustakaan OpenSSL, yang sangat kurang terdokumentasi,
jadi kegagalan dapat terjadi hanya karena pemrogram tidak mengetahui persyaratan OpenSSL
hari. Misalnya, sejak v6.3.16, fetchmail memanggil OpenSSL_add_all_algorithms(),
yang diperlukan untuk mendukung sertifikat menggunakan SHA256 pada OpenSSL 0.9.8 -- ini
informasi sangat tersembunyi dalam dokumentasi dan sama sekali tidak jelas. Jangan
ragu untuk melaporkan kegagalan SSL yang halus.

Anda dapat mengakses layanan terenkripsi SSL dengan menentukan opsi yang dimulai dengan --ssl, seperti
seperti --ssl, --sslproto, --sslcertck, dan lain-lain. Anda juga dapat melakukan ini menggunakan
opsi pengguna yang sesuai di file .fetchmailrc. Beberapa layanan, seperti POP3 dan
IMAP, memiliki port terkenal yang berbeda yang ditentukan untuk layanan terenkripsi SSL. NS
port terenkripsi akan dipilih secara otomatis ketika SSL diaktifkan dan tidak ada port eksplisit
ditentukan. Juga, baris perintah --sslcertck atau sslcertck menjalankan opsi file kontrol
harus digunakan untuk memaksa pemeriksaan sertifikat yang ketat - lihat di bawah.

Jika SSL tidak dikonfigurasi, fetchmail biasanya akan mencoba menggunakan STARTTLS secara oportunis.
STARTTLS dapat ditegakkan dengan menggunakan --sslproto auto dan dikalahkan dengan menggunakan --sslproto ''.
Koneksi TLS menggunakan port yang sama dengan versi protokol yang tidak terenkripsi dan bernegosiasi
TLS melalui perintah khusus. Baris perintah --sslcertck atau sslcertck menjalankan opsi file kontrol
harus digunakan untuk memaksa pemeriksaan sertifikat yang ketat - lihat di bawah.

--slcertck is direkomendasikan: Saat menghubungkan ke server terenkripsi SSL atau TLS, server
menyajikan sertifikat kepada klien untuk validasi. Sertifikat diperiksa untuk memverifikasi
bahwa nama umum dalam sertifikat cocok dengan nama server yang dihubungi dan
bahwa tanggal efektif dan kedaluwarsa dalam sertifikat menunjukkan bahwa saat ini
sah. Jika salah satu dari pemeriksaan ini gagal, pesan peringatan akan dicetak, tetapi koneksi
berlanjut. Sertifikat server tidak perlu ditandatangani oleh Sertifikasi tertentu
Otoritas dan mungkin sertifikat "ditandatangani sendiri". Jika opsi baris perintah --sslcertck
atau opsi file kontrol run sslcertck digunakan, fetchmail malah akan dibatalkan jika salah satu dari ini
pemeriksaan gagal, karena harus mengasumsikan bahwa ada serangan man-in-the-middle dalam hal ini
skenario, maka fetchmail tidak boleh mengekspos kata sandi cleartext. Penggunaan sslcertck atau
opsi --sslcertck oleh karena itu disarankan.

Beberapa server terenkripsi SSL mungkin meminta sertifikat sisi klien. Publik sisi klien
Sertifikat SSL dan kunci SSL pribadi dapat ditentukan. Jika diminta oleh server,
sertifikat klien dikirim ke server untuk validasi. Beberapa server mungkin memerlukan yang valid
sertifikat klien dan dapat menolak koneksi jika sertifikat tidak diberikan atau jika
sertifikat tidak valid. Beberapa server mungkin memerlukan sertifikat sisi klien ditandatangani oleh
Otoritas Sertifikasi yang diakui. Format untuk file kunci dan file sertifikat
adalah yang diperlukan oleh pustaka SSL yang mendasarinya (OpenSSL dalam kasus umum).

Perhatian tentang penggunaan SSL: Sementara pengaturan yang disebutkan di atas dengan server yang ditandatangani sendiri
sertifikat yang diambil melalui kabel dapat melindungi Anda dari penyadap pasif, itu
tidak membantu melawan penyerang aktif. Ini jelas merupakan peningkatan daripada mengirim
kata sandi jelas, tetapi Anda harus menyadari bahwa serangan man-in-the-middle sepele
mungkin (khususnya dengan alat seperti dsniffhttp://monkey.org/~dugsong/dsniff/, ).
Penggunaan pemeriksaan sertifikat yang ketat dengan otoritas sertifikasi yang diakui oleh server dan
klien, atau mungkin terowongan SSH (lihat di bawah untuk beberapa contoh) lebih disukai jika Anda
sangat peduli dengan keamanan kotak surat dan kata sandi Anda.

ESMTP AUT
ambil surat juga mendukung otentikasi ke server ESMTP di sisi klien sesuai dengan
RFC 2554. Anda dapat menentukan pasangan nama/sandi yang akan digunakan dengan kata kunci 'esmtpname'
dan 'esmtppassword'; yang pertama default ke nama pengguna dari pengguna yang menelepon.

DAEMON MODE

Introducing itu daemon mode
Dalam mode daemon, ambil surat menempatkan dirinya di latar belakang dan berjalan selamanya, menanyakan masing-masing
host tertentu dan kemudian tidur untuk interval polling tertentu.

Mulai itu daemon mode
Ada beberapa cara untuk membuat fetchmail berfungsi dalam mode daemon. Di baris perintah,
--daemon or -d opsi berjalan ambil surat dalam mode daemon. Kamu harus
tentukan argumen numerik yang merupakan interval polling (waktu menunggu setelah menyelesaikan a
seluruh siklus polling dengan server terakhir dan sebelum memulai siklus polling berikutnya dengan
server pertama) dalam hitungan detik.

Contoh: hanya memanggil

ambilmail -d 900

oleh karena itu, akan melakukan polling pada semua host yang dijelaskan dalam ~/.fetchmailrc file (kecuali yang
secara eksplisit dikecualikan dengan kata kerja 'lewati') sedikit lebih jarang dari sekali setiap 15 menit
(tepatnya: 15 menit + waktu yang dibutuhkan polling).

Anda juga dapat mengatur interval polling di ~/.fetchmailrc file dengan mengatakan
'set dasmon ', di mana adalah bilangan bulat detik. Jika kamu melakukan
ini, fetchmail akan selalu dimulai dalam mode daemon kecuali jika Anda menimpanya dengan perintah-
opsi baris --daemon 0 atau -d0.

Hanya satu proses daemon yang diizinkan per pengguna; dalam mode daemon, ambil surat menyiapkan per-
lockfile pengguna untuk menjamin ini. (Namun Anda dapat menipu dan mengatur FETCHMAILHOME
variabel lingkungan untuk mengatasi pengaturan ini, tetapi dalam hal ini, itu adalah tanggung jawab Anda
untuk memastikan Anda tidak melakukan polling pada server yang sama dengan dua proses secara bersamaan.)

Bangun itu latar belakang daemon
Biasanya, memanggil fetchmail dengan daemon di latar belakang mengirimkan sinyal bangun ke
daemon dan berhenti tanpa output. Daemon latar belakang kemudian memulai siklus polling berikutnya
langsung. Sinyal bangun, SIGUSR1, juga dapat dikirim secara manual. Aksi bangun tidur
juga menghapus tanda 'terjepit' yang menunjukkan bahwa koneksi terjepit karena gagal
otentikasi atau beberapa timeout.

Mengakhiri itu latar belakang daemon
Pilihan --berhenti akan mematikan proses daemon yang sedang berjalan alih-alih membangunkannya (jika ada
tidak ada proses seperti itu, ambil surat akan memberi tahu Anda). Jika opsi --quit muncul terakhir di
garis komando, ambil surat akan mematikan proses daemon yang sedang berjalan dan kemudian berhenti. Sebaliknya,
ambil surat pertama-tama akan mematikan proses daemon yang sedang berjalan dan kemudian melanjutkan berjalan dengan
pilihan lain.

Berguna Pilihan untuk daemon mode
The -L or --file log opsi (kata kunci: set logfile) hanya efektif
ketika fetchmail terlepas dan dalam mode daemon. Perhatikan bahwa itu file log harus ada sebelum
fetchmail dijalankan, Anda dapat menggunakan menyentuh(1) perintah dengan nama file sebagai satu-satunya argumen
untuk membuatnya.
Opsi ini memungkinkan Anda untuk mengalihkan pesan status ke file log yang ditentukan (ikuti
opsi dengan nama file log). File log dibuka untuk ditambahkan, jadi pesan sebelumnya
tidak dihapus. Ini terutama berguna untuk men-debug konfigurasi. Perhatikan bahwa
fetchmail tidak mendeteksi jika file log diputar, file log hanya dibuka sekali ketika
fetchmail dimulai. Anda perlu memulai ulang fetchmail setelah memutar file log dan sebelumnya
mengompresinya (jika ada).

The --syslog opsi (kata kunci: set syslog) memungkinkan Anda untuk mengalihkan status dan pesan kesalahan
dipancarkan ke syslog(3) daemon sistem jika tersedia. Pesan dicatat dengan id dari
ambil surat, fasilitas LOG_MAIL, dan prioritas LOG_ERR, LOG_ALERT or LOG_INFO. Ini
opsi ini dimaksudkan untuk mencatat status dan pesan kesalahan yang menunjukkan status
daemon dan hasilnya saat mengambil email dari server. Pesan kesalahan untuk perintah
opsi baris dan menguraikan .fetchmailrc file masih ditulis ke stderr, atau ke
file log yang ditentukan. NS --nosyslog opsi mematikan penggunaan syslog(3), dengan asumsi itu
dihidupkan di ~/.fetchmailrc mengajukan. Opsi ini ditimpa, dalam situasi tertentu,
by --file log (yang melihat).

The -N or --nodetach opsi menekan latar belakang dan detasemen proses daemon
dari terminal kontrolnya. Ini berguna untuk debugging atau ketika fetchmail dijalankan sebagai
anak dari proses pengawas seperti init(8) atau Gerrit Pape's menjalankannya(8). Perhatikan bahwa ini
juga menyebabkan opsi logfile diabaikan.

Perhatikan bahwa saat menjalankan dalam mode daemon polling server POP2 atau IMAP2bis, kesalahan sementara
(seperti kegagalan DNS atau penolakan pengiriman sendmail) dapat memaksa opsi fetchall aktif untuk
durasi siklus pemungutan suara berikutnya. Ini adalah fitur ketahanan. Artinya jika
pesan diambil (dan dengan demikian ditandai terlihat oleh server surat) tetapi tidak dikirim secara lokal karena
untuk beberapa kesalahan sementara, itu akan diambil kembali selama siklus jajak pendapat berikutnya. (IMAP
logika tidak menghapus pesan sampai terkirim, jadi masalah ini tidak muncul.)

Jika Anda menyentuh atau mengubah ~/.fetchmailrc file saat fetchmail berjalan dalam mode daemon,
ini akan terdeteksi pada awal siklus polling berikutnya. Ketika berubah
~/.fetchmailrc terdeteksi, fetchmail membacanya ulang dan memulai ulang dari awal (menggunakan eksekutif(2);
tidak ada informasi status yang disimpan dalam instance baru). Perhatikan bahwa jika fetchmail perlu
permintaan kata sandi, itu jika Anda melanggar ~/.fetchmailrc sintaks file, yang baru
instance akan dengan lembut dan diam-diam menghilang saat startup.

ADMINISTRASI PILIHAN

The --kepala kantor pos option (kata kunci: set postmaster) menentukan pilihan terakhir
nama pengguna ke mana email multidrop akan diteruskan jika tidak ada penerima lokal yang cocok dapat
ditemukan. Ini juga digunakan sebagai tujuan email yang tidak terkirim jika 'bouncemail' global
opsi tidak aktif dan tambahan untuk email yang diblokir spam jika opsi global 'bouncemail' adalah
mati dan opsi global 'spamounce' aktif. Opsi ini default ke pengguna yang dipanggil
ambil surat. Jika pengguna yang memanggil adalah root, maka default opsi ini adalah pengguna
'kepala kantor pos'. Mengatur postmaster ke string kosong menyebabkan email seperti yang dijelaskan di atas
untuk dibuang - namun ini biasanya merupakan ide yang buruk. Lihat juga deskripsi
Variabel lingkungan 'FETCHMAILUSER' di bagian LINGKUNGAN di bawah.

The --tidak memantul berperilaku seperti opsi global "set no bouncemail", yang melihat.

The --tak terlihat option (kata kunci: set tidak terlihat) mencoba membuat fetchmail tidak terlihat.
Biasanya, fetchmail berperilaku seperti MTA lainnya -- ini menghasilkan header Received
ke dalam setiap pesan yang menjelaskan tempatnya dalam rantai transmisi, dan memberitahu MTA itu
meneruskan bahwa email tersebut berasal dari mesin yang sedang dijalankan oleh fetchmail itu sendiri. jika
opsi tak terlihat aktif, header Received ditekan dan fetchmail mencoba memalsukan
MTA meneruskannya ke dalam pemikiran bahwa itu datang langsung dari host server surat.

The --titik pertunjukan opsi (kata kunci: set showdots) memaksa fetchmail untuk menunjukkan titik-titik kemajuan secara merata
jika output masuk ke file atau fetchmail tidak dalam mode verbose. Fetchmail menunjukkan
titik secara default saat dijalankan dalam mode --verbose dan output masuk ke konsol. Pilihan ini adalah
diabaikan dalam mode --silent.

Dengan menentukan --tracepoll pilihan, Anda dapat meminta fetchmail untuk menambahkan informasi ke
Menerima header pada formulir "polling {label} akun {user}", di mana {label} adalah akunnya
label (dari rcfile yang ditentukan, biasanya ~/.fetchmailrc) dan {user} adalah nama pengguna
yang digunakan untuk masuk ke server email. Header ini bisa digunakan untuk membuat filtering
email di mana tidak ada informasi header yang berguna tersedia dan Anda ingin email dari yang berbeda
akun yang diurutkan ke dalam kotak surat yang berbeda (ini dapat, misalnya, terjadi jika Anda memiliki
akun di server yang sama menjalankan milis, dan berlangganan ke daftar menggunakan
akun itu). Standarnya tidak menambahkan tajuk seperti itu. Di dalam .fetchmailrc, ini disebut
'tracepoll'.

PENGEMBALIAN KEGAGALAN MODE

Protokol-protokolnya ambil surat penggunaan untuk berbicara dengan server surat ada di sebelah antipeluru. dalam keadaan normal
penerusan operasi ke port 25, tidak ada pesan yang pernah dihapus (atau bahkan ditandai untuk dihapus)
di host sampai pendengar SMTP di sisi klien telah mengakui untuk ambil surat bahwa
pesan telah diterima untuk dikirim atau ditolak karena blok spam.

Namun, saat meneruskan ke MDA, ada lebih banyak kemungkinan kesalahan. Beberapa MDA adalah:
'aman' dan dengan andal mengembalikan status bukan nol pada kesalahan pengiriman apa pun, bahkan karena
batasan sumber daya sementara. NS kiriman surat(1) programnya seperti ini; begitu juga sebagian besar program
dirancang sebagai agen transportasi surat, seperti: kirim email(1), termasuk pembungkus sendmail dari
Postfix dan exim(1). Program-program ini memberikan kembali pengakuan positif yang dapat diandalkan dan dapat
digunakan dengan opsi mda tanpa risiko kehilangan email. MDA yang tidak aman, bagaimanapun, dapat mengembalikan 0
bahkan pada kegagalan pengiriman. Jika ini terjadi, Anda akan kehilangan email.

Modus normal dari ambil surat adalah mencoba mengunduh hanya pesan 'baru', tanpa tersentuh
(dan tidak terhapus) pesan yang telah Anda baca langsung di server (atau diambil dengan
sebelumnya ambil surat --menyimpan). Tetapi Anda mungkin menemukan pesan yang sudah Anda baca di
server sedang diambil (dan dihapus) bahkan ketika Anda tidak menentukan --all. Ada
beberapa alasan hal ini bisa terjadi.

Salah satunya bisa jadi Anda menggunakan POP2. Protokol POP2 tidak menyertakan representasi dari
status 'baru' atau 'lama' dalam pesan, jadi ambil surat harus memperlakukan semua pesan seperti baru semua
waktu. Tapi POP2 sudah usang, jadi ini tidak mungkin.

Masalah POP3 potensial mungkin adalah server yang menyisipkan pesan di tengah kotak surat
(beberapa implementasi surat VMS dikabarkan melakukan ini). NS ambil surat kode mengasumsikan
bahwa pesan baru ditambahkan ke akhir kotak surat; ketika ini tidak benar mungkin
memperlakukan beberapa pesan lama sebagai baru dan sebaliknya. Menggunakan UIDL saat mengatur fastuidl 0 mungkin
perbaiki ini, jika tidak, pertimbangkan untuk beralih ke IMAP.

Namun masalah POP3 lainnya adalah jika mereka tidak dapat membuat file temp di rumah pengguna
direktori, beberapa server POP3 akan mengembalikan respons tidak berdokumen yang menyebabkan fetchmail
untuk melaporkan secara palsu "Tidak ada surat".

Kode IMAP menggunakan ada atau tidaknya flag server \Seen untuk memutuskan apakah atau
bukan pesan yang baru. Ini bukan hal yang benar untuk dilakukan, fetchmail harus memeriksa
UIDVALIDITY dan gunakan UID, tetapi belum melakukannya. Di bawah Unix, ini mengandalkan IMAP Anda
server untuk memperhatikan tanda Status gaya BSD yang ditetapkan oleh agen pengguna email dan mengatur tanda \Seen
dari mereka bila perlu. Semua server IMAP Unix yang kami tahu melakukan ini, meskipun tidak
ditentukan oleh RFC IMAP. Jika Anda pernah tersandung server yang tidak, gejalanya akan
bahwa pesan yang telah Anda baca di host Anda akan terlihat baru di server. Di dalam
(tidak mungkin), hanya pesan yang Anda ambil ambil surat --menyimpan keduanya akan terhapus
dan ditandai tua.

Dalam mode ETRN dan ODMR, ambil surat tidak benar-benar mengambil pesan; sebagai gantinya, ia bertanya
pendengar SMTP server untuk memulai flush antrian ke klien melalui SMTP. Oleh karena itu
hanya mengirim pesan yang tidak terkirim.

SPAM PENYARINGAN

Banyak pendengar SMTP memungkinkan administrator untuk mengatur 'filter spam' yang memblokir yang tidak diminta
email dari domain tertentu. Sebuah MAIL FROM atau DATA line yang memicu fitur ini akan
mendapatkan respons SMTP yang (sayangnya) bervariasi menurut pendengarnya.

Versi terbaru dari kirim email mengembalikan kode kesalahan 571.

Menurut RFC2821, hal yang benar untuk dikembalikan dalam situasi ini adalah 550 "Diminta
tindakan tidak diambil: kotak surat tidak tersedia" (draf menambahkan "[Misalnya, kotak surat tidak ditemukan, tidak
akses, atau perintah ditolak karena alasan kebijakan].").

Versi lama dari exim MTA mengembalikan 501 "Kesalahan sintaks dalam parameter atau argumen".

The postfix MTA menjalankan 554 sebagai respons antispam.

pengirim email dapat menolak kode dengan respons 500 (diikuti dengan kode status yang ditingkatkan yang
berisi lebih banyak informasi).

Kembalikan kode yang ambil surat memperlakukan sebagai tanggapan antispam dan membuang pesan dapat
atur dengan opsi 'antispam'. Ini adalah salah satu hanya tiga keadaan di mana
fetchmail pernah membuang email (yang lainnya adalah kesalahan 552 dan 553 yang dijelaskan di bawah, dan
penekanan pesan multidrop dengan ID pesan yang sudah terlihat).

If ambil surat diambil dari server IMAP, respons antispam akan terdeteksi dan
pesan ditolak segera setelah tajuk diambil, tanpa membaca
Badan Pesan. Dengan demikian, Anda tidak akan membayar untuk mengunduh badan pesan spam.

Secara default, daftar tanggapan antispam kosong.

Jika spam opsi global aktif, email yang diblokir spam memicu dan
Pesan pentalan RFC1892/RFC1894 yang memberi tahu pembuatnya bahwa kami tidak menerima email dari
dia. Lihat juga BUGS.

SMTP/ESMTP ERROR PENANGANAN

Selain pemblokiran spam yang dijelaskan di atas, fetchmail mengambil tindakan khusus — yang mungkin
dimodifikasi oleh opsi --softbounce — pada kode respons kesalahan SMTP/ESMTP berikut

452 (penyimpanan sistem tidak memadai)
Tinggalkan pesan di kotak surat server untuk pengambilan nanti.

552 (pesan melebihi ukuran pesan maksimum tetap)
Hapus pesan dari server. Kirim bouncing-mail ke originator.

553 (domain pengiriman tidak valid)
Hapus pesan dari server. Jangan coba-coba mengirim email bouncing ke
pencipta.

Kesalahan lain yang lebih besar atau sama dengan 500 memicu email pentalan kembali ke pembuatnya, kecuali
ditekan oleh --softbounce. Lihat juga BUGS.

THE MENJALANKAN PENGENDALIAN FILE

Cara yang lebih disukai untuk menyiapkan fetchmail adalah dengan menulis .fetchmailrc arsip di rumah Anda
direktori (Anda dapat melakukannya secara langsung, dengan editor teks, atau secara tidak langsung melalui ambilmailconf).
Ketika ada konflik antara argumen baris perintah dan argumen dalam ini
file, argumen baris perintah diutamakan.

Untuk melindungi keamanan kata sandi Anda, Anda ~/.fetchmailrc biasanya tidak memiliki lebih banyak
dari 0700 (u=rwx,g=,o=) izin; ambil surat akan mengeluh dan keluar sebaliknya (ini
cek ditekan ketika --version aktif).

Anda dapat membaca .fetchmailrc file sebagai daftar perintah yang akan dieksekusi ketika ambil surat is
dipanggil tanpa argumen.

Run kontrol Sintaksis
Komentar dimulai dengan '#' dan diperpanjang hingga akhir baris. Jika tidak, file
terdiri dari serangkaian entri server atau pernyataan opsi global dalam format bebas,
sintaks berorientasi token.

Ada empat jenis token: kata kunci tata bahasa, angka (yaitu urutan digit desimal),
string yang tidak dikutip, dan string yang dikutip. String yang dikutip dibatasi oleh tanda kutip ganda dan mungkin
berisi spasi (dan angka yang dikutip diperlakukan sebagai string). Perhatikan bahwa string yang dikutip
juga akan berisi karakter umpan baris jika mereka berjalan melintasi dua atau lebih baris, kecuali jika Anda
gunakan garis miring terbalik untuk menggabungkan garis (lihat di bawah). String yang tidak dikutip adalah apa pun yang dibatasi spasi
token yang bukan numerik, string yang dikutip atau berisi karakter khusus ',', ';',
':', atau '='.

Jumlah spasi putih apa pun memisahkan token dalam entri server, tetapi sebaliknya diabaikan. Anda
dapat menggunakan urutan escape backslash (\n untuk LF, \t untuk HT, \b untuk BS, \r untuk CR, \nnn untuk
desimal (di mana nnn tidak dapat dimulai dengan 0), \0ooo untuk oktal, dan \xhh untuk hex) untuk disematkan
karakter yang tidak dapat dicetak atau pembatas string dalam string. Dalam string yang dikutip, garis miring terbalik
di akhir baris akan menyebabkan garis miring terbalik itu sendiri dan umpan baris (LF atau NL, baru
baris) karakter untuk diabaikan, sehingga Anda dapat membungkus string panjang. Tanpa garis miring terbalik di
akhir baris, karakter umpan baris akan menjadi bagian dari string.

Peringatan: sementara ini menyerupai urutan pelarian gaya-C, mereka tidak sama. ambil surat
hanya mendukung delapan gaya ini. C mendukung lebih banyak urutan pelarian yang terdiri dari
garis miring terbalik (\) dan satu karakter, tetapi tidak mendukung kode desimal dan tidak
membutuhkan 0 terkemuka dalam notasi oktal. Contoh: fetchmail mengartikan \233 sama dengan
\xE9 (huruf kecil Latin e dengan akut), di mana C akan menafsirkan \233 sebagai oktal 0233 = \x9B
(CSI, pengenalan urutan kontrol).

Setiap entri server terdiri dari salah satu kata kunci 'jajak pendapat' atau 'lewati', diikuti oleh server
nama, diikuti oleh opsi server, diikuti oleh sejumlah pengguna (atau nama pengguna)
deskripsi, diikuti oleh opsi pengguna. Catatan: penyebab paling umum dari kesalahan sintaks adalah
mencampur opsi pengguna dan server atau menempatkan opsi pengguna sebelum deskripsi pengguna.

Untuk kompatibilitas mundur, kata 'server' adalah sinonim untuk 'jajak pendapat'.

Anda dapat menggunakan kata kunci noise 'dan', 'dengan', 'memiliki', 'keinginan', dan 'opsi' di mana saja dalam
entri untuk membuatnya menyerupai bahasa Inggris. Mereka diabaikan, tetapi dapat membuat entri lebih mudah
untuk membaca sekilas. Karakter tanda baca ':', ';' dan ',' juga diabaikan.

Pemilihan vs Melewatkan
Kata kerja 'jajak pendapat' memberitahu fetchmail untuk menanyakan host ini saat dijalankan tanpa argumen. NS
'lewati' kata kerja memberitahu ambil surat untuk tidak melakukan polling pada host ini kecuali jika disebutkan secara eksplisit di
garis komando. (Kata kerja 'lewati' memungkinkan Anda bereksperimen dengan entri tes dengan aman, atau
dengan mudah menonaktifkan entri untuk host yang sementara tidak aktif.)

Kata Kunci/Opsi Ringkasan
Berikut adalah opsi hukum. Sufiks kata kunci yang diapit tanda kurung siku adalah opsional.
Yang sesuai dengan opsi baris perintah pendek diikuti oleh '-' dan yang sesuai
surat pilihan. Jika opsi hanya relevan untuk satu mode operasi, ini dicatat sebagai:
's' atau 'm' masing-masing untuk mode singledrop atau multidrop.

Berikut adalah opsi global legal:

Fungsi Mode Pilihan Kata Kunci
────────────────────────────────────────────────── ──────────────────
set daemon -d Atur interval polling latar belakang di
detik.
set postmaster Beri nama resor terakhir
penerima email (default: pengguna
menjalankan fetchmail, "postmaster" jika
dijalankan oleh pengguna root)
setel bouncemail Direct error mail ke pengirim
(Default)
atur tanpa bouncingmail Arahkan email kesalahan ke lokal
kepala pos (sesuai dengan
opsi global 'postmaster' di atas).
atur tanpa spambounce Jangan memantulkan email yang diblokir spam
(bawaan).
atur spambounce Bounce diblokir email yang diblokir spam
(sesuai pengguna 'antispam'
pilihan) kembali ke tujuan sebagai
ditunjukkan oleh 'bouncemail'
pilihan global. Peringatan: Jangan
gunakan ini untuk memantulkan spam kembali ke
pengirim - sebagian besar spam terkirim
dengan alamat pengirim palsu dan karenanya
opsi ini menyakitkan tidak bersalah
pengamat.
set no softbounce Hapus permanen tidak terkirim
surat. Disarankan untuk menggunakan
opsi ini jika konfigurasi
telah diuji secara menyeluruh.
atur softbounce Tetap tidak terkirim secara permanen
email seolah-olah kesalahan sementara
telah terjadi (default).
set logfile -L Nama file untuk menambahkan kesalahan dan
pesan status ke. Hanya
efektif dalam mode daemon dan jika
fetchmail terlepas. Jika efektif,
menimpa set syslog.
set idfile -i Nama file untuk menyimpan UID
daftar di.
set syslog Lakukan kesalahan saat masuk
syslog(3). Mungkin ditimpa oleh set
file log.

set no syslog Matikan kesalahan saat masuk
syslog(3). (bawaan)
atur properti Nilai string yang diabaikan oleh
fetchmail (dapat digunakan oleh
skrip ekstensi).

Berikut adalah opsi server legal:

Fungsi Mode Pilihan Kata Kunci
────────────────────────────────────────────────── ───────────────
melalui Tentukan nama DNS server surat,
menimpa nama polling
proto[col] -p Tentukan protokol (case
tidak sensitif): POP2, POP3, IMAP,
APOP, KPOP
local[domains] m Tentukan domain yang akan dipertimbangkan
sebagai lokal
port Tentukan port layanan TCP/IP
(usang, gunakan 'layanan' sebagai gantinya).
service -P Tentukan nama layanan (angka
nilai juga diperbolehkan dan
dianggap sebagai nomor port TCP/IP).
auth[enticate] Setel jenis otentikasi (default
'setiap')
batas waktu -t Server tidak aktif batas waktu masuk
detik (default 300)
amplop -E m Tentukan header alamat amplop
nama
tidak ada amplop m Nonaktifkan mencari amplop
alamat
qvirtual -Q m Qmail awalan domain virtual ke
hapus dari nama pengguna
alias m Tentukan nama DNS alternatif dari
server surat
interface -Saya menentukan antarmuka IP yang harus
siap untuk jajak pendapat server untuk diambil
tempat
monitor -M Tentukan alamat IP yang akan dipantau
kegiatan
plugin Tentukan perintah untuk
membuat koneksi server.
plugout Tentukan perintah yang akan digunakan untuk
membuat koneksi pendengar.
dns m Aktifkan pencarian DNS untuk multidrop
(Default)
no dns m Nonaktifkan pencarian DNS untuk multidrop
checkalias m Lakukan perbandingan berdasarkan alamat IP untuk
banyak titik
tidak ada checkalias m Lakukan perbandingan berdasarkan nama untuk
multi-tetesan (default)
uidl -U Paksa POP3 untuk menggunakan sisi klien
UIDL (disarankan)
no uidl Matikan penggunaan POP3 dari sisi klien
UIDL (default)
interval Hanya periksa situs ini setiap N poll
siklus; N adalah argumen numerik.
tracepolls Tambahkan informasi penelusuran polling ke
header yang diterima
pokok Set pokok Kerberos (hanya
berguna dengan IMAP dan kerberos)
esmtpname Setel nama untuk RFC2554
otentikasi ke ESMTP
Server.
esmtppassword Setel kata sandi untuk RFC2554
otentikasi ke ESMTP
Server.

bad-header Bagaimana memperlakukan pesan dengan buruk
kepala. Dapat ditolak (default) atau
menerima.

Berikut adalah deskripsi dan opsi pengguna legal:

Fungsi Mode Pilihan Kata Kunci
────────────────────────────────────────────────── ─────────────────
user[name] -u Ini adalah deskripsi pengguna dan
harus didahulukan setelah server
deskripsi dan setelah mungkin
opsi server, dan sebelum pengguna
Pilihan.
Ini menetapkan nama pengguna jarak jauh jika dengan
sendiri atau diikuti oleh 'di sana', atau
nama pengguna lokal jika diikuti oleh
'di sini'.
adalah Hubungkan pengguna lokal dan jarak jauh
nama
untuk Menghubungkan pengguna lokal dan jarak jauh
nama
pass[word] Tentukan kata sandi akun jarak jauh
ssl Hubungkan ke server melalui
protokol dasar yang ditentukan menggunakan SSL
enkripsi
sslcert Tentukan file untuk klien sisi
sertifikat SSL publik
sslcertfile Tentukan file dengan CA tepercaya
sertifikat
sslcertpath Tentukan direktori c_rehash-ed dengan
sertifikat CA tepercaya.
sslkey Tentukan file untuk klien sisi
kunci SSL pribadi
sslproto Paksa protokol ssl untuk koneksi
folder -r Tentukan folder jarak jauh untuk kueri
smtphost -S Tentukan host smtp untuk diteruskan
fetchdomains m Tentukan domain untuk email mana
harus diambil
smtpaddress -D Tentukan domain yang akan dimasukkan
RCPT KE jalur
smtpname Tentukan pengguna dan domain yang akan
masukkan ke baris RCPT TO
antispam -Z Tentukan apa pengembalian SMTP
ditafsirkan sebagai blok kebijakan spam
mda -m Tentukan MDA untuk pengiriman lokal
bsmtp -o Tentukan file batch BSMTP untuk ditambahkan
untuk
Perintah preconnect yang akan dieksekusi sebelum masing-masing
koneksi
Perintah postconnect yang akan dieksekusi setelah setiap
koneksi
keep -k Jangan hapus pesan yang terlihat dari
server (untuk POP3, uidl adalah
direkomendasikan)
flush -F Hapus semua pesan yang terlihat sebelumnya
kueri (BERBAHAYA)
limitflush Siram semua pesan yang terlalu besar
sebelum bertanya
fetchall -a Ambil semua pesan baik dilihat atau
tidak
tulis ulang Tulis ulang alamat tujuan untuk
balas (bawaan)
stripcr Kereta strip kembali dari ujung
dari garis
forcecr Kereta paksa kembali di ujung
baris

pass8bits Paksa BODY=8BITMIME ke ESMTP
pendengar
dropstatus Status Strip dan X-Mozilla-Status
baris keluar dari surat masuk
dropdelivered Strip Disampaikan-Ke jalur keluar dari
email masuk
mimedecode Ubah kutipan-dapat dicetak menjadi 8-bit
dalam pesan MIME
menganggur Idle menunggu pesan baru
setelah setiap jajak pendapat (hanya IMAP)
no keep -K Hapus pesan yang terlihat dari server
(Default)
no flush Jangan hapus semua pesan yang terlihat
sebelum menanyakan (default)
no fetchall Ambil hanya pesan baru
(Default)
tidak menulis ulang Jangan menulis ulang header
tidak ada stripcr Jangan strip kembali carriage
(Default)
no forcecr Jangan paksa carriage return at
EOL (bawaan)
tidak ada pass8bits Jangan paksa BODY=8BITMIME ke ESMTP
pendengar (bawaan)
tidak ada dropstatus Jangan jatuhkan tajuk Status
(Default)
tidak ada dropdelivered Jangan jatuhkan header Delivered-To
(Default)
no mimedecode Jangan ubah kutipan-dapat dicetak ke
8-bit dalam pesan MIME (default)
tidak menganggur Jangan menganggur menunggu yang baru
pesan setelah setiap polling (IMAP
saja)
limit -l Setel batas ukuran pesan
warnings -w Atur interval peringatan ukuran pesan
batchlimit -b Maks # pesan untuk diteruskan
koneksi tunggal
fetchlimit -B Maks # pesan untuk diambil secara tunggal
menghubungkan
fetchsizelimit Maks # ukuran pesan untuk diambil
transaksi tunggal
fastuidl Gunakan pencarian biner untuk yang pertama tidak terlihat
pesan (hanya POP3)
hapus -e Lakukan penghapusan pada setiap #th
pesan (hanya IMAP dan POP3)
properties Nilai string diabaikan oleh
fetchmail (dapat digunakan oleh
skrip ekstensi)

Semua opsi pengguna harus dimulai dengan deskripsi pengguna (opsi pengguna atau nama pengguna) dan mengikuti
semua deskripsi dan opsi server.

Dalam file .fetchmailrc, argumen string 'amplop' dapat didahului dengan spasi-
nomor terpisah. Nomor ini, jika ditentukan, adalah jumlah header yang harus dilewati
(yaitu, argumen 1 memilih header kedua dari tipe yang diberikan). Ini kadang-kadang
berguna untuk mengabaikan header amplop palsu yang dibuat oleh agen pengiriman lokal ISP atau
penerusan internal (melalui sistem pemeriksaan surat, misalnya).

Kata kunci Tidak Sesuai Untuk pilihan Switch
Opsi 'folder' dan 'smtphost' (tidak seperti baris perintah yang setara) dapat mengambil
daftar nama yang dipisahkan spasi atau koma setelahnya.

Semua opsi sesuai dengan argumen baris perintah yang jelas, kecuali yang berikut: 'via',
'interval', 'alias', 'is', 'ke', 'dns'/'no dns', 'checkalias'/'no checkalias', 'password',
'preconnect', 'postconnect', 'localdomains', 'stripcr'/'no stripcr', 'forcecr'/'no
forcecr', 'pass8bits'/'tidak ada pass8bits' 'dropstatus/tidak ada dropstatus', 'dropdelivered/tidak
dropdelivered', 'mimedecode/no mimedecode', 'no idle', dan 'no envelope'.

Opsi 'via' adalah jika Anda ingin memiliki lebih dari satu konfigurasi yang mengarah ke
situs yang sama. Jika ada, argumen string akan dianggap sebagai nama DNS sebenarnya dari
host server surat untuk melakukan kueri. Ini akan mengesampingkan argumen polling, yang kemudian dapat
cukup menjadi label yang berbeda untuk konfigurasi (misalnya apa yang akan Anda berikan pada perintah
baris untuk secara eksplisit menanyakan Host ini).

Opsi 'interval' (yang menggunakan argumen numerik) memungkinkan Anda untuk melakukan polling server lebih sedikit
sering daripada interval polling dasar. Jika Anda mengatakan 'interval N' server opsi ini
dilampirkan hanya akan ditanyakan setiap N interval polling.

Tetesan tunggal vs banyak titik Pilihan
Pastikan Anda membaca bagian berjudul THE GUNAKAN DAN PENYALAHGUNAAN OF BERGANDA KOTAK SURAT jika Anda
berniat untuk menggunakan mode multidrop.

Kata kunci 'is' atau 'to' mengaitkan nama lokal (klien) (atau nama server) berikut
ke pemetaan nama klien yang dipisahkan oleh =) dengan nama pengguna server surat di entri. Jika
is/to list memiliki '*' sebagai nama belakangnya, nama yang tidak dikenal hanya dilewatkan. Catatan
itu sampai ambil surat versi 6.3.4 secara inklusif, daftar ini hanya dapat berisi bagian lokal
nama pengguna (fetchmail hanya akan melihat bagian sebelum tanda @). ambil surat
versi 6.3.5 dan yang lebih baru mendukung alamat lengkap di sisi kiri pemetaan ini,
dan mereka lebih diutamakan daripada pemetaan 'localdomains', 'alias', 'via' atau yang serupa.

Satu nama lokal dapat digunakan untuk mendukung pengalihan email Anda saat nama pengguna Anda di
mesin klien berbeda dari nama Anda di server surat. Ketika hanya ada satu
nama lokal, email diteruskan ke nama pengguna lokal terlepas dari pesan Diterima,
Header To, Cc, dan Bcc. Pada kasus ini, ambil surat tidak pernah melakukan pencarian DNS.

Bila ada lebih dari satu nama lokal (atau pemetaan nama), ambil surat melihat amplop
header, jika dikonfigurasi, dan sebaliknya pada header Received, To, Cc, dan Bcc dari yang diambil
mail (ini adalah 'mode multidrop'). Itu mencari alamat dengan bagian nama host yang cocok
nama jajak pendapat Anda atau opsi 'via', 'alias' atau 'domain lokal' Anda, dan biasanya juga untuk
bagian hostname yang DNS memberitahu itu adalah alias dari server surat. Lihat pembahasan
'dns', 'checkalias', 'localdomains', dan 'alias' untuk detail tentang kecocokan alamat
ditangani.

If ambil surat tidak dapat cocok dengan nama pengguna server surat atau alamat domain lokal, email akan
terpental. Biasanya akan terpental ke pengirim, tetapi jika 'bouncemail' global
opsi tidak aktif, email akan dikirim ke kepala pos lokal sebagai gantinya. (lihat 'kepala pos'
pilihan global). Lihat juga BUGS.

Opsi 'dns' (biasanya aktif) mengontrol cara alamat dari kotak surat multidrop
diperiksa. Aktif, ini memungkinkan logika untuk memeriksa setiap alamat host yang tidak cocok dengan 'alias' atau
deklarasi 'localdomains' dengan mencarinya dengan DNS. Ketika nama pengguna server surat adalah
dikenali dilampirkan ke bagian nama host yang cocok, pemetaan lokalnya ditambahkan ke daftar
penerima lokal.

Opsi 'checkalias' (biasanya tidak aktif) memperluas pencarian yang dilakukan oleh kata kunci 'dns'
dalam mode multidrop, menyediakan cara untuk mengatasi MTA jarak jauh yang mengidentifikasi diri mereka menggunakan
nama kanonik mereka, sementara mereka disurvei menggunakan alias. Ketika server seperti itu disurvei,
pemeriksaan untuk mengekstrak alamat amplop gagal, dan ambil surat kembali ke pengiriman menggunakan
Header Ke/Cc/Bcc (Lihat di bawah 'Alamat Header vs. Envelope'). Menentukan opsi ini
menginstruksikan ambil surat untuk mengambil semua alamat IP yang terkait dengan kedua nama polling
dan nama yang digunakan oleh MTA jarak jauh dan untuk melakukan perbandingan alamat IP. Ini
sangat berguna dalam situasi di mana server jarak jauh sering mengalami nama kanonik
perubahan, yang jika tidak memerlukan modifikasi pada rcfile. 'checkalias' tidak memiliki
efek jika 'tidak ada dns' ditentukan dalam rcfile.

Opsi 'alias' digunakan dengan kotak surat multidrop. Ini memungkinkan Anda untuk mendeklarasikan daftar sebelumnya
alias DNS untuk server. Ini adalah peretasan pengoptimalan yang memungkinkan Anda menukar ruang
untuk kecepatan. Kapan ambil surat, saat memproses kotak surat multidrop, merendahkan melalui pesan
tajuk mencari nama server surat, yang menyatakan sebelumnya yang umum dapat menyimpannya dari
harus melakukan pencarian DNS. Catatan: nama yang Anda berikan sebagai argumen untuk 'alias' cocok sebagai
sufiks -- jika Anda menentukan (katakanlah) 'alias netaxs.com', ini tidak hanya cocok dengan nama host
netaxs.com, tetapi nama host apa pun yang diakhiri dengan '.netaxs.com'; seperti (katakanlah) pop3.netaxs.com
dan mail.netaxs.com.

Opsi 'localdomains' memungkinkan Anda untuk mendeklarasikan daftar domain yang harus diambil oleh fetchmail
pertimbangkan lokal. Saat fetchmail menguraikan baris alamat dalam mode multidrop, dan a
segmen trailing dari nama host cocok dengan domain lokal yang dideklarasikan, alamat itu diteruskan
melalui ke pendengar atau MDA tidak berubah (pemetaan nama lokal adalah tidak terapan).

Jika Anda menggunakan 'localdomains', Anda mungkin juga perlu menentukan 'tanpa amplop', yang
menonaktifkan ambil suratupaya normal untuk menyimpulkan alamat amplop dari baris Diterima
atau header X-Envelope-To atau header apa pun yang telah ditetapkan sebelumnya oleh 'amplop'. Jika kamu
atur 'tidak ada amplop' di entri default, dimungkinkan untuk membatalkannya di entri individual
dengan menggunakan 'amplop '. Sebagai kasus khusus, 'amplop "Diterima"' mengembalikan
parsing default dari baris yang diterima.

The kata sandi opsi memerlukan argumen string, yang merupakan kata sandi yang akan digunakan dengan
server entri.

Kata kunci 'preconnect' memungkinkan Anda untuk menentukan perintah shell yang akan dieksekusi sebelum
setiap kali ambil surat membuat koneksi server surat. Ini mungkin berguna jika Anda
mencoba mengatur koneksi POP yang aman dengan bantuan ssh(1). Jika perintah
mengembalikan status bukan nol, polling server surat itu akan dibatalkan.

Demikian pula, kata kunci 'postconnect' juga memungkinkan Anda untuk menentukan perintah shell menjadi
dijalankan tepat setelah setiap kali koneksi server surat dimatikan.

Opsi 'forcecr' mengontrol apakah jalur yang diakhiri oleh LF hanya diberikan CRLF
pemutusan sebelum diteruskan. Sebenarnya RFC821 membutuhkan ini, tetapi beberapa MTA
menegakkan persyaratan itu sehingga opsi ini biasanya tidak aktif (hanya satu MTA seperti itu, qmail, yang masuk
penggunaan yang signifikan pada saat penulisan).

Opsi 'stripcr' mengontrol apakah carriage return dihapus dari email yang diambil
sebelum diteruskan. Biasanya tidak perlu mengatur ini, karena defaultnya adalah
'on' (CR stripping diaktifkan) ketika ada MDA yang dideklarasikan tetapi 'off' (CR stripping
dinonaktifkan) saat penerusan melalui SMTP. Jika 'stripcr' dan 'forcecr' keduanya aktif, 'stripcr'
akan menimpa.

Opsi 'pass8bits' ada untuk mengatasi program email Microsoft yang dengan bodohnya menampar
"Konten-Transfer-Encoding: 7bit" dalam segala hal. Dengan opsi ini mati (default) dan
hadiah header seperti itu, ambil surat mendeklarasikan BODY=7BIT ke pendengar berkemampuan ESMTP; ini
menyebabkan masalah untuk pesan yang sebenarnya menggunakan set karakter ISO atau KOI-8 8-bit, yang akan
menjadi kacau dengan memiliki bit tinggi dari semua karakter dilucuti. Jika 'pass8bits' aktif,
ambil surat dipaksa untuk mendeklarasikan BODY=8BITMIME ke pendengar yang mendukung ESMTP. jika
pendengar adalah 8-bit-bersih (seperti semua yang utama sekarang) hal yang benar mungkin akan
hasil.

Opsi 'dropstatus' mengontrol apakah baris Status dan X-Mozilla-Status tidak kosong
dipertahankan dalam surat yang diambil (default) atau dibuang. Mempertahankannya memungkinkan MUA Anda untuk
lihat pesan apa (jika ada) yang ditandai terlihat di server. Di sisi lain, itu bisa
membingungkan beberapa pemberi tahu email baru, yang menganggap bahwa apa pun dengan baris Status di dalamnya memiliki
sudah dilihat. (Catatan: baris Status kosong yang disisipkan oleh beberapa server POP buggy adalah
dibuang tanpa syarat.)

Opsi 'dropdelivered' mengontrol apakah header Delivered-To akan disimpan dalam pengambilan
mail (default) atau dibuang. Header ini ditambahkan oleh server surat Qmail dan Postfix
untuk menghindari pengulangan surat tetapi mungkin menghalangi Anda jika Anda mencoba "mencerminkan" server surat
dalam domain yang sama. Gunakan dengan hati-hati.

Opsi 'mimedecode' mengontrol apakah pesan MIME menggunakan penyandian yang dapat dicetak dikutip
secara otomatis diubah menjadi data 8-bit murni. Jika Anda mengirim email ke ESMTP-
mampu, pendengar bersih 8-bit (yang mencakup semua MTA utama seperti sendmail), lalu
ini akan secara otomatis mengonversi header dan data pesan yang dapat dicetak yang dikutip menjadi data 8-bit,
sehingga lebih mudah dipahami saat membaca surat. Jika program email Anda tahu cara menangani
dengan pesan MIME, maka opsi ini tidak diperlukan. Opsi mimedecode dimatikan oleh
default, karena melakukan konversi RFC2047 pada header membuang informasi kumpulan karakter
dan dapat menyebabkan hasil yang buruk jika penyandian header berbeda dari penyandian isi.

Opsi 'idle' dimaksudkan untuk digunakan dengan server IMAP yang mendukung RFC2177 IDLE
ekstensi perintah, tetapi tidak benar-benar membutuhkannya. Jika diaktifkan, dan fetchmail
mendeteksi bahwa IDLE didukung, IDLE akan dikeluarkan di akhir setiap polling. Ini akan
beri tahu server IMAP untuk menahan koneksi agar tetap terbuka dan memberi tahu klien jika ada email baru
tersedia. Jika IDLE tidak didukung, fetchmail akan mensimulasikannya dengan menerbitkan secara berkala
TIDAK. Jika Anda perlu sering melakukan polling tautan, IDLE dapat menghemat bandwidth dengan menghilangkan TCP/IP
menghubungkan dan urutan LOGIN/LOGOUT. Di sisi lain, koneksi IDLE akan memakan hampir
semua waktu fetchmail Anda, karena tidak akan pernah memutuskan koneksi dan mengizinkan yang lain
jajak pendapat terjadi kecuali waktu server habis IDLE. Ini juga tidak berfungsi dengan banyak
folder; hanya folder pertama yang akan disurvei.

Opsi 'properti' adalah mekanisme ekstensi. Dibutuhkan argumen string, yaitu
diabaikan oleh fetchmail itu sendiri. Argumen string dapat digunakan untuk menyimpan konfigurasi
informasi untuk skrip yang membutuhkannya. Secara khusus, output dari '--configdump'
opsi akan membuat properti yang terkait dengan entri pengguna tersedia untuk Python
Script.

bermacam-macam Run kontrol Opsi
Kata 'di sini' dan 'di sana' memiliki arti penting seperti bahasa Inggris. Biasanya 'user eric
is esr' berarti email untuk pengguna jarak jauh 'eric' akan dikirimkan ke 'esr', tetapi
Anda dapat membuatnya lebih jelas dengan mengatakan 'user eric there is esr here', atau membalikkannya dengan mengatakan
'user esr disini ada eric disana'

Pengidentifikasi protokol hukum untuk digunakan dengan kata kunci 'protokol' adalah:

auto (atau AUTO) (warisan, akan dihapus dari rilis mendatang)
pop2 (atau POP2) (warisan, akan dihapus dari rilis mendatang)
pop3 (atau POP3)
sdps (atau SDPS)
imap (atau IMAP)
apop (atau APOP)
kpop (atau KPOP)

Jenis otentikasi legal adalah 'apa saja', 'sandi', 'kerberos', 'kerberos_v4', 'kerberos_v5'
dan 'gssapi', 'cram-md5', 'otp', 'msn' (hanya untuk POP3), 'ntlm', 'ssh', 'eksternal' (hanya
IMAP). Jenis 'kata sandi' menentukan otentikasi dengan transmisi kata sandi yang normal
(kata sandi mungkin berupa teks biasa atau tunduk pada enkripsi khusus protokol seperti dalam CRAM-
MD5); 'kerberos' menceritakan ambil surat untuk mencoba mendapatkan tiket Kerberos di awal setiap
kueri sebagai gantinya, dan kirim string arbitrer sebagai kata sandi; dan 'gssapi' memberi tahu fetchmail
untuk menggunakan autentikasi GSSAPI. Lihat deskripsi kata kunci 'auth' untuk lebih lanjut.

Menentukan 'kpop' menetapkan protokol POP3 melalui port 1109 dengan otentikasi Kerberos V4.
Default ini dapat ditimpa oleh opsi selanjutnya.

Ada beberapa pernyataan opsi global: 'set logfile' diikuti oleh set string yang sama
global ditentukan oleh --logfile. Opsi --logfile baris perintah akan menimpa ini. Catatan
--logfile itu hanya efektif jika fetchmail melepaskan dirinya dari terminal dan
logfile sudah ada sebelum fetchmail dijalankan, dan menimpa --syslog dalam kasus ini.
Juga, 'set daemon' menyetel interval polling seperti yang dilakukan --daemon. Ini dapat ditimpa oleh
baris perintah --daemon opsi; khususnya --daemon 0 dapat digunakan untuk memaksa latar depan
operasi. Pernyataan 'set postmaster' menetapkan alamat ke mana email multidrop
default jika tidak ada kecocokan lokal. Akhirnya, 'set syslog' mengirim pesan log ke
syslogd(8).

DEBUGING FETCHMAIL

Ambil surat menabrak
Ada berbagai cara agar fetchmail "crash", yaitu menghentikan operasi secara tiba-tiba dan
tiba-tiba. "Kecelakaan" biasanya mengacu pada kondisi kesalahan yang tidak dilakukan oleh perangkat lunak
menangani dengan sendirinya. Mode kegagalan yang terkenal adalah "kesalahan segmentasi" atau "sinyal 11" atau
"SIGSEGV" atau singkatnya "segfault". Ini dapat disebabkan oleh perangkat keras atau perangkat lunak
masalah. Segfault yang diinduksi perangkat lunak biasanya dapat direproduksi dengan mudah dan dengan cara yang sama
tempat, sedangkan segfault yang disebabkan oleh perangkat keras dapat hilang jika komputer di-boot ulang, atau
dimatikan selama beberapa jam, dan dapat terjadi di lokasi acak bahkan jika Anda menggunakan
perangkat lunak dengan cara yang sama.

Untuk memecahkan kesalahan yang disebabkan oleh perangkat keras, temukan komponen yang rusak dan perbaiki atau ganti
dia. FAQ Sig11http://www.bitwizard.nl/sig11/dapat membantu Anda dengan detail.

Untuk memecahkan segfault yang diinduksi perangkat lunak, pengembang mungkin memerlukan "stack backtrace".

Mengaktifkan ambil surat inti kesedihan
Secara default, fetchmail menekan dump inti karena ini mungkin berisi kata sandi dan lainnya
informasi sensitif. Untuk men-debug crash fetchmail, dapatkan "stack backtrace" dari
core dump sering kali merupakan cara tercepat untuk menyelesaikan masalah, dan saat memposting masalah Anda
pada milis, pengembang mungkin meminta Anda untuk "lacak balik".

1. Untuk mendapatkan backtrace yang berguna, fetchmail harus diinstal tanpa dihapus
simbol kompilasinya. Sayangnya, sebagian besar paket biner yang diinstal adalah
dilucuti, dan file inti dari program yang dilucuti simbol tidak berharga. Jadi, Anda mungkin perlu
kompilasi ulang fetchmail. Pada banyak sistem, Anda dapat mengetik

file `yang fetchmail`

untuk mengetahui apakah fetchmail dilucuti simbolnya atau tidak. Jika milikmu tidak dilucuti, baiklah,
lanjutkan, jika dilucuti, Anda perlu mengkompilasi ulang kode sumber terlebih dahulu. Anda tidak
biasanya perlu menginstal fetchmail untuk men-debugnya.

2. Lingkungan shell yang memulai fetchmail perlu mengaktifkan dump inti. Kuncinya adalah
"ukuran inti (file) maksimum" yang biasanya dapat dikonfigurasi dengan alat bernama "batas" atau
"batas". Lihat dokumentasi untuk shell Anda untuk detailnya. Di shell bash populer,
"ulimit -Sc unlimited" akan memungkinkan core dump.

3. Anda juga perlu memberi tahu fetchmail untuk mengizinkan pembuangan inti. Untuk melakukan ini, jalankan fetchmail dengan
itu -d0 -v pilihan. Seringkali juga lebih mudah untuk menambahkan --nosyslog -N juga.

Akhirnya, Anda perlu mereproduksi crash. Anda bisa memulai fetchmail dari direktori
di mana Anda menyusunnya dengan mengetik ./fetchmail, jadi baris perintah lengkap akan dimulai dengan
./fetchmail -Nvd0 --nosyslog dan mungkin daftar pilihan Anda yang lain.

Setelah crash, jalankan debugger Anda untuk mendapatkan core dump. Debugger akan sering
GNU GDB, Anda kemudian dapat mengetik (menyesuaikan jalur seperlunya) gdb ./fetchmail ambilmail.core dan
kemudian, setelah GDB memulai dan membaca semua filenya, ketik mundur penuh, Selamatkan
output (copy & paste akan dilakukan, backtrace akan dibaca oleh manusia) dan kemudian ketik berhenti untuk
tinggalkan gdb. Catatan: pada beberapa sistem, file inti memiliki nama yang berbeda, mungkin berisi
nomor bukan nama program, atau nomor dan nama, tetapi biasanya akan memiliki "inti"
sebagai bagian dari nama mereka.

INTERAKSI DENGAN RFC 822

Saat mencoba menentukan alamat asal sebuah pesan, fetchmail melihat-lihat
header dengan urutan sebagai berikut:

Return-Path:
Resent-Sender: (diabaikan jika tidak mengandung @ atau !)
Pengirim: (diabaikan jika tidak mengandung @ atau !)
Kirim-Dari:
Dari:
Membalas ke:
Rupanya-Dari:

Alamat asal digunakan untuk logging, dan untuk mengatur alamat MAIL FROM ketika
meneruskan ke SMTP. Pesanan ini dimaksudkan untuk mengatasi milis penerima dengan anggun
pesan dalam mode multidrop. Maksudnya adalah jika alamat lokal tidak ada,
pesan bouncing tidak akan dikembalikan secara membabi buta ke penulis atau ke daftar itu sendiri, melainkan
ke manajer daftar (yang tidak terlalu mengganggu).

Dalam mode multidrop, header tujuan diproses sebagai berikut: Pertama, tampilan fetchmail
untuk tajuk yang ditentukan oleh opsi 'amplop' untuk menentukan lokal
alamat penerima. Jika surat ditujukan ke lebih dari satu penerima, baris Diterima
tidak akan berisi informasi apa pun tentang alamat penerima.

Kemudian fetchmail mencari baris Resent-To:, Resent-Cc:, dan Resent-Bcc:. Jika mereka
ada, mereka harus berisi penerima akhir dan didahulukan dari mereka
Kepada:/Cc:/Bcc: rekanan. Jika baris Kirim-* tidak ada, To:, Cc:, Bcc: dan
Rupanya-Untuk: baris dicari. (Kehadiran Resent-To: dianggap menyiratkan bahwa
orang yang dirujuk oleh alamat Kepada: telah menerima salinan asli dari
surat.)

KONFIGURASI CONTOH

Perhatikan bahwa meskipun ada deklarasi kata sandi dalam banyak contoh di bawah ini,
ini terutama untuk tujuan ilustrasi. Kami merekomendasikan untuk menyembunyikan pasangan akun/sandi di
file $HOME/.netrc Anda, di mana mereka dapat digunakan tidak hanya oleh fetchmail tetapi juga oleh ftp(1) dan
program lainnya.

Format dasarnya adalah:

pemilihan NAMA SERVER protokol PROTOKOL nama pengguna NAMA kata sandi PASSWORD

Contoh:

poll pop.provider.net protokol pop3 nama pengguna "jsmith" kata sandi "secret1"

Atau, menggunakan beberapa singkatan:

poll pop.provider.net proto pop3 pengguna "jsmith" kata sandi "secret1"

Beberapa server mungkin terdaftar:

poll pop.provider.net proto pengguna pop3 "jsmith" lulus "secret1"
poll other.provider.net proto pengguna pop2 "John.Smith" lulus "My^Hat"

Inilah versi yang sama dengan lebih banyak spasi dan beberapa kata derau:

polling pop.provider.net proto pop3
pengguna "jsmith", dengan kata sandi secret1, adalah "jsmith" di sini;
polling other.provider.net proto pop2:
pengguna "John.Smith", dengan kata sandi "My^Hat", adalah "John.Smith" di sini;

Jika Anda perlu memasukkan spasi putih dalam string parameter atau memulai yang terakhir dengan angka,
melampirkan string dalam tanda kutip ganda. Dengan demikian:

poll mail.provider.net dengan proto pop3:
pengguna "jsmith" ada kata sandi "4u tapi kamu tidak bisa krak ini"
apakah jws ada di sini dan ingin mda "/bin/mail"

Anda mungkin memiliki deskripsi server awal yang dipimpin oleh kata kunci 'default' alih-alih
'jajak pendapat' diikuti dengan nama. Catatan seperti itu ditafsirkan sebagai default untuk semua kueri untuk
menggunakan. Ini mungkin ditimpa oleh deskripsi server individu. Jadi, Anda bisa menulis:

default proto pop3
pengguna "jsmith"
polling pop.provider.net
lulus "rahasia1"
polling mail.provider.net
pengguna "jjsmith" di sana memiliki kata sandi "secret2"

Dimungkinkan untuk menentukan lebih dari satu pengguna per server. Kata kunci 'pengguna' mengarah pada
deskripsi pengguna, dan setiap spesifikasi pengguna dalam entri multi-pengguna harus menyertakannya.
Ini sebuah contoh:

polling pop.provider.net port proto pop3 3111
pengguna "jsmith" dengan pass "secret1" adalah "smith" di sini
pengguna jones dengan pass "secret2" adalah "jjones" di sini tetap

Ini mengaitkan nama pengguna lokal 'smith' dengan nama pengguna pop.provider.net 'jsmith' dan
nama pengguna lokal 'jjones' dengan nama pengguna pop.provider.net 'jones'. Surat untuk 'jones'
disimpan di server setelah diunduh.

Berikut konfigurasi pengambilan sederhana untuk kotak surat multidrop:

polling pop.provider.net:
maildrop pengguna dengan pass secret1 ke golux 'hurkle'='happy' snark here

Ini mengatakan bahwa kotak surat akun 'maildrop' di server adalah kotak multidrop, dan
bahwa pesan di dalamnya harus diuraikan untuk nama pengguna server 'golux', 'hurkle', dan
'snar'. Lebih lanjut menentukan bahwa 'golux' dan 'snark' memiliki nama yang sama pada klien
seperti di server, tetapi email untuk pengguna server 'hurkle' harus dikirimkan ke pengguna klien
'senang'.

Note bahwa ambil surat, hingga versi 6.3.4, TIDAK mengizinkan spesifikasi lengkap pengguna@domain
di sini, ini tidak akan pernah cocok. Ambil surat 6.3.5 dan yang lebih baru mendukung pengguna@domain
spesifikasi di sisi kiri pemetaan pengguna.

Berikut ini contoh koneksi multidrop jenis lain:

poll pop.provider.net domain lokal loonytoons.org toons.org
amplop X-Amplop-Ke
maildrop pengguna dengan pass secret1 ke * di sini

Ini juga mengatakan bahwa kotak surat akun 'maildrop' di server adalah kotak multidrop.
Ini memberi tahu fetchmail bahwa alamat apa pun di domain loonytoons.org atau toons.org (termasuk
alamat subdomain seperti '[email dilindungi]') harus diteruskan ke
pendengar SMTP lokal tanpa modifikasi. Hati-hati dengan loop surat jika Anda melakukan ini!

Berikut ini contoh konfigurasi menggunakan ssh dan opsi plugin. Pertanyaan dibuat
langsung di stdin dan stdout dari imapd melalui ssh. Perhatikan bahwa dalam pengaturan ini, IMAP
otentikasi dapat dilewati.

poll mailhost.net dengan proto imap:
plugin "ssh %h /usr/sbin/imapd" auth ssh;
pengguna esr adalah esr di sini

THE GUNAKAN DAN PENYALAHGUNAAN OF BERGANDA KOTAK SURAT

Gunakan fitur penerima multilokal dengan hati-hati -- fitur ini dapat menggigit. Semua multidrop
fitur tidak efektif dalam mode ETRN dan ODMR.

Juga, perhatikan bahwa dalam mode multidrop, email duplikat ditekan. Sepotong surat adalah
dianggap duplikat jika memiliki ID pesan yang sama dengan pesan sebelumnya
dan lebih dari satu penerima. Jalan-jalan pesan seperti itu dapat dihasilkan ketika salinan dari a
pesan yang ditujukan ke beberapa pengguna dikirim ke kotak multidrop.

Header vs Amplop alamat
Masalah mendasarnya adalah dengan meminta server surat Anda melemparkan surat beberapa orang ke dalam
kotak maildrop tunggal, Anda mungkin telah membuang informasi yang berpotensi penting tentang siapa masing-masing
sepotong surat sebenarnya ditujukan kepada ('alamat amplop', sebagai lawan dari header
alamat di header RFC822 To/Cc - Bcc tidak tersedia di ujung penerima).
'Alamat amplop' ini adalah alamat yang Anda perlukan untuk merutekan ulang email dengan benar.

Terkadang ambil surat dapat menyimpulkan alamat amplop. Jika MTA server surat adalah kirim email
dan item surat hanya memiliki satu penerima, MTA akan menulis klausa 'oleh/untuk'
yang memberikan penerima amplop ke header Diterima. Tapi ini tidak bekerja dengan andal
untuk MTA lain, atau jika ada lebih dari satu penerima. Secara default, ambil surat mencari
alamat amplop di baris ini; Anda dapat mengembalikan default ini dengan -E "Diterima" atau
'amplop Diterima'.

As a lebih baik alternatif, beberapa pendengar SMTP dan/atau server email menyisipkan header di masing-masing
pesan yang berisi salinan alamat amplop. Header ini (bila ada) adalah
sering 'X-Original-To', 'Delivered-To' atau 'X-Envelope-To'. Asumsi Fetchmail tentang
ini dapat diubah dengan opsi -E atau 'amplop'. Perhatikan bahwa menulis amplop
header semacam ini memperlihatkan nama-nama penerima (termasuk penerima blind-copy) ke
semua penerima pesan, sehingga hulu harus menyimpan satu salinan pesan per
penerima untuk menghindari menjadi masalah privasi.

Postfix, sejak versi 2.0, menulis header X-Original-To: yang berisi salinan dari
amplop seperti yang diterima.

Qmail dan Postfix biasanya menulis header 'Delivered-To' setelah mengirimkan pesan ke
gulungan surat dan menggunakannya untuk menghindari loop surat. Namun, domain virtual Qmail akan diawali
nama pengguna dengan string yang biasanya cocok dengan domain pengguna. Untuk menghapus awalan ini
Anda dapat menggunakan opsi -Q atau 'qvirtual'.

Terkadang, sayangnya, tidak satu pun dari metode ini yang berhasil. Itulah titik ketika Anda
harus menghubungi ISP Anda dan meminta mereka untuk memberikan tajuk amplop seperti itu, dan Anda harus
tidak menggunakan multidrop dalam situasi ini. Ketika semuanya gagal, fetchmail harus kembali ke
isi header To/Cc (header Bcc tidak tersedia - lihat di bawah) untuk mencoba menentukan
penerima penerima -- dan ini tidak dapat diandalkan. Secara khusus, perangkat lunak milis
sering mengirimkan email hanya dengan alamat broadcast daftar di header To.

Note bahwa a masa depan versi of ambil surat mungkin menghapus Kepada/Cc menguraikan!

Ketika ambil surat tidak dapat menyimpulkan alamat penerima yang lokal, dan penerima yang dituju
alamatnya adalah siapa pun selain pengguna yang memanggil fetchmail, surat akan mendapatkan kalah. Ini apa
membuat fitur multidrop berisiko tanpa informasi amplop yang tepat.

Masalah terkait adalah ketika Anda menyalin pesan email secara buta, informasi Bcc adalah
dilakukan hanya sebagai alamat amplop (dihapus dari header oleh surat pengirim
server, sehingga fetchmail hanya dapat melihatnya jika ada header X-Envelope-To). Jadi, buta-
penyalinan ke seseorang yang menerima email melalui tautan multidrop fetchmail akan gagal kecuali jika
host mailserver secara rutin menulis X-Envelope-To atau header yang setara ke dalam pesan di
kiriman surat Anda.

In kesimpulan, mailing daftar dan Bcc'd surat bisa hanya kerja if itu Server kamu mengambil
dari

(1) toko satu salinan of itu pesan untuk penerima in Tujuan domain dan

(2) arsip itu amplop informasi in a khusus Header (X-Asli-Ke, Dikirim ke,
X-Amplop-Ke).

baik Cara Untuk penggunaan banyak titik Kotak surat
Beberapa nama lokal dapat digunakan untuk mengelola milis dari sisi klien a
ambil surat koleksi. Misalkan nama Anda 'esr', dan Anda ingin mengambilnya sendiri
mail dan pertahankan milis yang disebut (katakanlah) "fetchmail-friends", dan Anda ingin menyimpannya
daftar alias di mesin klien Anda.

Di server Anda, Anda dapat alias 'fetchmail-friends' menjadi 'esr'; kemudian, di .fetchmailrc,
mendeklarasikan 'untuk menjemput teman-teman di sini'. Kemudian, ketika email termasuk 'fetchmail-friends' sebagai
alamat lokal diambil, nama daftar akan ditambahkan ke daftar penerima
pendengar SMTP Anda melihat. Oleh karena itu akan mengalami ekspansi alias lokal. Pastikan untuk
sertakan 'esr' dalam perluasan alias lokal dari fetchmail-friends, atau Anda tidak akan pernah melihat email
dikirim hanya ke daftar. Pastikan juga pendengar Anda memiliki set opsi "saya juga"
(opsi baris perintah -oXm sendmail atau deklarasi OXm) sehingga nama Anda tidak dihapus dari
perluasan alias dalam pesan yang Anda kirim.

Namun, trik ini bukan tanpa masalah. Anda akan mulai melihat ini ketika pesan
datang yang ditujukan hanya ke milis yang Anda lakukan tidak telah dinyatakan sebagai lokal
nama. Setiap pesan tersebut akan menampilkan header 'X-Fetchmail-Warning' yang dihasilkan
karena fetchmail tidak dapat menemukan nama lokal yang valid di alamat penerima. Seperti
pesan default (seperti yang dijelaskan di atas) untuk dikirim ke pengguna lokal yang sedang berjalan
ambil surat, tetapi program tidak memiliki cara untuk mengetahui bahwa itu sebenarnya hal yang benar.

Buruk Cara Untuk Penyalahgunaan banyak titik Kotak surat
Kotak surat multidrop dan ambil surat melayani banyak pengguna dalam mode daemon tidak bercampur. NS
masalahnya, sekali lagi, adalah surat dari milis, yang biasanya tidak memiliki individu
alamat penerima di atasnya. Kecuali ambil surat dapat menyimpulkan alamat amplop, surat tersebut akan
hanya buka akun yang menjalankan fetchmail (mungkin root). Juga, pengguna yang disalin buta adalah
kemungkinan besar tidak akan pernah melihat email mereka sama sekali.

Jika Anda tergoda untuk menggunakan ambil surat untuk mengambil email untuk beberapa pengguna dari satu email
drop melalui POP atau IMAP, pikirkan lagi (dan baca kembali bagian tentang alamat header dan amplop
di atas). Akan lebih pintar untuk membiarkan surat itu duduk di antrian server surat dan digunakan
mode ETRN atau ODMR fetchmail untuk memicu pengiriman SMTP secara berkala (tentu saja, ini berarti
Anda harus melakukan polling lebih sering daripada periode kedaluwarsa server surat). Jika kamu tidak bisa
atur ini, coba atur umpan UUCP.

Jika Anda benar-benar harus gunakan multidrop untuk tujuan ini, pastikan server surat Anda menulis
header amplop-alamat yang dapat dilihat oleh fetchmail. Jika tidak, kamu akan kehilangan surat dan itu akan
kembali menghantuimu.

Ngebut Up banyak titik Memeriksa
Biasanya, ketika banyak pengguna dideklarasikan ambil surat mengekstrak alamat penerima sebagai
dijelaskan di atas dan memeriksa setiap bagian host dengan DNS untuk melihat apakah itu alias dari
server surat. Jika demikian, pemetaan nama yang dijelaskan dalam deklarasi "ke ... di sini" selesai
dan surat dikirim secara lokal.

Ini adalah metode yang nyaman tetapi juga lambat. Untuk mempercepatnya, deklarasikan terlebih dahulu alias server surat
dengan 'alias'; ini diperiksa sebelum pencarian DNS dilakukan. Jika Anda yakin alias Anda
daftar berisi semua Alias ​​DNS dari server surat (dan semua nama MX menunjuk padanya - perhatikan
ini dapat berubah di versi mendatang) Anda dapat mendeklarasikan 'tidak ada dns' untuk menekan pencarian DNS
seluruhnya dan hanya cocok dengan daftar alias.

SOCKS

Dukungan untuk kaus kaki4/5 adalah menyusun waktu opsi konfigurasi. Setelah dikompilasi, fetchmail
akan selalu menggunakan perpustakaan kaus kaki dan konfigurasi pada sistem Anda, tidak ada run-
waktu beralih di fetchmail - tetapi Anda masih dapat mengonfigurasi SOCKS: Anda dapat menentukan yang mana
File konfigurasi SOCKS digunakan dalam SOCKS_CONF variabel lingkungan.

Misalnya, jika Anda ingin melewati proxy SOCKS sama sekali dan memiliki fetchmail
terhubung secara langsung, Anda bisa melewati SOCKS_CONF=/dev/null di lingkungan, misalnya
(tambahkan opsi baris perintah Anda yang biasa - jika ada - ke akhir baris ini):

env SOCKS_CONF=/dev/null ambil email

EXIT KODE

Untuk memudahkan penggunaan ambil surat dalam skrip shell, kode status keluar dikembalikan ke
memberikan indikasi tentang apa yang terjadi selama koneksi tertentu.

Kode keluar dikembalikan oleh ambil surat adalah sebagai berikut:

0 Satu atau lebih pesan berhasil diambil (atau, jika opsi -c adalah
dipilih, ditemukan menunggu tetapi tidak diambil).

1 Tidak ada surat yang menunggu pengambilan. (Mungkin ada surat lama yang masih ada di
server tetapi tidak dipilih untuk pengambilan.) Jika Anda tidak ingin "tidak ada email" menjadi kesalahan
kondisi (misalnya, untuk pekerjaan cron), gunakan shell yang sesuai dengan POSIX dan tambahkan

|| [ $? -persamaan 1 ]

ke akhir baris perintah fetchmail, perhatikan bahwa ini membuat 0 tidak tersentuh, memetakan 1
ke 0, dan memetakan semua kode lainnya ke 1. Lihat juga item #C8 di FAQ.

2 Terjadi kesalahan saat mencoba membuka soket untuk mengambil email. Jika kamu
tidak tahu apa itu soket, jangan khawatir -- anggap saja ini sebagai
'kesalahan yang tidak dapat dipulihkan'. Kesalahan ini juga bisa karena protokol fetchmail ingin
untuk digunakan tidak terdaftar di /etc/services.

3 Langkah otentikasi pengguna gagal. Ini biasanya berarti bahwa id pengguna yang buruk,
kata sandi, atau id APOP telah ditentukan. Atau mungkin berarti Anda mencoba menjalankan fetchmail
dalam keadaan di mana ia tidak memiliki input standar yang terpasang ke terminal dan
tidak dapat meminta kata sandi yang hilang.

4 Beberapa jenis kesalahan protokol fatal terdeteksi.

5 Ada kesalahan sintaks dalam argumen untuk ambil surat, atau sebelum atau sesudah terhubung
perintah gagal.

6 File kontrol jalankan memiliki izin yang buruk.

7 Terjadi kondisi error yang dilaporkan oleh server. Bisa juga menembak jika ambil surat
waktu habis saat menunggu server.

8 Kesalahan pengecualian sisi klien. Ini berarti ambil surat entah menemukan salinan lain dari
sendiri sudah berjalan, atau gagal sedemikian rupa sehingga tidak yakin apakah yang lain
salinan sedang berjalan.

9 Langkah otentikasi pengguna gagal karena server merespons "kunci sibuk". Mencoba
lagi setelah jeda singkat! Kesalahan ini tidak diterapkan untuk semua protokol, juga tidak
untuk semua server. Jika tidak diterapkan untuk server Anda, "3" akan dikembalikan sebagai gantinya,
Lihat di atas. Dapat dikembalikan saat berbicara dengan qpopper atau server lain yang dapat
merespons dengan "kunci sibuk" atau teks serupa yang mengandung kata "kunci".

10 The ambil surat run gagal saat mencoba melakukan pembukaan atau transaksi port SMTP.

11 Kesalahan DNS yang fatal. Fetchmail mengalami kesalahan saat melakukan pencarian DNS di
memulai dan tidak dapat melanjutkan.

12 file batch BSMTP tidak dapat dibuka.

13 Jajak pendapat diakhiri dengan batas pengambilan (lihat opsi --fetchlimit).

14 Indikasi sibuk server.

23 Kesalahan dalam. Anda akan melihat pesan tentang kesalahan standar dengan detail.

24-26, 28, 29
Ini adalah kode internal dan tidak boleh muncul secara eksternal.

Ketika ambil surat menanyakan lebih dari satu host, status pengembalian adalah 0 jika Apa pun kueri berhasil
surat yang diambil. Jika tidak, status kesalahan yang dikembalikan adalah host terakhir yang ditanyakan.

Gunakan fetchmailconf online menggunakan layanan onworks.net