Sophie

Sophie

distrib > Fedora > 14 > x86_64 > media > updates > by-pkgid > 8e87fca2f49595adc16d9aa519a6edad > files > 431

systemtap-1.6-1.fc14.x86_64.rpm

<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>probe::signal.send.return</title><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="index.html" title="SystemTap Tapset Reference Manual"><link rel="up" href="signal.stp.html" title="Chapter&#160;17.&#160;Signal Tapset"><link rel="prev" href="API-signal-send.html" title="probe::signal.send"><link rel="next" href="API-signal-checkperm.html" title="probe::signal.checkperm"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>probe::signal.send.return</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-signal-send.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;17.&#160;Signal Tapset</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-signal-checkperm.html">Next</a></td></tr></table><hr></div><div class="refentry" title="probe::signal.send.return"><a name="API-signal-send-return"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>probe::signal.send.return &#8212; 
     Signal being sent to a process completed
 </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><pre class="synopsis">signal.send.return </pre></div><div class="refsect1" title="Values"><a name="id582812"></a><h2>Values</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>retstr</code></em></span></dt><dd><p>
     The return value to either __group_send_sig_info,
     specific_send_sig_info,
     or send_sigqueue
    </p></dd><dt><span class="term"><em class="parameter"><code>send2queue</code></em></span></dt><dd><p>
     Indicates whether the sent signal was sent to an
     existing sigqueue
    </p></dd><dt><span class="term"><em class="parameter"><code>name</code></em></span></dt><dd><p>
     The name of the function used to send out the signal
    </p></dd><dt><span class="term"><em class="parameter"><code>shared</code></em></span></dt><dd><p>
     Indicates whether the sent signal is shared by the thread group.
    </p></dd></dl></div></div><div class="refsect1" title="Context"><a name="id582891"></a><h2>Context</h2><p>
   The signal's sender. (correct?)
</p></div><div class="refsect1" title="Description"><a name="id582901"></a><h2>Description</h2><p>
   Possible __group_send_sig_info and
   specific_send_sig_info return values are as follows;
   </p><p>

   0 -- The signal is sucessfully sent to a process,
</p></div><div class="refsect1" title="which means that"><a name="id582914"></a><h2>which means that</h2><p>
   (1) the signal was ignored by the receiving process,
   (2) this is a non-RT signal and the system already has one queued, and
   (3) the signal was successfully added to the sigqueue of the receiving process.
   </p><p>

   -EAGAIN -- The sigqueue of the receiving process is
   overflowing, the signal was RT, and the signal was sent by a user using something other
   than <code class="function">kill</code>.
   </p><p>

   Possible send_group_sigqueue and
   send_sigqueue return values are as follows;
   </p><p>

   0 -- The signal was either sucessfully added into the
   sigqueue of the receiving process, or a SI_TIMER entry is already
   queued (in which case, the overrun count will be simply incremented).
   </p><p>

   1 -- The signal was ignored by the receiving process.
   </p><p>

   -1 -- (send_sigqueue only) The task was marked
   exiting, allowing * posix_timer_event to redirect it to the group
   leader.
</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-signal-send.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="signal.stp.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-signal-checkperm.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>probe::signal.send</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span>probe::signal.checkperm</span></td></tr></table></div></body></html>