diff --git a/Misc/python.man b/Misc/python.man --- a/Misc/python.man +++ b/Misc/python.man @@ -426,16 +426,80 @@ of str, bytes and datetime objects. If PYTHONHASHSEED is set to an integer value, it is used as a fixed seed for generating the hash() of the types covered by the hash randomization. Its purpose is to allow repeatable hashing, such as for selftests for the interpreter itself, or to allow a cluster of python processes to share hash values. 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 +.IR malloc +and +.IR pymalloc . +The available debug hooks are +.IR debug , +.IR malloc_debug , +and +.IR pymalloc_debug . + +When Python is compiled in debug mode, the default is +.IR pymalloc_debug +and the debug hooks are automatically used. Otherwise, the default is +.IR pymalloc . + +.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 +.RB $ PYTHONMALLOC +environment variable is used to force the +.BR malloc (3) +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. +.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 \fB-X "faulthandler"\fP 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 +.IR site-packages +directory and Distutils installation paths for +.IR "python setup\.py install \-\-user" . +.SS 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 this environment variable is set, Python will print threading debug info. +.IP PYTHONDUMPREFS +If this environment variable is 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 Main website: https://www.python.org/ .br Documentation: https://docs.python.org/ .br Developer resources: https://docs.python.org/devguide/