Index for Section 9r

Alphabetical listing for C

Bottom of page

copyinstr(9r)
NAME
  copyinstr - General: Copies a null-terminated string from a user address
  space to a kernel address space

SYNOPSIS
  int copyinstr(
	  char *user_src,
	  char *kernel_dest,
	  int maxlength,
	  int *lencopied );

ARGUMENTS
  user_src
      Specifies the address in user space of the null-terminated string to be
      copied.

  kernel_dest
      Specifies the address in kernel space to copy the null-terminated
      string to.

  maxlength
      Specifies the maximum number of bytes to copy.

  lencopied
      Specifies the actual length of the string copied.

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

CAUTIONS
  If the string being copied is not null terminated, copyinstr copies
  maxlength bytes into the kernel address space.

RETURN VALUES
  Upon successful completion, copyinstr returns the value 0 (zero) and the
  actual length of the string copied to the lencopied argument. Otherwise, it
  returns one of the following error constants defined in
  /usr/sys/include/sys/errno.h:

  EFAULT  The address in user space that you specified in the user_src
	  argument cannot be accessed.

  ENAMETOOLONG
	  The length of the string exceeds the maxlength value.

SEE ALSO
  Routines: copyoutstr(9r)

Index for Section 9r

Alphabetical listing for C

Top of page