te
Copyright (c) 1998 Sun Microsystems, Inc. All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
td_thr_getgregs, td_thr_setgregs, td_thr_getfpregs, td_thr_setfpregs, td_thr_getxregsize, td_thr_getxregs, td_thr_setxregs - reading and writing thread registers in libc_db

cc [ flag... ] file... -lc_db [ library... ]
#include <proc_service.h>
#include <thread_db.h>

td_err_e td_thr_getgregs(const td_thrhandle_t *th_p, prgregset_tgregset);

td_err_e td_thr_setgregs(const td_thrhandle_t *th_p, prgregset_tgregset);

td_err_e td_thr_getfpregs(const td_thrhandle_t *th_p, prfpregset_t *fpregset);

td_err_e td_thr_setfpregs(const td_thrhandle_t *th_p, prfpregset_t *fpregset);

td_err_e td_thr_getxregsize(const td_thrhandle_t *th_p, int *xregsize);

td_err_e td_thr_getxregs(const td_thrhandle_t *th_p, prxregset_t *xregset);

td_err_e td_thr_setxregs(const td_thrhandle_t *th_p, prxregset_t *xregset);

These functions read and write the register sets associated with thread th_p. The td_thr_getgregs() and td_thr_setgregs() functions get and set, respectively, the general registers of thread th_p. The td_thr_getfpregs() and td_thr_setfpregs() functions get and set, respectively, the thread's floating point register set. The td_thr_getxregsize(), td_thr_getxregs(), and td_thr_setxregs() functions are SPARC-specific. The td_thr_getxregsize() function returns in *xregsize the size of the architecture-dependent extra state registers. The td_thr_getxregs() and td_thr_setxregs() functions get and set, respectively, those extra state registers. On non-SPARC architectures, these functions return TD_NOXREGS.

If the thread specified by th_p is currently executing on a lightweight process ( LWP), these functions read or write, respectively, the appropriate register set to the LWP using the imported interface. If the thread is not currently executing on an LWP, the floating point and extra state registers may cannot be read or written. Some of the general registers might also not be readable or writable, depending on the architecture, in which case td_thr_getfpregs() and td_thr_setfpregs() return TD_NOFPREGS and td_thr_getxregs() and td_thr_setxregs() will TD_NOXREGS. Calls to td_thr_getgregs() and td_thr_setgregs() succeed, but values returned for unreadable registers are undefined, values specified for unwritable registers are ignored. In this instance, and TD_PARTIALREGS is returned. See the architecture-specific notes that follow regarding the registers that may be read and written for a thread not currently executing on an LWP.

On a thread not currently assigned to an LWP, only %i0-%i7, %l0-%l7, %g7, %pc, and %sp (%o6) can be read or written. %pc and %sp refer to the program counter and stack pointer that the thread will have when it resumes execution.

On a thread not currently assigned to an LWP, only %pc, %sp, %ebp, %edi, %edi, and %ebx can be read.

TD_OK TD_BADTH TD_DBERR TD_PARTIALREGS TD_NOFPREGS TD_NOXREGS TD_ERR

See attributes(5) for description of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE

MT-Level Safe

libc_db(3LIB), attributes(5)