about summary refs log tree commit diff
path: root/px.1
diff options
context:
space:
mode:
Diffstat (limited to 'px.1')
-rw-r--r--px.152
1 files changed, 52 insertions, 0 deletions
diff --git a/px.1 b/px.1
new file mode 100644
index 0000000..c1cd7db
--- /dev/null
+++ b/px.1
@@ -0,0 +1,52 @@
+.Dd April 15, 2024
+.Dt PX 1
+.Os
+.Sh NAME
+.Nm px
+.Nd report details on matching processes
+.Sh SYNOPSIS
+.Nm
+.Op Fl f
+.Op Fl t
+.Ar PATTERNS ...
+.Sh DESCRIPTION
+.Nm
+searches the process list for processes matching any of the patterns
+.Ar PATTERNS
+and prints details on them,
+namely PID, user, cpu usage, virtual and real memory usage,
+start time, run time and cpu time, as well as the full command line.
+.Pp
+As
+.Ar PATTERNS
+may be used:
+substrings of the process name or numeric PIDs.
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl f
+Search the whole command line, including arguments.
+.It Fl t
+Print each thread, not just each process.
+.El
+.Sh EXIT STATUS
+The
+.Nm
+utility returns 0 when a process was found,
+1 if no process was found,
+and 2 when other errors occured.
+.Sh SEE ALSO
+.Xr pgrep 1 ,
+.Xr ps 1
+.Sh AUTHORS
+.An Leah Neukirchen Aq Mt leah@vuxu.org
+.Sh LICENSE
+.Nm
+is in the public domain.
+.Pp
+To the extent possible under law,
+the creator of this work
+has waived all copyright and related or
+neighboring rights to this work.
+.Pp
+.Lk http://creativecommons.org/publicdomain/zero/1.0/