summaryrefslogtreecommitdiff
path: root/static/freebsd/man9/psignal.9 3.html
diff options
context:
space:
mode:
Diffstat (limited to 'static/freebsd/man9/psignal.9 3.html')
-rw-r--r--static/freebsd/man9/psignal.9 3.html110
1 files changed, 0 insertions, 110 deletions
diff --git a/static/freebsd/man9/psignal.9 3.html b/static/freebsd/man9/psignal.9 3.html
deleted file mode 100644
index 7f9f81ab..00000000
--- a/static/freebsd/man9/psignal.9 3.html
+++ /dev/null
@@ -1,110 +0,0 @@
-<table class="head">
- <tr>
- <td class="head-ltitle">PSIGNAL(9)</td>
- <td class="head-vol">Kernel Developer's Manual</td>
- <td class="head-rtitle">PSIGNAL(9)</td>
- </tr>
-</table>
-<div class="manual-text">
-<section class="Sh">
-<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
-<p class="Pp"><code class="Nm">psignal</code>,
- <code class="Nm">kern_psignal</code>, <code class="Nm">pgsignal</code>,
- <code class="Nm">tdsignal</code> &#x2014; <span class="Nd">post signal to a
- thread, process, or process group</span></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
-<p class="Pp"><code class="In">#include
- &lt;<a class="In">sys/types.h</a>&gt;</code>
- <br/>
- <code class="In">#include &lt;<a class="In">sys/signalvar.h</a>&gt;</code></p>
-<p class="Pp"><var class="Ft">void</var>
- <br/>
- <code class="Fn">kern_psignal</code>(<var class="Fa" style="white-space: nowrap;">struct
- proc *p</var>, <var class="Fa" style="white-space: nowrap;">int
- signum</var>);</p>
-<p class="Pp"><var class="Ft">void</var>
- <br/>
- <code class="Fn">pgsignal</code>(<var class="Fa" style="white-space: nowrap;">struct
- pgrp *pgrp</var>, <var class="Fa" style="white-space: nowrap;">int
- signum</var>, <var class="Fa" style="white-space: nowrap;">int
- checkctty</var>);</p>
-<p class="Pp"><var class="Ft">void</var>
- <br/>
- <code class="Fn">tdsignal</code>(<var class="Fa" style="white-space: nowrap;">struct
- thread *td</var>, <var class="Fa" style="white-space: nowrap;">int
- signum</var>);</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
-<p class="Pp">These functions post a signal to a thread or one or more
- processes. The argument <var class="Fa">signum</var> common to all three
- functions should be in the range [1-<code class="Dv">NSIG</code>].</p>
-<p class="Pp" id="kern_psignal">The
- <a class="permalink" href="#kern_psignal"><code class="Fn">kern_psignal</code></a>()
- function posts signal number <var class="Fa">signum</var> to the process
- represented by the process structure <var class="Fa">p</var>. The
- <code class="Fn">kern_psignal</code>() function used to be called
- <a class="permalink" href="#psignal"><code class="Fn" id="psignal">psignal</code></a>()
- but was renamed in order to eliminate a name collision with the libc
- function of that name and facilitate code reuse. With a few exceptions noted
- below, the target process signal disposition is updated and is marked as
- runnable, so further handling of the signal is done in the context of the
- target process after a context switch. Note that
- <code class="Fn">kern_psignal</code>() does not by itself cause a context
- switch to happen.</p>
-<p class="Pp">The target process is not marked as runnable in the following
- cases:</p>
-<ul class="Bl-bullet Bd-indent">
- <li>The target process is sleeping uninterruptibly. The signal will be noticed
- when the process returns from the system call or trap.</li>
- <li>The target process is currently ignoring the signal.</li>
- <li>If a stop signal is sent to a sleeping process that takes the default
- action (see <a class="Xr">sigaction(2)</a>), the process is stopped
- without awakening it.</li>
- <li id="SIGCONT"><a class="permalink" href="#SIGCONT"><code class="Dv">SIGCONT</code></a>
- restarts a stopped process (or puts them back to sleep) regardless of the
- signal action (e.g., blocked or ignored).</li>
-</ul>
-<p class="Pp" id="kern_psignal~2">If the target process is being traced
- <a class="permalink" href="#kern_psignal~2"><code class="Fn">kern_psignal</code></a>()
- behaves as if the target process were taking the default action for
- <var class="Fa">signum</var>. This allows the tracing process to be notified
- of the signal.</p>
-<p class="Pp" id="pgsignal">The
- <a class="permalink" href="#pgsignal"><code class="Fn">pgsignal</code></a>()
- function posts signal number <var class="Fa">signum</var> to each member of
- the process group described by <var class="Fa">pgrp</var>. If
- <var class="Fa">checkctty</var> is non-zero, the signal will be posted only
- to processes that have a controlling terminal.
- <code class="Fn">pgsignal</code>() is implemented by walking along the
- process list headed by the field <code class="Li">pg_members</code> of the
- process group structure pointed at by <var class="Fa">pgrp</var> and calling
- <code class="Fn">kern_psignal</code>() as appropriate. If
- <var class="Fa">pgrp</var> is <code class="Dv">NULL</code> no action is
- taken.</p>
-<p class="Pp" id="tdsignal">The
- <a class="permalink" href="#tdsignal"><code class="Fn">tdsignal</code></a>()
- function posts signal number <var class="Fa">signum</var> to the thread
- represented by the thread structure <var class="Fa">td</var>.</p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
- ALSO</a></h1>
-<p class="Pp"><a class="Xr">sigaction(2)</a>, <a class="Xr">signal(9)</a>,
- <a class="Xr">tsleep(9)</a></p>
-</section>
-<section class="Sh">
-<h1 class="Sh" id="HISTORY"><a class="permalink" href="#HISTORY">HISTORY</a></h1>
-<p class="Pp">The <code class="Fn">psignal</code>() function was renamed to
- <code class="Fn">kern_psignal</code>() in <span class="Ux">FreeBSD
- 9.0</span>.</p>
-</section>
-</div>
-<table class="foot">
- <tr>
- <td class="foot-date">July 14, 2023</td>
- <td class="foot-os">FreeBSD 15.0</td>
- </tr>
-</table>