From patchwork Sun Mar 16 09:08:39 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kang-Che Sung X-Patchwork-Id: 107950 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 35A5A3858D3C for ; Sun, 16 Mar 2025 09:10:28 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 35A5A3858D3C Authentication-Results: sourceware.org; dkim=pass (2048-bit key, unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20230601 header.b=cJWRqyPC X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-ej1-x62b.google.com (mail-ej1-x62b.google.com [IPv6:2a00:1450:4864:20::62b]) by sourceware.org (Postfix) with ESMTPS id 68B9E3858D38 for ; Sun, 16 Mar 2025 09:08:52 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 68B9E3858D38 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 68B9E3858D38 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2a00:1450:4864:20::62b ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1742116132; cv=none; b=aH7y+yVhqM+YMF3C1mtKWiHySELZrsLLC8CUAiWNmG69DiuegbaPqk/Fcq6FBn5SkAEtU3EjwA7zzritvYHrdCn+MM39nATjeWcDtWTWeZaQ2zTLui9re3YkPgLxJX7FIlEJiwn7r+253/j0Fz6HBol3iJTTRmFXiqBTNA2wL90= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1742116132; c=relaxed/simple; bh=HsilT7Hm9JDjXM/FOgIfzUJPNN0lEuhiH50f9aewlIQ=; h=DKIM-Signature:MIME-Version:From:Date:Message-ID:Subject:To; b=k3vK33zAbOiympo7xXSWk6jobSRk5sQ9tpCXXElwnGGamTz3RigDK2KMPo0wnBRv0pgfzpUCvI6/zd11rxxovEoxHazkNyhBP7VY8MYoA38ILnAPCAvvkNanhTtxyb2zC9ZIpb0KPw1rg41TZdhH8pqAyxgKgzxaatgO1BLjsPA= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 68B9E3858D38 Received: by mail-ej1-x62b.google.com with SMTP id a640c23a62f3a-abec8b750ebso624636666b.0 for ; Sun, 16 Mar 2025 02:08:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1742116131; x=1742720931; darn=sourceware.org; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=uvZL6T06ni565xp6hM9b+BgwBsxUBSCq4caPOLXOUzU=; b=cJWRqyPC87pvgrBjAfgcVCT4vrfVdCguc2wEI7ZVPWJLHwwOFK7D9yfhjEU8XGB8FD VkD2vgES6Nka6CqkBRRnwtFtwzdDNmpNeuyp+quhMLsLlPi8tmpfTR9xrgdTuQnAgOtL ob90BPgqIUCMJIbZJM40sJtuuGDKZHFtVPQuLnC9yKM8A2KKzCRZs4GRPXslGM9PsaWX 4u9ZvFej0efnSgp0MF/Yv8y8UeSnhWBsti0L5SF6uCswzt6j1rnda917kL3V0xbylfrA 8VjcUeGOUWk+fth1fHSF1xe1o4M/CjdrSoScH6vQlClWmrBGKE3xvScxnS6wKMcPGKD8 3c2g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1742116131; x=1742720931; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=uvZL6T06ni565xp6hM9b+BgwBsxUBSCq4caPOLXOUzU=; b=SbP/GTMCpxOxr+o4ud1WZZXLEebYwrM/UKLpc9saB5MinTa5R5c0uNkV2VVMDoVvu6 hzR1MgpyNc08J2IxutLijH3oBWLwyEHwnjifFzS4OcOzE3tKo5ieenDpFj413Na8HHQq GaZFs3LCBfXbkgHqLWPU1ULROyL1vW7/7CF4vTCe1aqveZVmL42Phe9PpwrR8lgSv4FS 23zt/jxhBGbhm//9tj3Er+MQzBkZWt3BCAm4ypUE69FcBuzwwRbmjVzjrH06oZQ/hIrX XZLcgqSbb5Nu0pP0Pwis2HJxoh4gnd5Wwy5wbRSXBy/vMsAbnpYEeaYt5maafsNBio+v afBA== X-Forwarded-Encrypted: i=1; AJvYcCW89um+x8zpyhtX90MWlYi6zyOJoBIpIYe/yrvsrklD5L5nQMPiQWfeyuH189wceS9fAKF6kNC85J1B@sourceware.org X-Gm-Message-State: AOJu0Yx/ouW93ZkkkgJF4KGkVAXszRulWkYdnKV5EY24f6T23oo2eF/y 5mnDCDE+rejx2ld/fYChFbx4dTiSgLNa0lkb7XZwERgEHnG1f5Ko5lFKqHtErdhVj1f2jgRqfQ0 6eLL+bF+pRF77THg67ldvsx5Oo3E= X-Gm-Gg: ASbGncuhynzjnnVjZq0RsB2jG7L4OwEXAcpN8mrdcklRifHdotYrLI6BNfeVk2UTt2f bznvlb3LVv7fbDMLudM+vvEmW14rJw9XwHdzdJiT2P81utt8koPdKv4bQNF3Qbuenv2hx8S75NB tVVakEEvZXASbZJQQKTG2fPkOJz7Y= X-Google-Smtp-Source: AGHT+IGowfcWRUi/f6of1jC76ReUT0O06Ouc+TSLm4JiyEt7fvPGV8maLmzD8Xbxi+tLibeggg85K2nHaEat9QUOGaI= X-Received: by 2002:a17:907:86a2:b0:ac3:4c24:8648 with SMTP id a640c23a62f3a-ac34c24d69fmr428167966b.55.1742116130818; Sun, 16 Mar 2025 02:08:50 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Kang-Che Sung Date: Sun, 16 Mar 2025 17:08:39 +0800 X-Gm-Features: AQ5f1Jo34Y6svthvwSHGxzvP10QY6AWBTq6wFW1DhkfTIOVwbxwi9-iP7RsVbh0 Message-ID: Subject: [PATCH 2/2] man/man3/wcrtomb.3: Document MB_CUR_MAX length requirement To: alx@kernel.org Cc: linux-man@vger.kernel.org, libc-alpha@sourceware.org X-Spam-Status: No, score=-8.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_ENVFROM_END_DIGIT, FREEMAIL_FROM, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libc-alpha-bounces~patchwork=sourceware.org@sourceware.org The wcrtomb(3) function, like wctomb(3), has a length requirement about MB_CUR_MAX. So copy the wording about MB_CUR_MAX from wctomb(3) to wcrtomb(3). Signed-off-by: Kang-Che Sung --- man/man3/wcrtomb.3 | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/man/man3/wcrtomb.3 b/man/man3/wcrtomb.3 index 967a1a0f6..27b5bd9c1 100644 --- a/man/man3/wcrtomb.3 +++ b/man/man3/wcrtomb.3 @@ -94,6 +94,14 @@ is NULL, a static anonymous state known only to the .BR wcrtomb () function is used instead. +.P +At most +.B MB_CUR_MAX +bytes can be written at +.IR s . +The programmer must ensure that there is enough room to store the +multibyte sequence at +.IR s . .SH RETURN VALUE The .BR wcrtomb () @@ -101,6 +109,9 @@ function returns the number of bytes that have been or would have been written to the byte array at .IR s . +The value returned will never be greater than the value of the +.B MB_CUR_MAX +macro. If .I wc can not be