~ubuntu-branches/ubuntu/intrepid/perl-doc-html/intrepid

      <h2>Links:</h2>

      <ul>

        <li><a href="http://search.cpan.org">CPAN</a></li>

        <li><a href="http://www.perl.com">Perl.com</a></li>

        <li><a href="http://www.pm.org">Perl Mongers</a></li>

        <li><a href="http://www.perlmonks.org">Perl Monks</a></li>

        <li><a href="http://planet.perl.org">Planet Perl</a></li>

      <ul>

        <li>Site maintained by<br><a href="http://perl.jonallen.info">Jon Allen</a>

            (<a href="http://perl.jonallen.info">JJ</a>)</li>

        <li class="spaced">See the <a href="http://perl.jonallen.info/projects/perldoc">project page</a> for

        more details</li>

      </ul>

    <div id="centerContent">

      <div id="contentHeader">

        <div id="contentHeaderLeft"><a href="#" onClick="showLeft()">Show navigation</a></div>

        <div id="contentHeaderRight"><a href="#" onClick="showRight()">Show toolbar</a></div>

      </div>

      <div id="breadCrumbs"><a href="index.html">Home</a> &gt; <a href="index-pragmas.html">Pragmas</a> &gt; sigtrap</div>

      <div id="contentBody"><div class="title_container"><div class="page_title">sigtrap</div></div><ul><li><a href="#NAME">NAME</a><li><a href="#SYNOPSIS">SYNOPSIS</a><li><a href="#DESCRIPTION">DESCRIPTION</a><li><a href="#OPTIONS">OPTIONS</a><ul><li><a href="#SIGNAL-HANDLERS">SIGNAL HANDLERS</a><li><a href="#SIGNAL-LISTS">SIGNAL LISTS</a><li><a href="#OTHER">OTHER</a></ul><li><a href="#EXAMPLES">EXAMPLES</a></ul><a name="NAME"></a><h1>NAME</h1>

<p>sigtrap - Perl pragma to enable simple signal handling</p>

<a name="SYNOPSIS"></a><h1>SYNOPSIS</h1>

                    <span class="q">stack-trace any error-signals)</span><span class="sc">;</span>

                    <span class="q">stack-trace error-signals)</span><span class="sc">;</span></pre>

<a name="DESCRIPTION"></a><h1>DESCRIPTION</h1>

<p>The <b>sigtrap</b> pragma is a simple interface to installing signal

</li>

<li><a name="*die*"></a><b><b>die</b></b>

<p>The handler used for subsequently installed signals calls <code class="inline"><a class="l_k" href="functions/die.html">die</a></code>

) with a message indicating which signal was caught.</p>

</li>

<li><a name="*handler*-_your-handler_"></a><b><b>handler</b> <i>your-handler</i></b>

<p><i>your-handler</i> will be used as the handler for subsequently installed

signals.  <i>your-handler</i> can be any value which is valid as an

assignment to an element of <code class="inline"><span class="i">%SIG</span></code>

</li>

</ul>

<a name="SIGNAL-LISTS"></a><h2>SIGNAL LISTS</h2>

</ul>

<a name="EXAMPLES"></a><h1>EXAMPLES</h1>

<p>Provide a stack trace for the old-interface-signals:</p>

<p>Ditto:</p>

<p>Provide a stack trace on the 4 listed signals only:</p>

<p>Die on INT or QUIT:</p>

<p>Die on HUP, INT, PIPE or TERM:</p>

<p>Die on HUP, INT, PIPE or TERM, except don't change the behavior for

signals which are already trapped or ignored:</p>

<p>Die on receipt one of an of the <b>normal-signals</b> which is currently

<b>untrapped</b>, provide a stack trace on receipt of <b>any</b> of the

<b>error-signals</b>:</p>

                    <span class="q">stack-trace any error-signals)</span><span class="sc">;</span></pre>

<p>Install my_handler() as the handler for the <b>normal-signals</b>:</p>

<p>Install my_handler() as the handler for the normal-signals, provide a

Perl stack trace on receipt of one of the error-signals:</p>

                    <span class="q">stack-trace error-signals)</span><span class="sc">;</span></pre>

</div>

      <div id="contentFooter"><a href="http://www.perl.org"><img src="perlpowered.png" border=0></a></div>

          <!--<select name="r"><option value="1" selected>Go to top result<option value="0">Show results list</select>-->

        </form>

      </p>

      <h2>Labels:</h2>

      <p>

        <a href="#" onClick="addLabel('sigtrap','sigtrap.html')">Add this page</a>