NAME

dump_usb.pl - Use Device::USB to list USB devices.

VERSION

Version 0.02

SYNOPSIS

The "dump_usb.pl" program provides a relatively crude dump of the information available from any USB devices installed on the system.

DESCRIPTION

This module provides a Perl interface to the C library libusb. This library supports a relatively full set of functionality to access a USB device. In addition to the libusb, functioality, Device::USB provides a few convenience features that are intended to produce a more Perl-ish interface.

If called without arguments, the program lists all installed USB devices on all busses. This is just a Data::Dumper dump of the structures, so it is not the most user friendly output in the world. (However, the program was only intended as a quick hack to verify that Device::USB was working.)

If called with arguments, they are expected to be a vendor id and a product id. (These arguments can be in hex if you precede them with "0x".) The program searches for a device that matches that vendor id and product id. If it finds one, the device filename is printed, along with the vendor and product ids.

If the program can open the device, it will also print the manufacture name and product name as reported by the device.

DEPENDENCIES

This module depends on the Device::USB and Data::Dumper modules, as well as the strict and warnings pragmas. Obviously, libusb must be available for Device::USB to function.

AUTHOR

G. Wade Johnson (wade at anomaly dot org) Paul Archer (paul at paularcher dot org)

Houston Perl Mongers Group

BUGS

The output format is extremely non-friendly.

The program only returns the first matching USB device.

Please report any bugs or feature requests to "bug-maze-svg1@rt.cpan.org", or through the web interface at <http://rt.cpan.org/NoAuth/ReportBug.html?Device::USB>. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

ACKNOWLEDGEMENTS

Thanks go to various members of the Houston Perl Mongers group for input on the module. But thanks mostly go to Paul Archer who proposed the project and helped with the development.

COPYRIGHT & LICENSE

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.