NAME
pmap, pfiles — displays process address information and open file descriptors
SYNOPSIS
pmap
[-o
options]
pid1
[pid2]...
pfiles
pid1
[pid2]...
DESCRIPTION
pmap
prints the address space information of a process.
pfiles
prints information about all open file descriptors of a process.
If file descriptor corresponds to a file, then
pfiles
prints the
fstat(2)
and
fcntl(2)
information.
If the file descriptor corresponds to a socket, then
pfiles
prints
socket related info, such as the socket type, socket family, and
protocol family.
In the case of
AF_INET and AF_INET6 family of sockets, information about the peer host
is also printed.
pmap Options
The information printed by
pmap
can be controlled by the
-o
option.
The argument to
-o
can be a comma-separated set of arguments given below:
- mlck
Display the size data locked in memory for each mapped object.
- name
Display the map name. This field can contain the following data.
- anonymous
If the object is mapped as
MAP_ANONYMOUS.
- stack, rsestack
If the object mapped is the stack segment of the process.
- text
The object mapped is the text segment of the program.
- data
The object mapped is the data segment of the program.
- filename
The object is mapped from a file.
If the file name cannot be resolved, then the inode number and the
device ID of the file is displayed.
Also see the
WARNINGS
section below.
Other map names include:
nulldref,
shared_memory,
uarea,
graphics,
dma_graphics,
and
io.
- offset
Display the offset of each mapped object.
- perm
Specify access permission for each mapped object.
- rsz
Display the resident size of each mapped object.
- space
Display the space ID of each mapped object.
- swap
Display the swap allocated for each mapped object.
- szhnt
Display the maximum size of a page that can be allocated for the object.
- type
Indicate the type of data managed by each mapped object.
The values include,
- SC(n)
Shared code, with
n
indicating the number of processes sharing the mapped object.
- PC
Private code.
- SD(n)
Shared data, with
n
indicating the number of processes sharing the mapped object.
- PD
Private data.
- vsz
Display the virtual size of each mapped object.
Since the name of the file can be of variable length, use the name
argument as the last argument to the
-o
option to ensure proper indentation of other fields.
If no
-o
option is specified,
pmap
prints the following fields by default:
offset,
rsz,
type,
perm,
and
name.
EXTERNAL INFLUENCES
Environment Variables
If
LANG
is not specified or is null, it defaults to
C
(see
lang(5)).
EXAMPLES
This
pmap
command prints the virtual address, the resident memory size, and the name
of each object mapped for processes with process ID 100 and 200:
pmap -ooffset,rsz,name 100 200
This
pfiles
command prints information on open file descriptors of processes
with process ID 100 and 200:
WARNINGS
pmap
and
pfiles
depend on
DNLC
to resolve the file names.
If the file name cannot be resolved, then
these commands will only print the device ID and the inode number of the file.
Users of
pmap
must not rely on the exact field widths and spacing of its output,
as these will vary depending on the system and the release of HP-UX.