Lines Matching +full:debug +full:- +full:mode
4 .\" groff -Tascii -man python.man | less
7 python \- an interpreted, interactive, object-oriented programming language
11 .B \-B
14 .B \-b
17 .B \-d
20 .B \-E
23 .B \-h
26 .B \-i
29 .B \-I
33 .B \-m
34 .I module-name
37 .B \-q
40 .B \-O
43 .B \-OO
46 .B \-s
49 .B \-S
52 .B \-u
56 .B \-v
59 .B \-V
62 .B \-W
66 .B \-x
70 .B \-X
73 .B \-?
77 .B \--check-hash-based-pycs
86 .B \-c
91 \-
97 Python is an interpreted, interactive, object-oriented programming
100 The Python Library Reference documents built-in and standard types,
121 .B \-B
126 .B \-b
128 and comparing bytes/bytearray with str. (-bb: issue errors)
130 .BI "\-c " command
135 .BI "\-\-check-hash-based-pycs " mode
136 Configure how Python evaluates the up-to-dateness of hash-based .pyc files.
138 .B \-d
142 .B \-E
146 .B \-h ", " \-? ", "\-\-help
149 .B \-i
150 When a script is passed as first argument or the \fB\-c\fP option is
151 used, enter interactive mode after executing the script or the
156 .B \-I
157 Run Python in isolated mode. This also implies \fB\-E\fP and \fB\-s\fP. In
158 isolated mode sys.path contains neither the script's directory nor the user's
159 site-packages directory. All PYTHON* environment variables are ignored, too.
163 .BI "\-m " module-name
170 .B \-O
173 adding .opt-1 before the .pyc extension.
175 .B \-OO
176 Do \fB-O\fP and also discard docstrings; change the filename for
177 compiled (bytecode) files by adding .opt-2 before the .pyc extension.
179 .B \-q
181 also suppressed in non-interactive mode.
183 .B \-s
186 .B \-S
189 and the site-dependent manipulations of
195 .B \-u
199 .B \-v
201 (filename or built-in module) from which it is loaded. When given
206 .B \-V ", " \-\-version
210 .BI "\-W " argument
218 .B \-W
222 .B \-W
262 case-insensitive. The
269 field matches the (fully-qualified) module name; this match is
270 case-sensitive. The
275 .BI "\-X " option
278 -X faulthandler: enable faulthandler
280 -X showrefcount: output the total reference count and number of used
282 interactive interpreter. This only works on debug builds
284 -X tracemalloc: start tracing Python memory allocations using the
286 traceback of a trace. Use -X tracemalloc=NFRAME to start tracing with a
289 -X showalloccount: output the total count of allocated objects for each
293 -X importtime: show how long each import takes. It shows module name,
295 nested imports). Note that its output may be broken in multi-threaded
296 application. Typical usage is python3 -X importtime -c 'import asyncio'
298 -X dev: enable CPython’s “development mode”, introducing additional runtime
301 only emitted when an issue is detected. Effect of the developer mode:
302 * Add default warning filter, as -W default
303 * Install debug hooks on memory allocators: see the PyMem_SetupDebugHooks() C function
305 * Enable asyncio debug mode
309 -X utf8: enable UTF-8 mode for operating system interfaces, overriding the default
310 locale-aware mode. -X utf8=0 explicitly disables UTF-8 mode (even when it would
313 -X pycache_prefix=PATH: enable writing .pyc files to a parallel tree rooted at the
316 .B \-x
329 .B \-c
337 In non-interactive mode, the entire input is parsed before it is
349 .B \-c
353 .I '-c'.
358 In interactive mode, the primary prompt is `>>>'; the second prompt
366 control returns to the primary prompt; in non-interactive mode, the
376 conventions; ${prefix} and ${exec_prefix} are installation-dependent
403 are installation-dependent directories, both defaulting to
411 Non-existent directories are silently ignored.
423 mode.
433 If this is set to a non-empty string it is equivalent to specifying
434 the \fB\-O\fP option. If set to an integer, it is equivalent to
435 specifying \fB\-O\fP multiple times.
437 If this is set to a non-empty string it is equivalent to specifying
438 the \fB\-d\fP option. If set to an integer, it is equivalent to
439 specifying \fB\-d\fP multiple times.
441 If this is set to a non-empty string it is equivalent to specifying
442 the \fB\-B\fP option (don't try to write
446 If this is set to a non-empty string it is equivalent to specifying
447 the \fB\-i\fP option.
458 If this is set to a non-empty string it is equivalent to specifying the
459 \fB\-s\fP option (Don't add the user site directory to sys.path).
461 If this is set to a non-empty string it is equivalent to specifying
462 the \fB\-u\fP option.
464 If this is set to a non-empty string it is equivalent to specifying
465 the \fB\-v\fP option. If set to an integer, it is equivalent to
466 specifying \fB\-v\fP multiple times.
468 If this is set to a comma-separated string it is equivalent to
469 specifying the \fB\-W\fP option for each separate value.
483 Set the Python memory allocators and/or install debug hooks. The available
488 The available debug hooks are
489 .IR debug ,
494 When Python is compiled in debug mode, the default is
496 and the debug hooks are automatically used. Otherwise, the default is
499 If set to a non-empty string, Python will print statistics of the pymalloc
509 If this environment variable is set to a non-empty string, enable the debug
510 mode of the asyncio module.
512 If this environment variable is set to a non-empty string, start tracing
520 If this environment variable is set to a non-empty string,
525 This is equivalent to the \fB-X faulthandler\fP option.
533 .IR site-packages
535 .IR "python setup\.py install \-\-user" .
537 If this environment variable is set to a non-empty string, Python will
539 \fB\-X importtime\fP on the command line.
543 .SS Debug-mode variables
544 Setting these variables only has an effect in a debug build of Python, that is,
546 \fB\--with-pydebug\fP build option.
548 If this environment variable is set, Python will print threading debug info.