ltop.tproj/ltop.1

   1 .\" Copyright (c) 2012, Apple Inc.  All rights reserved.
   2 .\"
   3 .Dd June 28, 2012
   4 .Dt LTOP 1
   5 .Os "Mac OS X"
   6 .Sh NAME
   7 .Nm ltop
   8 .Nd Display ledger information for processes on the system
   9 .Sh SYNOPSIS
  10 .Nm ltop
  11 .Bk -words
  12 .Fl h
  13 .Pp
  14 .Nm ltop
  15 .Op Fl dL
  16 .Op Fl g Ar group
  17 .Op Fl p Ar pid
  18 .Op Fl r Ar resource
  19 .Op Ar interval
  20 .Ek
  21 .Sh DESCRIPTION
  22 .Nm ltop
  23 displays the contents of system ledgers maintained by the kernel for each process in the system. Ledgers are a general accounting mechanism that the kernel uses to track and limit things like CPU time and memory usage.
  24 .Pp
  25 If the optional
  26 .Ar interval
  27 is specified, then
  28 .Nm
  29 will display the ledger contents every interval seconds.
  30 .Pp
  31 The options are as follows:
  32 .Bl -tag -width indent
  33 .\" ==========
  34 .It Fl d
  35 In conjunction with
  36 .Ar interval ,
  37 display the rate of change for each value, as compared to the previous sample displayed.
  38 .\" ==========
  39 .It Fl L
  40 Display template info. Shows which resources are tracked, and lists the associated units.
  41 .\" ==========
  42 .It Fl g Ar group
  43 Only display info for the ledgers associated with
  44 .Ar group .
  45 Group topology can be seen via the
  46 .Fl L
  47 option.
  48 .\" ==========
  49 .It Fl p Ar pid
  50 Only display info for process
  51 .Ar pid .
  52 .\" ==========
  53 .It Fl r Ar resource
  54 Only display info for resource
  55 .Ar resource .
  56 .\" ==========
  57 .El
  58 .Sh SEE ALSO
  59 .Xr top 1