aboutsummaryrefslogtreecommitdiff
path: root/usr.sbin/usbconfig/usbconfig.8
Commit message (Collapse)AuthorAgeFilesLines
* usbconfig: add -l option to dump_device_desc for single line outputBjoern A. Zeeb2025-02-241-1/+5
| | | | | | | | | | | | | | | | | Like pciconf -l add a -l to dump_device_desc for usbconfig which will fold most fields into a single line. We do filter out some we think will not be interesting in this case. While mangling with string output in ways not always anticipated when the program was initially written this should help to parse the available devices for programs like fwget(8). While I had this in mind for other bits for a while I got prompted by D48678 to finally do it. Sponsored by: The FreebSD Foundation MFC after: 3 days Reviewed by: bapt (LGTM), ziaee (man) Differential Revision: https://reviews.freebsd.org/D48974
* Remove $FreeBSD$: one-line nroff patternWarner Losh2023-08-161-1/+0
| | | | Remove /^\.\\"\s*\$FreeBSD\$$\n/
* usbconfig.8: Sort flags according to style(9)Mateusz Piotrowski2022-01-291-5/+5
| | | | MFC after: 2 weeks
* usbconfig.8: Improve style and fix examplesMateusz Piotrowski2022-01-291-13/+23
| | | | | | | | | | | | | - Use Ar macros for arguments - Stylize the argument synopsis to the -d flag - Change the width of the list to one of the actual tags in the list - Stylize "ugen" and "/dev/ugen" with Cm as those are constant strings, which are usually treated as command modifiers. - Break long lines to reduce the number of warnings from linters - Fix examples; the -d flag is now required when specifying the unit and the address with the "dot notation". MFC after: 2 weeks
* usbconfig: implement a -v optionJoerg Wunsch2021-12-201-3/+13
| | | | | | | | | | | | | | | Implement a -v option to usbconfig(8), as a shortcut for the most frequently needed commands dump_device_desc, dump_curr_config_desc, and show_ifdrv. While here, implement a real -h option that has been promised by the man page. Use <sysexits.h> to declare the utility return codes. Reviewed by: hselasky Differential Revision: https://reviews.freebsd.org/D33586 MFC after: 2 weeks
* usbconfig: documentation fixes, mainly for -i optionJoerg Wunsch2021-12-201-3/+11
| | | | | | | | | | | | | * in usage(), clearly mark -i interface as optional * both, -u busnum and -a devaddr are optional as well * various minor man page fixes * clearly mark those two commands that actually use -i ifaceidx * remove unused bitfield tag got_iface * fix indentation level according to review comment Differential Revision: https://reviews.freebsd.org/D33579/ Reviewed by: hselasky MFC after: 2 weeks
* usbconfig: use getopt(3) for option handlingJoerg Wunsch2021-12-201-1/+3
| | | | | | | | | | | | | This makes option handling consistent with other utilities as well as Posix rules. By that, it's no longer important whether option name and its argument are separated by a space or not, so -d5.3 works the same as -d 5.3. Also, recognize either /dev/ugen or ugen as prefix to the -d argument. Note that this removes the undocumented feature that allowed to specify multiple -d n.m options interleaved with commands referring to that particular device in a single run.
* Implement dump_stats command for usbconfig(8).Hans Petter Selasky2019-12-271-2/+4
| | | | | | | | | | This command is useful when debugging USB device issues. MFC after: 1 week Sponsored by: Mellanox Technologies Notes: svn path=/head/; revision=356137
* Implement detach_kernel_driver command in usbconfig(8).Hans Petter Selasky2019-08-161-2/+7
| | | | | | | | | Submitted by: Kevin Zheng <kevinz5000@gmail.com> PR: 239916 MFC after: 1 week Notes: svn path=/head/; revision=351146
* Clean up the EXAMPLES section of usbconfig(8). This removes parts thatEdward Tomasz Napierala2018-04-291-21/+9
| | | | | | | | | | | | become redundant after documenting all the subcommands, and switches to the new syntax, without the '-d'. Reviewed by: hselasky@ MFC after: 2 weeks Sponsored by: The FreeBSD Foundation Notes: svn path=/head/; revision=333089
* Make it possible to pass the ugenX.Y to usbconfig(8) without using "-d",Edward Tomasz Napierala2018-04-171-2/+2
| | | | | | | | | | | eg "usbconfig ugen1.2 dump_all_desc". Reviewed by: hselasky@ MFC after: 2 weeks Sponsored by: The FreeBSD Foundation Notes: svn path=/head/; revision=332659
* Add "usbconfig dump_all_desc", a subcommand to dump all device and configEdward Tomasz Napierala2018-03-131-0/+2
| | | | | | | | | | | descriptors. Reviewed by: hselasky@ MFC after: 2 weeks Sponsored by: The FreeBSD Foundation Notes: svn path=/head/; revision=330875
* Fix warnings from "mandoc -Tlint -Wwarning".Edward Tomasz Napierala2018-01-031-2/+0
| | | | | | | | | Reported by: Yuri Pankov <yuripv at gmx.com> MFC after: 2 weeks Sponsored by: The FreeBSD Foundation Notes: svn path=/head/; revision=327522
* Improve usbconfig(8) manual page by adding descriptions for subcommands.Edward Tomasz Napierala2017-12-301-21/+100
| | | | | | | | | | Reviewed by: hselasky MFC after: 2 weeks Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D13445 Notes: svn path=/head/; revision=327382
* Add a man page for usb_quirk module, plus references in other man pages,Nick Hibma2010-11-101-1/+5
| | | | | | | | | | | | | | | and updated comments in the usb_quirk.h header file. The main purpose of this is to expose the quirks for ejecting 3G modules. usb_modeswitch in Linux does a great job of collecting information on these, and with the quirks module people can try out the modeswitch config file entries on FreeBSD, hence the SCSI strings in the man page. MFC after: 2 weeks Notes: svn path=/head/; revision=215104
* Sync to p4Andrew Thompson2010-01-071-2/+37
| | | | | | | | | - Add new quirks commands and the '-d' option optionally to specify the ugen device. Submitted by: Hans Petter Selasky Notes: svn path=/head/; revision=201705
* Expand DESCRIPTION and a basic EXAMPLES section.Christian Brueffer2009-11-011-1/+9
| | | | | | | | | PR: 139605 Submitted by: Warren Block <wblock@wonkity.com> MFC after: 1 week Notes: svn path=/head/; revision=198750
* Fix xref name.Andrew Thompson2009-05-271-1/+1
| | | | Notes: svn path=/head/; revision=192924
* Bring in USB4BSD, Hans Petter Selasky rework of the USB stackAlfred Perlstein2008-11-041-0/+53
that includes significant features and SMP safety. This commit includes a more or less complete rewrite of the *BSD USB stack, including Host Controller and Device Controller drivers and updating all existing USB drivers to use the new USB API: 1) A brief feature list: - A new and mutex enabled USB API. - Many USB drivers are now running Giant free. - Linux USB kernel compatibility layer. - New UGEN backend and libusb library, finally solves the "driver unloading" problem. The new BSD licensed libusb20 library is fully compatible with libusb-0.1.12 from sourceforge. - New "usbconfig" utility, for easy configuration of USB. - Full support for Split transactions, which means you can use your full speed USB audio device on a high speed USB HUB. - Full support for HS ISOC transactions, which makes writing drivers for various HS webcams possible, for example. - Full support for USB on embedded platforms, mostly cache flushing and buffer invalidating stuff. - Safer parsing of USB descriptors. - Autodetect of annoying USB install disks. - Support for USB device side mode, also called USB gadget mode, using the same API like the USB host side. In other words the new USB stack is symmetric with regard to host and device side. - Support for USB transfers like I/O vectors, means more throughput and less interrupts. - ... see the FreeBSD quarterly status reports under "USB project" 2) To enable the driver in the default kernel build: 2.a) Remove all existing USB device options from your kernel config file. 2.b) Add the following USB device options to your kernel configuration file: # USB core support device usb2_core # USB controller support device usb2_controller device usb2_controller_ehci device usb2_controller_ohci device usb2_controller_uhci # USB mass storage support device usb2_storage device usb2_storage_mass # USB ethernet support, requires miibus device usb2_ethernet device usb2_ethernet_aue device usb2_ethernet_axe device usb2_ethernet_cdce device usb2_ethernet_cue device usb2_ethernet_kue device usb2_ethernet_rue device usb2_ethernet_dav # USB wireless LAN support device usb2_wlan device usb2_wlan_rum device usb2_wlan_ral device usb2_wlan_zyd # USB serial device support device usb2_serial device usb2_serial_ark device usb2_serial_bsa device usb2_serial_bser device usb2_serial_chcom device usb2_serial_cycom device usb2_serial_foma device usb2_serial_ftdi device usb2_serial_gensa device usb2_serial_ipaq device usb2_serial_lpt device usb2_serial_mct device usb2_serial_modem device usb2_serial_moscom device usb2_serial_plcom device usb2_serial_visor device usb2_serial_vscom # USB bluetooth support device usb2_bluetooth device usb2_bluetooth_ng # USB input device support device usb2_input device usb2_input_hid device usb2_input_kbd device usb2_input_ms # USB sound and MIDI device support device usb2_sound 2) To enable the driver at runtime: 2.a) Unload all existing USB modules. If USB is compiled into the kernel then you might have to build a new kernel. 2.b) Load the "usb2_xxx.ko" modules under /boot/kernel having the same base name like the kernel device option. Submitted by: Hans Petter Selasky hselasky at c2i dot net Reviewed by: imp, alfred Notes: svn path=/head/; revision=184610
generated by cgit v1.3 (git 2.53.0) at 2026-05-08 20:50:01 +0000