ps_lgetregs(3PROC)					 Process Control Library Functions					ps_lgetregs(3PROC)

NAME

       ps_lgetregs,  ps_lsetregs,  ps_lgetfpregs,  ps_lsetfpregs,  ps_lgetxregsize,  ps_lgetxregs,  ps_lsetxregs - routines that access the target
       process register in libthread_db

SYNOPSIS

       #include <proc_service.h>

	ps_err_e ps_lgetregs(struct ps_prochandle *ph, lwpid_t lid, prgregset_t gregset);

       ps_err_e ps_lsetregs(struct ps_prochandle *ph, lwpid_t lid, static prgregset_t gregset);

       ps_err_e ps_lgetfpregs(struct ps_prochandle *ph, lwpid_t lid, prfpregset_t *fpregs);

       ps_err_e ps_lsetfpregs(struct ps_prochandle *ph, lwpid_t lid, static prfpregset_t *fpregs);

       ps_err_e ps_lgetxregsize(struct ps_prochandle *ph, lwpid_t lid, int *xregsize);

       ps_err_e ps_lgetxregs(struct ps_prochandle *ph, lwpid_t lid, caddr_t xregset);

       ps_err_e ps_lsetxregs(struct ps_prochandle *ph, lwpid_t lid, caddr_t xregset);

DESCRIPTION

       ps_lgetregs(), ps_lsetregs(), ps_lgetfpregs(), ps_lsetfpregs(), ps_lgetxregsize(), ps_lgetxregs(), ps_lsetxregs() read and  write  register
       sets  from  lightweight	processes  (LWPs)  within the target process identified by ph. ps_lgetregs() gets the general registers of the LWP
       identified by lid, and ps_lsetregs() sets them. ps_lgetfpregs() gets the LWP's floating point register set, while ps_lsetfpregs() sets it.

   SPARC Only
       ps_lgetxregsize(),ps_lgetxregs(), andps_lsetxregs() are SPARC-specific. They do not need to be defined by a  controlling  process  on  non-
       SPARC  architecture.  ps_lgetxregsize()	returns  in *xregsize the size of the architecture-dependent extra state registers. ps_lgetxregs()
       gets the extra state registers, and ps_lsetxregs() sets them.

RETURN VALUES

       PS_OK	       The call returned successfully.

       PS_NOFPREGS     Floating point registers are neither available for this architecture nor for this process.

       PS_NOXREGS      Extra state registers are not available on this architecture.

       PS_ERR	       The function did not return successfully.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       libc_db(3LIB), proc_service(3PROC), attributes(5), threads(5)

SunOS 5.10							    30 Jan 1998 						ps_lgetregs(3PROC)