REDROOM

Navigation

Breadcrumbs

/ / usr / include / python3.6m

Create

Create File | Create Folder | Upload Files | Run Command

Preview: pyfpe.h Size: 8.27 KB

/usr/include/python3.6m/pyfpe.h

#ifndef Py_PYFPE_H
#define Py_PYFPE_H
#ifdef __cplusplus
extern "C" {
#endif
/*
     ---------------------------------------------------------------------
    /                       Copyright (c) 1996.                           \
   |          The Regents of the University of California.                 |
   |                        All rights reserved.                           |
   |                                                                       |
   |   Permission to use, copy, modify, and distribute this software for   |
   |   any purpose without fee is hereby granted, provided that this en-   |
   |   tire notice is included in all copies of any software which is or   |
   |   includes  a  copy  or  modification  of  this software and in all   |
   |   copies of the supporting documentation for such software.           |
   |                                                                       |
   |   This  work was produced at the University of California, Lawrence   |
   |   Livermore National Laboratory under  contract  no.  W-7405-ENG-48   |
   |   between  the  U.S.  Department  of  Energy and The Regents of the   |
   |   University of California for the operation of UC LLNL.              |
   |                                                                       |
   |                              DISCLAIMER                               |
   |                                                                       |
   |   This  software was prepared as an account of work sponsored by an   |
   |   agency of the United States Government. Neither the United States   |
   |   Government  nor the University of California nor any of their em-   |
   |   ployees, makes any warranty, express or implied, or  assumes  any   |
   |   liability  or  responsibility  for the accuracy, completeness, or   |
   |   usefulness of any information,  apparatus,  product,  or  process   |
   |   disclosed,   or  represents  that  its  use  would  not  infringe   |
   |   privately-owned rights. Reference herein to any specific  commer-   |
   |   cial  products,  process,  or  service  by trade name, trademark,   |
   |   manufacturer, or otherwise, does not  necessarily  constitute  or   |
   |   imply  its endorsement, recommendation, or favoring by the United   |
   |   States Government or the University of California. The views  and   |
   |   opinions  of authors expressed herein do not necessarily state or   |
   |   reflect those of the United States Government or  the  University   |
   |   of  California,  and shall not be used for advertising or product   |
    \  endorsement purposes.                                              /
     ---------------------------------------------------------------------
*/

/*
 *       Define macros for handling SIGFPE.
 *       Lee Busby, LLNL, November, 1996
 *       busby1@llnl.gov
 *
 *********************************************
 * Overview of the system for handling SIGFPE:
 *
 * This file (Include/pyfpe.h) defines a couple of "wrapper" macros for
 * insertion into your Python C code of choice. Their proper use is
 * discussed below. The file Python/pyfpe.c defines a pair of global
 * variables PyFPE_jbuf and PyFPE_counter which are used by the signal
 * handler for SIGFPE to decide if a particular exception was protected
 * by the macros. The signal handler itself, and code for enabling the
 * generation of SIGFPE in the first place, is in a (new) Python module
 * named fpectl. This module is standard in every respect. It can be loaded
 * either statically or dynamically as you choose, and like any other
 * Python module, has no effect until you import it.
 *
 * In the general case, there are three steps toward handling SIGFPE in any
 * Python code:
 *
 * 1) Add the *_PROTECT macros to your C code as required to protect
 *    dangerous floating point sections.
 *
 * 2) Turn on the inclusion of the code by adding the ``--with-fpectl''
 *    flag at the time you run configure.  If the fpectl or other modules
 *    which use the *_PROTECT macros are to be dynamically loaded, be
 *    sure they are compiled with WANT_SIGFPE_HANDLER defined.
 *
 * 3) When python is built and running, import fpectl, and execute
 *    fpectl.turnon_sigfpe(). This sets up the signal handler and enables
 *    generation of SIGFPE whenever an exception occurs. From this point
 *    on, any properly trapped SIGFPE should result in the Python
 *    FloatingPointError exception.
 *
 * Step 1 has been done already for the Python kernel code, and should be
 * done soon for the NumPy array package.  Step 2 is usually done once at
 * python install time. Python's behavior with respect to SIGFPE is not
 * changed unless you also do step 3. Thus you can control this new
 * facility at compile time, or run time, or both.
 *
 ********************************
 * Using the macros in your code:
 *
 * static PyObject *foobar(PyObject *self,PyObject *args)
 * {
 *     ....
 *     PyFPE_START_PROTECT("Error in foobar", return 0)
 *     result = dangerous_op(somearg1, somearg2, ...);
 *     PyFPE_END_PROTECT(result)
 *     ....
 * }
 *
 * If a floating point error occurs in dangerous_op, foobar returns 0 (NULL),
 * after setting the associated value of the FloatingPointError exception to
 * "Error in foobar". ``Dangerous_op'' can be a single operation, or a block
 * of code, function calls, or any combination, so long as no alternate
 * return is possible before the PyFPE_END_PROTECT macro is reached.
 *
 * The macros can only be used in a function context where an error return
 * can be recognized as signaling a Python exception. (Generally, most
 * functions that return a PyObject * will qualify.)
 *
 * Guido's original design suggestion for PyFPE_START_PROTECT and
 * PyFPE_END_PROTECT had them open and close a local block, with a locally
 * defined jmp_buf and jmp_buf pointer. This would allow recursive nesting
 * of the macros. The Ansi C standard makes it clear that such local
 * variables need to be declared with the "volatile" type qualifier to keep
 * setjmp from corrupting their values. Some current implementations seem
 * to be more restrictive. For example, the HPUX man page for setjmp says
 *
 *   Upon the return from a setjmp() call caused by a longjmp(), the
 *   values of any non-static local variables belonging to the routine
 *   from which setjmp() was called are undefined. Code which depends on
 *   such values is not guaranteed to be portable.
 *
 * I therefore decided on a more limited form of nesting, using a counter
 * variable (PyFPE_counter) to keep track of any recursion.  If an exception
 * occurs in an ``inner'' pair of macros, the return will apparently
 * come from the outermost level.
 *
 */

#ifdef WANT_SIGFPE_HANDLER
#include <signal.h>
#include <setjmp.h>
#include <math.h>
extern jmp_buf PyFPE_jbuf;
extern int PyFPE_counter;
extern double PyFPE_dummy(void *);

#define PyFPE_START_PROTECT(err_string, leave_stmt) \
if (!PyFPE_counter++ && setjmp(PyFPE_jbuf)) { \
	PyErr_SetString(PyExc_FloatingPointError, err_string); \
	PyFPE_counter = 0; \
	leave_stmt; \
}

/*
 * This (following) is a heck of a way to decrement a counter. However,
 * unless the macro argument is provided, code optimizers will sometimes move
 * this statement so that it gets executed *before* the unsafe expression
 * which we're trying to protect.  That pretty well messes things up,
 * of course.
 *
 * If the expression(s) you're trying to protect don't happen to return a
 * value, you will need to manufacture a dummy result just to preserve the
 * correct ordering of statements.  Note that the macro passes the address
 * of its argument (so you need to give it something which is addressable).
 * If your expression returns multiple results, pass the last such result
 * to PyFPE_END_PROTECT.
 *
 * Note that PyFPE_dummy returns a double, which is cast to int.
 * This seeming insanity is to tickle the Floating Point Unit (FPU).
 * If an exception has occurred in a preceding floating point operation,
 * some architectures (notably Intel 80x86) will not deliver the interrupt
 * until the *next* floating point operation.  This is painful if you've
 * already decremented PyFPE_counter.
 */
#define PyFPE_END_PROTECT(v) PyFPE_counter -= (int)PyFPE_dummy(&(v));

#else

#define PyFPE_START_PROTECT(err_string, leave_stmt)
#define PyFPE_END_PROTECT(v)

#endif

#ifdef __cplusplus
}
#endif
#endif /* !Py_PYFPE_H */

Directory Contents

Dirs: 0 × Files: 102

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
abstract.h	46.34 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
accu.h	1016 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
asdl.h	1.18 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
ast.h	477 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
bitset.h	792 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
bltinmodule.h	264 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
boolobject.h	886 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
bytearrayobject.h	2.06 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
bytesobject.h	8.17 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
bytes_methods.h	3.12 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
cellobject.h	701 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
ceval.h	8.32 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
classobject.h	1.63 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
code.h	5.81 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
codecs.h	6.63 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
compile.h	2.11 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
complexobject.h	1.76 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
datetime.h	9.19 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
descrobject.h	2.89 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
dictobject.h	7.01 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
dtoa.h	458 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
dynamic_annotations.h	21.94 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
enumobject.h	253 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
errcode.h	1.46 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
eval.h	597 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
fileobject.h	1.61 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
fileutils.h	3.44 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
floatobject.h	4.68 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
frameobject.h	3.45 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
funcobject.h	3.98 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
genobject.h	3.50 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
graminit.h	1.92 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
grammar.h	2.03 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
import.h	4.13 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
intrcheck.h	513 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
iterobject.h	567 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
listobject.h	2.83 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
longintrepr.h	3.67 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
longobject.h	9.60 KB	lrw-r--r--	2026-02-05 20:00:12	Edit Download recursive recursive
marshal.h	803 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
memoryobject.h	2.70 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
metagrammar.h	253 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
methodobject.h	3.76 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
modsupport.h	7.15 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
moduleobject.h	2.23 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
namespaceobject.h	349 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
node.h	1007 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
object.h	41.21 KB	lrw-r--r--	2026-02-05 20:00:12	Edit Download recursive recursive
objimpl.h	13.91 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
odictobject.h	1.26 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
opcode.h	4.95 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
osdefs.h	691 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
osmodule.h	291 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
parsetok.h	2.82 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
patchlevel.h	1.10 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pgen.h	253 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pgenheaders.h	1.15 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pyarena.h	2.68 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pyatomic.h	7.94 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pycapsule.h	1.69 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pyconfig-64.h	43.58 KB	lrw-r--r--	2026-02-05 20:01:21	Edit Download recursive recursive
pyconfig.h	162 B	lrw-r--r--	2026-02-05 20:05:18	Edit Download recursive recursive
pyctype.h	1.29 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pydebug.h	1.23 KB	lrw-r--r--	2026-02-05 20:00:12	Edit Download recursive recursive
pydtrace.h	1.92 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pyerrors.h	16.82 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pyexpat.h	2.39 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pyfpe.h	8.27 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pygetopt.h	410 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pyhash.h	4.04 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pylifecycle.h	3.98 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pymacconfig.h	2.92 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pymacro.h	3.42 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pymath.h	8.12 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pymem.h	8.36 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pyport.h	26.93 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pystate.h	10.88 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pystrcmp.h	436 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pystrhex.h	495 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pystrtod.h	1.45 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
Python-ast.h	21.75 KB	lrw-r--r--	2018-12-24 02:45:11	Edit Download recursive recursive
Python.h	3.15 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pythonrun.h	6.62 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pythread.h	2.92 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
pytime.h	7.43 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
py_curses.h	4.21 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
rangeobject.h	629 B	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
setobject.h	3.25 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
sliceobject.h	2.43 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
structmember.h	1.97 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
structseq.h	1.32 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
symtable.h	4.88 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
sysmodule.h	1.32 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
token.h	1.90 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
traceback.h	3.56 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
tupleobject.h	2.39 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
typeslots.h	2.20 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
ucnhash.h	1.03 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
unicodeobject.h	79.86 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
warnings.h	1.65 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
weakrefobject.h	2.80 KB	lrw-r--r--	2018-12-23 21:37:14	Edit Download recursive recursive
_hashopenssl.h	1.33 KB	lrw-r--r--	2026-02-05 20:00:12	Edit Download recursive recursive