'\" te
.\" Copyright (c) 2006, Sun Microsystems, Inc. All Rights Reserved.
.TH uucopy 2 "12 Sep 2006" "SunOS 5.11" "System Calls"
.SH NAME
uucopy \- no-fault memory-to-memory copy
.SH SYNOPSIS
.LP
.nf
#include <strings.h>

\fBint\fR \fBuucopy\fR(\fBconst void *\fR\fIs1\fR, \fBvoid *\fR\fIs2\fR, \fBsize_t\fR \fIn\fR);
.fi

.SH DESCRIPTION
.sp
.LP
The \fBuucopy()\fR function copies \fIn\fR bytes from memory area \fIs1\fR to \fIs2\fR.  Copying  between objects that overlap could corrupt one or both buffers.
.sp
.LP
Unlike \fBbcopy\fR(3C), \fBuucopy()\fR does not cause a segmentation fault if either the source or destination buffer includes an illegal address. Instead, it returns \(mi1 and sets \fBerrno\fR to \fBEFAULT\fR. This error could occur after the operation has partially completed, so the contents of the buffer at \fIs2\fR are defined if the operation fails.
.SH RETURN VALUES
.sp
.LP
Upon successful completion, \fBuucopy()\fR returns 0.  Otherwise, the function returns \(mi1 and  set \fBerrno\fR to indicate the error.
.SH ERRORS
.sp
.LP
The \fBuucopy()\fR function will fail if:
.sp
.ne 2
.mk
.na
\fB\fBEFAULT\fR\fR
.ad
.RS 10n
.rt  
Either the \fIs1\fR or \fIs2\fR arguments points to an illegal address.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelMT-Safe
.TE

.SH SEE ALSO
.sp
.LP
\fBbcopy\fR(3C), \fBattributes\fR(5)