| Repos | \ndalance/procs | \n
|---|---|
| Views | \n![\"views\"](\"https://views.whatilearened.today/views/github/dalance/procs.svg\") | \n
| Stars | \n![\"stars\"](\"https://img.shields.io/github/stars/dalance/procs?color=f2f08d&logo=Undertale&logoColor=eb4630\") | \n
| Forks | \n![\"forks\"](\"https://img.shields.io/github/forks/dalance/procs?color=ba86eb&logo=Handshake&logoColor=ea6aa6\") | \n
| License | \n![\"license\"](\"https://img.shields.io/github/license/dalance/procs?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAADAAAAAwCAYAAABXAvmHAAAACXBIWXMAAAsTAAALEwEAmpwYAAAD3klEQVR4nO3YSUzUUBgH8JroWVrUGJfEm7sXNcSDFxMTL2pi4sHEgxeNRowXgpEWBDURR%2BNANOKOK66ooKJGBXeEGRcWAcEVFGQRHFwQmH5%2F0wHaeWHI9DUDU5L5knehdOb7zfe%2B19cnCJGIRCQiEYlQB7YJIyGL8aosulVZ6iRFQjiGKkudWg5aLlpOppNXnfPqw5U0DYRJmVxjCgFF3BLuZGmAoVUiKEArmX7D7USgsQporgGa3gHfK4H6cuBbCVD3Gqh1A5%2BLgE%2BFwIenQM0joDofqLoHVNwBym8CpTnAm2zQq0sgdxbIdQZUlAkqPAZ6dgj05ADoYRoofy%2FoXiro7k5QXjLopgzKiQNlLDaqoIguEwBjzqP5PfDjE9DyIXyI63FMTwQFMCVrqwNav4QfoRg58QF%2BfrMHQrEK8DToCMqNAyWNHfxmTRoLOrmSRVgGtDfqCEqZOHQrzo4pbCUsA3416Qi6EQ9KGjcEFRgHOrOKnU6WAb9bGETYekKxCvjTag9E4pje54Dk5QP8bbMHYv%2FC3ueAeJkP0OGxB%2BJpBnArYR8EYQQnoN1ANFaBnPP5l8SrseYQL06Adk0FJY8HOWaBMleAHjh0hPosIzlo8v0A%2F34ZiOeHra0qKRPMVSI7tv%2B92tw%2FvhxUeBRq4VELgM7fBqK5GpRmoQLXNpubTu6zoNRpgT8nPQbq84wd%2FICuvyxiKHqiNAfI3wM6uIhBqGkLiiwAOsKDqOht7Itr9Vy8SjRBEWfyAbr%2FhR1BfpVQFdHJB%2FB2hh7x7j6QpwCVeeYQ2krUB5Clcj6A2m0gWj%2BD0mL49zW5cQyCHLN7rjlmmatEyXX%2FCrTzA%2FoQxZkWl9GJTCVo%2ByTj87%2B4giPKcv0qIHo4AV4D0VZrrQI34pnpRM65xue%2FzAreE4%2FT%2FSoglfEByMsiQtATlL3RAJ5YHrSx6ZDfS70s7uMHhBpR%2FYB5s0PW6oERp1b6%2FfrRhK3SDL5Tie6OQUHQlQ3sVDu%2BzPck9vWE9str%2B6IjS9gHmWPahaDJ%2BwCK6NIBBXsHB9HykXsxwDphlCmAdvplabUJNnZPB94%2FNt6xOe8XzEbP2WhM3WAg1Gub6tH%2B3Q1Pg376R9q4uqlno6gdHGjDOQ90eb01AHM6rYiuUJ1Oq4r4FVuj5vR9BzM9WgNvOywDhiIYQFvgbcfwAfwMvHcaPgBPA%2FDyHGjPbN9A8amebcdwAdD5Nf375txqewNUReoyvwBIXYLdQpWlhwFWqtPaCPD3AsFuASV6qqqIlb0JvkVC1FL9WkLUUlUWK3zXZLFC%2B1%2FBroFto6OsXIuEYJP4DzzW2YFV1oJaAAAAAElFTkSuQmCC\") | \n
| UpdatedAt | \n![\"last-commit\"](\"https://img.shields.io/github/last-commit/dalance/procs?display_timestamp=committer&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAB4AAAAeCAYAAAA7MK6iAAAACXBIWXMAAAsTAAALEwEAmpwYAAAFHUlEQVR4nLVX7U9aVxwm26dlX%2Fdhbx%2B2%2FQnbkvUbrdUAQgJJIfUDNWDTTmOv1FQUFaPJ4kusrV01Jt1sNpctS2u3botZtmxd9tJSFSoqKqIF5bYDFLCovClefstzJ8wXRLDZLznkcO4557n3d3%2FneZ4rEOQZt1WqF%2B8XFr4%2BfOLEe2joY0zwf8ToyZPvjEgkLY%2Bk0mmrXO6dKinxzGk0fjT0x%2BRyr0UqncYczM1rc4tQ%2BIrp2LGXdo4NC4VvWqTS72wqlc%2Br13ORri6KdXdnbOHLlwlzJpRKn6W4%2BK6poOCNnIAfHj%2F%2BwahIZB4vKnqZf0qJpNIql%2Fv8TU0cNl5rbyc3w0QnTp3y2LTaJ7M1NaxDr2fRn1SpPG6Gia21tfE34TcaOay1iMUVOQFbFYqIWSo1W8TiAVanC0evXOEB7Wp14HFb22zE5fqLOC5ERLQWidNaNI4uEcc9i7hcJldHh2NWrQ5gDdbOlpaumIuLb2atAQDPnz0b8NbWcmxVVRJ3HmxpScwwzOJmKDRGe8LlCZDLG9g7TInV1Ql7dbXbV1e3gT0WKirCFomkPyvwXFlZGJOjV6%2BSt64uudDZOU5EUcox%2FMEQDVvt6MbcN27Y3Ayzhv3spaUrB6Z9qrJSO19ezj8p2pLBkJy%2BcCHJxWI5gW5tcfRRz1dU19GfGkou9PZO4smR9jGFwpex4Dy3bvnmKypotbU13VidjqYZhrj49rvMEt%2F%2FYqLz9d00NjW%2Fczgyo9O51zs6aNlo5FDtu0DZgQFhlGXJ0dBADoNhd6uvp6Whoayg7N9LVGH8mD4b%2FHnftUQoNG4vLQ0gixMqlW%2B4qOjtNHDg3r1f6YiRSGxRy7UvqLb9U4qkqnxPONva5lDpHr1%2ByyKRNKWBZy5edMUHB2m5ry%2B%2BEQw%2Bzgf4zo9%2F0ocN3WRzLBw4J%2BJyPWCrqmIgGYtUOsWD4oxZFQoPUjGpVHqI4%2FafkQPC6fZQeeM1%2BvLuIQnjuBWQDDCscrmHP9eoNPAtBqfOnXuaK%2Bh6JEbGrs%2BpvvMmxeIbh863abVPeYySEo9FJHpNMFJY%2BP5cWZkfg7O1tSwYCeSQLTY3E8Q09%2FBVPJUlxQjshT1BscCY02r9UDUBfvCHB66pcfPA3lyAe3ngr3%2F47XDgaJzsly7xwA6NZtlUUPCuAHqaSjUIP%2Bsue8BRWAC%2FNfQ7JZPZ59s0Gj7VtpISz4hQ%2BCpfXGMKhZcvLpUKxfWM8ohvf7p%2FODjHBfcVF8Isk82g1FHykcVFE%2BUZAAX47aE%2FMl4PO50Pnuh0%2Fx4nmcyWPsdwDhBx6CmkLV%2FgFDjYKxOJOFtb0wQyIhL9RyCwK3AOfIGp1YFEBhnMJcLRWEbKdKQoU6ncTZkIEDicAy%2F81dVuEM5RwPfey4xOx0Ik%2FI2NnFki%2BWafOoFIYFcgYZCyxd7eCUjbc4AmF65ft%2FkMhk3o%2B5hc7sMJyqjJEGvYFaQFIr7Y0wPw8BFAY%2B6%2Bvmk3w6zzRuDMmZVRsfh8RtA0uETSD7uCBT6DYQN6iveU0fpkYLjE6qrVrtOxeNKU9THLZJ9kBU2JBsBhV5AivB%2FoKaQNKgPCBwDYaIfZC4adThOqF4WENViLJwVoXobfLBKVw67AOaTsLc65TaVK21vQ4La99eKcYg5vbxsbObzTQ9N7UKDgUO1wDjiDIIBshh5ztg39nQMLSZBH4OzBOUDEQXm206d3fcLgswbXQA4PhcK3nhswU1Bz8wvQ09RHG%2FoYy3ejfwBNmtoYqLA0XgAAAABJRU5ErkJggg%3D%3D&label=UpdatedAt\") | \n
| CreatedAt | \n![\"create-at\"](\"https://img.shields.io/github/created-at/dalance/procs?logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAAB4AAAAeCAYAAAA7MK6iAAAACXBIWXMAAAsTAAALEwEAmpwYAAAFHUlEQVR4nLVX7U9aVxwm26dlX%2Fdhbx%2B2%2FQnbkvUbrdUAQgJJIfUDNWDTTmOv1FQUFaPJ4kusrV01Jt1sNpctS2u3botZtmxd9tJSFSoqKqIF5bYDFLCovClefstzJ8wXRLDZLznkcO4557n3d3%2FneZ4rEOQZt1WqF%2B8XFr4%2BfOLEe2joY0zwf8ToyZPvjEgkLY%2Bk0mmrXO6dKinxzGk0fjT0x%2BRyr0UqncYczM1rc4tQ%2BIrp2LGXdo4NC4VvWqTS72wqlc%2Br13ORri6KdXdnbOHLlwlzJpRKn6W4%2BK6poOCNnIAfHj%2F%2BwahIZB4vKnqZf0qJpNIql%2Fv8TU0cNl5rbyc3w0QnTp3y2LTaJ7M1NaxDr2fRn1SpPG6Gia21tfE34TcaOay1iMUVOQFbFYqIWSo1W8TiAVanC0evXOEB7Wp14HFb22zE5fqLOC5ERLQWidNaNI4uEcc9i7hcJldHh2NWrQ5gDdbOlpaumIuLb2atAQDPnz0b8NbWcmxVVRJ3HmxpScwwzOJmKDRGe8LlCZDLG9g7TInV1Ql7dbXbV1e3gT0WKirCFomkPyvwXFlZGJOjV6%2BSt64uudDZOU5EUcox%2FMEQDVvt6MbcN27Y3Ayzhv3spaUrB6Z9qrJSO19ezj8p2pLBkJy%2BcCHJxWI5gW5tcfRRz1dU19GfGkou9PZO4smR9jGFwpex4Dy3bvnmKypotbU13VidjqYZhrj49rvMEt%2F%2FYqLz9d00NjW%2Fczgyo9O51zs6aNlo5FDtu0DZgQFhlGXJ0dBADoNhd6uvp6Whoayg7N9LVGH8mD4b%2FHnftUQoNG4vLQ0gixMqlW%2B4qOjtNHDg3r1f6YiRSGxRy7UvqLb9U4qkqnxPONva5lDpHr1%2ByyKRNKWBZy5edMUHB2m5ry%2B%2BEQw%2Bzgf4zo9%2F0ocN3WRzLBw4J%2BJyPWCrqmIgGYtUOsWD4oxZFQoPUjGpVHqI4%2FafkQPC6fZQeeM1%2BvLuIQnjuBWQDDCscrmHP9eoNPAtBqfOnXuaK%2Bh6JEbGrs%2BpvvMmxeIbh863abVPeYySEo9FJHpNMFJY%2BP5cWZkfg7O1tSwYCeSQLTY3E8Q09%2FBVPJUlxQjshT1BscCY02r9UDUBfvCHB66pcfPA3lyAe3ngr3%2F47XDgaJzsly7xwA6NZtlUUPCuAHqaSjUIP%2Bsue8BRWAC%2FNfQ7JZPZ59s0Gj7VtpISz4hQ%2BCpfXGMKhZcvLpUKxfWM8ohvf7p%2FODjHBfcVF8Isk82g1FHykcVFE%2BUZAAX47aE%2FMl4PO50Pnuh0%2Fx4nmcyWPsdwDhBx6CmkLV%2FgFDjYKxOJOFtb0wQyIhL9RyCwK3AOfIGp1YFEBhnMJcLRWEbKdKQoU6ncTZkIEDicAy%2F81dVuEM5RwPfey4xOx0Ik%2FI2NnFki%2BWafOoFIYFcgYZCyxd7eCUjbc4AmF65ft%2FkMhk3o%2B5hc7sMJyqjJEGvYFaQFIr7Y0wPw8BFAY%2B6%2Bvmk3w6zzRuDMmZVRsfh8RtA0uETSD7uCBT6DYQN6iveU0fpkYLjE6qrVrtOxeNKU9THLZJ9kBU2JBsBhV5AivB%2FoKaQNKgPCBwDYaIfZC4adThOqF4WENViLJwVoXobfLBKVw67AOaTsLc65TaVK21vQ4La99eKcYg5vbxsbObzTQ9N7UKDgUO1wDjiDIIBshh5ztg39nQMLSZBH4OzBOUDEQXm206d3fcLgswbXQA4PhcK3nhswU1Bz8wvQ09RHG%2FoYy3ejfwBNmtoYqLA0XgAAAABJRU5ErkJggg%3D%3D&label=CreatedAt\") | \n
![](\"https://cdn.jsdelivr.net/gh/eryajf/tu@main/img/image_20240420_214408.gif\")
\n| Repos | \ndalance/procs | \n
|---|---|
| Views | \n | \n
| Stars | \n | \n
| Forks | \n | \n
| License | \n | \n
| UpdatedAt | \n | \n
| CreatedAt | \n | \n
\nprocs is a replacement for ps written in Rust.
![\"Actions](\"https://github.com/dalance/procs/workflows/Regression/badge.svg\"){kind=icon}
\n
\n
\n
![\"Changelog\"](\"https://img.shields.io/badge/changelog-v0.14.10-green.svg\"){kind=icon}
![\"Crates.io\"](\"https://img.shields.io/crates/v/procs.svg\")
![\"procs\"](\"https://snapcraft.io/procs/badge.svg\"){kind=icon}
![\"homebrew\"](\"https://img.shields.io/homebrew/v/procs.svg\")
ps\ntop)Download from release page, and extract to the directory in PATH.
\n![\"Packaging](\"https://repology.org/badge/vertical-allrepos/procs.svg?columns=3\"){kind=icon}
You can install from Nixpkgs.
\nnix-env --install procs\nYou can install from snapcraft.
\nsudo snap install procs\nYou can install from homebrew.
\nbrew install procs\nYou can install from MacPorts.
\nsudo port install procs\nYou can install from the Alpine Linux repository.
\nThe correct repository (see above link for the most up-to-date information) should be enabled before apk add.
sudo apk add procs\nYou can install from the Arch Linux extra repository.
\nsudo pacman -S procs\nYou can install with scoop.
\nscoop install procs\nsudo dnf install procs\nwinget install procs\nYou can install with rpm.
\nsudo rpm -i https://github.com/dalance/procs/releases/download/v0.14.10/procs-0.14.10-1.x86_64.rpm\nYou can install with cargo.
\ncargo install procs\nYou can install with x-cmd.
\nx env use procs\n# or\nx procs # Download procs, and invoke procs in a way that does not affect the current environment\nOn macOS, normal users can't access any information on other users' processes.
\nOn Linux, normal users can't access some information (ex. Read/Write throughput) of other users.
If you want to show this information, you should use sudo.
$ sudo procs\n[sudo] password for ...:If you want to skip password input, you can add the following entry to /etc/sudoers.
[user or group] ALL= NOPASSWD: [procs binary path]\n// ex. myuser ALL= NOPASSWD: /usr/local/bin/procs\nIn the following screenshots, config/large.toml is used as the configuration.
Type procs only. It shows the information of all processes.
procs![\"procs\"](\"https://user-images.githubusercontent.com/4331004/55446625-5e5fce00-55fb-11e9-8914-69e8640d89d7.png\")
If you add any keyword as argument, it is matched to USER, Command by default.
procs zshIf you want to add columns matching to non-numeric keyword, nonnumeric_search option can be used in configuration file.
![\"procs_zsh\"](\"https://user-images.githubusercontent.com/4331004/55446648-71729e00-55fb-11e9-8e12-1ca63911c568.png\")
If a numeric is used as the keyword, it is matched to PID by default.
\nNumeric is treated as exact match, and non-numeric is treated as partial match by default.
procs --or 6000 60000 60001 16723If you want to add columns matching to numeric keyword, numeric_search option can be used in configuration file.
![\"procs_port\"](\"https://user-images.githubusercontent.com/4331004/55446667-83ecd780-55fb-11e9-8959-53209837c4ee.png\")
Note that procfs permissions only allow identifying listening ports for processes owned by the current user, so not all ports will show up unless run as root.
\nIf there are some keywords, logical operation between the keywords can be specified by commandline option.
\n--and : The processes that match with all keywords are shown.--or : The processes that match with any keyword are shown.--nand: The processes are shown unless these match with all keywords.--nor : The processes are shown unless these match with any keyword.The default operation can be specified in the configuration file. See [search] section.
If you have access permission to docker daemon ( unix:///var/run/docker.sock ), Docker column is added.
procs growi![\"procs_docker\"](\"https://user-images.githubusercontent.com/4331004/55446681-91a25d00-55fb-11e9-943d-5b5caeb23c62.png\")
Note that procs gets the container information through UNIX domain socket, so Docker Toolbox on macOS (doesn't use UNIX domain socket) is not supported.
\nDocker Desktop for Mac is supported but not tested.
If output lines exceed terminal height, pager is used automatically.
\nThis behavior and pager command can be specified by configuration file.
On Linux and macOS, less is the default pager.
\nIf there is not less, more is used.
\nInstead of them, built-in pager can be used by configuration use_builtin.
On Windows, built-in pager is always used.
\nIf --watch or --watch-interval <second> option is used, procs automatically updates output like top.
\nIf --watch is used, the update interval becomes 1s.
\nThe update interval can be specified by the argument of --watch-interval.
\nThere are some keyboard shortcuts to control.
n: Change the sort column to the next columnp: Change the sort column to the previous columna: Change the sort order to ascendingd: Change the sort order to descendingq: QuitIf --tree option is used, processes are sorted by dependency order and dependency tree is shown at left side.
procs --tree![\"procs_tree\"](\"https://user-images.githubusercontent.com/4331004/55446692-9ff07900-55fb-11e9-8b66-a8432df0a8e1.png\")
If TreeSlot column exists in config, dependency tree is shown at the slot.
Column sort order can be changed by --sorta or --sortd option.
\nThe last character of --sorta and --sortd means sort order: \"a\"scending and \"d\"escending.
The column for sort is selected by the option keyword.
\nThe keyword is matched with column kind that is shown by --list option.
\nIf --sorta cputime, column is sorted by CpuTime with ascending order.
\nIf --sortd rss, column is sorted by VmRss with descending order.
\nThe keyword is matched partially and case is ignored.
The default sort is specified by [sort] section in the configuration file.
procs --sortd cpu![\"procs_sort\"](\"https://user-images.githubusercontent.com/4331004/55446704-ab43a480-55fb-11e9-81dc-e3ac1a1e2507.png\")
--insert option inserts new column to the position of Slot column or MultiSlot column.
\nThe column for insert is selected by the option keyword.
\nThe keyword is the same as sort option.
\nA Slot column can be used by an inserted column.
\nIf many insertions are required, many Slot columns should be added.
\nA MultiSlot column can be used by many inserted columns.
\nIf there is a MultiSlot, all the remaining columns are inserted to the MultiSlot, and the subsequent Slot / MultiSlot is not used.
\nUnused Slot / MultiSlot is not shown.
--gen-completion option generates shell completion files under the current directory.
\nThe following shells are supported.
zshbashfishpowershellelvish--gen-completion-out option generates shell completion to stdout.
\nYou can source it directly on some shells.
source <(procs --gen-completion-out bash)You can change configuration by writing a configuration file.
\nThere are some configuration examples in config directory of this repository.
\nconfig/large.toml is the default configuration before procs v0.9.21.
The locations of the configuration file is OS-specific:
\n~/.config/procs/config.toml, /etc/procs/procs.toml~/Library/Preferences/com.github.dalance.procs/config.toml, /etc/procs/procs.toml~/AppData/Roaming/dalance/procs/config/config.tomlFor compatibility, if ~/.procs.toml exists, it will be preferred to
\nthe OS-specific locations.
--use-config option can specify a built-in configuration.
\n--load-config option can specify a configuration file path.
The complete example of a configuration file can be generated by --gen-config option.
[[columns]]\nkind = \"Pid\"\nstyle = \"BrightYellow|Yellow\"\nnumeric_search = true\nnonnumeric_search = false\n\n[[columns]]\nkind = \"Username\"\nstyle = \"BrightGreen|Green\"\nnumeric_search = false\nnonnumeric_search = true\nalign = \"Right\"\n\n[style]\nheader = \"BrightWhite|Black\"\nunit = \"BrightWhite|Black\"\ntree = \"BrightWhite|Black\"\n\n[style.by_percentage]\ncolor_000 = \"BrightBlue|Blue\"\ncolor_025 = \"BrightGreen|Green\"\ncolor_050 = \"BrightYellow|Yellow\"\ncolor_075 = \"BrightRed|Red\"\ncolor_100 = \"BrightRed|Red\"\n\n[style.by_state]\ncolor_d = \"BrightRed|Red\"\ncolor_r = \"BrightGreen|Green\"\ncolor_s = \"BrightBlue|Blue\"\ncolor_t = \"BrightCyan|Cyan\"\ncolor_z = \"BrightMagenta|Magenta\"\ncolor_x = \"BrightMagenta|Magenta\"\ncolor_k = \"BrightYellow|Yellow\"\ncolor_w = \"BrightYellow|Yellow\"\ncolor_p = \"BrightYellow|Yellow\"\n\n[style.by_unit]\ncolor_k = \"BrightBlue|Blue\"\ncolor_m = \"BrightGreen|Green\"\ncolor_g = \"BrightYellow|Yellow\"\ncolor_t = \"BrightRed|Red\"\ncolor_p = \"BrightRed|Red\"\ncolor_x = \"BrightBlue|Blue\"\n\n[search]\nnumeric_search = \"Exact\"\nnonnumeric_search = \"Partial\"\nlogic = \"And\"\n\n[display]\nshow_self = false\nshow_thread = false\nshow_thread_in_tree = true\ncut_to_terminal = true\ncut_to_pager = false\ncut_to_pipe = false\ncolor_mode = \"Auto\"\n\n[sort]\ncolumn = 0\norder = \"Ascending\"\n\n[docker]\npath = \"unix:///var/run/docker.sock\"\n\n[pager]\nmode = \"Auto\"[[columns]] section[[columns]] section defines which columns are used.
\nThe first [[columns]] is shown at left side, and the last is shown at right side.
| Key | \nValue | \nDefault | \nDescription | \n
|---|---|---|---|
| kind | \nSee kind list | \n\n | Column type | \n
| style | \nSee style list | \n\n | Column style | \n
| numeric_search | \ntrue, false | \nfalse | \nWhether the column can be matched with numeric keywords | \n
| nonnumeric_search | \ntrue, false | \nfalse | \nWhether the column can be matched with non-numeric keywords | \n
| align | \nLeft, Right, Center | \nLeft | \nText alignment | \n
| max_width | \n[Number] | \n\n | Maximum column width | \n
| min_width | \n[Number] | \n\n | Minimum column width | \n
| header | \n[String] | \n\n | Alternate header description | \n
kind listprocs kind | \nps STANDARD FORMAT | \nDescription | \nLinux | \nmacOS | \nWindows | \nFreeBSD | \n
|---|---|---|---|---|---|---|
| Arch | \n-not supported- | \nArchitecture of binary (macOS specific) | \n\n | o | \n\n | \n |
| Ccgroup | \n-not supported- | \nControl group by compressed format | \no | \n\n | \n | \n |
| Cgroup | \ncgroup | \nControl group | \no | \n\n | \n | \n |
| Command | \nargs | \nCommand with all arguments | \no | \no | \no | \no | \n
| ContextSw | \n-not supported- | \nContext switch count | \no | \no | \n\n | o | \n
| CpuTime | \ncputime | \nCumulative CPU time | \no | \no | \no | \no | \n
| Docker | \n-not supported- | \nDocker container name | \no | \no | \n\n | \n |
| Eip | \neip | \nInstruction pointer | \no | \n\n | \n | \n |
| ElapsedTime | \n-not supported- | \nElapsed time | \no | \no | \no | \no | \n
| Env | \ne output modifier | \nEnvironment variables | \no | \n\n | \n | o | \n
| Esp | \nesp | \nStack pointer | \no | \n\n | \n | \n |
| FileName | \ncomm | \nFile name | \no | \n\n | \n | o | \n
| Gid | \negid | \nGroup ID | \no | \no | \no | \no | \n
| GidFs | \nfgid | \nFile system group ID | \no | \n\n | \n | \n |
| GidReal | \nrgid | \nReal group ID | \no | \no | \n\n | o | \n
| GidSaved | \nsgid | \nSaved group ID | \no | \no | \n\n | o | \n
| Group | \negroup | \nGroup name | \no | \no | \no | \no | \n
| GroupFs | \nfgroup | \nFile system group name | \no | \n\n | \n | \n |
| GroupReal | \nrgroup | \nReal group name | \no | \no | \n\n | o | \n
| GroupSaved | \nsgroup | \nSaved group name | \no | \no | \n\n | o | \n
| MajFlt | \nmaj_flt | \nMajor page fault count | \no | \no | \no | \no | \n
| MinFlt | \nmin_flt | \nMinor page fault count | \no | \no | \n\n | o | \n
| MultiSlot | \n-not supported- | \nSlot for --insert option | \no | \no | \no | \no | \n
| Nice | \nni | \nNice value | \no | \no | \n\n | o | \n
| Pgid | \npgid | \nProcess group ID | \no | \no | \n\n | o | \n
| Pid | \npid | \nProcess ID ( or Thread ID sorrunded by [] ) | \no | \no | \no | \no | \n
| Policy | \npolicy | \nScheduling policy | \no | \no | \n\n | \n |
| Ppid | \nppid | \nParent process ID | \no | \no | \no | \no | \n
| Priority | \npri | \nPriority | \no | \no | \no | \no | \n
| Processor | \npsr | \nCurrently assigned processor | \no | \n\n | \n | o | \n
| ReadBytes | \n-not supported- | \nRead bytes from storage | \no | \no | \no | \no | \n
| RtPriority | \nrtprio | \nReal-time priority | \no | \n\n | \n | \n |
| SecContext | \nlabel | \nSecurity context | \no | \n\n | \n | \n |
| Separator | \n-not supported- | \nShow | for column separation | \no | \no | \no | \no | \n
| Session | \nsid | \nSession ID | \no | \no | \n\n | o | \n
| ShdPnd | \npending | \nPending signal mask for process | \no | \n\n | \n | o | \n
| SigBlk | \nblocked | \nBlocked signal mask | \no | \n\n | \n | o | \n
| SigCgt | \ncaught | \nCaught signal mask | \no | \n\n | \n | o | \n
| SigIgn | \nignored | \nIgnored signal mask | \no | \n\n | \n | o | \n
| SigPnd | \npending | \nPending signal mask for thread | \no | \n\n | \n | \n |
| Slot | \n-not supported- | \nSlot for --insert option | \no | \no | \no | \no | \n
| Ssb | \n-not supported- | \nSpeculative store bypass status | \no | \n\n | \n | \n |
| StartTime | \nstart_time | \nStarting time | \no | \no | \no | \no | \n
| State | \ns | \nProcess state | \no | \no | \n\n | o | \n
| TcpPort | \n-not supported- | \nBound TCP ports | \no | \no | \n\n | \n |
| Threads | \nnlwp | \nThread count | \no | \no | \n\n | o | \n
| TreeSlot | \n-not supported- | \nSlot for tree column | \no | \no | \no | \no | \n
| Tty | \ntty | \nControlling TTY | \no | \no | \n\n | o | \n
| UdpPort | \n-not supported- | \nBound UDP ports | \no | \no | \n\n | \n |
| Uid | \neuid | \nUser ID | \no | \no | \no | \no | \n
| UidFs | \nfuid | \nFile system user ID | \no | \n\n | \n | \n |
| UidLogin | \n-not supported- | \nLogin user ID | \no | \n\n | \n | \n |
| UidReal | \nruid | \nReal user ID | \no | \no | \n\n | o | \n
| UidSaved | \nsuid | \nSaved user ID | \no | \no | \n\n | o | \n
| UsageCpu | \n%cpu | \nCPU utilization | \no | \no | \no | \no | \n
| UsageMem | \n%mem | \nMemory utilization | \no | \no | \no | \no | \n
| User | \neuser | \nUser name | \no | \no | \no | \no | \n
| UserFs | \nfuser | \nFile system user name | \no | \n\n | \n | \n |
| UserLogin | \n-not supported- | \nLogin user name | \no | \n\n | \n | \n |
| UserReal | \nruser | \nReal user name | \no | \no | \n\n | o | \n
| UserSaved | \nsuser | \nSaved user name | \no | \no | \n\n | o | \n
| VmData | \n-not supported- | \nData size | \no | \n\n | \n | o | \n
| VmExe | \ntrs | \nText segments size | \no | \n\n | \n | o | \n
| VmHwm | \n-not supported- | \nPeak resident set size | \no | \n\n | o | \no | \n
| VmLib | \n-not supported- | \nLibrary code size | \no | \n\n | \n | \n |
| VmLock | \n-not supported- | \nLocked memory size | \no | \n\n | \n | \n |
| VmPeak | \n-not supported- | \nPeak virtual memory size | \no | \n\n | o | \n\n |
| VmPin | \n-not supported- | \nPinned memory size | \no | \n\n | o | \n\n |
| VmPte | \n-not supported- | \nPage table entries size | \no | \n\n | \n | \n |
| VmRss | \nrss | \nResident set size | \no | \no | \no | \no | \n
| VmSize | \nvsz | \nPhysical page size | \no | \no | \no | \no | \n
| VmStack | \n-not supported- | \nStack size | \no | \n\n | \n | o | \n
| VmSwap | \n-not supported- | \nSwapped-out virtual memory size | \no | \n\n | o | \n\n |
| Wchan | \nwchan | \nProcess sleeping kernel function | \no | \n\n | \n | o | \n
| WorkDir | \n-not supported- | \nCurrent working directory | \no | \n\n | \n | \n |
| WriteByte | \n-not supported- | \nWrite bytes to storage | \no | \no | \no | \no | \n
style listThere are some special styles like ByPercentage, ByState, ByUnit.
\nThese are the styles for value-aware coloring.
\nFor example, if ByUnit is chosen, color can be specified for each unit of value ( like K, M, G,,, ).
\nThe colors can be configured in [style.by_unit] section.
Other colors can be configured as the same as color.
[style] section[style] section defines colors of header, unit and each styles.
\nThe available list of color is below.
| Subsection | \nKey | \nValue | \nDefault | \nDescription | \n
|---|---|---|---|---|
| \n | header | \nSee color list | \nBrightWhite|Black | \nHeader color | \n
| \n | unit | \nSee color list | \nBrightWhite|Black | \nUnit color | \n
| \n | tree | \nSee color list | \nBrightWhite|Black | \nTree color | \n
| by_percentage | \ncolor_000 | \nSee color list | \nBrightBlue|Blue | \nColor at 0% - 25% | \n
| by_percentage | \ncolor_025 | \nSee color list | \nBrightGreen|Green | \nColor at 25% - 50% | \n
| by_percentage | \ncolor_050 | \nSee color list | \nBrightYellow|Yellow | \nColor at 50% - 75% | \n
| by_percentage | \ncolor_075 | \nSee color list | \nBrightRed|Red | \nColor at 75% - 100% | \n
| by_percentage | \ncolor_100 | \nSee color list | \nBrightRed|Red | \nColor at 100% - | \n
| by_state | \ncolor_d | \nSee color list | \nBrightRed|Red | \nColor at D state | \n
| by_state | \ncolor_r | \nSee color list | \nBrightGreen|Green | \nColor at R state | \n
| by_state | \ncolor_s | \nSee color list | \nBrightBlue|Blue | \nColor at S state | \n
| by_state | \ncolor_t | \nSee color list | \nBrightCyan|Cyan | \nColor at T state | \n
| by_state | \ncolor_z | \nSee color list | \nBrightMagenta|Magenta | \nColor at Z state | \n
| by_state | \ncolor_x | \nSee color list | \nBrightMagenta|Magenta | \nColor at X state | \n
| by_state | \ncolor_k | \nSee color list | \nBrightYellow|Yellow | \nColor at K state | \n
| by_state | \ncolor_w | \nSee color list | \nBrightYellow|Yellow | \nColor at W state | \n
| by_state | \ncolor_p | \nSee color list | \nBrightYellow|Yellow | \nColor at P state | \n
| by_unit | \ncolor_k | \nSee color list | \nBrightBlue|Blue | \nColor at unit K | \n
| by_unit | \ncolor_m | \nSee color list | \nBrightGreen|Green | \nColor at unit M | \n
| by_unit | \ncolor_g | \nSee color list | \nBrightYellow|Yellow | \nColor at unit G | \n
| by_unit | \ncolor_t | \nSee color list | \nBrightRed|Red | \nColor at unit T | \n
| by_unit | \ncolor_p | \nSee color list | \nBrightRed|Red | \nColor at unit P | \n
| by_unit | \ncolor_x | \nSee color list | \nBrightBlue|Blue | \nColor at other unit | \n
color listColors can be configured by theme through |.
style = \"BrightWhite|Black\" # BrightWhite for dark theme and Black for light theme\nstyle = \"BrightWhite\" # BrightWhite for both themeThe first color is for dark theme, and the second is for light theme.
\nIf only a color is specified, the color is applied to both theme.
Color256 can be specified by 0-255 value like below:
style = \"223|112\" # 223 for dark theme and 112 for light theme\nstyle = \"223\" # 223 for both theme[search] section[search] section defines option for Keyword search.
| Key | \nValue | \nDefault | \nDescription | \n
|---|---|---|---|
| numeric_search | \nExact, Partial | \nExact | \nWhether numeric keywords match exactly or partially | \n
| nonnumeric_search | \nExact, Partial | \nPartial | \nWhether non-numeric keywords match exactly or partially | \n
| logic | \nAnd, Or, Nand, Nor | \nAnd | \nLogical operation between keywords | \n
| case | \nSmart, Insensitive, Sensitive | \nSmart | \nCase sensitivity in search | \n
casecase is case sensitivity in search.
Smart: If keyword contains uppercase character, case sensitive search. Otherwise case insensitive searchInsensitive: case insensitive searchSensitive: case sensitive search[display] section[display] section defines option for output display.
| Key | \nValue | \nDefault | \nDescription | \n
|---|---|---|---|
| show_self | \ntrue, false | \nfalse | \nWhether the self process ( procs ) is shown | \n
| show_self_parents | \ntrue, false | \nfalse | \nWhether the parents which have self as the only child process are shown | \n
| show_thread | \ntrue, false | \nfalse | \nWhether the thread information is shown ( Linux only ) | \n
| show_thread_in_tree | \ntrue, false | \ntrue | \nWhether the thread information is shown in tree mode ( Linux only ) | \n
| show_parent_in_tree | \ntrue, false | \ntrue | \nWhether the parent process is shown in tree mode | \n
| show_children_in_tree | \ntrue, false | \ntrue | \nWhether the children processes are shown in tree mode | \n
| show_header | \ntrue, false | \ntrue | \nWhether header row is shown | \n
| show_footer | \ntrue, false | \nfalse | \nWhether footer row is shown | \n
| show_kthreads | \ntrue, false | \ntrue | \nWhether processes which belong to kthread are shown ( Linux only ) | \n
| cut_to_terminal | \ntrue, false | \ntrue | \nWhether output lines are truncated for output into terminal | \n
| cut_to_pager | \ntrue, false | \nfalse | \nWhether output lines are truncated for output into pager | \n
| cut_to_pipe | \ntrue, false | \nfalse | \nWhether output lines are truncated for output into pipe | \n
| color_mode | \nAuto, Always, Disable | \nAuto | \nThe default behavior of output coloring without --color commandline option | \n
| separator | \n[String] | \n│ | \nString used as Separator | \n
| ascending | \n[String] | \n▲ | \nAscending sort indicator | \n
| descending | \n[String] | \n▼ | \nDescending sort indicator | \n
| tree_symbols | \n[String; 5] | \n[│, ─, ┬, ├, └] | \nSymbols used by tree view | \n
| abbr_sid | \ntrue, false | \ntrue | \nWhether machine SID is abbreviated ( Windows only ) | \n
| theme | \nAuto, Dark, Light | \nAuto | \nDefault theme | \n
If color_mode is Auto, color is enabled for terminal and pager, disabled for pipe.
If theme is Auto, theme is detected from terminal automatically.
\nSome terminal don't support the automatic detection, so Dark or Light can be specified explicitly.
abbr_sidWindows SID is too long, so it is abbreviated by default.
\nIf abbr_sid is false, SID is fully shown like below:
S-1-5-21-789457439-2186958450-1652286173-1001\nIf abbr_sid is true, SID is shown like below:
S-1-5-21-...-1001\n[sort] section[sort] section defines the column used for sort and sort order.
| Key | \nValue | \nDefault | \nDescription | \n
|---|---|---|---|
| column | \n[Number] | \n0 | \nColumn number to used for sort | \n
| order | \nAscending, Descending | \nAscending | \nSort order | \n
If column is 0, value is sorted by the left column.
[docker] section[docker] section defines how to communicate to docker daemon.
| Key | \nValue | \nDefault | \nDescription | \n
|---|---|---|---|
| path | \n[Path] | \nunix:///var/run/docker.sock | \nUNIX domain socket to docker daemon | \n
[pager] section[pager] section defines the behavior of pager.
| Key | \nValue | \nDefault | \nDescription | \n
|---|---|---|---|
| mode | \nAuto, Always, Disable | \nAuto | \nThe default behavior of pager usage without --pager commandline option | \n
| detect_width | \ntrue, false | \nfalse | \nWhether auto mode detects terminal width overflow | \n
| use_builtin | \ntrue, false | \nfalse | \nWhether built-in pager is used | \n
| command | \n[Command] | \nless -SR | \nPager command | \n
If mode is Auto, pager is used only when output lines exceed terminal height.
\nDefault pager is less -SR ( if less is not found, more -f ).