usbconfig.8 (41adbaa596765145392ca1b560940dcc495ef445) usbconfig.8 (49366f62991ba8e723c0fcadd60007afe4d3b0a5)
1.\" $FreeBSD$
2.\"
3.\" Copyright (c) 2008-2010 Hans Petter Selasky. All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright

--- 9 unchanged lines hidden (view full) ---

18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
1.\" $FreeBSD$
2.\"
3.\" Copyright (c) 2008-2010 Hans Petter Selasky. All rights reserved.
4.\"
5.\" Redistribution and use in source and binary forms, with or without
6.\" modification, are permitted provided that the following conditions
7.\" are met:
8.\" 1. Redistributions of source code must retain the above copyright

--- 9 unchanged lines hidden (view full) ---

18.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24.\" SUCH DAMAGE.
25.\"
26.Dd April 29, 2018
26.Dd August 16, 2019
27.Dt USBCONFIG 8
28.Os
29.Sh NAME
30.Nm usbconfig
31.Nd configure the USB subsystem
32.Sh SYNOPSIS
33.Nm
34.Op Fl u Ar unit

--- 12 unchanged lines hidden (view full) ---

47.It Fl u Ar unit
48Limit device range to USB devices connected to the given USBUS unit.
49.It Fl a Ar addr
50Limit device range to the given USB device index.
51Should only be used in conjunction with the unit argument.
52.It Fl d Ar [ugen]<unit>.<addr>
53Limit device range to USB devices connected to the given unit and address.
54The unit and address coordinates may be prefixed by the lowercased word "ugen".
27.Dt USBCONFIG 8
28.Os
29.Sh NAME
30.Nm usbconfig
31.Nd configure the USB subsystem
32.Sh SYNOPSIS
33.Nm
34.Op Fl u Ar unit

--- 12 unchanged lines hidden (view full) ---

47.It Fl u Ar unit
48Limit device range to USB devices connected to the given USBUS unit.
49.It Fl a Ar addr
50Limit device range to the given USB device index.
51Should only be used in conjunction with the unit argument.
52.It Fl d Ar [ugen]<unit>.<addr>
53Limit device range to USB devices connected to the given unit and address.
54The unit and address coordinates may be prefixed by the lowercased word "ugen".
55.It Fl i Ar interface_index
56Specify interface index as indicated by the command description.
57If this argument is not specified a value of zero will be used for the interface index.
55.It Fl h
56Show help and available commands.
57.El
58.Pp
59The following commands may be used with
60.Nm :
61.Bl -tag -width indent
62.It Cm set_config Ar cfg_index
63Choose the configuration for the USB device.
64Valid values range from zero to the number reported as the
65.Ar bNumConfigurations
66in
67.Cm dump_device_desc
68output.
69The special value of 255 unconfigures the device, detaching
70the interface drivers and reducing the power consumption to minimum,
71but without going into power saving mode or detaching from the bus.
72In some cases, it prevents the device from charging.
73.It Cm set_alt Ar alt_index
58.It Fl h
59Show help and available commands.
60.El
61.Pp
62The following commands may be used with
63.Nm :
64.Bl -tag -width indent
65.It Cm set_config Ar cfg_index
66Choose the configuration for the USB device.
67Valid values range from zero to the number reported as the
68.Ar bNumConfigurations
69in
70.Cm dump_device_desc
71output.
72The special value of 255 unconfigures the device, detaching
73the interface drivers and reducing the power consumption to minimum,
74but without going into power saving mode or detaching from the bus.
75In some cases, it prevents the device from charging.
76.It Cm set_alt Ar alt_index
74Choose the alternate interface for the USB device.
77Choose the alternate interface for the selected interface and USB device.
75Alternative settings for the current configuration are available as the
76.Ar bAlternateSetting
77in
78.Cm dump_curr_config_desc
79output.
80Usually there is no need to adjust this setting.
81.It Cm set_template Ar template
82Set the global USB device side template.

--- 31 unchanged lines hidden (view full) ---

114.It Cm dump_info
115Display summary information about the device.
116.It Cm show_ifdrv
117Display the list of interface drivers (such as
118.Xr ukbd 4
119or
120.Xr u3g 4 )
121currently attached to the device.
78Alternative settings for the current configuration are available as the
79.Ar bAlternateSetting
80in
81.Cm dump_curr_config_desc
82output.
83Usually there is no need to adjust this setting.
84.It Cm set_template Ar template
85Set the global USB device side template.

--- 31 unchanged lines hidden (view full) ---

117.It Cm dump_info
118Display summary information about the device.
119.It Cm show_ifdrv
120Display the list of interface drivers (such as
121.Xr ukbd 4
122or
123.Xr u3g 4 )
124currently attached to the device.
125.It Cm detach_kernel_driver
126Detach kernel driver for the selected interface and USB device.
122.It Cm suspend
123Force the device to suspend.
124.It Cm resume
125Force the device to resume.
126.It Cm power_off
127Turn the device off.
128.It Cm power_save
129Turn the automatic suspend and resume on.

--- 38 unchanged lines hidden ---
127.It Cm suspend
128Force the device to suspend.
129.It Cm resume
130Force the device to resume.
131.It Cm power_off
132Turn the device off.
133.It Cm power_save
134Turn the automatic suspend and resume on.

--- 38 unchanged lines hidden ---