Bump to procps-ng 3.3.16
[platform/upstream/procps-ng.git] / pmap.1
1 '\" t
2 .\" (The preceding line is a note to broken versions of man to tell
3 .\" them to pre-process this man page with tbl)
4 .\" Man page for pmap.
5 .\" Licensed under version 2 of the GNU General Public License.
6 .\" Written by Albert Cahalan.
7 .\"
8 .TH PMAP "1" "September 2012" "procps-ng" "User Commands"
9 .SH NAME
10 pmap \- report memory map of a process
11 .SH SYNOPSIS
12 .B pmap
13 [\fIoptions\fR] \fIpid\fR [...]
14 .SH DESCRIPTION
15 The pmap command reports the memory map of a process or processes.
16 .SH OPTIONS
17 .TP
18 \fB\-x\fR, \fB\-\-extended\fR
19 Show the extended format.
20 .TP
21 \fB\-d\fR, \fB\-\-device\fR
22 Show the device format.
23 .TP
24 \fB\-q\fR, \fB\-\-quiet\fR
25 Do not display some header or footer lines.
26 .TP
27 \fB\-A\fR, \fB\-\-range\fR \fIlow\fR,\fIhigh\fR
28 Limit results to the given range to
29 .I low
30 and
31 .I high
32 address range.  Notice that the low and high arguments are single string
33 separated with comma.
34 .TP
35 \fB\-X\fR
36 Show even more details than the \fB\-x\fR option. WARNING: format changes
37 according to \fI/proc/PID/smaps\fR
38 .TP
39 \fB\-XX\fR
40 Show everything the kernel provides
41 .TP
42 \fB\-p\fR, \fB\-\-show\-path\fR
43 Show full path to files in the mapping column
44 .TP
45 \fB\-c\fR, \fB\-\-read\-rc\fR
46 Read the default configuration
47 .TP
48 \fB\-C\fR, \fB\-\-read\-rc\-from\fR \fIfile\fR
49 Read the configuration from \fIfile\fR
50 .TP
51 \fB\-n\fR, \fB\-\-create\-rc\fR
52 Create new default configuration
53 .TP
54 \fB\-N\fR, \fB\-\-create\-rc\-to\fR \fIfile\fR
55 Create new configuration to \fIfile\fR
56 .TP
57 \fB\-h\fR, \fB\-\-help\fR
58 Display help text and exit.
59 .TP
60 \fB\-V\fR, \fB\-\-version\fR
61 Display version information and exit.
62 .SH "EXIT STATUS"
63 .PP
64 .RS
65 .PD 0
66 .TP
67 .B 0
68 Success.
69 .TP
70 .B 1
71 Failure.
72 .TP
73 .B 42
74 Did not find all processes asked for.
75 .PD
76 .RE
77 .SH "SEE ALSO"
78 .BR ps (1),
79 .BR pgrep (1)
80 .SH STANDARDS
81 No standards apply, but pmap looks an awful lot like a SunOS command.
82 .SH "REPORTING BUGS"
83 Please send bug reports to
84 .UR procps@freelists.org
85 .UE