Userland: Introduce the pmemdump utility

This utility helps to dump the physical memory space from /dev/mem. It supports both read(2) and mmap(2) on it so we could use mmap(2) for fast dumping of the memory, or read(2) when we need to read unaligned physical regions.
Author: https://github.com/supercomputer7 Commit: ff25958b51 Pull-request: https://github.com/SerenityOS/serenity/pull/11390 Reviewed-by: https://github.com/ADKaster Reviewed-by: https://github.com/IdanHo ✅
2025-07-28 11:49:44 +00:00 · 2021-12-24 07:04:34 +02:00 · 2021-12-24 07:04:34 +02:00 · ff25958b51 · 2024-07-17 21:27:25 +09:00
commit ff25958b51
parent f7d1b8cd0c
3 changed files with 159 additions and 0 deletions
--- a/Base/usr/share/man/man1/pmemdump.md
+++ b/Base/usr/share/man/man1/pmemdump.md
@ -0,0 +1,38 @@
+## Name
+
+pmemdump - dump physical memory
+
+## Synopsis
+
+```**sh
+$ pmemdump [-r] <offset> <length>
+```
+
+## Description
+
+Dump a portion of the physical memory space.
+
+
+## Options
+
+* `-r`: Dump from /dev/mem with `read(2)` instead of doing `mmap(2)` on it.
+
+## Examples
+
+```sh
+$ pmemdump -r 983040 65536 
+$ pmemdump 983040 65536 
+```
+
+## Notes
+
+The pmemdump utility opens the `/dev/mem` file, and gets a mapping by doing `mmap(2)`
+on it.
+
+Using the `-r` flag might be useful sometimes, especially when reading from an unaligned
+reserved physical memory region when trying to `mmap(2)` `/dev/mem` on the specified
+offset fails.
+
+## See also
+
+* [`mem`(4)](../man4/mem.md)