From 339c056f856313e215baab8ddc4bc0ce064b4571 Mon Sep 17 00:00:00 2001 From: schwarze <> Date: Mon, 25 Jul 2011 00:38:53 +0000 Subject: update HISTORY and SEE ALSO for all of string(3), together with various smaller improvements; jmc@ and nicm@ both ask me to get this in because further tweaking will be easier in-tree --- src/lib/libc/string/wcscpy.3 | 34 ++++++++++++++++++++++++++++++---- 1 file changed, 30 insertions(+), 4 deletions(-) (limited to 'src/lib/libc/string/wcscpy.3') diff --git a/src/lib/libc/string/wcscpy.3 b/src/lib/libc/string/wcscpy.3 index a71d54f886..dcc375acbf 100644 --- a/src/lib/libc/string/wcscpy.3 +++ b/src/lib/libc/string/wcscpy.3 @@ -1,3 +1,5 @@ +.\" $OpenBSD: wcscpy.3,v 1.2 2011/07/25 00:38:53 schwarze Exp $ +.\" .\" Copyright (c) 1990, 1991 The Regents of the University of California. .\" All rights reserved. .\" @@ -29,9 +31,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $OpenBSD: wcscpy.3,v 1.1 2011/07/09 16:32:11 nicm Exp $ -.\" -.Dd $Mdocdate: July 9 2011 $ +.Dd $Mdocdate: July 25 2011 $ .Dt WCSCPY 3 .Os .Sh NAME @@ -51,7 +51,9 @@ .Sh DESCRIPTION The .Fn wcscpy -function copies the wide string +and +.Fn wcsncpy +functions copy the wide string .Fa src to .Fa dst @@ -83,6 +85,9 @@ and functions return .Fa dst . .Sh SEE ALSO +.Xr strcpy 3 , +.Xr strlcpy 3 , +.Xr wcscat 3 , .Xr wcslcpy 3 , .Xr wmemcpy 3 , .Xr wmemmove 3 @@ -95,3 +100,24 @@ functions conform to .St -isoC-99 and were first introduced in .St -isoC-amd1 . +.Sh HISTORY +The +.Fn wcscpy +and +.Fn wcsncpy +functions were ported from +.Nx +and first appeared in +.Ox 3.8 . +.Sh CAVEATS +Using the functions +.Fn wcscpy +and +.Fn wcsncpy +is very error-prone with respect to buffer overflows; +see the EXAMPLES section in +.Xr strcpy 3 +for correct usage. +Using +.Xr wcslcpy 3 +is a better choice in most cases. -- cgit v1.2.3-55-g6feb