ch06_02.htm

by Randal L. Schwartz and Tom Phoenix ISBN 0-596-00132-0 Third Edition, published July 2001. (See

<div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>b</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
b compile <em class="emphasis">subname</em>
</pre><p>Stops after the subroutine has been compiled.</p></div>

<a name="INDEX-1143" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>c</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
c [<em class="emphasis">line</em> | <em class="emphasis">sub</em>]
</pre><p><a name="INDEX-1143" />Continues, optionally inserting a
one-time-only breakpoint at the specified line or subroutine.
</p></div>

<a name="INDEX-1144" /><a name="INDEX-1145" /><a name="INDEX-1146" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>command</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
<em class="emphasis">command</em>
</pre><p>Executes <em class="replaceable">command</em> as a Perl statement. A
semicolon is not needed at the end.<a name="INDEX-1144" /><a name="INDEX-1145" /><a name="INDEX-1146" /> 
</p></div>

<a name="INDEX-1147" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>D</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
D
</pre><p><a name="INDEX-1147" />Deletes all installed breakpoints
</p></div>

<a name="INDEX-1148" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>d</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
d [<em class="emphasis">line</em>]
</pre><p><a name="INDEX-1148" />Deletes the breakpoint at the
specified <em class="replaceable"><tt>line</tt></em>. If
<em class="replaceable"><tt>line</tt></em> is omitted, deletes the breakpoint on
the line that is about to be executed..
</p></div>

<a name="INDEX-1149" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>f</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
f <em class="emphasis">filename</em>
</pre><p><a name="INDEX-1149" />Switches to viewing a different file.
</p></div>

<a name="INDEX-1150" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>H</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
H [<em class="emphasis">-number</em>]
</pre><p><a name="INDEX-1150" />Displays last
<em class="replaceable"><tt>number</tt></em> commands. If
<em class="replaceable"><tt>number</tt></em> is omitted, it lists all previous
commands. Only commands longer than one character are listed.
</p></div>

<a name="INDEX-1151" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>h</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
h [<em class="emphasis">command</em>]
</pre><p><a name="INDEX-1151" />Prints a help message, listing the
available debugger commands.
</p><p>If you supply another debugger command as an argument to the
<tt class="literal">h</tt> command, it prints out the description for just
that command. The command <tt class="literal">h h</tt> produces a more
compact help listing designed to fit on one screen.
</p></div>

<a name="INDEX-1152" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>L</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
L
</pre><p><a name="INDEX-1152" />Lists all breakpoints and actions for
the current file.
</p></div>

<a name="INDEX-1153" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>l</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
l [<em class="replaceable">linespec</em>]
</pre><p><a name="INDEX-1153" />If
<em class="replaceable"><tt>linespec</tt></em> is omitted, lists the next few
lines. Otherwise, lists the lines specified by
<em class="replaceable"><tt>linespec</tt></em>, which can be one of the
following:
</p><dl>
<dt><i><em class="replaceable"><tt>line</tt></em></i></dt>
<dd>
Lists the single line <em class="replaceable"><tt>line</tt></em></p>
</dd>


<dt><i><em class="replaceable"><tt>min</em><em class="emphasis">+</em><em class="replaceable">incr</tt></em></i></dt>
<dd>
Lists <em class="replaceable"><tt>incr</tt></em><tt class="literal">+1</tt> lines
starting at <em class="replaceable"><tt>min</tt></em></p>
</dd>


<dt><i><em class="replaceable"><tt>min</em><em class="emphasis">-</em><em class="replaceable">max</tt></em></i></dt>
<dd>
Lists lines <em class="replaceable"><tt>min</tt></em> through
<em class="replaceable"><tt>max</tt></em></p>
</dd>


<dt><i><em class="replaceable"><tt>subname</tt></em></i></dt>
<dd>
Lists the first few lines from subroutine
<em class="replaceable"><tt>subname</tt></em>.
</p>
</dd>

</dl><p>Also see the <tt class="literal">w</tt> and <tt class="literal">-</tt> commands.</p></div>

<a name="INDEX-1154" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>m</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
m <em class="emphasis">expr</em>
</pre><p><a name="INDEX-1154" /><tt class="literal">eval</tt>s the
expression in array context and prints methods callable on the first
element of the result.
</p></div>

<div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>m</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
m <em class="emphasis">class</em>
</pre><p>Prints methods callable via the given class.</p></div>

<a name="INDEX-1155" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>n</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
n
</pre><p><a name="INDEX-1155" />Next. Passes over subroutine calls and
executes the next statement at this level.
</p></div>

<a name="INDEX-1156" /><div class="refentry"><table width="515" border="0" cellpadding="5"><tr><td align="left"><font size="+1"><b>O</b</font></td><td align="right"><i></i></td></tr></table><hr width="515" size="3" noshade="true" align="left" color="black" /><pre>
O [<em class="emphasis">opt</em>[="<em class="emphasis">val</em>"]] [<em class="emphasis">opt</em>'val'] [<em class="emphasis">opt</em>?]
</pre><p><a name="INDEX-1156" />Sets or queries option values. If
omitted, <em class="replaceable"><tt>val</tt></em> defaults to
<tt class="literal">1</tt>. <em class="replaceable"><tt>opt?</tt></em> displays the
value of option <em class="replaceable"><tt>opt</tt></em>.
<em class="replaceable"><tt>opt</tt></em> can be abbreviated to the shortest
unique string, and multiple options can be specified. The possible
options are:
</p><dl>
<dt><b><tt class="literal">AutoTrace</tt></b></dt>
<dd>
Affects printing of messages at every possible breaking point.</p>
</dd>


<dt><b><tt class="literal">frame</tt></b></dt>
<dd>
Enables printing of messages on entry and exit from subroutines.</p>
</dd>


<dt><b><tt class="literal">inhibit_exit</tt></b></dt>
<dd>
Enables stepping off the end of the script.</p>
</dd>


<dt><b><tt class="literal">maxTraceLen</tt></b></dt>
<dd>
Gives the maximum length of evals/args listed in the stack trace.</p>
</dd>


<dt><b><tt class="literal">ornaments</tt></b></dt>
<dd>
Affects the appearance of the command line on the screen.</p>
</dd>


<dt><b><tt class="literal">pager</tt></b></dt>
<dd>
Specifies the program to use for output of pager-piped commands
(those beginning with a <tt class="literal">|</tt> character). Default
value is <tt class="literal">$ENV{PAGER}</tt>.
</p>
</dd>


<dt><b><tt class="literal">PrintRet</tt></b></dt>
<dd>
Enables printing of return value after <tt class="literal">r</tt> command.</p>
</dd>


<dt><b><tt class="literal">recallCommand</tt>, <tt class="literal">ShellBang</tt></b></dt>
<dd>
Specifies the characters used to recall previous commands or spawn a
shell. By default, these are both set to <tt class="literal">!</tt>.
</p>
</dd>

</dl><p>The following options affect what happens with the
<tt class="literal">V</tt>, <tt class="literal">X</tt>, and <tt class="literal">x</tt>
commands:
</p><dl>
<dt><b><tt class="literal">arrayDepth</tt>, <tt class="literal">hashDepth</tt></b></dt>
<dd>