tyler.durden/bottom
1
0
Fork 0
mirror of https://github.com/ClementTsang/bottom.git synced 2025-07-07 13:54:44 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: more details about search

Browse Source
This commit is contained in:
ClementTsang 2020-05-03 00:54:45 -04:00
parent 83a4a15cd5
commit d1ef24165d
2 changed files with 31 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
README.md
View File

@ -238,11 +238,15 @@ Run using `btm`.
### Process searching keywords ### Process searching keywords
Note none of the keywords are case sensitive. Furthermore, if you want to search a reserved keyword, surround the text in quotes - for example, `"And" or "Or"` would be a valid search. - Note none of the keywords are case sensitive.
- Use brackets to logically group together parts of the search.
- Furthermore, if you want to search a reserved keyword, surround the text in quotes - for example, `"or" or "(sd-pam)"` would be a valid search:
![quote searching](assets/quote_search.png)
#### Supported keywords #### Supported keywords
| | | | | Keywords | Example | Description |
| -------- | --------------- | ------------------------------------------------------------------------------- | | -------- | --------------- | ------------------------------------------------------------------------------- |
| `pid` | `pid: 1044` | Matches by PID; supports regex and requiring matching the entire PID | | `pid` | `pid: 1044` | Matches by PID; supports regex and requiring matching the entire PID |
| `cpu` | `cpu > 0.5` | Matches the condition for the CPU column; supports comparison operators | | `cpu` | `cpu > 0.5` | Matches the condition for the CPU column; supports comparison operators |
@ -254,8 +258,8 @@ Note none of the keywords are case sensitive. Furthermore, if you want to search
#### Supported comparison operators #### Supported comparison operators
| | | | Keywords | Description |
| ---- | -------------------------------------------------------------- | | -------- | -------------------------------------------------------------- |
| `=` | Checks if the values are equal | | `=` | Checks if the values are equal |
| `>` | Checks if the left value is strictly greater than the right | | `>` | Checks if the left value is strictly greater than the right |
| `<` | Checks if the left value is strictly less than the right | | `<` | Checks if the left value is strictly less than the right |
@ -266,15 +270,15 @@ Note none of the keywords are case sensitive. Furthermore, if you want to search
Note that the `and` operator takes precedence over the `or` operator. Note that the `and` operator takes precedence over the `or` operator.
| | | | | Keywords | Usage | Description |
| ------------------ | -------------------------------------------- | --------------------------------------------------- | | ------------------ | -------------------------------------------- | --------------------------------------------------- |
| `and, &&, <Space>` | `<CONDITION 1> and/&&/<Space> <CONDITION 2>` | Requires both conditions to be true to match | | `and, &&, <Space>` | `<CONDITION 1> and/&&/<Space> <CONDITION 2>` | Requires both conditions to be true to match |
| `or, \|\|` | `<CONDITION 1> or/\|\| <CONDITION 2>` | Requires at least one condition to be true to match | | `or, \|\|` | `<CONDITION 1> or/\|\| <CONDITION 2>` | Requires at least one condition to be true to match |
#### Supported units #### Supported units
| | | | Keywords | Description |
| ----- | --------- | | -------- | ----------- |
| `B` | Bytes | | `B` | Bytes |
| `KB` | Kilobytes | | `KB` | Kilobytes |
| `MB` | Megabytes | | `MB` | Megabytes |
@ -285,6 +289,12 @@ Note that the `and` operator takes precedence over the `or` operator.
| `GiB` | Gibibytes | | `GiB` | Gibibytes |
| `TiB` | Tebibytes | | `TiB` | Tebibytes |
#### Other syntax
| Keywords | Usage | Description |
| -------- | ---------------------------------------------------- | -------------------------- |
| `()` | `(<CONDITION 1> AND <CONDITION 2>) OR <CONDITION 3>` | Group together a condition |
## Features ## Features
As yet _another_ process/system visualization and management application, bottom supports the typical features: As yet _another_ process/system visualization and management application, bottom supports the typical features:

BIN
assets/quote_search.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 226 KiB