tyler.durden/bottom
1
0
Fork 0
mirror of https://github.com/ClementTsang/bottom.git synced 2025-08-21 01:28:31 +02:00
Code Issues Packages Projects Releases Wiki Activity
bottom/nightly/usage/widgets/process/index.html

2456 lines
60 KiB
HTML
Raw Permalink Blame History

<!doctype html>
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="description" content="A customizable cross-platform graphical process/system monitor for the terminal. Supports Linux, macOS, and Windows.">
<meta name="author" content="Clement Tsang">
<link rel="canonical" href="https://clementtsang.github.io/bottom/stable/usage/widgets/process/">
<link rel="prev" href="../network/">
<link rel="next" href="../disk/">
<link rel="icon" href="../../../assets/images/favicon.png">
<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.6.16">
<title>Process Widget - bottom</title>
<link rel="stylesheet" href="../../../assets/stylesheets/main.7e37652d.min.css">
<link rel="stylesheet" href="../../../assets/stylesheets/palette.06af60db.min.css">
<link rel="stylesheet" href="../../../assets/external/fonts.googleapis.com/css.5be84a27.css">
<style>:root{--md-text-font:"Roboto";--md-code-font:"IBM Plex Mono"}</style>
<link rel="stylesheet" href="../../../stylesheets/extra.css">
<script>__md_scope=new URL("../../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
</head>
<body dir="ltr" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo">
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" for="__drawer"></label>
<div data-md-component="skip">
<a href="#process-widget" class="md-skip">
Skip to content
</a>
</div>
<div data-md-component="announce">
</div>
<div data-md-color-scheme="default" data-md-component="outdated" hidden>
</div>
<header class="md-header" data-md-component="header">
<nav class="md-header__inner md-grid" aria-label="Header">
<a href="../../.." title="bottom" class="md-header__button md-logo" aria-label="bottom" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
</a>
<label class="md-header__button md-icon" for="__drawer">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
</label>
<div class="md-header__title" data-md-component="header-title">
<div class="md-header__ellipsis">
<div class="md-header__topic">
<span class="md-ellipsis">
bottom
</span>
</div>
<div class="md-header__topic" data-md-component="header-topic">
<span class="md-ellipsis">
Process Widget
</span>
</div>
</div>
</div>
<form class="md-header__option" data-md-component="palette">
<input class="md-option" data-md-color-media="(prefers-color-scheme)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">
<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m14.3 16-.7-2h-3.2l-.7 2H7.8L11 7h2l3.2 9zM20 8.69V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12zm-9.15 3.96h2.3L12 9z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="indigo" data-md-color-accent="indigo" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">
<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_2" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 7a5 5 0 0 1 5 5 5 5 0 0 1-5 5 5 5 0 0 1-5-5 5 5 0 0 1 5-5m0 2a3 3 0 0 0-3 3 3 3 0 0 0 3 3 3 3 0 0 0 3-3 3 3 0 0 0-3-3m0-7 2.39 3.42C13.65 5.15 12.84 5 12 5s-1.65.15-2.39.42zM3.34 7l4.16-.35A7.2 7.2 0 0 0 5.94 8.5c-.44.74-.69 1.5-.83 2.29zm.02 10 1.76-3.77a7.131 7.131 0 0 0 2.38 4.14zM20.65 7l-1.77 3.79a7.02 7.02 0 0 0-2.38-4.15zm-.01 10-4.14.36c.59-.51 1.12-1.14 1.54-1.86.42-.73.69-1.5.83-2.29zM12 22l-2.41-3.44c.74.27 1.55.44 2.41.44.82 0 1.63-.17 2.37-.44z"/></svg>
</label>
<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="black" data-md-color-accent="indigo" aria-label="Switch to system preference" type="radio" name="__palette" id="__palette_2">
<label class="md-header__button md-icon" title="Switch to system preference" for="__palette_0" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="m17.75 4.09-2.53 1.94.91 3.06-2.63-1.81-2.63 1.81.91-3.06-2.53-1.94L12.44 4l1.06-3 1.06 3zm3.5 6.91-1.64 1.25.59 1.98-1.7-1.17-1.7 1.17.59-1.98L15.75 11l2.06-.05L18.5 9l.69 1.95zm-2.28 4.95c.83-.08 1.72 1.1 1.19 1.85-.32.45-.66.87-1.08 1.27C15.17 23 8.84 23 4.94 19.07c-3.91-3.9-3.91-10.24 0-14.14.4-.4.82-.76 1.27-1.08.75-.53 1.93.36 1.85 1.19-.27 2.86.69 5.83 2.89 8.02a9.96 9.96 0 0 0 8.02 2.89m-1.64 2.02a12.08 12.08 0 0 1-7.8-3.47c-2.17-2.19-3.33-5-3.49-7.82-2.81 3.14-2.7 7.96.31 10.98 3.02 3.01 7.84 3.12 10.98.31"/></svg>
</label>
</form>
<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
<label class="md-header__button md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
</label>
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
<label class="md-search__icon md-icon" for="__search">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
</label>
<nav class="md-search__options" aria-label="Search">
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
</button>
</nav>
<div class="md-search__suggest" data-md-component="search-suggest"></div>
</form>
<div class="md-search__output">
<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
<div class="md-search-result" data-md-component="search-result">
<div class="md-search-result__meta">
Initializing search
</div>
<ol class="md-search-result__list" role="presentation"></ol>
</div>
</div>
</div>
</div>
</div>
<div class="md-header__source">
<a href="https://github.com/ClementTsang/bottom" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.0.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path fill="currentColor" d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
</div>
<div class="md-source__repository">
ClementTsang/bottom
</div>
</a>
</div>
</nav>
</header>
<div class="md-container" data-md-component="container">
<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
<div class="md-grid">
<ul class="md-tabs__list">
<li class="md-tabs__item">
<a href="../../.." class="md-tabs__link">
Home
</a>
</li>
<li class="md-tabs__item">
<a href="../../../support/official/" class="md-tabs__link">
Support
</a>
</li>
<li class="md-tabs__item md-tabs__item--active">
<a href="../../general-usage/" class="md-tabs__link">
Usage
</a>
</li>
<li class="md-tabs__item">
<a href="../../../configuration/command-line-options/" class="md-tabs__link">
Configuration
</a>
</li>
<li class="md-tabs__item">
<a href="../../../contribution/issues-and-pull-requests/" class="md-tabs__link">
Contribution
</a>
</li>
<li class="md-tabs__item">
<a href="../../../troubleshooting/" class="md-tabs__link">
Troubleshooting
</a>
</li>
</ul>
</div>
</nav>
<main class="md-main" data-md-component="main">
<div class="md-main__inner md-grid">
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
<div class="md-sidebar__scrollwrap">
<div class="md-sidebar__inner">
<nav class="md-nav md-nav--primary md-nav--lifted md-nav--integrated" aria-label="Navigation" data-md-level="0">
<label class="md-nav__title" for="__drawer">
<a href="../../.." title="bottom" class="md-nav__button md-logo" aria-label="bottom" data-md-component="logo">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54"/></svg>
</a>
bottom
</label>
<div class="md-nav__source">
<a href="https://github.com/ClementTsang/bottom" title="Go to repository" class="md-source" data-md-component="source">
<div class="md-source__icon md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 7.0.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path fill="currentColor" d="M439.6 236.1 244 40.5c-5.4-5.5-12.8-8.5-20.4-8.5s-15 3-20.4 8.4L162.5 81l51.5 51.5c27.1-9.1 52.7 16.8 43.4 43.7l49.7 49.7c34.2-11.8 61.2 31 35.5 56.7-26.5 26.5-70.2-2.9-56-37.3L240.3 199v121.9c25.3 12.5 22.3 41.8 9.1 55-6.4 6.4-15.2 10.1-24.3 10.1s-17.8-3.6-24.3-10.1c-17.6-17.6-11.1-46.9 11.2-56v-123c-20.8-8.5-24.6-30.7-18.6-45L142.6 101 8.5 235.1C3 240.6 0 247.9 0 255.5s3 15 8.5 20.4l195.6 195.7c5.4 5.4 12.7 8.4 20.4 8.4s15-3 20.4-8.4l194.7-194.7c5.4-5.4 8.4-12.8 8.4-20.4s-3-15-8.4-20.4"/></svg>
</div>
<div class="md-source__repository">
ClementTsang/bottom
</div>
</a>
</div>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../.." class="md-nav__link">
<span class="md-ellipsis">
Home
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
<span class="md-ellipsis">
Support
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_2">
<span class="md-nav__icon md-icon"></span>
Support
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../support/official/" class="md-nav__link">
<span class="md-ellipsis">
Official Support
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../support/unofficial/" class="md-nav__link">
<span class="md-ellipsis">
Unofficial Support
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
<span class="md-ellipsis">
Usage
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_3">
<span class="md-nav__icon md-icon"></span>
Usage
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../general-usage/" class="md-nav__link">
<span class="md-ellipsis">
General Usage
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../basic-mode/" class="md-nav__link">
<span class="md-ellipsis">
Basic Mode
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3_3" checked>
<label class="md-nav__link" for="__nav_3_3" id="__nav_3_3_label" tabindex="">
<span class="md-ellipsis">
Widgets
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_3_3_label" aria-expanded="true">
<label class="md-nav__title" for="__nav_3_3">
<span class="md-nav__icon md-icon"></span>
Widgets
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../cpu/" class="md-nav__link">
<span class="md-ellipsis">
CPU Widget
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../memory/" class="md-nav__link">
<span class="md-ellipsis">
Memory Widget
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../network/" class="md-nav__link">
<span class="md-ellipsis">
Network Widget
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--active">
<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
Process Widget
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
<span class="md-ellipsis">
Process Widget
</span>
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#features" class="md-nav__link">
<span class="md-ellipsis">
Features
</span>
</a>
<nav class="md-nav" aria-label="Features">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#sorting" class="md-nav__link">
<span class="md-ellipsis">
Sorting
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#grouping" class="md-nav__link">
<span class="md-ellipsis">
Grouping
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#process-termination" class="md-nav__link">
<span class="md-ellipsis">
Process termination
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#tree-mode" class="md-nav__link">
<span class="md-ellipsis">
Tree mode
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#full-command" class="md-nav__link">
<span class="md-ellipsis">
Full command
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#search" class="md-nav__link">
<span class="md-ellipsis">
Search
</span>
</a>
<nav class="md-nav" aria-label="Search">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#keywords" class="md-nav__link">
<span class="md-ellipsis">
Keywords
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#comparison-operators" class="md-nav__link">
<span class="md-ellipsis">
Comparison operators
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#logical-operators" class="md-nav__link">
<span class="md-ellipsis">
Logical operators
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#units" class="md-nav__link">
<span class="md-ellipsis">
Units
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#key-bindings" class="md-nav__link">
<span class="md-ellipsis">
Key bindings
</span>
</a>
<nav class="md-nav" aria-label="Key bindings">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#process-table" class="md-nav__link">
<span class="md-ellipsis">
Process table
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#sort-sub-widget" class="md-nav__link">
<span class="md-ellipsis">
Sort sub-widget
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#search-sub-widget" class="md-nav__link">
<span class="md-ellipsis">
Search sub-widget
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="#mouse-bindings" class="md-nav__link">
<span class="md-ellipsis">
Mouse bindings
</span>
</a>
<nav class="md-nav" aria-label="Mouse bindings">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#process-table_1" class="md-nav__link">
<span class="md-ellipsis">
Process table
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#sort-sub-widget_1" class="md-nav__link">
<span class="md-ellipsis">
Sort sub-widget
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../disk/" class="md-nav__link">
<span class="md-ellipsis">
Disk Widget
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../temperature/" class="md-nav__link">
<span class="md-ellipsis">
Temperature Widget
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../battery/" class="md-nav__link">
<span class="md-ellipsis">
Battery Widget
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../autocomplete/" class="md-nav__link">
<span class="md-ellipsis">
Auto-Complete
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
<label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
<span class="md-ellipsis">
Configuration
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4">
<span class="md-nav__icon md-icon"></span>
Configuration
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../configuration/command-line-options/" class="md-nav__link">
<span class="md-ellipsis">
Command-line Options
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4_2" >
<div class="md-nav__link md-nav__container">
<a href="../../../configuration/config-file/" class="md-nav__link ">
<span class="md-ellipsis">
Config File
</span>
</a>
<label class="md-nav__link " for="__nav_4_2" id="__nav_4_2_label" tabindex="0">
<span class="md-nav__icon md-icon"></span>
</label>
</div>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_4_2_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_4_2">
<span class="md-nav__icon md-icon"></span>
Config File
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../configuration/config-file/cpu/" class="md-nav__link">
<span class="md-ellipsis">
CPU Widget
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../configuration/config-file/data-filtering/" class="md-nav__link">
<span class="md-ellipsis">
Data Filtering
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../configuration/config-file/flags/" class="md-nav__link">
<span class="md-ellipsis">
Flags
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../configuration/config-file/layout/" class="md-nav__link">
<span class="md-ellipsis">
Layout
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../configuration/config-file/processes/" class="md-nav__link">
<span class="md-ellipsis">
Processes Widget
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../configuration/config-file/styling/" class="md-nav__link">
<span class="md-ellipsis">
Styling
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
<span class="md-ellipsis">
Contribution
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5">
<span class="md-nav__icon md-icon"></span>
Contribution
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../contribution/issues-and-pull-requests/" class="md-nav__link">
<span class="md-ellipsis">
Issues, Pull Requests, and Discussions
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../contribution/documentation/" class="md-nav__link">
<span class="md-ellipsis">
Documentation
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../contribution/packaging-and-distribution/" class="md-nav__link">
<span class="md-ellipsis">
Packaging and Distribution
</span>
</a>
</li>
<li class="md-nav__item md-nav__item--nested">
<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5_4" >
<label class="md-nav__link" for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
<span class="md-ellipsis">
Development
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
<label class="md-nav__title" for="__nav_5_4">
<span class="md-nav__icon md-icon"></span>
Development
</label>
<ul class="md-nav__list" data-md-scrollfix>
<li class="md-nav__item">
<a href="../../../contribution/development/dev_env/" class="md-nav__link">
<span class="md-ellipsis">
Development Environment
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../contribution/development/testing/" class="md-nav__link">
<span class="md-ellipsis">
Testing
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../contribution/development/logging/" class="md-nav__link">
<span class="md-ellipsis">
Logging
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../contribution/development/build_process/" class="md-nav__link">
<span class="md-ellipsis">
Build Process
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../contribution/development/deploy_process/" class="md-nav__link">
<span class="md-ellipsis">
Deploy Process
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
<a href="../../../troubleshooting/" class="md-nav__link">
<span class="md-ellipsis">
Troubleshooting
</span>
</a>
</li>
</ul>
</nav>
</div>
</div>
</div>
<div class="md-content" data-md-component="content">
<article class="md-content__inner md-typeset">
<a href="https://github.com/ClementTsang/bottom/edit/main/docs/content/usage/widgets/process.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75z"/></svg>
</a>
<h1 id="process-widget"><a class="toclink" href="#process-widget">Process Widget</a></h1>
<p>The process widget displays a table containing information regarding a running process, along with sorting,
searching, and process control features.</p>
<figure>
<img src="../../../assets/screenshots/process/process_default.webp" alt="A picture of an expanded process widget by default."/>
</figure>
<h2 id="features"><a class="toclink" href="#features">Features</a></h2>
<p>The process widget has three main components:</p>
<ul>
<li>The main process table</li>
<li>The search sub-widget (opened with <span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-f">f</kbd></span> or <span class="keys"><kbd class="key-slash">/</kbd></span>)</li>
<li>The sort menu sub-widget (opened with <span class="keys"><kbd class="key-s">s</kbd></span> or <span class="keys"><kbd class="key-f6">F6</kbd></span>)</li>
</ul>
<p>By default, the main process table displays the following information for each process:</p>
<ul>
<li>PID</li>
<li>Name of the process</li>
<li>CPU use percentage (note this is averaged out per available thread by default)</li>
<li>Memory use percentage</li>
<li>Disk reads per second</li>
<li>Disk writes per second</li>
<li>Total amount read from disk</li>
<li>Total amount written from disk</li>
<li>User</li>
<li>Process state</li>
<li>
<p>Process uptime</p>
<!-- 2-space indent here because mdx_truly_sane_lists interferes, see https://github.com/squidfunk/mkdocs-material/discussions/3763#discussioncomment-2833731 -->
<div class="admonition info indent">
<p class="admonition-title">Info</p>
<p>On Windows, the I/O counters will report <em>all</em> reads/writes, not just disk. See
<a href="https://docs.rs/sysinfo/latest/sysinfo/struct.Process.html#method.disk_usage">here</a>
for more details.</p>
</div>
</li>
</ul>
<p>With the feature flag (<code>--disable_gpu</code> on Linux/Windows to disable) and gpu process columns enabled in the configuration:</p>
<ul>
<li>GPU memory use percentage</li>
<li>GPU core utilization percentage</li>
</ul>
<p>See <a href="../../../configuration/config-file/processes/">the processes configuration page</a> on how to customize which columns
are shown.</p>
<h3 id="sorting"><a class="toclink" href="#sorting">Sorting</a></h3>
<p>The table can be sorted by clicking on the table headers, which will either sort the table by that column, or if already
sorting by that column, reverse the sorting order.</p>
<p>Alternatively, one can sort using the sort menu sub-widget, which is brought up using <span class="keys"><kbd class="key-s">s</kbd></span> or <span class="keys"><kbd class="key-f6">F6</kbd></span>, and can be controlled by arrow keys or the mouse.</p>
<figure>
<img src="../../../assets/screenshots/process/process_sort_menu.webp" alt="A picture of an expanded process widget with the sort menu open."/>
</figure>
<h3 id="grouping"><a class="toclink" href="#grouping">Grouping</a></h3>
<p>Pressing <span class="keys"><kbd class="key-tab">Tab</kbd></span> in the table will group entries with the same name together. The PID column will be replaced with the number of entries in each group, and usage
is added together when displayed.</p>
<figure>
<img src="../../../assets/screenshots/process/process_grouped.webp" alt="A picture of grouped mode in a process widget."/>
</figure>
<div class="admonition info">
<p class="admonition-title">Info</p>
<p>Note that the process state and user columns are disabled in this mode.</p>
</div>
<div class="admonition info">
<p class="admonition-title">Info</p>
<p>Note that if tree mode is also active, processes cannot be grouped together due to the behaviour of the two modes
somewhat clashing. This also reflects with default modes like <code>group_processes</code>.</p>
</div>
<h3 id="process-termination"><a class="toclink" href="#process-termination">Process termination</a></h3>
<p>Pressing <span class="keys"><kbd class="key-d">d</kbd><span>+</span><kbd class="key-d">d</kbd></span> or <span class="keys"><kbd class="key-f9">F9</kbd></span> will allow you to terminate the currently selected process/process group. On Unix-like
operating systems, you are also able to control which specific signals to send (e.g. <code>SIGKILL</code>, <code>SIGTERM</code>).</p>
<figure>
<img src="../../../assets/screenshots/process/process_kill_linux.webp" alt="A picture of the process kill menu on Linux."/>
<figcaption><sub>The process termination menu on Linux</sub></figcaption>
</figure>
<p>If you're on Windows, or if the <code>disable_advanced_kill</code> flag is set in the options or command-line (only available on
Linux, macOS, and FreeBSD), then a simpler termination screen with just yes or no options will be shown.</p>
<figure>
<img src="../../../assets/screenshots/process/process_kill_simple.webp" alt="A picture of the process kill menu on Windows."/>
<figcaption><sub>The process termination menu on Windows</sub></figcaption>
</figure>
<h3 id="tree-mode"><a class="toclink" href="#tree-mode">Tree mode</a></h3>
<p>Pressing <span class="keys"><kbd class="key-t">t</kbd></span> or <span class="keys"><kbd class="key-f5">F5</kbd></span> in the table toggles tree mode in the process widget, displaying processes in regard to their parent-child process relationships.</p>
<figure>
<img src="../../../assets/screenshots/process/process_tree.webp" alt="A picture of tree mode in a process widget."/>
</figure>
<p>A process in tree mode can also be "collapsed", hiding its children and any descendants, using the either the <span class="keys"><kbd class="key-minus">-</kbd></span>,
<span class="keys"><kbd class="key-plus">+</kbd></span>, or <span class="keys"><kbd class="key-arrow-left">Left</kbd></span> keys, or clicking on an entry. It can be expanded by using the <span class="keys"><kbd class="key-minus">-</kbd></span>, <span class="keys"><kbd class="key-plus">+</kbd></span>, or <span class="keys"><kbd class="key-arrow-right">Right</kbd></span>
keys, or by clicking on the entry again.</p>
<div class="admonition info">
<p class="admonition-title">Info</p>
<p>Note that if tree mode is active, processes cannot be grouped together due to the behaviour of the two modes
somewhat clashing. This also reflects with default modes like <code>group_processes</code>.</p>
</div>
<h3 id="full-command"><a class="toclink" href="#full-command">Full command</a></h3>
<p>You can show the full command instead of just the process name by pressing <span class="keys"><kbd class="key-P">P</kbd></span>.</p>
<figure>
<img src="../../../assets/screenshots/process/process_full.webp" alt="A picture of a process widget using full commands."/>
</figure>
<h3 id="search"><a class="toclink" href="#search">Search</a></h3>
<p>Pressing <span class="keys"><kbd class="key-slash">/</kbd></span> or <span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-f">f</kbd></span> will open up the search sub-widget. By default, just typing in something will search by the process name.</p>
<figure>
<img src="../../../assets/screenshots/process/search/search.webp" alt="A picture of searching for a process with a simple search."/>
</figure>
<p>This search can be further enhanced by matching by case, matching the entire word, or by regex.</p>
<figure>
<img src="../../../assets/screenshots/process/search/regex.webp" alt="A picture of searching for a process with a search condition that uses regex."/>
</figure>
<p>We are able to also search for multiple things/conditions.</p>
<figure>
<img src="../../../assets/screenshots/process/search/or.webp" alt="A picture of searching for a process with a search condition that uses the or operator."/>
</figure>
<p>And if our search uses a keyword, we need to use quotation marks around the term to properly search it.</p>
<figure>
<img src="../../../assets/screenshots/process/search/quotes.webp" alt="A picture of searching for a process with a search condition that needs quotation marks."/>
</figure>
<p>Lastly, we can refine our search even further based on the other columns, like PID, CPU usage, etc., as well as grouping together conditions.</p>
<figure>
<img src="../../../assets/screenshots/process/search/cpu.webp" alt="A picture of searching for a process with a search condition that uses the CPU keyword."/>
</figure>
<p>You can also paste search queries (e.g. <span class="keys"><kbd class="key-shift">Shift</kbd><span>+</span><kbd class="key-insert">Ins</kbd></span>, <span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-shift">Shift</kbd><span>+</span><kbd class="key-v">v</kbd></span>).</p>
<h4 id="keywords"><a class="toclink" href="#keywords">Keywords</a></h4>
<p>Note all keywords are case-insensitive. To search for a process/command that collides with a keyword, surround the term with quotes (e.x. <code>"cpu"</code>).</p>
<table>
<thead>
<tr>
<th>Keywords</th>
<th>Example</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td></td>
<td><code>btm</code></td>
<td>Matches by process or command name; supports regex</td>
</tr>
<tr>
<td><code>pid</code></td>
<td><code>pid=1044</code></td>
<td>Matches by PID; supports regex</td>
</tr>
<tr>
<td><code>cpu</code> <br/> <code>cpu%</code></td>
<td><code>cpu &gt; 0.5</code></td>
<td>Matches the CPU column; supports comparison operators</td>
</tr>
<tr>
<td><code>memb</code></td>
<td><code>memb &gt; 1000 b</code></td>
<td>Matches the memory column in terms of bytes; supports comparison operators</td>
</tr>
<tr>
<td><code>mem</code> <br/> <code>mem%</code></td>
<td><code>mem &lt; 0.5</code></td>
<td>Matches the memory column in terms of percent; supports comparison operators</td>
</tr>
<tr>
<td><code>read</code> <br/> <code>r/s</code> <br/> <code>rps</code></td>
<td><code>read = 1 mb</code></td>
<td>Matches the read/s column in terms of bytes; supports comparison operators</td>
</tr>
<tr>
<td><code>write</code> <br/> <code>w/s</code> <br/> <code>wps</code></td>
<td><code>write &gt;= 1 kb</code></td>
<td>Matches the write/s column in terms of bytes; supports comparison operators</td>
</tr>
<tr>
<td><code>tread</code> <br/> <code>t.read</code></td>
<td><code>tread &lt;= 1024 gb</code></td>
<td>Matches he total read column in terms of bytes; supports comparison operators</td>
</tr>
<tr>
<td><code>twrite</code> <br/> <code>t.write</code></td>
<td><code>twrite &gt; 1024 tb</code></td>
<td>Matches the total write column in terms of bytes; supports comparison operators</td>
</tr>
<tr>
<td><code>user</code></td>
<td><code>user=root</code></td>
<td>Matches by user; supports regex</td>
</tr>
<tr>
<td><code>state</code></td>
<td><code>state=running</code></td>
<td>Matches by state; supports regex</td>
</tr>
<tr>
<td><code>()</code></td>
<td><code>(&lt;COND 1&gt; AND &lt;COND 2&gt;) OR &lt;COND 3&gt;</code></td>
<td>Group together a condition</td>
</tr>
<tr>
<td><code>gmem</code></td>
<td><code>gmem &gt; 1000 b</code></td>
<td>Matches the gpu memory column in terms of bytes; supports comparison operators</td>
</tr>
<tr>
<td><code>gmem%</code></td>
<td><code>gmem% &lt; 0.5</code></td>
<td>Matches the gpu memory column in terms of percent; supports comparison operators</td>
</tr>
<tr>
<td><code>gpu%</code></td>
<td><code>gpu% &gt; 0</code></td>
<td>Matches the gpu usage column in terms of percent; supports comparison operators</td>
</tr>
</tbody>
</table>
<h4 id="comparison-operators"><a class="toclink" href="#comparison-operators">Comparison operators</a></h4>
<table>
<thead>
<tr>
<th>Keywords</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>=</code></td>
<td>Checks if the values are equal</td>
</tr>
<tr>
<td><code>&gt;</code></td>
<td>Checks if the left value is strictly greater than the right</td>
</tr>
<tr>
<td><code>&lt;</code></td>
<td>Checks if the left value is strictly less than the right</td>
</tr>
<tr>
<td><code>&gt;=</code></td>
<td>Checks if the left value is greater than or equal to the right</td>
</tr>
<tr>
<td><code>&lt;=</code></td>
<td>Checks if the left value is less than or equal to the right</td>
</tr>
</tbody>
</table>
<h4 id="logical-operators"><a class="toclink" href="#logical-operators">Logical operators</a></h4>
<p>Note all operators are case-insensitive, and the <code>and</code> operator takes precedence over the <code>or</code> operator.</p>
<table>
<thead>
<tr>
<th>Keywords</th>
<th>Usage</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>and</code> <br/> <code>&amp;&amp;</code> <br/> <code>&lt;Space&gt;</code></td>
<td><code>&lt;COND 1&gt; and &lt;COND 2&gt;</code> <br/> <code>&lt;COND 1&gt; &amp;&amp; &lt;COND 2&gt;</code> <br/> <code>&lt;COND 1&gt; &lt;COND 2&gt;</code></td>
<td>Requires both conditions to be true to match</td>
</tr>
<tr>
<td><code>or</code> <br/> <code>&#124;&#124;</code></td>
<td><code>&lt;COND 1&gt; or &lt;COND 2&gt;</code> <br/> <code>&lt;COND 1&gt; &amp;#124;&amp;#124; &lt;COND 2&gt;</code></td>
<td>Requires at least one condition to be true to match</td>
</tr>
</tbody>
</table>
<h4 id="units"><a class="toclink" href="#units">Units</a></h4>
<p>All units are case-insensitive.</p>
<table>
<thead>
<tr>
<th>Keywords</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>B</code></td>
<td>Bytes</td>
</tr>
<tr>
<td><code>KB</code></td>
<td>Kilobytes</td>
</tr>
<tr>
<td><code>MB</code></td>
<td>Megabytes</td>
</tr>
<tr>
<td><code>GB</code></td>
<td>Gigabytes</td>
</tr>
<tr>
<td><code>TB</code></td>
<td>Terabytes</td>
</tr>
<tr>
<td><code>KiB</code></td>
<td>Kibibytes</td>
</tr>
<tr>
<td><code>MiB</code></td>
<td>Mebibytes</td>
</tr>
<tr>
<td><code>GiB</code></td>
<td>Gibibytes</td>
</tr>
<tr>
<td><code>TiB</code></td>
<td>Tebibytes</td>
</tr>
</tbody>
</table>
<h2 id="key-bindings"><a class="toclink" href="#key-bindings">Key bindings</a></h2>
<p>Note that key bindings are generally case-sensitive.</p>
<h3 id="process-table"><a class="toclink" href="#process-table">Process table</a></h3>
<table>
<thead>
<tr>
<th>Binding</th>
<th>Action</th>
</tr>
</thead>
<tbody>
<tr>
<td><span class="keys"><kbd class="key-arrow-up">Up</kbd></span> , <span class="keys"><kbd class="key-k">k</kbd></span></td>
<td>Move up within a widget</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-arrow-down">Down</kbd></span> , <span class="keys"><kbd class="key-j">j</kbd></span></td>
<td>Move down within a widget</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-g">g</kbd><span>+</span><kbd class="key-g">g</kbd></span> , <span class="keys"><kbd class="key-home">Home</kbd></span></td>
<td>Jump to the first entry in the table</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-G">G</kbd></span> , <span class="keys"><kbd class="key-end">End</kbd></span></td>
<td>Jump to the last entry in the table</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-d">d</kbd><span>+</span><kbd class="key-d">d</kbd></span> , <span class="keys"><kbd class="key-f9">F9</kbd></span></td>
<td>Send a kill signal to the selected process</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-c">c</kbd></span></td>
<td>Sort by CPU usage, press again to reverse sorting order</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-m">m</kbd></span></td>
<td>Sort by memory usage, press again to reverse sorting order</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-p">p</kbd></span></td>
<td>Sort by PID name, press again to reverse sorting order</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-n">n</kbd></span></td>
<td>Sort by process name, press again to reverse sorting order</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-tab">Tab</kbd></span></td>
<td>Toggle grouping processes with the same name</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-P">P</kbd></span></td>
<td>Toggle between showing the full command or just the process name</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-f">f</kbd></span> , <span class="keys"><kbd class="key-slash">/</kbd></span></td>
<td>Toggle showing the search sub-widget</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-s">s</kbd></span> , <span class="keys"><kbd class="key-f6">F6</kbd></span>, <span class="keys"><kbd class="key-delete">Del</kbd></span> (<span class="keys"><kbd class="key-function">Fn</kbd><span>+</span><kbd class="key-delete">Del</kbd></span> on macOS)</td>
<td>Toggle showing the sort sub-widget</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-I">I</kbd></span></td>
<td>Invert the current sort</td>
</tr>
<tr>
<td><span class="keys"><kbd>%</kbd></span></td>
<td>Toggle between values and percentages for memory usage</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-t">t</kbd></span> , <span class="keys"><kbd class="key-f5">F5</kbd></span></td>
<td>Toggle tree mode</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-M">M</kbd></span></td>
<td>Sort by gpu memory usage, press again to reverse sorting order</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-C">C</kbd></span></td>
<td>Sort by gpu usage, press again to reverse sorting order</td>
</tr>
</tbody>
</table>
<h3 id="sort-sub-widget"><a class="toclink" href="#sort-sub-widget">Sort sub-widget</a></h3>
<table>
<thead>
<tr>
<th>Binding</th>
<th>Action</th>
</tr>
</thead>
<tbody>
<tr>
<td><span class="keys"><kbd class="key-arrow-up">Up</kbd></span> , <span class="keys"><kbd class="key-k">k</kbd></span></td>
<td>Move up within a widget</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-arrow-down">Down</kbd></span> , <span class="keys"><kbd class="key-j">j</kbd></span></td>
<td>Move down within a widget</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-g">g</kbd><span>+</span><kbd class="key-g">g</kbd></span> , <span class="keys"><kbd class="key-home">Home</kbd></span></td>
<td>Jump to the first entry in the table</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-G">G</kbd></span> , <span class="keys"><kbd class="key-end">End</kbd></span></td>
<td>Jump to the last entry in the table</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-escape">Esc</kbd></span></td>
<td>Close the sort sub-widget</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-enter">Enter</kbd></span></td>
<td>Sorts the corresponding process table</td>
</tr>
</tbody>
</table>
<h3 id="search-sub-widget"><a class="toclink" href="#search-sub-widget">Search sub-widget</a></h3>
<table>
<thead>
<tr>
<th>Binding</th>
<th>Action</th>
</tr>
</thead>
<tbody>
<tr>
<td><span class="keys"><kbd class="key-arrow-left">Left</kbd></span> <br/> <span class="keys"><kbd class="key-h">h</kbd></span> <br/> <span class="keys"><kbd class="key-alt">Alt</kbd><span>+</span><kbd class="key-h">h</kbd></span></td>
<td>Moves the cursor left</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-arrow-right">Right</kbd></span> <br/> <span class="keys"><kbd class="key-l">l</kbd></span> <br/> <span class="keys"><kbd class="key-alt">Alt</kbd><span>+</span><kbd class="key-l">l</kbd></span></td>
<td>Moves the cursor right</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-escape">Esc</kbd></span></td>
<td>Close the search widget (retains the filter)</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-a">a</kbd></span></td>
<td>Skip to the start of the search query</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-e">e</kbd></span></td>
<td>Skip to the end of the search query</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-u">u</kbd></span></td>
<td>Clear the current search query</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-w">w</kbd></span></td>
<td>Delete a word behind the cursor</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-control">Ctrl</kbd><span>+</span><kbd class="key-h">h</kbd></span></td>
<td>Delete the character behind the cursor</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-backspace">Backspace</kbd></span></td>
<td>Delete the character behind the cursor</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-delete">Del</kbd></span> (<span class="keys"><kbd class="key-function">Fn</kbd><span>+</span><kbd class="key-delete">Del</kbd></span> on macOS)</td>
<td>Delete the character at the cursor</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-alt">Alt</kbd><span>+</span><kbd class="key-c">c</kbd></span> , <span class="keys"><kbd class="key-f1">F1</kbd></span></td>
<td>Toggle matching case</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-alt">Alt</kbd><span>+</span><kbd class="key-w">w</kbd></span> , <span class="keys"><kbd class="key-f2">F2</kbd></span></td>
<td>Toggle matching the entire word</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-alt">Alt</kbd><span>+</span><kbd class="key-r">r</kbd></span> , <span class="keys"><kbd class="key-f3">F3</kbd></span></td>
<td>Toggle using regex</td>
</tr>
</tbody>
</table>
<h2 id="mouse-bindings"><a class="toclink" href="#mouse-bindings">Mouse bindings</a></h2>
<h3 id="process-table_1"><a class="toclink" href="#process-table_1">Process table</a></h3>
<table>
<thead>
<tr>
<th>Binding</th>
<th>Action</th>
</tr>
</thead>
<tbody>
<tr>
<td><span class="keys"><kbd>Scroll</kbd></span></td>
<td>Selects a CPU thread/average to show in the graph</td>
</tr>
<tr>
<td><span class="keys"><kbd class="key-left-button">Left Button</kbd></span></td>
<td>Table header: Sorts/reverse sorts the table by the column <br/> Table entry: Selects an entry in the table, if in tree mode, collapses/expands the entry's children</td>
</tr>
</tbody>
</table>
<h3 id="sort-sub-widget_1"><a class="toclink" href="#sort-sub-widget_1">Sort sub-widget</a></h3>
<table>
<thead>
<tr>
<th>Binding</th>
<th>Action</th>
</tr>
</thead>
<tbody>
<tr>
<td><span class="keys"><kbd class="key-left-button">Left Button</kbd></span></td>
<td>Selects an entry in the table</td>
</tr>
</tbody>
</table>
<aside class="md-source-file">
<span class="md-source-file__fact">
<span class="md-icon" title="Last update">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg>
</span>
<span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date" title="June 8, 2025 08:46:31">June 8, 2025</span>
</span>
</aside>
</article>
</div>
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
</div>
<button type="button" class="md-top md-icon" data-md-component="top" hidden>
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
Back to top
</button>
</main>
<footer class="md-footer">
<nav class="md-footer__inner md-grid" aria-label="Footer" >
<a href="../network/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Network Widget">
<div class="md-footer__button md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
</div>
<div class="md-footer__title">
<span class="md-footer__direction">
Previous
</span>
<div class="md-ellipsis">
Network Widget
</div>
</div>
</a>
<a href="../disk/" class="md-footer__link md-footer__link--next" aria-label="Next: Disk Widget">
<div class="md-footer__title">
<span class="md-footer__direction">
Next
</span>
<div class="md-ellipsis">
Disk Widget
</div>
</div>
<div class="md-footer__button md-icon">
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M4 11v2h12l-5.5 5.5 1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5 16 11z"/></svg>
</div>
</a>
</nav>
<div class="md-footer-meta md-typeset">
<div class="md-footer-meta__inner md-grid">
<div class="md-copyright">
<div class="md-copyright__highlight">
Copyright &copy; 2019 - 2024 Clement Tsang
</div>
Made with
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
Material for MkDocs
</a>
</div>
</div>
</div>
</footer>
</div>
<div class="md-dialog" data-md-component="dialog">
<div class="md-dialog__inner md-typeset"></div>
</div>
<div class="md-progress" data-md-component="progress" role="progressbar"></div>
<script id="__config" type="application/json">{"base": "../../..", "features": ["content.action.edit", "navigation.expand", "navigation.footer", "navigation.indexes", "navigation.instant", "navigation.instant.progress", "navigation.sections", "navigation.tabs", "navigation.top", "search.highlight", "search.suggest", "toc.integrate", "toc.follow"], "search": "../../../assets/javascripts/workers/search.d50fe291.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": {"default": "stable", "provider": "mike"}}</script>
<script src="../../../assets/javascripts/bundle.50899def.min.js"></script>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink