DUMP_USB(1p)

📦
version 0.38 · 2 versions
, in ubuntu jammy

💖 DUMP_USB — like, the whole manual, but make it make sense 💖

okay bestie, pull up a chair because this is dump_usb.pl from the User Contributed Perl Documentation section, and it's honestly giving "quick hack that got promoted." No cap. Let's get into it. 🦋

✨ NAME ✨

dump_usb.pl — the lil script that uses Device::USB to list your USB devices. That's it. That's the whole job. 💅

🎀 VERSION 🎀

Version 0.37. Iconic, vintage, beloved. ✨

🌸 SYNOPSIS 🌸

dump_usb.pl

So the dump_usb.pl program gives you a relatively crude dump of the info that's available from any USB devices installed on your system. Like, she's not polished, but she shows up and she tells you things. 🫶

🦋 DESCRIPTION 🦋

Okay so here's the lore. This module provides a Perl interface to the C library libusb. That library supports a relatively full set of functionality to access a USB device. And on top of all that libusb functionality, Device::USB throws in a few convenience features that are intended to produce a more Perl-ish interface. Because obviously. 💜

Now, the behaviour depends on how you call her:

  • No arguments at all? She lists all installed USB devices on all busses. Just so you know — this is literally a Data::Dumper dump of the structures, so it is not the most user friendly output in the world. Not even close, bestie. 😭 But listen — the program was only ever intended as a quick hack to verify that Device::USB was working. So, vibe check: it's doing exactly what it was born to do.
  • Called with arguments? Then those arguments are expected to be a vendor id and a product id. Pro tip: those arguments can be in hex if you precede them with 0x. She searches for a device that matches that vendor id and product id. If she finds one, the device filename gets printed, along with the vendor and product ids. Periodt. 💅
  • And if the program can open the device? Then she'll also print the manufacture name and product name as reported by the device. She's thorough like that. 👑

🔥 DEPENDENCIES 🔥

This module depends on the Device::USB and Data::Dumper modules, plus the strict and warnings pragmas. And obviously — and I mean obviously — libusb must be available for Device::USB to function at all. No libusb, no party. 💀

👑 AUTHOR 👑

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

Houston Perl Mongers Group — represent. 🌈

🙈 BUGS 🙈

Okay, the receipts:

  • The output format is extremely non-friendly. She said it, not me. 💀
  • The program only returns the first matching USB device. One match, that's all you get, don't ask for seconds.

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. Teamwork, fr fr. 🫶

💜 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. Main character energy, honestly. 👑

Copyright 2006 Houston Perl Mongers.

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

lowkey the whole thing is a Data::Dumper dump and highkey that's the point. it's giving "quick hack that works," and we respect her for it. 💖

and that's the tea, bestie — this was dump_usb.pl, documented under perl v5.34.0 and dated 2022-02-06. go forth and list your USB devices. 🦋💅🌸

📦 where this page comes from