diff options
Diffstat (limited to 'src/lib/libc/string/wcscat.3')
-rw-r--r-- | src/lib/libc/string/wcscat.3 | 32 |
1 files changed, 27 insertions, 5 deletions
diff --git a/src/lib/libc/string/wcscat.3 b/src/lib/libc/string/wcscat.3 index c5321d5a2a..d0281b8bd1 100644 --- a/src/lib/libc/string/wcscat.3 +++ b/src/lib/libc/string/wcscat.3 | |||
@@ -1,3 +1,5 @@ | |||
1 | .\" $OpenBSD: wcscat.3,v 1.2 2011/07/25 00:38:53 schwarze Exp $ | ||
2 | .\" | ||
1 | .\" Copyright (c) 1990, 1991 The Regents of the University of California. | 3 | .\" Copyright (c) 1990, 1991 The Regents of the University of California. |
2 | .\" All rights reserved. | 4 | .\" All rights reserved. |
3 | .\" | 5 | .\" |
@@ -29,9 +31,7 @@ | |||
29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | 31 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF |
30 | .\" SUCH DAMAGE. | 32 | .\" SUCH DAMAGE. |
31 | .\" | 33 | .\" |
32 | .\" $OpenBSD: wcscat.3,v 1.1 2011/07/09 16:32:11 nicm Exp $ | 34 | .Dd $Mdocdate: July 25 2011 $ |
33 | .\" | ||
34 | .Dd $Mdocdate: July 9 2011 $ | ||
35 | .Dt WCSCAT 3 | 35 | .Dt WCSCAT 3 |
36 | .Os | 36 | .Os |
37 | .Sh NAME | 37 | .Sh NAME |
@@ -43,7 +43,7 @@ | |||
43 | .Ft wchar_t * | 43 | .Ft wchar_t * |
44 | .Fn wcscat "wchar_t * restrict s" "const wchar_t * restrict append" | 44 | .Fn wcscat "wchar_t * restrict s" "const wchar_t * restrict append" |
45 | .Ft wchar_t * | 45 | .Ft wchar_t * |
46 | .Fo strncat | 46 | .Fo wcsncat |
47 | .Fa "wchar_t * restrict s" | 47 | .Fa "wchar_t * restrict s" |
48 | .Fa "const wchar_t * restrict append" | 48 | .Fa "const wchar_t * restrict append" |
49 | .Fa "size_t count" | 49 | .Fa "size_t count" |
@@ -77,8 +77,9 @@ and | |||
77 | functions return the pointer | 77 | functions return the pointer |
78 | .Fa s . | 78 | .Fa s . |
79 | .Sh SEE ALSO | 79 | .Sh SEE ALSO |
80 | .Xr strcat 3 , | ||
81 | .Xr strlcpy 3 , | ||
80 | .Xr wcscpy 3 , | 82 | .Xr wcscpy 3 , |
81 | .Xr wcslcat 3 , | ||
82 | .Xr wcslcpy 3 , | 83 | .Xr wcslcpy 3 , |
83 | .Xr wmemcpy 3 , | 84 | .Xr wmemcpy 3 , |
84 | .Xr wmemmove 3 | 85 | .Xr wmemmove 3 |
@@ -91,3 +92,24 @@ functions conform to | |||
91 | .St -isoC-99 | 92 | .St -isoC-99 |
92 | and were first introduced in | 93 | and were first introduced in |
93 | .St -isoC-amd1 . | 94 | .St -isoC-amd1 . |
95 | .Sh HISTORY | ||
96 | The | ||
97 | .Fn wcscat | ||
98 | and | ||
99 | .Fn wcsncat | ||
100 | functions were ported from | ||
101 | .Nx | ||
102 | and first appeared in | ||
103 | .Ox 3.8 . | ||
104 | .Sh CAVEATS | ||
105 | Using the functions | ||
106 | .Fn wcscat | ||
107 | and | ||
108 | .Fn wcsncat | ||
109 | is very error-prone with respect to buffer overflows; | ||
110 | see the EXAMPLES section in | ||
111 | .Xr strcat 3 | ||
112 | for correct usage. | ||
113 | Using | ||
114 | .Xr wcslcat 3 | ||
115 | is a better choice in most cases. | ||