نام (NAME)

cifsiostat - گزارش آمارهای مربوط به CIFS

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

cifsiostat [ -h ] [ -k | -m ] [ -t ] [ -U ] [ -V ] [ -y ] [ --dec={ 0 | 1 | 2 } ] [ --human ] [ -o JSON ] [ --pretty ] [ interval [ count ] ]

توضیحات (DESCRIPTION)

دستور cifsiostat آمارهایی دربارهٔ عملیات خواندن و نوشتن روی سیستم‌های فایل CIFS نمایش می‌دهد.

پارامتر interval مدت زمان بر حسب ثانیه را بین هر گزارش مشخص می‌کند. نخستین گزارش شامل آمارهای مربوط به زمان پس از راه‌اندازی سیستم (boot) است، مگر اینکه از گزینهٔ -y استفاده شود (در این حالت، نخستین گزارش نادیده گرفته می‌شود). هر گزارش بعدی شامل آمارهای جمع‌آوری‌شده در طول بازهٔ زمانی از گزارش قبلی است. یک گزارش شامل یک سطر سرآیند CIFS و به دنبال آن یک خط آماری برای هر سیستم فایل CIFS سوارشده (mounted) است. پارامتر count می‌تواند همراه با پارامتر interval مشخص شود. اگر پارامتر count مشخص شود، مقدار آن تعداد گزارش‌های تولیدشده به فاصلهٔ interval ثانیه را تعیین می‌کند. اگر پارامتر interval بدون پارامتر count مشخص شود، دستور cifsiostat گزارش‌ها را به‌صورت پیوسته تولید می‌کند.

گزارش (REPORT)

گزارش CIFS آمارهایی را برای هر سیستم فایل CIFS سوارشده ارائه می‌دهد. این گزارش شامل فیلدهای زیر است:

Filesystem:

این ستون نقطهٔ اتصال (mount point) سیستم فایل CIFS را نشان می‌دهد.

rB/s (rkB/s, rMB/s)

نشان‌دهندهٔ میانگین تعداد بایت‌های (کیبی‌بایت، مبی‌بایت) خوانده‌شده در هر ثانیه.

wB/s (wkB/s, wMB/s)

نشان‌دهندهٔ میانگین تعداد بایت‌های (کیبی‌بایت، مبی‌بایت) نوشته‌شده در هر ثانیه.

rop/s

نشان‌دهندهٔ تعداد عملیات خواندن (read) صادرشده به سیستم فایل در هر ثانیه.

wop/s

نشان‌دهندهٔ تعداد عملیات نوشتن (write) صادرشده به سیستم فایل در هر ثانیه.

fo/s

نشان‌دهندهٔ تعداد فایل‌های بازشده در هر ثانیه.

fc/s

نشان‌دهندهٔ تعداد فایل‌های بسته‌شده در هر ثانیه.

fd/s

نشان‌دهندهٔ تعداد فایل‌های حذف‌شده در هر ثانیه.

گزینه‌ها (OPTIONS)

--dec={ 0 | 1 | 2 }

تعداد ارقام اعشار مورد استفاده را مشخص می‌کند (۰ تا ۲، مقدار پیش‌فرض ۲ است).

-h

این گزینه معادل با مشخص کردن --human --pretty است.

--human

چاپ اندازه‌ها در قالبی خوانا برای انسان (مانند 1.0k، 1.2M و غیره). واحدهای نمایش‌داده‌شده با این گزینه بر هر واحد پیش‌فرض دیگری (مانند کیبی‌بایت، سکتورها و...) که با معیارها مرتبط هستند اولویت دارند.

-k

نمایش آمارها بر حسب کیبی‌بایت در ثانیه.

-m

نمایش آمارها بر حسب مبی‌بایت در ثانیه.

-o JSON

نمایش آمارها در قالب JSON (نشانه‌گذاری اشیاء جاوااسکریپت). ترتیب فیلدهای خروجی JSON نامشخص است و ممکن است فیلدهای جدیدی در آینده اضافه شوند.

--pretty

خواناتر کردن گزارش CIFS برای انسان.

-t

چاپ زمان برای هر گزارش نمایش‌داده‌شده. قالب برچسب زمانی ممکن است به مقدار متغیر محیطی S_TIME_FORMAT (پایین را ببینید) و به این که آیا گزینهٔ -U استفاده شده است یا خیر بستگی داشته باشد.

-U

نمایش برچسب زمانی (UTC - ساعت هماهنگ جهانی) بر حسب ثانیه از مبدأ زمان (epoch).

-V

چاپ شماره نسخه و خروج.

-y

صرف‌نظر کردن از نخستین گزارش حاوی آمار از زمان راه‌اندازی سیستم، در صورتی که چندین رکورد در فواصل زمانی مشخص نمایش داده شوند.

محیط (ENVIRONMENT)

دستور cifsiostat متغیرهای محیطی زیر را مد نظر قرار می‌دهد:

S_COLORS

به‌طور پیش‌فرض زمانی که خروجی به یک پایانه متصل باشد، آمارها به‌صورت رنگی نمایش داده می‌شوند. از این متغیر برای تغییر تنظیمات استفاده کنید. مقادیر ممکن برای این متغیر عبارتند از never، always یا auto (مورد آخر معادل تنظیمات پیش‌فرض است).
لطفاً توجه داشته باشید رنگی که برای نمایش یک مقدار استفاده می‌شود (قرمز، زرد، یا هر رنگ دیگری)، صرفاً به دلیل رنگ آن نشان‌دهندهٔ هیچ نوع مشکلی نیست؛ بلکه تنها بازه‌های مختلف مقادیر را مشخص می‌کند.

S_COLORS_SGR

رنگ‌ها و سایر مشخصه‌های مورد استفاده برای نمایش آمار در پایانه را تعیین می‌کند. مقدار آن فهرستی جداشده با دونقطه (:) از قابلیت‌ها است که مقدار پیش‌فرض آن I=32;22:N=34;1:Z=34;22 می‌باشد. قابلیت‌های پشتیبانی‌شده عبارتند از:

S_TIME_FORMAT

اگر این متغیر وجود داشته باشد و مقدار آن ISO باشد، محلی‌سازی (locale) جاری هنگام چاپ تاریخ در سرآیند گزارش نادیده گرفته می‌شود. دستور cifsiostat در عوض از قالب ISO 8601 (YYYY-MM-DD) استفاده خواهد کرد. برچسب زمانی نمایش‌داده‌شده با گزینهٔ -t نیز با قالب ISO 8601 سازگار خواهد بود.

گزارش باگ‌ها (BUGS)

برای کارکرد دستور cifsiostat، سیستم فایل /proc باید سوار شده باشد (mounted).

اگرچه cifsiostat واحدهای مربوط به کیلوبایت (kB)، مگابایت (MB) و... را نمایش می‌دهد، اما در واقع از کیبی‌بایت (kiB)، مبی‌بایت (MiB) و... استفاده می‌کند. یک کیبی‌بایت برابر با ۱۰۲۴ بایت، و یک مبی‌بایت برابر با ۱۰۲۴ کیبی‌بایت است.

فایل‌ها (FILES)

فایل /proc/fs/cifs/Stats شامل آمارهای CIFS است.

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

نوشته‌شده توسط Ivana Varekova (varekova <at> redhat.com)
نگه‌داری‌شده توسط Sebastien Godard (sysstat <at> orange.fr)

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

sar(1), pidstat(1), mpstat(1), vmstat(8), iostat(1), tapestat(1), nfsiostat(1)

https://github.com/sysstat/sysstat
https://sysstat.github.io