Description: Manual Page

Keywords: ss7 ss7/ip ss7 over ip ss7 mtp ss7 sccp ss7 tcap sigtran mtp sccp tcap openss7 acb56 linux telephony pstn linux telephony linux nebs linux compactpci

---

COPYIN

Section: Linux Fast-STREAMS DDI/DKI (9)
Updated: 2008-10-31
Index Return to Main Contents

---

NAME

copyin - copy user data in from user space to kernel space.

SYNOPSIS

#include <sys/stream.h>
#include <sys/dki.h>

int copyin(const void *from, void *to, size_t len);

ARGUMENTS

from

a pointer to user memory where data is to be copied from.

to

a pointer to kernel memory where data is to be copied to.

len

the length of the data to copy.

INTERFACE

DDI/DKI.

DESCRIPTION

copyin() verifies that len bytes of memory at current user-space address from are valid for read and then copies those bytes to the kernel address to.

RETURN

Upon success, copyin() copies the requested bytes and returns zero (0). Upon failure, copyin() does nothing but return a negative error number.

ERRORS

Upon failure, copyin() does nothing but return an appropriate negative error number as follows:

[EFAULT]

the buffer specified by from and len extends outside the user's valid address space.

CONTEXT

copyin() can only be called from user context.

MP-STREAMS

copyin() is MP-safe and does not require the holding of any global locks.

IMPLEMENTATION

copyin() simply calls the Linux copy_from_user(9) function, with the first two arguments reversed. If optimization is used, the call is inlined.

SEE ALSO

copyout(9), copy_from_user(9), copy_to_user(9).

BUGS

copyin() has no known bugs.

COMPATIBILITY

copyin() is compatible with SVR 4.2 MP DDI/DKI[1], and implementations based on SVR 4[2], with the following portability considerations:

---

copyin() runs faster than the LiS equivalent.

---

Binary compatibility is not guaranteed.

See STREAMS(9) for additional compatibility information.

CONFORMANCE

SVR 4.2 MP DDI/DKI[1].

HISTORY

copyin() first appeared (for use by STREAMS devices) in SVR 3[3].

REFERENCES

[1]

USL DDI/DKI, Device Driver Interface/Driver-Kernel Interface (DDI/DKI) Reference Manual for Intel Processors, 1992, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.

[2]

SVR 4 DDI/DKI, UNIX® System V Release 4 Device Driver Interface/Driver-Kernel Interface (DDI/DKI) Reference Manual, 1990, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.

[3]

SVR 3, UNIX® System V Release 3 Programmer's Manual, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.

TRADEMARKS

OpenSS7tm

is a trademark of OpenSS7 Corporation.

Linux®

is a registered trademark of Linus Torvalds.

UNIX®

is a registered trademark of The Open Group.

Solaris®

is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

Linux Fast-STREAMS: Package streams version 0.9.2.4 released 2008-10-31.

Copyright©1997-2008OpenSS7 Corp. All Rights Reserved.
(See roff source for permission notice.)

---

Index

NAME

SYNOPSIS

ARGUMENTS

INTERFACE

DESCRIPTION

RETURN

ERRORS

CONTEXT

MP-STREAMS

IMPLEMENTATION

SEE ALSO

BUGS

COMPATIBILITY

CONFORMANCE

HISTORY

REFERENCES

TRADEMARKS

IDENTIFICATION

---

This document was created by man2html, using the manual pages.
Time: 16:54:32 GMT, May 21, 2013