Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Kernel VM Library Functionskvm_read(3KVM)


NAME

 kvm_read, kvm_write, kvm_uread, kvm_uwrite, kvm_kread, kvm_kwrite - copy data to or from a kernel image or running system

SYNOPSIS

 
#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);
 ssize_t kvm_kread(kvm_t *kd, uintptr_t addr, void *buf, size_t nbytes);
 ssize_t kvm_kwrite(kvm_t *kd, uintptr_t addr, void *buf, size_t nbytes);
 ssize_t kvm_uread(kvm_t *kd, uintptr_t addr, void *buf, size_t nbytes);
 ssize_t kvm_uwrite(kvm_t *kd, uintptr_t addr, void *buf, size_t nbytes);

DESCRIPTION

 

kvm_kread

 

The kvm_kread() function transfers data from the kernel address space 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.

kvm_kwrite

 

The kvm_kwrite() function is like kvm_kread(), except that the direction of the transfer is reversed. To use this function, the kvm_open(3KVM) call that returned kd must have specified write access.

kvm_uread

 

The kvm_uread() function transfers data from the address space of the processes specified in the most recent kvm_getu(3KVM) call. nbytes bytes of data are copied from the user virtual address given by addr to the buffer pointed to by buf.

kvm_uwrite

 

The kvm_uwrite() function is like kvm_uread(), except that the direction of the transfer is reversed. To use this function, the kvm_open(3KVM) call that returned kd must have specified write access. The address is resolved in the address space of the process specified in the most recent kvm_getu(3KVM) call.

kvm_read

 

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.

kvm_write

 

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 use of kvm_read() and kvm_write() is strongly discouraged. On some platforms, there is considerable ambiguity over which address space is to be accessed by these functions, possibly leading to unexpected results. The kvm_kread(), kvm_kwrite(), kvm_uread(), and kvm_uwrite() functions are much more clearly defined in this respect.

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 TYPEATTRIBUTE VALUE
MT-LevelUnsafe

SEE ALSO

 

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


SunOS 5.9Go To TopLast Changed 22 Sep 1997

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.