summaryrefslogtreecommitdiff
path: root/usr/src/man/man1/pmap.1
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man/man1/pmap.1')
-rw-r--r--usr/src/man/man1/pmap.183
1 files changed, 6 insertions, 77 deletions
diff --git a/usr/src/man/man1/pmap.1 b/usr/src/man/man1/pmap.1
index 8dac9903b6..5f2c360872 100644
--- a/usr/src/man/man1/pmap.1
+++ b/usr/src/man/man1/pmap.1
@@ -3,7 +3,7 @@
.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
-.TH pmap 1 "9 Sep 2006" "SunOS 5.11" "User Commands"
+.TH PMAP 1 "Sep 9, 2006"
.SH NAME
pmap \- display information about the address space of a process
.SH SYNOPSIS
@@ -37,28 +37,23 @@ The \fBpmap\fR utility prints information about the address space of a process.
The following options are supported:
.sp
.ne 2
-.mk
.na
\fB\fB-a\fR\fR
.ad
.RS 20n
-.rt
Prints anonymous and swap reservations for shared mappings.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-A\fR \fIaddress_range\fR\fR
.ad
.RS 20n
-.rt
Specifies the subrange of address space to display. \fIaddress_range\fR is
specified in one of the following forms:
.sp
.ne 2
-.mk
.na
\fB\fIstart_addr\fR\fR
.ad
@@ -72,7 +67,6 @@ the whole segment even when the \fB-L\fR option is specified.
.sp
.ne 2
-.mk
.na
\fB\fIstart_addr\fR\fB,\fR\fR
.ad
@@ -85,7 +79,6 @@ containing the specified address.
.sp
.ne 2
-.mk
.na
\fB\fIstart_addr\fR\fB,\fR\fIend_addr\fR\fR
.ad
@@ -99,7 +92,6 @@ page containing the end address.
.sp
.ne 2
-.mk
.na
\fB\fB,\fR\fIend_addr\fR\fR
.ad
@@ -115,12 +107,10 @@ containing the specified address.
.sp
.ne 2
-.mk
.na
\fB\fB-F\fR\fR
.ad
.RS 20n
-.rt
Force. Grabs the target process even if another process has control.
.sp
See \fBUSAGE\fR.
@@ -128,68 +118,56 @@ See \fBUSAGE\fR.
.sp
.ne 2
-.mk
.na
\fB\fB-l\fR\fR
.ad
.RS 20n
-.rt
Shows unresolved dynamic linker map names.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-L\fR\fR
.ad
.RS 20n
-.rt
Prints lgroup containing physical memory that backs virtual memory.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-r\fR\fR
.ad
.RS 20n
-.rt
Prints the process's reserved addresses.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-s\fR\fR
.ad
.RS 20n
-.rt
Prints \fBHAT\fR page size information.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-S\fR\fR
.ad
.RS 20n
-.rt
Displays swap reservation information per mapping. See USAGE for more
information.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB-x\fR\fR
.ad
.RS 20n
-.rt
Displays additional information per mapping. See USAGE for more information.
.RE
@@ -199,7 +177,6 @@ Displays additional information per mapping. See USAGE for more information.
The \fBpmap\fR utility prints information about the address space of a process.
.sp
.ne 2
-.mk
.na
\fBProcess Mappings\fR
.ad
@@ -224,7 +201,6 @@ the output includes the segments bounded by those addresses.
.sp
.ne 2
-.mk
.na
\fBProcess Lgroup Mappings\fR
.ad
@@ -257,7 +233,6 @@ In addition, the thread and memory placement can be changed by using
.sp
.ne 2
-.mk
.na
\fBProcess anon/locked mapping details\fR
.ad
@@ -280,7 +255,6 @@ this process.
.sp
.ne 2
-.mk
.na
\fBSwap Reservations\fR
.ad
@@ -316,7 +290,6 @@ contiguous mapping of each hardware translation page size belonging to the same
lgroup. The column headings are shown in parentheses below.
.sp
.ne 2
-.mk
.na
\fBVirtual Address (\fBAddress\fR)\fR
.ad
@@ -328,7 +301,6 @@ mapping. Virtual addresses are displayed in ascending order.
.sp
.ne 2
-.mk
.na
\fBVirtual Mapping Size (\fBKbytes\fR)\fR
.ad
@@ -339,7 +311,6 @@ The virtual size in kilobytes of each mapping.
.sp
.ne 2
-.mk
.na
\fBResident Physical Memory (\fBRSS\fR)\fR
.ad
@@ -351,7 +322,6 @@ including that which is shared with other address spaces.
.sp
.ne 2
-.mk
.na
\fBAnonymous Memory (\fBAnon\fR)\fR
.ad
@@ -367,7 +337,6 @@ pages with mappings mapped with \fBMAP_PRIVATE\fR (see \fBmmap\fR(2)).
.sp
.ne 2
-.mk
.na
\fBLocked (\fBLocked\fR)\fR
.ad
@@ -380,7 +349,6 @@ locked with \fBmlock()\fR and System V shared memory created with
.sp
.ne 2
-.mk
.na
\fBPermissions/Flags (\fBMode\fR)\fR
.ad
@@ -390,46 +358,38 @@ The virtual memory permissions are shown for each mapping. Valid permissions
are:
.sp
.ne 2
-.mk
.na
\fB\fBr:\fR\fR
.ad
.RS 6n
-.rt
The mapping can be read by the process.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBw:\fR\fR
.ad
.RS 6n
-.rt
The mapping can be written by the process.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBx:\fR\fR
.ad
.RS 6n
-.rt
Instructions that reside within the mapping can be executed by the process.
.RE
Flags showing additional information for each mapping can be displayed:
.sp
.ne 2
-.mk
.na
\fB\fBs:\fR\fR
.ad
.RS 6n
-.rt
The mapping is shared such that changes made in the observed address space are
committed to the mapped file, and are visible from all other processes sharing
the mapping.
@@ -437,12 +397,10 @@ the mapping.
.sp
.ne 2
-.mk
.na
\fB\fBR:\fR\fR
.ad
.RS 6n
-.rt
Swap space is not reserved for this mapping. Mappings created with
\fBMAP_NORESERVE\fR and System V \fBISM\fR shared memory mappings do not
reserve swap space.
@@ -450,12 +408,10 @@ reserve swap space.
.sp
.ne 2
-.mk
.na
\fB\fB*:\fR\fR
.ad
.RS 6n
-.rt
The data for the mapping is not present in the core file (only applicable when
applied to a core file). See \fBcoreadm\fR(1M) for information on configuring
core file content.
@@ -465,7 +421,6 @@ core file content.
.sp
.ne 2
-.mk
.na
\fBLgroup (\fBLgrp\fR)\fR
.ad
@@ -476,7 +431,6 @@ The lgroup containing the physical memory that backs the specified mapping.
.sp
.ne 2
-.mk
.na
\fBMapping Name (\fBMapped File\fR)\fR
.ad
@@ -506,45 +460,37 @@ mappings:
.sp
.ne 2
-.mk
.na
\fB\fB[ heap ]\fR\fR
.ad
.RS 22n
-.rt
The mapping is the process heap.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB[ stack ]\fR\fR
.ad
.RS 22n
-.rt
The mapping is the main stack.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB[ stack tid=\fIn\fR ]\fR\fR
.ad
.RS 22n
-.rt
The mapping is the stack for thread \fIn\fR.
.RE
.sp
.ne 2
-.mk
.na
\fB\fB[ altstack tid=\fIn\fR ]\fR\fR
.ad
.RS 22n
-.rt
The mapping is used as the alternate signal stack for thread \fIn\fR.
.RE
@@ -563,24 +509,20 @@ system calls are reported with the names shown below:
.sp
.ne 2
-.mk
.na
\fB\fBshmid=n:\fR\fR
.ad
.RS 17n
-.rt
The mapping is a System V shared memory mapping. The shared memory identifier
that the mapping was created with is reported.
.RE
.sp
.ne 2
-.mk
.na
\fB\fBism shmid=n:\fR\fR
.ad
.RS 17n
-.rt
The mapping is an "Intimate Shared Memory" variant of System V shared memory.
\fBISM\fR mappings are created with the \fBSHM_SHARE_MMU\fR flag set, in
accordance with \fBshmat\fR(2) (see \fBshmop\fR(2)).
@@ -588,12 +530,10 @@ accordance with \fBshmat\fR(2) (see \fBshmop\fR(2)).
.sp
.ne 2
-.mk
.na
\fB\fBdism shmid=n:\fR\fR
.ad
.RS 17n
-.rt
The mapping is a pageable variant of \fBISM\fR. Pageable \fBISM\fR is created
with the \fBSHM_PAGEABLE\fR flag set in accordance with \fBshmat\fR(2) (see
\fBshmop\fR(2)).
@@ -613,7 +553,6 @@ buffers. No mapping name is shown for other mapped objects.
.sp
.ne 2
-.mk
.na
\fBPage Size (\fBPgsz\fR)\fR
.ad
@@ -625,7 +564,6 @@ this mapping. See \fBmemcntl\fR(2) for further information.
.sp
.ne 2
-.mk
.na
\fBSwap Space (\fBSwap\fR)\fR
.ad
@@ -1010,46 +948,38 @@ FFBFE000 8K rw--- 2 [ stack ]
The following exit values are returned:
.sp
.ne 2
-.mk
.na
\fB\fB0\fR\fR
.ad
.RS 12n
-.rt
Successful operation.
.RE
.sp
.ne 2
-.mk
.na
\fBnon-zero\fR
.ad
.RS 12n
-.rt
An error has occurred.
.RE
.SH FILES
.sp
.ne 2
-.mk
.na
\fB\fB/proc/*\fR\fR
.ad
.RS 19n
-.rt
process files
.RE
.sp
.ne 2
-.mk
.na
\fB\fB/usr/proc/lib/*\fR\fR
.ad
.RS 19n
-.rt
\fBproc\fR tools supporting files
.RE
@@ -1061,13 +991,12 @@ See \fBattributes\fR(5) for descriptions of the following attributes:
.sp
.TS
-tab() box;
-cw(2.75i) |cw(2.75i)
-lw(2.75i) |lw(2.75i)
-.
-ATTRIBUTE TYPEATTRIBUTE VALUE
+box;
+c | c
+l | l .
+ATTRIBUTE TYPE ATTRIBUTE VALUE
_
-Interface StabilitySee below.
+Interface Stability See below.
.TE
.sp
generated by cgit v1.2.3 (git 2.46.0) at 2025-12-11 03:37:10 +0000