File: memray.1

package info (click to toggle)
python-memray 1.17.0%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 24,396 kB
  • sloc: python: 28,451; ansic: 16,507; sh: 10,586; cpp: 8,494; javascript: 1,474; makefile: 822; awk: 12
file content (82 lines) | stat: -rw-r--r-- 2,184 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
.TH MEMRAY "1" "June 2024" "memray 1.13.0" "User Commands"
.SH NAME
memray \- Memory profiler for Python applications
.SH DESCRIPTION
usage: memray [\-h] [\-v] [\-V]
.IP
{run,flamegraph,table,live,tree,parse,summary,stats,transform,attach,detach}
\&...
.PP
Memory profiler for Python applications
.PP
Run `memray run` to generate a memory profile report, then use a reporter command
such as `memray flamegraph` or `memray table` to convert the results into HTML.
.PP
Example:
.IP
\f(CW$ python3 -m memray run -o output.bin my_script.py\fR
.br
\f(CW$ python3 -m memray flamegraph output.bin\fR
.SS "positional arguments:"
.TP
{run,flamegraph,table,live,tree,parse,summary,stats,transform,attach,detach}
Mode of operation
.TP
run
Run the specified application and track memory usage
.TP
flamegraph
Generate an HTML flame graph for peak memory usage
.TP
table
Generate an HTML table with all records in the peak memory usage
.TP
live
Remotely monitor allocations in a text\-based interface
.TP
tree
Generate a tree view in the terminal for peak memory usage
.TP
parse
Debug a results file by parsing and printing each record in it
.TP
summary
Generate a terminal\-based summary report of the functions that allocate most memory
.TP
stats
Generate high level stats of the memory usage in the terminal
.TP
transform
Generate reports files in different formats
.TP
attach
Begin tracking allocations in an already\-started process
.TP
detach
End the tracking started by a previous ``memray attach`` call
.SS "options:"
.TP
\fB\-h\fR, \fB\-\-help\fR
show this help message and exit
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Increase verbosity. Option is additive and can be specified up to 3 times
.TP
\fB\-V\fR, \fB\-\-version\fR
Displays the current version of Memray
.PP
Please submit feedback, ideas, and bug reports by filing a new issue at
https://github.com/bloomberg/memray/issues
.SH "SEE ALSO"
The full documentation for
.B memray
is maintained as a Texinfo manual.  If the
.B info
and
.B memray
programs are properly installed at your site, the command
.IP
.B info memray
.PP
should give you access to the complete manual.