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

---

COPYOUT

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

---

NAME

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

SYNOPSIS

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

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

ARGUMENTS

from

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

to

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

len

the length of the data to copy.

INTERFACE

DDI/DKI.

DESCRIPTION

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

RETURN

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

ERRORS

Upon failure, copyout() 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

copyout() can only be called from user context.

MP-STREAMS

copyout() is MP-safe; however, the caller is responsible for ensuring exclusive access to the kernel memory to which data is being copied.

NOTICES

copyout() simply calls the Linux copy_to_user(9) function, with the first two arguments reversed. If optimization is used, the call is inline.

SEE ALSO

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

BUGS

copyout() has no known bugs.

COMPATIBILITY

copyout() is source-level compatible with SVR 4.2 MP DDI/DKI[1], Solaris® and LiS[2] with the following exceptions:

---

copyout() 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, Solaris® documentation.

HISTORY

copyout() 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]

LIS 2.18, Linux STREAMS (LiS) 2.18.6 Source Code, Brian Bidulock, ed., OpenSS7 Corporation. <http://www.openss7.org/>

[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

NOTICES

SEE ALSO

BUGS

COMPATIBILITY

CONFORMANCE

HISTORY

REFERENCES

TRADEMARKS

IDENTIFICATION

---

This document was created by man2html, using the manual pages.
Time: 08:00:29 GMT, May 22, 2013