sieve-test - Online di Cloud

PROGRAM:

NAMA

sieve-test - penguji skrip Saringan Pigeonhole

RINGKASAN

uji saringan [Pilihan] file skrip file surat

DESKRIPSI

uji saringan perintah adalah bagian dari Proyek Pigeonhole (mengesampingkan(7)), yang menambahkan Saringan
(RFC 5228) mendukung server IMAP dan POP3 Dovecot yang aman (tempat perlindungan merpati(1)).

Menggunakan uji saringan perintah, eksekusi skrip Saringan dapat diuji. Ini mengevaluasi
skrip untuk pesan yang diberikan, menghasilkan serangkaian tindakan Saringan. Kecuali jika -e Option
ditentukan, itu tidak benar-benar menjalankan tindakan ini, artinya tidak menyimpan
atau meneruskan pesan di mana saja. Sebagai gantinya, itu mencetak daftar terperinci tentang tindakan apa yang akan
biasanya berlangsung. Perhatikan bahwa, bahkan ketika -e ditentukan, tidak ada pesan yang pernah ada
ditransmisikan ke penerima SMTP jarak jauh. Pesan keluar selalu dicetak ke stdout
sebagai gantinya.

Ini adalah alat yang sangat berguna untuk men-debug eksekusi skrip Saringan. Dapat digunakan untuk
memverifikasi skrip yang baru diinstal untuk perilaku yang dimaksud dan dapat memberikan lebih detail
informasi tentang masalah eksekusi skrip yang dilaporkan oleh plugin Saringan, untuk
contoh dengan menelusuri eksekusi dan evaluasi perintah dan tes masing-masing.

PILIHAN

-a asal-penerima-alamat
Alamat penerima amplop asli. Inilah yang akan dilakukan oleh tes amplop Saringan
bandingkan dengan saat bagian amplop "ke" diminta. Beberapa tes dan tindakan akan
juga gunakan ini sebagai alamat email pemilik skrip. Jika opsi ini dihilangkan,
alamat penerima diambil dari header pesan "Amplop-Ke:", atau "Kepada:".
Jika tidak ada header ini yang ada, alamat penerima default ke
penerima@contoh.com.

-c file konfigurasi
Jalur file konfigurasi Dovecot alternatif.

-C Kompilasi paksa. Secara default, biner yang dikompilasi disimpan di disk. Kapan ini
biner ditemukan selama eksekusi berikutnya dari uji saringan dan waktu modifikasinya
lebih baru daripada file skrip, digunakan dan skrip tidak dikompilasi
lagi. Opsi ini memaksa skrip untuk dikompilasi, sehingga mengabaikan hadiah apa pun
biner. Mengacu pada saringan(1) untuk informasi lebih lanjut tentang kompilasi Saringan.

-D Aktifkan debug Saringan.

-d file sampah
Menyebabkan dump kode yang dihasilkan ditulis ke file yang ditentukan. Ini adalah
identik dengan sampah yang dihasilkan oleh saringan-buang(1). Menggunakan '-' sebagai nama file menyebabkan
dump untuk ditulis ke stdout.

-e Mengaktifkan eksekusi sebenarnya dari serangkaian tindakan yang dihasilkan dari menjalankan skrip.
Dalam kombinasi dengan -l parameter, pengiriman pesan yang sebenarnya dapat
diuji. Perhatikan bahwa ini tidak akan mengirimkan pesan apa pun ke penerima SMTP jarak jauh.
Tindakan tersebut hanya mencetak pesan keluar ke stdout.

-f amplop-pengirim
Alamat pengirim amplop (jalur kembali). Inilah yang akan dilakukan oleh tes amplop Saringan
bandingkan dengan saat bagian amplop "dari" diminta. Juga, di sinilah respons
pesan 'dikirim' ke. Jika opsi ini dihilangkan, alamat pengirim akan diambil
dari header pesan "Jalur Kembali:", "Pengirim:" atau "Dari:". Jika tidak satu pun dari ini
header juga ada, alamat amplop pengirim default ke
pengirim@contoh.com.

-l lokasi surat
Lokasi toko email pengguna. Sintaks dari opsi ini lokasi surat
parameter identik dengan apa yang digunakan untuk pengaturan mail_location di Dovecot
berkas konfigurasi. Parameter ini biasanya digunakan dalam kombinasi dengan -e untuk menguji
penyampaian pesan yang sebenarnya. Jika -l dihilangkan ketika -e ditentukan, toko surat
tindakan seperti fileinto dan keep dilewati.

-m kotak surat default
Kotak surat tempat tindakan keep menyimpan pesan. Ini adalah "INBOX" secara default.

-r alamat penerima
Alamat penerima amplop terakhir. Beberapa tes dan tindakan akan menggunakan ini sebagai
alamat email pemilik skrip. Misalnya, ini yang digunakan oleh liburan
tindakan untuk memeriksa apakah balasan sesuai. jika -r opsi dihilangkan,
alamat penerima amplop asli akan digunakan sebagai gantinya (lihat -a pilihan untuk lebih banyak
informasi).

-s file skrip
Tentukan skrip tambahan yang akan dieksekusi sebelum skrip utama. Beberapa -s
argumen diperbolehkan dan skrip yang ditentukan dieksekusi secara berurutan di
pesanan yang ditentukan pada baris perintah.

-t jejak-file
Mengaktifkan proses debug pelacakan waktu proses. Jejak debug memberikan wawasan mendetail dalam
operasi yang dilakukan oleh skrip Saringan. Lihat debugging jejak runtime
bagian di bawah. Informasi jejak ditulis ke file yang ditentukan. Menggunakan '-'
karena nama file menyebabkan data jejak ditulis ke stdout.

-T opsi jejak
Mengonfigurasi runtime trace debugging, yang diaktifkan dengan opsi -t. Mengacu pada
bagian debugging jejak runtime di bawah ini.

-x ekstensi
Setel ekstensi yang tersedia. Parameternya adalah daftar aktif yang dipisahkan oleh spasi
ekstensi. Dengan menambahkan pengidentifikasi ekstensi dengan + or -, ekstensi bisa
disertakan atau dikecualikan relatif terhadap kumpulan ekstensi aktif yang dikonfigurasi. Jika tidak
ekstensi memiliki + or - awalan, hanya ekstensi yang secara eksplisit terdaftar
akan diaktifkan. Ekstensi yang tidak dikenal diabaikan dan peringatan dibuat.

Misalnya -x "+imapflags -enotify" akan mengaktifkan ekstensi imapflags yang tidak digunakan lagi
dan nonaktifkan ekstensi enotify. Ekstensi aktif lainnya bergantung pada
saringan_ekstensi dan saringan_global_ekstensi pengaturan. Secara default, yaitu ketika
saringan_ekstensi dan saringan_global_ekstensi tetap tidak dikonfigurasi, semua didukung
ekstensi tersedia, kecuali untuk ekstensi yang tidak digunakan lagi atau yang masih ada
dalam pengembangan.

ARGUMEN

file skrip
Menentukan skrip untuk (mengkompilasi dan) mengeksekusi.

Perhatikan bahwa alat ini mencari file biner yang telah dikompilasi sebelumnya dengan a .svbin perpanjangan
dan dengan nama dasar dan jalur yang identik dengan skrip yang ditentukan. Menggunakan -C pilihan untuk
nonaktifkan perilaku ini dengan memaksa skrip untuk dikompilasi menjadi biner baru.

file surat
Menentukan file yang berisi pesan email untuk diuji.

PENGGUNAAN

WAKTU JALAN TRACE DEBUGING
Menggunakan -t opsi, opsi uji saringan alat dapat dikonfigurasi untuk mencetak jejak terperinci
informasi tentang eksekusi skrip Saringan ke file atau output standar. Misalnya,
perintah yang ditemui, tes yang dilakukan dan nilai yang cocok dapat dicetak.

Jejak runtime dapat dikonfigurasi menggunakan -T opsi, yang dapat ditentukan beberapa
waktu. Ini dapat digunakan sebagai berikut:

-Tingkat =...
Setel tingkat detail debug pelacakan. Salah satu dari nilai berikut dapat menjadi
dipasok:

tindakan (Default)
Hanya mencetak perintah tindakan yang dieksekusi, seperti keep, fileinto, reject, dan redirect.

perintah
Cetak semua perintah yang dijalankan, kecuali perintah pengujian.

tes
Cetak semua perintah yang dieksekusi dan tes yang dilakukan.

sesuai
Cetak semua perintah yang dieksekusi, tes yang dilakukan, dan nilai yang cocok dengan tes tersebut.

-debug
Cetak pesan debug juga. Ini biasanya hanya berguna untuk pengembang dan kemungkinan
untuk menghasilkan output yang berantakan.

-Alamat
Cetak alamat kode byte untuk keluaran jejak saat ini. Biasanya, hanya Saringan saat ini
posisi kode sumber (nomor baris) dicetak. Alamat kode byte sama dengan
yang terdaftar dalam dump biner yang diproduksi menggunakan -d pilihan atau dengan saringan-buang(1)
perintah.

DEBUG SARINGAN EXTENSION
Untuk meningkatkan debugging skrip, implementasi Saringan ini mendukung bahasa Saringan khusus
ekstensi yang disebut 'vnd.dovecot.debug'. Itu menambahkan debug_log perintah yang memungkinkan logging
pesan debug.

Contoh:

memerlukan "vnd.dovecot.debug";

if header : berisi "subjek" "halo" {

debug_log "Header subjek berisi halo!";

}

Alat seperti uji saringan, saringan dan saringan-buang memiliki dukungan untuk vnd.dovecot.debug
ekstensi diaktifkan secara default dan tidak perlu mengaktifkan atau menonaktifkan
ketersediaan ekstensi debug dengan -x pilihan. Pesan yang dicatat ditulis ke
stdout pada kasus ini.

Sebaliknya, untuk plugin Saringan sebenarnya untuk Dovecot LDA (tempat perlindungan merpati-lda(1))
ekstensi vnd.dovecot.debug harus diaktifkan secara eksplisit menggunakan saringan_ekstensi
pengaturan. Pesan-pesan tersebut kemudian dicatat ke file log skrip pribadi pengguna. Jika digunakan dalam
global script, pesan dicatat melalui fasilitas default Dovecot logging.

EXIT STATUS

uji saringan akan keluar dengan salah satu nilai berikut:

0 Eksekusi berhasil. (EX_OK, EXIT_SUCCESS)

1 Operasi gagal. Ini dikembalikan untuk hampir semua kegagalan. (EXIT_FAILURE)

64 Parameter yang diberikan tidak valid. (EX_USAGE)

Gunakan uji saringan online menggunakan layanan onworks.net