Print this page
10270 Convert ptree(1) to mandoc

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1/ptree.1.man.txt
          +++ new/usr/src/man/man1/ptree.1.man.txt
   1    1  PTREE(1)                         User Commands                        PTREE(1)
   2    2  
   3      -
   4      -
   5    3  NAME
   6      -       ptree - print process trees
        4 +     ptree - print process trees
   7    5  
   8    6  SYNOPSIS
   9      -       /usr/bin/ptree [-a] [-c] [-z zone] [pid | user]...
        7 +     ptree [-a] [-c] [-z zone] [pid | user]...
  10    8  
  11      -
  12    9  DESCRIPTION
  13      -       The ptree utility prints the process trees containing the specified
  14      -       pids or users, with child processes indented from their respective
  15      -       parent processes. An argument of all digits is taken to be a process-
  16      -       ID, otherwise it is assumed to be a user login name. The default is all
  17      -       processes.
       10 +     The ptree utility prints the process trees containing the specified pids
       11 +     or users, with child processes indented from their respective parent
       12 +     processes.  An argument of all digits is taken to be a process-ID,
       13 +     otherwise it is assumed to be a user login name.  The default is all
       14 +     processes.
  18   15  
  19   16  OPTIONS
  20      -       The following options are supported:
       17 +     The following options are supported:
  21   18  
  22      -       -a
  23      -                  All. Print all processes, including children of process 0.
       19 +     -a       All.  Print all processes, including children of process 0.
  24   20  
       21 +     -c       Contracts.  Print process contract memberships in addition to
       22 +              parent-child relationships.  See process(4).  This option
       23 +              implies the -a option.
  25   24  
  26      -       -c
  27      -                  Contracts. Print process contract memberships in addition to
  28      -                  parent-child relationships. See process(4). This option
  29      -                  implies the -a option.
       25 +     -z zone  Zones.  Print only processes in the specified zone.  Each zone
       26 +              ID can be specified as either a zone name or a numerical zone
       27 +              ID.
  30   28  
       29 +              This option is only useful when executed in the global zone.
  31   30  
  32      -       -z zone
  33      -                  Zones. Print only processes in the specified zone. Each zone
  34      -                  ID can be specified as either a zone name or a numerical
  35      -                  zone ID.
  36      -
  37      -                  This option is only useful when executed in the global zone.
  38      -
  39      -
  40   31  OPERANDS
  41      -       The following operands are supported:
       32 +     The following operands are supported:
  42   33  
  43      -       pid
  44      -               Process-id or a list of process-ids. ptree also accepts
  45      -               /proc/nnn as a process-id, so the shell expansion /proc/* can
  46      -               be used to specify all processes in the system.
       34 +     pid   Process-id or a list of process-ids.  ptree also accepts /proc/nnn
       35 +           as a process-id, so the shell expansion /proc/* can be used to
       36 +           specify all processes in the system.
  47   37  
       38 +     user  Username or list of usernames.  Processes whose effective user IDs
       39 +           match those given are displayed.
  48   40  
  49      -       user
  50      -               Username or list of usernames. Processes whose effective user
  51      -               IDs match those given are displayed.
       41 +FILES
       42 +     /proc/*                           process files
  52   43  
       44 +EXIT STATUS
       45 +     The ptree utility exits 0 on success, and >0 if an error occurs.
  53   46  
  54   47  EXAMPLES
  55      -       Example 1 Using ptree
       48 +     Example 1 Using ptree
  56   49  
       50 +     The following example prints the process tree (including children of
       51 +     process 0) for processes which match the command name ssh:
  57   52  
  58      -       The following example prints the process tree (including children of
  59      -       process 0) for processes which match the command name ssh:
       53 +       $ ptree -a `pgrep ssh`
       54 +               1     /sbin/init
       55 +                 100909 /usr/lib/ssh/sshd
       56 +                   569150 /usr/lib/ssh/sshd
       57 +                     569157 /usr/lib/ssh/sshd
       58 +                       569159 -ksh
       59 +                         569171 bash
       60 +                           569173 /bin/ksh
       61 +                             569193 bash
  60   62  
       63 +INTERFACE STABILITY
       64 +     Not-an-Interface
  61   65  
  62      -         $ ptree -a `pgrep ssh`
  63      -                 1     /sbin/init
  64      -                   100909 /usr/lib/ssh/sshd
  65      -                     569150 /usr/lib/ssh/sshd
  66      -                       569157 /usr/lib/ssh/sshd
  67      -                         569159 -ksh
  68      -                           569171 bash
  69      -                             569173 /bin/ksh
  70      -                               569193 bash
  71      -
  72      -
  73      -
  74      -EXIT STATUS
  75      -       The following exit values are returned:
  76      -
  77      -       0
  78      -                   Successful operation.
  79      -
  80      -
  81      -       non-zero
  82      -                   An error has occurred.
  83      -
  84      -
  85      -FILES
  86      -       /proc/*
  87      -                  process files
  88      -
  89      -
  90      -ATTRIBUTES
  91      -       See attributes(5) for descriptions of the following attributes:
  92      -
  93      -
  94      -
  95      -
  96      -       +--------------------+-----------------+
  97      -       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
  98      -       +--------------------+-----------------+
  99      -       |Interface Stability | See below.      |
 100      -       +--------------------+-----------------+
 101      -
 102      -
 103      -       The human readable output is Unstable. The options are Evolving.
 104      -
 105   66  SEE ALSO
 106      -       gcore(1), ldd(1), pargs(1), pgrep(1), pkill(1), plimit(1), pmap(1),
 107      -       preap(1), proc(1), ps(1), ppgsz(1), pwd(1), rlogin(1), time(1),
 108      -       truss(1), wait(1), fcntl(2), fstat(2), setuid(2), dlopen(3C),
 109      -       signal.h(3HEAD), core(4), proc(4), process(4), attributes(5), zones(5)
       67 +     gcore(1), ldd(1), pargs(1), pgrep(1), pkill(1), plimit(1), pmap(1),
       68 +     ppgsz(1), preap(1), proc(1), ps(1), pwd(1), rlogin(1), time(1), truss(1),
       69 +     wait(1), fcntl(2), fstat(2), setuid(2), dlopen(3C), signal.h(3HEAD),
       70 +     core(4), proc(4), process(4), attributes(5), zones(5)
 110   71  
 111      -
 112      -
 113      -                               October 11, 2005                       PTREE(1)
       72 +illumos                        January 12, 2019                        illumos
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX