clamav-milter.conf(5)           Clam AntiVirus           clamav-milter.conf(5)

نام (NAME)
       clamav-milter.conf - پرونده پیکربندی برای clamav-milter

توضیحات (DESCRIPTION)
       پرونده clamav-milter.conf حاوی گزینه‌های پیکربندی برای clamav-milter(8)
       است.

قالب فایل (FILE FORMAT)
       این پرونده از توضیحات و گزینه‌های دارای آرگومان تشکیل شده است. هر خطی که
       با نماد هش (#) آغاز شود توسط تجزیه‌کننده نادیده گرفته می‌شود. گزینه‌ها و
       آرگومان‌ها به حروف بزرگ و کوچک حساس هستند و به شکل Option Argument نوشته
       می‌شوند. آرگومان‌ها از انواع زیر هستند:

       BOOL   مقدار بولی (yes/no یا true/false یا 1/0).

       STRING رشته متنی بدون نویسه‌های فاصله خالی.

       SIZE   اندازه بر حسب بایت. می‌توانید از اصلاح‌کننده‌های 'M' یا 'm' برای
              مگابایت و 'K' یا 'k' برای کیلوبایت استفاده کنید.

       NUMBER عدد صحیح بدون علامت.

گزینه‌های اصلی (MAIN OPTIONS)
       Example
              اگر این گزینه تنظیم شده باشد، clamav-milter اجرا نخواهد شد.

       MilterSocket STRING
              رابطی را تعریف می‌کند که از طریق آن با sendmail ارتباط برقرار
              می‌کنیم. این گزینه اجباری است!
              قالب‌های ممکن عبارتند از:
              [[unix|local]:]/path/to/file - برای مشخص کردن یک سوکت دامنه
              یونیکس
              inet:port@[hostname|ip-address] - برای مشخص کردن یک سوکت ipv4
              inet6:port@[hostname|ip-address] - برای مشخص کردن یک سوکت ipv6
              پیش‌فرض: تنظیم‌نشده

       MilterSocketGroup STRING
              مالکیت گروهی را برای سوکت میلتر (یونیکس) تعیین می‌کند.
              پیش‌فرض: غیرفعال (گروه اصلی کاربری که clamd را اجرا می‌کند)

       MilterSocketMode STRING
              مجوزهای دسترسی روی سوکت میلتر (یونیکس) را روی حالت مشخص‌شده تنظیم
              می‌کند.
              پیش‌فرض: غیرفعال (پیروی از umask)

       FixStaleSocket BOOL
              حذف سوکت بی‌استفاده پس از خاموش شدن نادرست.
              پیش‌فرض: yes

       User STRING
              اجرا تحت عنوان یک کاربر دیگر (برای کارکرد این گزینه، clamav-
              milter باید توسط ریشه/root آغاز شده باشد)
              پیش‌فرض: تنظیم‌نشده (امتیازات کاهش نمی‌یابند)

       ReadTimeout NUMBER
              انتظار برای دریافت داده از clamd پس از این مدت زمان (بر حسب
              ثانیه) منقضی می‌شود.
              پیش‌فرض: 120

       Foreground BOOL
              عدم انشعاب (fork) به پس‌زمینه.
              پیش‌فرض: no

       Chroot STRING
              تغییر ریشه (Chroot) به دایرکتوری مشخص‌شده. عملیات Chroot بلافاصله
              پس از خواندن فایل پیکربندی و پیش از کاهش امتیازات انجام می‌شود.
              پیش‌فرض: تنظیم‌نشده (بدون chroot)

       PidFile STRING
              نوشتن شناسه فرایند (PID) دیمن در فایل مشخص‌شده.
              پیش‌فرض: غیرفعال

       TemporaryDirectory STRING
              مسیر اختیاری برای دایرکتوری موقت سراسری.
              پیش‌فرض: وابسته به سیستم (معمولاً /tmp یا /var/tmp).

گزینه‌های CLAMD (CLAMD OPTIONS)
       ClamdSocket STRING
              سوکت clamd را برای اتصال جهت پویش مشخص می‌کند. این گزینه اجباری
              است! نحو:
              ClamdSocket unix:path
              ClamdSocket tcp:host:port
              نحو نخست یک سوکت محلی یونیکس را مشخص می‌کند (به مسیر مطلق نیاز
              دارد)، به عنوان مثال:
              ClamdSocket unix:/run/clamav/clamd.sock
              نحو دوم یک سوکت محلی یا دوردست tcp را مشخص می‌کند: میزبان می‌تواند
              یک نام میزبان یا یک نشانی ip باشد؛ فیلد ":port" تنها برای
              نشانی‌های IPv6 الزامی است، در غیر این صورت پیش‌فرض آن 3310 است، به
              عنوان مثال:
              ClamdSocket tcp:192.168.0.1
              این گزینه می‌تواند چندین بار با سوکت‌های مختلف یا حتی با همان سوکت
              تکرار شود: سرورهای clamd به روش نوبت‌گردشی (round-robin) انتخاب
              خواهند شد.
              پیش‌فرض: بدون پیش‌فرض

استثناها (EXCLUSIONS)
       LocalNet STRING
              پیام‌های ارسال‌شده از این میزبان‌ها/شبکه‌ها پویش نخواهند شد. این
              گزینه یک جفت نام میزبان/ماسک را در قالب نشانه‌گذاری CIDR دریافت
              می‌کند و می‌تواند چندین بار تکرار شود. اگر "/mask" حذف شود، یک
              میزبان فرض می‌شود. برای تعیین یک ایمیل غیر smtp که از مبدا محلی
              تولید شده است، از کلمه کلیدی "local" استفاده کنید.
              پیش‌فرض: تنظیم‌نشده (پویش همه‌چیز بدون در نظر گرفتن مبدا)

       AllowList STRING
              این گزینه فایلی را مشخص می‌کند که حاوی فهرستی از عبارت‌های منظم
              پایه POSIX است. نشانی‌هایی (فرستاده شده به یا از - در زیر ببینید)
              که با این regexها مطابقت دارند پویش نخواهند شد. به صورت اختیاری
              هر خط می‌تواند با رشته "From:" یا "To:" آغاز شود (توجه: بدون
              فاصله خالی پس از دونقطه) که مشخص می‌کند به ترتیب فرستنده یا
              گیرنده مجاز است. اگر این فیلد وجود نداشته باشد، "To:" فرض می‌شود.
              خطوطی که با #، : یا ! شروع می‌شوند نادیده گرفته می‌شوند.
              پیش‌فرض: تنظیم‌نشده (هیچ استثنایی اعمال نمی‌شود)

       SkipAuthenticated STRING
              پیام‌های کاربران احراز هویت‌شده SMTP که با این عبارت منظم
              گسترش‌یافته POSIX (مشابه egrep) مطابقت دارند پویش نخواهند شد. به
              عنوان یک جایگزین، فایلی حاوی فهرستی ساده (غیر regex) از نام‌ها
              (یک نام در هر خط) می‌تواند با استفاده از پیشوند "file:" مشخص شود؛
              مانند SkipAuthenticated file:/etc/good_guys. توجه: این نام ورود
              AUTH است!
              پیش‌فرض: تنظیم‌نشده (بدون مجازسازی بر اساس احراز هویت SMTP)

       MaxFileSize SIZE
              پیام‌های بزرگ‌تر از این مقدار پویش نخواهند شد. اطمینان حاصل کنید
              که این مقدار کوچک‌تر یا مساوی با StreamMaxLength در clamd.conf
              باشد.
              پیش‌فرض: 100M

اقدامات (ACTIONS)
       گروه گزینه‌های زیر فرآیند تحویل را در شرایط مختلف کنترل می‌کند. اقدامات
       زیر در دسترس هستند:
       - Accept: پیام برای تحویل پذیرفته می‌شود
       - Reject: بلافاصله تحویل رد می‌شود (یک خطای 5xx به طرف مقابل بازگردانده
       می‌شود)
       - Defer: یک پیام شکست موقت (4xx) به طرف مقابل بازگردانده می‌شود
       - Blackhole (برای OnFail در دسترس نیست): مانند Accept است اما پیام حذف
       و محو می‌شود
       - Quarantine (برای OnFail در دسترس نیست): مانند Accept است اما پیام به
       جای تحویل داده شدن، قرنطینه می‌شود. نکته: در Sendmail صف قرنطینه می‌تواند
       از طریق mailq -qQ بررسی شود. در Postfix این اقدام باعث می‌شود پیام در
       وضعیت تعلیق (hold) قرار گیرد.

       OnClean STRING
              اقدامی که باید روی پیام‌های پاک انجام شود (بیشتر برای آزمایش
              کاربرد دارد)
              پیش‌فرض: Accept

       OnInfected STRING
              اقدامی که باید روی پیام‌های آلوده انجام شود
              پیش‌فرض: Quarantine

       OnFail STRING
              اقدامی که باید در شرایط خطا انجام شود (شامل عدم موفقیت در تخصیص
              ساختارهای داده، در دسترس نبودن پویشگرها، وقفه زمانی شبکه،
              پاسخ‌های ناشناخته پویشگر و موارد مشابه)
              پیش‌فرض: Defer

       RejectMsg STRING
              این گزینه به شما امکان می‌دهد دلیل رد مشخصی را برای پیام‌های آلوده
              تعیین کنید و بنابراین تنها همراه با "OnInfected Reject" کاربرد
              دارد. رشته "%v" در صورت وجود با نام ویروس جایگزین خواهد شد.
              پیش‌فرض: وابسته به MTA

       AddHeader STRING
              اگر این گزینه روی "Replace" (یا "Yes") تنظیم شود، هدرهای "X-
              Virus-Scanned" و "X-Virus-Status" به هر پیام پردازش‌شده پیوست
              می‌شوند و احتمالاً جایگزین هدرهای موجود خواهند شد. اگر روی Add
              تنظیم شود، هدرهای X-Virus احتمالاً در بالای هدرهای موجود اضافه
              می‌شوند. توجه داشته باشید که در حالی که "Replace" می‌تواند امضاهای
              DKIM را مخدوش کند، "Add" ممکن است procmail و فیلترهای مشابه را
              دچار سردرگمی کند.
              پیش‌فرض: no

       ReportHostname STRING
              هنگامی که AddHeader در حال استفاده است، این گزینه به شما امکان
              می‌دهد نام میزبان گزارش‌شده را تعیین کنید. این امر ممکن است برای
              جلوگیری از افشای نام‌های داخلی مطلوب باشد. در صورت عدم تنظیم، نام
              واقعی دستگاه استفاده می‌شود.
              پیش‌فرض: غیرفعال

       VirusAction STRING
              اجرای یک دستور (احتمالاً با جستجو در PATH) هنگام یافتن یک پیام
              آلوده. پارامترهای زیر به همین ترتیب به برنامه فراخوانی‌شده ارسال
              می‌شوند: نام ویروس، شناسه صف (queue id)، فرستنده، مقصد، موضوع،
              شناسه پیام، تاریخ پیام. نکته ۱: این کار مستلزم در دسترس بودن
              ماکروهای MTA است (LogInfected را در زیر ببینید). نکته ۲: فرایند
              در زمینه clamav-milter فراخوانی می‌شود. نکته ۳: clamav-milter
              منتظر خروج فرایند می‌ماند. برای جلوگیری از تأخیرهای غیرضروری در
              تحویل ایمیل، سریع عمل کنید یا از fork استفاده نمایید.
              پیش‌فرض: غیرفعال

گزینه‌های گزارش‌گیری (LOGGING OPTIONS)
       LogFile STRING
              فعال‌سازی گزارش‌گیری در فایل انتخاب‌شده.
              پیش‌فرض: no

       LogFileUnlock BOOL
              غیرفعال‌سازی قفل سیستمی که از اجرای همزمان چند نمونه clamd با یک
              فایل پیکربندی یکسان جلوگیری می‌کند.
              پیش‌فرض: no

       LogFileMaxSize SIZE
              محدود کردن اندازه فایل گزارش. اگر حجم فایل از SIZE بیشتر شود،
              گزارش‌گیر به طور خودکار غیرفعال می‌شود. مقدار 0 این محدودیت را
              غیرفعال می‌کند.
              پیش‌فرض: 1M

       LogTime BOOL
              ثبت زمان برای هر پیام در گزارش.
              پیش‌فرض: no

       LogSyslog BOOL
              استفاده از سیستم ثبت گزارش سیستم‌عامل (می‌تواند همراه با LogFile
              کار کند).
              پیش‌فرض: no

       LogFacility STRING
              نوع پیام‌های syslog را مشخص می‌کند - لطفاً برای نام‌های facility به
              'man syslog' مراجعه کنید.
              پیش‌فرض: LOG_LOCAL6

       LogVerbose BOOL
              فعال‌سازی گزارش‌گیری با جزئیات کامل (verbose).
              پیش‌فرض: no

       LogInfected STRING
              این گزینه به شما امکان می‌دهد آنچه را که هنگام آلوده بودن پیام
              ثبت می‌شود، تنظیم کنید. مقادیر ممکن عبارتند از: Off (پیش‌فرض -
              هیچ‌چیزی ثبت نمی‌شود)، Basic (اطلاعات حداقلی ثبت می‌شود)، Full
              (اطلاعات کامل با جزئیات ثبت می‌شود)
              نکته: برای اینکه این مورد در sendmail به درستی کار کند، مطمئن
              شوید که ماکروهای msg_id، mail_addr، rcpt_addr و i در eom در
              دسترس هستند. به عبارت دیگر خطی مانند:
              Milter.macros.eom={msg_id}, {mail_addr}, {rcpt_addr}, i را به
              فایل .cf خود اضافه کنید. همچنین می‌توانید از این ماکرو استفاده
              کنید: define(`confMILTER_MACROS_EOM', `{msg_id}, {mail_addr},
              {rcpt_addr}, i')
              برنامه Postfix باید با تنظیمات پیش‌فرض به خوبی کار کند.
              پیش‌فرض: غیرفعال

       LogClean STRING
              این گزینه به شما امکان می‌دهد آنچه را که هنگام نیافتن تهدید در
              پیام پویش‌شده ثبت می‌شود، تنظیم کنید.
              برای مقادیر ممکن و هشدارها، به LogInfected مراجعه کنید.
              برای اشکال‌زدایی مفید است اما حجم فایل گزارش را به شدت افزایش
              می‌دهد.
              پیش‌فرض: غیرفعال

       SupportMultipleRecipients BOOL
              این گزینه بر رفتار LogInfected، LogClean و VirusAction هنگام
              پویش پیامی با چند گیرنده تأثیر می‌گذارد:
              اگر SupportMultipleRecipients خاموش باشد (پیش‌فرض)، تنها یک ورودی
              گزارش برای پیام ایجاد می‌شود و در صورتی که پیام مخرب تشخیص داده
              شود، دستور مشخص‌شده توسط VirusAction فقط یک بار اجرا می‌گردد. در
              هر دو حالت تنها آخرین گیرنده گزارش می‌شود.
              اگر SupportMultipleRecipients روشن باشد، برای هر گیرنده یک خط
              گزارش ثبت می‌شود و دستور تعیین‌شده توسط VirusAction نیز برای هر
              گیرنده یک بار اجرا می‌گردد.
              نکته: با وجود اینکه فعال کردن این گزینه احتمالاً ایده خوبی است،
              مقدار پیش‌فرض آن در حال حاضر به دلایل تاریخی و سازگاری با گذشته
              روی off تنظیم شده است.
              پیش‌فرض: no

نکات (NOTES)
       تمام گزینه‌هایی که اندازه را بیان می‌کنند به حداکثر ۴ گیگابایت محدود
       هستند. مقادیر فراتر از آن به مقدار حداکثر بازنشانی خواهند شد.

فایل‌ها (FILES)
       /etc/clamav/clamav-milter.conf

نویسنده (AUTHOR)
       aCaB <acab@clamav.net>

همچنین ببینید (SEE ALSO)
       clamav-milter(8), clamd(8), clamd.conf(5)

ClamAV 1.5.4                   February 25, 2009         clamav-milter.conf(5)