Manual Pages for UNIX Operating System command usage for man ps_pread

Process Control Library Functions                 ps_pread(3PROC)



NAME
     ps_pread,  ps_pwrite,  ps_pdread,   ps_pdwrite,   ps_ptread,
     ps_ptwrite  - interfaces in libthread_db that target process
     memory access

SYNOPSIS
     #include 

     ps_err_e ps_pread(struct ps_prochandle *ph, psaddr_t addr,
          void *buf, size_t size);


     ps_err_e ps_pwrite(struct ps_prochandle *ph, psaddr_t addr,
          const void *buf, size_t size);


     ps_err_e ps_pdread(struct ps_prochandle *ph, psaddr_t addr,
          void *buf, size_t size);


     ps_err_e ps_pdwrite(struct ps_prochandle *ph, psaddr_t addr,
          const void *buf, size_t size);


     ps_err_e ps_ptread(struct ps_prochandle *ph, psaddr_t addr,
          void *buf, size_t size);


     ps_err_e ps_ptwrite(struct ps_prochandle *ph, psaddr_t addr,
          const void *buf, size_t size);


DESCRIPTION
     These  routines  copy  data  between  the  target  process's
     address space and the controlling process. ps_pread() copies
     size bytes from address addr in the target process into  buf
     in  the  controlling process. pr_pwrite() is like ps_pread()
     except that the direction of the copy is reversed;  data  is
     copied from the controlling process to the target process.


     ps_pdread()   and   ps_ptread()   behave   identically    to
     ps_pread(). ps_pdwrite() and ps_ptwrite() behave identically
     to ps_pwrite(). These functions can be implemented as simple
     aliases  for  the  corresponding primary functions. They are
     artifacts of history that must be maintained.

RETURN VALUES
     PS_OK         The call  returned  successfully.  size  bytes
                   were copied.





SunOS 5.11          Last change: 12 Oct 2007                    1






Process Control Library Functions                 ps_pread(3PROC)



     PS_BADADDR    Some part  of  the  address  range  from  addr
                   through  addr+size-1 is not part of the target
                   process's address space.


     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),    librtld_db(3LIB),     proc_service(3PROC),
     rtld_db(3EXT), attributes(5), threads(5)































SunOS 5.11          Last change: 12 Oct 2007                    2