PERLDB(1)

NAME
perldb | Perl Debugger

SYNOPSIS
perldb [|o output] perlscript arguments

DESCRIPTION
Perldb is a symbolic debugger for perl scripts. Run your script just as you normally would, only prepend "perldb" to the command. (On systems where #! doesn't work, put any perl switches into the #! line anyway|perldb will pass them off to perl when it runs the script.) Perldb copies your script to a temporary file, instrumenting it in the process and adding a debugging monitor. It then executes the instrumented script for you and stops at the first statement so you can set any breakpoints or actions you desire.

There is only one switch: |o, which tells perldb to put its temporary file in the filename you specify, and to refrain from deleting the file. Use this switch if you intend to rerun the instrumented script, or want to look at it for some reason.

These are the debugging commands: Single step. Subsequent carriage returns will single step. Continue. Turns off single step mode and runs till the next break point. Subsequent carriage returns will continue. Repeat last s or c. List lines in the indicated range. List indicated line. List the whole program. List breakpoints. Toggle trace mode. Trace mode causes lines to be printed out as they are executed. Set breakpoint at indicated line. Delete breakpoint at indicated line. Delete breakpoint at this line. Set an action for indicated line. The command must be a valid perl command, except that a missing trailing ; will be supplied. Quit. Execute command as a perl statement. A missing trailing ; will be supplied if necessary.

ENVIRONMENT
No environment variables are used by perldb.

AUTHOR
Larry Wall <lwall@jpl|devvax.Jpl.Nasa.Gov>

FILES
/tmp/pdb$$    temporary file for instrumented script

SEE ALSO
perl

DIAGNOSTICS

BUGS