copyin(9) kernel copy functions

Other Alias

copy, copyin_nofault, copyout, copyout_nofault, copystr, copyinstr

SYNOPSIS

In sys/types.h In sys/systm.h Ft int Fn copyin const void *uaddr void *kaddr size_t len Ft int Fn copyin_nofault const void *uaddr void *kaddr size_t len Ft int Fn copyout const void *kaddr void *uaddr size_t len Ft int Fn copyout_nofault const void *kaddr void *uaddr size_t len Ft int Fn copystr const void *kfaddr void *kdaddr size_t len size_t *done Ft int Fn 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 Fn copystr copy data from user-space to kernel-space or vice-versa.

The Fn copyin and Fn copyin_nofault functions copy Fa len bytes of data from the user-space address Fa uaddr to the kernel-space address Fa kaddr .

The Fn copyout and Fn copyout_nofault functions copy Fa len bytes of data from the kernel-space address Fa kaddr to the user-space address Fa uaddr .

The Fn copyin_nofault and Fn copyout_nofault functions require that the kernel-space and user-space data be accessible without incurring a page fault. The source and destination addresses must be physically mapped for read and write access, respectively, and neither the source nor destination addresses may be pageable.

The Fn copystr function 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

The Fn copyinstr function 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 Fn copyin_nofault and Fn copyout_nofault functions return Er EFAULT if a page fault occurs, and the Fn copystr and Fn copyinstr functions return Er ENAMETOOLONG if the string is longer than Fa len bytes.