V4L2-TRACER(1)                  دستورهای کاربری                 V4L2-TRACER(1)

نام (NAME)
       v4l2-tracer - برنامه‌ای برای ردگیری و بازپخش رمزگشایی ویدیویی بدون حالت
       (stateless).

خلاصه دستور (SYNOPSIS)
       v4l2-tracer [گزینه‌ها] trace <tracee>
       v4l2-tracer [گزینه‌ها] retrace  <trace_file>.json
       v4l2-tracer clean  <file>.json


توضیحات (DESCRIPTION)
       ابزار v4l2-tracer برنامه‌های فضای کاربری (userspace) را که رابط رمزگشای
       ویدیویی بدون حالت حافظه‌به‌حافظه (memory-to-memory stateless) در v4l2 را
       پیاده‌سازی کرده‌اند، ردگیری، ضبط و بازپخش می‌کند.

   Trace
       فراخوانی‌های سیستمی و داده‌های فریم ویدیویی ارسال‌شده از سوی برنامه فضای
       کاربری <tracee> به گرداننده هسته (kernel driver) را ردگیری می‌کند.  تمام
       کنترل‌های کدک بدون حالت در API فضای کاربری قابل ردگیری هستند. خروجی یک
       فایل ردگیری با قالب JSON است.

   Retrace
       فایل با قالب JSON با نام <trace_file>.json را می‌خواند. همان فراخوانی‌های
       سیستمی را بازپخش کرده و همان داده‌های فریم ویدیویی را به گرداننده هسته
       ارسال می‌کند.  خروجی یک فایل بازپخش با قالب JSON است.


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


گزینه‌ها (OPTIONS)
   گزینه‌های عمومی (Common Options)
       -c, --compact
              نوشتن کمترین فاصله‌های خالی (whitespace) در فایل JSON.

       -g, --debug
              فعال کردن گزارش‌دهی پرگو (verbose) به‌همراه اطلاعات اشکال‌زدایی
              اضافی.

       -h, --help
              نمایش این پیام راهنما.

       -r, --raw
              نوشتن داده‌های فریم ویدیویی رمزگشایی‌شده در فایل JSON.

       -v, --verbose
              فعال کردن گزارش‌دهی پرگو (verbose).

       -y, --yuv
              نوشتن داده‌های فریم ویدیویی رمزگشایی‌شده در فایل yuv.


   گزینه‌های Retrace (Retrace Options)
       -d, --device <dev>
              استفاده از یک دستگاه ویدیویی متفاوت از آنچه در فایل ردگیری مشخص
              شده است.
              <dev> باید عددی متناظر با یک /dev/video<dev> موجود باشد.

       -m, --media <dev>
              استفاده از یک دستگاه رسانه‌ای متفاوت از آنچه در فایل ردگیری مشخص
              شده است.
              <dev> باید عددی متناظر با یک /dev/media<dev> موجود باشد.


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


مثال‌ها (EXAMPLES)
       ردگیری برنامه‌ای که در حال رمزگشایی ویدیوی VP8 است:
              v4l2-tracer trace gst-launch-1.0 -- filesrc location=test-25fps.vp8 ! parsebin ! v4l2slvp8dec ! videocodectestsink

       یک فایل ردگیری تولید می‌شود:
              71827_trace.json

       بازپخش فایل ردگیری:
              v4l2-tracer retrace 71827_trace.json

       مشخص کردن گره‌های دستگاه در صورت بازپخش روی یک گرداننده متفاوت:
              v4l2-tracer -d0 -m0 retrace 71827_trace.json

       یک فایل بازپخش تولید می‌شود:
              71827_trace_retrace.json

       حذف توصیف‌کننده‌های فایل و نشانی‌ها (اختیاری):
              v4l2-tracer clean 71827_trace.json
              v4l2-tracer clean 71827_trace_retrace.json

       فایل‌های پاک‌سازی‌شده برای مقایسه تولید می‌شوند:
              clean_71827_trace.json
              clean_71827_trace_retrace.json


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

v4l-utils 1.32.0                  نوامبر 2022                   V4L2-TRACER(1)