NAME    [Toc]    [Back]

       copyoutstr - General: Copies a null-terminated string from
       a kernel address space to a user address space

SYNOPSIS    [Toc]    [Back]

       int copyoutstr(
               char *kernel_src,
               char *user_dest,
               int maxlength,
               int *lencopied );

ARGUMENTS    [Toc]    [Back]

       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    [Toc]    [Back]

       The copyoutstr routine copies a specified  null-terminated
       string  from  the  protected  kernel  address space to the
       unprotected user address space.

CAUTIONS    [Toc]    [Back]

       If the string being copied is not  null-terminated,  copyoutstr
 copies maxlength bytes into the user address space.

RETURN VALUES    [Toc]    [Back]

       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    [Toc]    [Back]

       Routines: copyinstr(9r)



                                                   copyoutstr(9r)