.TH "V4L2-TRACER" "1" "نوامبر 2022" "v4l-utils 1.32.0" "دستورهای کاربری"
.SH "نام (NAME)"
v4l2-tracer \- برنامه‌ای برای ردگیری و بازپخش رمزگشایی ویدیویی بدون حالت (stateless).
.SH "خلاصه دستور (SYNOPSIS)"
\fBv4l2-tracer \fR[گزینه‌ها] \fBtrace\fR <\fItracee\fR>
.RS
.RE
\fBv4l2-tracer \fR[گزینه‌ها] \fBretrace\fR  <\fItrace_file\fR>\fB.json\fR
.RS
.RE
\fBv4l2-tracer clean\fR  <\fIfile\fR>\fB.json\fR
.RS
.RE

.SH "توضیحات (DESCRIPTION)"
ابزار v4l2-tracer برنامه‌های فضای کاربری (userspace) را که رابط رمزگشای ویدیویی بدون حالت حافظه‌به‌حافظه (memory-to-memory stateless) در v4l2 را پیاده‌سازی کرده‌اند، ردگیری، ضبط و بازپخش می‌کند.
.SS Trace
فراخوانی‌های سیستمی و داده‌های فریم ویدیویی ارسال‌شده از سوی برنامه فضای کاربری <\fItracee\fR> به گرداننده هسته (kernel driver) را ردگیری می‌کند.
تمام کنترل‌های کدک بدون حالت در API فضای کاربری قابل ردگیری هستند. خروجی یک فایل ردگیری با قالب JSON است.
.SS Retrace
فایل با قالب JSON با نام <\fItrace_file\fR>\fB.json\fR را می‌خواند. همان فراخوانی‌های سیستمی را بازپخش کرده و همان داده‌های فریم ویدیویی را به گرداننده هسته ارسال می‌کند.
خروجی یک فایل بازپخش با قالب JSON است.

.SS Clean
سطرهایی را که دارای تفاوت‌های نامرتبط هستند (مانند توصیف‌کننده‌های فایل و نشانی‌های حافظه) از فایل‌های JSON حذف می‌کند.
یک نسخه پاک‌سازی‌شده خروجی می‌دهد که لزوماً همچنان در قالب JSON نیست.

.SH "گزینه‌ها (OPTIONS)"
.SS گزینه‌های عمومی (Common Options)
.TP
\fB\-c\fR, \fB\-\-compact\fR
نوشتن کمترین فاصله‌های خالی (whitespace) در فایل JSON.
.TP
\fB\-g\fR, \fB\-\-debug\fR
فعال کردن گزارش‌دهی پرگو (verbose) به‌همراه اطلاعات اشکال‌زدایی اضافی.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش این پیام راهنما.
.TP
\fB\-r\fR, \fB\-\-raw\fR
نوشتن داده‌های فریم ویدیویی رمزگشایی‌شده در فایل JSON.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فعال کردن گزارش‌دهی پرگو (verbose).
.TP
\fB\-y\fR, \fB\-\-yuv\fR
نوشتن داده‌های فریم ویدیویی رمزگشایی‌شده در فایل yuv.

.SS گزینه‌های Retrace (Retrace Options)
.TP
\fB\-d\fR, \fB\-\-device\fR <\fIdev\fR>
استفاده از یک دستگاه ویدیویی متفاوت از آنچه در فایل ردگیری مشخص شده است.
.RS
<\fIdev\fR> باید عددی متناظر با یک /dev/video<\fIdev\fR> موجود باشد.
.RE
.TP
\fB\-m\fR, \fB\-\-media\fR <\fIdev\fR>
استفاده از یک دستگاه رسانه‌ای متفاوت از آنچه در فایل ردگیری مشخص شده است.
.RS
<\fIdev\fR> باید عددی متناظر با یک /dev/media<\fIdev\fR> موجود باشد.
.RE

.SH "وضعیت خروج (EXIT STATUS)"
در صورت موفقیت، مقدار 0 بازگردانده می‌شود. در غیر این صورت، مقدار 1 یا یک کد خطا بازگردانده خواهد شد.

.SH "مثال‌ها (EXAMPLES)"
.TP
ردگیری برنامه‌ای که در حال رمزگشایی ویدیوی VP8 است:
.EX
\fIv4l2-tracer trace gst-launch-1.0 -- filesrc location=test-25fps.vp8 ! parsebin ! v4l2slvp8dec ! videocodectestsink\fR
.EE
.TP
یک فایل ردگیری تولید می‌شود:
.EE
\fI71827_trace.json\fR
.TP
بازپخش فایل ردگیری:
.EX
\fIv4l2-tracer retrace 71827_trace.json\fR
.EE
.TP
مشخص کردن گره‌های دستگاه در صورت بازپخش روی یک گرداننده متفاوت:
.EX
\fIv4l2-tracer -d0 -m0 retrace 71827_trace.json\fR
.EE
.TP
یک فایل بازپخش تولید می‌شود:
.EE
\fI71827_trace_retrace.json\fR
.EX
.TP
حذف توصیف‌کننده‌های فایل و نشانی‌ها (اختیاری):
.EX
\fIv4l2-tracer clean 71827_trace.json\fR
.EE
.EX
\fIv4l2-tracer clean 71827_trace_retrace.json\fR
.EE
.TP
فایل‌های پاک‌سازی‌شده برای مقایسه تولید می‌شوند:
.EX
\fIclean_71827_trace.json\fR
.EE
.EE
\fIclean_71827_trace_retrace.json\fR
.EX

.SH "گزارش باگ‌ها (BUGS)"
گزارش‌های باگ یا پرسش‌ها درباره این ابزار باید به فهرست پستی
linux-media@vger.kernel.org ارسال شوند.