Manual Pages for UNIX Operating System command usage for man ps_lsetregs

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 

      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.

  SPARC Only
     ps_lgetxregsize(),ps_lgetxregs(),   andps_lsetxregs()    are
     SPARC-specific. They do not need to be defined by a control-
     ling 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



SunOS 5.11          Last change: 30 Jan 1998                    1






Process Control Library Functions              ps_lgetregs(3PROC)



     registers, and ps_lsetxregs() sets them.

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 architecture.


     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)





















SunOS 5.11          Last change: 30 Jan 1998                    2