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