This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perl 1.0 patch 9: 3 portability problems
[perl5.git] / perldb.man
CommitLineData
a559c259
LW
1.rn '' }`
2''' $Header: perldb.man,v 1.0.1.1 88/01/28 10:28:19 root Exp $
3'''
4''' $Log: perldb.man,v $
5''' Revision 1.0.1.1 88/01/28 10:28:19 root
6''' patch8: created this file.
7'''
8'''
9.de Sh
10.br
11.ne 5
12.PP
13\fB\\$1\fR
14.PP
15..
16.de Sp
17.if t .sp .5v
18.if n .sp
19..
20.de Ip
21.br
22.ie \\n.$>=3 .ne \\$3
23.el .ne 3
24.IP "\\$1" \\$2
25..
26'''
27''' Set up \*(-- to give an unbreakable dash;
28''' string Tr holds user defined translation string.
29''' Bell System Logo is used as a dummy character.
30'''
31.tr \(bs-|\(bv\*(Tr
32.ie n \{\
33.ds -- \(bs-
34.if (\n(.H=4u)&(1m=24u) .ds -- \(bs\h'-12u'\(bs\h'-12u'-\" diablo 10 pitch
35.if (\n(.H=4u)&(1m=20u) .ds -- \(bs\h'-12u'\(bs\h'-8u'-\" diablo 12 pitch
36.ds L" ""
37.ds R" ""
38.ds L' '
39.ds R' '
40'br\}
41.el\{\
42.ds -- \(em\|
43.tr \*(Tr
44.ds L" ``
45.ds R" ''
46.ds L' `
47.ds R' '
48'br\}
49.TH PERLDB 1 LOCAL
50.SH NAME
51perldb - Perl Debugger
52.SH SYNOPSIS
53.B perldb [-o output] perlscript arguments
54.SH DESCRIPTION
55.I Perldb
56is a symbolic debugger for
57.I perl
58scripts.
59Run your script just as you normally would, only prepend \*(L"perldb\*(R" to
60the command.
61(On systems where #! doesn't work, put any perl switches into the #! line
62anyway\*(--perldb will pass them off to perl when it runs the script.)
63Perldb copies your script to a temporary file, instrumenting it in the process
64and adding a debugging monitor.
65It then executes the instrumented script for
66you and stops at the first statement so you can set any breakpoints or actions
67you desire.
68.PP
69There is only one switch: \-o, which tells perldb to put its temporary file
70in the filename you specify, and to refrain from deleting the file.
71Use this switch if you intend to rerun the instrumented script, or want to
72look at it for some reason.
73.PP
74These are the debugging commands:
75.Ip s 8
76Single step.
77Subsequent carriage returns will single step.
78.Ip c 8
79Continue.
80Turns off single step mode and runs till the next break point.
81Subsequent carriage returns will continue.
82.Ip <CR> 8
83Repeat last s or c.
84.Ip "l min-max" 8
85List lines in the indicated range.
86.Ip "l line" 8
87List indicated line.
88.Ip l 8
89List the whole program.
90.Ip L 8
91List breakpoints.
92.Ip t 8
93Toggle trace mode.
94.Ip "b line" 8
95Set breakpoint at indicated line.
96.Ip "d line" 8
97Delete breakpoint at indicated line.
98.Ip d 8
99Delete breakpoint at this line.
100.Ip "a line command" 8
101Set an action for indicated line.
102The command must be a valid perl command, except that a missing trailing ;
103will be supplied.
104.Ip q 8
105Quit.
106.Ip command 8
107Execute command as a perl statement.
108A missing trailing ; will be supplied if necessary.
109.SH ENVIRONMENT
110No environment variables are used by perldb.
111.SH AUTHOR
112Larry Wall <lwall@jpl-devvax.Jpl.Nasa.Gov>
113.SH FILES
114/tmp/pdb$$ temporary file for instrumented script
115.SH SEE ALSO
116perl
117.SH DIAGNOSTICS
118.SH BUGS
119.rn }` ''