From nobody Fri Jul 25 09:05:09 2025 X-Original-To: dev-commits-src-main@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 4bpMQd3KSqz62tct; Fri, 25 Jul 2025 09:05:13 +0000 (UTC) (envelope-from avg@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 "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4bpMQd2TZWz3wkg; Fri, 25 Jul 2025 09:05:13 +0000 (UTC) (envelope-from avg@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1753434313; 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:autocrypt:autocrypt; bh=dSWdHpUF69xKzP3vNVtlOu7agXYHxWO8QpK6gIkiFrY=; b=R229qIGaBEC5ihdxVaAW5SOWtSqlp8oqfBjBJDz0iE2/3RwVM2oS1y6G8Q80r9v9NZJqM6 0kcsEBxQEI3jsNrRhg4K2/aDyGc95qkWzR75Zlp21sIdTSuZLtEsE+tt0UJSO80DRYFwJF S0oXBdXDlL5NYJpPrY1kbT/19cKEJJ3f2TBwVujChLLbqTi/+dv5Xc2kf+HhWOTnsU8yMf UV2sTE/Ixo6U3ubHenT+gYYrIHBS/prfWpdXp1PWeGHsPgBObT2Fd7bbR+aBBrWB5Wq2Dy VvxZju1Ko6dnlHzS9yTGQJUE96ew6FNHxqkvG7E0sLtjvJ62o4JYAR1NQDaGlg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1753434313; 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:autocrypt:autocrypt; bh=dSWdHpUF69xKzP3vNVtlOu7agXYHxWO8QpK6gIkiFrY=; b=Ljat1+D1wn4bu1r1PhB0G7h106uZ2FSVE5/KXoaUzb7MvnyE67yWzP+/X+MCLJB9uF0kGE Uy/l/deZRTGvW44SH/wHVH+td2i2NfzydPIRrLgmuPVLHUol0xP+WIXhCcMpKpYx0EOgVi LUCAaLj0XCbJBmFq0jmRzoPDkkUSh5cdi9E+LxghMqE2Qru3yxANJo7NWK/69esiX1Joc3 hCNVwLhtYV/NC98ykf+PcWkaUSQAnEsIdEv+gO839SjYfsBlbUySI0BsdGrFHZQdzfBAms Ar7VjHAoxPg6oUoyGDV6JWWFpNW2na/JZkXcC/4TGcC8dS4yEThYuQyFtvb85w== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1753434313; a=rsa-sha256; cv=none; b=WZRsV3AqVJJiE/9yuH51ZX3FwAhkyQtaXJVzHaNJxf5iHkvBPHO3ozWemwvfvgM6ded8eM jCI+JuuFADGhdLhqtwKPnigAAyslzyRBYi6eCer2BUfsRhHyQi+k6h2v/zs+StRGhKUiWp UxDeOXyUEvQNfQ6vzlB5heCzLBOijCEY6nOp/ETQx5xdsJ5nOpSLVKTclE5TdTYlFP8S4j 2R/GVocnl5+N32SEi9vPpoLiMumGJ7vC2PcYsLsALaOlDY80GUUZv5PZ4wuttXaeJBRfN8 ez8mfI7DTcIfiA0W1Q24xrhYYL6AAeWataKaviFZWXRrNx/n5xnmoazgWGY3LQ== Received: from [192.168.0.88] (unknown [93.188.39.137]) (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: avg/mail) by smtp.freebsd.org (Postfix) with ESMTPSA id 4bpMQc4r5Mz1R46; Fri, 25 Jul 2025 09:05:12 +0000 (UTC) (envelope-from avg@FreeBSD.org) Message-ID: Date: Fri, 25 Jul 2025 12:05:09 +0300 List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: git: 441995e161a2 - main - memchr.3: mention the len argument in the functions description To: Konstantin Belousov , src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org References: <202507221511.56MFBlfh096304@gitrepo.freebsd.org> Content-Language: en-US From: Andriy Gapon Autocrypt: addr=avg@FreeBSD.org; keydata= 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 gpPTjT15L8xGftEjQXF6 In-Reply-To: <202507221511.56MFBlfh096304@gitrepo.freebsd.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 22/07/2025 18:11, Konstantin Belousov wrote: > The branch main has been updated by kib: > > URL: https://cgit.FreeBSD.org/src/commit/?id=441995e161a2564d37947d054a2f1219754deb5f > > commit 441995e161a2564d37947d054a2f1219754deb5f > Author: Konstantin Belousov > AuthorDate: 2025-07-19 12:15:44 +0000 > Commit: Konstantin Belousov > CommitDate: 2025-07-22 15:11:40 +0000 > > memchr.3: mention the len argument in the functions description > > Otherwise, its use is only specified in the error case, which is > somewhat obscure. Also properly typeset NULL. > > Reviewed by: pauamma_gundo.com > Discussed with: emaste > Sponsored by: The FreeBSD Foundation > MFC after: 3 days > Differential revision: https://reviews.freebsd.org/D51424 > --- > lib/libc/string/memchr.3 | 16 +++++++++++----- > 1 file changed, 11 insertions(+), 5 deletions(-) > > diff --git a/lib/libc/string/memchr.3 b/lib/libc/string/memchr.3 > index f5d1fe5d5c7f..65617a117371 100644 > --- a/lib/libc/string/memchr.3 > +++ b/lib/libc/string/memchr.3 > @@ -52,7 +52,10 @@ locates the first occurrence of > (converted to an > .Vt "unsigned char" ) > in string Maybe this is also a good time to change 'string' to 'memory object' (using POSIX wording) or something of that kind. Most people would read 'string' as C string which the parameter doesn't have to be. > -.Fa b . > +.Fa b , > +limited to at most > +.Fa len > +characters. > .Pp > The > .Fn memrchr > @@ -61,15 +64,18 @@ function behaves like > except that it locates the last occurrence of > .Fa c > in string > -.Fa b . > +.Fa b , > +limited to the first > +.Fa len > +characters. > .Sh RETURN VALUES > The > .Fn memchr > and > .Fn memrchr > -functions > -return a pointer to the byte located, > -or NULL if no such byte exists within > +functions return a pointer to the byte located, or > +.Dv NULL > +if no such byte exists within > .Fa len > bytes. > .Sh SEE ALSO -- Andriy Gapon