autodi...system(3perl)

💖 autodi...system — bestie edition

okay so real talk: this is the manual page for autodi...system in section 3perl, straight out of the Perl Programmers Reference Guide, and we are gonna get you fluent, no cap. 🫶

---

✨ NAME ✨

autodie::exception::system — the class that throws the exceptions when autodie is watching your system() calls. it's giving "your subprocess called, and it has feelings" 💅

---

🌸 SYNOPSIS 🌸

like, this is the whole vibe:

eval {
    use autodie qw(system);

    system($cmd, @args);

};

if (my $E = $@) {
    say "Ooops!  ",$E->caller," had problems: $@";
}

so you wrap it in an eval, you turn on autodie for system, and when your command goes sideways you get an object back in $@ instead of just quietly vibing with a bad exit code. icon behavior tbh. ✨

---

🦋 DESCRIPTION 🦋

okay so this is an autodie::exception class — specifically the one for failures coming out of the system command. 🎀

and now the part where i have to be honest with you bestie: Presently there is no way to interrogate an autodie::exception::system object for the command, exit status, and other information you'd expect such an object to hold. like, the info you'd expect it to hold? it's just not interrogatable right now. 😭 the interface will be expanded to accommodate this in the future, so it's not forever, it's just— for now. okay? okay. 🫶

🧚 stringify

when you stringify an autodie::exception::system object (you know, drop it into a string, print it, let it interpolate) — it currently uses the message generated by IPC::System::Simple. that's where the words come from. that's the whole thing. 🌸

---

👑 LICENSE 👑

Copyright (C)2008 Paul Fenwick

This is free software. You may modify and/or redistribute this code under the same terms as Perl 5.10 itself, or, at your option, any later version of Perl 5.

^^^ free software, bestie. modify it, redistribute it, it's yours under the same terms as Perl 5.10 or any later version of Perl 5, your choice. slay. 💜

---

💫 AUTHOR 💫

Paul Fenwick <pjf@perltraining.com.au> — thank you for your service, king 👑

---

everything in this page is exactly as it was written in the original — i just gave it a wardrobe change, fr fr.

this has been perl v5.44.0, dated 2026-10-17 💖 and yes that's the same autodi...system(3perl) you came in with. periodt. 🎀✨