opensolaris man page for ps_ptwrite

ps_pread(3PROC) 					 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 <proc_service.h>

       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 func-
       tions 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.

       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 attributes:

       +-----------------------------+-----------------------------+
       |      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							    12 Oct 2007 						   ps_pread(3PROC)