Content-type: text/html Man page of kvm_kread

kvm_kread

Section: Kernel VM Library Functions (3KVM)
Updated: 2 May 2002
Index Return to Main Contents
 

NAME

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

SYNOPSIS

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

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

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.

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.

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.

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.  

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
Interface StabilityStable
MT-LevelUnsafe

 

SEE ALSO

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


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:38:32 GMT, October 02, 2010