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 control file descriptor
26 .Fa "struct ps_prochandle *P"
31 function returns a file descriptor to the underlying /proc file system
33 file for the process identified by the handle
35 This may be used for injecting control operations manually;
36 however, many interfaces for using it are provided by
40 Only live processes have a control file descriptor.
41 Process handles that correspond to files and cores, created through
44 .Xr Pgrab_core 3PROC ,
45 do not have a corresponding file descriptor.
47 The file descriptor is invalidated when the process handle is released
50 or if control is lost and the handle is reopened.
52 Upon successful completion, the
54 function returns a valid file descriptor.
55 Otherwise, if none exists, then
58 .Sh INTERFACE STABILITY
69 .Xr Pgrab_core 3PROC ,
70 .Xr Pgrab_file 3PROC ,