swaks - Dalam talian di Awan

JADUAL:

NAMA

swaks - Swiss Army Knife SMTP, penguji transaksi smtp serba guna

DESCRIPTION

Matlamat reka bentuk utama swaks adalah untuk menjadi ujian SMTP berorientasikan transaksi yang fleksibel, boleh skrip
alat. Ia mengendalikan ciri dan sambungan SMTP seperti TLS, pengesahan dan
saluran paip; berbilang versi protokol SMTP termasuk SMTP, ESMTP dan LMTP; dan
pelbagai kaedah pengangkutan termasuk soket domain unix, soket domain internet dan
paip kepada proses bertelur. Pilihan boleh ditentukan dalam pembolehubah persekitaran,
fail konfigurasi, dan baris arahan yang membenarkan kebolehkonfigurasian maksimum dan kemudahan penggunaan
untuk operator dan skrip.

CEPAT MULA

Hantarkan e-mel ujian standard kepada [e-mel dilindungi] pada port 25 test-server.example.net:

swaks --kepada [e-mel dilindungi] --server test-server.example.net

Hantarkan e-mel ujian standard, yang memerlukan pengesahan CRAM-MD5 sebagai pengguna [e-mel dilindungi].
Pengepala "X-Test" akan ditambahkan pada badan e-mel. Kata laluan pengesahan akan menjadi
digesa untuk.

swaks --kepada [e-mel dilindungi] --dari [e-mel dilindungi] --auth CRAM-MD5 --auth-user [e-mel dilindungi] --header-X-Test "e-mel ujian"

Uji pengimbas virus menggunakan EICAR dalam lampiran. Jangan tunjukkan bahagian DATA mesej.:

swaks -t [e-mel dilindungi] --attach - --server test-server.example.com --suppress-data

Uji pengimbas spam menggunakan GTUBE dalam badan e-mel, dihalakan melalui rekod MX untuk
example.com:

swaks --kepada [e-mel dilindungi] --body /path/to/gtube/file

Hantarkan e-mel ujian standard kepada [e-mel dilindungi] menggunakan protokol LMTP melalui UNIX
fail soket domain

swaks --kepada [e-mel dilindungi] --socket /var/lda.sock --protocol LMTP

Laporkan semua penerima dalam fail teks yang tidak boleh disahkan pada pelayan ujian:

untuk E dalam `cat /path/to/email/file`
do
swaks --ke $E --server test-server.example.com --quit-after RCPT --hide-all
[ $? -ne 0 ] && echo $E
dilakukan

TERMA DAN KONVENSYEN

Dokumen ini cuba untuk konsisten dan khusus dalam penggunaan terma berikut untuk
mengurangkan kekeliruan.

Transaksi
Transaksi ialah pembukaan sambungan melalui pengangkutan ke sasaran dan menggunakan a
protokol pemesejan untuk cuba menyampaikan mesej.

Sasaran
Sasaran transaksi adalah perkara yang disambungkan oleh swaks. Istilah generik ini ialah
digunakan sepanjang dokumentasi kerana kebanyakan istilah lain tidak wajar membayangkan sesuatu
tentang pengangkutan yang digunakan.

pengangkutan
Pengangkutan ialah kaedah asas yang digunakan untuk menyambung ke sasaran.

Protokol
Protokol ialah bahasa aplikasi yang digunakan untuk berkomunikasi dengan sasaran. ini
dokumen menggunakan SMTP untuk bercakap secara umum tentang ketiga-tiga protokol yang disokong melainkan ia
menyatakan bahawa ia bercakap tentang protokol 'SMTP' khusus dan tidak termasuk yang lain.

Mesej Anda
Protokol SMTP wujud untuk memindahkan mesej, satu set bait dalam format yang dipersetujui
yang mempunyai penghantar dan penerima.

Sampul surat
Sampul surat mesej mengandungi pengirim dan penerima "benar" mesej. Ia boleh
juga dirujuk sebagai komponennya, penghantar sampul surat dan penerima sampul surat. Ia adalah
penting untuk ambil perhatian bahawa sampul surat mesej tidak perlu sepadan dengan To: dan From:
tajuk.

DATA
Bahagian DATA transaksi SMTP ialah mesej sebenar yang sedang
diangkut. Ia terdiri daripada kedua-dua pengepala mesej dan badannya. DATA dan badan
kadangkala digunakan secara sinonim, tetapi ia sentiasa dua perkara yang berbeza dalam hal ini
dokumen.

Pengepala
Pengepala mesej ditakrifkan sebagai semua baris dalam bahagian DATA mesej sebelum ini
baris kosong pertama. Ia mengandungi maklumat tentang e-mel yang akan dipaparkan
kepada penerima seperti Kepada:, Daripada:, Subjek:, dsb. Dalam dokumen ini pengepala akan
sentiasa ditulis dengan huruf besar pertama dan titik bertindih.

Badan
Badan mesej ialah bahagian bahagian DATAnya selepas baris kosong pertama.

OPTION PEMPROSESAN

Untuk mengelakkan kemungkinan kekeliruan dalam dokumen ini, bendera kepada swaks sentiasa dirujuk sebagai
satu "pilihan". Jika pilihan mengambil data tambahan, data tambahan itu dirujuk sebagai
hujah kepada pilihan. Contohnya, "--dari [e-mel dilindungi]" mungkin diberikan kepada
swaks pada baris arahan, dengan "--from" menjadi pilihan dan "[e-mel dilindungi]" menjadi
--dari hujah.

Pilihan boleh diberikan kepada swaks dalam tiga cara. Mereka boleh ditentukan dalam konfigurasi
fail, dalam pembolehubah persekitaran, dan pada baris arahan. Bergantung pada pilihan tertentu
dan sama ada hujah diberikan kepadanya atau tidak, swaks boleh menggesa pengguna untuk hujah itu.

Apabila swaks menilai pilihannya, ia mula-mula mencari fail konfigurasi (sama ada dalam a
lokasi lalai atau ditentukan dengan --config). Kemudian ia menilai sebarang pilihan dalam
pembolehubah persekitaran. Akhirnya, ia menilai pilihan baris arahan. Pada setiap pusingan
pemprosesan, sebarang pilihan yang ditetapkan lebih awal akan ditindih. Selain itu, sebarang pilihan boleh
diawali dengan "tidak-" untuk menyebabkan swaks lupa bahawa pembolehubah telah ditetapkan sebelum ini.
Keupayaan ini diperlukan kerana banyak pilihan merawat yang ditakrifkan-tetapi-tiada-hujah
berbeza daripada tidak ditentukan.

Mekanisme dan format yang tepat untuk menggunakan setiap jenis disenaraikan di bawah.

FAIL KONFIGURASI
Fail konfigurasi boleh digunakan untuk menetapkan pilihan yang biasa digunakan atau tidak normal.
Secara lalai, swaks kelihatan mengikut urutan untuk $SWAKS_HOME/.swaksrc, $HOME/.swaksrc dan
$LOGDIR/.swaksrc. Jika salah satu daripadanya didapati wujud (dan --config belum digunakan)
fail itu digunakan sebagai fail konfigurasi.

Selain itu, fail konfigurasi di lokasi bukan lalai boleh ditentukan menggunakan
--config. Jika ini ditetapkan dan tidak diberi hujah swaks tidak akan menggunakan apa-apa
fail konfigurasi, termasuk mana-mana fail lalai. Jika --config menunjuk kepada yang boleh dibaca
fail, ia digunakan sebagai fail konfigurasi, mengatasi mana-mana lalai yang mungkin wujud. Jika
ia menunjuk kepada fail yang tidak boleh dibaca dan ralat akan ditunjukkan dan swaks akan keluar.

Satu set lalai "mudah alih" juga boleh dibuat dengan menambah pilihan pada penghujung
fail program swaks. Seperti yang diedarkan, baris terakhir swaks hendaklah "__END__". mana-mana
baris yang ditambahkan selepas __END__ akan dianggap sebagai kandungan fail konfigurasi.
Ini membolehkan satu set pilihan pengguna disalin secara automatik dari pelayan ke pelayan
dalam satu fail.

Jika fail hadir dan konfigurasi tidak dimatikan secara eksplisit, __END__
config sentiasa dibaca. Hanya satu fail konfigurasi lain akan digunakan setiap satu
seruan swaks, walaupun berbilang fail konfigurasi ditentukan. Menentukan
pilihan --config tanpa hujah mematikan pemprosesan kedua-dua __END__
config dan sebarang fail konfigurasi sebenar.

Dalam baris fail konfigurasi yang bermula dengan cincang (#) diabaikan. Semua baris lain
diandaikan sebagai pilihan untuk swaks, dengan sempang utama atau sempang pilihan.
Segala-galanya selepas ruang pertama baris pilihan diandaikan sebagai hujah pilihan
dan tidak diproses dengan cangkerang. Oleh itu memetik biasanya tidak diperlukan dan akan
dimasukkan secara literal dalam hujah. Berikut adalah contoh kandungan a
fail konfigurasi:

# sentiasa gunakan penghantar ini, tidak kira pelayan atau pengguna log masuk
--dari [e-mel dilindungi]
# Saya lebih suka e-mel ujian saya mempunyai pengepala cantik. Nota
# kekurangan tanda sempang pada pilihan dan kekurangan petikan di sekeliling
# keseluruhan hujah.
h-Daripada: "Contoh Fred"[e-mel dilindungi]>

PEMBOLEH UBAH PERSEKITARAN
Pilihan boleh dibekalkan melalui pembolehubah persekitaran. Pembolehubah adalah dalam bentuk
$SWAKS_OPT_name, dengan nama ialah nama pilihan yang akan dinyatakan pada
baris arahan. Kerana sempang tidak dibenarkan dalam nama pembolehubah persekitaran dalam kebanyakan
cangkerang unix-ish, tiada sempang utama harus digunakan dan sebarang sempang di dalam pilihan
nama hendaklah diganti dengan garis bawah. Yang berikut akan mencipta pilihan yang sama
ditunjukkan dalam contoh fail konfigurasi:

$ SWAKS_OPT_from='[e-mel dilindungi]'
$ SWAKS_OPT_h_From='"Contoh Fred"[e-mel dilindungi]>'

Menetapkan pembolehubah kepada nilai kosong adalah sama seperti menentukannya pada baris arahan
tanpa hujah. Sebagai contoh, menetapkan SWAKS_OPT_server="" akan menyebabkan swaks
menggesa penggunaan untuk pelayan yang akan disambungkan pada setiap seruan.

Selain menetapkan setara dengan pilihan baris arahan, SWAKS_HOME boleh ditetapkan
ke direktori yang mengandungi .swaksrc lalai untuk digunakan.

PILIHAN TALIAN PERINTAH
Kaedah terakhir untuk membekalkan pilihan kepada swaks adalah melalui baris arahan. Pilihan
berkelakuan dengan cara yang konsisten dengan kebanyakan program baris arahan unix-ish. Banyak pilihan
mempunyai kedua-dua bentuk pendek dan panjang (contohnya -s dan --server). Secara ringkas konvensyen
pilihan ditentukan dengan sengkang tunggal dan pilihan panjang ditentukan dengan dua-
sempang. Ini hanyalah konvensyen dan mana-mana awalan akan berfungsi dengan mana-mana jenis.

Berikut menunjukkan contoh yang ditunjukkan dalam fail konfigurasi dan persekitaran
bahagian berubah-ubah:

$ swaks --dari [e-mel dilindungi] --h-Daripada: '"Contoh Fred"[e-mel dilindungi]>'

PENGANGKUTAN

swaks boleh menyambung ke sasaran melalui paip unix ("paip"), soket domain unix ("unix
soket"), atau soket domain internet ("soket rangkaian"). Menyambung melalui soket rangkaian
ialah tingkah laku lalai. Kerana sifat tunggal pengangkutan yang digunakan, setiap set
daripada pilihan dalam bahagian berikut adalah saling eksklusif. Menentukan lebih daripada satu daripada
--server, --pipe, atau --socket akan mengakibatkan ralat. Mencampurkan pilihan lain antara
jenis pengangkutan hanya akan menyebabkan pilihan yang tidak relevan diabaikan. Di bawah ialah a
penerangan ringkas tentang setiap jenis pengangkutan dan pilihan yang khusus untuk itu
jenis pengangkutan.

SOKET RANGKAIAN
Pengangkutan ini cuba menyampaikan mesej melalui TCP/IP, kaedah standard untuk
menyampaikan SMTP. Ini adalah pengangkutan lalai untuk swaks. Jika tiada --server,
--pipe, atau --soket diberikan maka pengangkutan ini digunakan dan pelayan sasaran adalah
ditentukan daripada domain penerima (lihat --server di bawah untuk butiran lanjut).

Pengangkutan ini memerlukan modul IO::Soket yang merupakan sebahagian daripada perl standard
pengedaran. Jika modul ini tidak boleh dimuatkan, cuba menggunakan pengangkutan ini akan
mengakibatkan ralat dan penamatan program.

IPv6 disokong apabila modul IO::Socket::INET6 hadir.

-s, --server [pelayan mel sasaran[:port]]
Beritahu swaks secara eksplisit untuk menggunakan soket rangkaian dan nyatakan nama hos atau IP
alamat yang hendak disambungkan, atau gesa jika tiada hujah diberikan. Jika pilihan ini adalah
tidak diberikan dan tiada pilihan pengangkutan lain diberikan, pelayan mel sasaran adalah
ditentukan daripada rekod DNS yang sesuai untuk domain e-mel penerima
alamat menggunakan modul Net::DNS. Jika Net::DNS tidak tersedia swaks akan
cuba menyambung ke localhost untuk menghantar. Port sasaran boleh ditetapkan secara pilihan
di sini. Format yang disokong untuk ini termasuk SERVER:PORT (nama sokongan dan IPv4
alamat); [SERVER]:PORT dan SERVER/PORT (nama sokongan, IPv4 dan IPv6
alamat). Lihat juga --copy-routing.

-p, --port [port]
Tentukan port TCP pada sasaran yang akan digunakan, atau gesa jika tiada hujah
tersenarai. Hujah boleh menjadi nama perkhidmatan (seperti yang diambil oleh getservbyname(3)) atau
nombor port. Port lalai ditentukan oleh pilihan --protocol. Lihat
--protokol untuk butiran lanjut.

-li, --local-interface [IP atau nama hos[:port]]
Gunakan argumen sebagai antara muka tempatan untuk sambungan SMTP keluar, atau gesaan
pengguna jika tiada hujah diberikan. Hujah boleh menjadi alamat IP atau nama hos. lalai
tindakan adalah untuk membiarkan sistem pengendalian memilih antara muka tempatan. Lihat --server untuk
ulasan tambahan pada : format port.

-lp, --local-port [port]
Tentukan port keluar untuk memulakan transaksi. Jika pilihan ini adalah
tidak dinyatakan sistem akan memilih port fana. Perhatikan bahawa pengguna biasa
tidak boleh menentukan beberapa port.

--copy-routing [domain]
Hujah ditafsirkan sebagai bahagian domain alamat e-mel dan ia digunakan
untuk mencari pelayan sasaran menggunakan logik yang sama yang akan digunakan untuk mencari
pelayan sasaran untuk alamat e-mel penerima. Lihat --ke pilihan untuk mendapatkan butiran lanjut
tentang cara sasaran ditentukan daripada domain e-mel.

-4, -6
Paksa IPv4 atau IPv6.

SOKET UNIX
Kaedah pengangkutan ini cuba menghantar mesej melalui fail soket domain unix.
Ini berguna untuk menguji MTA/MDA yang mendengar pada fail soket (contohnya, ujian
penghantaran LMTP kepada Cyrus). Pengangkutan ini memerlukan modul IO:: Soket yang merupakan sebahagian
daripada taburan perl standard. Jika modul ini tidak boleh dimuatkan, cuba gunakan
pengangkutan ini akan mengakibatkan ralat dan penamatan program.

--soket [/path/to/socket/file]
Pilihan ini mengambil sebagai hujahnya fail soket domain unix. Jika swaks tidak mampu
untuk membuka soket ini ia akan memaparkan ralat dan keluar.

PAIP
Pengangkutan ini cuba melahirkan proses dan berkomunikasi dengannya melalui paip. The
program yang dihasilkan mesti disediakan untuk berkelakuan sebagai pelayan mel melalui STDIN/STDOUT. mana-mana
MTA yang direka untuk beroperasi dari inet/xinet harus menyokong ini. Di samping itu beberapa MTA
menyediakan mod ujian yang boleh dikomunikasikan melalui STDIN/STDOUT. Pengangkutan ini
boleh digunakan untuk mengautomasikan ujian itu. Contohnya, jika anda melaksanakan semakan DNSBL
dengan Exim dan anda ingin memastikan ia berfungsi, anda boleh menjalankan 'swak --pipe
"exim -bh 127.0.0.2"'. Dalam dunia yang ideal, proses yang anda bicarakan harus berkelakuan
sama seperti pelayan SMTP pada stdin dan stdout. Sebarang penyahpepijatan hendaklah dihantar ke
stderr, yang akan diarahkan ke terminal anda. Dalam dunia sebenar swaks boleh
secara amnya mengendalikan beberapa nyahpepijat pada stdout kanak-kanak, tetapi tiada jaminan tentang caranya
banyak yang boleh dikendalikan.

Pengangkutan ini memerlukan modul IPC::Open2 yang merupakan sebahagian daripada perl standard
pengedaran. Jika modul ini tidak boleh dimuatkan, percubaan untuk menggunakan pengangkutan ini akan
mengakibatkan ralat dan penamatan program.

--pipe [/path/to/command and arguments]
Sediakan nama proses dan hujah kepada proses tersebut. swaks akan cuba bertelur
proses dan berkomunikasi dengannya melalui paip. Jika hujahnya bukan an
swaks boleh laku akan memaparkan ralat dan keluar.

PROTOKOL PILIHAN

Pilihan ini berkaitan dengan lapisan protokol.

-t, --ke [e-mel-alamat[,e-mel-alamat,...]]
Memberitahu swaks untuk menggunakan hujah sebagai penerima sampul surat untuk e-mel, atau menggesa untuk
penerima jika tiada hujah disediakan. Jika berbilang penerima disediakan dan
domain penerima diperlukan untuk menentukan penghalaan domain penerima terakhir
disediakan digunakan.

Tiada nilai lalai untuk pilihan ini. Jika tiada penerima disediakan melalui mana-mana
bermakna, pengguna akan digesa untuk menyediakannya secara interaktif. Satu-satunya pengecualian untuk ini
adalah jika nilai --quit-after disediakan yang akan menyebabkan transaksi smtp menjadi
ditamatkan sebelum penerima diperlukan.

-f, --dari [e-mel-alamat]
Gunakan hujah sebagai penghantar sampul surat untuk e-mel, atau gesa pengguna jika tiada hujah dinyatakan.
Rentetan <> boleh dibekalkan bermaksud penghantar nol. Jika pengguna tidak menyatakan a
alamat penghantar nilai lalai digunakan. Bahagian domain pengirim lalai ialah a
tekaan terbaik pada nama domain yang layak sepenuhnya bagi hos tempatan. Kaedah
menentukan bahagian tempatan berbeza-beza. Pada Windows, Win32::LoginName() digunakan. pada unix-
ish, pembolehubah persekitaran $LOGNAME digunakan jika ia ditetapkan. Jika tidak
getpwuid(3) digunakan. Lihat juga --force-getpwuid.

--ehlo, --lhlo, -h, --helo [helo-string]
Rentetan untuk digunakan sebagai hujah kepada perintah HELO/EHLO/LHLO, atau gunakan segera jika tiada hujah
ditentukan. Jika pilihan ini tidak digunakan tekaan terbaik pada nama domain yang layak sepenuhnya
hos tempatan digunakan. Jika modul Sys::Hostname, yang merupakan sebahagian daripada pangkalan
pengedaran, tidak tersedia pengguna akan digesa untuk mendapatkan nilai HELO. Perhatikan bahawa
Sys:: Nama hos telah diperhatikan tidak dapat mencari nama hos tempatan secara tertentu
keadaan. Ini mempunyai kesan yang sama seolah-olah Sys::Hostname tidak tersedia.

-q, --berhenti-selepas [titik-henti]
Titik di mana transaksi harus dihentikan. Apabila titik perhentian yang diminta
dicapai dalam urus niaga, dan dengan syarat bahawa swaks tidak tersilap sebelum
mencapainya, swaks akan menghantar "QUIT" dan cuba menutup sambungan dengan bersih.
Ini adalah hujah dan nota yang sah tentang maknanya.

SAMBUNG, BANNER
Tamatkan sesi selepas menerima sepanduk ucapan daripada sasaran.

FIRST-HELO, FIRST-EHLO, FIRST-LHLO
Dalam sesi STARTTLS (tetapi bukan tls-on-connect), tamatkan transaksi selepas itu
yang pertama daripada dua HELO. Dalam transaksi bukan STARTTLS, berkelakuan sama seperti HELO
(lihat di bawah).

XCLIENT
Berhenti selepas XCLIENT dihantar

TLS Hentikan transaksi serta-merta selepas rundingan TLS. Perhatikan bahawa ini
berlaku di tempat yang berbeza bergantung pada sama ada STARTTLS atau tls-on-connect
digunakan. Ini sentiasa berhenti selepas titik di mana TLS akan dirundingkan,
tidak kira sama ada ia dicuba.

HELO, EHLO, LHLO
Dalam sesi STARTTLS atau XCLIENT, berhenti selepas HELO kedua. Jika tidak berhenti
selepas HELO yang pertama dan satu-satunya.

AUTH
Berhenti selepas pengesahan. Ini sentiasa berhenti selepas titik di mana pengesahan
akan dirundingkan, tidak kira sama ada ia dicuba.

MEL, DARI
Berhenti selepas MAIL FROM: dihantar.

RCPT, KEPADA
Berhenti selepas RCPT KE: dihantar.

--masa tamat [masa]
Gunakan hujah sebagai tamat masa transaksi SMTP, atau gesa pengguna jika tiada hujah diberikan.
Hujah boleh sama ada digit tulen, yang akan ditafsirkan sebagai saat, atau boleh
mempunyai penentu s atau m (5s = 5 saat, 3m = 180 saat). Sebagai kes khas, 0
bermakna jangan tamatkan masa transaksi. Nilai lalai ialah 30s.

--protokol [protokol]
Tentukan protokol yang hendak digunakan dalam transaksi. Pilihan yang sah ditunjukkan dalam
jadual di bawah. Pada masa ini protokol 'teras' ialah SMTP, ESMTP, dan LMTP. Dengan menggunakan
variasi jenis protokol ini seseorang boleh dengan jelas menentukan port lalai, sama ada
pengesahan harus dicuba, dan jenis sambungan TLS yang sepatutnya
cuba. Protokol lalai ialah ESMTP. Jadual ini menunjukkan yang tersedia
argumen kepada --protocol dan pilihan masing-masing ditetapkan sebagai kesan sampingan:

SMTP
HELO, "-p 25"

SSMTP
EHLO->HELO, "-tlsc -p 465"

SSMTPA
EHLO->HELO, "-a -tlsc -p 465"

SMTPS
HELO, "-tlsc -p 465"

ESMTP
EHLO->HELO, "-p 25"

ESMTPA
EHLO->HELO, "-a -p 25"

ESMTPS
EHLO->HELO, "-tls -p 25"

ESMTPSA
EHLO->HELO, "-a -tls -p 25"

LMTP
LHLO, "-p 24"

LMTPA
LHLO, "-a -p 24"

LMTPS
LHLO, "-tls -p 24"

LMTPSA
LHLO, "-a -tls -p 24"

--talian paip
Jika pelayan jauh menyokongnya, cuba PIPELINING SMTP (RFC 2920). Ini adalah satu
pilihan yang lebih muda, jika anda mengalami masalah dengannya sila maklumkan kepada pengarang.
Kawasan masalah yang berpotensi termasuk pelayan yang menerima DATA walaupun tidak ada yang sah
penerima (swak harus menghantar badan kosong dalam kes itu, bukan BERHENTI) dan kebuntuan yang disebabkan
dengan menghantar paket di luar saiz tetingkap tcp.

--force-getpwuid
Beritahu swaks untuk menggunakan kaedah getpwuid untuk mencari bahagian tempatan penghantar lalai
mencuba $LOGNAME dahulu.

TLS / TAMADUN

Ini adalah pilihan yang berkaitan dengan menyulitkan transaksi. Ini telah diuji dan
disahkan berfungsi dengan ketiga-tiga kaedah pengangkutan. Modul Net::SSLeay digunakan untuk
melakukan penyulitan apabila ia diminta. Jika modul ini tidak boleh dimuatkan swaks akan sama ada
abaikan permintaan TLS atau ralat, bergantung pada sama ada permintaan itu adalah pilihan.
STARTTLS ditakrifkan sebagai sambungan dalam protokol ESMTP dan tidak akan tersedia jika
--protocol ditetapkan kepada variasi smtp. Kerana ia tidak ditakrifkan dalam protokol
sendiri, --tls-on-connect tersedia untuk sebarang jenis protokol jika sasaran menyokongnya.

Sijil tempatan tidak diperlukan untuk sambungan TLS dirundingkan. Walau bagaimanapun, beberapa
pelayan menggunakan pemeriksaan sijil klien untuk mengesahkan bahawa klien dibenarkan untuk menyambung.
swaks boleh diberitahu untuk menggunakan sijil tempatan tertentu melalui penggunaan --tls-cert
dan --tls-key pilihan.

-tls
Memerlukan sambungan untuk menggunakan STARTTLS. Keluar jika TLS tidak tersedia atas sebarang sebab (tidak
diiklankan, rundingan gagal, dll).

-tlso, --tls-pilihan
Cuba untuk menggunakan STARTTLS jika tersedia, teruskan dengan transaksi biasa jika TLS ada
tidak dapat dirundingkan atas sebarang sebab. Ambil perhatian bahawa ini adalah pilihan separa tidak berguna sebagai
sedang dilaksanakan kerana selepas kegagalan rundingan keadaan sambungan
tidak diketahui. Dalam sesetengah kes, seperti versi yang tidak sepadan, sambungan harus dibiarkan sebagai
teks kosong. Dalam yang lain, seperti kegagalan pengesahan, pihak pelayan mungkin menganggapnya
harus terus bercakap TLS sementara pelanggan berpendapat ia adalah teks biasa. Mungkin ada
cuba menambah lebih banyak pengesanan keadaan berbutir pada masa hadapan, tetapi buat masa ini hanya sedar
bahawa perkara ganjil mungkin berlaku dengan pilihan ini jika rundingan TLS dicuba dan
gagal.

-tlsos, --tls-pilihan-ketat
Cuba gunakan STARTTLS jika tersedia. Teruskan dengan transaksi jika TLS dirundingkan
berjaya atau STARTTLS tidak diiklankan. Jika STARTTLS diiklankan tetapi TLS
rundingan gagal, anggap sebagai ralat dan batalkan transaksi. Disebabkan oleh kaveat yang dicatatkan
di atas, ini adalah pilihan yang lebih waras daripada --tls-optional.

--tlsc, --tls-on-connect
Mulakan sambungan TLS serta-merta semasa sambungan. Mengikuti konvensyen biasa, jika
pilihan ini ditentukan port lalai berubah daripada 25 kepada 465, walaupun ini boleh
masih ditindih dengan pilihan --port.

-tlsp, --tls-protokol SPESIFIKASI
Tentukan protokol yang hendak digunakan (atau tidak digunakan) semasa merundingkan TLS. Pada masa ini
menulis, protokol yang tersedia ialah sslv2, sslv3, tlsv1, tlsv1_1 dan tlsv1_2. The
ketersediaan protokol ini bergantung pada perpustakaan OpenSSL asas anda, jadi
tidak semua ini mungkin tersedia. Senarai protokol yang tersedia ditunjukkan dalam
output --dump (dengan andaian TLS tersedia sama sekali).

Rentetan spesifikasi ialah senarai protokol yang dibatasi koma yang boleh digunakan atau
tidak digunakan. Contohnya 'tlsv1,tlsv1_1' hanya akan berjaya jika salah satu daripada keduanya
protokol tersedia pada kedua-dua klien dan pelayan. Sebaliknya,
'no_sslv2,no_sslv3' akan cuba merundingkan sebarang protokol kecuali sslv2 dan sslv3.
Kedua-dua bentuk spesifikasi tidak boleh dicampur.

-tls-cipher CIPHER_STRING
Argumen ke pilihan ini dihantar ke perpustakaan OpenSSL yang mendasari untuk menetapkan senarai
sifir yang boleh diterima untuk digunakan untuk sambungan. Format rentetan ini ialah
legap kepada swaks dan ditakrifkan dalam
http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT. Contoh ringkas
akan menjadi --tls-cipher '3DES:+RSA'.

--tls-sahkan
Secara lalai, swaks tidak melakukan sebarang pengesahan sijil. Tetapan --tls-verify akan
menyebabkan swaks cuba mengesahkan sijil pelayan. Jika pilihan ini ditetapkan dan
sijil pelayan tidak boleh disahkan (sama ada menggunakan CA lalai sistem
maklumat, atau maklumat CA tersuai (lihat --tls-ca-path)) Rundingan TLS tidak akan
berjaya.

--tls-ca-path [ /path/to/CAfile | /path/to/CAdir/ ]
Secara lalai, swaks akan menggunakan maklumat CA lalai perpustakaan OpenSSL asas untuk
mengesahkan sijil pelayan. --tls-ca-path membolehkan anda menentukan alternatif
lokasi. Lihat http://www.openssl.org/docs/ssl/SSL_CTX_load_verify_locations.html khususnya
butiran kandungan fail/direktori.

--tls-cert /path/to/file
Sediakan laluan ke fail yang mengandungi swaks sijil tempatan harus digunakan jika TLS adalah
dirundingkan. Argumen laluan fail diperlukan. Seperti yang dilaksanakan pada masa ini
sijil dalam fail mestilah dalam format PEM. Hubungi pengarang jika ada
keperluan yang mendesak untuk ASN1. Jika pilihan ini ditetapkan, --tls-key juga diperlukan.

--tls-key /path/to/file
Sediakan laluan ke fail yang mengandungi swaks kunci persendirian tempatan yang harus digunakan jika TLS adalah
dirundingkan. Argumen laluan fail diperlukan. Seperti yang dilaksanakan pada masa ini
sijil dalam fail mestilah dalam format PEM. Hubungi pengarang jika ada
keperluan yang mendesak untuk ASN1. Jika pilihan ini ditetapkan, --tls-cert juga diperlukan.

--tls-get-peer-cert [/path/to/file]
Dapatkan salinan sijil rakan setara TLS. Jika tiada hujah diberikan, ia akan menjadi
dipaparkan kepada STDOUT. Jika hujah diberikan ia diandaikan sebagai laluan sistem fail
menyatakan di mana sijil harus ditulis. Sijil yang disimpan kemudiannya boleh
diperiksa menggunakan alat standard seperti arahan openssl. Jika fail dinyatakan, ia
kandungan akan ditimpa.

PEMULIHAN

swaks akan cuba untuk mengesahkan ke pelayan mel sasaran jika diarahkan berbuat demikian. ini
butiran bahagian yang tersedia jenis pengesahan, keperluan, pilihan dan mereka
interaksi, dan perkara baik lain dalam penggunaan pengesahan. Kerana pengesahan adalah
ditakrifkan sebagai sambungan dalam protokol ESMTP ia tidak akan tersedia jika --protocol ditetapkan
kepada variasi smtp.

Semua kaedah pengesahan memerlukan pengekodan base64. Jika modul perl MIME::Base64 ialah
swaks yang boleh dimuatkan cuba menggunakannya untuk melaksanakan pengekodan ini. Jika MIME::Base64 bukan
swaks yang tersedia akan menggunakan rutin base64 onboard sendiri. Ini adalah lebih perlahan daripada
MIME::Base64 rutin dan kurang disemak, walaupun ia telah diuji dengan teliti. menggunakan
modul MIME::Base64 digalakkan.

Jika pengesahan diperlukan (lihat pilihan di bawah untuk masa ia diperlukan dan tidak diperlukan) dan
keperluan tidak dipenuhi untuk jenis pengesahan yang tersedia, swaks memaparkan ralat
dan keluar. Dua cara ini boleh berlaku termasuk memaksa swaks menggunakan yang khusus
jenis pengesahan yang tidak boleh digunakan oleh swaks kerana keperluan yang tiada, atau membenarkan swaks melakukannya
gunakan sebarang jenis pengesahan, tetapi pelayan hanya mengiklankan jenis swaks tidak boleh menyokong. Dalam
bekas kes swaks kesilapan keluar pada masa pemprosesan pilihan kerana ia tahu di hadapan ia
tidak akan dapat mengesahkan. Dalam kes terakhir swaks akan ralat keluar pada
peringkat pengesahan transaksi smtp kerana swaks tidak akan sedar bahawa ia akan
tidak dapat mengesahkan sehingga ketika itu.

Berikut ialah jenis pengesahan yang disokong termasuk sebarang nota individu dan
keperluan.

Pilihan berikut mempengaruhi penggunaan pengesahan swaks. Pilihan ini semuanya antara
berkaitan. Sebagai contoh, menentukan --auth-user membayangkan --auth dan --auth-kata laluan.
Menentukan --auth-optional membayangkan --auth-user dan --auth-password, dsb.

-a, --auth [auth-type[,auth-type,...]]
Memerlukan swaks untuk mengesahkan. Jika tiada hujah diberikan, sebarang jenis auth yang disokong
yang diiklankan oleh pelayan dicuba sehingga satu berjaya atau semua gagal. Jika satu atau lebih
auth-types ditentukan sebagai hujah, setiap satu yang pelayan juga menyokong cuba
teratur sehingga seseorang berjaya atau semua gagal. Pilihan ini memerlukan swaks untuk mengesahkan,
jadi jika tiada jenis auth biasa ditemui atau tiada bukti kelayakan berjaya, swaks memaparkan a
kesilapan dan keluar.

Jadual berikut menyenaraikan jenis auth yang sah

LOGIN, PLAIN
Jenis pengesahan asas ini disokong dan diuji sepenuhnya dan tidak mempunyai
keperluan tambahan

CRAM-MD5
Pengesah CRAM-MD5 memerlukan modul Digest::MD5. Ia diuji sepenuhnya
dan dipercayai berfungsi terhadap mana-mana pelayan yang melaksanakannya.

DIGEST-MD5
Pengesah DIGEST-MD5 (RFC2831) memerlukan modul Authen::SASL. Versi
20100211.0 dan lebih awal menggunakan Authen::DigestMD5 yang mempunyai beberapa ralat tahap protokol
yang menghalangnya daripada berfungsi dengan beberapa pelayan. Authen::SASL's DIGEST-MD5
pengendalian adalah lebih mantap.

Pelaksanaan DIGEST-MD5 dalam swaks agak tidak matang. Ia kini menyokong
hanya jenis qop "auth", contohnya. Jika anda mempunyai pengalaman DIGEST-MD5 dan
ingin membantu swaks menyokong DIGEST-MD5 dengan lebih baik, sila hubungi saya.

Nilai "alam" protokol DIGEST-MD5 boleh ditetapkan menggunakan --auth-extra "alam"
kata kunci. Jika tiada alam diberikan, lalai yang munasabah akan digunakan.

Nilai "digest-uri" protokol DIGEST-MD5 boleh ditetapkan menggunakan --auth-extra
pilihan. Sebagai contoh, anda boleh mencipta nilai digest-uri-
"lmtp/mail.example.com/example.com" dengan pilihan "--auth-extra
dmd5-serv-type=lmtp,dmd5-host=mail.example.com,dmd5-serv-name=example.com".
rentetan "digest-uri-value" dan komponennya ditakrifkan dalam RFC2831. Jika tiada
nilai ini diberikan, lalai yang munasabah akan digunakan.

CRAM-SHA1
Pengesah CRAM-SHA1 memerlukan modul Digest::SHA. Jenis ini mempunyai sahaja
telah diuji terhadap pelaksanaan bukan standard pada pelayan Exim dan mungkin
oleh itu mempunyai beberapa kelemahan pelaksanaan.

NTLM/SPA/MSN
Pengesah ini memerlukan modul Authen::NTLM. Perhatikan bahawa terdapat dua
modul menggunakan ruang nama Authen::NTLM pada CPAN. Pelaksanaan Mark Bush
(Authen/NTLM-1.03.tar.gz) ialah versi yang diperlukan oleh swaks. Jenis ini telah
diuji terhadap Exim, Communigate, and Exchange 2007.

Sebagai tambahan kepada nama pengguna dan kata laluan standard, jenis pengesahan ini boleh
juga mengenali "domain". Domain boleh ditetapkan menggunakan --auth-extra "domain"
kata kunci. Ambil perhatian bahawa ini tidak pernah diuji dengan pelayan mel yang tidak
abaikan DOMAIN supaya ini mungkin dilaksanakan secara tidak betul.

-ao, --auth-optional [auth-type[,auth-type,...]]
Pilihan ini berkelakuan sama dengan --auth kecuali ia meminta pengesahan
daripada memerlukannya. Jika tiada jenis auth biasa ditemui atau tiada bukti kelayakan
berjaya, swaks meneruskan seolah-olah pengesahan tidak diminta.

-aos, --auth-optional-strict [auth-type[,auth-type,...]]
Pilihan ini ialah kompromi antara --auth dan --auth-optional. Jika tiada pengesahan biasa-
jenis ditemui, swaks berkelakuan seolah-olah --auth-optional ditentukan dan meneruskan
transaksi tersebut. Jika swaks tidak dapat menyokong jenis auth yang diminta, pelayan tidak menyokong
mengiklankan sebarang jenis auth biasa, atau jika tiada bukti kelayakan berjaya, swaks berkelakuan seolah-olah
--auth telah digunakan dan keluar dengan ralat.

-au, --auth-user [nama pengguna]
Sediakan nama pengguna untuk digunakan untuk pengesahan, atau gesa pengguna untuknya jika tidak
hujah disediakan. Rentetan <> boleh dibekalkan bermaksud nama pengguna kosong.

-ap, --auth-kata laluan [kata laluan]
Sediakan kata laluan untuk digunakan untuk pengesahan, atau gesa pengguna untuknya jika tidak
hujah disediakan. Rentetan <> boleh dibekalkan bermaksud kata laluan kosong.

-ae, --auth-extra [KEYWORD=value[,...]]
Beberapa jenis pengesahan membenarkan maklumat tambahan dimasukkan ke dalam
proses pengesahan. Daripada menambah pilihan baharu untuk setiap sudut dan celah
setiap pengesah, pilihan --auth-extra membenarkan maklumat ini dibekalkan.

Jadual berikut menyenaraikan kata kunci yang diiktiraf pada masa ini dan pengesah
yang menggunakan mereka

alam, domain
Kata kunci alam dan domain adalah sinonim. Menggunakan salah satu akan menetapkan "domain"
pilihan dalam NTLM/MSN/SPA dan pilihan "alam" dalam DIGEST-MD5

dmd5-serv-type
Kata kunci jenis dmd5-serv digunakan oleh pengesah DIGEST-MD5 dan digunakan, dalam
bahagian, untuk membina rentetan digest-uri-value (lihat RFC2831)

dmd5-host
Kata kunci hos dmd5 digunakan oleh pengesah DIGEST-MD5 dan digunakan, dalam
bahagian, untuk membina rentetan digest-uri-value (lihat RFC2831)

dmd5-serv-name
Kata kunci dmd5-serv-name digunakan oleh pengesah DIGEST-MD5 dan digunakan, dalam
bahagian, untuk membina rentetan digest-uri-value (lihat RFC2831)

-am, --auth-map [auth-alias=auth-type[,...]]
Menyediakan cara untuk memetakan nama ganti pada jenis pengesahan asas. Berguna untuk mana-mana
tapak yang menggunakan nama ganti untuk jenis biasa. Fungsi ini sebenarnya digunakan
secara dalaman untuk memetakan jenis SPA dan MSN ke NTLM jenis asas. Barisan arahan
hujah untuk mensimulasikan ini ialah "--auth-map SPA=NTLM,MSN=NTLM". Semua kebenaran-
jenis yang disenaraikan di atas adalah sasaran yang sah untuk pemetaan kecuali SPA dan MSN.

-apt, --auth-plaintext
Daripada menunjukkan rentetan AUTH base64 yang dikodkan semasa ia dihantar, terjemahkannya
kepada teks biasa sebelum mencetak pada skrin.

-ahp, --auth-hide-password [rentetan penggantian]
Jika pilihan ini ditentukan, bila-bila masa kata laluan yang boleh dibaca akan dicetak ke
terminal (khususnya AUTH PLAIN dan AUTH LOGIN) kata laluan digantikan dengan
rentetan dummy (atau kandungan "rentetan penggantian" jika disediakan). Tali tiruan
akan dikodkan base64 atau tidak bergantung pada pilihan --auth-plaintext.

Ambil perhatian bahawa --auth-hide-password adalah serupa, tetapi tidak sama, dengan --protect-prompt
pilihan. Yang pertama melindungi kata laluan daripada dipaparkan dalam transaksi SMTP
tidak kira bagaimana mereka dimasukkan. Yang terakhir melindungi rentetan sensitif apabila
pengguna menaipnya di terminal, tidak kira bagaimana rentetan itu akan digunakan.

XCLIENT PILIHAN

XCLIENT ialah sambungan SMTP yang diperkenalkan oleh projek Postfix. XCLIENT membenarkan a
(dibenarkan dengan betul) pelanggan untuk memberitahu pelayan untuk menggunakan maklumat alternatif, seperti IP
alamat atau nama hos, untuk pelanggan. Ini membolehkan laluan yang lebih mudah untuk menguji mel
konfigurasi pelayan. Butiran penuh mengenai protokol boleh didapati di
http://www.postfix.org/XCLIENT_README.html.

--xclient-addr [VALUE]
--xclient-name [VALUE]
--xclient-port [VALUE]
--xclient-proto [VALUE]
--xclient-helo [VALUE]
--xclient-login [VALUE]
--xclient-reverse-name [VALUE]
Pilihan ini menentukan atribut XCLIENT yang harus dihantar ke pelayan sasaran. Jika
[VALUE] tidak disediakan, swaks akan menggesa dan membaca nilai pada STDIN. Lihat
http://www.postfix.org/XCLIENT_README.html untuk dokumentasi rasmi untuk apa yang
min atribut dan kemungkinan nilainya, termasuk "[TIDAK TERSEDIA]" khas dan
Nilai "[TEMPUNAVAIL]".

Dengan cara contoh mudah, tetapkan "--xclient-name foo.example.com --xclient-addr
192.168.1.1" akan menyebabkan swaks menghantar arahan SMTP "XCLIENT NAME=foo.example.com
ADDR=192.168.1.1".

Ambil perhatian bahawa atribut "REVERSE_NAME" nampaknya tidak muncul dalam rasmi
dokumentasi. Terdapat urutan senarai mel yang mendokumenkannya, boleh dilihat di
http://comments.gmane.org/gmane.mail.postfix.user/192623.

Pilihan ini semuanya boleh dicampur antara satu sama lain, dan boleh dicampur dengan --xclient
pilihan (lihat di bawah).

--xclient [XCLIENT_STRING]
Ini ialah pilihan XCLIENT "borang percuma". Apa sahaja nilai yang disediakan untuk XCLIENT_STRING
akan dihantar verbatim sebagai hujah kepada arahan XCLIENT smtp. Sebagai contoh, jika
"--xclient 'NAME= ADDR=192.168.1.1 FOO=bar'" digunakan, swaks akan menghantar arahan SMTP
"NAMA XCLIENT= ADDR=192.168.1.1 FOO=bar". Kelebihan utama ini berbanding lebih banyak lagi
pilihan khusus di atas ialah tiada pengesahan sintaks XCLIENT di sini. ini
membolehkan anda menghantar XCLIENT yang tidak sah ke pelayan sasaran untuk ujian. Jika tidak
XCLIENT_STRING dihantar pada baris arahan, swaks akan menggesa dan membaca nilai pada
STDIN.

Pilihan --xclient boleh dicampur secara bebas dengan pilihan --xclient-* di atas. Jika
"--xclient-addr 192.168.0.1 --xclient 'FOO=bar NAME=wind'" diberikan kepada swaks, "XCLIENT
ADDR=192.168.0.1 FOO=bar NAME=wind" akan dihantar ke pelayan sasaran.

--xclient-pilihan
--xclient-optional-strict
Dalam operasi biasa, menetapkan salah satu pilihan --xclient* akan menyebabkan kejayaan
Transaksi XCLIENT akan berlaku untuk meneruskan (iaitu, XCLIENT perlu
diiklankan, semua atribut yang diminta pengguna perlu telah diiklankan, dan
pelayan perlu menerima permintaan XCLIENT swaks). Pilihan ini mengubahnya
tingkah laku. --xclient-optional memberitahu swaks untuk meneruskan tanpa syarat melepasi XCLIENT
peringkat transaksi SMTP, tidak kira sama ada ia berjaya.
--xclient-optional-strict adalah serupa tetapi lebih berbutir. Versi ketat akan
teruskan ke XCLIENT tidak diiklankan, tetapi akan gagal jika XCLIENT cuba tetapi berjaya
tidak berjaya.

DATA PILIHAN

Pilihan ini berkaitan dengan kandungan untuk bahagian DATA transaksi SMTP.

-d, --data [bahagian data]
Gunakan hujah sebagai keseluruhan kandungan DATA, atau gesa pengguna jika tiada hujah dinyatakan.
Jika hujah '-' disediakan, data akan dibaca daripada STDIN. Jika ada yang lain
argumen disediakan dan ia mewakili nama fail boleh terbuka, kandungan
fail akan digunakan. Sebarang hujah lain akan menjadi sendiri untuk kandungan DATA.

Nilai boleh berada pada satu baris, dengan \n (ascii 0x5c, 0x6e) mewakili tempat
line break hendaklah diletakkan. Titik utama akan dipetik. Titik penutup tidak
diperlukan tetapi dibenarkan. Nilai lalai untuk pilihan ini ialah "Tarikh: %DATE%\nKepada:
%TO_ADDRESS%\nDaripada: %FROM_ADDRESS%\nSubjek: ujian %DATE%\nX-Mailer: swaks v$p_version
jetmore.org/john/code/swaks/\n%NEW_HEADERS%\n%BODY%\n".

Penghuraian token yang sangat asas dilakukan pada bahagian DATA. Lihat --use-old-data-token
untuk butiran tentang token aksara tunggal yang ditandakan sebagai tidak digunakan. Yang berikut
jadual menunjukkan token yang diiktiraf dan nilai gantiannya:

%FROM_ADDRESS%
Digantikan dengan penghantar sampul surat. Menggantikan token %F yang telah ditamatkan.

%TO_ADDRESS%
Digantikan dengan penerima-sampul surat. Menggantikan token %T yang telah ditamatkan.

%TARIKH%
Digantikan dengan masa semasa dalam format yang sesuai untuk dimasukkan dalam Tarikh:
kepala. Perhatikan percubaan ini untuk menggunakan modul standard Time::Local untuk zon waktu
pengiraan. Jika modul ini tidak tersedia, rentetan tarikh akan berada dalam GMT.
Menggantikan token %D yang telah ditamatkan.

%NEW_HEADERS%
Digantikan dengan kandungan pilihan --add-header. Jika --add-header tidak
dinyatakan token ini hanya dialih keluar. Menggantikan token %H yang telah ditamatkan.

%BODY%
Digantikan dengan nilai yang ditentukan oleh pilihan --body. Lihat --body untuk lalai.
Menggantikan token %H yang telah ditamatkan.

--gunakan-token-data-lama
Dalam versi swaks sebelumnya, token DATA seperti yang diterangkan dalam pilihan --data di atas
menggunakan token aksara tunggal (cth, %F). Ini bukan pilihan yang bagus untuk lalai
token, dan terbukti sangat menyusahkan dengan bahasa yang dikodkan, bukan bahasa Inggeris di mana
gabungan watak ini mungkin biasa. Token aksara tunggal ialah
digantikan dengan versi yang kurang ralat-ralat yang disenaraikan di atas. Pengekalan daripada
token lama dan kemasukan pilihan ini untuk mengaktifkannya bertujuan sebagai a
bantuan sementara kepada pengguna yang mempunyai korpus mesej sedia ada menggunakan token lama. The
token aksara tunggal dan pilihan --use-old-data-token harus dipertimbangkan
ditamatkan dan berkemungkinan akan dialih keluar dalam keluaran seterusnya.

-dab, --buang-sebagai-badan
Jika --dump-as-body digunakan dan tiada pilihan lain digunakan untuk menukar badan lalai bagi
mesej, badan digantikan dengan output yang serupa dengan output apa yang ada
disediakan oleh --dump. --dump stanza keupayaan program awal tidak dipaparkan, dan
bahagian "data" tidak disertakan. Selain itu, --dump sentiasa menyertakan kata laluan.
Secara lalai --dump-as-body tidak termasuk kata laluan, walaupun ini boleh ditukar dengan
--dump-as-body-shows-password.

-dabsp, --dump-as-body-shows-password
Menyebabkan --dump-as-body memasukkan kata laluan teks biasa. Pilihan ini tidak disyorkan.
Pilihan ini membayangkan --dump-as-body.

--body [spesifikasi badan]
Nyatakan badan e-mel. Lalai ialah "Ini adalah mel ujian". Jika tidak
hujah kepada --body diberikan, segera untuk membekalkan satu secara interaktif. Jika '-' dibekalkan,
badan akan dibaca daripada input standard. Jika ada teks lain yang disediakan dan teks
mewakili fail boleh terbuka, kandungan fail itu digunakan sebagai badan. Jika ia
tidak mewakili fail yang boleh dibuka, teks itu sendiri digunakan sebagai badan.

Jika mesej dipaksa kepada format MIME (lihat --attach) hujah untuk pilihan ini
akan disertakan tanpa dikodkan sebagai bahagian MIME pertama. Jenis kandungannya akan sentiasa
teks / biasa.

--lampirkan [lampiran-spesifikasi]
Apabila satu atau lebih pilihan --attach dibekalkan, mesej ditukar menjadi a
mesej MIME berbilang bahagian/campuran. Argumen untuk --attach diproses sama seperti
--body berkenaan dengan stdin, kandungan fail, dsb. --attach boleh dibekalkan berbilang
kali untuk membuat beberapa lampiran. Secara lalai setiap lampiran dilampirkan sebagai a
fail aplikasi/strim oktet. Lihat --attach-type untuk menukar tingkah laku ini.

Jika nama fail ditentukan, pengekodan MIME akan menyertakan nama fail tersebut. Lihat
--attach-name untuk butiran lanjut tentang penamaan fail.

Sah untuk '-' (STDIN) dinyatakan sebagai hujah beberapa kali (sekali untuk
--body dan beberapa kali untuk --attach). Dalam kes ini, kandungan yang sama akan menjadi
dilampirkan setiap kali ia dinyatakan. Ini berguna untuk melampirkan kandungan yang sama
dengan pelbagai jenis MIME.

--attach-type [jenis-mime]
Secara lalai, kandungan yang dilampirkan MIME pada mesej dengan pilihan --attach ialah
dikodkan sebagai aplikasi/strim oktet. --attach-type menukar jenis mime untuk setiap
--lampirkan pilihan yang mengikutinya. Ia boleh dinyatakan beberapa kali.

--lampirkan-nama [nama]
Pilihan ini menetapkan nama fail yang akan disertakan dalam bahagian MIME yang dibuat untuk
pilihan --lampirkan seterusnya. Jika tiada hujah ditetapkan untuk pilihan ini, ia tidak menyebabkan nama fail
maklumat yang perlu disertakan untuk bahagian MIME seterusnya, walaupun swaks boleh menjananya
daripada nama fail tempatan.

-ah, --add-header [header]
Pilihan ini membolehkan pengepala ditambahkan pada DATA. Jika %H terdapat dalam DATA itu
digantikan dengan hujah untuk pilihan ini. Jika %H tidak hadir, hujahnya ialah
disisipkan di antara dua baris baharu pertama berturut-turut dalam DATA (iaitu, ia
disisipkan pada penghujung tajuk sedia ada).

Pilihan boleh sama ada ditentukan beberapa kali atau satu masa dengan berbilang
pengepala dipisahkan oleh rentetan '\n' literal. Jadi, "--add-header 'Foo: bar' --add-header
'Baz: foo'" dan "--add-header 'Foo: bar\nBaz: foo'" akhirnya menambah dua yang sama
tajuk.

--header [header-and-data], --h-Header [data]
Pilihan ini membenarkan cara untuk menukar pengepala yang sudah wujud dalam DATA. '--kepala
"Subjek: foo"' dan '--h-Subject foo' adalah setara. Jika pengepala belum lagi
wujud dalam data maka hujah ini berkelakuan sama dengan --add-header. Namun, jika
pengepala sudah wujud ia digantikan dengan yang ditentukan.

-g Jika dinyatakan, swaks akan membaca nilai DATA untuk mel daripada STDIN. Ini adalah
bersamaan dengan "--data -". Jika terdapat baris From_ dalam e-mel, ia akan dialih keluar
(tetapi lihat pilihan -nsf). Berguna untuk menyampaikan mesej sebenar (disimpan dalam fail) sebaliknya
menggunakan contoh mesej.

--tiada-pembetulan-data, -ndf
Pilihan ini memaksa swaks untuk tidak mengurut bahagian DATA e-mel. ini
termasuk penggantian token, Dari_ pelucutan, penambahan titik mengekor, --body/attachment
kemasukan, dan sebarang tambahan pengepala. Pilihan ini benar-benar hanya berguna apabila digunakan dengan
--data, kerana bahagian DATA lalai dalaman menggunakan token.

--tiada-strip-daripada, -nsf
Jangan tanggalkan baris From_ daripada bahagian DATA, jika ada.

OUTPUT PILIHAN

Secara lalai, swaks menyediakan transkrip transaksinya kepada pemanggilnya (STDOUT/STDERR).
Transkrip ini bertujuan untuk menjadi representasi urus niaga yang mungkin
walaupun ia mengubah suai output ini dengan menambahkan awalan maklumat pada baris dan oleh
menyediakan versi teks biasa transaksi TLS

"Awalan maklumat" dirujuk sebagai petunjuk transaksi. Petunjuk ini adalah
pada mulanya terdiri daripada garis penanda yang merupakan keluaran swaks itu sendiri, sama ada
mesej maklumat atau ralat, dan yang menunjukkan barisan data yang sebenarnya dihantar atau
diterima dalam transaksi. Jadual ini menunjukkan pembayang dan maknanya:

=== Menunjukkan garis maklumat yang dijana oleh swaks

*** Menunjukkan ralat yang dihasilkan dalam swaks

-> Menunjukkan baris yang dijangka dihantar oleh swaks ke pelayan sasaran

~> Menunjukkan talian dijangka disulitkan TLS yang dihantar oleh swaks ke pelayan sasaran

**> Menunjukkan baris yang tidak dijangka yang dihantar oleh swaks ke pelayan sasaran

*~> Menunjukkan talian yang disulitkan TLS, tidak dijangka yang dihantar oleh swaks ke pelayan sasaran

> Menunjukkan sebahagian mentah ujian yang dihantar oleh swaks ke pelayan sasaran (lihat --show-raw-text).
Tiada konsep "dijangka" atau "tidak dijangka" pada tahap ini.

<- Menunjukkan baris yang dijangka dihantar oleh pelayan sasaran ke swaks

<~ Menunjukkan talian dijangka disulitkan TLS yang dihantar oleh pelayan sasaran kepada swaks

<** Menunjukkan baris yang tidak dijangka yang dihantar oleh pelayan sasaran ke swaks

<~* Menunjukkan talian yang disulitkan TLS dan tidak dijangka yang dihantar oleh pelayan sasaran kepada swaks

< Menunjukkan sebahagian mentah teks yang diterima oleh swaks daripada pelayan sasaran (lihat
--show-raw-text). Tiada konsep "dijangka" atau "tidak dijangka" pada tahap ini.

Pilihan berikut mengawal apa dan bagaimana output dipaparkan kepada pemanggil.

-n, --sekat-data
Meringkaskan bahagian DATA transaksi SMTP dan bukannya mencetak setiap baris.
Pilihan ini sangat membantu, bersempadan dengan yang diperlukan, apabila menggunakan swaks untuk menghantar tertentu
e-mel ujian. E-mel dengan lampiran, sebagai contoh, akan mengatasi terminal dengan cepat
jika DATA tidak disekat.

-stl, --show-time-lapse [i]
Paparkan selang masa antara hantar/terima pasangan. Pilihan ini paling berguna apabila
Masa::HiRes tersedia, yang mana selang masa akan dipaparkan dalam
seperseribu saat. Jika Time::HiRes tidak tersedia atau "i" diberikan sebagai hujah
luput akan dipaparkan dalam saat integer sahaja.

-nih, --tiada-maklumat-petunjuk
Jangan paparkan pembayang transaksi untuk transaksi bermaklumat. Ini paling banyak
berguna apabila perlu menyalin sebahagian daripada baris maklumat, contohnya
output sijil daripada --tls-get-peer-cert.

-nsh, --tiada-hantar-petunjuk
-nrh, --tidak-terima-petunjuk
-nth, --tiada-petunjuk
--no-send-hints dan --no-receive-hints menyekat awalan transaksi daripada hantar dan
menerima talian, masing-masing. Ini selalunya berguna apabila menyalin sebahagian daripada
transaksi untuk digunakan di tempat lain (contohnya, "--no-send-hints --hide-receive
--hide-informational" ialah cara yang berguna untuk mendapatkan hanya arahan pihak klien untuk sesuatu yang diberikan
transaksi). --no-hints adalah sama dengan menentukan kedua-dua --no-send-hints dan
--tiada-terima-petunjuk.

Jangan tunjukkan petunjuk transaksi (berguna bersama -hr untuk membuat salinan/tampal-boleh
urus niaga).

-raw, --show-raw-text
Pilihan ini akan mencetak longgokan hex bagi data mentah yang dihantar dan diterima oleh swaks. Setiap hex
dump ialah kandungan satu bacaan atau tulis pada rangkaian. Ini sepatutnya
sama dengan apa yang telah dipaparkan (dengan pengecualian aksara \r
sedang dikeluarkan). Pilihan ini berguna untuk melihat butiran apabila pelayan menghantar lot
data dalam paket tunggal, atau memecahkan baris individu kepada beberapa paket. Jika
anda benar-benar perlu pergi secara mendalam di kawasan itu anda mungkin lebih baik dengan satu paket
sniffer, tetapi pilihan ini merupakan langkah pertama yang baik untuk melihat isu sambungan ganjil.

--fail keluaran
--output-file-stdout
--output-file-stderr
Pilihan ini membolehkan pengguna menghantar output ke fail dan bukannya stdout/stderr. The
pilihan pertama menghantar kedua-duanya ke fail yang sama. Hujah &STDOUT dan &STDERR ialah
dirawat secara khusus, merujuk kepada pemegang fail "biasa", jadi "--output-file-stderr
'&STDOUT'" akan mengubah hala STDERR ke STDOUT.

-pp, --protect-prompt
Jangan bergema input pengguna pada gesaan yang berpotensi sensitif (sekarang sahaja
kata laluan pengesahan). Lihat juga --auth-hide-password

-hr, --sembunyikan-terima
Jangan paparkan talian yang dihantar dari pelayan jauh yang diterima oleh swaks

-hs, --sembunyikan-hantar
Jangan paparkan talian yang dihantar oleh swaks ke pelayan jauh

-hai, --sembunyikan-maklumat
Jangan paparkan baris maklumat bukan ralat daripada swaks itu sendiri.

-ha, --sembunyikan-semua
Jangan paparkan sebarang kandungan ke terminal.

-S, --senyap [peringkat]
Menyebabkan swaks senyap. Jika tiada hujah diberikan atau jika hujah "1" diberikan,
cetak tiada keluaran melainkan/sehingga ralat berlaku, selepas itu semua keluaran ditunjukkan. Jika an
hujah "2" diberikan, hanya ralat cetakan. Jika "3" diberikan, tunjukkan tiada keluaran.

--sokongan
Keupayaan cetak dan keluar. Ciri tertentu memerlukan modul perl bukan standard.
Pilihan ini menilai sama ada modul ini ada dan memaparkan yang mana
kefungsian tersedia dan mana yang tidak, dan modul mana yang perlu ditambah
untuk mendapatkan fungsi yang hilang.

--pembuangan
Pilihan ini menyebabkan swaks mencetak hasil pemprosesan pilihan, sejurus sebelum itu
mel akan dihantar. Tiada mel akan dihantar apabila --dump digunakan. Perhatikan bahawa
--dump dianggap sebagai alat diagnosis diri yang tulen dan tiada usaha atau kehendak dibuat
pernah dibuat untuk menutup kata laluan dalam output --dump.

- membantu
Paparkan maklumat bantuan ini.

--versi
Paparkan maklumat versi.

KELULUSAN

SISTEM OPERASI
Program ini terutamanya bertujuan untuk digunakan pada sistem pengendalian seperti unix, dan ia
harus berfungsi pada mana-mana versi munasabahnya. Ia telah dibangunkan dan diuji pada
Solaris, Linux dan Mac OS X dan ciri lengkap pada semua ini.

Program ini diketahui menunjukkan fungsi asas pada Windows menggunakan
Perl ActiveState. Ia belum diuji sepenuhnya. Diketahui berfungsi ialah SMTP asas
kefungsian dan jenis pengesahan LOGIN, PLAIN dan CRAM-MD5. Tidak diketahui ialah sebarang TLS
kefungsian dan jenis pengesahan NTLM/SPA dan DIGEST-MD5.

Oleh kerana program ini harus berfungsi di mana-mana sahaja Perl berfungsi, saya sangat menghargai mengetahuinya
mana-mana sistem pengendalian baharu yang telah anda gunakan swaks secara menyeluruh serta sebarang masalah
ditemui pada OS baharu.

PELAYAN MEL
Program ini hampir dibangunkan secara eksklusif terhadap pelayan mel Exim. Ia telah berlaku
digunakan secara santai oleh pengarang, walaupun tidak diuji secara menyeluruh, dengan Sendmail, Smail,
Exchange, Suite Kolaborasi Oracle, qpsmtpd dan Communigate. Kerana semua
kefungsian dalam swaks adalah berdasarkan piawaian yang diketahui ia harus berfungsi dengan mana-mana secara adil
pelayan mel moden. Jika masalah ditemui, sila maklumkan pengarang di alamat
di bawah.

EXIT KOD

0 tiada ralat berlaku

1 ralat menghuraikan pilihan baris arahan

2 ralat menyambung ke pelayan jauh

3 jenis sambungan yang tidak diketahui

4 semasa berjalan dengan jenis sambungan "paip", masalah maut menulis atau membaca daripada
proses kanak-kanak

5 semasa berjalan dengan jenis sambungan "paip", proses kanak-kanak mati tanpa diduga. ini
boleh bermakna bahawa program yang ditentukan dengan --pipe tidak wujud.

6 Sambungan ditutup secara tidak dijangka. Jika penutupan dikesan sebagai tindak balas kepada 'QUIT'
swaks menghantar berikutan tindak balas yang tidak dijangka, kod ralat untuk yang tidak dijangka itu
tindak balas digunakan sebaliknya. Sebagai contoh, jika pelayan mel mengembalikan respons 550 kepada a
MAIL FROM: dan kemudian segera menutup sambungan, swaks mengesan bahawa
sambungan ditutup, tetapi menggunakan kod keluar yang lebih khusus 23 untuk memperincikan sifat
kegagalan. Jika sebaliknya pelayan mengembalikan kod 250 dan kemudian segera menutup kod
sambungan, swaks akan menggunakan kod keluar 6 kerana tiada jalan keluar yang lebih spesifik
kod.

10 ralat dalam prasyarat (modul yang diperlukan tidak tersedia)

21 ralat membaca sepanduk awal dari pelayan

22 ralat dalam transaksi HELO

23 ralat dalam transaksi MAIL

24 tiada RCPT diterima

25 pelayan mengembalikan ralat kepada permintaan DATA

26 pelayan tidak menerima mel berikutan data

27 pelayan mengembalikan ralat selepas permintaan berhenti sesi biasa

28 ralat dalam transaksi AUTH

29 ralat dalam transaksi TLS

32 ralat dalam EHLO berikutan rundingan TLS

33 ralat dalam transaksi XCLIENT

34 ralat dalam EHLO berikutan XCLIENT

TENTANG THE NAMA

Nama "swaks" ialah (semacam) akronim untuk "SWiss Army Knife Smtp". Ia dipilih untuk menjadi
agak berbeza dan boleh disebut. Manakala "swak" adalah unik sebagai nama perisian
pakej, ia mempunyai beberapa maksud lain, bukan perisian. Sila hantar kegunaan lain "swak" atau
"swak" untuk dimasukkan.

"Dimeteraikan dengan ciuman"
SWAK/SWAK muncul sekali-sekala di internet dengan maksud "dengan cinta".

buruk / miskin / sakit (Afrikaans)
Terlihat dalam tajuk "SA se bes en swaks gekledes pada 2011", yang diterjemahkan sebagai
"pakaian terbaik dan paling teruk" oleh penutur asli. Terjemahan Google tidak suka "swak
gekledes", tetapi ia akan menterjemahkan "swak" sebagai "miskin" dan "swak geklede" sebagai "berpakaian buruk".

HUBUNGI KAMI

[e-mel dilindungi]
Sila gunakan alamat ini untuk hubungan umum, soalan, tampalan, permintaan, dsb.

[e-mel dilindungi]
Jika anda ingin dimasukkan ke dalam senarai untuk menerima pemberitahuan apabila versi baharu
swaks dikeluarkan, sila hantar e-mel ke alamat ini.

http://www.jetmore.org/john/code/swaks/
Log perubahan, bantuan ini dan versi terkini ditemui di pautan ini.

Gunakan swaks dalam talian menggunakan perkhidmatan onworks.net