.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PYPY" "1" "Feb 11, 2022" "7.3" "PyPy"
.SH NAME
pypy \- fast, compliant alternative implementation of the Python language
.SH SYNOPSIS
.sp
\fBpypy\fP [\fIoptions\fP]
[\fB\-c\fP \fIcmd\fP|\fB\-m\fP \fImod\fP|\fIfile.py\fP|\fB\-\fP]
[\fIarg\fP\&...]
.SH OPTIONS
.INDENT 0.0
.TP
.B  \-i
Inspect interactively after running script.
.TP
.B  \-O
Skip assert statements.
.TP
.BI \-O\fB O
Remove docstrings when importing modules in addition to \fB\-O\fP\&.
.TP
.BI \-c \ CMD
Program passed in as \fBCMD\fP (terminates option list).
.TP
.B  \-S
Do not \fBimport site\fP on initialization.
.TP
.B  \-s
Don\(aqt add the user site directory to \fIsys.path\fP\&.
.TP
.B  \-u
Unbuffered binary \fBstdout\fP and \fBstderr\fP\&.
.TP
.B  \-h\fP,\fB  \-\-help
Show a help message and exit.
.TP
.BI \-m \ MOD
Library module to be run as a script (terminates option list).
.TP
.BI \-W \ ARG
Warning control (\fIarg\fP is \fIaction\fP:\fImessage\fP:\fIcategory\fP:\fImodule\fP:\fIlineno\fP).
.TP
.B  \-E
Ignore environment variables (such as \fBPYTHONPATH\fP).
.TP
.B  \-B
Disable writing bytecode (\fB\&.pyc\fP) files.
.TP
.BI \-X \ track\-resources
Produce a \fBResourceWarning\fP whenever a file or socket is closed by the
garbage collector.
.TP
.B  \-\-version
Print the PyPy version.
.TP
.B  \-\-info
Print translation information about this PyPy executable.
.TP
.BI \-\-jit \ ARG
Low level JIT parameters.  Mostly internal.  Run \fB\-\-jit help\fP
for more information.
.UNINDENT
.SH ENVIRONMENT
.INDENT 0.0
.TP
.B \fBPYTHONPATH\fP
Add directories to pypy\(aqs module search path.
The format is the same as shell\(aqs \fBPATH\fP\&.
.TP
.B \fBPYTHONSTARTUP\fP
A script referenced by this variable will be executed before the
first prompt is displayed, in interactive mode.
.TP
.B \fBPYTHONDONTWRITEBYTECODE\fP
If set to a non\-empty value, equivalent to the \fB\-B\fP option.
Disable writing \fB\&.pyc\fP files.
.TP
.B \fBPYTHONINSPECT\fP
If set to a non\-empty value, equivalent to the \fB\-i\fP option.
Inspect interactively after running the specified script.
.TP
.B \fBPYTHONIOENCODING\fP
If this is set, it overrides the encoding used for
\fIstdin\fP/\fIstdout\fP/\fIstderr\fP\&.
The syntax is \fIencodingname\fP:\fIerrorhandler\fP
The \fIerrorhandler\fP part is optional and has the same meaning as in
\fIstr.encode\fP\&.
.TP
.B \fBPYTHONNOUSERSITE\fP
If set to a non\-empty value, equivalent to the \fB\-s\fP option.
Don\(aqt add the user site directory to \fIsys.path\fP\&.
.TP
.B \fBPYTHONWARNINGS\fP
If set, equivalent to the \fB\-W\fP option (warning control).
The value should be a comma\-separated list of \fB\-W\fP parameters.
.UNINDENT
.INDENT 0.0
.TP
.B \fBPYPYLOG\fP
If set to a non\-empty value, enable logging, the format is:
.INDENT 7.0
.TP
.B \fIfname\fP or \fI+fname\fP
logging for profiling: includes all
\fBdebug_start\fP/\fBdebug_stop\fP but not any nested
\fBdebug_print\fP\&.
\fIfname\fP can be \fB\-\fP to log to \fIstderr\fP\&.
The \fI+fname\fP form can be used if there is a \fI:\fP in fname
.TP
.B \fB:\fP\fIfname\fP
Full logging, including \fBdebug_print\fP\&.
.TP
.B \fIprefix\fP\fB:\fP\fIfname\fP
Conditional logging.
Multiple prefixes can be specified, comma\-separated.
Only sections whose name match the prefix will be logged.
.UNINDENT
.sp
\fBPYPYLOG=jit\-log\-opt,jit\-backend:logfile\fP will
generate a log suitable for \fIjitviewer\fP, a tool for debugging
performance issues under PyPy.
.TP
.B \fBPYPY_IRC_TOPIC\fP
If set to a non\-empty value, print a random #pypy IRC
topic at startup of interactive mode.
.UNINDENT
.sp
several environment variables:
.INDENT 0.0
.TP
.B \fBPYPY_GC_NURSERY\fP
The nursery size.
Defaults to 1/2 of your last\-level cache, or \fB4M\fP if unknown.
Small values (like 1 or 1KB) are useful for debugging.
.TP
.B \fBPYPY_GC_NURSERY_DEBUG\fP
If set to non\-zero, will fill nursery with garbage, to help
debugging.
.TP
.B \fBPYPY_GC_INCREMENT_STEP\fP
The size of memory marked during the marking step.  Default is size of
nursery times 2. If you mark it too high your GC is not incremental at
all.  The minimum is set to size that survives minor collection times
1.5 so we reclaim anything all the time.
.TP
.B \fBPYPY_GC_MAJOR_COLLECT\fP
Major collection memory factor.
Default is \fB1.82\fP, which means trigger a major collection when the
memory consumed equals 1.82 times the memory really used at the end
of the previous major collection.
.TP
.B \fBPYPY_GC_GROWTH\fP
Major collection threshold\(aqs max growth rate.
Default is \fB1.4\fP\&.
Useful to collect more often than normally on sudden memory growth,
e.g. when there is a temporary peak in memory usage.
.TP
.B \fBPYPY_GC_MAX\fP
The max heap size.
If coming near this limit, it will first collect more often, then
raise an RPython MemoryError, and if that is not enough, crash the
program with a fatal error.
Try values like \fB1.6GB\fP\&.
.TP
.B \fBPYPY_GC_MAX_DELTA\fP
The major collection threshold will never be set to more than
\fBPYPY_GC_MAX_DELTA\fP the amount really used after a collection.
Defaults to 1/8th of the total RAM size (which is constrained to be
at most 2/3/4GB on 32\-bit systems).
Try values like \fB200MB\fP\&.
.TP
.B \fBPYPY_GC_MIN\fP
Don\(aqt collect while the memory size is below this limit.
Useful to avoid spending all the time in the GC in very small
programs.
Defaults to 8 times the nursery.
.TP
.B \fBPYPY_GC_DEBUG\fP
Enable extra checks around collections that are too slow for normal
use.
Values are \fB0\fP (off), \fB1\fP (on major collections) or \fB2\fP (also
on minor collections).
.TP
.B \fBPYPY_GC_MAX_PINNED\fP
The maximal number of pinned objects at any point in time.  Defaults
to a conservative value depending on nursery size and maximum object
size inside the nursery.  Useful for debugging by setting it to 0.
.UNINDENT
.SH SEE ALSO
.sp
\fBpython\fP(1)
.SH AUTHOR
The PyPy Project
.SH COPYRIGHT
2022, The PyPy Project
.\" Generated by docutils manpage writer.
.