kvm_read(3) [netbsd man page]

KVM_READ(3)						   BSD Library Functions Manual 					       KVM_READ(3)

NAME

     kvm_read, kvm_write -- read or write kernel virtual memory

LIBRARY

     Kernel Data Access Library (libkvm, -lkvm)

SYNOPSIS

     #include <kvm.h>

     ssize_t
     kvm_read(kvm_t *kd, u_long addr, void *buf, size_t nbytes);

     ssize_t
     kvm_write(kvm_t *kd, u_long addr, const void *buf, size_t nbytes);

DESCRIPTION

     The kvm_read() and kvm_write() functions are used to read and write kernel virtual memory (or a crash dump file).	See kvm_open(3) or
     kvm_openfiles(3) for information regarding opening kernel virtual memory and crash dumps.

     The kvm_read() function transfers nbytes bytes of data from the kernel space address addr to buf.	Conversely, kvm_write() transfers data
     from buf to addr.	Unlike their SunOS counterparts, these functions cannot be used to read or write process address spaces.

RETURN VALUES

     Upon success, the number of bytes actually transferred is returned.  Otherwise, -1 is returned.

SEE ALSO

     kvm(3), kvm_close(3), kvm_getargv(3), kvm_getenvv(3), kvm_geterr(3), kvm_getprocs(3), kvm_nlist(3), kvm_open(3), kvm_openfiles(3)

BSD
								   June 4, 1993 							       BSD

kvm_read(3KVM)						    Kernel VM Library Functions 					    kvm_read(3KVM)

NAME

       kvm_read, kvm_write - copy data to or from a kernel image or running system

SYNOPSIS

       cc [ flag... ] file... -lkvm [ library...]
       #include <kvm.h>

       ssize_t kvm_read(kvm_t *kd, uintptr_t addr, void *buf, size_t nbytes);

       ssize_t kvm_write(kvm_t *kd, uintptr_t addr, void *buf, size_t nbytes);

DESCRIPTION

       The  kvm_read()	function  transfers  data  from the kernel image specified by kd (see kvm_open(3KVM)) to the address space of the process.
       nbytes bytes of data are copied from the kernel virtual address given by addr to the buffer pointed to by buf.

       The kvm_write() function is like kvm_read(), except  that  the  direction  of  data  transfer  is  reversed.  To  use  this  function,  the
       kvm_open(3KVM)  call  that  returned kd must have specified write access. If a user virtual address is given, it is resolved in the address
       space of the process specified in the most recent kvm_getu(3KVM) call.

USAGE

       The kvm_read() and kvm_write() functions are obsolete  and  might  be  removed  in  a  future  release.	The  functions	described  on  the
       kvm_kread(3KVM) manual page should be used instead.

RETURN VALUES

       On success, these functions return the number of bytes actually transferred. On failure, they return -1.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Obsolete			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Unsafe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       kvm_getu(3KVM), kvm_kread(3KVM)kvm_nlist(3KVM), kvm_open(3KVM), attributes(5)

SunOS 5.10							    2 May 2002							    kvm_read(3KVM)