NAME    [Toc]    [Back]

     kvm_read, kvm_write -- read or write kernel virtual memory

LIBRARY    [Toc]    [Back]

     Kernel Data Access Library (libkvm, -lkvm)

SYNOPSIS    [Toc]    [Back]

     #include <kvm.h>

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

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

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

SEE ALSO    [Toc]    [Back]

     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)


FreeBSD 5.2.1			 June 4, 1993			 FreeBSD 5.2.1