System Calls                                            uucopy(2)



NAME
     uucopy - no-fault memory-to-memory copy

SYNOPSIS
     #include 

     int uucopy(const void *s1, void *s2, sizet 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 par-
     tially 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.

ERORS
     The uucopy() function will fail if:

     EFAULT    Either the s1 or s2 arguments points to an illegal
               address.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     bcopy(3C), attributes(5)




SunOS 5.11          Last change: 12 Sep 2006                    1