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.
20 .Nd release a process control handle
27 .Fa "struct ps_prochandle *P"
32 .Fa "struct ps_prochandle *P"
37 function is used to release all of the resources associated with a
40 It is suitable for handles to core files, created processes, and grabbed
42 .Xr Pgrab_core 3PROC ,
51 function, all data that was returned via the handle will no longer be
53 For example, the data from calls to
55 .Xr Pgetauxvec 3PROC ,
59 The behavior of the released process is controlled by the
62 By default, if no flags are passed, then the process represented by
64 will be set running if it was created by
66 or if it was not originally stopped or set to stop in /proc.
67 The following values may be passed in to the
70 Multiple flags should be be combined with a bitwise-inclusive-OR.
71 .Bl -tag -width Er -offset indent
73 When releasing the process, clear all tracing flags that are set on the
75 .It Dv PRELEASE_RETAIN
76 When releasing the process, retain all tracing flags that are currently
77 active on the process.
79 Leave the process stopped.
80 It will not resume execution unless it is explicitly enabled with
82 or another process explicitly enables it.
84 Release the process and terminate it with
86 This option takes precedence over all other values that may be passed in to
92 function is similar to the
94 function in that it frees the resources associated with the process
99 function, it does not handle any logic to change or set the grabbed processes
105 .Sh INTERFACE STABILITY
117 .Xr Pgrab_core 3PROC ,