.\" iostat manual page - (C) 1998-2025 Sebastien Godard (sysstat <at> orange.fr)
.TH IOSTAT 1 "JULY 2025" Linux "Linux User's Manual" -*- nroff -*-
.SH "نام (NAME)"
iostat \- گزارش آمار واحد پردازش مرکزی (CPU) و آمار ورودی/خروجی دستگاه‌ها و پارتیشن‌ها

.SH "خلاصه دستور (SYNOPSIS)"
.ie 'yes'no' \{
.B iostat [ \-c ] [ \-d ] [ \-h ] [ \-k | \-m ] [ \-N ] [ \-s ] [ \-t ] [ \-U ] [ \-V ] [ \-x ] [ \-y ] [ \-z ]
.BI "[ \-\-compact ] [ \-\-dec={ 0 | 1 | 2 } ] [ { \-f | +f } " "directory" " ] [ \-j { ID | LABEL | PATH | UUID | ... } ] "
.BI "[ \-o JSON ] [ [ \-H ] \-g " "group_name " "] [ \-\-human ] [ \-\-pretty ] [ \-p [ " "device" "[,...] | ALL ] ] ["
.IB "device " "[...] | ALL ] [ \-\-debuginfo ] [ " "interval " "[ " "count " "] ] "
.\}
.el \{
.B iostat [ \-c ] [ \-d ] [ \-h ] [ \-k | \-m ] [ \-N ] [ \-s ] [ \-t ] [ \-U ] [ \-V ] [ \-x ] [ \-y ] [ \-z ]
.BI "[ \-\-compact ] [ \-\-dec={ 0 | 1 | 2 } ] [ { \-f | +f } " "directory" " ] [ \-j { ID | LABEL | PATH | UUID | ... } ] "
.BI "[ \-o JSON ] [ [ \-H ] \-g " "group_name " "] [ \-\-human ] [ \-\-pretty ] [ \-p [ " "device" "[,...] | ALL ] ] ["
.IB "device " "[...] | ALL ] [ " "interval " "[ " "count " "] ]"
.\}

.SH "توضیحات (DESCRIPTION)"
دستور
.B iostat
برای نظارت بر بار ورودی/خروجی دستگاه‌های سیستم با مشاهده مدت‌زمانی که دستگاه‌ها نسبت به میانگین نرخ انتقال خود فعال هستند، استفاده می‌شود. دستور
.B iostat
گزارش‌هایی تولید می‌کند که می‌توان از آن‌ها برای تغییر پیکربندی سیستم جهت توزیع و متعادل‌سازی بهتر بار ورودی/خروجی بین دیسک‌های فیزیکی استفاده کرد.
.PP
اولین گزارش تولیدشده توسط دستور
.B iostat
آمارهای مربوط به زمان سپری‌شده از هنگام بالا آمدن (بوت) سیستم را ارائه می‌دهد، مگر اینکه از گزینه
.B \-y
استفاده شود (در این صورت، گزارش نخست حذف می‌شود).
هر گزارش بعدی، بازه زمانی پس از گزارش قبلی را پوشش می‌دهد. تمام آمارها در هر بار اجرای دستور
.B iostat
گزارش می‌شوند. این گزارش شامل یک سطر سربرگ
.B CPU
و به دنبال آن یک سطر از آمارهای
.B CPU
است. در سیستم‌های چندپردازنده‌ای، آمارهای CPU در سطح کل سیستم به عنوان میانگین تمام پردازنده‌ها محاسبه می‌شوند. همچنین یک سطر سربرگ دستگاه‌ها نمایش داده می‌شود و پس از آن برای هر دستگاهِ پیکربندی‌شده، یک خط آمار درج می‌گردد.
.PP
پارامتر
.I interval
فاصله زمانی بر حسب ثانیه را بین هر گزارش مشخص می‌کند. پارامتر
.I count
می‌تواند همراه با پارامتر
.I interval
مشخص شود. اگر پارامتر
.I count
تعیین گردد، مقدار آن بیانگر تعداد گزارش‌های تولیدشده در فواصل زمانی
.I interval
ثانیه‌ای خواهد بود. اگر پارامتر
.I interval
بدون پارامتر
.I count
مشخص شود، دستور
.B iostat
گزارش‌ها را به صورت مداوم تولید می‌کند.

.SH "گزارش‌ها (REPORTS)"
دستور
.B iostat
دو نوع گزارش تولید می‌کند: گزارش مصرف پردازنده (CPU Utilization report) و گزارش مصرف دستگاه (Device Utilization report).

.IP "گزارش مصرف پردازنده (CPU Utilization Report)"
نخستین گزارش تولیدشده توسط دستور
.B iostat
گزارش مصرف پردازنده است. در سیستم‌های چندپردازنده‌ای، مقادیر CPU میانگین‌های سراسری بین تمام پردازنده‌ها هستند.
این گزارش دارای قالب زیر است:
.RS
.IP %user
درصد مصرف پردازنده در زمان اجرا در سطح کاربر (برنامه‌ها) را نمایش می‌دهد.
.IP %nice
درصد مصرف پردازنده در زمان اجرا در سطح کاربر با اولویت nice را نمایش می‌دهد.
.IP %system
درصد مصرف پردازنده در زمان اجرا در سطح سیستم (هسته/کرنل) را نمایش می‌دهد.
.IP %iowait
درصد زمانی را نمایش می‌دهد که در طول آن پردازنده یا پردازنده‌ها بیکار بودند در حالی که سیستم یک درخواست معوق ورودی/خروجی دیسک داشت.
.IP %steal
درصد زمانی را نمایش می‌دهد که پردازنده یا پردازنده‌های مجازی در حالی که هایپروایزر در حال سرویس‌دهی به یک پردازنده مجازی دیگر بود، به اجبار در حالت انتظار سپری کردند.
.IP %idle
درصد زمانی را نمایش می‌دهد که پردازنده یا پردازنده‌ها بیکار بودند و سیستم هیچ درخواست معوق ورودی/خروجی دیسکی نداشت.
.RE
.PP
.IP "گزارش مصرف دستگاه (Device Utilization Report)"
دومین گزارش تولیدشده توسط دستور
.B iostat
گزارش مصرف دستگاه است.
گزارش دستگاه، آمارها را بر پایه هر دستگاه فیزیکی یا پارتیشن ارائه می‌دهد. دستگاه‌های بلوکی و پارتیشن‌هایی که آمار آن‌ها باید نمایش داده شود را می‌توان در خط فرمان وارد کرد.
اگر هیچ دستگاه یا پارتیشنی وارد نشود، آمار برای هر دستگاهی که توسط سیستم استفاده شده است، به شرطی که هسته آمار آن را نگهداری کند، نمایش داده می‌شود.
اگر کلمه کلیدی
.B ALL
در خط فرمان مشخص شود، آمار برای تمام دستگاه‌های تعریف‌شده در سیستم، شامل مواردی که هرگز استفاده نشده‌اند، نمایش داده می‌شود.
نرخ‌های انتقال به طور پیش‌فرض بر حسب بلوک‌های ۱۰۲۴ بایتی نمایش داده می‌شوند، مگر اینکه متغیر محیطی
.B POSIXLY_CORRECT
تنظیم شده باشد، که در این حالت از بلوک‌های ۵۱۲ بایتی استفاده می‌شود.
بسته به گزینه‌های مورد استفاده (مانند
.BR "\-x" "، " "\-s" " و " "\-k" " یا " "\-m" ")،"
این گزارش ممکن است فیلدهای زیر را نمایش دهد:
.RS
.IP Device:
این ستون نام دستگاه (یا پارتیشن) را مطابق با نام فهرست‌شده در دایرکتوری
.IR "/dev"
نمایش می‌دهد.
.IP tps
تعداد انتقال‌ها در ثانیه را که به دستگاه ارسال شده است نشان می‌دهد. یک انتقال در واقع یک درخواست ورودی/خروجی (I/O) به دستگاه است. چندین درخواست منطقی را می‌توان در قالب یک درخواست ورودی/خروجی واحد به دستگاه ترکیب کرد. اندازه یک انتقال نامشخص است.
.IP "Blk_read/s (kB_read/s, MB_read/s)"
میزان داده خوانده‌شده از دستگاه را بر حسب تعداد بلوک‌ها (کیبی‌بایت، مبی‌بایت) در ثانیه نشان می‌دهد. بلوک‌ها معادل سکتورها هستند و بنابراین اندازه ۵۱۲ بایتی دارند.
.IP "Blk_wrtn/s (kB_wrtn/s, MB_wrtn/s)"
میزان داده نوشته‌شده روی دستگاه را بر حسب تعداد بلوک‌ها (کیبی‌بایت، مبی‌بایت) در ثانیه نشان می‌دهد.
.IP "Blk_dscd/s (kB_dscd/s, MB_dscd/s)"
میزان داده دورریخته‌شده (discard) برای دستگاه را بر حسب تعداد بلوک‌ها (کیبی‌بایت، مبی‌بایت) در ثانیه نشان می‌دهد.
.IP "Blk_w+d/s (kB_w+d/s, MB_w+d/s)"
میزان داده نوشته‌شده یا دورریخته‌شده برای دستگاه را بر حسب تعداد بلوک‌ها (کیبی‌بایت، مبی‌بایت) در ثانیه نشان می‌دهد.
.IP "Blk_read (kB_read, MB_read)"
تعداد کل بلوک‌ها (کیبی‌بایت، مبی‌بایت) خوانده‌شده.
.IP "Blk_wrtn (kB_wrtn, MB_wrtn)"
تعداد کل بلوک‌ها (کیبی‌بایت، مبی‌بایت) نوشته‌شده.
.IP "Blk_dscd (kB_dscd, MB_dscd)"
تعداد کل بلوک‌ها (کیبی‌بایت، مبی‌بایت) دورریخته‌شده.
.IP "Blk_w+d (kB_w+d, MB_w+d)"
تعداد کل بلوک‌ها (کیبی‌بایت، مبی‌بایت) نوشته‌شده یا دورریخته‌شده.
.IP r/s
تعداد درخواست‌های خواندن تکمیل‌شده در ثانیه برای دستگاه (پس از ادغام‌ها).
.IP w/s
تعداد درخواست‌های نوشتن تکمیل‌شده در ثانیه برای دستگاه (پس از ادغام‌ها).
.IP d/s
تعداد درخواست‌های دورریزی (discard) تکمیل‌شده در ثانیه برای دستگاه (پس از ادغام‌ها).
.IP f/s
تعداد درخواست‌های فلاش (flush / تخلیه بافر به دیسک) تکمیل‌شده در ثانیه برای دستگاه (پس از ادغام‌ها).
این شمارش، درخواست‌های فلاش اجراشده توسط دیسک‌ها را در بر می‌گیرد. درخواست‌های فلاش برای پارتیشن‌ها ردیابی نمی‌شوند.
پیش از ادغام، عملیات‌های فلاش به عنوان نوشتن محاسبه می‌شوند.
.IP "sec/s (kB/s, MB/s)"
تعداد سکتورها (کیبی‌بایت، مبی‌بایت) خوانده‌شده، نوشته‌شده یا دورریخته‌شده برای دستگاه در هر ثانیه.
.IP "rsec/s (rkB/s, rMB/s)"
تعداد سکتورها (کیبی‌بایت، مبی‌بایت) خوانده‌شده از دستگاه در هر ثانیه.
.IP "wsec/s (wkB/s, wMB/s)"
تعداد سکتورها (کیبی‌بایت، مبی‌بایت) نوشته‌شده روی دستگاه در هر ثانیه.
.IP "dsec/s (dkB/s, dMB/s)"
تعداد سکتورها (کیبی‌بایت، مبی‌بایت) دورریخته‌شده برای دستگاه در هر ثانیه.
.IP rqm/s
تعداد درخواست‌های ورودی/خروجی ادغام‌شده در ثانیه که در صف دستگاه قرار گرفته بودند.
.IP rrqm/s
تعداد درخواست‌های خواندن ادغام‌شده در ثانیه که در صف دستگاه قرار گرفته بودند.
.IP wrqm/s
تعداد درخواست‌های نوشتن ادغام‌شده در ثانیه که در صف دستگاه قرار گرفته بودند.
.IP drqm/s
تعداد درخواست‌های دورریزی ادغام‌شده در ثانیه که در صف دستگاه قرار گرفته بودند.
.IP %rrqm
درصد درخواست‌های خواندن که پیش از ارسال به دستگاه با یکدیگر ادغام شده‌اند.
.IP %wrqm
درصد درخواست‌های نوشتن که پیش از ارسال به دستگاه با یکدیگر ادغام شده‌اند.
.IP %drqm
درصد درخواست‌های دورریزی که پیش از ارسال به دستگاه با یکدیگر ادغام شده‌اند.
.IP areq\-sz
میانگین اندازه (بر حسب کیبی‌بایت) درخواست‌های ورودی/خروجی ارسال‌شده به دستگاه.
.br
نکته: در نسخه‌های پیشین، این فیلد با نام avgrq\-sz شناخته می‌شد و بر حسب سکتور بیان می‌گردید.
.IP rareq\-sz
میانگین اندازه (بر حسب کیبی‌بایت) درخواست‌های خواندن ارسال‌شده به دستگاه.
.IP wareq\-sz
میانگین اندازه (بر حسب کیبی‌بایت) درخواست‌های نوشتن ارسال‌شده به دستگاه.
.IP dareq\-sz
میانگین اندازه (بر حسب کیبی‌بایت) درخواست‌های دورریزی ارسال‌شده به دستگاه.
.IP await
میانگین زمان (بر حسب میلی‌ثانیه) برای سرویس‌دهی به درخواست‌های ورودی/خروجی ارسال‌شده به دستگاه. این مقدار شامل زمان سپری‌شده توسط درخواست‌ها در صف و زمان صرف‌شده برای پاسخ‌دهی به آن‌ها است.
.IP r_await
میانگین زمان (بر حسب میلی‌ثانیه) برای سرویس‌دهی به درخواست‌های خواندن ارسال‌شده به دستگاه. این مقدار شامل زمان سپری‌شده توسط درخواست‌ها در صف و زمان صرف‌شده برای پاسخ‌دهی به آن‌ها است.
.IP w_await
میانگین زمان (بر حسب میلی‌ثانیه) برای سرویس‌دهی به درخواست‌های نوشتن ارسال‌شده به دستگاه. این مقدار شامل زمان سپری‌شده توسط درخواست‌ها در صف و زمان صرف‌شده برای پاسخ‌دهی به آن‌ها است.
.IP d_await
میانگین زمان (بر حسب میلی‌ثانیه) برای سرویس‌دهی به درخواست‌های دورریزی ارسال‌شده به دستگاه. این مقدار شامل زمان سپری‌شده توسط درخواست‌ها در صف و زمان صرف‌شده برای پاسخ‌دهی به آن‌ها است.
.IP f_await
میانگین زمان (بر حسب میلی‌ثانیه) برای سرویس‌دهی به درخواست‌های فلاش ارسال‌شده به دستگاه.
لایه بلوکی درخواست‌های فلاش را با یکدیگر ترکیب کرده و در هر لحظه حداکثر یکی را اجرا می‌کند.
بنابراین عملیات فلاش می‌تواند تا دو برابر طول بکشد: انتظار برای درخواست فلاش جاری، سپس اجرای آن و بعد انتظار برای درخواست بعدی.
.IP aqu\-sz
میانگین طول صف درخواست‌های ارسال‌شده به دستگاه.
.br
نکته: در نسخه‌های پیشین، این فیلد با نام avgqu\-sz شناخته می‌شد.
.IP %util
درصد زمان سپری‌شده‌ای که در طول آن درخواست‌های ورودی/خروجی به دستگاه ارسال شده‌اند (بهره‌وری پهنای باند برای دستگاه). اشباع دستگاه زمانی رخ می‌دهد که این مقدار برای دستگاه‌هایی که درخواست‌ها را به صورت متوالی سرویس می‌دهند نزدیک به ۱۰۰٪ باشد.
اما برای دستگاه‌هایی که به درخواست‌ها به صورت موازی پاسخ می‌دهند، مانند آرایه‌های RAID و SSDهای امروزی، این عدد نشان‌دهنده محدودیت‌های عملکردی آن‌ها نیست.
.RE

.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-c
نمایش گزارش مصرف پردازنده (CPU).
.TP
.B \-\-compact
گزارش مصرف دستگاه را به زیرگزارش‌ها تقسیم نمی‌کند تا تمام معیارها در یک خط نمایش داده شوند.
.TP
.B \-d
نمایش گزارش مصرف دستگاه.
.if 'yes'no' \{
.TP
.B \-\-debuginfo
چاپ خروجی دیباگ در stderr.
.\}
.TP
.B \-\-dec={ 0 | 1 | 2 }
مشخص کردن تعداد ارقام اعشار مورد استفاده (از ۰ تا ۲، مقدار پیش‌فرض ۲ است).
.TP
.BI "\-f " "directory"
.RE
.BI "+f " "directory"
.RS
مشخص کردن یک دایرکتوری جایگزین برای
.B iostat
جهت خواندن آمارهای دستگاه‌ها. گزینه
.BR \-f
به
.B iostat
می‌گوید که تنها از فایل‌های واقع در دایرکتوری جایگزین استفاده کند، در حالی که گزینه
.B +f
به آن می‌گوید که هم از فایل‌های استاندارد هسته و هم از فایل‌های موجود در دایرکتوری جایگزین برای خواندن آمارهای دستگاه استفاده کند.

پارامتر
.IR directory
دایرکتوری حاوی فایل‌های آماری برای دستگاه‌های مدیریت‌شده در فضای کاربری (userspace) است.
این دایرکتوری می‌تواند شامل موارد زیر باشد:

- یک فایل "diskstats" که قالب آن با فایل موجود در "/proc" سازگار است،
.br
- آمارهای دستگاه‌های منفرد موجود در فایل‌هایی که قالب آن‌ها با فایل‌های واقع در "/sys" سازگار است.

به‌ویژه، فایل‌های زیر واقع در
.I directory
ممکن است توسط
.B iostat
استفاده شوند:

.IR "directory" "/block/" "device" "/stat"
.br
.IR "directory" "/block/" "device" "/" "partition" "/stat"

فایل‌های
.I partition
باید یک مدخل در دایرکتوری
.IR "directory" "/dev/block/"
داشته باشند، مانند:

.IR "directory" "/dev/block/" "major" ":" "minor" " --> ../../block/" "device" "/" "partition"
.RE
.TP
.BI "\-g " "group_name " "{ " "device " "[...] | ALL }"
نمایش آمار برای گروهی از دستگاه‌ها.
دستور
.B iostat
ابتدا آمار را برای هر دستگاه مجزا در فهرست گزارش کرده و سپس یک سطر از آمارهای سراسری برای گروه به نام
.I group_name
متشکل از تمام دستگاه‌های فهرست ارائه می‌دهد. کلمه کلیدی
.B ALL
به این معنی است که تمام دستگاه‌های بلوکی تعریف‌شده توسط سیستم باید در گروه قرار گیرند.
.TP
.B \-H
این گزینه باید به همراه گزینه
.B \-g
استفاده شود و مشخص می‌کند که تنها آمارهای سراسری برای گروه نمایش داده شوند، نه آمارهای مربوط به تک‌تک دستگاه‌های موجود در آن گروه.
.TP
.B \-h
این گزینه معادل تعیین
.BR "\-\-human \-\-pretty"
است.
.TP
.B \-\-human
چاپ اندازه‌ها در قالبی خوانا برای انسان (مانند 1.0k، 1.2M و غیره).
واحدهای نمایش‌داده‌شده با این گزینه بر هر واحد پیش‌فرض دیگری (مانند کیبی‌بایت، سکتور و...) که به این معیارها وابسته است اولویت دارند.
.TP
.BI "\-j { ID | LABEL | PATH | UUID | ... } [ " "device " "[...] | ALL ]"
نمایش نام‌های ماندگار دستگاه. کلمات کلیدی
.BR ID "، " LABEL "، " PATH "، " UUID
و غیره نوع نام ماندگار را تعیین می‌کنند. این کلمات کلیدی محدود نیستند و تنها پیش‌نیاز این است که دایرکتوری با نام‌های ماندگار مورد نیاز در
.IR "/dev/disk"
موجود باشد.
به صورت اختیاری، می‌توان چند دستگاه را در نوع نام ماندگار انتخابی مشخص کرد.
از آنجا که نام‌های ماندگار دستگاه معمولاً طولانی هستند، گزینه
.B \-\-pretty
به صورت ضمنی همراه با این گزینه تنظیم می‌شود.
.TP
.B \-k
نمایش آمارها بر حسب کیبی‌بایت در ثانیه.
.TP
.B \-m
نمایش آمارها بر حسب مبی‌بایت در ثانیه.
.TP
.B \-N
نمایش نام‌های ثبت‌شده نگاشت‌کننده دستگاه (device mapper) برای دستگاه‌های دیوایس مپر.
برای مشاهده آمارهای LVM2 کاربرد دارد.
.TP
.B \-o JSON
نمایش آمارها در قالب JSON (JavaScript Object Notation).
ترتیب فیلدهای خروجی JSON تعریف‌نشده است و ممکن است در آینده فیلدهای جدیدی اضافه شوند.
.TP
.BI "\-p [ { " "device" "[,...] | ALL } ]"
نمایش آمار برای دستگاه‌های بلوکی و تمام پارتیشن‌های آن‌ها که توسط سیستم استفاده می‌شوند.
اگر نام دستگاهی در خط فرمان وارد شود، آمار آن و تمام پارتیشن‌هایش نمایش داده می‌شود. در نهایت، کلمه کلیدی
.B ALL
مشخص می‌کند که آمار باید برای تمام دستگاه‌های بلوکی و پارتیشن‌های تعریف‌شده در سیستم، شامل مواردی که هرگز استفاده نشده‌اند، نمایش یابد. اگر گزینه
.B \-j
پیش از این گزینه تعریف شده باشد، دستگاه‌های واردشده در خط فرمان را می‌توان با نوع نام ماندگار برگزیده تعیین کرد.
.TP
.B \-\-pretty
خواناتر کردن گزارش مصرف دستگاه برای انسان.
نام دستگاه در سمت راست چاپ خواهد شد. همچنین در صورت وجود معیارهای متعدد برای نمایش، گزارش ممکن است به زیرگزارش‌ها تقسیم شود (برای جلوگیری از این حالت از گزینه
.B \-\-compact
استفاده کنید).
.TP
.B \-s
نمایش نسخه کوتاه (باریک) گزارش برای جا شدن در صفحه‌نمایش‌های با عرض ۸۰ کاراکتر.
.TP
.B \-t
چاپ زمان برای هر گزارش نمایش‌داده‌شده. قالب برچسب زمانی ممکن است به مقدار متغیر محیطی
.B S_TIME_FORMAT
(به زیر مراجعه کنید) و استفاده از گزینه
.B \-U
بستگی داشته باشد.
.TP
.B \-U
نمایش برچسب زمانی (UTC - ساعت هماهنگ جهانی) بر حسب ثانیه از مبدا زمان (Epoch).
.TP
.B \-V
چاپ شماره نسخه و سپس خروج.
.TP
.B \-x
نمایش آمارهای تفصیلی و گسترده (extended statistics).
.TP
.B \-y
صرف‌نظر کردن از نخستین گزارش حاوی آمارهای پس از بوت سیستم، هنگام نمایش چند رکورد در بازه زمانی معین.
.TP
.B \-z
به
.B iostat
اعلام می‌کند که از خروجی هر دستگاهی که در طول دوره نمونه‌برداری فعالیتی نداشته است صرف‌نظر کند.

.SH "محیط (ENVIRONMENT)"
دستور
.B iostat
متغیرهای محیطی زیر را مد نظر قرار می‌دهد:
.TP
.B POSIXLY_CORRECT
هنگامی که این متغیر تنظیم شده باشد، نرخ‌های انتقال به جای بلوک‌های پیش‌فرض ۱۰۲۴ بایتی، در بلوک‌های ۵۱۲ بایتی نمایش داده می‌شوند.
.TP
.B S_COLORS
به طور پیش‌فرض زمانی که خروجی به یک ترمینال متصل باشد، آمارها به صورت رنگی نمایش داده می‌شوند.
از این متغیر برای تغییر این تنظیمات استفاده کنید. مقادیر ممکن برای این متغیر عبارتند از
.IR never "، " always " یا " auto
(مورد اخیر معادل تنظیمات پیش‌فرض است).
.br
لطفاً توجه داشته باشید که رنگ استفاده‌شده (قرمز، زرد یا هر رنگ دیگر) برای نمایش یک مقدار، صرفاً به دلیل رنگ آن بیانگر هیچ مشکلی نیست؛ بلکه تنها بازه‌های مختلف مقادیر را نشان می‌دهد.
.TP
.B S_COLORS_SGR
رنگ‌ها و سایر مشخصه‌های مورد استفاده برای نمایش آمارها در ترمینال را تعیین می‌کند.
مقدار آن فهرستی از قابلیت‌ها است که با دو نقطه از هم جدا شده‌اند و به طور پیش‌فرض برابر با
.B I=32;22:N=34;1:W=35;1:X=31;1:Z=34;22
است. قابلیت‌های پشتیبانی‌شده عبارتند از:
.RS
.TP
.B I=
زیررشته SGR (Select Graphic Rendition) برای نام‌های دستگاه.
.TP
.B N=
زیررشته SGR برای مقادیر آماری غیرصفر.
.TP
.BR "W=" " (یا " "M=" ")"
زیررشته SGR برای مقادیر درصدی در بازه ۷۵٪ تا ۹۰٪ (یا در بازه ۱۰٪ تا ۲۵٪ بسته به مفهوم معیار).
.TP
.BR "X=" " (یا " "H=" ")"
زیررشته SGR برای مقادیر درصدی بزرگ‌تر یا مساوی ۹۰٪ (یا کوچک‌تر یا مساوی ۱۰٪ بسته به مفهوم معیار).
.TP
.B Z=
زیررشته SGR برای مقادیر صفر.
.RE
.TP
.B S_TIME_FORMAT
اگر این متغیر وجود داشته باشد و مقدار آن
.B ISO
باشد، هنگام چاپ تاریخ در سربرگ گزارش، محلی‌سازی فعلی (locale) نادیده گرفته می‌شود. در این حالت دستور
.B iostat
از قالب ISO 8601 (YYYY-MM-DD) استفاده خواهد کرد.
برچسب زمانی نمایش‌داده‌شده با گزینه
.B \-t
نیز مطابق با قالب ISO 8601 خواهد بود.

.SH "مثال‌ها (EXAMPLES)"
.TP
.B iostat
نمایش یک گزارش واحد از تاریخچه پس از بوت برای تمام پردازنده‌ها و دستگاه‌ها.
.TP
.B iostat \-d 2
نمایش مداوم گزارش دستگاه در فواصل زمانی دو ثانیه‌ای.
.TP
.B iostat \-d 2 6
نمایش شش گزارش در فواصل زمانی دو ثانیه‌ای برای تمام دستگاه‌ها.
.TP
.B iostat \-x sda sdb 2 6
نمایش شش گزارش از آمارهای گسترده در فواصل زمانی دو ثانیه‌ای برای دستگاه‌های sda و sdb.
.TP
.B iostat \-p sda 2 6
نمایش شش گزارش در فواصل زمانی دو ثانیه‌ای برای دستگاه sda و تمام پارتیشن‌های آن (sda1 و غیره).

.SH "اشکالات (BUGS)"
سیستم‌فایل
.IR "/proc"
برای کارکرد
.B iostat
باید سوار (mount) شده باشد.
.PP
هسته‌های قدیمی‌تر از 2.6.x دیگر پشتیبانی نمی‌شوند.
.PP
اگرچه
.B iostat
واحدهای متناظر با کیلوبایت (kB)، مگابایت (MB)... را نمایش می‌دهد، اما در واقع از کیبی‌بایت (kiB)، مبی‌بایت (MiB)... استفاده می‌کند.
هر کیبی‌بایت برابر با ۱۰۲۴ بایت، و هر مبی‌بایت برابر با ۱۰۲۴ کیبی‌بایت است.

.SH "فایل‌ها (FILES)"
فایل
.IR "/proc/stat"
شامل آمارهای سیستم است.
.br
فایل
.IR "/proc/uptime"
شامل آپ‌تایم سیستم است.
.br
فایل
.IR "/proc/diskstats"
شامل آمارهای دیسک‌ها است.
.br
دایرکتوری
.IR "/sys"
شامل آمارهای دستگاه‌های بلوکی است.
.br
فایل
.IR "/proc/self/mountstats"
شامل آمارهای سیستم‌فایل‌های شبکه‌ای است.
.br
دایرکتوری
.IR "/dev/disk"
شامل نام‌های ماندگار دستگاه‌ها است.

.SH "نویسنده (AUTHOR)"
Sebastien Godard (sysstat <at> orange.fr)

.SH "همچنین ببینید (SEE ALSO)"
.BR "sar" "(1), " "pidstat" "(1), " "mpstat" "(1), " "vmstat" "(8), " "tapestat" "(1), " "nfsiostat" "(1),"
.BR "cifsiostat" "(1)"
.PP
.I https://github.com/sysstat/sysstat
.br
.I https://sysstat.github.io