Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PSTREE(1)		     General Commands Manual		       PSTREE(1)

NAME
     pstree -- list processes as a tree

SYNOPSIS
     pstree [-Uw] [-f file] [-g n] [-l n] [-p pid] [-s string] [-u user]
	    [rootpid ...]

DESCRIPTION
     Tree sorted output frontend for ps(1).  pstree uses the output of the ps(1)
     program to show nicely formatted process family trees.

     For  each	rootpid  argument, pstree shows one tree rooted at that process.
     By default, if no rootpid argument is given, it shows a single tree  rooted
     at process 1.

     The options are as follows:

     -f file	Read   input   from   file   instead   of  running  "ps  -kaxwwo
		user,pid,ppid,pgid,command".  If file is a  single  dash  (`-'),
		pstree reads from standard input.

     -g n	Use  graphics chars for tree.  n = 1: IBM-850, n = 2: VT100, n =
		3: UTF8.

     -l n	Show a maximum of n levels.

     -p pid	Show only parents and descendants of the process pid.

     -s string	Show only parents and descendants of  processes  containing  the
		string in their commandline.

     -U 	Do not show branches containing only root processes.

     -u user	Show only parents and descendants of processes of user.

     -w 	Wide output, not truncated to terminal width.

ENVIRONMENT
     COLUMNS  The  width  of  the  terminal in characters.  This can be set with
	      stty(1)columns number.

EXIT STATUS
     The pstree utility exits 0 on success, and >0 if an error occurs.

EXAMPLES
     Show branches of processes containing "httpd" using VT100 graphic chars:

     $ pstree -g 2 -s httpd

     Show process number "15495" and its descendants:

     $ pstree 15495

     Show process number "15495" and its parents and descendants:

     $ pstree -p 15495

SEE ALSO
     ps(1), top(1)

AUTHORS
     The program was written and is  maintained  by  Fred  Hucht  <fred@thp.uni-
     due.de>, and this manual page was initially set up by
     Sebastian Stark.

FreeBSD ports 15.quarterly	  June 4, 2013			       PSTREE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pstree&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help