ibm-information-center/dist/eclipse/plugins/i5OS.ic.apis_5.4.0.1/users_94.htm

68 lines
3.2 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Copyright" content="Copyright (c) 2006 by IBM Corporation">
<title>Signals APIs</title>
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<!-- Begin Header Records ========================================== -->
<!-- NETMG2 SCRIPT A converted by B2H R4.1 (346) (CMS) by HOLTJM at -->
<!-- RCHVMW2 on 29 Jan 1999 at 10:01:37 -->
<!--File Edited November 2001 -->
<!-- 031112 JETAYLOR replaced API and/or Exit listings with -->
<!-- pagegenerator output from javascript array -->
<!--End Header Records -->
<link rel="stylesheet" type="text/css" href="../rzahg/ic.css">
</head>
<body>
<!-- Java sync-link -->
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
</script>
<h2>Signals APIs</h2>
<p>Signal APIs can be used to manipulate signals in a threaded process. Signals
can be sent to individual threads, the signal mask of a thread can be changed.
When a signal is sent to a thread, the actions associated with the signal (such
as stopping, continuing or terminating) <strong>never</strong> affect only the
thread, all signal actions are defined to affect the process. When a signal
handler is called, it is called in the thread that the signal was delivered
to.</p>
<p>Using signals correctly in a multithreaded process can be difficult. The
recommended way to handle signals in a multithreaded process is to mask off all
signals in all threads, then use the signals sigwait() API in a single thread
to wait for any signal to be delivered to the process.</p>
<p>For information about the examples included with the APIs, see the <a href=
"users_g3.htm">information on the API examples</a>.</p>
<p>The Signals APIs are:</p>
<!-- ***** NOTE ***** Do not manually update text or links in this section. -->
<!-- Updates made in this section *will* be overlaid by automated tools -->
<!-- Notify User Technologies of needed updates to be made in XML for API finder.-->
<!--***************API BEGIN PASTE***************-->
<ul>
<li><A HREF="users_95.htm">pthread_kill()</A> (Send Signal to Thread) requests that the signal sig be delivered to the specified thread.</li>
<li><A HREF="users_96.htm">pthread_sigmask()</A> (Set or Get Signal Mask) examines or modifies the signal blocking mask for the current thread.</li>
<li><A HREF="users_97.htm">pthread_signal_to_cancel_np()</A> (Convert Signals to Cancel Requests) causes a pthread_cancel() to be delivered to the target thread when the first signal specified in set arrives.</li>
</ul>
<!--***************API END PASTE***************-->
<hr>
<center>
<table cellpadding="2" cellspacing="2">
<tr align="center">
<td valign="middle" align="center"><a href="rzah4mst.htm">Pthread APIs</a> | <a
href="aplist.htm">APIs by category</a></td>
</tr>
</table>
</center>
</body>
</html>