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.
22 .Nd set and get a register from a stopped process or thread
29 .Fa "struct ps_prochandle *P"
35 .Fa "struct ps_prochandle *P"
41 .Fa "struct ps_lwphandle *L"
47 .Fa "struct ps_lwphandle *L"
56 functions read and update the registers of the process handle referred
59 The getting and setting of registers of the process operates on the
60 representative thread (LWP).
61 For more information on how the representative is chosen, see
64 To change the registers of a specific thread, use the
70 The getting and setting of registers only applies to stopped processes.
71 In addition, one may obtain registers from core files, but not set them.
72 To stop a process, see the
76 The register to get or set is indicated by the
79 For a list of registers, see
81 The set of registers is specific to each architecture of the system.
84 function will fill in the value of
86 with the value of the register
90 function will update the value of the register
94 Updated registers will be set when the process resumes execution.
100 functions are equivalent to the
104 functions, except rather than operating on the process and its
105 representative thread, they instead operate on the thread handle
108 Upon successful completion, the
118 is set, and no registers will have been gotten or updated.
124 functions will fail if:
130 This means it is less than
136 value varies based on process architecture.
140 is neither stopped nor a core file.
144 refers to a file obtained through
145 .Xr Pgrab_file 3PROC .
152 functions will fail if:
158 This means it is less than
164 value varies based on process architecture.
168 is not stopped or refers to a non-active process.
170 .Sh INTERFACE STABILITY
181 .Xr Pgrab_file 3PROC ,