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

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

v4l2-tracer [گزینه‌ها] trace <tracee>

v4l2-tracer [گزینه‌ها] retrace <trace_file>.json v4l2-tracer clean <file>.json

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

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

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

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

نوشتن کمترین فاصله‌های خالی (whitespace) در فایل JSON.
فعال کردن گزارش‌دهی پرگو (verbose) به‌همراه اطلاعات اشکال‌زدایی اضافی.
نمایش این پیام راهنما.
نوشتن داده‌های فریم ویدیویی رمزگشایی‌شده در فایل JSON.
فعال کردن گزارش‌دهی پرگو (verbose).
نوشتن داده‌های فریم ویدیویی رمزگشایی‌شده در فایل yuv.

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

در صورت موفقیت، مقدار 0 بازگردانده می‌شود. در غیر این صورت، مقدار 1 یا یک کد خطا بازگردانده خواهد شد.

ردگیری برنامه‌ای که در حال رمزگشایی ویدیوی 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

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

نوامبر 2022 v4l-utils 1.32.0