sieve-test - آنلاین در ابر

برنامه:

نام

sieve-test - تستر اسکریپت غربال Pigeonhole

خلاصه

تست غربال [گزینه های] فایل اسکریپت فایل پستی

شرح

La تست غربال فرمان بخشی از پروژه Pigeonhole است (کبوتر چاله(7))، که Sieve را اضافه می کند
(RFC 5228) از سرور امن IMAP و POP3 Dovecot (کبوترخانه(1).

با استفاده از تست غربال دستور، اجرای اسکریپت های Sieve را می توان آزمایش کرد. این ارزیابی می کند
اسکریپت پیام ارائه شده، مجموعه ای از اقدامات Sieve را ارائه می دهد. مگر اینکه -e انتخاب
مشخص شده است، در واقع این اقدامات را اجرا نمی کند، به این معنی که ذخیره نمی کند
یا پیام را در هر حال فوروارد کنید. درعوض، فهرستی دقیق از اقدامات انجام شده را چاپ می کند
به طور معمول برگزار می شود. توجه داشته باشید که، حتی زمانی که -e مشخص شده است، هیچ پیامی هرگز وجود ندارد
به گیرندگان SMTP از راه دور منتقل می شود. پیام های خروجی همیشه در چاپ می شوند stdout
به جای آن.

این یک ابزار بسیار مفید برای اشکال زدایی اجرای اسکریپت های Sieve است. می توان از آن استفاده کرد
بررسی اسکریپت های تازه نصب شده برای رفتار مورد نظر و می تواند جزئیات بیشتری را ارائه دهد
اطلاعات مربوط به مشکلات اجرای اسکریپت که توسط افزونه Sieve گزارش شده است، برای
به عنوان مثال با ردیابی اجرا و ارزیابی دستورات و تست ها به ترتیب.

OPTIONS

-a مبدا-گیرنده-آدرس
آدرس گیرنده پاکت اصلی این همان چیزی است که تست پاکت Sieve انجام می دهد
مقایسه با زمانی که قسمت پاکت "to" درخواست شده است. برخی از آزمایش ها و اقدامات انجام خواهد شد
همچنین از این به عنوان آدرس ایمیل صاحب اسکریپت استفاده کنید. اگر این گزینه حذف شود،
آدرس گیرنده از سرفصل های پیام "Envelope-To:" یا "To:" بازیابی می شود.
اگر هیچ یک از این سرصفحه ها وجود نداشته باشد، آدرس گیرنده به طور پیش فرض روی می دهد
[ایمیل محافظت شده].

-c فایل پیکربندی
مسیر فایل پیکربندی جایگزین Dovecot.

-C تدوین نیرو. به طور پیش فرض، باینری کامپایل شده روی دیسک ذخیره می شود. وقتی این
باینری در طول اجرای بعدی یافت می شود تست غربال و زمان اصلاح آن
جدیدتر از فایل اسکریپت است، استفاده می شود و اسکریپت کامپایل نشده است
از نو. این گزینه اسکریپت را مجبور می کند تا کامپایل شود، بنابراین هیچ موجودی نادیده گرفته می شود
دودویی. رجوع شود به sievec(1) برای اطلاعات بیشتر در مورد کامپایل Sieve.

-D Sieve debugging را فعال کنید.

-d فایل روگرفت
باعث می شود که کد تولید شده روی فایل مشخص شده نوشته شود. این هست
یکسان به زباله تولید شده توسط غربال کردن(1). استفاده از '-' به عنوان نام فایل باعث می شود
روگرفتی که به آن نوشته شود stdout.

-e اجرای واقعی مجموعه اقداماتی را که از اجرای اسکریپت حاصل می شود را فعال می کند.
در ترکیب با -l پارامتر، تحویل واقعی پیام ها می تواند باشد
تست شده توجه داشته باشید که با این کار هیچ پیامی به گیرندگان SMTP راه دور ارسال نمی شود.
چنین اقداماتی فقط پیام خروجی را چاپ می کنند stdout.

-f پاکت نامه
آدرس فرستنده پاکت نامه (مسیر برگشت). این همان چیزی است که تست پاکت Sieve انجام می دهد
مقایسه با زمانی که قسمت پاکت "از" درخواست شده است. همچنین، این جایی است که پاسخ
پیام ها به "ارسال می شوند". اگر این گزینه حذف شود، آدرس فرستنده بازیابی می شود
از سرفصل های پیام "Return-Path:"، "Sender:" یا "From:". اگر هیچ کدام از اینها نیست
هدرها نیز وجود دارد، آدرس پاکت فرستنده به صورت پیش‌فرض است
[ایمیل محافظت شده].

-l مکان پستی
مکان فروشگاه ایمیل کاربر. نحو این گزینه است مکان پستی
پارامتر با آنچه برای تنظیم mail_location در Dovecot استفاده می شود یکسان است
فایل پیکربندی این پارامتر معمولاً در ترکیب با -e برای آزمایش
تحویل واقعی پیام ها اگر -l زمانی که حذف می شود -e مشخص شده است، فروشگاه پست
اقداماتی مانند fileinto و keep نادیده گرفته می شوند.

-m صندوق پستی پیش فرض
صندوق پستی که در آن اکشن keep پیام را ذخیره می کند. این به طور پیش فرض "INBOX" است.

-r آدرس گیرنده
آدرس گیرنده پاکت نهایی برخی از آزمایش ها و اقدامات از این به عنوان استفاده می کنند
آدرس ایمیل صاحب اسکریپت به عنوان مثال، این چیزی است که در تعطیلات استفاده می شود
اقدامی برای بررسی مناسب بودن پاسخ اگر -r گزینه حذف شده است،
به جای آن از آدرس گیرنده پاکت اصلی استفاده می شود (نگاه کنید به -a گزینه ای برای بیشتر
اطلاعات)

-s فایل اسکریپت
اسکریپت های اضافی را برای اجرا قبل از اسکریپت اصلی مشخص کنید. چندگانه -s
آرگومان ها مجاز هستند و اسکریپت های مشخص شده به صورت متوالی در برنامه اجرا می شوند
سفارش مشخص شده در خط فرمان

-t فایل ردیابی
اشکال زدایی ردیابی زمان اجرا را فعال می کند. اشکال زدایی ردیابی بینش دقیقی را در
عملیات انجام شده توسط اسکریپت Sieve. به اشکال زدایی ردیابی زمان اجرا مراجعه کنید
بخش زیر اطلاعات ردیابی در فایل مشخص شده نوشته می شود. استفاده كردن '-'
به عنوان نام فایل باعث می شود که داده ردیابی در آن نوشته شود stdout.

-T گزینه ردیابی
اشکال زدایی ردیابی زمان اجرا را که با گزینه -t فعال می شود، پیکربندی می کند. رجوع شود به
بخش اشکال زدایی ردیابی زمان اجرا در زیر.

-x ضمیمهها
پسوندهای موجود را تنظیم کنید. این پارامتر یک لیست فعال با فاصله جدا شده است
پسوندها با اضافه کردن شناسه های پسوند با + or -، پسوندها می توانند باشند
نسبت به مجموعه پیکربندی شده پسوندهای فعال گنجانده یا مستثنی شده است. اگر نه
پسوندها دارای یک + or - پیشوند، فقط پسوندهایی که به صراحت فهرست شده اند
فعال خواهد شد. پسوندهای ناشناخته نادیده گرفته می شوند و یک اخطار تولید می شود.

مثلا -x "+imapflags -enotify" پسوند منسوخ شده imapflags را فعال می کند
و پسوند enotify را غیرفعال کنید. بقیه پسوندهای فعال به این بستگی دارد
sieve_extensions و sieve_global_extensions تنظیمات. به طور پیش فرض، یعنی چه زمانی
sieve_extensions و sieve_global_extensions پیکربندی نشده باقی می ماند، همه پشتیبانی می شوند
برنامه های افزودنی در دسترس هستند، به جز برنامه های افزودنی منسوخ شده یا آنهایی که هنوز هستند
در حال توسعه.

ادله

فایل اسکریپت
اسکریپت را برای (کامپایل و) اجرا مشخص می کند.

توجه داشته باشید که این ابزار به دنبال یک فایل باینری از پیش کامپایل شده با a است svbin گسترش
و با نام پایه و مسیر یکسان با اسکریپت مشخص شده است. استفاده کنید -C گزینه ای برای
با اجبار کردن اسکریپت به یک باینری جدید، این رفتار را غیرفعال کنید.

فایل پستی
فایل حاوی پیام ایمیل برای آزمایش را مشخص می کند.

طریقه استفاده

زمان اجرا TRACE اشکال زدایی
با استفاده از -t گزینه، تست غربال ابزار را می توان برای چاپ ردیابی دقیق پیکربندی کرد
اطلاعات مربوط به اجرای اسکریپت Sieve به یک فایل یا خروجی استاندارد. به عنوان مثال
دستورات مواجه شده، تست های انجام شده و مقادیر مطابقت داده شده را می توان چاپ کرد.

ردیابی زمان اجرا را می توان با استفاده از پیکربندی کرد -T گزینه ای که می توان آن را چندگانه مشخص کرد
بار. می توان از آن به صورت زیر استفاده کرد:

-سطح=...
سطح جزئیات اشکال زدایی ردیابی را تنظیم کنید. یکی از مقادیر زیر می تواند باشد
عرضه شده:

اقدامات (به طور پیش فرض)
فقط دستورات اکشن اجرا شده را چاپ کنید، مانند keep، fileinto، reject و redirect.

دستورات
هر دستور اجرا شده را به استثنای دستورات آزمایشی چاپ کنید.

تست
تمام دستورات اجرا شده و تست های انجام شده را چاپ کنید.

مطابق
تمام دستورات اجرا شده، تست های انجام شده و مقادیر مطابق با آن تست ها را چاپ کنید.

-Tdebug
پیام های اشکال زدایی را نیز چاپ کنید. این معمولا فقط برای توسعه دهندگان مفید است و احتمال دارد
برای تولید خروجی نامرتب

-تادرس ها
آدرس های کد بایت را برای خروجی ردیابی فعلی چاپ کنید. به طور معمول، فقط غربال فعلی
موقعیت کد منبع (شماره خط) چاپ شده است. آدرس های کد بایت برابر است با
آنهایی که در یک دامپ باینری فهرست شده اند با استفاده از -d گزینه یا توسط غربال کردن(1)
فرمان

اشکال زدایی الک افزونه
برای بهبود اشکال زدایی اسکریپت، این پیاده سازی Sieve از یک زبان Sieve سفارشی پشتیبانی می کند
پسوند به نام "vnd.dovecot.debug". را اضافه می کند debug_log دستوری که اجازه ورود به سیستم را می دهد
پیام های اشکال زدایی

مثال:

نیاز به "vnd.dovecot.debug";

if header : حاوی "موضوع" "Hello" {

debug_log "سرصفحه موضوع شامل سلام است!";

}

ابزارهایی مانند تست غربال, sievec و غربال کردن از vnd.dovecot.debug پشتیبانی کنید
برنامه افزودنی به طور پیش فرض فعال است و نه ضروری است و نه ممکن است غیرفعال شود
در دسترس بودن پسوند اشکال زدایی با -x گزینه. پیام‌های ثبت‌شده در آن نوشته می‌شوند
stdout در این مورد.

در مقابل، برای پلاگین Sieve واقعی برای Dovecot LDA (کبوتر-لدا(1))
پسوند vnd.dovecot.debug باید به صراحت با استفاده از این فعال شود sieve_extensions
تنظیمات. سپس پیام ها به فایل لاگ اسکریپت خصوصی کاربر وارد می شوند. اگر در الف استفاده شود
اسکریپت جهانی، پیام‌ها از طریق تسهیلات پیش‌فرض Dovecot ثبت می‌شوند.

خروج وضعیت

تست غربال با یکی از مقادیر زیر خارج می شود:

0 اعدام با موفقیت انجام شد. (EX_OK، EXIT_SUCCESS)

1 عملیات شکست خورد. این تقریباً برای تمام خرابی ها برگردانده می شود. (EXIT_FAILURE)

64 پارامتر نامعتبر داده شده است. (EX_USAGE)

با استفاده از خدمات onworks.net از Sieve-test آنلاین استفاده کنید