UUCOPY(2) System Calls UUCOPY(2)
NAME
uucopy - no-fault memory-to-memory copy
SYNOPSIS
#include <strings.h>
int uucopy(
const void *s1,
void *s2,
size_t n);
DESCRIPTION
The
uucopy() function copies
n bytes from memory area
s1 to
s2.
Copying between objects that overlap could corrupt one or both
buffers.
Unlike
bcopy(3C),
uucopy() does not cause a segmentation fault if
either the source or destination buffer includes an illegal address.
Instead, it returns -1 and sets
errno to
EFAULT. This error could
occur after the operation has partially completed, so the contents of
the buffer at
s2 are defined if the operation fails.
RETURN VALUES
Upon successful completion,
uucopy() returns 0. Otherwise, the
function returns -1 and set
errno to indicate the error.
ERRORS
The
uucopy() function will fail if:
EFAULT Either the
s1 or
s2 arguments points to an illegal address.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+
SEE ALSO
bcopy(3C),
attributes(7) September 12, 2006 UUCOPY(2)
