File: //usr/share/doc/python-docs-2.4.3/html/api/processControl.html
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="api.css" type='text/css' />
<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
<link rel='start' href='../index.html' title='Python Documentation Index' />
<link rel="first" href="api.html" title='Python/C API Reference Manual' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="importing.html" />
<link rel="prev" href="os.html" />
<link rel="parent" href="utilities.html" />
<link rel="next" href="importing.html" />
<meta name='aesop' content='information' />
<title>5.2 Process Control </title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="5.1 Operating System Utilities"
href="os.html"><img src='../icons/previous.png'
border='0' height='32' alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="5. Utilities"
href="utilities.html"><img src='../icons/up.png'
border='0' height='32' alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="5.3 Importing Modules"
href="importing.html"><img src='../icons/next.png'
border='0' height='32' alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python/C API Reference Manual</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='../icons/contents.png'
border='0' height='32' alt='Contents' width='32' /></A></td>
<td class='online-navigation'><img src='../icons/blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><a rel="index" title="Index"
href="genindex.html"><img src='../icons/index.png'
border='0' height='32' alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="os.html">5.1 Operating System Utilities</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="utilities.html">5. Utilities</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="importing.html">5.3 Importing Modules</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION007200000000000000000"></A><A NAME="processControl"></A>
<BR>
5.2 Process Control
</H1>
<P>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>void <b><tt id='l2h-162' xml:id='l2h-162' class="cfunction">Py_FatalError</tt></b>(</nobr></td><td>const char *<var>message</var>)</td></tr></table></dt>
<dd>
Print a fatal error message and kill the process. No cleanup is
performed. This function should only be invoked when a condition is
detected that would make it dangerous to continue using the Python
interpreter; e.g., when the object administration appears to be
corrupted. On <span class="Unix">Unix</span>, the standard C library function
<tt class="cfunction">abort()</tt><a id='l2h-165' xml:id='l2h-165'></a> is called which will attempt to
produce a <span class="file">core</span> file.
</dd></dl>
<P>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>void <b><tt id='l2h-163' xml:id='l2h-163' class="cfunction">Py_Exit</tt></b>(</nobr></td><td>int <var>status</var>)</td></tr></table></dt>
<dd>
Exit the current process. This calls
<tt class="cfunction">Py_Finalize()</tt><a id='l2h-166' xml:id='l2h-166'></a> and then calls the
standard C library function
<code>exit(<var>status</var>)</code><a id='l2h-167' xml:id='l2h-167'></a>.
</dd></dl>
<P>
<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>int <b><tt id='l2h-164' xml:id='l2h-164' class="cfunction">Py_AtExit</tt></b>(</nobr></td><td>void (*func) ())</td></tr></table></dt>
<dd>
Register a cleanup function to be called by
<tt class="cfunction">Py_Finalize()</tt><a id='l2h-168' xml:id='l2h-168'></a>. The cleanup
function will be called with no arguments and should return no
value. At most 32 <a id='l2h-169' xml:id='l2h-169'></a>cleanup functions can be
registered. When the registration is successful,
<tt class="cfunction">Py_AtExit()</tt> returns <code>0</code>; on failure, it returns
<code>-1</code>. The cleanup function registered last is called first.
Each cleanup function will be called at most once. Since Python's
internal finalization will have completed before the cleanup
function, no Python APIs should be called by <var>func</var>.
</dd></dl>
<P>
<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="5.1 Operating System Utilities"
href="os.html"><img src='../icons/previous.png'
border='0' height='32' alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="5. Utilities"
href="utilities.html"><img src='../icons/up.png'
border='0' height='32' alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="5.3 Importing Modules"
href="importing.html"><img src='../icons/next.png'
border='0' height='32' alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python/C API Reference Manual</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
href="contents.html"><img src='../icons/contents.png'
border='0' height='32' alt='Contents' width='32' /></A></td>
<td class='online-navigation'><img src='../icons/blank.png'
border='0' height='32' alt='' width='32' /></td>
<td class='online-navigation'><a rel="index" title="Index"
href="genindex.html"><img src='../icons/index.png'
border='0' height='32' alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="os.html">5.1 Operating System Utilities</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="utilities.html">5. Utilities</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="importing.html">5.3 Importing Modules</A>
</div>
</div>
<hr />
<span class="release-info">Release 2.4.3, documentation updated on 29 March 2006.</span>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>