pagemon - a tool to monitor memory pages.
Contents
Copyright
Copyright © 2016-2021 Canonical Ltd. Copyright © 2021-2025 Colin Ian King
This is free software; see the source for copying conditions. There is NO warranty; not even for
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
January 12, 2024" PAGEMON(8)
Description
pagemon is a program that allows one to interactively monitor the memory pages of a process.
Examples
Monitor the thunderbird process:
sudo pagemon -p thunderbird
Monitor process 1 (init), zoom scale of 4:
sudo pagemon -p 1 -z 4
Keys
KeyExplanation
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
Name
pagemon - a tool to monitor memory pages.
Options
pagemon options are as follow:
-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.
-ddelay
delay in microseconds between data refreshes, the default is 10,000 microseconds (1/100th of a
second).
-h show help.
-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.
-r read pages into memory. This will force all pages in the process to be read into physical memory.
-tticks
specify ticks between dirty page checks. The default is 60 ticks; the larger the value the longer
time between dirty page checks.
-v enable VM information view. This is equivalent to pressing the 'v' or 'V' key when running
pagemon.
-zzoom
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.
Synopsis
pagemon [options]
