نام (NAME)

freshclam - ابزار به‌روزرسانی پایگاه داده ویروس

خلاصه دستور (SYNOPSIS)

freshclam [گزینه‌ها]

توضیحات (DESCRIPTION)

دستور freshclam ابزاری برای به‌روزرسانی پایگاه داده ویروس در ClamAV است.

گزینه‌ها (OPTIONS)

برنامه FreshClam پیکربندی خود را از فایل freshclam.conf می‌خواند. این تنظیمات را می‌توان با گزینه‌های خط فرمان بازنویسی و جایگزین کرد.

-h, --help: نمایش اطلاعات راهنما و خروج.
-V, --version: نمایش شماره نسخه و خروج.
-v, --verbose: حالت پرگو. این گزینه باعث می‌شود freshclam اطلاعات تکمیلی زیادی چاپ کند.
--debug: فعال‌سازی پیام‌های اشکال‌زدایی از LibClamAV.
--quiet: حالت بی‌صدا - فقط خروجی پیام‌های خطا.
--no-warnings: عدم چاپ و ثبت هشدارهای لاگ.
--stdout: نوشتن تمام پیام‌ها در خروجی استاندارد (stdout).
--show-progress: نمایش درصد پیشرفت دانلود.
--config-file=FILE: خواندن پیکربندی از FILE.
-l FILE, --log=FILE: ثبت گزارش لاگ در FILE.
-d, --daemon: اجرا در حالت دیمن (پس‌زمینه). پیش‌فرض ۱۲ بار بررسی در روز است مگر اینکه با --checks یا در freshclam.conf مشخص شده باشد.
-p FILE, --pid=FILE: نوشتن شناسه فرایند (PID) دیمن در FILE.
-F, --foreground: عدم انشعاب در پس‌زمینه (برای استفاده در حالت دیمن).
-u USER, --user USER: اجرا به عنوان کاربر USER. به‌طور پیش‌فرض (هنگامی که توسط کاربر ریشه اجرا می‌شود) freshclam دسترسی‌ها را کاهش داده و تحت عنوان کاربر 'clamav' عمل می‌کند.
--no-dns: این گزینه روش قدیمی اعتبارسنجی بدون DNS (بدون تاخیر TTL) را اجباری می‌کند.
-c #n, --checks=#n: بررسی وجود پایگاه داده جدید به تعداد #n بار در روز. مقدار #n باید بین ۱ تا ۵۰ باشد.
--datadir=DIRECTORY: نصب پایگاه داده جدید در پوشه DIRECTORY. این پوشه باید برای کاربر 'clamav' یا کاربر غیرممتازی که freshclam را اجرا می‌کند قابل نوشتن بوده، از قبل وجود داشته باشد و یک مسیر مطلق باشد.
--daemon-notify=/path/to/clamd.conf: اطلاع‌رسانی به دیمن در مورد پایگاه داده جدید. به‌طور پیش‌فرض فایل پیکربندی ثابت خوانده می‌شود، اما می‌توانید فایل متفاوتی را مشخص کنید. از هر دو سوکت محلی و TCP پشتیبانی می‌شود.
-a IP, --local-address=IP: استفاده از آدرس IP (محلی) برای دانلودهای HTTP. برای سیستم‌های دارای چند کارت شبکه (multi-homed) مفید است. در صورت ناموفق بودن اتصال به هر دلیل، هشداری صادر می‌شود و freshclam بدون این فلگ عمل می‌کند.
--on-update-execute=COMMAND: اجرای دستور COMMAND پس از به‌روزرسانی موفق.
--on-error-execute=COMMAND: اجرای دستور COMMAND در صورت بروز خطا. به‌خاطر داشته باشید که تازگی پایگاه داده ویروس مهم‌ترین بخش در یک سیستم ضدویروس است. با این گزینه freshclam می‌تواند در صورت بروز اشکال به شما هشدار دهد (مثلاً ارسال پیامک).
--on-outdated-execute=COMMAND: اجرای دستور COMMAND هنگامی که freshclam نسخه قدیمی را گزارش می‌دهد. در رشته دستور، مقدار %v با شماره نسخه جدید جایگزین می‌شود.
--update-db=DBNAME: با این گزینه می‌توانید به‌روزرسانی‌ها را به زیرمجموعه‌ای از فایل‌های پایگاه داده محدود کنید. مقدار DBNAME باید "main"، "daily"، "bytecode"، "safebrowsing" یا نام یکی از پایگاه‌های داده متفرقه باشد. این گزینه می‌تواند چندین بار استفاده شود و فقط با پایگاه‌های داده رسمی و متفرقه توزیع‌شده از طریق آینه‌های ClamAV کار می‌کند؛ پایگاه‌های داده سفارشی شما (مشخص‌شده با DatabaseCustomURL در freshclam.conf) نادیده گرفته نخواهند شد.

متغیرهای محیطی (ENVIRONMENT VARIABLES)

برنامه freshclam از متغیرهای محیطی زیر استفاده می‌کند:

CURL_CA_BUNDLE: (فقط لینوکس/یونیکس، به‌جز macOS) می‌تواند روی مسیر فایلی شامل یک یا چند گواهی CA تنظیم شود. این متغیر مسیر پیش‌فرض گواهی openssl را بازنویسی می‌کند.
FRESHCLAM_CLIENT_CERT: می‌تواند روی مسیر فایل (PEM) حاوی گواهی کلاینت تنظیم شود. این متغیر برای احراز هویت کلاینت به کار می‌رود.
FRESHCLAM_CLIENT_KEY: می‌تواند روی مسیر فایل (PEM) حاوی کلید خصوصی کلاینت تنظیم شود. در صورت تنظیم FRESHCLAM_CLIENT_CERT، تعیین این متغیر الزامی است.
FRESHCLAM_CLIENT_KEY_PASSWD: می‌تواند روی گذرواژه فایل PEM کلید کلاینت تنظیم شود. در صورت تنظیم FRESHCLAM_CLIENT_KEY و محافظت شدن فایل PEM با گذرواژه، این متغیر الزامی است.
CVD_CERTS_DIR: تعیین پوشه حاوی گواهی ریشه CA مورد نیاز برای اعتبارسنجی امضاهای دیجیتال CVD جداگانه. در صورت عدم تعیین، freshclam در مسیر پیش‌فرض جستجو خواهد کرد.
توجه داشته باشید که متغیر محیطی CURL_CA_BUNDLE توسط ابزار خط فرمان curl نیز برای همین منظور استفاده می‌شود.

مثال‌ها (EXAMPLES)

(۰) دانلود پایگاه داده در پوشه پیش‌فرض:: freshclam
(۱) دانلود پایگاه داده در پوشه جاری:: freshclam --datadir=.
(۲) اجرا به عنوان دیمن و ۲ بار بررسی در روز برای پایگاه داده جدید:: freshclam -d -c 2

کدهای بازگشتی (RETURN CODES)

برخی از کدهای بازگشتی freshclam را می‌توان با دستور داخلی EXIT_n که به --on-*-execute ارسال می‌شود بازنویسی کرد؛ برای مثال --on-update-execute=EXIT_1 باعث می‌شود freshclam پس از به‌روزرسانی موفق پایگاه داده همیشه مقدار ۱ را بازگرداند.

0 : پایگاه داده به‌روز است یا با موفقیت به‌روزرسانی شد.
40: گزینه ناشناخته ارسال شده است.
50: عدم امکان تغییر دایرکتوری.
51: عدم امکان بررسی هش MD5.
52: مشکل در اتصال (شبکه).
53: عدم امکان حذف (unlink) فایل.
54: خطای اعتبارسنجی MD5 یا امضای دیجیتال.
55: خطا در خواندن فایل.
56: خطای فایل پیکربندی.
57: عدم امکان ایجاد فایل جدید.
58: عدم امکان خواندن پایگاه داده از سرور راه دور.
59: آینه‌ها کاملاً همگام نیستند (کمی بعد دوباره امتحان کنید).
60: عدم امکان دریافت اطلاعات کاربر 'clamav' از /etc/passwd.
61: عدم امکان کاهش دسترسی‌ها.
62: عدم امکان راه‌اندازی سیستم ثبت لاگ.

فایل‌ها (FILES)

/etc/clamav/freshclam.conf

قدردانی‌ها (CREDITS)

لطفاً مستندات کامل را برای فهرست قدردانی‌ها بررسی کنید.

نویسندگان (AUTHORS)

Tomasz Kojm <tkojm@clamav.net>, Kevin Lin <klin@sourcefire.com>

همچنین ببینید (SEE ALSO)

freshclam.conf(5), clamd(8), clamd.conf(5), clamscan(1)