From 401643c23eeacf0d38521756311196f5fdcfbdf0 Mon Sep 17 00:00:00 2001 From: "Chris D. Faulhaber" Date: Wed, 17 Jan 2001 20:51:20 +0000 Subject: [PATCH] Clarify comments referring to strlcat() usage Obtained from: OpenBSD --- lib/libc/string/strlcpy.3 | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/lib/libc/string/strlcpy.3 b/lib/libc/string/strlcpy.3 index bc20d4595c1..c26a6f31721 100644 --- a/lib/libc/string/strlcpy.3 +++ b/lib/libc/string/strlcpy.3 @@ -59,8 +59,29 @@ and take the full size of the buffer (not just the length) and guarantee to NUL-terminate the result (as long as .Fa size -is larger than 0). Note that you should include a byte for the NUL in +is larger than 0 or, in the case of +.Fn strlcat , +as long as there is at least one byte free in +.Fa dst ) . +Note that you should include a byte for the NUL in .Fa size . +Also note that +.Fn strlcpy +and +.Fn strlcat +only operate on true +.Dq C +strings. +This means that for +.Fn strlcpy +.Fa src +must be NUL-terminated and for +.Fn strlcat +both +.Fa src +and +.Fa dst +must be NUL-terminated. .Pp The .Fn strlcpy