From patchwork Sun Mar 16 18:32:13 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: 107959 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 17BD63858D3C for ; Sun, 16 Mar 2025 18:33:49 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 17BD63858D3C 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=E6ZcZPRw X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-ed1-x52b.google.com (mail-ed1-x52b.google.com [IPv6:2a00:1450:4864:20::52b]) by sourceware.org (Postfix) with ESMTPS id 6A24F3858C54 for ; Sun, 16 Mar 2025 18:32:26 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 6A24F3858C54 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 6A24F3858C54 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2a00:1450:4864:20::52b ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1742149946; cv=none; b=Rs9eWV+QH9ez9KeP3rHO9AwzSXAd1JJiQ2Uf2lGw+CfXmPVy6Oo6QBQsq0giTQMeA5f+fmQhVJDKWzD9rLYcaXg60F64mCrXjkvkJueMCYPiXTOneJtxnDk7WxK+c8JrXtwQOhK7/hw2m4CC5/QGT2dx3YOwUjqxBLoHRCG5oEc= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1742149946; c=relaxed/simple; bh=hGzsFRG96iNrEAwV9ZE1ezoTbrFA0K9bvuySsZ+g/Aw=; h=DKIM-Signature:MIME-Version:From:Date:Message-ID:Subject:To; b=alKVlc46CKH5glzLNVdmHyQEWQgiug+zaEZoHCY9Bq9QU9Bs6C0e/p2EtrJVqKsU57cuf33qiq5vScAcnrfJLd0pC6/8sbzcky1BZVwGfWHg5V1Qjb68uDDd7R4q1tm3AI5KyViBia2ovxGV5OaIpM9fnrAOz81Jaql3BOWtyR8= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6A24F3858C54 Received: by mail-ed1-x52b.google.com with SMTP id 4fb4d7f45d1cf-5e614da8615so7287393a12.1 for ; Sun, 16 Mar 2025 11:32:26 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1742149945; x=1742754745; 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=BZm9a50vG8fN4sSOfP0MNTHLDfutQyXWro1TRXDvqV0=; b=E6ZcZPRwNKtcnzitOfMl51FzAuhH1A+C8reO6Kb/sGR58SPO4jwk1vW3oV9uI/2kZa OmXb+HDrVJfUgGnffmBApQyVTa09fL5oeTYeEtpEcsS/aWMSW1TGrIbVrXFotoRkJwvU HOyIT0l8ZJOL1iz15J1Fo5dlMvQrIJqzLAWw2dhhcYqQHlN9kw7AYEEtmsUBcTzcb89w c1khLtqZpXkNz6C8ok2EEvtItXvoHcUS5g1v0iZJ7zyM3icUJmYsTM1s5BbR7Pp+/S9Y UMhXlBI2SpammpIYeZVY9TM4tDyp64B4GlQV+LKqC6BZsfcYCSmJkgsr/j56hXr/yZx4 z5LA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1742149945; x=1742754745; 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=BZm9a50vG8fN4sSOfP0MNTHLDfutQyXWro1TRXDvqV0=; b=hx6LBzbM+Q9rFv4r2cAuBvEt5Pzw81fK36lQyiu/CmCxbDlPZLblrBnPTL8n4NVE4t G2GukfQ88FqV9ApebZ5cTu1iilWNVHwAhPt6OjLzYPO+dZAePH42+W9UHPQR+ynVtGoQ Wb4bdfsyRCMXDZFWVS/TN8Fw3T/0s5zQQFduRappBLMKE5j0GpugB7XS3isf+Mar8pJv Vf8QwEntyAaDVS9Sxsux6gmx3kTiQ7pTI5P/ZYFiYSBdq4snTWSzQ2zLvJKnLO9aqejY iKGBXrdgk2aHUC1lkXbnYvILqS0JHpdSiz+J201IbHHasOnfsEC5YxtKvV9rjhKWCGFs Fh9A== X-Forwarded-Encrypted: i=1; AJvYcCXcU9UfBT2GbNzSYhvRVBM1xfsPa4nN6BGItwv76TzZBRXGVHS1mf0fsIqmVY/T28zqTtoQNpTCPIyY@sourceware.org X-Gm-Message-State: AOJu0YwfUrY0Ob11blqKzPWDltNz7TXzBRey/dm2Xwi6S7TRt/6B/zDq zahZaQlr1ESCbGxsrlgAABWzBJy2G9gPqT1dZeOsn4OjNPpPBfkHQ47blDsa7ndt8ATdYv6mxjG 5OkpmbF8yJ9/yCWMkr4iEzC1dwr8= X-Gm-Gg: ASbGncvPoX1uzmZGsTR+YQ/ck4tFJ/T24d8veLqDDnM7LwSnG3JctzbfYPJ161CcRH9 PZww5mo63qsmzNVSFUd0X+5XndSHgQn198e66EY6RyXOHU9wkkUsQQYM5XfUHqizSbvEzsjkhks i37gXc+750sAGy5B25dZHT+7tzRFTyef/61ldvGw== X-Google-Smtp-Source: AGHT+IF2C9ajbzu6eHhTmv65p57CfJoggSG8ytS95Yc/Xy9kzu/2UjzM0oMroSP7qHwCwzdcTd7IR+72kLz/PQWVBfo= X-Received: by 2002:a05:6402:26cc:b0:5e0:6332:9af0 with SMTP id 4fb4d7f45d1cf-5e814f2a935mr13404642a12.14.1742149944347; Sun, 16 Mar 2025 11:32:24 -0700 (PDT) MIME-Version: 1.0 References: In-Reply-To: From: Kang-Che Sung Date: Mon, 17 Mar 2025 02:32:13 +0800 X-Gm-Features: AQ5f1JpdzkasqBQAfq7LVjZt2vStr2ljnSJgObTU5uYK73iLopxylPIaGt3qRlE Message-ID: Subject: [PATCH v2] man/man3/wc{,r}tomb.3: Rewording to MB_CUR_MAX To: Alejandro Colomar Cc: linux-man@vger.kernel.org, libc-alpha@sourceware.org X-Spam-Status: No, score=-9.1 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 Add the missing length requirement about MB_CUR_MAX to wcrtomb(3). Change the wording on the MB_CUR_MAX requirement in wctomb(3). If programmers know the wide character to convert beforehand, they are allowed to use a buffer smaller than MB_CUR_MAX bytes, as long as it "fits" the sequence. Signed-off-by: Kang-Che Sung --- man/man3/wcrtomb.3 | 8 ++++++++ man/man3/wctomb.3 | 8 +++++--- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/man/man3/wcrtomb.3 b/man/man3/wcrtomb.3 index 967a1a0f6..162d97df8 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 will 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 () diff --git a/man/man3/wctomb.3 b/man/man3/wctomb.3 index fce54cb4b..643e2e677 100644 --- a/man/man3/wctomb.3 +++ b/man/man3/wctomb.3 @@ -42,10 +42,12 @@ that is, the number of bytes written at .IR s . .P -The programmer must ensure that there is -room for at least +At most .B MB_CUR_MAX -bytes at +bytes will be written at +.IR s . +The programmer must ensure that there is enough room to store the +multibyte sequence at .IR s . .P If