From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-wr1-x42e.google.com (mail-wr1-x42e.google.com [IPv6:2a00:1450:4864:20::42e]) by sourceware.org (Postfix) with ESMTPS id 917423951CBD for ; Thu, 11 Mar 2021 22:33:45 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 917423951CBD Received: by mail-wr1-x42e.google.com with SMTP id f12so3709896wrx.8 for ; Thu, 11 Mar 2021 14:33:45 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=mgmXHrDeoTzmoHBxPWQOD2RzNwW9F/xIZ7kEpSy3Bi0=; b=oZpaQZbasU5ua8MUBwjTf9loCcZTmQd92pUcecIH4H9KGJVh48yCX38iRJKTN1rugY uH8wwcbcbnHFYTMKRZZ5a1L51DgT5pL9E6v3Rx94g0qtnjJTzg1Q8mnSV5HdSG/aTg4V i7WfhuWU/u3sKI+vJtUssTCNqwryfLXyk5i+juARsG1N027Tepb9qw5BYRIJN1DJVDcz jnRamoYZDIrHheZUpM3GgQoV2kRgy3YmZGc9HluEDi5hT7KBxTDMKwhupLxaGoM4QQHN gTO+sQx2e/mPGxSBwhV2KOwp+pGYHFX32NJvJ/qDQbkcdRSqkKIfMIgH+c3q0n5RdzEF KKdQ== X-Gm-Message-State: AOAM5328r1lZsketVCqZ2q4iGz6nfD9kZ0cL4O5jgo2FYe5MYsk/j0BH TtHko7KiVgkerEpsA6bIQmIb+WksDio= X-Google-Smtp-Source: ABdhPJyxDpiCm+vGMfHkfvP5JPKpeDzdhJKPmDYRwVpbmtowdXytiDhka1KOugHgxangIW3/QSL3TQ== X-Received: by 2002:adf:d0c9:: with SMTP id z9mr11258834wrh.396.1615502024554; Thu, 11 Mar 2021 14:33:44 -0800 (PST) Received: from localhost.localdomain ([170.253.36.171]) by smtp.googlemail.com with ESMTPSA id v2sm22365771wmj.1.2021.03.11.14.33.43 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 11 Mar 2021 14:33:44 -0800 (PST) From: Alejandro Colomar To: mtk.manpages@gmail.com Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org Subject: [PATCH 03/17] unlocked_stdio.3: SYNOPSIS: Use 'restrict' in prototypes Date: Thu, 11 Mar 2021 23:33:16 +0100 Message-Id: <20210311223330.722437-4-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.1 In-Reply-To: <20210311223330.722437-1-alx.manpages@gmail.com> References: <20210311223330.722437-1-alx.manpages@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-11.9 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 11 Mar 2021 22:33:46 -0000 glibc uses 'restrict' in fread_unlocked(), fwrite_unlocked(), fgets_unlocked(), fputs_unlocked(), fgetws_unlocked(), fputws_unlocked(). Let's use it here too. .../glibc$ grep_glibc_prototype fread_unlocked libio/stdio.h:678: extern size_t fread_unlocked (void *__restrict __ptr, size_t __size, size_t __n, FILE *__restrict __stream) __wur; .../glibc$ grep_glibc_prototype fwrite_unlocked libio/stdio.h:680: extern size_t fwrite_unlocked (const void *__restrict __ptr, size_t __size, size_t __n, FILE *__restrict __stream); .../glibc$ grep_glibc_prototype fgets_unlocked libio/stdio.h:591: extern char *fgets_unlocked (char *__restrict __s, int __n, FILE *__restrict __stream) __wur __attr_access ((__write_only__, 1, 2)); .../glibc$ grep_glibc_prototype fputs_unlocked libio/stdio.h:667: extern int fputs_unlocked (const char *__restrict __s, FILE *__restrict __stream); .../glibc$ grep_glibc_prototype fgetws_unlocked wcsmbs/wchar.h:820: extern wchar_t *fgetws_unlocked (wchar_t *__restrict __ws, int __n, __FILE *__restrict __stream); .../glibc$ grep_glibc_prototype fputws_unlocked wcsmbs/wchar.h:829: extern int fputws_unlocked (const wchar_t *__restrict __ws, __FILE *__restrict __stream); .../glibc$ Signed-off-by: Alejandro Colomar --- man3/unlocked_stdio.3 | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3 index 324c4fdc8..e16c5a521 100644 --- a/man3/unlocked_stdio.3 +++ b/man3/unlocked_stdio.3 @@ -44,13 +44,15 @@ putchar_unlocked \- nonlocking stdio functions .BI "int fgetc_unlocked(FILE *" stream ); .BI "int fputc_unlocked(int " c ", FILE *" stream ); .PP -.BI "size_t fread_unlocked(void *" ptr ", size_t " size ", size_t " n , -.BI " FILE *" stream ); -.BI "size_t fwrite_unlocked(const void *" ptr ", size_t " size ", size_t " n , -.BI " FILE *" stream ); +.BI "size_t fread_unlocked(void *restrict " ptr ", size_t " size ", size_t " n , +.BI " FILE *restrict " stream ); +.BI "size_t fwrite_unlocked(const void *restrict " ptr ", size_t " size \ +", size_t " n , +.BI " FILE *restrict " stream ); .PP -.BI "char *fgets_unlocked(char *" s ", int " n ", FILE *" stream ); -.BI "int fputs_unlocked(const char *" s ", FILE *" stream ); +.BI "char *fgets_unlocked(char *restrict " s ", int " n \ +", FILE *restrict " stream ); +.BI "int fputs_unlocked(const char *restrict " s ", FILE *restrict " stream ); .PP .B #include .PP @@ -62,8 +64,10 @@ putchar_unlocked \- nonlocking stdio functions .BI "wint_t putwc_unlocked(wchar_t " wc ", FILE *" stream ); .BI "wint_t putwchar_unlocked(wchar_t " wc ); .PP -.BI "wchar_t *fgetws_unlocked(wchar_t *" ws ", int " n ", FILE *" stream ); -.BI "int fputws_unlocked(const wchar_t *" ws ", FILE *" stream ); +.BI "wchar_t *fgetws_unlocked(wchar_t *restrict " ws ", int " n , +.BI " FILE *restrict " stream ); +.BI "int fputws_unlocked(const wchar_t *restrict " ws , +.BI " FILE *restrict " stream ); .fi .PP .RS -4 -- 2.30.1