diff -r 1465baaccd84 Misc/python.man --- a/Misc/python.man Sat Nov 19 10:32:44 2016 -0800 +++ b/Misc/python.man Sat Nov 19 21:55:04 2016 -0600 @@ -430,6 +430,71 @@ The integer must be a decimal number in the range [0,4294967295]. Specifying the value 0 will disable hash randomization. +.IP PYTHONMALLOC +Set the Python memory allocators and/or install debug hooks. +The available memory allocators are "malloc" and "pymalloc". +The available debug hooks are "debug","malloc_debug", +and "pymalloc_debug". + +When Python is compiled in release mode, the default is "pymalloc". +When compiled in debug mode, the default is "pymalloc_debug" and +the debug hooks are used automatically. + +If Python is configured without "pymalloc" support, "pymalloc" and +"pymalloc_debug" are not available, the default is "malloc" in release +mode and "malloc_debug" in debug mode. + +.IP PYTHONMALLOCSTATS +If set to a non-empty string, Python will print statistics of the +pymalloc memory allocator every time a new pymalloc object arena +is created, and on shutdown. + +This variable is ignored if the PYTHONMALLOC environment variable +$PYTHONMALLOC is used to force the "malloc()" allocator +of the C library, or if Python is configured without pymalloc support. +.IP PYTHONASYNCIODEBUG +If this environment variable is set to a non-empty string, +enable the debug mode of the asyncio module. +.IP PYTHONTRACEMALLOC +If this environment variable is set to a non-empty string, +start tracing Python memory allocations using the tracemalloc +module. The value of the variable is the maximum number of frames +stored in a traceback of a trace. For example, +.IB PYTHONTRACEMALLOC=1 +stores only the most recent frame. See the documentation +.IR tracemalloc.start() + for more information. +.IP PYTHONFAULTHANDLER +If this environment variable is set to a non-empty string, +.IR faulthandler.enable() +is called at startup: install a handler +for SIGSEGV, SIGFPE, SIGABRT, SIGBUS and SIGILL signals to +dump the Python traceback. + +This is equivalent to the -X "faulthandler" option. +.IP PYTHONEXECUTABLE +If this environment variable is set, +.IB sys.argv[0] +will be set to its value instead of the value got through +the C runtime. Only works on Mac OS X. +.IP PYTHONUSERBASE +Defines the user base directory, which is used to compute +the path of the user site-packages directory and Distutils +installation paths for "python setup.py install --user". + +.SH DEBUG-MODE VARIABLES + +Setting these variables only has an effect in a debug build +of Python, that is, if Python was configured with the +\fB\--with-pydebug\fP build option. + +.IP PYTHONTHREADDEBUG +If set, Python will print threading debug info. + +.IP PYTHONDUMPREFS +If set, Python will dump objects and reference counts still +alive after shutting down the interpreter. + .SH AUTHOR The Python Software Foundation: https://www.python.org/psf/ .SH INTERNET RESOURCES