-
Notifications
You must be signed in to change notification settings - Fork 4
/
pagemon.8
117 lines (114 loc) · 3.49 KB
/
pagemon.8
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
.\" Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH PAGEMON 8 "January 12, 2024""
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.nr SS ((\n[.l] - \n[.i]) / 1n - 24)
.SH NAME
pagemon \- a tool to monitor memory pages.
.br
.SH SYNOPSIS
.B pagemon
.RI [options]
.br
.SH DESCRIPTION
pagemon is a program that allows one to interactively monitor the memory
pages of a process.
.SH OPTIONS
pagemon options are as follow:
.TP
.B \-a
enable automatic zoom mode, this will change the zoom level to show
the entire page map in the window, up to a maximum zoom level of 999.
.TP
.B \-d delay
delay in microseconds between data refreshes, the default is 10,000
microseconds (1/100th of a second).
.TP
.B \-h
show help.
.TP
.B \-p
specify the process id (PID) or name of the process to monitor. If a name
is given, then pagemon will monitor the first process that matches the name.
.TP
.B \-r
read pages into memory. This will force all pages in the process to be read
into physical memory.
.TP
.B \-t ticks
specify ticks between dirty page checks. The default is 60 ticks; the larger
the value the longer time between dirty page checks.
.TP
.B \-v
enable VM information view. This is equivalent to pressing the 'v' or 'V' key
when running pagemon.
.TP
.B \-z zoom
specify the default zoom level on page view, the default is 1 (that is 1\-to\-1
view of pages). Higher values increase the zoom level so more pages are
represented in the map view.
.SH KEYS
.TS
expand;
lB lBw(\n[SS]n)
l l.
Key Explanation
Home Move cursor to start of page map or start of page
End Move cursor to end of page map or end of page
Cursor Up Move cursor up
Cursor Down Move cursor down
Cursor Left Move cursor left
Cursor Right Move cursor right
Page Up Move cursor 1/2 page up
Page Down Move cursor 1/2 page down
Esc, q, Q Quit
Enter Toggle page map / memory map view
Tab Toggle detailed view of page
a, A Toggle automatic zoom mode
v, V Toggle Virtual Memory statistics of process
p, P Toggle page statistics
?, h Toggle help
c, C Close all the pop up windows
r, R Force all pages in process to be read into memory
t Increase ticks between Dirty Page updates
T Decrease ticks between Dirty Page updates
+, z Zoom in (only in page map view)
-, Z Zoom out (only in page map view)
[ Zoom scale to 1, turn off automatic zoom mode
] Zoom scale to 999, turn off automatic zoom mode
.TE
.SH EXAMPLES
.LP
Monitor the thunderbird process:
.RS 8
sudo pagemon -p thunderbird
.RE
.LP
Monitor process 1 (init), zoom scale of 4:
.RS 8
sudo pagemon -p 1 -z 4
.RE
.SH AUTHOR
pagemon was written by Colin King <[email protected]> with contributions
from Dr. David Alan Gilbert.
.PP
This manual page was written by Colin King <[email protected]>,
for the Ubuntu project (but may be used by others).
.SH COPYRIGHT
Copyright \(co 2016-2021 Canonical Ltd. Copyright \(co 2021-2024 Colin Ian King
.br
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.