From nobody Fri May 22 14:55:36 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4gMSy228W4z6dwgJ; Fri, 22 May 2026 14:55:38 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Received: from smtp.freebsd.org (smtp.freebsd.org [IPv6:2610:1c1:1:606c::24b:4]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "smtp.freebsd.org", Issuer "R12" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4gMSy21C48z3VC7; Fri, 22 May 2026 14:55:38 +0000 (UTC) (envelope-from jhb@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1779461738; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=hWi8Y1iKKfhgxpJll2vYqMnff6NNXZQA45NQQVRcezM=; b=hcxuPPEFKfyBCiKPt9eKndWD0+ilfjIH2x39r7r3xSvQxaggLK+yEwMwWjlHMILn1Uxkrz rV4wzeicLCbhf/oUAjnV+zXong0nx3J607QlM85DuWzpupuldqVwUK0FMPKzPHnbmrdTgG SBV5IVJRb2fWkahfMqDEUUnnOwZcgeTh+iSRRg3scSs80+/NBVZu9zqP1XGd7DKfW1RC2d 9aPQ1WqsXH3Mlf85Zk0Oc9QVCQdrNLmsZ4cj+CESDmgKPqtxMILV+DfpN9nKVJvvZTU+WO CIWP7sk6ayCgHDoHpbE4CWyb6QS8rplZr51jWUnOjzK5jpWihLWKvMuvK0fVKA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1779461738; a=rsa-sha256; cv=none; b=CzQVn3u2OE1s+FwhzE9SFE9dXZ6VkYxwmqdeEhZC+p+RDJ7Pg2WI2Fix0qCZXRgFw3FDxv rH6tfBeo49RZXs+WXwZTqOhc293zq/TUkKCTNJsmA3kE8IWLNGRIBdhusVFR7l+0D8BTu/ v97s46LPdI0dH0gI2mJnqMd4HI06r5H8h3gTAYgoVxpUH6CxnsT85sz75NdQ+yoP2stK2c kCmYOetOX94ZETgjmXAudaukgnoh/kDgI+9BsG3J+qsdgH4SYlCOZp272Rn/zDl1yUV7ZX TQokiMe3lE7m6fQX96Oe6XngQcVKPPcNlphGT7DV57KEYc+N3Uv1hqPPBHodVg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1779461738; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=hWi8Y1iKKfhgxpJll2vYqMnff6NNXZQA45NQQVRcezM=; b=mtbMvmMqqpqEc5ocboJowObjzn5DNYxMi+PD4gi+d4mLHZelPcNyTgeDOoFze6rapk5R58 849sExovMja8eETTZ9NIOTsQqJOLaiT0arGv9v4vc9TeAnanBCnT4a2E4kWIToEdoz/NCv brBmX0bDfXAGdx49fVIhYUyEgN4VqsG2WtHhzI59a7ZFgaoYoMakpXgiMcVMIm3UZbPXY7 PPbpGOzffgKmE2X85LWpgLMHr6rdCDhqIe0FbLNbIShGvBUn08+80FRhkBloGy+L9xjQkW XQPBFDzx5HZMCIJbFdsqymgwCklms7OtaPxgajtSBUYHsbI2SHmxFP/DHmtIpA== Received: from [IPV6:2601:5c0:4202:5670:b084:249c:1542:22b4] (unknown [IPv6:2601:5c0:4202:5670:b084:249c:1542:22b4]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) (Authenticated sender: jhb) by smtp.freebsd.org (Postfix) with ESMTPSA id 4gMSy16DVJz17Pk; Fri, 22 May 2026 14:55:37 +0000 (UTC) (envelope-from jhb@FreeBSD.org) Message-ID: <5bc3179a-9146-4f32-b250-b64cb0ea541a@FreeBSD.org> Date: Fri, 22 May 2026 10:55:36 -0400 List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: git: 03c410ba1724 - main - man: Stop referring to non-existing manpage strlcpy(9) Content-Language: en-US To: Martin Cracauer , src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org References: <6a0f6638.3c7a0.152892aa@gitrepo.freebsd.org> From: John Baldwin In-Reply-To: <6a0f6638.3c7a0.152892aa@gitrepo.freebsd.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 5/21/26 16:08, Martin Cracauer wrote: > The branch main has been updated by cracauer: > > URL: https://cgit.FreeBSD.org/src/commit/?id=03c410ba172426aa7f2a1cc19b94250686e5c8bd > > commit 03c410ba172426aa7f2a1cc19b94250686e5c8bd > Author: Martin Cracauer > AuthorDate: 2026-05-21 20:08:08 +0000 > Commit: Martin Cracauer > CommitDate: 2026-05-21 20:08:08 +0000 > > man: Stop referring to non-existing manpage strlcpy(9) > > Reviewed by: ziaee, mhorne, kevans It might be best to not use a manpage reference here then. You can't call userspace functions from the kernel, so it is a category error for a kernel API manpage in section 9 to ever refer to calling a userspace function from sections 2 or 3. There is an implementation of strlcpy int he kernel, and the point of the section 9 here was to indicate that there is a kernel version that can be called. However, there are many, many functions in section 3 that do not have equivalent implementations in the kernel and cannot be called. > --- > share/man/man9/copy.9 | 5 +++-- > 1 file changed, 3 insertions(+), 2 deletions(-) > > diff --git a/share/man/man9/copy.9 b/share/man/man9/copy.9 > index 3a3105ddf644..fe51bbd12704 100644 > --- a/share/man/man9/copy.9 > +++ b/share/man/man9/copy.9 > @@ -67,9 +67,10 @@ to another. > .Pp > .Fn copystr > is deprecated and should be replaced with > -.Xr strlcpy 9 . > +.Xr strlcpy 3 , > +which has a kernel-to-kernel version. What does this sentence even mean? We don't have a version of strlcpy anywhere or strncpy or strcpy that tries to copy between different address spaces (e.g. between user and kernel pointers). I think this is trying to address the confusion you've just introduced, but you would be better off IMO just saying "strlcpy" I think, e.g.: is deprecated and should be replaced with strlcpy. > It will be removed from > -.Fx 13 . > +.Fx 16 . > .Pp > The > .Fn copyin > -- John Baldwin