Loading...
--- Libc/Libc-498.1.7/string/strcpy.3
+++ Libc/Libc-262.3.2/string/strcpy.3
@@ -34,73 +34,53 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)strcpy.3 8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/string/strcpy.3,v 1.24 2002/12/19 09:40:24 ru Exp $
+.\" $FreeBSD: src/lib/libc/string/strcpy.3,v 1.11 2001/10/01 16:09:00 ru Exp $
.\"
.Dd August 9, 2001
.Dt STRCPY 3
.Os
.Sh NAME
-.Nm stpcpy ,
-.Nm strcpy ,
-.Nm strncpy
+.Nm strcpy , strncpy
.Nd copy strings
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In string.h
.Ft char *
-.Fo stpcpy
-.Fa "char *s1"
-.Fa "const char *s2"
-.Fc
+.Fn strcpy "char *dst" "const char *src"
.Ft char *
-.Fo strcpy
-.Fa "char *restrict s1"
-.Fa "const char *restrict s2"
-.Fc
-.Ft char *
-.Fo strncpy
-.Fa "char *restrict s1"
-.Fa "const char *restrict s2"
-.Fa "size_t n"
-.Fc
+.Fn strncpy "char *dst" "const char *src" "size_t len"
.Sh DESCRIPTION
The
-.Fn stpcpy
-and
.Fn strcpy
-functions
-copy the string
-.Fa s2
+function
+copies the string
+.Fa src
to
-.Fa s1
+.Fa dst
(including the terminating
.Ql \e0
character).
.Pp
The
.Fn strncpy
-function copies at most
-.Fa n
+function copies not more than
+.Fa len
characters from
-.Fa s2
+.Fa src
into
-.Fa s1 .
-If
-.Fa s2
+.Fa dst ,
+appending
+.Ql \e0
+characters if
+.Fa src
is less than
-.Fa n
-characters long,
-the remainder of
-.Fa s1
-is filled with
-.Ql \e0
-characters.
-Otherwise,
-.Fa s1
-is
+.Fa len
+characters long, and
.Em not
-terminated.
+terminating
+.Fa dst
+otherwise.
.Sh RETURN VALUES
The
.Fn strcpy
@@ -108,13 +88,7 @@
.Fn strncpy
functions
return
-.Fa s1 .
-The
-.Fn stpcpy
-function returns a pointer to the terminating
-.Ql \e0
-character of
-.Fa s1 .
+.Fa dst .
.Sh EXAMPLES
The following sets
.Va chararray
@@ -140,9 +114,9 @@
.Em not
.Tn NUL
terminate
-.Va chararray ,
+.Va chararray
because the length of the source string is greater than or equal
-to the length argument.
+to the length parameter.
.Pp
The following copies as many characters from
.Va input
@@ -171,20 +145,10 @@
.Pp
.Dl "(void)strlcpy(buf, input, sizeof(buf));"
.Pp
-Note that, because
+Note that because
.Xr strlcpy 3
is not defined in any standards, it should
only be used when portability is not a concern.
-.Sh SECURITY CONSIDERATIONS
-The
-.Fn strcpy
-function is easily misused in a manner which enables malicious users
-to arbitrarily change a running program's functionality through a
-buffer overflow attack.
-(See
-the FSA
-and
-.Sx EXAMPLES . )
.Sh SEE ALSO
.Xr bcopy 3 ,
.Xr memccpy 3 ,
@@ -199,16 +163,3 @@
functions
conform to
.St -isoC .
-The
-.Fn stpcpy
-function is an MS-DOS and GNUism.
-The
-.Fn stpcpy
-function
-conforms to no standard.
-.Sh HISTORY
-The
-.Fn stpcpy
-function first appeared in
-.Fx 4.4 ,
-coming from 1998-vintage Linux.