'\" t
.\"     Title: procs
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.21
.\"      Date: 2024-03-30
.\"    Manual: User Commands
.\"    Source: procs
.\"  Language: English
.\"
.TH "PROCS" "1" "2024-03-30" "procs" "User Commands"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "NAME"
procs \- a replacement for `ps` written in Rust
.SH "SYNOPSIS"
.sp
\fBprocs\fP [OPTIONS] [KEYWORDS]
.SH "DESCRIPTION"
.sp
\fBprocs\fP is a command\-line tool that provides an alternative to the \f(CRps\fP command.
.SH "OPTIONS"
.sp
\fB\-\-and\fP
.RS 4
Show processes that match all keywords.
.RE
.sp
\fB\-\-or\fP
.RS 4
Show processes that match any keyword.
.RE
.sp
\fB\-\-nand\fP
.RS 4
Show processes unless they match all keywords.
.RE
.sp
\fB\-\-nor\fP
.RS 4
Show processes unless they match any keyword.
.RE
.sp
\fB\-\-watch\fP
.RS 4
Enable watch mode for real\-time updates.
.RE
.sp
\fB\-\-watch\-interval <second>\fP
.RS 4
Set the update interval for watch mode.
.RE
.sp
\fB\-\-tree\fP
.RS 4
Display processes in a tree view.
.RE
.sp
\fB\-\-sorta <column>\fP
.RS 4
Sort processes in ascending order by the specified column.
.RE
.sp
\fB\-\-sortd <column>\fP
.RS 4
Sort processes in descending order by the specified column.
.RE
.sp
\fB\-\-insert <column>\fP
.RS 4
Insert a new column at the position of \f(CRSlot\fP or \f(CRMultiSlot\fP.
.RE
.sp
\fB\-\-gen\-completion\fP
.RS 4
Generate shell completion files for supported shells.
.RE
.SH "EXAMPLES"
.sp
\fBShow all processes\fP
.RS 4
procs
.RE
.sp
\fBSearch by non\-numeric keyword\fP
.RS 4
procs zsh
.RE
.sp
\fBSearch by numeric keyword\fP
.RS 4
procs \-\-or 6000 60000 60001 16723
.RE
.sp
\fBShow Docker container name\fP
.RS 4
procs growi
.RE
.SH "PAGER"
.sp
On Linux and macOS, \f(CRless\fP is the default pager. If not available, \f(CRmore\fP is used. Built\-in pager can be used by configuring \f(CRuse_builtin\fP. On Windows, the built\-in pager is always used.
.SH "WATCH MODE SHORTCUTS"
.sp
If \f(CR\-\-watch\fP or \f(CR\-\-watch\-interval <second>\fP option is used, procs automatically updates output like \f(CRtop\fP.
Keyboard shortcuts are available for control.
.sp
\fBn\fP
.RS 4
Change the sort column to the next column
.RE
.sp
\fBp\fP
.RS 4
Change the sort column to the previous column
.RE
.sp
\fBa\fP
.RS 4
Change the sort order to ascending
.RE
.sp
\fBd\fP
.RS 4
Change the sort order to descending
.RE
.sp
\fBq\fP
.RS 4
Quit
.RE
.SH "RESOURCES"
.sp
\fBProject source code:\fP \c
.URL "https://github.com/dalance/procs" "" ""