2 .\" This file and its contents are supplied under the terms of the
3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
4 .\" You may only use this file in accordance with the terms of version
7 .\" A full copy of the text of the CDDL should have accompanied this
8 .\" source. A copy of the CDDL is also available via the Internet at
9 .\" http://www.illumos.org/license/CDDL.
12 .\" Copyright 2015 Joyent, Inc.
19 .Nd obtain the process address space file descriptor
26 .Fa "struct ps_prochandle *P"
31 funtion returns a file descriptor that allows direct access to the
32 address space of the process handle
34 A defined file descriptor is provided when using the
37 .Xr Pgrab_file 3PROC ,
41 Note that the address space may be different in each of these cases and doesn't
42 necessarily correspond to the /proc
44 file, except for live processes.
45 Other means of obtaining a
47 process handle may not define a file descriptor that contains the
50 The returned file descriptor must not be closed and is only valid for
51 as long as the corresponding process handle
56 the file descriptor is invalidated.
58 Upon successful completion, the
60 function returns a valid file descriptor.
61 Otherwise, if none exists, then
64 .Sh INTERFACE STABILITY
75 .Xr Pgrab_core 3PROC ,
76 .Xr Pgrab_file 3PROC ,