sam-t2/devtools/v9/html/python/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&nbsp;<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&nbsp;<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&nbsp;<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.2, documentation updated on 28 September 2005.</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>