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  identi-
     fied  by  lid,  and ps_lsetregs() sets them. ps_lgetfpregs()
     gets  the  LWP's  floating   point   register   set,   while
     ps_lsetfpregs() sets it.

|    ps_lgetxregsize(), ps_lgetxregs(), and ps_lsetxregs() are
|    system dependent. 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. On systems that do not support
|    extra state registers, these functions will return
|    PS_NOXREGS. 


RETURN VALUES
     PS_OK           The call returned successfully.


     PS_NOFPREGS     Floating point registers are neither  avail-
                     able for this architecture nor for this pro-
                     cess.


|    PS_NOXREGS      Extra state registers are not available on
|                    this system.


     PS_ERR          The function did not return successfully.


ATTRIBUTES
     See attributes(5) for description of  the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT Level                    | Safe                        |
    |_____________________________|_____________________________|


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