lsusb

USB bus와 연결된 USB device 정보를 조회하는 usbutils 명령. vendor/product ID 확인, tree 보기, descriptor 점검에 자주 사용한다.

• lsusb는 현재 연결된 USB 장치를 bus/device 번호와 VID:PID 중심으로 보여준다.
• 간단한 목록은 일반 사용자 권한으로도 충분하지만, 상세 descriptor는 환경에 따라 root 권한이 필요할 수 있다.
• 이 페이지의 help 원문은 현재 작업 환경에서 직접 확인했다.

lsusb [options]...

• lsusb [<switches>…]
• lsusb -t: USB topology tree 출력
• lsusb -v: descriptor 포함 상세 출력
• lsusb -d VID:PID: 특정 vendor/product ID만 필터링
• lsusb -s [ [BUS]: ][DEVNUM]: 특정 bus/device 번호만 출력
• lsusb -D /dev/bus/usb/BUS/DEV: 지정한 device node만 검사

• -v, –verbose: descriptor 상세 출력
• ''-s 22b14c>**-d**</color> <color #7092be>VENDOR[:PRODUCT]</color>'': hexadecimal VID:PID 필터 * ''<color #22b14c>**-D**</color> <color #7092be>DEVICE</color>'': 특정 USB device node 직접 검사 * ''<color #22b14c>**-t**</color>'', ''<color #22b14c>**--tree**</color>'': 물리적 USB tree 표시 * ''<color #22b14c>**-V**</color>'', ''<color #22b14c>**--version**</color>'': 버전 출력 * ''<color #22b14c>**-h**</color>'', ''<color #22b14c>**--help**</color>'': 도움말 출력 ===== Examples ===== <code bash> # 전체 USB 장치 목록 lsusb # 계층 구조로 보기 lsusb -t # 특정 VID:PID 장치만 보기 lsusb -d 303a: lsusb -d 303a:1001 # 특정 bus/device만 보기 lsusb -s 001:002 # descriptor 자세히 보기 lsusb -v # 특정 device node 직접 검사 lsusb -D /dev/bus/usb/001/002 </code> ===== Troubleshooting ===== * ''lsusb'' 자체가 없으면 보통 ''usbutils'' 패키지를 설치해야 한다. * ''-v'' 나 ''-D'' 사용 시 permission denied가 나면 root 권한 또는 적절한 udev 권한이 필요할 수 있다. * 장치가 아예 안 보이면 케이블 전원/데이터 지원 여부, kernel 로그([[dmesg)와 포트 자체 이상 여부를 함께 점검한다. ===== Compatibility ===== * 현재 작업 환경의 lsusb 버전은 usbutils 015 이다. * USB VID/PID는 firmware mode, bootloader mode, composite device 구성에 따라 달라질 수 있다. ===== Help ===== ++ lsusb --help

  Usage: lsusb [options]...
  List USB devices
    -v, --verbose
        Increase verbosity (show descriptors)
    -s [[bus]:][devnum]
        Show only devices with specified device and/or
        bus numbers (in decimal)
    -d vendor:[product]
        Show only devices with the specified vendor and
        product ID numbers (in hexadecimal)
    -D device
        Selects which device lsusb will examine
    -t, --tree
        Dump the physical USB device hierarchy as a tree
    -V, --version
        Show version of program
    -h, --help
        Show usage and help

  ++ ===== See Also ===== * dmesg * lsblk ===== History ===== * codex:: 2026-06-28 Created lsusb page with device filtering, topology examples, and live help output.