The perlbug Program

As you develop and debug your own code, it’s possible that you’ll run into a bug in Perl itself. If you do, the best way to report it is with the perlbug program. perlbug is a Perl program designed to automate the process of reporting bugs in the Perl standard distribution and the standard modules. It works interactively, prompting you for the information needed and generating an email message addressed to . (If the bug you found is in one of the nonstandard Perl ports, see the documentation for that port to find out how to report bugs.) When you run perlbug, it prompts you to include all relevant information, making it easier for the Perl developers to reproduce and track down the bug. If you come up with a patch to resolve the problem, include that too.

Don’t use perlbug to get help debugging your code (for that, see the list of newsgroups and other resources in Chapter 1). But if you believe you’ve found a bug in Perl itself, perlbug is the way to report it.

To run perlbug, simply enter the command with any options you want to include. For example:

% perlbug -t

The possible options are:

-a address

Email address to send report to. Default is .

-b body

Body of report. If not included on the command line or in a file, you are given a chance to edit it.


Don’t send a copy to your Perl administrator.

-c address

Email address where copy should be sent. Default is your Perl administrator.


Data mode. (The default if you redirect or pipe ...

Get Perl in a Nutshell, 2nd Edition now with O’Reilly online learning.

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.