Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

kvm_read(3) [freebsd 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, 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
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

Check Out this Related Man Page

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)
Man Page