Page MenuHomeFreeBSD

Improve usbconfig(8) manual page
ClosedPublic

Authored by trasz on Dec 11 2017, 1:18 PM.
Tags
None
Referenced Files
F110439652: D13445.diff
Tue, Feb 18, 12:10 PM
Unknown Object (File)
Tue, Feb 4, 4:14 PM
Unknown Object (File)
Jan 6 2025, 7:38 PM
Unknown Object (File)
Dec 24 2024, 7:22 PM
Unknown Object (File)
Nov 29 2024, 9:36 PM
Unknown Object (File)
Nov 1 2024, 11:58 PM
Unknown Object (File)
Oct 21 2024, 8:20 PM
Unknown Object (File)
Oct 21 2024, 8:19 PM
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 13478
Build 13704: arc lint + arc unit

Event Timeline

Check my comments and update. Thanks!

usr.sbin/usbconfig/usbconfig.8
68

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

75

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

122

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

129

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

140

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

usr.sbin/usbconfig/usbconfig.8
68

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

122

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

140

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.

usr.sbin/usbconfig/usbconfig.8
68

"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.

122

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

140

No problem.

usr.sbin/usbconfig/usbconfig.8
68

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.