Process Control Library Functions                 pspread(3PROC)



NAME
     pspread,  pspwrite,  pspdread,   pspdwrite,   psptread,
     psptwrite  - interfaces in libthreaddb that target process
     memory access

SYNOPSIS
     #include 

     pserre pspread(struct psprochandle *ph, psaddrt addr,
          void *buf, sizet size);


     pserre pspwrite(struct psprochandle *ph, psaddrt addr,
          const void *buf, sizet size);


     pserre pspdread(struct psprochandle *ph, psaddrt addr,
          void *buf, sizet size);


     pserre pspdwrite(struct psprochandle *ph, psaddrt addr,
          const void *buf, sizet size);


     pserre psptread(struct psprochandle *ph, psaddrt addr,
          void *buf, sizet size);


     pserre psptwrite(struct psprochandle *ph, psaddrt addr,
          const void *buf, sizet size);


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


     pspdread()   and   psptread()   behave   identically    to
     pspread(). pspdwrite() and psptwrite() behave identically
     to pspwrite(). These functions can be implemented as simple
     aliases  for  the  corresponding primary functions. They are
     artifacts of history that must be maintained.

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





SunOS 5.11          Last change: 12 Oct 2007                    1






Process Control Library Functions                 pspread(3PROC)



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


     PSER        The function did not return successfully.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT Level                     Safe                        
    


SEE ALSO
     libcdb(3LIB),    librtlddb(3LIB),     procservice(3PROC),
     rtlddb(3EXT), attributes(5), threads(5)































SunOS 5.11          Last change: 12 Oct 2007                    2