BSD 4_4 development
[unix-history] / usr / share / man / cat3 / kvm_read.0
KVM_READ(3) BSD Programmer's Manual KVM_READ(3)
N\bNA\bAM\bME\bE
k\bkv\bvm\bm_\b_r\bre\bea\bad\bd, k\bkv\bvm\bm_\b_w\bwr\bri\bit\bte\be - read or write kernel virtual memory
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<k\bkv\bvm\bm.\b.h\bh>\b>
_\bs_\bs_\bi_\bz_\be_\b__\bt
k\bkv\bvm\bm_\b_r\bre\bea\bad\bd(_\bk_\bv_\bm_\b__\bt _\b*_\bk_\bd, _\bu_\b__\bl_\bo_\bn_\bg _\ba_\bd_\bd_\br, _\bv_\bo_\bi_\bd _\b*_\bb_\bu_\bf, _\bs_\bi_\bz_\be_\b__\bt _\bn_\bb_\by_\bt_\be_\bs);
_\bs_\bs_\bi_\bz_\be_\b__\bt
k\bkv\bvm\bm_\b_w\bwr\bri\bit\bte\be(_\bk_\bv_\bm_\b__\bt _\b*_\bk_\bd, _\bu_\b__\bl_\bo_\bn_\bg _\ba_\bd_\bd_\br, _\bc_\bo_\bn_\bs_\bt _\bv_\bo_\bi_\bd _\b*_\bb_\bu_\bf, _\bs_\bi_\bz_\be_\b__\bt _\bn_\bb_\by_\bt_\be_\bs);
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
The k\bkv\bvm\bm_\b_r\bre\bea\bad\bd() and k\bkv\bvm\bm_\b_w\bwr\bri\bit\bte\be() functions are used to read and write ker-
nel virtual memory (or a crash dump file). See k\bkv\bvm\bm_\b_o\bop\bpe\ben\bn(_\b3) or
k\bkv\bvm\bm_\b_o\bop\bpe\ben\bnf\bfi\bil\ble\bes\bs(_\b3) for information regarding opening kernel virtual memory
and crash dumps.
The k\bkv\bvm\bm_\b_r\bre\bea\bad\bd() function transfers _\bn_\bb_\by_\bt_\be_\bs bytes of data from the kernel
space address _\ba_\bd_\bd_\br to _\bb_\bu_\bf. Conversely, k\bkv\bvm\bm_\b_w\bwr\bri\bit\bte\be() transfers data from
_\bb_\bu_\bf to _\ba_\bd_\bd_\br. Unlike their SunOS counterparts, these functions cannot be
used to read or write process address spaces.
R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bES\bS
Upon success, the number of bytes actually transferred is returned. Oth-
erwise, -1 is returned.
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
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)
4.4BSD June 4, 1993 1