Ito ang command sieve-test na maaaring patakbuhin sa OnWorks na libreng hosting provider gamit ang isa sa aming maramihang libreng online na workstation gaya ng Ubuntu Online, Fedora Online, Windows online emulator o MAC OS online emulator
PROGRAMA:
NAME
sieve-test - Pigeonhole's Sieve script tester
SINOPSIS
salaan-pagsusulit [pagpipilian] script-file mail-file
DESCRIPTION
Ang salaan-pagsusulit Ang command ay bahagi ng Pigeonhole Project (butas ng kalapati(7)), na nagdaragdag ng Salain
(RFC 5228) na suporta sa Dovecot secure na IMAP at POP3 server (kulungan ng kalapati(1)).
Paggamit ng salaan-pagsusulit utos, maaaring masuri ang pagpapatupad ng mga script ng Sieve. Ito ay sinusuri
ang script para sa ibinigay na mensahe, na nagbubunga ng isang hanay ng mga pagkilos ng Salain. Maliban kung ang -e opsyon
ay tinukoy, hindi nito aktwal na isinasagawa ang mga pagkilos na ito, ibig sabihin ay hindi ito nag-iimbak
o ipasa ang mensahe kahit saan. Sa halip, nagpi-print ito ng detalyadong listahan ng kung anong mga aksyon ang gagawin
karaniwang nagaganap. Tandaan na, kahit kailan -e ay tinukoy, walang mensahe kailanman
ipinadala sa mga remote na tatanggap ng SMTP. Ang mga papalabas na mensahe ay palaging naka-print sa stdout
sa halip.
Ito ay isang napaka-kapaki-pakinabang na tool upang i-debug ang pagpapatupad ng mga script ng Sieve. Maaari itong magamit sa
i-verify ang mga bagong naka-install na script para sa nilalayon na gawi at makakapagbigay ito ng mas detalyado
impormasyon tungkol sa mga problema sa pagpapatupad ng script na iniulat ng Sieve plugin, para sa
halimbawa sa pamamagitan ng pagsubaybay sa pagpapatupad at pagsusuri ng mga utos at pagsusulit ayon sa pagkakabanggit.
Opsyon
-a orig-recipient-address
Ang orihinal na address ng tatanggap ng sobre. Ito ang gagawin ng pagsubok sa sobre ng Sieve
ihambing kung kailan hiniling ang bahagi ng "to" na sobre. Ang ilang mga pagsubok at aksyon ay gagawin
gamitin din ito bilang e-mail address ng may-ari ng script. Kung aalisin ang opsyong ito, ang
ang address ng tatanggap ay kinukuha mula sa mga header ng mensahe na "Sobre-To:", o "To:."
Kung wala rin sa mga header na ito, ang address ng tatanggap ay magde-default sa
[protektado ng email].
-c config-file
Alternatibong Dovecot configuration file path.
-C Force compilation. Bilang default, ang pinagsama-samang binary ay naka-imbak sa disk. Kapag ganito
binary ay matatagpuan sa panahon ng susunod na pagpapatupad ng salaan-pagsusulit at oras ng pagbabago nito
ay mas bago kaysa sa script file, ito ay ginagamit at ang script ay hindi pinagsama-sama
muli. Pinipilit ng pagpipiliang ito na i-compile ang script, kaya hindi pinapansin ang anumang kasalukuyan
binary. Sumangguni sa salaanc(1) para sa higit pang impormasyon tungkol sa compilation ng Sieve.
-D Paganahin ang Sieve debugging.
-d dump-file
Nagiging sanhi ng isang dump ng nabuong code upang maisulat sa tinukoy na file. Ito ay
kapareho ng dump na ginawa ng salaan-dump(1). Ang paggamit ng '-' bilang filename ay nagiging sanhi ng
dump para sulatan stdout.
-e Pinapagana ang tunay na pagpapatupad ng hanay ng mga aksyon na nagreresulta mula sa pagpapatakbo ng script.
Kasabay ng -l parameter, ang aktwal na paghahatid ng mga mensahe ay maaaring
sinubok. Tandaan na hindi ito magpapadala ng anumang mensahe sa mga remote na tatanggap ng SMTP.
Ang mga naturang pagkilos ay nagpi-print lamang ng papalabas na mensahe sa stdout.
-f envelope-sender
Ang address ng nagpadala ng sobre (daanan sa pagbabalik). Ito ang gagawin ng pagsubok sa sobre ng Sieve
ihambing kung kailan hiniling ang bahaging "mula sa" sobre. Gayundin, dito ang tugon
ang mga mensahe ay 'ipinadala' sa. Kung ang pagpipiliang ito ay tinanggal, ang address ng nagpadala ay kukunin
mula sa "Return-Path:", "Sender:" o "From:" na mga header ng mensahe. Kung wala sa mga ito
naroroon ang mga header, ang address ng sobre ng nagpadala ay nagde-default sa
[protektado ng email].
-l lokasyon ng koreo
Ang lokasyon ng mail store ng user. Ang syntax ng pagpipiliang ito lokasyon ng koreo
Ang parameter ay magkapareho sa kung ano ang ginagamit para sa setting ng mail_location sa Dovecot
config file. Ang parameter na ito ay karaniwang ginagamit kasama ng -e upang subukan ang
aktwal na paghahatid ng mga mensahe. Kung -l ay tinanggal kapag -e ay tinukoy, tindahan ng mail
Nilaktawan ang mga aksyon tulad ng fileinto at keep.
-m default-mailbox
Ang mailbox kung saan iniimbak ng keep action ang mensahe. Ito ay "INBOX" bilang default.
-r recipient-address
Ang huling address ng tatanggap ng sobre. Gagamitin ito ng ilang pagsubok at pagkilos bilang ang
e-mail address ng may-ari ng script. Halimbawa, ito ang ginagamit ng bakasyon
aksyon upang suriin kung naaangkop ang isang tugon. Kung ang -r ang opsyon ay tinanggal, ang
ang orihinal na address ng tatanggap ng sobre ay gagamitin sa halip (tingnan -a opsyon para sa higit pa
impormasyon).
-s script-file
Tukuyin ang mga karagdagang script na isasagawa bago ang pangunahing script. Maramihan -s
pinapayagan ang mga argumento at ang mga tinukoy na script ay isinasagawa nang sunud-sunod sa
order na tinukoy sa command line.
-t trace-file
Pinapagana ang runtime trace debugging. Ang trace debugging ay nagbibigay ng detalyadong insight sa
mga operasyong isinagawa ng Sieve script. Sumangguni sa runtime trace debugging
seksyon sa ibaba. Ang bakas na impormasyon ay nakasulat sa tinukoy na file. Gamit ang '-'
dahil ang filename ay nagiging sanhi ng pagsusulatan ng trace data stdout.
-T bakas-opsyon
Kino-configure ang runtime trace debugging, na pinagana gamit ang -t na opsyon. Sumangguni sa
ang seksyon ng pag-debug ng runtime trace sa ibaba.
-x mga extension
Itakda ang magagamit na mga extension. Ang parameter ay isang hiwalay na espasyo na listahan ng mga aktibo
mga extension. Sa pamamagitan ng paglalagay ng mga extension identifier gamit ang + or -, ang mga extension ay maaaring
kasama o ibinukod kaugnay sa naka-configure na hanay ng mga aktibong extension. Kung hindi
ang mga extension ay may a + or - prefix, tanging ang mga extension na tahasang nakalista
paganahin. Binabalewala ang mga hindi kilalang extension at may ginawang babala.
Halimbawa -x Ang "+imapflags -enotify" ay magbibigay-daan sa hindi na ginagamit na extension ng imapflags
at huwag paganahin ang extension ng enotify. Ang natitirang mga aktibong extension ay nakasalalay sa
salaan_mga extension at salain_global_extension mga setting. Bilang default, ibig sabihin, kapag
salaan_mga extension at salain_global_extension manatiling hindi naka-configure, lahat ay suportado
available ang mga extension, maliban sa mga hindi na ginagamit na extension o sa mga hindi na ginagamit
sa ilalim ng pag-unlad.
MGA PANGANGATWIRANG
script-file
Tinutukoy ang script na (i-compile at) isasagawa.
Tandaan na ang tool na ito ay naghahanap ng isang pre-compiled binary file na may a .svbin karugtong
at may basename at landas na magkapareho sa tinukoy na script. Gamitin ang -C pagpipilian sa
huwag paganahin ang pag-uugali na ito sa pamamagitan ng pagpilit sa script na i-compile sa isang bagong binary.
mail-file
Tinutukoy ang file na naglalaman ng mensaheng e-mail upang subukan.
PAGGAMIT
RUNTIME TRACE NAG-DEBUGG
Paggamit ng -t opsyon, ang salaan-pagsusulit maaaring i-configure ang tool upang mag-print ng detalyadong bakas
impormasyon sa pagpapatupad ng Sieve script sa isang file o karaniwang output. Halimbawa, ang
nakatagpo ng mga utos, ang mga isinagawang pagsubok at ang mga katugmang halaga ay maaaring i-print.
Maaaring i-configure ang runtime trace gamit ang -T opsyon, na maaaring tukuyin ng maramihan
beses. Maaari itong gamitin bilang mga sumusunod:
-Tlevel=...
Itakda ang antas ng detalye ng pag-debug ng bakas. Ang isa sa mga sumusunod na halaga ay maaaring
ibinigay:
pagkilos (default)
I-print lamang ang mga naisagawang command na aksyon, tulad ng keep, fileinnto, reject at redirect.
utos
Mag-print ng anumang naisagawang command, hindi kasama ang mga test command.
pagsusulit
I-print ang lahat ng naisagawang utos at isinagawa na mga pagsubok.
pagtutugma
I-print ang lahat ng naisagawang utos, isinagawa na mga pagsubok at ang mga halagang tumugma sa mga pagsubok na iyon.
-Tdebug
Mag-print din ng mga mensahe ng debug. Ito ay kadalasang kapaki-pakinabang lamang para sa mga developer at malamang
upang makagawa ng magulo na output.
-Mga Taddress
I-print ang mga address ng byte code para sa kasalukuyang trace na output. Karaniwan, ang kasalukuyang Salain lamang
Ang posisyon ng source code (line number) ay naka-print. Ang mga address ng byte code ay katumbas ng
ang mga nakalista sa binary dump na ginawa gamit ang -d opsyon o sa pamamagitan ng salaan-dump(1)
utos.
MGA DEBUG salaan EXTENSION
Upang mapabuti ang pag-debug ng script, sinusuportahan ng pagpapatupad ng Sieve na ito ang isang custom na wika ng Sieve
extension na tinatawag na 'vnd.dovecot.debug'. Idinagdag nito ang debug_log utos na nagpapahintulot sa pag-log
i-debug ang mga mensahe.
Halimbawa:
nangangailangan ng "vnd.dovecot.debug";
kung ang header :contains "subject" "hello" {
debug_log "Ang header ng paksa ay naglalaman ng hello!";
}
Mga tool tulad ng salaan-pagsusulit, salaanc at salaan-dump may suporta para sa vnd.dovecot.debug
extension ay pinagana bilang default at hindi kinakailangan na paganahin o posible na huwag paganahin ang
availability ng debug extension na may -x opsyon. Ang mga naka-log na mensahe ay isinulat sa
stdout sa kasong ito.
Sa kaibahan, para sa aktwal na Sieve plugin para sa Dovecot LDA (dovecot-lda(1)) ang
Kailangang tahasang paganahin ang extension ng vnd.dovecot.debug gamit ang salaan_mga extension
setting. Ang mga mensahe ay naka-log sa pribadong script log file ng user. Kung gagamitin sa a
global script, ang mga mensahe ay naka-log sa pamamagitan ng default na Dovecot logging facility.
EXIT STATUS
salaan-pagsusulit ay lalabas gamit ang isa sa mga sumusunod na halaga:
0 Naging matagumpay ang pagpapatupad. (EX_OK, EXIT_SUCCESS)
1 Nabigo ang operasyon. Ito ay ibinalik para sa halos lahat ng mga pagkabigo. (EXIT_FAILURE)
64 Invalid na parameter ang ibinigay. (EX_USAGE)
Gumamit ng sieve-test online gamit ang mga serbisyo ng onworks.net