mirror of
https://github.com/RGBCube/serenity
synced 2025-05-20 13:35:07 +00:00
d0f9906c17
Add an option "-A", that will run all of the crash types in the crash program. In this mode, all crash tests are run in a child process so that the crash program does not crash. Crash uses the return status of the child process to ascertain whether the crash happened as expected.
42 lines
1.4 KiB
Markdown
42 lines
1.4 KiB
Markdown
## Name
|
|
|
|
crash - intentionally perform an illegal operation
|
|
|
|
## Synopsis
|
|
|
|
```**sh
|
|
$ crash [options]
|
|
```
|
|
|
|
## Description
|
|
|
|
This program is used to test how the Serenity kernel handles
|
|
userspace crashes, and can be used to simulate many different
|
|
kinds of crashes.
|
|
|
|
## Options
|
|
|
|
* `-A`: Test that all of the following crashes crash as intended.
|
|
* `-s`: Perform a segmentation violation by dereferencing an invalid pointer.
|
|
* `-d`: Perform a division by zero.
|
|
* `-i`: Execute an illegal CPU instruction.
|
|
* `-a`: Call `abort()`.
|
|
* `-m`: Read a pointer from uninitialized memory, then read from it.
|
|
* `-f`: Read a pointer from memory freed using `free()`, then read from it.
|
|
* `-M`: Read a pointer from uninitialized memory, then write to it.
|
|
* `-F`: Read a pointer from memory freed using `free()`, then write to it.
|
|
* `-r`: Write to read-only memory.
|
|
* `-T`: Make a syscall while using an invalid stack pointer.
|
|
* `-t`: Trigger a page fault while using an invalid stack pointer.
|
|
* `-S`: Make a syscall from writeable memory.
|
|
* `-x`: Read from recently freed memory. (Tests an opportunistic malloc guard.)
|
|
* `-y`: Write to recently freed memory. (Tests an opportunistic malloc guard.)
|
|
* `-X`: Attempt to execute non-executable memory. (Not mapped with PROT\_EXEC.)
|
|
|
|
## Examples
|
|
|
|
```sh
|
|
$ crash -F
|
|
Testing: "Write to freed memory"
|
|
Shell: crash(33) exitied due to signal "Segmentation violation"
|
|
```
|