xref: /openbsd-src/usr.sbin/usbdevs/usbdevs.8 (revision 48ef77341fedbbef958f32957eef2efbf11434e8)
1*48ef7734Smpi.\" $OpenBSD: usbdevs.8,v 1.12 2018/07/12 07:58:23 mpi Exp $
27517eab2Snate.\" $NetBSD: usbdevs.8,v 1.5 2000/10/15 12:44:11 bjh21 Exp $
3ad1b13fbSjakob.\"
4ad1b13fbSjakob.\" Copyright (c) 1999 The NetBSD Foundation, Inc.
5ad1b13fbSjakob.\" All rights reserved.
6ad1b13fbSjakob.\"
7ad1b13fbSjakob.\" This code is derived from software contributed to The NetBSD Foundation
8ad1b13fbSjakob.\" by Lennart Augustsson.
9ad1b13fbSjakob.\"
10ad1b13fbSjakob.\" Redistribution and use in source and binary forms, with or without
11ad1b13fbSjakob.\" modification, are permitted provided that the following conditions
12ad1b13fbSjakob.\" are met:
13ad1b13fbSjakob.\" 1. Redistributions of source code must retain the above copyright
14ad1b13fbSjakob.\"    notice, this list of conditions and the following disclaimer.
15ad1b13fbSjakob.\" 2. Redistributions in binary form must reproduce the above copyright
16ad1b13fbSjakob.\"    notice, this list of conditions and the following disclaimer in the
17ad1b13fbSjakob.\"    documentation and/or other materials provided with the distribution.
18ad1b13fbSjakob.\"
19ad1b13fbSjakob.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20ad1b13fbSjakob.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21ad1b13fbSjakob.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22ad1b13fbSjakob.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23ad1b13fbSjakob.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24ad1b13fbSjakob.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25ad1b13fbSjakob.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26ad1b13fbSjakob.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27ad1b13fbSjakob.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28ad1b13fbSjakob.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29ad1b13fbSjakob.\" POSSIBILITY OF SUCH DAMAGE.
30ad1b13fbSjakob.\"
31*48ef7734Smpi.Dd $Mdocdate: July 12 2018 $
32ad1b13fbSjakob.Dt USBDEVS 8
33ad1b13fbSjakob.Os
34ad1b13fbSjakob.Sh NAME
35ad1b13fbSjakob.Nm usbdevs
36ad1b13fbSjakob.Nd show USB devices connected to the system
37ad1b13fbSjakob.Sh SYNOPSIS
387517eab2Snate.Nm
39*48ef7734Smpi.Op Fl v
40ad1b13fbSjakob.Op Fl a Ar addr
41*48ef7734Smpi.Op Fl d Ar usbdev
42ad1b13fbSjakob.Sh DESCRIPTION
43ad1b13fbSjakob.Nm
44ad1b13fbSjakobprints a listing of all USB devices connected to the system
45ad1b13fbSjakobwith some information about each device.
46ad1b13fbSjakob.Pp
47ad1b13fbSjakobThe options are as follows:
487517eab2Snate.Bl -tag -width Fl
49ad1b13fbSjakob.It Fl a Ar addr
50959fd710SaaronOnly print information about the device at the given address.
51*48ef7734Smpi.It Fl d Ar usbdev
52959fd710SaaronOnly print information for the given USB controller.
53ad1b13fbSjakob.It Fl v
54ad1b13fbSjakobBe verbose.
55bf1e2c67SschwarzeMultiple
56bf1e2c67Sschwarze.Fl v
57bf1e2c67Sschwarzeoptions increase the verbosity.
58ad1b13fbSjakob.El
59fb99babbSmickey.Sh FILES
60fb99babbSmickey.Bl -tag -width Pa
61fb99babbSmickey.It Pa /dev/usb[0-9]
62fb99babbSmickeyDefault USB controllers.
63fb99babbSmickey.El
64ad1b13fbSjakob.Sh SEE ALSO
65ad1b13fbSjakob.Xr usb 4
66ad1b13fbSjakob.Sh HISTORY
67ad1b13fbSjakobThe
68ad1b13fbSjakob.Nm
69ad1b13fbSjakobcommand appeared in
70ff25aaaeSjakob.Ox 2.7 .
71