HTOPRS(1)

NAME
htoprs - interactive process viewer (a faithful Rust port of htop)

SYNOPSIS
htoprs [-dCFhpustvH]

DESCRIPTION
htoprs is a Rust port of htop(1), the cross-platform ncurses-based process viewer. It is being ported function-for-function from the htop 3.5.1 C source, which is the specification; the command-line surface below mirrors htop's.

Like top(1), htop lets you scroll vertically and horizontally, interact using a pointing device, observe all processes with their command lines, view them in a tree, select multiple processes, and act on them at once. Tasks such as killing and renicing can be done without entering PIDs.

PORT STATUS: the port is at an early stage. The XUtils.c string and math utility layer is ported and tested; the TUI, process table, meters, and platform data collection are not yet ported, so the binary does not yet present an interactive interface. The options below document the CLI contract being ported. For interactive-runtime commands, see htop(1).

COMMAND-LINE OPTIONS
Mandatory arguments to long options are mandatory for short options too.

-d --delay=DELAY
    Delay between updates, in tenths of a second. If the delay value is less than 1, it is increased to 1, i.e. 1/10 second. If the delay value is greater than 100, it is decreased to 100, i.e. 10 seconds.

-C --no-color --no-colour
    Start in monochrome mode.

-F --filter=FILTER
    Filter processes by terms matching the commands. The terms are matched case-insensitive and as fixed strings (not regexps). You can separate multiple terms with "|".

--no-function-bar
    Hide the function bar.

-h --help
    Display a help message and exit.

-p --pid=PID,PID...
    Show only the given PIDs.

-s --sort-key COLUMN
    Sort by this column (use --sort-key help for a column list). This will force a list view unless you specify -t at the same time. Sorting in tree mode applies to the direct children of each process.

-u --user[=USERNAME|UID]
    Show only the processes of a given user, or self if omitted.

-n --max-iterations=NUMBER
    Exit after NUMBER refresh iterations.

-U --no-unicode
    Do not use unicode but ASCII characters for graph meters.

-M --no-mouse
    Disable support of mouse control.

--no-meters
    Hide graph meters.

--readonly
    Disable all system and process changing features.

-V --version
    Output version information and exit.

-t --tree
    Show processes in tree view. This can be used to force a tree view when requesting a sort order with -s.

-H --highlight-changes[=DELAY]
    Highlight new and old processes.

SEE ALSO
htop(1), top(1), ps(1)

AUTHOR
htoprs is written by MenkeTechnologies as a faithful Rust port of the htop project. See the htoprs repository (https://github.com/MenkeTechnologies/htoprs).