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 [ [BUS]: ][DEVNUM]: decimal bus/device 번호 필터
• -d VENDOR[:PRODUCT]: hexadecimal VID:PID 필터
• -D DEVICE: 특정 USB device node 직접 검사
• -t, –tree: 물리적 USB tree 표시
• -V, –version: 버전 출력
• -h, –help: 도움말 출력

# 전체 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

• lsusb 자체가 없으면 보통 usbutils 패키지를 설치해야 한다.
• -v 나 -D 사용 시 permission denied가 나면 root 권한 또는 적절한 udev 권한이 필요할 수 있다.
• 장치가 아예 안 보이면 케이블 전원/데이터 지원 여부, kernel 로그(dmesg)와 포트 자체 이상 여부를 함께 점검한다.

• 현재 작업 환경의 lsusb 버전은 usbutils 015 이다.
• USB VID/PID는 firmware mode, bootloader mode, composite device 구성에 따라 달라질 수 있다.

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

• dmesg
• lsblk

• codex:: 2026-06-28 Created lsusb page with device filtering, topology examples, and live help output.