.TH "Clamd client" "1" "12 فوریه 2009" "ClamAV 1.5.4" "Clam AntiVirus"
.SH "نام (NAME)"
.LP
clamdscan \- اسکن فایل‌ها و دایرکتوری‌ها برای ویروس با استفاده از دیمن Clam AntiVirus
.SH "خلاصه دستور (SYNOPSIS)"
.LP
clamdscan [گزینه‌ها] [فایل/دایرکتوری]
.SH "توضیحات (DESCRIPTION)"
.LP
دستور clamdscan یک کلاینت برای clamd است که می‌تواند به عنوان جایگزین clamscan استفاده شود. این دستور تمام گزینه‌های پیاده‌سازی‌شده در clamscan را می‌پذیرد، اما اکثر آن‌ها نادیده گرفته می‌شوند زیرا قابلیت‌های اسکن آن کاملاً به clamd وابسته است.
.SH "گزینه‌ها (OPTIONS)"
.LP

.TP
\fB\-h, \-\-help\fR
نمایش اطلاعات راهنما و خروج.
.TP
\fB\-V, \-\-version\fR
چاپ شماره نسخه و خروج.
.TP
\fB\-v, \-\-verbose\fR
حالت پرحرف با توضیحات بیشتر.
.TP
\fB\-\-quiet\fR
حالت بی‌صدا \- فقط نمایش پیام‌های خطا.
.TP
\fB\-\-stdout\fR
نوشتن تمام پیام‌ها (به جز خروجی libclamav) در خروجی استاندارد (stdout).
.TP
\fB\-c, \-\-config\-file=FILE\fR
خواندن تنظیمات clamd از FILE.
.TP
\fB\-l FILE, \-\-log=FILE\fR
ذخیره گزارش اسکن در FILE.
.TP
\fB\-f FILE, \-\-file\-list=FILE\fR
اسکن فایل‌های فهرست‌شده سطر به سطر در FILE.
.TP
\fB\-p A[:I], \-\-ping A[:I]\fR
ارسال پینگ به clamd حداکثر تا [A] بار در فواصل اختیاری [I] تا زمانی که پاسخ دهد.
.TP
\fB\-w, \-\-wait\fR
انتظار تا ۳۰ ثانیه برای شروع به کار clamd. می‌توان به همراه ping برای تنظیم دفعات تلاش [A] و فاصله زمانی [I] برای بررسی clamd استفاده کرد.
.TP
\fB\-m, \-\-multiscan\fR
استفاده از حالت چنداسکنی (multiscan). برای اسکن دایرکتوری محلی که دیمن مستقیماً مسیرها را باز می‌کند، clamd تلاش می‌کند محتویات دایرکتوری را به صورت موازی با استفاده از ریسمان‌های (threads) موجود اسکن کند. فایل‌های منفرد تحت تأثیر قرار نمی‌گیرند. هنگامی که این گزینه با \-\-stream، با \-\-fdpass روی سوکت محلی، یا با یک اقدام قرنطینه‌ای ترکیب شود، clamdscan خودش مسیرهای درخواستی را پیمایش می‌کند و اسکن فایل‌های مجزا را ارسال می‌نماید، در حالی که همچنان به clamd اجازه می‌دهد چندین فایل را به صورت موازی پردازش کند.
.TP
\fB\-z, \-\-allmatch\fR
پس از یافتن یک تطابق، ادامه اسکن درون فایل برای یافتن موارد منطبق بیشتر.
.TP
\fB\-\-remove\fR
حذف فایل‌های آلوده. \fBمراقب باشید.\fR
.TP
\fB\-\-move=DIRECTORY\fR
انتقال فایل‌های آلوده به DIRECTORY.
.TP
\fB\-\-copy=DIRECTORY\fR
کپی کردن فایل‌های آلوده در DIRECTORY.
.TP
\fB\-\-no\-summary\fR
عدم نمایش خلاصه گزارش در پایان اسکن.
.TP
\fB\-\-reload\fR
درخواست از clamd برای بارگذاری مجدد پایگاه‌داده ویروس.
.TP
\fB\-i, \-\-infected\fR
فقط چاپ فایل‌های آلوده.
.TP
\fB\-\-fdpass\fR
باز کردن فایل و ارسال توصیف‌گر فایل (file descriptor) بازشده به clamd. این قابلیت زمانی مفید است که clamd با یک کاربر دیگر اجرا می‌شود یا clamd ساختار سیستم‌فایل متفاوتی را می‌بیند. این روش سریع‌تر از استریم کردن فایل به clamd است. تنها در صورت اتصال به clamd از طریق سوکت محلی/یونیکس در دسترس است.
.TP
\fB\-\-stream\fR
مجبور کردن clamdscan به ارسال محتویات فایل به clamd به جای درخواست از clamd برای باز کردن مسیرهای فایل. این معمولاً لازم نیست زیرا clamdscan به صورت خودکار تشخیص می‌دهد که آیا ارسال محتوای فایل مورد نیاز است یا خیر. این گزینه بیشتر برای اشکال‌زدایی و آزمایش وجود دارد. در سایر موارد سوکت محلی، معمولاً \-\-fdpass ارجح است.

.SH "برهم‌کنش گزینه‌ها (OPTION INTERACTIONS)"
.LP
رفتار clamdscan در ابتدا به نوع سوکت و سپس به گزینه‌های خط فرمان بستگی دارد.
.TP
\fBسوکت یونیکس/محلی (Unix/local socket)\fR
به‌طور پیش‌فرض، clamdscan از دیمن محلی می‌خواهد مسیرهایی را که مشخص کرده‌اید باز کند. دیمن باید بتواند آن مسیرها را ببیند و مجوز خواندن آن‌ها را داشته باشد.
.RS
.IP \(bu 2
با \-\-fdpass، دستور clamdscan هر فایل را خودش باز می‌کند و فایل بازشده را به دیمن تحویل می‌دهد. این حالت زمانی مفید است که دیمن با کاربری دیگر اجرا می‌شود یا نمای متفاوتی از سیستم‌فایل دارد. این گزینه فقط با سوکت یونیکس/محلی و پشتیبانی از fd-passing کار می‌کند.
.IP \(bu 2
با \-\-stream، دستور clamdscan به جای درخواست باز کردن مسیرها، محتوای فایل را برای دیمن ارسال می‌کند.
.IP \(bu 2
با \-\-multiscan، اسکن‌های دایرکتوری می‌توانند از چندین ریسمان کارگر دیمن استفاده کنند. اگر از \-\-stream، \-\-fdpass، یا اقدام قرنطینه نیز استفاده شود، clamdscan خودش مسیرها را پیمایش می‌کند و اسکن فایل‌های مجزا را ارسال می‌نماید، در حالی که اجازه می‌دهد دیمن چندین فایل را به صورت موازی پردازش کند.
.IP \(bu 2
گزینه \-\-allmatch تنها زمانی موثر است که clamdscan از دیمن می‌خواهد مسیرها را مستقیماً باز کند و از \-\-multiscan، \-\-stream، یا \-\-fdpass استفاده نمی‌شود.
.RE
.TP
\fBسوکت TCP (TCP socket)\fR
هنگامی که دیمن روی سیستمی دیگر (remote) است، clamdscan محتوای فایل را به جای مسیرهای محلی ارسال می‌کند زیرا مسیرهای کلاینت ممکن است در میزبان دیمن وجود نداشته باشند. هنگامی که دیمن محلی است و clamdscan می‌تواند محلی بودن آن را تشخیص دهد، ممکن است از دیمن بخواهد مستقیماً مسیرهای محلی را باز کند.
.RS
.IP \(bu 2
گزینه \-\-stream برنامه clamdscan را وادار به ارسال محتوای فایل می‌کند، حتی اگر دیمن محلی باشد.
.IP \(bu 2
گزینه \-\-fdpass از طریق TCP در دسترس نیست. بر اساس نوع سوکت و نحوه دسترسی دیمن به فایل‌ها، یکی از گزینه‌های \-\-stream یا \-\-fdpass را برای اسکن استفاده کنید.
.IP \(bu 2
با \-\-multiscan، اسکن دایرکتوری محلی می‌تواند از چندین ریسمان کارگر دیمن بهره ببرد. اسکن‌های راه دور، اسکن‌های \-\-stream و اسکن‌های با اقدامات قرنطینه به صورت اسکن فایل‌های منفرد مدیریت می‌شوند، در حالی که همچنان پردازش موازی چند فایل در دیمن حفظ می‌شود.
.IP \(bu 2
گزینه \-\-allmatch فقط زمانی مؤثر است که clamdscan از دیمن محلی می‌خواهد مسیرها را مستقیماً باز کند و از \-\-multiscan یا \-\-stream استفاده نمی‌شود.
.RE
.TP
\fBراهنمای گزینه‌ها\fR
گزینه \-\-allmatch همراه با \-\-multiscan مفید نیست؛ فقط برای اسکن‌هایی استفاده شود که clamdscan از یک دیمن محلی می‌خواهد مسیرها را مستقیماً باز کند. برای قرنطینه، یک اقدام را برای اسکن انتخاب کنید: \-\-move، \-\-copy، یا \-\-remove.
.TP
\fBاقدامات قرنطینه همراه با multiscan\fR
اقدامات قرنطینه مانند \-\-move، \-\-copy و \-\-remove توسط clamdscan انجام می‌شوند، نه توسط clamd. برای اسکن‌های دایرکتوری که اقدامات قرنطینه در آن‌ها فعال است، clamdscan مسیر اقدام را برای هر فایل پیش از درخواست اسکن تعیین می‌کند. هنگامی که \-\-multiscan نیز فعال باشد، clamdscan اسکن فایل‌های مجزا را ارسال می‌کند تا بتواند ارتباط نتیجه اسکن با مسیر اقدام را حفظ کند در حالی که همچنان به clamd اجازه می‌دهد چندین فایل را موازی پردازش نماید.

.SH "مثال‌ها (EXAMPLES)"
.LP
.TP
(0) برای اسکن یک فایل:

\fBclamdscan file\fR
.TP
(1) برای اسکن دایرکتوری کاری جاری:

\fBclamdscan\fR
.TP
(2) برای اسکن تمام فایل‌ها در /home:

\fBclamdscan /home\fR
.TP
(3) برای اسکن فایل در حالتی که clamd با یک کاربر دیگر اجرا می‌شود:

\fBclamdscan \-\-fdpass ~/downloads\fR
.TP
(4) برای اسکن از ورودی استاندارد:

\fBclamdscan \- < file_to_scan\fR

\fBcat file_to_scan | clamdscan \-\fR
.SH "کدهای بازگشتی (RETURN CODES)"
.LP
0 : ویروسی یافت نشد.
.TP
1 : ویروس(ها) پیدا شد.
.TP
2 : خطایی رخ داد.
.SH "اعتبارات (CREDITS)"
لطفاً مستندات کامل را برای اعتبارات بررسی کنید.
.SH "نویسندگان (AUTHORS)"
.LP
Tomasz Kojm <tkojm@clamav.net>
.SH "همچنین ببینید (SEE ALSO)"
.LP
clamd(8), clamd.conf(5), clamscan(1)