'\" t
.\"     Title: dool
.\"    Author: Scott Baker <scott@perturb.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: October 2024
.\"    Manual: \ \&
.\"    Source: \ \& 1.3.0
.\"  Language: English
.\"
.TH "DOOL" "1" "October 2024" "\ \& 1\&.3\&.0" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
dool \- ابزاری همه‌کاره برای تولید آمار و اطلاعات منابع سیستم
.SH "خلاصه دستور (SYNOPSIS)"
.sp
dool [\-afv] [options\&.\&.] [delay [count]]
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار Dool یک جایگزین همه‌کاره و منعطف برای دستورهای vmstat، iostat و ifstat است\&. دستور Dool برخی از محدودیت‌های آن‌ها را برطرف کرده و قابلیت‌های بیشتری را ارائه می‌دهد\&.
.sp
ابزار Dool به شما امکان می‌دهد تمامی منابع سیستم خود را فوراً و به‌صورت زنده مشاهده کنید؛ برای نمونه می‌توانید مصرف دیسک را در کنار وقفه‌های ارسالی از کنترلر IDE بررسی کنید، یا آمار پهنای باند شبکه را مستقیماً با توان عملیاتی (throughput) دیسک در یک بازه زمانی یکسان مقایسه نمایید\&.
.sp
همچنین Dool داده‌ها را به‌شکلی هوشمندانه و با جزئیات کامل در ستون‌هایی منظم ارائه می‌دهد و واحد اندازه‌گیری و مقیاس خروجی را نیز به‌روشنی مشخص می‌کند؛ سردرگمی کمتر، خطای کمتر و کارایی بیشتر\&.
.sp
ویژگی منحصربه‌فرد Dool این است که به شما امکان می‌دهد توان عملیاتی دستگاه‌های بلوکی (block devices) را برای یک مجموعه دیسک خاص، یا پهنای باند شبکه را برای گروهی از رابط‌ها تجمیع کنید؛ به این معنی که می‌توانید توان عملیاتی تمامی دستگاه‌های بلوکی تشکیل‌دهندهٔ یک سیستم‌فایل یا ذخیره‌ساز را به‌صورت یکجا بررسی کنید\&.
.sp
دستور Dool امکان نوشتن مستقیم داده‌ها در یک فایل CSV را فراهم می‌آورد تا بتوان از آن برای تولید نمودار در نرم‌افزارهایی چون OpenOffice، Gnumeric یا Excel استفاده کرد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-c, \-\-cpu
.RS 4
فعال‌سازی آمار پردازنده (سیستم، کاربر، بیکار، انتظار)؛ برای آمارهای بیشتر مربوط به پردازنده، گزینه‌های
\fB\-\-cpu\-adv\fR
و
\fB\-\-cpu\-use\fR
را نیز ببینید\&.
.RE
.PP
\-C 0,3,total
.RS 4
شامل کردن cpu0، cpu3 و total (هنگام استفاده از \-c/\-\-cpu)؛ از
\fIall\fR
برای نمایش تمام پردازنده‌ها استفاده کنید\&.
.RE
.PP
\-d, \-\-disk
.RS 4
فعال‌سازی آمار دیسک (خواندن، نوشتن)؛ برای آمارهای بیشتر در رابطه با دیسک، سایر افزونه‌های
\fB\-\-disk\fR
را بررسی کنید\&.
.RE
.PP
\-D total,sda
.RS 4
شامل کردن total و sda (هنگام استفاده از \-\-disk)\&.
.RE
.PP
\-\-diskset diskset_name:dev1,dev2,dev3,etc\&...
.RS 4
دسته‌بندی چند دیسک با یکدیگر و گزارش آمار تجمیعی (هنگام استفاده از \-\-disk)\&.
.RE
.PP
\-g, \-\-page
.RS 4
فعال‌سازی آمار پیجینگ حافظه (page in، page out)\&.
.RE
.PP
\-i, \-\-int
.RS 4
فعال‌سازی آمار وقفه‌ها (interrupts)\&.
.RE
.PP
\-I 5,10
.RS 4
شامل کردن وقفه‌های ۵ و ۱۰ (هنگام استفاده از \-i/\-\-int)\&.
.RE
.PP
\-l, \-\-load
.RS 4
فعال‌سازی آمار میانگین بار سیستم (۱ دقیقه، ۵ دقیقه، ۱۵ دقیقه)\&.
.RE
.PP
\-m, \-\-mem
.RS 4
فعال‌سازی آمار حافظه (مصرف‌شده، بافرها، کَش، آزاد)؛ برای آمارهای بیشتر حافظه، گزینه‌های
\fB\-\-mem\-adv\fR
و
\fB\-\-swap\fR
را نیز امتحان کنید\&.
.RE
.PP
\-n, \-\-net
.RS 4
فعال‌سازی آمار شبکه (دریافت، ارسال)\&.
.RE
.PP
\-N eth1,total
.RS 4
شامل کردن eth1 و total (هنگام استفاده از \-n/\-\-net)\&.
.RE
.PP
\-p, \-\-proc
.RS 4
فعال‌سازی آمار فرآیندها (آماده‌به‌اجرا، غیرقابل‌وقفه، جدید)\&.
.RE
.PP
\-r, \-\-io
.RS 4
فعال‌سازی آمار درخواست‌های I/O (درخواست‌های خواندن و نوشتن)\&.
.RE
.PP
\-s, \-\-swap
.RS 4
فعال‌سازی آمار حافظه swap (مصرف‌شده، آزاد)\&.
.RE
.PP
\-S swap1,total
.RS 4
شامل کردن swap1 و total (هنگام استفاده از \-s/\-\-swap)\&.
.RE
.PP
\-t, \-\-time
.RS 4
فعال‌سازی نمایش زمان/تاریخ در خروجی\&.
.RE
.PP
\-T, \-\-epoch
.RS 4
فعال‌سازی شمارنده زمان (ثانیه‌های سپری‌شده از مبدأ epoch)\&.
.RE
.PP
\-y, \-\-sys
.RS 4
فعال‌سازی آمار سیستم (وقفه‌ها، تعویض زمینه یا context switches)\&.
.RE
.PP
\-\-aio
.RS 4
فعال‌سازی آمار aio (ورودی/خروجی ناهمگام)\&.
.RE
.PP
\-\-cpu\-adv
.RS 4
فعال‌سازی آمار پیشرفته پردازنده\&.
.RE
.PP
\-\-cpu\-use
.RS 4
تنها فعال‌سازی آمار میزان استفاده از پردازنده\&.
.RE
.PP
\-\-fs, \-\-filesystem
.RS 4
فعال‌سازی آمار سیستم‌فایل (فایل‌های باز، inodeها)\&.
.RE
.PP
\-\-ipc
.RS 4
فعال‌سازی آمار ipc (صف پیام، سمافورها، حافظه اشتراکی)\&.
.RE
.PP
\-\-lock
.RS 4
فعال‌سازی آمار قفل‌های فایل (posix، flock، خواندن، نوشتن)\&.
.RE.PP
\-\-mem\-adv
.RS 4
فعال‌سازی آمار پیشرفتهٔ حافظه
.RE
.PP
\-\-raw
.RS 4
فعال‌سازی آمار خام (سوکت‌های raw)
.RE
.PP
\-\-socket
.RS 4
فعال‌سازی آمار سوکت (total، tcp، udp، raw، ip\-fragments)
.RE
.PP
\-\-tcp
.RS 4
فعال‌سازی آمار tcp (شامل listen، established، syn، time_wait، close)
.RE
.PP
\-\-udp
.RS 4
فعال‌سازی آمار udp (شامل listen، active)
.RE
.PP
\-\-unix
.RS 4
فعال‌سازی آمار unix (شامل datagram، stream، listen، active)
.RE
.PP
\-\-vm
.RS 4
فعال‌سازی آمار vm (خطاهای برگهٔ سخت، خطاهای برگهٔ نرم، تخصیص‌یافته، آزاد)
.RE
.PP
\-\-vm\-adv
.RS 4
فعال‌سازی آمار پیشرفتهٔ vm (شامل steal، scanK، scanD، pgoru، astll)
.RE
.PP
\-\-zones
.RS 4
فعال‌سازی آمار zoneinfo (شامل d32F، d32H، normF، normH)
.RE
.PP
\-\-<plugin\-name>
.RS 4
فعال‌سازی افزونه‌های (خارجی) با نام افزونه؛ برای گزینه‌ها
\fBPLUGINS\fR
را ببینید
.RE
.PP
آمارهای داخلی ممکن عبارتند از:
.RS 4
aio، cpu، cpu24، cpu\-adv، cpu\-use، disk، disk24، disk24\-old، epoch، fs، int، int24، io، ipc، load، lock، mem، mem\-adv، net، page، page24، proc، raw، socket، swap، swap\-old، sys، tcp، time، udp، unix، vm، vm\-adv، zones
.RE
.PP
\-\-list
.RS 4
فهرست کردن نام‌های افزونه‌های داخلی و خارجی
.RE
.PP
\-a, \-\-all
.RS 4
معادل \-cdngy (پیش‌فرض)
.RE
.PP
\-f, \-\-full
.RS 4
گسترش فهرست‌های شناسایی \-C، \-D، \-I، \-N و \-S
.RE
.PP
\-v, \-\-vmstat
.RS 4
معادل \-pmgdsc \-D total
.RE
.PP
\-\-bits
.RS 4
اجبار به نمایش برحسب بیت برای مقادیری که به بایت بیان شده‌اند
.RE
.PP
\-\-bytes
.RS 4
اجبار به نمایش برحسب بایت برای مقادیری که به بیت بیان شده‌اند
.RE
.PP
\-\-float
.RS 4
اجبار به نمایش مقادیر اعشاری روی صفحه (ناسازگار با
\fB\-\-integer\fR)
.RE
.PP
\-\-integer
.RS 4
اجبار به نمایش مقادیر صحیح روی صفحه (ناسازگار با
\fB\-\-float\fR)
.RE
.PP
\-\-color
.RS 4
اجبار به خروجی ۲۵۶ رنگ (پیش‌فرض)
.RE
.PP
\-\-color16
.RS 4
اجبار به خروجی ۱۶ رنگ
.RE
.PP
\-\-bw, \-\-blackonwhite
.RS 4
تغییر رنگ‌ها برای ترمینال‌های با پس‌زمینهٔ سفید
.RE
.PP
\-\-nocolor
.RS 4
غیرفعال‌سازی رنگ‌ها
.RE
.PP
\-\-noheaders
.RS 4
غیرفعال‌سازی سرآیندهای تکراری
.RE
.PP
\-\-noupdate
.RS 4
غیرفعال‌سازی به‌روزرسانی‌های میانی هنگامی که delay > 1 است
.RE
.PP
\-\-output file
.RS 4
نوشتن خروجی CSV در file
.RE
.PP
\-\-display
.RS 4
نمایش داده‌های جدولی روی صفحه نمایش\&. هنگام استفاده همراه با
\fB\-\-output\fR
برای نمایش روی صفحه و نوشتن هم‌زمان در یک فایل کاربرد دارد
.RE
.PP
\-\-dstat
.RS 4
فعال‌سازی حالت خروجی قدیمی Dstat
.RE
.PP
\-\-profile
.RS 4
نمایش آمارهای پروفایلینگ هنگام خروج از dool
.RE
.PP
\-\-ascii
.RS 4
خروجی دادن داده‌های جدول با فرمت ascii به‌جای ANSI
.RE.SH "افزونه‌ها (PLUGINS)"
.sp
در حالی که هر کسی می‌تواند افزونه‌های dool خود را بسازد (و در توسعه آن مشارکت کند)، dool به‌طور پیش‌فرض همراه با چندین افزونه عرضه می‌شود که قابلیت‌های آن را تا حد زیادی گسترش می‌دهند\&. در ادامه نمایی کلی از افزونه‌هایی که همراه با dool ارائه می‌شوند آمده است:
.PP
\-\-battery
.RS 4
میزان باتری به درصد (نیازمند ACPI)
.RE
.PP
\-\-battery\-remain
.RS 4
زمان باقی‌مانده باتری بر حسب ساعت، دقیقه (نیازمند ACPI)
.RE
.PP
\-\-cpufreq
.RS 4
فرکانس پردازنده به درصد (نیازمند ACPI)
.RE
.PP
\-\-dbus
.RS 4
تعداد اتصالات dbus (نیازمند python\-dbus)
.RE
.PP
\-\-disk\-avgqu
.RS 4
میانگین طول صف درخواست‌های ارسال‌شده به دستگاه
.RE
.PP
\-\-disk\-avgrq
.RS 4
میانگین اندازه (بر حسب سکتور) درخواست‌های ارسال‌شده به دستگاه
.RE
.PP
\-\-disk\-svctm
.RS 4
میانگین زمان سرویس‌دهی (بر حسب میلی‌ثانیه) برای درخواست‌های I/O ارسال‌شده به دستگاه
.RE
.PP
\-\-disk\-tps
.RS 4
تعداد تراکنش‌ها یا انتقال‌ها در ثانیه ارسال‌شده به دستگاه
.RE
.PP
\-\-disk\-util
.RS 4
درصد زمان پردازنده که طی آن درخواست‌های I/O به دستگاه ارسال شده‌اند (میزان بهره‌وری پهنای باند برای دستگاه)
.RE
.PP
\-\-disk\-wait
.RS 4
میانگین زمان (بر حسب میلی‌ثانیه) برای پاسخ‌گویی به درخواست‌های I/O ارسال‌شده به دستگاه
.RE
.PP
\-\-dool
.RS 4
نمایش میزان مصرف cputime و تأخیر برنامه dool
.RE
.PP
\-\-dool\-cpu
.RS 4
نمایش میزان پیشرفته استفاده پردازنده توسط dool
.RE
.PP
\-\-dool\-ctxt
.RS 4
نمایش تعویض‌های زمینه (context switches) برنامه dool
.RE
.PP
\-\-dool\-mem
.RS 4
نمایش میزان پیشرفته مصرف حافظه توسط dool
.RE
.PP
\-\-fan
.RS 4
سرعت فن (نیازمند ACPI)
.RE
.PP
\-\-freespace
.RS 4
فضای مصرفی دیسک به تفکیک سیستم‌فایل
.RE
.PP
\-\-gpfs
.RS 4
ورودی/خروجی خواندن/نوشتن GPFS (نیازمند mmpmon)
.RE
.PP
\-\-gpfs\-ops
.RS 4
عملیات سیستم‌فایل GPFS (نیازمند mmpmon)
.RE
.PP
\-\-helloworld
.RS 4
افزونه نمونه «Hello world» برای dool
.RE
.PP
\-\-innodb\-buffer
.RS 4
نمایش آمار بافر innodb
.RE
.PP
\-\-innodb\-io
.RS 4
نمایش آمار I/O در innodb
.RE
.PP
\-\-innodb\-ops
.RS 4
نمایش شمارنده‌های عملیات innodb
.RE
.PP
\-\-lustre
.RS 4
نمایش توان عملیاتی ورودی/خروجی lustre
.RE
.PP
\-\-lnet
.RS 4
نمایش آمار ورودی/خروجی شبکه lustre
.RE
.PP
\-\-md\-status
.RS 4
نمایش پیشرفت و سرعت raid نرم‌افزاری (md)
.RE
.PP
\-\-memcache\-hits
.RS 4
نمایش تعداد درخواست‌های موفق (hits) و ناموفق (misses) در memcache
.RE
.PP
\-\-mysql5\-cmds
.RS 4
نمایش آمار دستورات MySQL5
.RE
.PP
\-\-mysql5\-conn
.RS 4
نمایش آمار اتصالات MySQL5
.RE
.PP
\-\-mysql5\-innodb
.RS 4
نمایش آمار innodb در MySQL5
.RE
.PP
\-\-mysql5\-io
.RS 4
نمایش آمار ورودی/خروجی MySQL5
.RE
.PP
\-\-mysql5\-keys
.RS 4
نمایش آمار کلیدهای MySQL5
.RE
.PP
\-\-mysql\-io
.RS 4
نمایش آمار ورودی/خروجی MySQL
.RE
.PP
\-\-mysql\-keys
.RS 4
نمایش آمار کلیدهای MySQL
.RE
.PP
\-\-net\-packets
.RS 4
نمایش تعداد بسته‌های دریافت‌شده و ارسال‌شده
.RE
.PP
\-\-nfs3
.RS 4
نمایش عملیات کلاینت NFS v3
.RE
.PP
\-\-nfs3\-ops
.RS 4
نمایش عملیات پیشرفته کلاینت NFS v3
.RE.PP
\-\-nfsd3
.RS 4
نمایش عملیات‌های کارساز NFS v3
.RE
.PP
\-\-nfsd3\-ops
.RS 4
نمایش عملیات‌های گسترش‌یافته کارساز NFS v3
.RE
.PP
\-\-nfsd4\-ops
.RS 4
نمایش عملیات‌های گسترش‌یافته کارساز NFS v4
.RE
.PP
\-\-nfsstat4
.RS 4
نمایش آمار NFS v4
.RE
.PP
\-\-ntp
.RS 4
نمایش زمان NTP از یک کارساز NTP
.RE
.PP
\-\-postfix
.RS 4
نمایش اندازه‌های صف postfix (نیازمند postfix)
.RE
.PP
\-\-power
.RS 4
نمایش مصرف انرژی
.RE
.PP
\-\-proc\-count
.RS 4
نمایش تعداد کل فرایندها
.RE
.PP
\-\-qmail
.RS 4
نمایش اندازه‌های صف qmail (نیازمند qmail)
.RE
.sp
\-\-redis: نمایش آمار redis
.PP
\-\-rpc
.RS 4
نمایش آمار فراخوانی‌های کارخواه RPC
.RE
.PP
\-\-rpcd
.RS 4
نمایش آمار فراخوانی‌های کارساز RPC
.RE
.PP
\-\-sendmail
.RS 4
نمایش اندازه صف sendmail (نیازمند sendmail)
.RE
.PP
\-\-snmp\-cpu
.RS 4
نمایش آمار CPU با استفاده از SNMP از DOOL_SNMPSERVER
.RE
.PP
\-\-snmp\-load
.RS 4
نمایش آمار بار سیستم با استفاده از SNMP از DOOL_SNMPSERVER
.RE
.PP
\-\-snmp\-mem
.RS 4
نمایش آمار حافظه با استفاده از SNMP از DOOL_SNMPSERVER
.RE
.PP
\-\-snmp\-net
.RS 4
نمایش آمار شبکه با استفاده از SNMP از DOOL_SNMPSERVER
.RE
.sp
\-\-snmp\-net\-err: نمایش خطاهای شبکه با استفاده از SNMP از DOOL_SNMPSERVER
.PP
\-\-snmp\-sys
.RS 4
نمایش آمار سیستم (وقفه‌ها و تعویض بافت‌ها) با استفاده از SNMP از DOOL_SNMPSERVER
.RE
.PP
\-\-snooze
.RS 4
نمایش تعداد تیک‌ها در هر ثانیه
.RE
.PP
\-\-squid
.RS 4
نمایش آمار مصرف squid
.RE
.PP
\-\-test
.RS 4
نمایش خروجی افزونه آزمایشی
.RE
.PP
\-\-thermal
.RS 4
حسگرهای دمای سیستم
.RE
.PP
\-\-top\-bio
.RS 4
نمایش پرمصرف‌ترین فرایند I/O بلوکی
.RE
.PP
\-\-top\-bio\-adv
.RS 4
نمایش پرمصرف‌ترین فرایند I/O بلوکی (شامل\& pid و دیگر آمارها)
.RE
.PP
\-\-top\-childwait
.RS 4
نمایش فرایندی با بیشترین انتظار برای فرزند
.RE
.PP
\-\-top\-cpu
.RS 4
نمایش پرمصرف‌ترین فرایند CPU
.RE
.PP
\-\-top\-cpu\-adv
.RS 4
نمایش پرمصرف‌ترین فرایند CPU (شامل\& pid و دیگر آمارها)
.RE
.PP
\-\-top\-cputime
.RS 4
نمایش فرایندی با بیشترین زمان مصرف CPU (به میلی‌ثانیه)
.RE
.PP
\-\-top\-cputime\-avg
.RS 4
نمایش فرایندی با بیشترین میانگین برش زمانی (به میلی‌ثانیه)
.RE
.PP
\-\-top\-int
.RS 4
نمایش پرتکرارترین وقفه
.RE
.PP
\-\-top\-io
.RS 4
نمایش پرمصرف‌ترین فرایند I/O
.RE
.PP
\-\-top\-io\-adv
.RS 4
نمایش پرمصرف‌ترین فرایند I/O (شامل\& pid و دیگر آمارها)
.RE
.PP
\-\-top\-latency
.RS 4
نمایش فرایندی با بیشترین تأخیر کل (به میلی‌ثانیه)
.RE
.PP
\-\-top\-latency\-avg
.RS 4
نمایش فرایندی با بیشترین میانگین تأخیر (به میلی‌ثانیه)
.RE
.PP
\-\-top\-mem
.RS 4
نمایش فرایندی که بیشترین حافظه را مصرف می‌کند
.RE
.PP
\-\-top\-oom
.RS 4
نمایش فرایندی که زودتر از همه توسط OOM کشته خواهد شد
.RE
.PP
\-\-utmp
.RS 4
نمایش تعداد اتصالات utmp (نیازمند python\-utmp)
.RE.PP
\-\-vm\-cpu
.RS 4
نمایش آمار پردازنده VMware از هایپروایزر
.RE
.PP
\-\-vm\-mem
.RS 4
نمایش آمار حافظه VMware از هایپروایزر
.RE
.PP
\-\-vm\-mem\-adv
.RS 4
نمایش آمار پیشرفته حافظه VMware از هایپروایزر
.RE
.PP
\-\-vmk\-hba
.RS 4
نمایش آمار vmhba در هسته VMware ESX
.RE
.PP
\-\-vmk\-int
.RS 4
نمایش آمار وقفه در هسته VMware ESX
.RE
.PP
\-\-vmk\-nic
.RS 4
نمایش آمار درگاه‌های هسته VMware ESX
.RE
.PP
\-\-vz\-cpu
.RS 4
نمایش مصرف پردازنده به ازای هر مهمان OpenVZ
.RE
.PP
\-\-vz\-io
.RS 4
نمایش مصرف I/O به ازای هر مهمان OpenVZ
.RE
.PP
\-\-vz\-ubc
.RS 4
نمایش beancounters کاربر OpenVZ
.RE
.PP
\-\-wifi
.RS 4
کیفیت پیوند بی‌سیم و نسبت سیگنال به نویز
.RE
.PP
\-\-zfs\-arc
.RS 4
نمایش آمار arc در ZFS
.RE
.PP
\-\-zfs\-l2arc
.RS 4
نمایش آمار l2arc در ZFS
.RE
.PP
\-\-zfs\-zil
.RS 4
نمایش آمار zil در ZFS
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
\fBdelay\fR تاخیر زمانی بر حسب ثانیه بین هر به‌روزرسانی است
.sp
\fBcount\fR تعداد به‌روزرسانی‌ها برای نمایش پیش از خروج است
.sp
مقدار پیش‌فرض delay برابر با ۱ و count نامشخص (نامحدود) است
.SH "به‌روزرسانی‌های میانی (INTERMEDIATE UPDATES)"
.sp
هنگام فراخوانی dool با یک \fBdelay\fR بزرگ‌تر از ۱ و بدون گزینه \fB\-\-noupdate\fR، به‌روزرسانی‌های میانی نمایش داده می‌شوند؛ یعنی بار نخست یک میانگین ۱ ثانیه‌ای، در به‌روزرسانی دوم میانگین ۲ ثانیه‌ای و غیره\&، تا زمانی که مقدار تاخیر سپری شود\&.
.sp
بنابراین در صورتی که تاخیر را ۱۰ ثانیه تعیین کنید، \fBآن ۹ به‌روزرسانی میانی تصویر لحظه‌ای (snapshot) نیستند\fR، بلکه میانگین‌هایی از زمان سپری‌شده پس از آخرین به‌روزرسانی نهایی هستند\&. نتیجه نهایی این است که درست مانند vmstat، میانگینی ۱۰ ثانیه‌ای را در یک خط جدید دریافت می‌کنید\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
استفاده از dool برای مرتبط ساختن توان عملیاتی دیسک با مصرف شبکه (eth0)، کل مصرف پردازنده و شمارنده‌های سیستم:
.sp
.if n \{\
.RS 4
.\}
.nf
dool \-dnyc \-N eth0 \-C total \-f 5
.fi
.if n \{\
.RE
.\}
.sp
بررسی رفتار dool و اثرگذاری dool بر سیستم:
.sp
.if n \{\
.RS 4
.\}
.nf
dool \-taf \-\-debug
.fi
.if n \{\
.RE
.\}
.sp
استفاده از پلاگین time همراه با پلاگین‌های cpu، net، disk، system، load، proc و top_cpu:
.sp
.if n \{\
.RS 4
.\}
.nf
dool \-tcndylp \-\-top\-cpu
.fi
.if n \{\
.RE
.\}
.sp
این معادل است با
.sp
.if n \{\
.RS 4
.\}
.nf
dool \-\-time \-\-cpu \-\-net \-\-disk \-\-sys \-\-load \-\-proc \-\-top\-cpu
.fi
.if n \{\
.RE
.\}
.sp
استفاده از dool برای مرتبط ساختن آمار پیشرفته پردازنده با وقفه به ازای هر دستگاه:
.sp
.if n \{\
.RS 4
.\}
.nf
dool \-t \-\-cpu\-adv \-yif
.fi
.if n \{\
.RE
.\}.SH "گزارش باگ‌ها (BUGS)"
.sp
از آن‌جا که آزمایش dool روی هر ترکیب ممکنی از نسخهٔ هسته، python یا توزیع عملاً غیرممکن است، برای رفع مشکلات باقی‌مانده به یاری و بازخورد شما نیاز دارم\&. اگر پیشنهادی برای بهبود یا گزارش باگی دارید، لطفاً آن را به این نشانی بفرستید: \m[blue]\fBdag@wieers\&.com\fR\m[]\&\s-2\u[1]\d\s+2
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.sp
لطفاً برای باگ‌های شناخته‌شده و برنامه‌های آینده، فایل TODO را ببینید\&.
.sp .5v
.RE
.SH "فایل‌ها (FILES)"
.sp
مسیرهایی که ممکن است حاوی افزونه‌های خارجی dool_*\&.py باشند:
.sp
.if n \{\
.RS 4
.\}
.nf
~/\&.dool/
(path of binary)/plugins/
/usr/share/dool/
/usr/local/share/dool/
.fi
.if n \{\
.RE
.\}
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.sp
برنامهٔ Dool آرگومان‌های اضافی خط فرمان را از متغیر محیطی \fBDOOL_OPTS\fR می‌خواند\&. می‌توانید از این متغیر برای پیکربندی رفتار پیش‌فرض Dool استفاده کنید؛ به عنوان نمونه اگر ترمینالی با قلم سیاه روی پس‌زمینهٔ سفید (black\-on\-white) دارید:
.sp
.if n \{\
.RS 4
.\}
.nf
export DOOL_OPTS="\-\-bw \-\-noupdate"
.fi
.if n \{\
.RE
.\}
.sp
سایر افزونه‌های داخلی یا خارجی نیز متغیرهای محیطی ویژهٔ خود را برای اثرگذاری بر رفتارشان دارند؛ مانند:
.sp
.if n \{\
.RS 4
.\}
.nf
DOOL_NTPSERVER
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
DOOL_MYSQL
DOOL_MYSQL_HOST
DOOL_MYSQL_PORT
DOOL_MYSQL_SOCKET
DOOL_MYSQL_USER
DOOL_MYSQL_PWD
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
DOOL_SNMPSERVER
DOOL_SNMPCOMMUNITY
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
DOOL_SQUID_OPTS
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
DOOL_TIMEFMT
.fi
.if n \{\
.RE
.\}.SH "همچنین ببینید (SEE ALSO)"
.SS "ابزارهای کارایی (Performance tools)"
.sp
.if n \{\
.RS 4
.\}
.nf
htop(1), ifstat(1), iftop(8), iostat(1), mpstat(1), netstat(8), nfsstat(8), perf(1), powertop(1), rtacct(8), top(1), vmstat(8), xosview(1)
.fi
.if n \{\
.RE
.\}
.SS "ردیابی فرایندها (Process tracing)"
.sp
.if n \{\
.RS 4
.\}
.nf
lslk(8), lsof(8), ltrace(1), pidstat(1), pmap(1), ps(1), pstack(1), strace(1)
.fi
.if n \{\
.RE
.\}
.SS "اشکال‌زدایی باینری (Binary debugging)"
.sp
.if n \{\
.RS 4
.\}
.nf
ldd(1), file(1), nm(1), objdump(1), readelf(1)
.fi
.if n \{\
.RE
.\}
.SS "ابزارهای مصرف حافظه (Memory usage tools)"
.sp
.if n \{\
.RS 4
.\}
.nf
free(1), memusage, memusagestat, ps_mem(1), slabtop(1), smem(8)
.fi
.if n \{\
.RE
.\}
.SS "ابزارهای حسابرسی (Accounting tools)"
.sp
.if n \{\
.RS 4
.\}
.nf
acct(2), dump\-acct(8), dump\-utmp(8), lastcomm(1), sa(8)
.fi
.if n \{\
.RE
.\}
.SS "ابزارهای اشکال‌زدایی سخت‌افزار (Hardware debugging tools)"
.sp
.if n \{\
.RS 4
.\}
.nf
dmidecode(8), ifinfo(1), lsdev(1), lshal(1), lshw(1), lsmod(8), lspci(8), lsusb(8), numactl(8), smartctl(8), turbostat(8), x86info(1)
.fi
.if n \{\
.RE
.\}
.SS "اشکال‌زدایی برنامه‌ها (Application debugging)"
.sp
.if n \{\
.RS 4
.\}
.nf
mailstats(8), qshape(1)
.fi
.if n \{\
.RE
.\}
.SS "ابزارهای مرتبط با Xorg (Xorg related tools)"
.sp
.if n \{\
.RS 4
.\}
.nf
xdpyinfo(1), xrestop(1)
.fi
.if n \{\
.RE
.\}.SS "سایر اطلاعات مفید (Other useful info)"
.sp
.if n \{\
.RS 4
.\}
.nf
collectl(1), proc(5), procinfo(8)
.fi
.if n \{\
.RE
.\}
.SH "نویسنده (AUTHOR)"
.sp
Dool توسط Scott Baker \m[blue]\fBscott@perturb\&.org\fR\m[]\&\s-2\u[2]\d\s+2 نگهداری می‌شود
.sp
صفحهٔ خانگی در \m[blue]\fBhttps://github\&.com/scottchiefbaker/dool\fR\m[]
.sp
dstat در ابتدا توسط Dag Wieers \m[blue]\fBdag@wieers\&.com\fR\m[]\&\s-2\u[1]\d\s+2 نوشته شده است
.sp
صفحهٔ خانگی در \m[blue]\fBhttp://dag\&.wieers\&.com/home\-made/dstat\fR\m[]
.sp
این صفحهٔ راهنما در ابتدا توسط Andrew Pollock \m[blue]\fBapollock@debian\&.org\fR\m[]\&\s-2\u[3]\d\s+2 برای سیستم Debian GNU/Linux نوشته شده است\&.
.SH "نویسنده (AUTHOR)"
.PP
\fBScott Baker\fR <\&scott@perturb\&.org\&>
.RS 4
نویسنده.
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
dag@wieers.com
.RS 4
\%mailto:dag@wieers.com
.RE
.IP " 2." 4
scott@perturb.org
.RS 4
\%mailto:scott@perturb.org
.RE
.IP " 3." 4
apollock@debian.org
.RS 4
\%mailto:apollock@debian.org
.RE