.\"SPDX-License-Identifier: GPL-2.0-only
.\"Copyright (c) 1999 Thomas Sailer <sailer@ife.ee.ethz.ch>
.TH lsusb 8 "11 February 2019" "usbutils" "Linux USB Utilities"
.IX lsusb
.SH "نام (NAME)"
lsusb \- فهرست کردن دستگاه‌های USB
.SH "خلاصه دستور (SYNOPSIS)"
.B lsusb
[
.I گزینه‌ها
]
.SH "توضیحات (DESCRIPTION)"
دستور
.B lsusb
ابزاری برای نمایش اطلاعات دربارهٔ گذرگاه‌های USB در سامانه و دستگاه‌های متصل به آن‌ها است. این ابزار از پایگاه داده سخت‌افزار udev برای اختصاص دادن یک نام کامل و خوانا برای انسان به شناسه سازنده (vendor ID) و شناسه محصول (product ID) استفاده می‌کند.

.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-v ", " \-\-verbose
به
.I lsusb
دستور می‌دهد تا خروجی مشروح و پرجزئیاتی دربارهٔ دستگاه‌های نمایش‌داده‌شده ارائه دهد. این اطلاعات شامل توصیف‌کننده‌های پیکربندی برای سرعت فعلی دستگاه است. توصیف‌کننده‌های کلاس در صورت دردسترس بودن برای کلاس‌های دستگاه‌های USB شامل هاب، صدا (audio)، دستگاه رابط انسانی (HID)، ارتباطات (communications) و کارت‌تراشه (chipcard) نمایش داده خواهند شد. می‌تواند همراه با گزینهٔ
\fB-t\fP
استفاده شود.
.TP
\fB\-s\fP [[\fIbus\fP]\fB:\fP][\fIdevnum\fP]
تنها دستگاه‌های واقع در
.I گذرگاه (bus)
و/یا
.IR "شماره دستگاه (devnum)"
مشخص‌شده را نمایش می‌دهد. هر دو شناسه به صورت ده‌دهی (decimal) داده می‌شوند و ممکن است حذف شوند.
.TP
\fB\-d\fP [\fIvendor\fP]\fB:\fP[\fIproduct\fP]
تنها دستگاه‌هایی با شناسه سازنده (vendor ID) و شناسه محصول (product ID) مشخص‌شده را نمایش می‌دهد. هر دو شناسه به صورت شانزده‌شانزدهی (hexadecimal) داده می‌شوند.
.TP
.B \-D \fIdevice\fP
شاخه /dev/bus/usb را پویش نمی‌کند، بلکه تنها اطلاعات مربوط به دستگاهی را نمایش می‌دهد که پروندهٔ دستگاه آن داده شده است. پروندهٔ دستگاه باید چیزی شبیه به /dev/bus/usb/001/001 باشد. این گزینه اطلاعات دقیقی همانند گزینهٔ \fB-v\fP نمایش می‌دهد؛ برای انجام این کار باید دسترسی ریشه (root) داشته باشید.
.TP
.BR \-t ", " \-\-tree
به
.I lsusb
دستور می‌دهد تا سلسله‌مراتب فیزیکی دستگاه‌های USB را به صورت یک درخت نمایش دهد. سطح جزئیات را می‌توان دو بار با گزینهٔ
\fB-v\fP
افزایش داد.
.TP
.BR \-V ", " \-\-version
اطلاعات نسخه را در خروجی استاندارد چاپ می‌کند و سپس با موفقیت خارج می‌شود.

.SH "کدهای خروج (EXIT STATUS)"
اگر دستگاه مشخص‌شده پیدا نشود، یک کد خروج غیر صفر برگردانده می‌شود.

.SH "همچنین ببینید (SEE ALSO)"
.BR lspci (8),
.BR usbview (8).

.SH "نویسنده (AUTHOR)"
Thomas Sailer, <sailer@ife.ee.ethz.ch>.