Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id D8451C433E0 for ; Tue, 29 Dec 2020 14:44:08 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id AAC15207CF for ; Tue, 29 Dec 2020 14:44:08 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726138AbgL2OoI (ORCPT ); Tue, 29 Dec 2020 09:44:08 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:60524 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726014AbgL2OoH (ORCPT ); Tue, 29 Dec 2020 09:44:07 -0500 Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 30F4CC061796 for ; Tue, 29 Dec 2020 06:43:27 -0800 (PST) Received: by mail-wr1-x433.google.com with SMTP id t30so14878396wrb.0 for ; Tue, 29 Dec 2020 06:43:27 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=ln+iVA30hhKNoj8HQLh/VSGsWAWbqBi26B5ckHEMY+M=; b=KS2isf3tGaS88TJd6wZvBWtU+kvWHnmilZ7ZLIjqxmWScLw0iLFSY8um3jkDYavqy3 SoRG9CymMXqUKjCcf2qJ9P10LgmRaY10BleTG8EKjYNCW5x/Adw/3y8J9+nqIeWY5ppF jin2rUgfDCMWjxLPKhUkgiXbgpm5Ln7RpS+74fCHyctZLn9O1LE63pIn/1JmcoSklK7F OzTUCp27FI8BYwvH/sW3a5Z5c6VQxxJm4S4sh99DspIzxUmb6V8NbX6lqoEVYL3nrKZK pn4tL1HdN3LUsohjr5+SEaVsxWLswpDL+0mG6F+5yuX7Ffd3rmUkdTe0sGQK2K40oV5f 1B9w== 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=ln+iVA30hhKNoj8HQLh/VSGsWAWbqBi26B5ckHEMY+M=; b=DSqGoduTe8UKoLLdzezKi2VfHJ7Q8UScYZ/Z6F8KjWrIxm3DhN+YA5jw2KqtzhOTRt bflt8eNQ2z08VPDx/Q1JV0JSSDmi6oHorEtTFPaem63HfbgtFfWJHeLdfnoeFhiHGu13 XbX4h7spOu2urVEsd5OfNUAYe0kChuuwYq9TjV9Oe1mkURatfCGZjncEjyXe4wZDhXq+ PLzIL8b0+b3LTAEfCvUaO313WpuxtGHtW1dFmD/dFZO7HNyO8gfkhnFGvCBT8uVdEjYz amh+R9QkmHpVlyaz8E33xIqI1m88AqPfEOt1BXKUvecYQRyran8Exr5XUV0clKv/u1/M G8oA== X-Gm-Message-State: AOAM533Lu5bxambdM4/o4Y4MCdUnb3PVAY7cW+i2A01tZeQ/mQ4rZ4QT UuCVTmC/M+xp1y12yyzLsyGKhg0lCP0= X-Google-Smtp-Source: ABdhPJweZZg20JoWbI9erlT9akUfkOhSaeduQK3o3KdnR5p9A3JUQTzgRJTV70vbPmTPKf3BW5aZTQ== X-Received: by 2002:adf:a543:: with SMTP id j3mr34827627wrb.175.1609253005869; Tue, 29 Dec 2020 06:43:25 -0800 (PST) Received: from debian.vlc ([170.253.51.130]) by smtp.gmail.com with ESMTPSA id k10sm57992109wrq.38.2020.12.29.06.43.25 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 29 Dec 2020 06:43:25 -0800 (PST) From: Alejandro Colomar To: mtk.manpages@gmail.com Cc: Ganimedes Colomar , linux-man@vger.kernel.org, Alejandro Colomar Subject: [PATCH 2/2] Various pages: Normalize NOTES about non-existing glibc wrappers Date: Tue, 29 Dec 2020 15:39:03 +0100 Message-Id: <20201229143859.17473-3-alx.manpages@gmail.com> X-Mailer: git-send-email 2.29.2 In-Reply-To: <20201229143859.17473-1-alx.manpages@gmail.com> References: <20201229143859.17473-1-alx.manpages@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Precedence: bulk List-ID: X-Mailing-List: linux-man@vger.kernel.org From: Ganimedes Colomar See previous commit. This commit normalizes texts under sections other than SYNOPSIS (most of them in NOTES). Signed-off-by: Ganimedes Colomar Cowritten-by: Alejandro Colomar Signed-off-by: Alejandro Colomar --- man2/add_key.2 | 2 +- man2/arch_prctl.2 | 6 ++---- man2/getdents.2 | 8 ++++---- man2/io_cancel.2 | 2 +- man2/io_destroy.2 | 2 +- man2/io_getevents.2 | 2 +- man2/io_setup.2 | 2 +- man2/io_submit.2 | 2 +- man2/kexec_load.2 | 3 +-- man2/keyctl.2 | 2 +- man2/pidfd_getfd.2 | 2 +- man2/pidfd_open.2 | 2 +- man2/pidfd_send_signal.2 | 2 +- man2/request_key.2 | 2 +- man2/s390_guarded_storage.2 | 3 +-- man2/s390_pci_mmio_write.2 | 3 +-- man2/s390_runtime_instr.2 | 3 +-- man2/s390_sthyi.2 | 3 +-- man2/sysctl.2 | 3 +-- 19 files changed, 23 insertions(+), 31 deletions(-) diff --git a/man2/add_key.2 b/man2/add_key.2 index 7c20de777..0d136e4aa 100644 --- a/man2/add_key.2 +++ b/man2/add_key.2 @@ -216,7 +216,7 @@ This system call first appeared in Linux 2.6.10. .SH CONFORMING TO This system call is a nonstandard Linux extension. .SH NOTES -No wrapper for this system call is provided in glibc. +Glibc does not provide a wrapper for this system call. A wrapper is provided in the .IR libkeyutils package. diff --git a/man2/arch_prctl.2 b/man2/arch_prctl.2 index e8a6da391..f9a9dc39d 100644 --- a/man2/arch_prctl.2 +++ b/man2/arch_prctl.2 @@ -177,10 +177,8 @@ and in the same thread is dangerous, as they may overwrite each other's TLS entries. .PP -As of version 2.7, glibc provides no prototype for -.BR arch_prctl (). -You have to declare it yourself for now. -This may be fixed in future glibc versions. +Glibc does not provide a wrapper for this system call; call it using +.BR syscall (2). .PP .I FS may be already used by the threading library. diff --git a/man2/getdents.2 b/man2/getdents.2 index 8fe6f90fc..2a0576ffd 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -211,13 +211,13 @@ SVr4. Library support for .BR getdents64 () was added in glibc 2.30; -there is no glibc wrapper for -.BR getdents (). -Calling +Glibc does not provide a wrapper for +.BR getdents (); +call .BR getdents () (or .BR getdents64 () -on earlier glibc versions) requires the use of +on earlier glibc versions) using .BR syscall (2). In that case you will need to define the .I linux_dirent diff --git a/man2/io_cancel.2 b/man2/io_cancel.2 index 1bea257ec..8bcd9c195 100644 --- a/man2/io_cancel.2 +++ b/man2/io_cancel.2 @@ -68,7 +68,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5. is Linux-specific and should not be used in programs that are intended to be portable. .SH NOTES -Glibc does not provide a wrapper function for this system call. +Glibc does not provide a wrapper for this system call. You could invoke it using .BR syscall (2). But instead, you probably want to use the diff --git a/man2/io_destroy.2 b/man2/io_destroy.2 index dc9633f5a..89defd867 100644 --- a/man2/io_destroy.2 +++ b/man2/io_destroy.2 @@ -57,7 +57,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5. is Linux-specific and should not be used in programs that are intended to be portable. .SH NOTES -Glibc does not provide a wrapper function for this system call. +Glibc does not provide a wrapper for this system call. You could invoke it using .BR syscall (2). But instead, you probably want to use the diff --git a/man2/io_getevents.2 b/man2/io_getevents.2 index c9a608e06..0f7c17dbf 100644 --- a/man2/io_getevents.2 +++ b/man2/io_getevents.2 @@ -94,7 +94,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5. is Linux-specific and should not be used in programs that are intended to be portable. .SH NOTES -Glibc does not provide a wrapper function for this system call. +Glibc does not provide a wrapper for this system call. You could invoke it using .BR syscall (2). But instead, you probably want to use the diff --git a/man2/io_setup.2 b/man2/io_setup.2 index 5168ee445..e08d19bb8 100644 --- a/man2/io_setup.2 +++ b/man2/io_setup.2 @@ -72,7 +72,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5. is Linux-specific and should not be used in programs that are intended to be portable. .SH NOTES -Glibc does not provide a wrapper function for this system call. +Glibc does not provide a wrapper for this system call. You could invoke it using .BR syscall (2). But instead, you probably want to use the diff --git a/man2/io_submit.2 b/man2/io_submit.2 index bcbcf43b9..6cdd018a5 100644 --- a/man2/io_submit.2 +++ b/man2/io_submit.2 @@ -247,7 +247,7 @@ The asynchronous I/O system calls first appeared in Linux 2.5. is Linux-specific and should not be used in programs that are intended to be portable. .SH NOTES -Glibc does not provide a wrapper function for this system call. +Glibc does not provide a wrapper for this system call. You could invoke it using .BR syscall (2). But instead, you probably want to use the diff --git a/man2/kexec_load.2 b/man2/kexec_load.2 index a7114545a..4951eb5c3 100644 --- a/man2/kexec_load.2 +++ b/man2/kexec_load.2 @@ -335,8 +335,7 @@ system call first appeared in Linux 3.17. .SH CONFORMING TO These system calls are Linux-specific. .SH NOTES -Currently, there is no glibc support for these system calls. -Call them using +Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). .SH SEE ALSO .BR reboot (2), diff --git a/man2/keyctl.2 b/man2/keyctl.2 index f37cae8df..9311100cf 100644 --- a/man2/keyctl.2 +++ b/man2/keyctl.2 @@ -1953,7 +1953,7 @@ This system call first appeared in Linux 2.6.10. .SH CONFORMING TO This system call is a nonstandard Linux extension. .SH NOTES -No wrapper for this system call is provided in glibc. +Glibc does not provide a wrapper for this system call. A wrapper is provided in the .IR libkeyutils library. diff --git a/man2/pidfd_getfd.2 b/man2/pidfd_getfd.2 index 9312b6f92..1a1319aae 100644 --- a/man2/pidfd_getfd.2 +++ b/man2/pidfd_getfd.2 @@ -121,7 +121,7 @@ first appeared in Linux 5.6. .BR pidfd_getfd () is Linux specific. .SH NOTES -Currently, there is no glibc wrapper for this system call; call it using +Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). .PP For a description of PID file descriptors, see diff --git a/man2/pidfd_open.2 b/man2/pidfd_open.2 index 1b0c5e0d4..b6a321562 100644 --- a/man2/pidfd_open.2 +++ b/man2/pidfd_open.2 @@ -91,7 +91,7 @@ first appeared in Linux 5.3. .BR pidfd_open () is Linux specific. .SH NOTES -Currently, there is no glibc wrapper for this system call; call it using +Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). .PP The following code sequence can be used to obtain a file descriptor diff --git a/man2/pidfd_send_signal.2 b/man2/pidfd_send_signal.2 index ffbfd1796..7b1dc782d 100644 --- a/man2/pidfd_send_signal.2 +++ b/man2/pidfd_send_signal.2 @@ -135,7 +135,7 @@ first appeared in Linux 5.1. .BR pidfd_send_signal () is Linux specific. .SH NOTES -Currently, there is no glibc wrapper for this system call; call it using +Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). .\" .SS PID file descriptors diff --git a/man2/request_key.2 b/man2/request_key.2 index 6b041d0c4..997c221b7 100644 --- a/man2/request_key.2 +++ b/man2/request_key.2 @@ -439,7 +439,7 @@ in Linux 2.6.13. .SH CONFORMING TO This system call is a nonstandard Linux extension. .SH NOTES -No wrapper for this system call is provided in glibc. +Glibc does not provide a wrapper for this system call. A wrapper is provided in the .IR libkeyutils package. diff --git a/man2/s390_guarded_storage.2 b/man2/s390_guarded_storage.2 index c3ab3bc85..c20230786 100644 --- a/man2/s390_guarded_storage.2 +++ b/man2/s390_guarded_storage.2 @@ -144,9 +144,8 @@ This Linux-specific system call is available only on the s390 architecture. .PP The guarded storage facility is available beginning with System z14. .SH NOTES -Glibc does not provide a wrapper for this system call, use +Glibc does not provide a wrapper for this system call; call it using .BR syscall (2) -to call it. .PP The description of the guarded storage facility along with related instructions and Guarded Storage Control Block and diff --git a/man2/s390_pci_mmio_write.2 b/man2/s390_pci_mmio_write.2 index 2ccd630ab..5897c967e 100644 --- a/man2/s390_pci_mmio_write.2 +++ b/man2/s390_pci_mmio_write.2 @@ -103,8 +103,7 @@ These system calls are available since Linux 3.19. This Linux-specific system call is available only on the s390 architecture. The required PCI support is available beginning with System z EC12. .SH NOTES -Glibc does not provide a wrapper for this system call, use +Glibc does not provide wrappers for these system calls; call them using .BR syscall (2) -to call it. .SH SEE ALSO .BR syscall (2) diff --git a/man2/s390_runtime_instr.2 b/man2/s390_runtime_instr.2 index 0f4a704de..71e391fe9 100644 --- a/man2/s390_runtime_instr.2 +++ b/man2/s390_runtime_instr.2 @@ -97,9 +97,8 @@ This Linux-specific system call is available only on the s390 architecture. The run-time instrumentation facility is available beginning with System z EC12. .SH NOTES -Glibc does not provide a wrapper for this system call, use +Glibc does not provide a wrapper for this system call; call it using .BR syscall (2) -to call it. .PP The .I asm/runtime_instr.h diff --git a/man2/s390_sthyi.2 b/man2/s390_sthyi.2 index 70871286b..91fc622bc 100644 --- a/man2/s390_sthyi.2 +++ b/man2/s390_sthyi.2 @@ -126,9 +126,8 @@ This system call is available since Linux 4.15. .SH CONFORMING TO This Linux-specific system call is available only on the s390 architecture. .SH NOTES -Glibc does not provide a wrapper for this system call, use +Glibc does not provide a wrapper for this system call; call it using .BR syscall (2) -to call it. .PP For details of the STHYI instruction, see .UR https://www.ibm.com\:/support\:/knowledgecenter\:/SSB27U_6.3.0\:/com.ibm.zvm.v630.hcpb4\:/hcpb4sth.htm diff --git a/man2/sysctl.2 b/man2/sysctl.2 index 72f0af6f3..0ed68df00 100644 --- a/man2/sysctl.2 +++ b/man2/sysctl.2 @@ -120,8 +120,7 @@ Note that on older kernels where this system call still exists, it is available only if the kernel was configured with the .B CONFIG_SYSCTL_SYSCALL option. -Furthermore, -glibc does not provide a wrapper for this system call, +Furthermore, glibc does not provide a wrapper for this system call, necessitating the use of .BR syscall (2). .SH BUGS -- 2.29.2