copyoutstr(9r)copyoutstr(9r)NAMEcopyoutstr - General: Copies a null-terminated string from a kernel
address space to a user address space
SYNOPSIS
int copyoutstr(
char *kernel_src,
char *user_dest,
int maxlength,
int *lencopied );
ARGUMENTS
Specifies the address in kernel space of the null-terminated string to
be copied. Specifies the address in user space to copy the null-termi‐
nated string to. Specifies the maximum number of bytes to copy. Spec‐
ifies the actual length of the string copied.
DESCRIPTION
The copyoutstr routine copies a specified null-terminated string from
the protected kernel address space to the unprotected user address
space.
CAUTIONS
If the string being copied is not null-terminated, copyoutstr copies
maxlength bytes into the user address space.
RETURN VALUES
Upon successful completion, copyoutstr returns the value 0 (zero) and
the actual length of the string copied in lencopied. Otherwise, it can
return the following errors: The address in kernel space that you spec‐
ified in the kernel_src argument cannot be accessed. The length of the
string exceeds the maxlength value.
SEE ALSO
Routines: copyinstr(9r)copyoutstr(9r)