نام (NAME)

usbhid-dump - استخراج گزارش‌ها و توصیف‌گرهای دستگاه‌های رابط انسانی USB (HID)

خلاصه دستور (SYNOPSIS)

usbhid-dump [گزینه‌ها]...

توضیحات (DESCRIPTION)

دستور usbhid-dump از libusb برای استخراج توصیف‌گرهای گزارش و جریان‌ها از رابط‌های HID (دستگاه رابط انسانی) دستگاه‌های USB استفاده می‌کند. این ابزار به‌طور پیش‌فرض، رابط‌های HID تمام دستگاه‌های USB متصل را استخراج می‌کند، اما با استفاده از گزینه‌ها می‌توان آن را به زیرمجموعه‌ای از آن‌ها یا به یک رابط منفرد محدود کرد.

نکته: دستور usbhid-dump درایورهای هسته را از رابط‌هایی که تخلیه و استخراج می‌کند جدا (detach) کرده و به‌صورت انحصاری از آن‌ها استفاده می‌کند؛ بنابراین در این مدت هیچ برنامه دیگری ورودی را دریافت نخواهد کرد. استخراج توصیف‌گر گزارش آنی است، اما استخراج جریان تا زمانی که با سیگنال SIGINT (کلیدهای C^ در ترمینال) متوقف شود یا مهلت زمانی به پایان برسد ادامه می‌یابد.

اگر به‌طور تصادفی استخراج جریان را از صفحه‌کلید USB که برای کنترل ترمینال استفاده می‌کنید آغاز کنید، سیستم دریافت ورودی را متوقف می‌کند و شما قادر به متوقف کردن usbhid-dump نخواهید بود. در این حالت کافی است ورودی دادن را متوقف کرده و تا اتمام مهلت زمانی منتظر بمانید. استخراج جریان متوقف خواهد شد، صفحه‌کلید مجدداً به درایور هسته متصل می‌شود و کنترل را دوباره به دست خواهید آورد.

مهلت زمانی پیش‌فرض برای استخراج جریان ۶۰ ثانیه است و می‌توان آن را با گزینهٔ -t تغییر داد.

گزینه‌ها (OPTIONS)

-h, --help: چاپ پیام راهنما و خروج.
-v, --version: چاپ اطلاعات نسخه و خروج.
-s, -a, --address=bus[:dev]: محدود کردن رابط‌ها بر اساس شماره گذرگاه و نشانی دستگاه. هر دو در بازه ۱-۲۵۵ و به صورت ده‌دهی هستند. عدد صفر با هر گذرگاه یا دستگاهی مطابقت دارد.
-d, -m, --model=vid[:pid]: محدود کردن رابط‌ها بر اساس شناسه سازنده و شناسه محصول. هر دو در بازه 1-FFFF و به صورت شانزده‌شانزدهی هستند. عدد صفر با هر سازنده یا محصولی مطابقت دارد.
-i, --interface=NUMBER: محدود کردن رابط‌ها بر اساس شماره رابط (۰-۲۵۴) به صورت ده‌دهی. مقدار ۲۵۵ با هر رابطی مطابقت دارد.
-e, --entity=STRING: موجودیتی که باید استخراج شود: یکی از مقادیر "descriptor"، "stream" یا "all". مقدار می‌تواند تا یک حرف کوتاه شود. مقدار پیش‌فرض "descriptor" است.
-t, --stream-timeout=NUMBER: مهلت زمانی انتقال وقفه جریان بر حسب میلی‌ثانیه. عدد صفر به معنای بی‌نهایت است. مقدار پیش‌فرض ۶۰۰۰۰ (۶۰ ثانیه) است.
-p, --stream-paused: آغاز با خروجی استخراج جریان در وضعیت متوقف‌شده (paused).
-f, --stream-feedback: فعال‌سازی بازخورد استخراج جریان: چاپ یک نقطه در stderr به ازای هر انتقال استخراج‌شده.

سیگنال‌ها (SIGNALS)

USR1/USR2: توقف موقت یا ازسرگیری خروجی استخراج جریان.

قالب خروجی (OUTPUT FORMAT)

دستور usbhid-dump خروجی‌های استخراج‌شده را در تکه‌ها (chunks) ارائه می‌دهد. هر تکه با یک خط خالی جدا می‌شود و با خط سرآیند زیر آغاز می‌گردد:

BUS:DEVICE:INTERFACE:ENTITY TIMESTAMP

در اینجا BUS ،DEVICE و INTERFACE به‌ترتیب شماره‌های گذرگاه، دستگاه و رابط هستند. ENTITY یکی از مقادیر "DESCRIPTOR" یا "STREAM" است. TIMESTAMP برچسب زمانی بر حسب ثانیه از مبدأ زمان (epoch) است.

پس از سرآیند، داده‌های اصلی استخراج‌شده به صورت بایت‌های هگزادسیمال می‌آیند. یک تکه توصیف‌گر شامل کل توصیف‌گر گزارش است. هر تکه جریان معمولاً شامل یک گزارش کامل است، اما اگر یک گزارش بزرگ‌تر از wMaxPacketSize نقطه پایانی باشد، در چندین تکه پخش خواهد شد.

مثال‌ها (EXAMPLES)

استخراج توصیف‌گر گزارش برای دستگاهی با نشانی ۳ در گذرگاه شماره ۲:: usbhid-dump -a 2:3
استخراج جریان گزارش برای دستگاهی با شناسه سازنده 0x5543 و شناسه محصول 0x0005:: usbhid-dump -m 5543:0005 -es
استخراج توصیف‌گر گزارش از رابط ۱ یک دستگاه با شناسه سازنده 0x5543:: usbhid-dump -m 5543 -i 1 -ed
استخراج جریان‌های گزارش از تمام رابط‌های HID تمامی دستگاه‌های USB (احتیاط: در صورت استفاده از صفحه‌کلید USB، کنترل ترمینال را از دست خواهید داد):: usbhid-dump -es

نویسنده (AUTHOR)

Nikolai Kondrashov <spbnick@gmail.com>

همچنین ببینید (SEE ALSO)

lsusb(8), usb-devices(1).