Page MenuHomeFreeBSD

Improve usbconfig(8) manual page
ClosedPublic

Authored by trasz on Dec 11 2017, 1:18 PM.
Tags
None
Referenced Files
Unknown Object (File)
Tue, Apr 30, 12:50 AM
Unknown Object (File)
Apr 17 2024, 6:03 PM
Unknown Object (File)
Apr 14 2024, 10:50 AM
Unknown Object (File)
Mar 12 2024, 8:17 AM
Unknown Object (File)
Mar 12 2024, 8:12 AM
Unknown Object (File)
Mar 12 2024, 8:12 AM
Unknown Object (File)
Mar 12 2024, 8:11 AM
Unknown Object (File)
Mar 12 2024, 8:11 AM
Subscribers

Details

Summary

Improve usbconfig(8) manual page by adding descriptions for subcommands.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 13504
Build 13729: arc lint + arc unit

Event Timeline

Check my comments and update. Thanks!

usr.sbin/usbconfig/usbconfig.8
139

Can you add this:

The cnf_index value starts at zero and always increments by one. A value of 255 means unconfigure the device.

--HPS

143

-d ugen1.2 or -d 1.2 are both valid syntaxes.

146

Usually there is no need to change the alternate interface selection for a USB device from userspace.

193

By default only HUBs have this feature turned on by default.

200

This is the default command if no commands are given to usbconfig.

usr.sbin/usbconfig/usbconfig.8
139

What exactly does it mean to "unconfigure the device"? Prevent the driver from attaching, or restore some kind of default value?

143

Indeed, but it might be easier for the user if we limit examples to one kind of those, in this case to what's there in "usbconfig list" output.

193

The default for other devices is "on", right?

usr.sbin/usbconfig/usbconfig.8
139

"unconfigure the device" is a USB terminologi, which bascially means detach all drivers and reduce power consumption to a minimum, but do not go into power save mode or disappear from USB.

143

No problem.

193

Yes: HUBs are default power_save, all other devices unless the attach driver requests, are power_on .

usr.sbin/usbconfig/usbconfig.8
139

Can be used to prevent devices from charging, if the vendor follows the USB.org standards.

Fix capitalization and .Dd.

Thank you. This looks good!

--HPS

This revision is now accepted and ready to land.Dec 28 2017, 4:04 PM
This revision was automatically updated to reflect the committed changes.