نام (NAME)

clamdtop - پایش دیمن ضدویروس Clam (Clam AntiVirus Daemon)

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

clamdtop [options] [clamdspec ...]

توضیحات (DESCRIPTION)

دستور clamdtop ابزاری برای پایش یک یا چند پردازهٔ clamd است. این ابزار دارای یک رابط کاربری ncurses (رنگی) است که کارهای موجود در صف clamd، میزان مصرف حافظه و اطلاعات مربوط به پایگاه‌دادهٔ امضاهای بارگذاری‌شده را نمایش می‌دهد. می‌توانید در خط فرمان مشخص کنید که ابزار باید به کدام clamd متصل شود. به‌طور پیش‌فرض، تلاش خواهد کرد به clamd محلی مطابق با آنچه در clamd.conf تعریف شده است، متصل گردد.

گزینه‌ها (OPTIONS)

-h, --help: نمایش اطلاعات راهنما و خروج.
-V, --version: چاپ شماره نسخه و خروج.
--config-file=FILE: خواندن تنظیمات clamd از FILE، برای تعیین نحوهٔ اتصال به آن.
clamdspec: مشخص‌کنندهٔ clamd جهت اتصال: یا مسیری به سوکت محلی (unix domain socket) پردازهٔ clamd، یا یک نشانی IP و یک شماره درگاه (با پیش‌فرض ۳۳۱۰) برای اتصال به یک clamd محلی یا راه دور از طریق TCP/IP.

نمای کلی (OVERVIEW)

کلیدها (KEYS):

H: نمایش یک صفحه راهنمای کوتاه که مفهوم اجزای مختلف نمایشگر را توضیح می‌دهد.
Q: خروج از clamdtop.
R: بازنشانی مقادیر بیشینه (حداکثر).
up arrow, down arrow: اگر چندین clamd را پایش می‌کنید، clamdtop به‌طور پیش‌فرض یک صفحهٔ نمای کلی را نمایش می‌دهد. می‌توانید از کلیدهای پیکان بالا (up arrow) و پیکان پایین (down arrow) برای جابه‌جایی میان هر clamd به‌صورت جداگانه و بازگشت به صفحهٔ نمای کلی استفاده کنید. یک نوار آبی‌رنگ clamd مورد نظر را که جزئیات آن در حال نمایش است مشخص می‌کند. در صفحهٔ نمای کلی هیچ‌کدام از clamdها انتخاب نشده‌اند (بنابراین نوار آبی وجود ندارد) و می‌توانید موارد موجود در صف همهٔ clamdها را مشاهده کنید.

نوار بالایی (The top bar)

نسخهٔ clamdtop و زمان فعلی را نشان می‌دهد. clamdtop نمایشگر را هر ۲ ثانیه یک‌بار به‌روزرسانی می‌کند.

فهرست clamdها (The list of clamds)

فهرست clamdهایی که clamdtop به آن‌ها متصل است و آمار مربوط به آن‌ها را نشان می‌دهد.

NO: شمارهٔ یکتای clamd
CONNTIME: مدت زمانی که clamdtop متصل بوده است (با اتصال مجدد بازنشانی می‌شود)
LIV: تعداد کل رشته‌های فعال (live)
IDL: تعداد کل رشته‌های بیکار (idle)
QUEUE: تعداد موارد موجود در صف
MAXQ: بیشترین تعداد موارد مشاهده‌شده در صف
MEM: کل حافظهٔ مصرفی (در صورت در دسترس بودن)
HOST: مشخص‌کنندهٔ clamd؛ مقدار local به معنی سوکت یونیکس است
ENGINE: نسخهٔ موتور (Engine)
DBVER: نسخهٔ پایگاه‌داده
DBTIME: زمان انتشار پایگاه‌داده

نمای باجزئیات clamd (Clamd detailed view)

Primary threads live: تعداد رشته‌هایی که در حال حاضر مشغول اجرای دستورها یا اسکن هستند.
Primary threads idle: تعداد رشته‌هایی که بیکار بوده و منتظر دستور هستند. این رشته‌ها پس از مدت‌زمان IdleTimeout (۳۰ ثانیه) خارج می‌شوند.
Primary threads max: حداکثر تعداد رشته‌های پیکربندی‌شده.
Queue items: تعداد موارد (کارهای اسکن) در صف clamd که منتظر یک رشتهٔ آزاد برای پردازش هستند.
Queue max: حداکثر تعداد موارد دیده‌شده در صف clamd.

نمای مصرف حافظه (The memory usage view)

در صورت در دسترس بودن، جزئیات مصرف حافظهٔ clamd را نمایش می‌دهد:

Mem heap: میزان حافظهٔ استفاده‌شده توسط libc از هیپ (heap) بر حسب مگابایت.
Mem mmap: میزان حافظهٔ استفاده‌شده توسط libc از حافظهٔ تخصیص‌یافته با mmap بر حسب مگابایت.
Mem unused: میزان حافظه‌ای که می‌تواند توسط libc بازپس گرفته شود.
Libc used: میزان حافظهٔ مفید تخصیص‌داده‌شده توسط libc.
Libc free: میزان حافظهٔ تخصیص‌داده‌شده توسط libc که به دلیل تکه‌تکه شدن (fragmentation) قابل آزادسازی نیست.
Libc total: کل میزان حافظهٔ تخصیص‌یافته توسط libc از سیستم.
Pool count: تعداد نواحی mmap تخصیص‌یافته توسط تخصیص‌دهندهٔ استخر حافظه (memory pool allocator) در clamd (برای پایگاه‌دادهٔ امضاها).
Pool used: میزان حافظهٔ استفاده‌شده توسط تخصیص‌دهندهٔ استخر حافظهٔ clamd (برای پایگاه‌دادهٔ امضاها).
Total: کل میزان حافظهٔ تخصیص‌یافته توسط تخصیص‌دهندهٔ استخر حافظهٔ clamd.

صف کارهای clamd (The clamd job queue)

COMMAND: نوع دستور در حال اجرا؛ STATS مربوط به clamdtop است، گزینه‌های SCAN/CONTSCAN/FILDES/MULTISCAN اسکن یک فایل یا دایرکتوری هستند و MULTISCANFILE مربوط به اسکن یک مورد توسط کار MULTISCAN است.
QUEUEDSINCE: مدت زمان سپری‌شده از قرار گرفتن دستور در صف تا این لحظه.
FILE: نام فایل در حال پردازش (در صورت وجود).

مثال‌ها (EXAMPLES)

(۱) برای اتصال به clamd پیکربندی‌شده در clamd.conf پیش‌فرض:: clamdtop
(۲) برای اتصال به clamd پیکربندی‌شده در یک clamd.conf دیگر:: clamdtop --config-file=/path/to/clamd.conf
(۳) برای اتصال به یک clamd در حال اجرا روی دستگاهی دیگر (192.168.0.3) در شبکهٔ محلی (LAN):: clamdtop 192.168.0.3
(۴) برای اتصال به یک clamd در حال اجرا روی دستگاهی دیگر (192.168.0.3) با درگاهی غیرپیش‌فرض (3410):: clamdtop 192.168.0.3:3410
(۵) برای پایش clamd محلی و ۲ پردازهٔ clamd راه دور دیگر از طریق TCP/IP:: clamdtop localhost 192.168.0.3 192.168.0.4

نکات (NOTES)

اگر ترمینال قابلیت نمایش رنگ را داشته باشد، clamdtop از رنگ‌ها استفاده خواهد کرد. اگر مطمئن هستید که ترمینال شما از رنگ‌ها پشتیبانی می‌کند اما هیچ رنگی نمی‌بینید، بررسی کنید که متغیر محیطی TERM به‌درستی تنظیم شده باشد. به عنوان مثال، در صورت استفاده از محیط‌های مبتنی بر xterm، مقدار آن را به TERM=xterm-color تنظیم کنید. پشتیبانی از IPv6 افزوده شده است. در صورت وارد کردن نشانی IPv6، لطفاً قوانین معمول آدرس‌دهی IPv6 را رعایت کنید. در صورتی که نشانی IPv6 همراه با درگاه مشخص می‌شود، نشانی IPv6 را درون براکت قرار دهید (مانند [::1]:3410).

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

0 : پایان عادی

>0 : خطایی رخ داده است.

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

لطفاً برای مشاهدهٔ فهرست دست‌اندرکاران و قدردانی‌ها به مستندات کامل مراجعه کنید.

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

Török Edvin <edwin@clamav.net>

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

clamd(8), clamd.conf(5)