UUCOPY(2)UUCOPY(2)NAMEuucopy - 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. Copy‐
ing 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 func‐
tion 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(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Evolving │
├────────────────────┼─────────────────┤
│MT-Level │ MT-Safe │
└────────────────────┴─────────────────┘
SEE ALSObcopy(3C), attributes(5)
Sep 12, 2006 UUCOPY(2)
