https://github.com/kdablabs/qmemstat

Inspect Pagemaps of Programs
https://github.com/kdablabs/qmemstat

Last synced: about 8 hours ago
JSON representation

Inspect Pagemaps of Programs

• Host: GitHub
• URL: https://github.com/kdablabs/qmemstat
• Owner: KDABLabs
• License: other
• Created: 2017-11-14T16:37:27.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2017-11-15T09:59:22.000Z (about 7 years ago)
• Last Synced: 2023-09-25T03:06:45.607Z (over 1 year ago)
• Language: C++
• Size: 77.1 KB
• Stars: 8
• Watchers: 9
• Forks: 4
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.GPL.txt

Awesome Lists containing this project

README

        
# QMemstat

**QMemstat** is a tool to **inspect the address space of a process.**

The Linux kernel exposes quite detailed information about the memory pages

that processes use, and information about the pages themselves, which can

be put together to get detailed information about a given process.

qmemstat uses this information from the kernel and shows it in a more

convenient format.

Since the kernel interfaces used are root-only for security reasons,

qmemstat needs to run as root, or at least a "server" needs to run as root

for qmemstat.

## Tools

QMemstat contains two related tools:

### memstat

Command-line tool. It must be run as root.

memstat has two modes:

- display memory use information: `memstat |`

  outputs the following three numbers:

    - VSZ (virtual set size): the size of the address space of the process

    - RSS (resident set size): the size of physical memory in the address

      space of the process

    - PSS (proportional set size): like RSS, but for shared memory pages

      the size is divided by the number of users. This is the most accurate

      "actual memory used" value.

- server mode: `memstat | --server `

  continuously grabs address space information and provides

  it to qmemstat (see below).

### qmemstat

GUI tool which shows information about a process's address space, and

which updates the information continuously.

It has two modes:

- standalone: `qmemstat |` (must be run as root)

  shows a graphical view of the address space of the process. 

    - Hold down

      the left mouse button to see the flags of the page under the cursor

      in the panel on the left.

- as a client to memstat running in server mode (does not need root):

  `qmemstat --client  `

  Otherwise it works like standalone mode.