Initial commit of OpenSPARC T2 design and verification files.
[OpenSPARC-T2-DV] / tools / src / nas,5.n2.os.2 / lib / python / html / python / api / os.html
CommitLineData
86530b38
AT
1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2<html>
3<head>
4<link rel="STYLESHEET" href="api.css" type='text/css' />
5<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
6<link rel='start' href='../index.html' title='Python Documentation Index' />
7<link rel="first" href="api.html" title='Python/C API Reference Manual' />
8<link rel='contents' href='contents.html' title="Contents" />
9<link rel='index' href='genindex.html' title='Index' />
10<link rel='last' href='about.html' title='About this document...' />
11<link rel='help' href='about.html' title='About this document...' />
12<link rel="next" href="processControl.html" />
13<link rel="prev" href="utilities.html" />
14<link rel="parent" href="utilities.html" />
15<link rel="next" href="processControl.html" />
16<meta name='aesop' content='information' />
17<title>5.1 Operating System Utilities </title>
18</head>
19<body>
20<DIV CLASS="navigation">
21<div id='top-navigation-panel' xml:id='top-navigation-panel'>
22<table align="center" width="100%" cellpadding="0" cellspacing="2">
23<tr>
24<td class='online-navigation'><a rel="prev" title="5. Utilities"
25 href="utilities.html"><img src='../icons/previous.png'
26 border='0' height='32' alt='Previous Page' width='32' /></A></td>
27<td class='online-navigation'><a rel="parent" title="5. Utilities"
28 href="utilities.html"><img src='../icons/up.png'
29 border='0' height='32' alt='Up One Level' width='32' /></A></td>
30<td class='online-navigation'><a rel="next" title="5.2 Process Control"
31 href="processControl.html"><img src='../icons/next.png'
32 border='0' height='32' alt='Next Page' width='32' /></A></td>
33<td align="center" width="100%">Python/C API Reference Manual</td>
34<td class='online-navigation'><a rel="contents" title="Table of Contents"
35 href="contents.html"><img src='../icons/contents.png'
36 border='0' height='32' alt='Contents' width='32' /></A></td>
37<td class='online-navigation'><img src='../icons/blank.png'
38 border='0' height='32' alt='' width='32' /></td>
39<td class='online-navigation'><a rel="index" title="Index"
40 href="genindex.html"><img src='../icons/index.png'
41 border='0' height='32' alt='Index' width='32' /></A></td>
42</tr></table>
43<div class='online-navigation'>
44<b class="navlabel">Previous:</b>
45<a class="sectref" rel="prev" href="utilities.html">5. Utilities</A>
46<b class="navlabel">Up:</b>
47<a class="sectref" rel="parent" href="utilities.html">5. Utilities</A>
48<b class="navlabel">Next:</b>
49<a class="sectref" rel="next" href="processControl.html">5.2 Process Control</A>
50</div>
51<hr /></div>
52</DIV>
53<!--End of Navigation Panel-->
54
55<H1><A NAME="SECTION007100000000000000000"></A><A NAME="os"></A>
56<BR>
575.1 Operating System Utilities
58</H1>
59
60<P>
61<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>int&nbsp;<b><tt id='l2h-156' xml:id='l2h-156' class="cfunction">Py_FdIsInteractive</tt></b>(</nobr></td><td>FILE *<var>fp</var>, char *<var>filename</var>)</td></tr></table></dt>
62<dd>
63 Return true (nonzero) if the standard I/O file <var>fp</var> with name
64 <var>filename</var> is deemed interactive. This is the case for files
65 for which "<tt class="samp">isatty(fileno(<var>fp</var>))</tt>" is true. If the global
66 flag <tt class="cdata">Py_InteractiveFlag</tt> is true, this function also returns
67 true if the <var>filename</var> pointer is <tt class="constant">NULL</tt> or if the name is
68 equal to one of the strings <code>'&lt;stdin&gt;'</code> or <code>'???'</code>.
69</dd></dl>
70
71<P>
72<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>long&nbsp;<b><tt id='l2h-157' xml:id='l2h-157' class="cfunction">PyOS_GetLastModificationTime</tt></b>(</nobr></td><td>char *<var>filename</var>)</td></tr></table></dt>
73<dd>
74 Return the time of last modification of the file <var>filename</var>.
75 The result is encoded in the same way as the timestamp returned by
76 the standard C library function <tt class="cfunction">time()</tt>.
77</dd></dl>
78
79<P>
80<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>void&nbsp;<b><tt id='l2h-158' xml:id='l2h-158' class="cfunction">PyOS_AfterFork</tt></b>(</nobr></td><td>)</td></tr></table></dt>
81<dd>
82 Function to update some internal state after a process fork; this
83 should be called in the new process if the Python interpreter will
84 continue to be used. If a new executable is loaded into the new
85 process, this function does not need to be called.
86</dd></dl>
87
88<P>
89<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>int&nbsp;<b><tt id='l2h-159' xml:id='l2h-159' class="cfunction">PyOS_CheckStack</tt></b>(</nobr></td><td>)</td></tr></table></dt>
90<dd>
91 Return true when the interpreter runs out of stack space. This is a
92 reliable check, but is only available when <tt class="constant">USE_STACKCHECK</tt>
93 is defined (currently on Windows using the Microsoft Visual C++
94 compiler). <tt class="constant">USE_STACKCHECK</tt> will be
95 defined automatically; you should never change the definition in
96 your own code.
97</dd></dl>
98
99<P>
100<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>PyOS_sighandler_t&nbsp;<b><tt id='l2h-160' xml:id='l2h-160' class="cfunction">PyOS_getsig</tt></b>(</nobr></td><td>int <var>i</var>)</td></tr></table></dt>
101<dd>
102 Return the current signal handler for signal <var>i</var>. This is a
103 thin wrapper around either <tt class="cfunction">sigaction()</tt> or
104 <tt class="cfunction">signal()</tt>. Do not call those functions directly!
105 <tt class="ctype">PyOS_sighandler_t</tt> is a typedef alias for <tt class="ctype">void
106 (*)(int)</tt>.
107</dd></dl>
108
109<P>
110<dl><dt><table cellpadding="0" cellspacing="0"><tr valign="baseline"><td><nobr>PyOS_sighandler_t&nbsp;<b><tt id='l2h-161' xml:id='l2h-161' class="cfunction">PyOS_setsig</tt></b>(</nobr></td><td>int <var>i</var>, PyOS_sighandler_t <var>h</var>)</td></tr></table></dt>
111<dd>
112 Set the signal handler for signal <var>i</var> to be <var>h</var>; return the
113 old signal handler. This is a thin wrapper around either
114 <tt class="cfunction">sigaction()</tt> or <tt class="cfunction">signal()</tt>. Do not call those
115 functions directly! <tt class="ctype">PyOS_sighandler_t</tt> is a typedef alias
116 for <tt class="ctype">void (*)(int)</tt>.
117</dd></dl>
118
119<P>
120
121<DIV CLASS="navigation">
122<div class='online-navigation'>
123<p></p><hr />
124<table align="center" width="100%" cellpadding="0" cellspacing="2">
125<tr>
126<td class='online-navigation'><a rel="prev" title="5. Utilities"
127 href="utilities.html"><img src='../icons/previous.png'
128 border='0' height='32' alt='Previous Page' width='32' /></A></td>
129<td class='online-navigation'><a rel="parent" title="5. Utilities"
130 href="utilities.html"><img src='../icons/up.png'
131 border='0' height='32' alt='Up One Level' width='32' /></A></td>
132<td class='online-navigation'><a rel="next" title="5.2 Process Control"
133 href="processControl.html"><img src='../icons/next.png'
134 border='0' height='32' alt='Next Page' width='32' /></A></td>
135<td align="center" width="100%">Python/C API Reference Manual</td>
136<td class='online-navigation'><a rel="contents" title="Table of Contents"
137 href="contents.html"><img src='../icons/contents.png'
138 border='0' height='32' alt='Contents' width='32' /></A></td>
139<td class='online-navigation'><img src='../icons/blank.png'
140 border='0' height='32' alt='' width='32' /></td>
141<td class='online-navigation'><a rel="index" title="Index"
142 href="genindex.html"><img src='../icons/index.png'
143 border='0' height='32' alt='Index' width='32' /></A></td>
144</tr></table>
145<div class='online-navigation'>
146<b class="navlabel">Previous:</b>
147<a class="sectref" rel="prev" href="utilities.html">5. Utilities</A>
148<b class="navlabel">Up:</b>
149<a class="sectref" rel="parent" href="utilities.html">5. Utilities</A>
150<b class="navlabel">Next:</b>
151<a class="sectref" rel="next" href="processControl.html">5.2 Process Control</A>
152</div>
153</div>
154<hr />
155<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
156</DIV>
157<!--End of Navigation Panel-->
158<ADDRESS>
159See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
160</ADDRESS>
161</BODY>
162</HTML>