osf1 man page for copyoutstr

copyoutstr(9r)															    copyoutstr(9r)

NAME
       copyoutstr - 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-
       terminated string to.  Specifies the maximum number of bytes to copy.  Specifies 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 specified in the kernel_src argument cannot be accessed.  The  length
       of the string exceeds the maxlength value.

SEE ALSO
       Routines: copyinstr(9r)

																    copyoutstr(9r)