diff options
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/pstree.1')
-rw-r--r-- | upstream/opensuse-leap-15-6/man1/pstree.1 | 171 |
1 files changed, 171 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/pstree.1 b/upstream/opensuse-leap-15-6/man1/pstree.1 new file mode 100644 index 00000000..e7d3f3cd --- /dev/null +++ b/upstream/opensuse-leap-15-6/man1/pstree.1 @@ -0,0 +1,171 @@ +.\" +.\" Copyright 1993-2002 Werner Almesberger +.\" 2002-2016 Craig Small +.\" This program is free software; you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation; either version 2 of the License, or +.\" (at your option) any later version. +.\" +.TH PSTREE 1 "2016-06-18" "psmisc" "User Commands" +.SH NAME +pstree \- display a tree of processes +.SH SYNOPSIS +.ad l +.B pstree +.RB [ \-a , \ \-\-arguments ] +.RB [ \-c , \ \-\-compact ] +.RB [ \-h , \ \-\-highlight\-all , \ \-H \fIpid\fB , \ \-\-highlight\-pid\ \fIpid\fB ] +.RB [ \-g ] \ \-\-show\-pgids ] +.RB [ \-l , \ \-\-long ] +.RB [ \-n , \ \-\-numeric\-sort ] +.RB [ \-N , \ \-\-ns\-sort \fIns\fB +.RB [ \-p , \ \-\-show\-pids ] +.RB [ \-s , \ \-\-show\-parents ] +.RB [ \-S , \ \-\-ns-changes ] +.RB [ \-t , \ \-\-thread-names ] +.RB [ \-T , \ \-\-hide-threads ] +.RB [ \-u , \ \-\-uid\-changes ] +.RB [ \-Z , \ \-\-security\-context ] +.RB [ \-A , \ \-\-ascii , \ \-G , \ \-\-vt100 , \ \-U , \ \-\-unicode ] +.RB [ \fIpid\fB , \ \fIuser\fB] +.br +.B pstree +.RB \-V , \ \-\-version +.ad b +.SH DESCRIPTION +.B pstree +shows running processes as a tree. The tree is rooted at either +.I pid +or +.B init +if +.I pid +is omitted. If a user name is specified, all process trees rooted at +processes owned by that user are shown. +.PP +.B pstree +visually merges identical branches by putting them in square brackets +and prefixing them with the repetition count, e.g. +.nf +.sp + init\-+\-getty + |\-getty + |\-getty + `\-getty +.sp +.fi +becomes +.nf +.sp + init\-\-\-4*[getty] +.sp +.fi +.PP +.PP +Child threads of a process are found under the parent process and are +shown with the process name in curly braces, e.g. +.nf +.sp + icecast2\-\-\-13*[{icecast2}] +.sp +.fi +.PP +If +.B pstree +is called as +.B pstree.x11 +then it will prompt the user at the end of the line to press return and +will not return until that has happened. This is useful for when +.B pstree +is run in a xterminal. +.PP +Certain kernel or mount parameters, such as the hidepid option for procfs, +will hide information for some processes. In these situations +.B pstree +will attempt to build the tree without this information, showing process +names as question marks. + +.SH OPTIONS +.IP \fB\-a\fP +Show command line arguments. If the command line of a process is +swapped out, that process is shown in parentheses. +.B \-a +implicitly disables compaction for processes but not threads. +.IP \fB\-A\fP +Use ASCII characters to draw the tree. +.IP \fB\-c\fP +Disable compaction of identical subtrees. By default, subtrees are +compacted whenever possible. +.IP \fB\-G\fP +Use VT100 line drawing characters. +.IP \fB\-h\fP +Highlight the current process and its ancestors. This is a no-op if +the terminal doesn't support highlighting or if neither the current +process nor any of its ancestors are in the subtree being shown. +.IP \fB\-H\fP +Like +.BR \-h , +but highlight the specified process instead. Unlike with +.BR \-h , +.B pstree +fails when using +.B \-H +if highlighting is not +available. +.IP \fB\-g\fP +Show PGIDs. Process Group IDs are shown as decimal numbers in +parentheses after each process name. +.B \-g +implicitly disables compaction. If both PIDs and PGIDs are displayed +then PIDs are shown first. +.IP \fB\-l\fP +Display long lines. By default, lines are truncated to either the COLUMNS +environment variable or the display width. If neither of these methods work, +the default of 132 columns is used. +.IP \fB\-n\fP +Sort processes with the same ancestor by PID instead of by name. +(Numeric sort.) +.IP \fB\-N\fP +Show individual trees for each namespace of the type specified. The +available types are: ipc, mnt, net, pid, user, uts. Regular users don't +have access to other users' processes information, so the output will be +limited. +.IP \fB\-p\fP +Show PIDs. PIDs are shown as decimal numbers in parentheses after each +process name. +.B \-p +implicitly disables compaction. +.IP \fB\-s\fP +Show parent processes of the specified process. +.IP \fB\-S\fP +Show namespaces transitions. Like \-N, the output is limited when running +as a regular user. +.IP \fB\-t\fP +Show full names for threads when available. +.IP \fB\-T\fP +Hide threads and only show processes. +.IP \fB\-u\fP +Show uid transitions. Whenever the uid of a process differs from the +uid of its parent, the new uid is shown in parentheses after the +process name. +.IP \fB\-U\fP +Use UTF-8 (Unicode) line drawing characters. Under Linux 1.1-54 and +above, UTF-8 mode is entered on the console with +.B echo \-e '\\033%8' +and left with +.B echo \-e '\\033%@' +.IP \fB\-V\fP +Display version information. +.IP \fB\-Z\fP +(SELinux) Show security context for each process. This flag will only +work if pstree is compiled with SELinux support. +.SH FILES +.TP +/proc +location of the proc file system +.SH BUGS +Some character sets may be incompatible with the VT100 characters. +.SH "SEE ALSO" +.BR ps (1), +.BR top (1). +.\"{{{}}} |