93 lines
7.0 KiB
HTML
93 lines
7.0 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>Signal 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 December 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>
|
||
|
|
<a name="Top_Of_Page"></a>
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<script language="Javascript" src="../rzahg/synch.js" type="text/javascript">
|
||
|
|
</script>
|
||
|
|
|
||
|
|
<h2>Signal APIs</h2>
|
||
|
|
|
||
|
|
<p>An X/Open specification defines a "signal" as a mechanism by which a process may be notified of, or affected by, an event occurring in the system. The term signal is also used to refer to the event itself.</p>
|
||
|
|
|
||
|
|
<p>For additional information on the Signal APIs, see:</p>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><a href="unix5a2.htm">Signal Concepts</a></li>
|
||
|
|
|
||
|
|
<li><a href="unix5a2.htm#sigmanagement">i5/OS Signal Management</a></li>
|
||
|
|
|
||
|
|
<li><a href="unix5a2.htm#sigdifferences">Differences from Signals on UNIX
|
||
|
|
Systems</a></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p>The Signal 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="sigalarm.htm">alarm()</A> (Set schedule for alarm signal) generates a SIGALRM signal after the number of seconds specified by the seconds parameter have elapsed. The delivery of the SIGALRM signal is directed at the calling process.</li>
|
||
|
|
<li><A HREF="getitime.htm">getitimer()</A> (Get value of interval timer) returns the value last used to set the interval timer specified by which in the structure pointed to by value.</li>
|
||
|
|
<li><A HREF="sigkill.htm">kill()</A> (Send signal to process or group of processes) sends a signal to a process or process group specified by pid.</li>
|
||
|
|
<li><A HREF="sigpause.htm">pause()</A> (Suspend process until signal received) suspends processing of the calling thread.</li>
|
||
|
|
<li><A HREF="sigdsig.htm">Qp0sDisableSignals()</A> (Disable process for signals) prevents the process from receiving signals.</li>
|
||
|
|
<li><A HREF="sigesig.htm">Qp0sEnableSignals()</A> (Enable process for signals) enables the process to receive signals.</li>
|
||
|
|
<li><A HREF="setitime.htm">setitimer()</A> (Set value of interval timer) sets the timer specified by which to the value in the structure pointed to by value and stores the previous value of the timer in the structure pointed to by ovalue.</li>
|
||
|
|
<li><A HREF="sigactn.htm">sigaction()</A> (Examine and change signal action) examines, changes, or both examines and changes the action associated with a specific signal.</li>
|
||
|
|
<li><A HREF="sigaset.htm">sigaddset()</A> (Add signal to signal set) is part of a family of functions that manipulate signal sets.</li>
|
||
|
|
<li><A HREF="sigdset.htm">sigdelset()</A> (Delete signal from signal set) is part of a family of functions that manipulate signal sets.</li>
|
||
|
|
<li><A HREF="sigeset.htm">sigemptyset()</A> (Initialize and empty signal set) is part of a family of functions that manipulate signal sets.</li>
|
||
|
|
<li><A HREF="sigfset.htm">sigfillset()</A> (Initialize and fill signal set) is part of a family of functions that manipulate signal sets.</li>
|
||
|
|
<li><A HREF="sigismbr.htm">sigismember()</A> (Test for signal in signal set) is part of a family of functions that manipulate signal sets.</li>
|
||
|
|
<li><A HREF="siglngj.htm">siglongjmp()</A> (Perform nonlocal goto with signal handling) restores the stack environment previously saved in env by sigsetjmp().</li>
|
||
|
|
<li><A HREF="sigpend.htm">sigpending()</A> (Examine pending signals) returns signals that are blocked from delivery and pending for either the calling thread or the process.</li>
|
||
|
|
<li><A HREF="sigpmsk.htm">sigprocmask()</A> (Examine and change blocked signals) examines, or changes, or both examines and changes the signal mask of the calling thread.</li>
|
||
|
|
<li><A HREF="sigsetj.htm">sigsetjmp()</A> (Set jump point for nonlocal goto) saves the current stack environment and, optionally, the current signal mask.</li>
|
||
|
|
<li><A HREF="sigsusp.htm">sigsuspend()</A> (Wait for signal) replaces the current signal mask of a thread with the signal set given by *sigmask and then suspends processing of the calling process.</li>
|
||
|
|
<li><A HREF="sigtwait.htm">sigtimedwait()</A> (Synchronously accept a signal for interval of time) selects a pending signal from set, clears it from the set of pending signals for the thread or process, and returns that signal number in the si_signo member in the structure that is referenced by info.</li>
|
||
|
|
<li><A HREF="sigwait.htm">sigwait()</A> (Synchronously accept a signal) selects a pending signal from set, clears it from the set of pending signals for the thread or process, and returns that signal number in the location that is referenced by sig.</li>
|
||
|
|
<li><A HREF="sigwaiti.htm">sigwaitinfo()</A> (Synchronously accept a signal and signal data) selects a pending signal from set, clears it from the set of pending signals for the thread or process, and returns that signal number in the si_signo member in the structure that is referenced by info.</li>
|
||
|
|
<li><A HREF="sigsleep.htm">sleep()</A> (Suspend processing for interval of time) suspends a thread for a specified number of seconds.</li>
|
||
|
|
<li><A HREF="usleep.htm">usleep()</A> (Suspend processing for interval of time) suspends a thread for the number of microseconds specified by the of useconds parameter.</li>
|
||
|
|
</ul>
|
||
|
|
<!--***************API END PASTE***************-->
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> These functions use header (include) files from the library QSYSINC, which is optionally installable. Make sure QSYSINC is installed on your system before using any of the functions. See <a href="unix13.htm">Header Files for UNIX-Type Functions</a> for the file and member name of each header file.</p>
|
||
|
|
|
||
|
|
<p>The term "signal" comes from X/Open CAE
|
||
|
|
Specification System Interface Definitions Issue 4, Number 2, Glossary, page
|
||
|
|
27. X/Open Company Ltd., United Kingdom, 1994.</p>
|
||
|
|
<hr>
|
||
|
|
<center>
|
||
|
|
<table cellpadding="2" cellspacing="2">
|
||
|
|
<tr align="center">
|
||
|
|
<td valign="middle" align="center">
|
||
|
|
<a href="#Top_Of_Page">Top</a> |
|
||
|
|
<a href="unix.htm">UNIX-Type APIs</a> |
|
||
|
|
<a href="aplist.htm">APIs by category</a></td>
|
||
|
|
</tr>
|
||
|
|
</table>
|
||
|
|
</center>
|
||
|
|
</body>
|
||
|
|
</html>
|
||
|
|
|