1uucopy(2)                        System Calls                        uucopy(2)
2
3
4

NAME

6       uucopy - no-fault memory-to-memory copy
7

SYNOPSIS

9       #include <strings.h>
10
11       int uucopy(const void *s1, void *s2, size_t n);
12
13

DESCRIPTION

15       The  uucopy() function copies n bytes from memory area s1 to s2.  Copy‐
16       ing  between objects that overlap could corrupt one or both buffers.
17
18
19       Unlike bcopy(3C), uucopy() does  not  cause  a  segmentation  fault  if
20       either  the  source  or destination buffer includes an illegal address.
21       Instead, it returns −1 and sets errno to EFAULT. This error could occur
22       after  the  operation  has  partially completed, so the contents of the
23       buffer at s2 are defined if the operation fails.
24

RETURN VALUES

26       Upon successful completion, uucopy() returns 0.  Otherwise,  the  func‐
27       tion returns −1 and  set errno to indicate the error.
28

ERRORS

30       The uucopy() function will fail if:
31
32       EFAULT    Either the s1 or s2 arguments points to an illegal address.
33
34

ATTRIBUTES

36       See attributes(5) for descriptions of the following attributes:
37
38
39
40
41       ┌─────────────────────────────┬─────────────────────────────┐
42       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
43       ├─────────────────────────────┼─────────────────────────────┤
44       │Interface Stability          │Evolving                     │
45       ├─────────────────────────────┼─────────────────────────────┤
46       │MT-Level                     │MT-Safe                      │
47       └─────────────────────────────┴─────────────────────────────┘
48

SEE ALSO

50       bcopy(3C), attributes(5)
51
52
53
54SunOS 5.11                        12 Sep 2006                        uucopy(2)
Impressum