man/man3kvm/kvm_read.3kvm

         te
 Copyright (c) 2002, Sun Microsystems, Inc. All Rights Reserved
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License.
 You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License.
 When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 KVM_READ 3KVM "May 2, 2002"
 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)