.TH "pw-top" 1 "1.6.8" "PipeWire" \" -*- nroff -*-
.ad l
.nh
.SH "نام (NAME)"
pw\-top \- نمایشگر پویای فرایندهای پایپ‌ویر
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.PP
\fBpw-top\fP [\fIگزینه‌ها\fP]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
.PP
برنامه
\fIpw-top\fP
نمایی پویا و بلادرنگ از آمار دستگاه‌ها و گره‌های پایپ‌ویر (PipeWire) ارائه می‌دهد\&.
.PP
نمایی سلسله‌مراتبی از گره‌های راه‌انداز (Driver) و گره‌های پیرو (Follower) نمایش داده می‌شود\&. گره‌های راه‌انداز به صورت فعال از یک زمان‌سنج (Timer) برای زمان‌بندی جریان داده در پیروها استفاده می‌کنند\&. گره‌های پیروِ هر گره راه‌انداز در زیر راه‌انداز مربوطه با علامت + (یا = برای گره‌های ناهمگام) در یک نمایش درختی نشان داده می‌شوند\&.
.PP
ستون‌های نمایش‌داده‌شده به شرح زیر هستند:
.PP
\fBS\fP
.RS 4
وضعیت گره\&.
.PP
.IP "\(bu" 2
E = ERROR (خطا)
.IP "\(bu" 2
C = CREATING (در حال ایجاد)
.IP "\(bu" 2
S = SUSPENDED (معلق)
.IP "\(bu" 2
I = IDLE (بیکار)
.IP "\(bu" 2
R = RUNNING (در حال اجرا)
.IP "\(bu" 2
t = RUNNING + transport starting (در حال اجرا + آغاز ترنسپورت)
.IP "\(bu" 2
T = RUNNING + transport running (در حال اجرا + ترنسپورت فعال)
.PP
.RE
.PP
.PP
\fBID\fP
.RS 4
شناسه گره یا دستگاه پایپ‌ویر، همان‌طور که در
\fIpw-dump\fP
و
\fIpw-cli\fP
یافت می‌شود\&.
.RE
.PP
\fBQUANT\fP
.RS 4
کوانتوم (Quantum) جاری (برای راه‌اندازها) و کوانتوم پیشنهادی برای گره‌های پیرو\&.
.PP
مقدار کوانتوم به خودی خود باید بر مقدار ستون RATE تقسیم شود تا مدت زمان یک دوره زمان‌بندی به کسر ثانیه محاسبه گردد\&.
.PP
برای مقدار QUANT برابر با ۱۰۲۴ و مقدار RATE برابر با ۴۸۰۰۰، مدت یک دوره در گراف برابر با ۱۰۲۴/۴۸۰۰۰ یعنی ۲۱\&.۳ میلی‌ثانیه است\&.
.PP
گره‌های پیرو می‌توانند مقدار QUANT برابر با ۰ داشته باشند، به این معنا که گره پیشنهادی برای کوانتوم ندارد و بنابراین از آنچه راه‌انداز برگزیده استفاده می‌کند\&.
.PP
راه‌انداز از کمترین کوانتوم در میان تمام پیروها استفاده خواهد کرد\&. اگر هیچ‌یک از پیروها کوانتومی انتخاب نکنند، کوانتوم پیش‌فرض موجود در فایل پیکربندی پایپ‌ویر استفاده خواهد شد\&.
.PP
مقدار QUANT در راه‌اندازها معمولاً مستقیماً به تعداد نمونه‌های صوتی پردازش‌شده در هر چرخه پردازشی گراف ترجمه می‌شود\&.
.PP
همچنین ببینید:
<https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/FAQ#pipewire-buffering-explained>
.RE
.PP
.PP
\fBRATE\fP
.RS 4
نرخ جاری (برای راه‌اندازها) و نرخ پیشنهادی برای گره‌های پیرو\&.
.PP
این نرخی است که
\fIگراف\fP
داده‌ها را با آن پردازش می‌کند و باید با مقدار QUANT ترکیب شود تا مدت زمان یک چرخه پردازش در گراف به دست آید\&.
.PP
برخی گره‌ها می‌توانند مقدار RATE برابر با ۰ داشته باشند، به این معنا که هیچ پیشنهادی برای نرخ گراف ندارند\&. گره‌هایی که یک نرخ را پیشنهاد می‌دهند می‌توانند در صورتی که گراف بیکار باشد و نرخ جدید به عنوان نرخ مجاز گراف تعریف شده باشد (فایل پیکربندی پایپ‌ویر را ببینید)، موجب تغییر نرخ گراف شوند\&.
.PP
مقدار RATE در گره‌های راه‌انداز (صوتی) معمولاً مستقیماً به نرخ نمونه‌برداری (Samplerate) مورداستفاده توسط دستگاه تبدیل می‌شود\&. اگرچه ممکن است برخی دستگاه‌ها قادر به کار در نرخ نمونه‌برداری ارائه‌شده نباشند، که در این حالت بازنمونه‌برداری (Resampling) انجام خواهد شد\&. نرخ نمونه‌برداری توافق‌شده با دستگاه و جریان را می‌توان در ستون FORMAT یافت\&.
.PP
.RE
.PP
.PP
\fBWAIT\fP
.RS 4
زمان انتظار یک گره، مدت‌زمان سپری‌شده میان لحظه‌ای است که گره آماده شروع پردازش است تا زمانی که واقعاً پردازش را آغاز می‌کند\&.
.PP
برای گره‌های راه‌انداز، این زمان فاصله میان بیدار شدن گره برای شروع پردازش گراف تا تکمیل یک چرخه توسط راه‌انداز (و بنابراین گراف) است\&. بنابراین زمان WAIT برای راه‌انداز، زمان سپری‌شده در پردازش گراف است\&.
.PP
برای گره‌های پیرو، این مدت زمانی است که بین بیدار شدن (هنگامی که تمام وابستگی‌های گره برآورده شدند) و شروع پردازش سپری می‌شود\&. بنابراین زمان WAIT برای گره‌های پیرو عمدتاً ناشی از تعویض زمینه (Context Switching) است\&.
.PP
مقدار \-\-\- به این معنی است که به گره سیگنالی ارسال نشده است\&. مقدار +++ به این معنی است که به گره سیگنال داده شده اما بیدار نشده است\&.
.RE
.PP
.PP
\fBBUSY\fP
.RS 4
زمان پردازش، از زمانی که گره پردازش را آغاز می‌کند تا زمانی که کار را به پایان رسانده و گره‌های بعدی را در گراف بیدار می‌کند محاسبه می‌شود\&.
.PP
مقدار \-\-\- به این معنی است که گره شروع به کار نکرده است\&. مقدار +++ به این معنی است که گره شروع به کار کرده اما کار را تمام نکرده است\&.
.RE
.PP
.PP
\fBW/Q\fP
.RS 4
نسبت WAIT / QUANT\&.
.PP
مقدار W/Q در گره راه‌انداز معیار مناسبی برای بار پردازشی گراف است\&. میانگین متحرک نسبت‌های W/Q راه‌انداز، به عنوان بار DSP در سایر ابزارها (مانند JACK) استفاده می‌شود\&.
.PP
مقادیر \-\-\- و +++ از ستون WAIT کپی می‌شوند\&.
.PP
.RE
.PP
.PP
\fBB/Q\fP
.RS 4
نسبت BUSY / QUANT\&.
.PP
این معیار مناسبی برای سنجش بار کاری یک گره راه‌انداز یا پیرو خاص است\&.
.PP
مقادیر \-\-\- و +++ از ستون BUSY کپی می‌شوند\&.
.RE
.PP
.PP
\fBERR\fP
.RS 4
مجموع Xrunها و خطاها\&.
.PP
رخ دادن Xrun در راه‌اندازها زمانی است که گراف یک چرخه را کامل نکرده باشد\&. این می‌تواند به این دلیل باشد که گره‌ای در گراف دچار Xrun شده است\&. همچنین می‌تواند ناشی از تأخیرهای زمان‌بندی باشد که منجر به از دست رفتن مهلت زمانی (Deadline) و ایجاد Xrun سخت‌افزاری می‌شود\&.
.PP
شمارنده Xrun برای پیروها زمانی افزایش می‌یابد که گره پردازش را آغاز کرده باشد اما پیش از پایان مهلت چرخه گراف کار را تمام نکند\&.
.RE
.PP
.PP
\fBFORMAT\fP
.RS 4
فرمت مورداستفاده توسط گره راه‌انداز یا جریان\&. این فرمت سخت‌افزاری توافق‌شده با دستگاه یا جریان است\&.
.PP
اگر جریان یا راه‌انداز نرخی متفاوت از گراف داشته باشد، بازنمونه‌برداری (Resampling) انجام خواهد شد\&.
.PP
برای فرمت‌های صوتی خام (Raw)، ساختار به صورت <sampleformat> <channels> <samplerate> است\&.
.PP
برای فرمت‌های صوتی عبوری (Passthrough) استاندارد IEC958، ساختار به صورت IEC958 <codec> <samplerate> است\&.
.PP
برای فرمت‌های DSD، ساختار به صورت <dsd-rate> <channels> است\&.
.PP
برای فرمت‌های ویدیویی، ساختار به صورت <pixelformat> <width>x<height> است\&.
.RE
.PP
.PP
\fBNAME\fP
.RS 4
نام اختصاص‌یافته به دستگاه یا گره، همان‌گونه که در مقدار node\&.name در دستور
\fIpw-dump\fP
یافت می‌شود\&.
.PP
نام‌ها با پیشوند
\fI+\fP/*=*
مشخص می‌شوند هنگامی که به یک راه‌انداز پیوند خورده باشند (مدخل بالایی که فاقد +/= است)\&.
.RE
.PP
.PP
.SH "دستورها (COMMANDS)"
.PP
.PP
کلیدهای زیر در حالت تعاملی قابل استفاده هستند:
.PP
\fBq\fP
.RS 4
خروج
.RE
.PP
\fBc\fP
.RS 4
پاک کردن شمارنده‌های ERR\&. این کار شمارنده‌ها را به صورت سراسری پاک
\fIنمی‌کند\fP،
بلکه فقط شمارنده‌ها را در این نمونه اجرایی از
\fIpw-top\fP
صفر خواهد کرد\&.
.RE
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
.PP
\fB-h | --help\fP
.RS 4
نمایش راهنما\&.
.RE
.PP
\fB-b | --batch-mode\fP
.RS 4
اجرا در حالت دسته‌ای و غیرتعاملی، مشابه حالت دسته‌ای در دستور top\&.
.RE
.PP
\fB-n | --iterations=NUMBER\fP
.RS 4
خروج پس از NUMBER بار تکرار دسته‌ای\&. فقط در حالت دسته‌ای کاربرد دارد\&.
.RE
.PP
\fB-r | --remote=NAME\fP
.RS 4
نام نمونه
\fIremote\fP
برای نظارت\&. در صورت نامشخص بودن، اتصال به نمونه پیش‌فرض PipeWire برقرار می‌شود\&.
.RE
.PP
\fB-V | --version\fP
.RS 4
نمایش اطلاعات نسخه\&.
.RE
.PP
.SH "نویسندگان (AUTHORS)"
.PP
.PP
توسعه‌دهندگان پایپ‌ویر <https://gitlab.freedesktop.org/pipewire/pipewire/issues>؛ پایپ‌ویر در <https://pipewire.org> در دسترس است\&.
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
.PP
\fBpipewire(1)\fP, \fBpw-dump(1)\fP, \fBpw-cli(1)\fP, \fBpw-profiler(1)\fP