#include <sys/types.h>
#include <sys/systm.h> int
copyin (const void *uaddr void *kaddr size_t len); int
copyout (const void *kaddr void *uaddr size_t len); int
copystr (const void *kfaddr void *kdaddr size_t len size_t *done); int
copyinstr (const void *uaddr void *kaddr size_t len size_t *done);
DESCRIPTION
The
functions are designed to copy contiguous data from one address
to another.
All but
copystr ();
copy data from user-space to kernel-space or vice-versa.
The
routines provide the following functionality:
Fn copyin
Copies
Fa len
bytes of data from the user-space address
Fa uaddr
to the kernel-space address
Fa kaddr .
Fn copyout
Copies
Fa len
bytes of data from the kernel-space address
Fa kaddr
to the user-space address
Fa uaddr .
Fn copystr
Copies a NUL-terminated string, at most
Fa len
bytes long, from kernel-space address
Fa kfaddr
to kernel-space address
Fa kdaddr .
The number of bytes actually copied, including the terminating
NUL, is returned in
Fa *done
(if
Fa done
is
non- NULL
Fn copyinstr
Copies a NUL-terminated string, at most
Fa len
bytes long, from user-space address
Fa uaddr
to kernel-space address
Fa kaddr .
The number of bytes actually copied, including the terminating
NUL, is returned in
Fa *done
(if
Fa done
is
non- NULL
RETURN VALUES
The
functions return 0 on success or
Er EFAULT
if a bad address is encountered.
In addition, the
copystr (,);
and
copyinstr ();
functions return
Er ENAMETOOLONG
if the string is longer than
Fa len
bytes.
