'\" t
.\"     Title: vfs_virusfilter
.\"    Author: [بخش "نویسنده (AUTHOR)" را ببینید]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 08/16/2026
.\"    Manual: ابزارهای مدیریت سیستم
.\"    Source: Samba 4.8
.\"  Language: Persian
.\"
.TH "VFS_VIRUSFILTER" "8" "08/16/2026" "Samba 4\&.8" "ابزارهای مدیریت سیستم"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
vfs_virusfilter \- پویشگر ویروس هنگام دسترسی برای سامبا
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\ 'u
vfs objects = virusfilter
.SH "توضیحات (DESCRIPTION)"
.PP
این ماژول مجموعه‌ای از ماژول‌های مختلف VFS سامبا است که با استفاده از یک پویشگر ضدویروس، پرونده‌های آلوده به ویروس را روی سرویس‌های پرونده سامبا پویش و پالایش می‌کند\&.
.PP
این ماژول پشته‌پذیر (stackable) است و قابلیت ترکیب با دیگر ماژول‌ها را دارد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
virusfilter:scanner
.RS 4
موتور پویش ضدویروس\&.
.RS
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIsophos\fR، پویشگر ضدویروس Sophos
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIfsav\fR، پویشگر ضدویروس F\-Secure
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIclamav\fR، پویشگر ضدویروس ClamAV
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIdummy\fR، پویشگر ساختگی مورد استفاده در آزمون‌ها\&. مقادیر را با پارامتر
\fIinfected files\fR
بررسی کرده و هر نام منطبق را به عنوان آلوده علامت‌گذاری می‌کند\&.
.RE
.sp
.RE
.RE
.PP
virusfilter:socket path = PATH
.RS 4
مسیر سوکت محلی برای پویشگر ویروس\&.
.sp
اگر این گزینه تنظیم نشود، مسیر پیش‌فرض به موتور پویش ضدویروس پیکربندی‌شده بستگی دارد\&.
.sp
برای بک‌اند
\fIsophos\fR
مسیر پیش‌فرض
\fI/var/run/savdi/sssp\&.sock\fR
است\&.
.sp
برای بک‌اند
\fIfsav\fR
مسیر پیش‌فرض
\fI/tmp/\&.fsav\-0\fR
است\&.
.sp
برای بک‌اند
\fIclamav\fR
مسیر پیش‌فرض
\fI/var/run/clamav/clamd\&.ctl\fR
است\&.
.RE
.PP
virusfilter:connect timeout = 30000
.RS 4
مدت زمان انتظار برای برقراری اتصال به فرایند پویشگر ویروس پیش از اتمام مهلت زمانی (timeout) را تعیین می‌کند\&. مقدار به میلی‌ثانیه است\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 30000 است\&.
.RE
.PP
virusfilter:io timeout = 60000
.RS 4
مدت زمان انتظار برای ارتباط با فرایند پویشگر ویروس پیش از اتمام مهلت زمانی را کنترل می‌کند\&. مقدار به میلی‌ثانیه است\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 60000 است\&.
.RE
.PP
virusfilter:scan on open = yes
.RS 4
این گزینه تعیین می‌کند که آیا پرونده‌ها هنگام باز شدن پویش شوند یا خیر\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض yes است\&.
.RE
.PP
virusfilter:scan on close = no
.RS 4
این گزینه تعیین می‌کند که آیا پرونده‌ها هنگام بسته شدن پویش شوند یا خیر\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض no است\&.
.RE
.PP
virusfilter:max file size = 100000000
.RS 4
بزرگ‌ترین اندازه پرونده برحسب بایت است که پویش خواهد شد\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 100MB است\&.
.RE
.PP
virusfilter:min file size = 10
.RS 4
کوچک‌ترین اندازه پرونده برحسب بایت است که پویش خواهد شد\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 10 است\&.
.RE
.PP
virusfilter:infected file action = nothing
.RS 4
اقدامی که باید در برابر یک پرونده آلوده انجام شود\&. گزینه‌ها عبارتند از nothing (هیچ‌کدام)، quarantine (قرنطینه)، rename (تغییر نام) و delete (حذف)\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض nothing است\&.
.RE
.PP
virusfilter:infected file errno on open = EACCES
.RS 4
کد خطایی (errno) که در صورت آلوده بودن پرونده هنگام باز شدن بازگردانده می‌شود\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض EACCES است\&.
.RE
.PP
virusfilter:infected file errno on close = 0
.RS 4
کد خطایی (errno) که در صورت آلوده بودن پرونده هنگام بسته شدن بازگردانده می‌شود\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 0 است\&.
.RE
.PP
virusfilter:quarantine directory = PATH
.RS 4
مسیری که پرونده‌های آلوده باید به آن منتقل شوند\&. این مسیر باید یک مسیر مطلق باشد\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض "\&.quarantine" به صورت نسبی نسبت به مسیر اشتراک است\&.
.RE
.PP
virusfilter:quarantine prefix = virusfilter\&.
.RS 4
پیشوند پرونده‌های قرنطینه‌شده\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض "virusfilter\&." است\&.
.RE
.PP
virusfilter:quarantine suffix = \&.infected
.RS 4
پسوند پرونده‌های قرنطینه‌شده\&. این گزینه تنها زمانی استفاده می‌شود که keep name برابر با true باشد؛ در غیر این صورت نادیده گرفته می‌شود\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض "\&.infected" است\&.
.RE
.PP
virusfilter:rename prefix = virusfilter\&.
.RS 4
پیشوند پرونده‌های آلوده\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض "virusfilter\&." است\&.
.RE
.PP
virusfilter:rename suffix = \&.infected
.RS 4
پسوند پرونده‌های آلوده\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض "\&.infected" است\&.
.RE
.PP
virusfilter:quarantine keep tree = yes
.RS 4
اگر keep tree فعال باشد، ساختار دایرکتوری نسبت به مسیر اشتراک در دایرکتوری قرنطینه حفظ می‌شود\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض yes است\&.
.RE
.PP
virusfilter:quarantine keep name = yes
.RS 4
آیا نام پرونده، به جز افزودن پسوند و/یا پیشوند و یک نام پسوند تصادفی مطابق با تعاریف virusfilter:rename prefix و virusfilter:rename suffix، بدون تغییر باقی بماند یا خیر\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض yes است\&.
.RE
.PP
virusfilter:infected file command = @SAMBA_DATADIR@/bin/virusfilter\-notify \-\-mail\-to virusmaster@example\&.com \-\-cc "%U@example\&.com" \-\-from samba@example\&.com \-\-subject\-prefix "Samba: Infected File: "
.RS 4
دستور خارجی برای اجرا هنگام پیدا شدن پرونده آلوده\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض none است\&.
.RE
.PP
virusfilter:scan archive = true
.RS 4
این گزینه تعیین می‌کند که آیا بایگانی‌ها (فایل‌های فشرده) پویش شوند یا خیر\&.
.sp
پویشگرهای Sophos و F\-Secure از این گزینه پشتیبانی می‌کنند و پیش‌فرض آن false است\&.
.RE
.PP
virusfilter:max nested scan archive = 1
.RS 4
این گزینه حداکثر عمق را برای جستجوی بایگانی‌های تو در تو تعیین می‌کند\&.
.sp
پویشگرهای Sophos و F\-Secure از این گزینه پشتیبانی می‌کنند و مقدار پیش‌فرض آن 1 است\&.
.RE
.PP
virusfilter:scan mime = true
.RS 4
این گزینه تعیین می‌کند که آیا پرونده‌های mime پویش شوند یا خیر\&.
.sp
تنها پویشگر
\fIfsav\fR
از این گزینه پشتیبانی می‌کند و مقدار پیش‌فرض آن false است\&.
.RE
.PP
virusfilter:scan error command = @SAMBA_DATADIR@/bin/virusfilter\-notify \-\-mail\-to virusmaster@example\&.com \-\-from samba@example\&.com \-\-subject\-prefix "Samba: Scan Error: "
.RS 4
دستور خارجی برای اجرا هنگام وقوع خطای پویش\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض none است\&.
.RE
.PP
virusfilter:exclude files = empty
.RS 4
پرونده‌هایی که باید از پویش مستثنی شوند\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض empty است\&.
.RE
.PP
virusfilter:infected files = empty
.RS 4
پرونده‌هایی که پویشگر
\fIdummy\fR
در virusfilter آن‌ها را به عنوان آلوده علامت‌گذاری می‌کند\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض empty است\&.
.RE
.PP
virusfilter:block access on error = false
.RS 4
تعیین می‌کند که آیا در صورت بروز خطای پویش، دسترسی باید مسدود شود یا خیر\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض false است\&.
.RE
.PP
virusfilter:scan error errno on open = EACCES
.RS 4
کد خطایی (errno) که در صورت بروز خطا در پویش پرونده و true بودن block access on error، هنگام باز شدن پرونده بازگردانده می‌شود\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض EACCES است\&.
.RE
.PP
virusfilter:scan error errno on close = 0
.RS 4
کد خطایی (errno) که در صورت بروز خطا در پویش پرونده و true بودن block access on error، هنگام بسته شدن پرونده بازگردانده می‌شود\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 0 است\&.
.RE
.PP
virusfilter:cache entry limit = 100
.RS 4
حداکثر تعداد مدخل‌ها در حافظه نهان نتایج پویش\&. با توجه به نحوه عملکرد memcache در سامبا، این مقدار تقریبی است\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 100 است\&.
.RE
.PP
virusfilter:cache time limit = 10
.RS 4
حداکثر زمانی (به ثانیه) که یک نتیجه پویش در حافظه نهان نتایج باقی خواهد ماند\&. مقدار \-1 محدودیت را غیرفعال می‌کند\&. مقدار 0 نهان‌سازی را غیرفعال می‌کند\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 10 است\&.
.RE
.PP
virusfilter:quarantine directory mode = 0755
.RS 4
حالت مبنای هشت (اکتال) برای دایرکتوری قرنطینه و زیردایرکتوری‌های آن هنگام ایجاد\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 0755 یا S_IRUSR | S_IWUSR | S_IXUSR | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH است\&.
.sp
مجوزها باید به گونه‌ای باشند که همه کاربران بتوانند بخوانند و جستجو کنند؛ یعنی تا زمانی که دقیقاً نمی‌دانید چه کاری انجام می‌دهید، این مقدار را دستکاری نکنید\&.
.RE
.PP
virusfilter:block suspected file = false
.RS 4
با فعال بودن این گزینه، بدافزارهای مشکوک نیز مسدود خواهند شد\&. تنها پویشگر
\fIfsav\fR
از این گزینه پشتیبانی می‌کند\&.
.sp
اگر این گزینه تنظیم نشود، مقدار پیش‌فرض false است\&.
.RE
.SH "نکات (NOTES)"
.PP
این ماژول می‌تواند جریان‌های داده‌ای غیر از جریان پیش‌فرض را نیز پویش کند، مشروط بر آن‌که جریان‌های متناوب داده هر یک در قالب پرونده‌های جداگانه ذخیره و پشتیبانی شوند، مانند عملکرد ماژول vfs با نام streams_depot\&.
.PP
برای کارکرد صحیح، ماژول پشتیبانی از جریان‌ها باید پیش از ماژول virusfilter در فهرست vfs objects قرار گیرد (یعنی streams_depot باید قبل از ماژول virusfilter فراخوانی شود)\&.
.PP
این ماژول با ارائه قابلیت پویش ویروس روی سرور، با هدف ایجاد دفاع در عمق (defense in depth) طراحی شده است\&. این ماژول برای استفاده به جای امنیت مناسب مبتنی بر کلاینت در نظر گرفته نشده است\&. ماژول‌های امنیتی دیگری نیز ممکن است وجود داشته باشند که برای دفاع در عمق روی سرور سودمند باشند\&.
.SH "نویسنده (AUTHOR)"
.PP
نرم‌افزار اصلی سامبا و ابزارهای مرتبط با آن توسط Andrew Tridgell ساخته شده‌اند\&. سامبا اکنون توسط تیم سامبا (Samba Team) به عنوان یک پروژه متن‌باز مشابه نحوه توسعه هسته لینوکس توسعه داده می‌شود\&.