From patchwork Sun Feb 14 13:39:07 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42026 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 9FC7D384B13D; Sun, 14 Feb 2021 13:48:03 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 9FC7D384B13D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1613310483; bh=RbmGRai9khpzA9lGPDc0qiZjCQHwpScfyjwp7gSkoB8=; h=To:Subject:Date:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:Cc:From; b=jmqvZqhVFhF+NgLqrAa5Y5D2Mr+zlY4iLhy16lFah2+z80xJ0Gz0xYat8TV1CKsDT 20oSATM81TMi0QhbNkGIc61ZcwzBEhuoEnJ2IAV54gUb9uCKOUouXeDks+1+2R6Ixf ofFSYrUcfkMi6MrsdDfhHV3yoZIeRIzuZ9dkGmMQ= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x42b.google.com (mail-wr1-x42b.google.com [IPv6:2a00:1450:4864:20::42b]) by sourceware.org (Postfix) with ESMTPS id 271213858024 for ; Sun, 14 Feb 2021 13:48:01 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 271213858024 Received: by mail-wr1-x42b.google.com with SMTP id 7so5459689wrz.0 for ; Sun, 14 Feb 2021 05:48:01 -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:mime-version :content-transfer-encoding; bh=RbmGRai9khpzA9lGPDc0qiZjCQHwpScfyjwp7gSkoB8=; b=nB7GDROkmDawd9cb8CBGeAc5RHPKniBx1NYIF946qIBhaXdJoeTHLZkyYqbKTijDTF +JjoAb1o3zJTn8mD61KxqgvpA2hD7eCTiSBEGRxLw4e7RDQBh34xLc0/ibgcGw4v4Vca bgBga6CqlEQlPd0uzQqiRQ+WASgMga0KuXfAWSK+SzgIjFjO/RZdGrCGu7NsJmEf3UTD PKM5mMlT1Uv7fR7u8oj48gTMgxR1qjGpZSemD8oK8mP09cJSxbZHNpSOgzkJDpacbKnM cnedX4EJizeGaF9ZLDs1RyzDSQ78GYWdrEOWO98ER3YBhx3x8OpNEQ7Ql5Bpk0VZlE2l PJ7Q== X-Gm-Message-State: AOAM533QkyaMihiK0jSOIAEXGzc3s3s36iX6O9WFX5dAd0iDWjqLHAv/ PHsNWztctVYZB1QKHbE7exo= X-Google-Smtp-Source: ABdhPJwE/OcdZtUsKR+ObA23qr6mcRPy6c1CFectqeWEng4CxUFZDkB3rh5LeQmOwL1/NObjx9CSpw== X-Received: by 2002:adf:f6d0:: with SMTP id y16mr14080936wrp.351.1613310480352; Sun, 14 Feb 2021 05:48:00 -0800 (PST) Received: from localhost.localdomain ([170.253.36.171]) by smtp.googlemail.com with ESMTPSA id z8sm18795278wrr.55.2021.02.14.05.47.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 14 Feb 2021 05:47:59 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC] execve.2: SYNOPSIS: Document both glibc wrapper and kernel sycalls Date: Sun, 14 Feb 2021 14:39:07 +0100 Message-Id: <20210214133907.157320-1-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.0 MIME-Version: 1.0 X-Spam-Status: No, score=-11.8 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Until now, the manual pages have (usually) documented only either the glibc (or another library) wrapper for a syscall, or the raw syscall (this only when there's not a wrapper). Let's document both prototypes, which many times are slightly different. This will solve a problem where documenting glibc wrappers implied shadowing the documentation for the raw syscall. It will also be much clearer for the reader where the syscall comes from (kernel? glibc? other?), by adding an explicit comment at the beginning of the prototypes. This removes the need of scrolling down to NOTES to see that info. Signed-off-by: Alejandro Colomar --- Hi all, This is a prototype for doing some important changes to the SYNOPSIS of the man-pages. The commit message above explains the idea quite well. A few details that couldn't be shown on this commit are: For cases where the wrapper is provided by a library other than glibc, I'd simply change the comment. For example, for move_pages(2), it would say /* libnuma wrapper function: */. I think this would make the samll notes warning that there's no glibc wrapper function deprecated (but we could keep them for some time and decide that later). While changing this, I'd also make sure that the headers are correct, and clearly differentiate which headers are needed for the raw syscall and for the wrapper function. This change will probably take more than one release of the man-pages to complete. Any thoughts? Thanks, Alex --- man2/execve.2 | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/man2/execve.2 b/man2/execve.2 index 639e3b4b9..87ff022ce 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -39,10 +39,18 @@ execve \- execute program .SH SYNOPSIS .nf +/* Glibc wrapper function: */ .B #include .PP -.BI "int execve(const char *" pathname ", char *const " argv [], -.BI " char *const " envp []); +.BI "int execve(const char *" pathname ", +.BI " char *const " argv "[], char *const " envp []); +.PP + /* Raw system call: */ +.B #include +.B #include +.PP +.BI "int syscall(SYS_execve, const char *" pathname , +.BI " const char *const " argv "[], const char *const " envp []); .fi .SH DESCRIPTION .BR execve () From patchwork Sat Mar 13 19:25:12 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42518 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 389223864859; Sat, 13 Mar 2021 19:25:54 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 389223864859 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663554; bh=53imOT5BnpvRZ4s95euPtzvtcokyK77zLaPlARMABdo=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=EEkbHRsKZkT2y0W7pyoZPGi2Qs4Vz54KQbAVbUBtKPQVHyhqSA2DRFwAHlZiS7UfR pMpYAyqmjsadtLuQsxtnR/ug6u/uT+S07N541PUCnOmopGm2sK8cHD36ELj6rxHGCI Qyp7BFq4JVbLLWsQF6CxJ24N9zcz1l3yCUbVshgU= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x32d.google.com (mail-wm1-x32d.google.com [IPv6:2a00:1450:4864:20::32d]) by sourceware.org (Postfix) with ESMTPS id 6F83338618D9 for ; Sat, 13 Mar 2021 19:25:51 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 6F83338618D9 Received: by mail-wm1-x32d.google.com with SMTP id b2-20020a7bc2420000b029010be1081172so17104398wmj.1 for ; Sat, 13 Mar 2021 11:25:51 -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=53imOT5BnpvRZ4s95euPtzvtcokyK77zLaPlARMABdo=; b=qAjGHVz/C7wiWJe1WUnhwtyguyG2jY9rth2xeBAPfSI88gVbQWyiVSPFJZOh5cTrg4 4c/txyP+bdXIT4ZlvxEbglW4Ianv2R5TNJfk4iV6ZAG2Xn+YswAuAUD76ytrH0y9wAyP 9H1FKZNtp5iYUeNA7zG3SXWN58234qvRmUsIa2a4+llZ7Cds4IYoHbeRGBQOWv4+6Shk gz5zam7JzrgpT5ad3gypGrg7BqO28r7Qklrd5eExGxUTdiGmVXUUDFjtnzE8kASY9gWg NazxNaY26o+EtdHmApJ8ZvPDk675u0tIR8mAXL0M0t6D83hViNNJSIzwCd4HPjL7XDPv s7uA== X-Gm-Message-State: AOAM533qr4YtLAbcQfY0jbstEUXm23DDYm6deyRJcPCiSg0dELDoa6tp N/s92yoNn4+EdofsxI1AKDoe4mfvEJN2jg== X-Google-Smtp-Source: ABdhPJxhiKSAKHH3iakfudvWPUYRMNwr2C7nWlPajnCaqXmkd2bz3HxTZOSV1DShl9gnoFJQuRljGA== X-Received: by 2002:a7b:c396:: with SMTP id s22mr18682288wmj.38.1615663550550; Sat, 13 Mar 2021 11:25:50 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.49 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:50 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 02/17] alloc_hugepages.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:12 +0100 Message-Id: <20210313192526.350200-3-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/alloc_hugepages.2 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/man2/alloc_hugepages.2 b/man2/alloc_hugepages.2 index 623eeab6e..a3a157725 100644 --- a/man2/alloc_hugepages.2 +++ b/man2/alloc_hugepages.2 @@ -27,11 +27,12 @@ alloc_hugepages, free_hugepages \- allocate or free huge pages .SH SYNOPSIS .nf -.BI "void *alloc_hugepages(int " key ", void *" addr ", size_t " len , -.BI " int " prot ", int " flag ); +.BI "void *syscall(SYS_alloc_hugepages, int " key ", void *" addr \ +", size_t " len , +.BI " int " prot ", int " flag ); .\" asmlinkage unsigned long sys_alloc_hugepages(int key, unsigned long addr, .\" unsigned long len, int prot, int flag); -.BI "int free_hugepages(void *" addr ); +.BI "int syscall(SYS_free_hugepages, void *" addr ); .\" asmlinkage int sys_free_hugepages(unsigned long addr); .fi .SH DESCRIPTION From patchwork Sat Mar 13 19:25:13 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42519 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 BE5F4388C013; Sat, 13 Mar 2021 19:25:55 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org BE5F4388C013 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663555; bh=z3NNryk1ci9eYbs78Jt/UvIKKs9jNRVOVbWS8ChqMqc=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=hbojLsM2g/b6M7GTGJBXoubCmx3X26fSArydAxG6cqOj5Xbolrr6SueWM0dufCabK 9aUdthSqPA7RPC8iE9e0VjC3QuzbPhsrVeqmWOyJc5zXA+IBHXVnNyvFPGmpwKuP5r L1Eq/tAnINPIGJkrJQYggh8R4063ZurMX5csGbGE= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x32e.google.com (mail-wm1-x32e.google.com [IPv6:2a00:1450:4864:20::32e]) by sourceware.org (Postfix) with ESMTPS id 4242C3854801 for ; Sat, 13 Mar 2021 19:25:52 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 4242C3854801 Received: by mail-wm1-x32e.google.com with SMTP id g25so5728294wmh.0 for ; Sat, 13 Mar 2021 11:25:52 -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=z3NNryk1ci9eYbs78Jt/UvIKKs9jNRVOVbWS8ChqMqc=; b=nihS/BugE8BjjfRhwzlH2BPy7NFPZBK+QqnRBlPKSJU8Xu6s62hOggI0ryO/I/jfKE MyFFMBPR1uOp+WwbUZIb9hJEVCfleZKb1eIl8ZmCWssX3nJUp5+TvGVzqsvzcnqZJ7/X Q/0JP7Q0NzimFLUtWR9l+NRebVXjtQadIXK1bLiOYrxkk7LuQnErskZALrPMPZcawx+D +ECJYnykP7lcqoikT5pB33VVhNiOQ9pUvawM7e8re84mzhKcWvbhWpAyvpsm3H6rT6he AHEq00o2G7EI98PBSZBTbfCBZ7QvBQN32dXKty0jCkiX4PtTMcoJgpXCLHcAjo/2Dbkl wQiw== X-Gm-Message-State: AOAM530aoMSIbImu5wqMWLqqZElwPc+2ZbC+M+CNS6d4yAow1KuG+cEU FUf9q3QTac0zP7LTGWV6SxA= X-Google-Smtp-Source: ABdhPJx8XH+GI14ambLJs44HFKtFSLjhMYB43uahxuH3zsK3nJ3aAR44vwc7rLp3W9uyMvAta7r7PA== X-Received: by 2002:a1c:1bc7:: with SMTP id b190mr19148407wmb.115.1615663551362; Sat, 13 Mar 2021 11:25:51 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:51 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 03/17] arch_prctl.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:13 +0100 Message-Id: <20210313192526.350200-4-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/arch_prctl.2 | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/man2/arch_prctl.2 b/man2/arch_prctl.2 index f9a9dc39d..8706cd1ec 100644 --- a/man2/arch_prctl.2 +++ b/man2/arch_prctl.2 @@ -27,15 +27,14 @@ arch_prctl \- set architecture-specific thread state .SH SYNOPSIS .nf -.B #include +.BR "#include " " /* Definition of " ARCH_* " constants */" .B #include +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include .PP -.BI "int arch_prctl(int " code ", unsigned long " addr ); -.BI "int arch_prctl(int " code ", unsigned long *" addr ); +.BI "int syscall(SYS_arch_prctl, int " code ", unsigned long " addr ); +.BI "int syscall(SYS_arch_prctl, int " code ", unsigned long *" addr ); .fi -.PP -.IR Note : -There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION .BR arch_prctl () sets architecture-specific process or thread state. @@ -177,9 +176,6 @@ and in the same thread is dangerous, as they may overwrite each other's TLS entries. .PP -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. Programs that use From patchwork Sat Mar 13 19:25:14 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42520 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 4EA77386F833; Sat, 13 Mar 2021 19:25:56 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4EA77386F833 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663556; bh=/AFw5wHq+GfKWHh1wvl2IlsPE6dyDM4uX+z9mQpJ5/M=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=uVYz1003QNVOjtzSRHpwPz9R3G7qp3cQ+Xj95wZzLA6WRZvDd36LwBGOQqRrYMa0v daAihUtBOZWK0kODELTMWpYjR0dEvrJaq9NMK0gt3tAs8ye6GrMfSFGaKeuh1U1XXn CQmyCbt3oVvDPgvUsEUuwtL6BCXh+DeIp4TLJuXI= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x330.google.com (mail-wm1-x330.google.com [IPv6:2a00:1450:4864:20::330]) by sourceware.org (Postfix) with ESMTPS id 16865384A01C for ; Sat, 13 Mar 2021 19:25:53 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 16865384A01C Received: by mail-wm1-x330.google.com with SMTP id d191so5724064wmd.2 for ; Sat, 13 Mar 2021 11:25:53 -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=/AFw5wHq+GfKWHh1wvl2IlsPE6dyDM4uX+z9mQpJ5/M=; b=P1aHqVJGZpXxvQdZ3S8/1wWDI4SwilcQ9W74ULchfo7CNFxcOsFJiH65JR8zebotob GokLWuat1RX0cXG6lFDO2YXOj8hAGs+71OKMxDfv7n0kAKWT0byqY+/kwNhHDyAQmiBS cdajlL6WXnndKcZ/mmH8vT15r1aUiIYOpj7iC0VhB4Jc0XNQ/cWrcfvNumtCN33v0GC/ lh9rHIt67cWH1ofYGbYaI5SD3zWEOkL5DVRcXoxzW+iWogEFosZa6Wje3eDplXcPPwWC K5JMj2lLoWQ7WrxPNvyXmlG1s15gy+pyeqgevRsTNZHeqUjPg4+oIcgiAfimKWD8cY75 QV3A== X-Gm-Message-State: AOAM532XUEvl0Dy/elEHbIgiEvSHghHABlhcpKrSVroGY2cLCD4krBXZ kHYBPAvXo+eC0BlvNdK3nO04DRMI96gR8A== X-Google-Smtp-Source: ABdhPJwFJC4ND+OAQfr098dvmKqEpBmwO0pYfnx/Kpx8bTckbjgEpUfEnjj9RCx4VboksKP+tiKkkw== X-Received: by 2002:a05:600c:4112:: with SMTP id j18mr18959294wmi.143.1615663552222; Sat, 13 Mar 2021 11:25:52 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:51 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 04/17] arch_prctl.2: SYNOPSIS: Remove unused includes Date: Sat, 13 Mar 2021 20:25:14 +0100 Message-Id: <20210313192526.350200-5-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" AFAICS, there's no reason to include that. All of the macros that this function uses are already defined in the other headers. Cc: glibc Signed-off-by: Alejandro Colomar --- man2/arch_prctl.2 | 1 - 1 file changed, 1 deletion(-) diff --git a/man2/arch_prctl.2 b/man2/arch_prctl.2 index 8706cd1ec..d1b9e16f9 100644 --- a/man2/arch_prctl.2 +++ b/man2/arch_prctl.2 @@ -28,7 +28,6 @@ arch_prctl \- set architecture-specific thread state .SH SYNOPSIS .nf .BR "#include " " /* Definition of " ARCH_* " constants */" -.B #include .BR "#include " " /* Definition of " SYS_* " constants */" .B #include .PP From patchwork Sat Mar 13 19:25:15 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42521 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 5F7B7388C02A; Sat, 13 Mar 2021 19:25:57 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 5F7B7388C02A DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663557; bh=wl47K/xROL84A9jG0Dw06koLMYjwVaIYahNhoWpygGk=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=cRqFxq5ABRy2Ix+y5vayASE0EKCGTDbcbBez4BTQnyB7bKCCHufqS0JhAIe1XmVVe HmAlrVAKuV1PYG3x1cpNPgfMbnfhzQBcSUEJ1Qhf6Oe3J7zNOKbLz0QzMzZr7/EKyB rW/jqzh5FS0FNezBD/obDhL3kbmVXa6pWRsWufCM= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x32e.google.com (mail-wm1-x32e.google.com [IPv6:2a00:1450:4864:20::32e]) by sourceware.org (Postfix) with ESMTPS id ED1A0388C006 for ; Sat, 13 Mar 2021 19:25:53 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org ED1A0388C006 Received: by mail-wm1-x32e.google.com with SMTP id y124-20020a1c32820000b029010c93864955so17781288wmy.5 for ; Sat, 13 Mar 2021 11:25:53 -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=wl47K/xROL84A9jG0Dw06koLMYjwVaIYahNhoWpygGk=; b=uR+gyY6b56AmOUtQwMAdjRCVBWI3t9995pq6R5iGUbxQKBcWSK6vaepI0/+R3x3Fok K7/VP+4mSK+6BVXGWp8vtEi/ufY+8v7DNqfmtMIn8VwYBjoUhyBHoFWV7ywyiR3OEnb1 z6/iLiOb0cePr7uTdTGMudoZXBIPdYe+m7BV2Ab0UTUbFgfWNyPixaxYLq9mtVpFJFMy iNBc3zkJhagcuf1RCoY7ukm92NAkGnIfS6erXWzUsDj7+XAqHIednEPuntwyyRh2HvfW 0Ea/6J3OtIP69g7GZD2jnEQVv7hYMOndU3qbu7ZfBTQB1RGjbSzwmndOa56j0leNogdC 2Gvw== X-Gm-Message-State: AOAM530ep8U0i9dvcKOteDfoR/U3ZNDDutjV6bsQ4dTZpITsxrcz/350 4diDtupU2/P3ahluJQuu2mU= X-Google-Smtp-Source: ABdhPJx2BDyjt5tPfDFtWAxTa6l/hMJe0QZDF7mOnTAQLsXewIT4HgyBxFi89ZfZMkx7sih0ZdIsvg== X-Received: by 2002:a1c:7905:: with SMTP id l5mr19122128wme.181.1615663553104; Sat, 13 Mar 2021 11:25:53 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:52 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 05/17] capget.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:15 +0100 Message-Id: <20210313192526.350200-6-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/capget.2 | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/man2/capget.2 b/man2/capget.2 index ea504c28c..981645f90 100644 --- a/man2/capget.2 +++ b/man2/capget.2 @@ -18,14 +18,15 @@ capget, capset \- set/get capabilities of thread(s) .SH SYNOPSIS .nf -.B #include +.BR "#include " " /* Definition of types and constants */" +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include .PP -.BI "int capget(cap_user_header_t " hdrp ", cap_user_data_t " datap ); -.BI "int capset(cap_user_header_t " hdrp ", const cap_user_data_t " datap ); +.BI "int syscall(SYS_capget, cap_user_header_t " hdrp , +.BI " cap_user_data_t " datap ); +.BI "int syscall(SYS_capset, cap_user_header_t " hdrp , +.BI " const cap_user_data_t " datap ); .fi -.PP -.IR Note : -There are no glibc wrappers for these system calls; see NOTES. .SH DESCRIPTION These two system calls are the raw kernel interface for getting and setting thread capabilities. @@ -40,7 +41,7 @@ The portable interfaces are .BR cap_set_proc (3) and .BR cap_get_proc (3); -if possible, you should use those interfaces in applications. +if possible, you should use those interfaces in applications; see NOTES. .\" .SS Current details Now that you have been warned, some current kernel details. @@ -239,9 +240,6 @@ No such thread. .SH CONFORMING TO These system calls are Linux-specific. .SH NOTES -Glibc does not provide a wrapper for this system call; call it using -.BR syscall (2). -.PP The portable interface to the capability querying and setting functions is provided by the .I libcap From patchwork Sat Mar 13 19:25:16 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42522 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 E4501384A01C; Sat, 13 Mar 2021 19:25:58 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E4501384A01C DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663559; bh=vaIv3psZjL7GIAaqBtUc1l5X6QKk9mi+QSa5QAcEGL8=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=t4lJ7pjVtMfzda2v/XPdeWDiH7EN3oYRleqiNMJCIM/5wcyQ75IXo22lRWvYR1BDp ExUJ+alUPqKUVZ8Cc0Gr/01MivRJ8p+Zd+z0S2mlLzPdhGupCsqEnWrurnaFO9K8YA bax7/ItwwDHthSJHRDgMR6ahaqF6/qnJHaIyIDdA= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x335.google.com (mail-wm1-x335.google.com [IPv6:2a00:1450:4864:20::335]) by sourceware.org (Postfix) with ESMTPS id D1246384A01C for ; Sat, 13 Mar 2021 19:25:54 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org D1246384A01C Received: by mail-wm1-x335.google.com with SMTP id w203-20020a1c49d40000b029010c706d0642so689606wma.0 for ; Sat, 13 Mar 2021 11:25:54 -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=vaIv3psZjL7GIAaqBtUc1l5X6QKk9mi+QSa5QAcEGL8=; b=F8LVrxH9qfPhQDOC5g/xRd40gs5l4zwoXswwplo+nMure5hf9ljOpSwTJ81RFN0J6E RPoHw1aEXDfuJm2LYDIdPZmrYWk6Xgnpgc7GQTl9zUhrfLU8Mn1ZfXsULLtp4eH10RKh Nt+lAxqIdO6WrDN1EkfU0wRsQJeavzDQMns9brFSVj8TdmCib4ndsy8fHZyNSYnpHnRy QW+RZWuD1bfq/Ar4vFklawzJPRE7UjRAwxsZ65HdU2uryOXMmB9d0SoAczXA4JnPC3Ti tOO6rgJ2bBoMSqpO8PczhSfIqe2H4UBks5D2QAL4ErlLYqjQgScbmSx+TglLvjckfH/t 2G1A== X-Gm-Message-State: AOAM531Dy3mtBrxq/7531H+BDtlFv64CXsO2qgk/O6Omfcct0Ryjabom 61van+CFooLeTMf9Sg88eak= X-Google-Smtp-Source: ABdhPJwhVIebu85kdo6+AvqSaKQ6mTQ0asUxJ7beu3O5wd/FQm2wlW1rjKDbwlKjiV015/s63tEL1A== X-Received: by 2002:a7b:c931:: with SMTP id h17mr19202908wml.4.1615663553968; Sat, 13 Mar 2021 11:25:53 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:53 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 06/17] clone.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:16 +0100 Message-Id: <20210313192526.350200-7-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/clone.2 | 16 +++++----------- 1 file changed, 5 insertions(+), 11 deletions(-) diff --git a/man2/clone.2 b/man2/clone.2 index 11eb6c622..2f5ecac42 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -56,13 +56,12 @@ clone, __clone2, clone3 \- create a child process .PP /* For the prototype of the raw clone() system call, see NOTES */ .PP -.BI "long clone3(struct clone_args *" cl_args ", size_t " size ); -.fi +.BR "#include " " /* Definition of " "struct clone_args" " */" +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include .PP -.IR Note : -There is no glibc wrapper for -.BR clone3 (); -see NOTES. +.BI "long syscall(SYS_clone3, struct clone_args *" cl_args ", size_t " size ); +.fi .SH DESCRIPTION These system calls create a new ("child") process, in a manner similar to @@ -1541,11 +1540,6 @@ One use of these systems calls is to implement threads: multiple flows of control in a program that run concurrently in a shared address space. .PP -Glibc does not provide a wrapper for -.BR clone3 (); -call it using -.BR syscall (2). -.PP Note that the glibc .BR clone () wrapper function makes some changes From patchwork Sat Mar 13 19:25:17 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42523 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 7C798388A811; Sat, 13 Mar 2021 19:25:59 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 7C798388A811 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663559; bh=yQXEtfeyKUnkSglVrznV/SHCCMXJyKxnW8hgUwKGmHg=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=sWvFlXKuckPEBiwiGk6YTQ0J5DiEuJUxRtk3UC5fwWuV5Fg60yTMyU/MccvvqIYU6 UC4X+sc79AffUtjfEAQ5DvDQUAYQAHBKmCLg4Y4rwvcMjWwSu0BeQ+rRblw22Ko/AZ hbOYIvF8JoLmyu7XuoIeaaMbT5X+/r4lmv4BVF2M= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x32f.google.com (mail-wm1-x32f.google.com [IPv6:2a00:1450:4864:20::32f]) by sourceware.org (Postfix) with ESMTPS id A9192388C006 for ; Sat, 13 Mar 2021 19:25:55 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org A9192388C006 Received: by mail-wm1-x32f.google.com with SMTP id c76-20020a1c9a4f0000b029010c94499aedso17785842wme.0 for ; Sat, 13 Mar 2021 11:25:55 -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=yQXEtfeyKUnkSglVrznV/SHCCMXJyKxnW8hgUwKGmHg=; b=dyY7LAzTpIC8Sl4DinUYs7pu/bKK2eaqhKvWEFMIIqKer1jZSWKkGQJG3SGZznZHEj ecfR+fp39djVWtzsxnrB59fgx2LHsgNkFfYi5hhyMdB2k3XKO6IK+rysVWe1HjD6zCND QcmD+WAhlxCeR2kLZ7wOrZvxXtF/3Qti2glWbHIlzkrG3Puq2GWK85zwdgkw+FKM2fBY PnWM+OXj6C+mXp8miTYlblQ1ovccPD7zNvfoo/xMrrSf7JWNoGtB/hTNUs3KEK8zpHlr EzSQz8IzFIjGngFOYRDWCHPVILTQC68fsWpJ1XE9THLeB4Ewy/0Tf7XDmoDdtEkCt6oV IxpA== X-Gm-Message-State: AOAM533xat26xAMfAY3vdTazUivFcXghHzvLblVbfaf4en8L7Z+i5VWf JeGlf9faSfoYZbE/a4KFOMI= X-Google-Smtp-Source: ABdhPJzMA2rcRrGgKxTV5GfVy9NgQlIob38w90BYyCIiZfU+6RHUpQs/sOvXP6n0OAqSljiKymag+Q== X-Received: by 2002:a7b:c084:: with SMTP id r4mr18907694wmh.166.1615663554835; Sat, 13 Mar 2021 11:25:54 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:54 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 07/17] delete_module.2: wfix Date: Sat, 13 Mar 2021 20:25:17 +0100 Message-Id: <20210313192526.350200-8-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Use the same wording as in delete_module(2) for this special case. Signed-off-by: Alejandro Colomar --- man2/delete_module.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/man2/delete_module.2 b/man2/delete_module.2 index cb78cf484..50921d7ba 100644 --- a/man2/delete_module.2 +++ b/man2/delete_module.2 @@ -31,7 +31,7 @@ delete_module \- unload a kernel module .fi .PP .IR Note : -There is no glibc wrapper for this system call; see NOTES. +No declaration of this system call is provided in glibc headers; see NOTES. .SH DESCRIPTION The .BR delete_module () From patchwork Sat Mar 13 19:25:18 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42524 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 1303D388C032; Sat, 13 Mar 2021 19:26:00 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 1303D388C032 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663560; bh=m2UYqInPbiVi0OaTJQ9o2S1q3+yvxRnv9zNjA6WqsG0=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=hGUXJAk2kG5ud1LE6gY0KuiZQPaMgeTbkN/tBePOsrUPyGKabyrhmrRkrbSSam6eU ntZqQ9Z63+d9jTkedKoU1mR91A3eB8J4ELuI/6zsN5CJcmSgvkmN7Zd6YmaMt/Fn+g kNa8El6a3jXQUHUJrJ5c0GHaWkCv8xlQJlRCDQyw= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x432.google.com (mail-wr1-x432.google.com [IPv6:2a00:1450:4864:20::432]) by sourceware.org (Postfix) with ESMTPS id 81054388A811 for ; Sat, 13 Mar 2021 19:25:56 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 81054388A811 Received: by mail-wr1-x432.google.com with SMTP id 7so6609504wrz.0 for ; Sat, 13 Mar 2021 11:25:56 -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=m2UYqInPbiVi0OaTJQ9o2S1q3+yvxRnv9zNjA6WqsG0=; b=HsWiM3d+YWUZr0PkdX+Dj2Vi7/RO3mvzbbJE5InxAOjkV0XzgcjlX6KftJQu7q33ok xC4KF1FAl4PAotT5zzSYRynhA3L6HjshJOrWU12Ie2ROfcP7dqDKpiqz68HpyVe+fI3O tcwgsjIVPgqh5Ft3pTs9oLHjAPE2tTpvV3+Xhls821Lf1PtBrgr4VJNJaxhARAXeg3/E TcoIwB6nIPGK6zTeSoMcY3FvlaSFB2ipQhgcdmkXEDK0ZN8omkWi2edvKQUgyaUU2kUY 6VjT+cALGvuEc/aew5J6iZC0H6+lbEXFgmrkGxre2ripa0ZvLEGP5aPY08FLycic7DoR lMwQ== X-Gm-Message-State: AOAM530mX6u1vfk4qRUYeZaO3Ip8ao+qyRlgaFIXRloTlXFB2SrtwMJT SEHlslXs8XdI/5w9T0kJdJY= X-Google-Smtp-Source: ABdhPJz0V23KnA6yIiswti5QiH73acYI1QhV9tU6ijBdEO/5LImULsitAbd8x0W3FS7qq+7ZO6R9TQ== X-Received: by 2002:a5d:6404:: with SMTP id z4mr19052012wru.109.1615663555693; Sat, 13 Mar 2021 11:25:55 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:55 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 08/17] epoll_wait.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:18 +0100 Message-Id: <20210313192526.350200-9-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/epoll_wait.2 | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/man2/epoll_wait.2 b/man2/epoll_wait.2 index af4180df0..0f3cfe1d5 100644 --- a/man2/epoll_wait.2 +++ b/man2/epoll_wait.2 @@ -32,7 +32,13 @@ epoll_wait, epoll_pwait, epoll_pwait2 \- wait for an I/O event on an epoll file .BI "int epoll_pwait(int " epfd ", struct epoll_event *" events , .BI " int " maxevents ", int " timeout , .BI " const sigset_t *" sigmask ); -.BI "int epoll_pwait2(int " epfd ", struct epoll_event *" events , +.PP +.BR "#include " \ +" /* Definition of " "struct epoll_event" " */" +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include +.PP +.BI "int syscall(SYS_epoll_pwait2, int " epfd ", struct epoll_event *" events , .BI " int " maxevents ", const struct timespec *" timeout , .BI " const sigset_t *" sigmask ); .\" FIXME: Check if glibc has added a wrapper for epoll_pwait2(), From patchwork Sat Mar 13 19:25:19 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42525 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 9A433388C025; Sat, 13 Mar 2021 19:26:01 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 9A433388C025 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663561; bh=NOO1piYZB4k0TV/xxFD2hxAk7MvONuytBBkxF8kYck4=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=PUIHW5OgeVwwnLl25bprJdNrrrHMYtvQT+5DC/BtoB8vRumMOIYDMElCBtIYj4DXK 1A1U9I+GcWhEH/Oa2tUoHincXMjaa2XSC6RsEhEzWJqx7tEdwXBYYGfRaOb9zSKjbN V0yAy7hHfKLwSWpXZ9COPjVMev+KAnPZe/yRSAsw= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x334.google.com (mail-wm1-x334.google.com [IPv6:2a00:1450:4864:20::334]) by sourceware.org (Postfix) with ESMTPS id 5A8AB388C00F for ; Sat, 13 Mar 2021 19:25:57 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 5A8AB388C00F Received: by mail-wm1-x334.google.com with SMTP id t5-20020a1c77050000b029010e62cea9deso17084743wmi.0 for ; Sat, 13 Mar 2021 11:25:57 -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=NOO1piYZB4k0TV/xxFD2hxAk7MvONuytBBkxF8kYck4=; b=H+q6s8aWwbNjPOkpVSfrgQJTMUBThzJ4FK+j4elC2umYQrfAvTSU5jTA7vfJx/OMfc sGwlBX1DzP8LciRsnrjcvV5gaPidpKBSzL7HGxIGVphRu39vmpv2FenAL7K9jkpPWCfk 6qHmiJaT/ATVCnrPOjJin72gALcYuD+lhm1BwjgpAbyb4kWrBzqCYOV+qqkjUMt0puKf GpB9YZ9W5w8dOJ1LqFPQViQTC9wVAtUyhqcNyFxRUH6YBxPI58M3JReswMVLSr0bC7i3 DOoqdRogyXMekqBgnPLkdrewDXCu4kkfBj7mMMYZA9p/zKFQ/uUWK/Iz/Fho+/Httlxw Paow== X-Gm-Message-State: AOAM530nwXtCecxToKRRkpqmBvCXYKIgRL56vau+Di3jpAzXO2K1xcSC bM9bQhKm7x6TUnNM63E77G4= X-Google-Smtp-Source: ABdhPJxq/HKudgOtfWet3oROo3nP2zKy3IWv9Mw94DLCTh9f3pueKjVhvJXPpwLA4qXrFTyaVCDnzw== X-Received: by 2002:a7b:c0c4:: with SMTP id s4mr19465206wmh.9.1615663556524; Sat, 13 Mar 2021 11:25:56 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:56 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 09/17] execveat.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:19 +0100 Message-Id: <20210313192526.350200-10-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.4 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/execveat.2 | 13 ++++--------- 1 file changed, 4 insertions(+), 9 deletions(-) diff --git a/man2/execveat.2 b/man2/execveat.2 index 499bf1b57..0d23cb39b 100644 --- a/man2/execveat.2 +++ b/man2/execveat.2 @@ -28,15 +28,13 @@ execveat \- execute program relative to a directory file descriptor .SH SYNOPSIS .nf +.BR "#include " " /* Definition of " SYS_* " constants */" .B #include .PP -.BI "int execveat(int " dirfd ", const char *" pathname , -.BI " const char *const " argv "[], const char *const " envp [], -.BI " int " flags ); +.BI "int syscall(SYS_execveat, int " dirfd ", const char *" pathname , +.BI " const char *const " argv "[], const char *const " envp [], +.BI " int " flags ); .fi -.PP -.IR Note : -There is no glibc wrapper for this system call; see NOTES. .\" FIXME . See https://sourceware.org/bugzilla/show_bug.cgi?id=27364 .SH DESCRIPTION .\" commit 51f39a1f0cea1cacf8c787f652f26dfee9611874 @@ -209,9 +207,6 @@ the natural idiom when using is to set the close-on-exec flag on .IR dirfd . (But see BUGS.) -.PP -Glibc does not provide a wrapper for this system call; call it using -.BR syscall (2). .SH BUGS The .B ENOENT From patchwork Sat Mar 13 19:25:20 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42526 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 2EAF8388C034; Sat, 13 Mar 2021 19:26:02 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 2EAF8388C034 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663562; bh=16hG+prRGYsc90zoRGQcsQFv1GBR/nIH049+WtOVoWA=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=BeB9z6ubNUAklsnCBVDVXeW242skvOdnlbOrz8qpBPDE04FdOv/9ZIU1rIkjkvhC8 LlOP8rbi3XpestStIfLPEitdxh4Izn075OCR1ZfiP7nu1kXKZgpJaSYgNfR4Rj++TK 4tgQ3BmzZE5LKEf2Nakca99I537eFhc1NGzUuEME= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x430.google.com (mail-wr1-x430.google.com [IPv6:2a00:1450:4864:20::430]) by sourceware.org (Postfix) with ESMTPS id 340C0388A811 for ; Sat, 13 Mar 2021 19:25:58 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 340C0388A811 Received: by mail-wr1-x430.google.com with SMTP id y16so6617123wrw.3 for ; Sat, 13 Mar 2021 11:25:58 -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=16hG+prRGYsc90zoRGQcsQFv1GBR/nIH049+WtOVoWA=; b=HPhwcGPFCNURJoekNIcTY+MgvME3dXtcJwpDwn/evsypLZemO2medTdUfU+CuZnAZY hxvAASuYc6frKqcnAtfU7woGW4eLu+JqdiDeO2kwJPyVVYBfFNSTQBJ9tqbpKVA+z8rq r/fsIEL6PYbr1PmNbW6GZCc55oWzvMi2dJw+qfoniL2aJ1mdHJpUwzTA5/YgZencdRM1 5O7tgO9mwibv/H4hFj/qWCctz1Lj9X/WHSl5yZxdbbNYsGAglJPrunuTb2AI0vD2xfQT 5FkJ6uTSwT6r4eOIU9+5CRLxYUdkprzm0Q9pQ+f7gzJisAGRuZ2lPMlsNljF4LUgvJJo t0uQ== X-Gm-Message-State: AOAM533tpjCSJ+yaE1D+5xqWPfmRNSWezhPXtQdhiXWi6ZHj7ICYW1oQ UaBoG829hJqOIm5XdbKP/kJL4BEBClVVKw== X-Google-Smtp-Source: ABdhPJy9L87AixTdY5x8ZssPvIuDW/oCBWr4JSxUVtdGl9Wt2BQEc4B8QXOaVssg/RMvaplZLlgSrw== X-Received: by 2002:adf:f648:: with SMTP id x8mr20244639wrp.157.1615663557329; Sat, 13 Mar 2021 11:25:57 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:57 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 10/17] exit_group.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:20 +0100 Message-Id: <20210313192526.350200-11-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.5 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/exit_group.2 | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/man2/exit_group.2 b/man2/exit_group.2 index d26ec8c70..5bf207bd3 100644 --- a/man2/exit_group.2 +++ b/man2/exit_group.2 @@ -27,9 +27,10 @@ exit_group \- exit all threads in a process .SH SYNOPSIS .nf -.B #include +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #inlcude .PP -.BI "void exit_group(int " status ); +.BI "void syscall(SYS_exit_group, int " status ); .fi .SH DESCRIPTION This system call is equivalent to From patchwork Sat Mar 13 19:25:21 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42527 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 C4474388CC17; Sat, 13 Mar 2021 19:26:02 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C4474388CC17 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663562; bh=ELdom3QA9KtDMvn7b4rnXhEozrUJ/M/stF+XSkKHLwg=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=Me2FJWUxgWJ+AtCl/tFHIggXoKwOh6AwuH8BcrK8RLIhqlIcE7yIml27GSGq/J8+q IGDUtEzQBIkbn+fY1WIEkbvY6IVlp2/sK9wI9gas2753WfSKrtKFEcRGqyrViKu2// G3dCZtRyenC1rnoRNSGhxTFW56uMyHCHlMxgiY9I= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x336.google.com (mail-wm1-x336.google.com [IPv6:2a00:1450:4864:20::336]) by sourceware.org (Postfix) with ESMTPS id 0A528388C00F for ; Sat, 13 Mar 2021 19:25:59 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 0A528388C00F Received: by mail-wm1-x336.google.com with SMTP id f22-20020a7bc8d60000b029010c024a1407so17795131wml.2 for ; Sat, 13 Mar 2021 11:25:58 -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=ELdom3QA9KtDMvn7b4rnXhEozrUJ/M/stF+XSkKHLwg=; b=s4a31X5aOs+WHSSLTSxty9tg1WnuqdHUVKDnU9aJEu1ZS7plEYeSIYvHoPRAAiqAu/ t25BdLr/sDXCvjRsLhq9yO0LF18ELaR4vzyVhCaSVwAohxYega5UpcMxiRhRsX9YVddN 8PSC9VDydsnoZNu0bEEO0j1ESFP61ekIcIi2wZ6JWRmrvBVIrpBtL/s9vt+CdnPQBn8j VNbpCNSB/8LxWhiExlJTDFAo0HFvzrYT4XPekZ1WMtxv42YkQBtEUmeB3kY4Ozeu71RZ G5cNRUjiPr7ZFOKgyDQ/FNkNP8AcWe8aBYPiU1NgyMep00/rnuJLqK/V35hpSaaUnL1c 4LHQ== X-Gm-Message-State: AOAM532DHuSW0ZnM45VcSpU0nSbTaR3YJm80q1H13Gl8esQGLPrI6OuY VPf492LT/Gljl7GaLJTqiyBqSjYqYacqpA== X-Google-Smtp-Source: ABdhPJwyTmDL/rq88PSF7k7CcZENxH2pPePg+uuA365qwWo7crkb4mTyxer3LC5CdTBneL6n3MF/hg== X-Received: by 2002:a7b:cb90:: with SMTP id m16mr18819776wmi.162.1615663558205; Sat, 13 Mar 2021 11:25:58 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:57 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 11/17] futex.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:21 +0100 Message-Id: <20210313192526.350200-12-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.5 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" At the same time, document only headers that are required for calling the function, or those that are specific to the function: is required for the syscall() prototype. is required for the syscall name SYS_xxx. is specific to this syscall. However, uint32_t is generic enough that it shouldn't be documented here. The system_data_types(7) page already documents it, and is more precise about it. The same goes for timespec. As a general rule a man[23] page should document the header that includes the prototype, and all of the headers that define macros that should be used with the call. However, the information about types should be restricted to system_data_types(7) (and that page should probably be improved by adding types), except for types that are very specific to the call. Otherwise, we're duplicating info and it's then harder to maintain, and probably outdated in the future. Signed-off-by: Alejandro Colomar --- man2/futex.2 | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/man2/futex.2 b/man2/futex.2 index e698178d2..a2486628b 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -25,18 +25,16 @@ futex \- fast user-space locking .SH SYNOPSIS .nf .PP -.B #include -.B #include -.B #include +.BR "#include " " /* Definition of " FUTEX_* " constants */" +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include .PP -.BI "long futex(uint32_t *" uaddr ", int " futex_op ", uint32_t " val , -.BI " const struct timespec *" timeout , \ +.BI "long syscall(SYS_futex, uint32_t *" uaddr ", int " futex_op \ +", uint32_t " val , +.BI " const struct timespec *" timeout , \ " \fR /* or: \fBuint32_t \fIval2\fP */" -.BI " uint32_t *" uaddr2 ", uint32_t " val3 ); +.BI " uint32_t *" uaddr2 ", uint32_t " val3 ); .fi -.PP -.IR Note : -There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION The .BR futex () @@ -1695,9 +1693,6 @@ and a sixth argument was added in Linux 2.6.7. .SH CONFORMING TO This system call is Linux-specific. .SH NOTES -Glibc does not provide a wrapper for this system call; call it using -.BR syscall (2). -.PP Several higher-level programming abstractions are implemented via futexes, including POSIX semaphores and various POSIX threads synchronization mechanisms From patchwork Sat Mar 13 19:25:22 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42528 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 54CAE388CC1A; Sat, 13 Mar 2021 19:26:03 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 54CAE388CC1A DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663563; bh=9VCy3PwsXOlp+t9P8TEk8gqJUNOzd1/Fb5yw/M+eqTo=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=iUtezuVJOYGqDYhaRXTornOJEOOPU211sEsM7Na+HbQObsfGkvWPQ/7JB0Sm00YmU XaRI2wum4FKgoMh51R7KrToYvWix9OgWGbnugdUB7UY46st2BdYyFP+rQuQ6AqQ1PY dQ7H3zYvmPl5CIK5QOTOHsClG9yekcTOsGZkr6+U= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x42f.google.com (mail-wr1-x42f.google.com [IPv6:2a00:1450:4864:20::42f]) by sourceware.org (Postfix) with ESMTPS id CEF06388C012 for ; Sat, 13 Mar 2021 19:25:59 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org CEF06388C012 Received: by mail-wr1-x42f.google.com with SMTP id b9so3599721wrt.8 for ; Sat, 13 Mar 2021 11:25:59 -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=9VCy3PwsXOlp+t9P8TEk8gqJUNOzd1/Fb5yw/M+eqTo=; b=sJPjx+Un57/bpFDLel/GNR7bPkNLY2tsCDrUUgKQax+c6Hj4iD7V9taFPACIrVNsBo I0Fam1gIWO7oanVL9CySJzQHRdIrmqOECjMMEpEsnYchw5WZGSipoNy1FWIRMxvyLsM6 EU45yKROqPyHeB9bl5BV5zekS/76U4WEX97fMx5lp5DxHenbi3H57TTMju37V9lAxw4+ cMkbsEw6Gt8NN7qSfaqIp0fA7VB2Ty2OJCh1ryme9g8YhDsya0Y+dfD1VOf8qtApXmTH ivVTooay6Ge5boNeqUujEY1nHOdm1O3OIFI7zPqtWKtqGMNrq1hoiY9ItwEyoSJhrXV2 JFTQ== X-Gm-Message-State: AOAM53176XDx4vmYfU9hVQ77oBX/c+fMN07Gkix18n8utqKFM+lQdl0C Zlrxj0BBx+8+tyq4d9mo01k= X-Google-Smtp-Source: ABdhPJzS85oZIdFISj0xy7H815EDeHntGPJsgnIKwfB9Cd5Euba2OfLlnSCmBIshhd4hdUjDZw/l7w== X-Received: by 2002:adf:82af:: with SMTP id 44mr19370149wrc.279.1615663559022; Sat, 13 Mar 2021 11:25:59 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:58 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 12/17] getdents.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:22 +0100 Message-Id: <20210313192526.350200-13-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.5 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/getdents.2 | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/man2/getdents.2 b/man2/getdents.2 index ba41e0be8..7d5b0e01c 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -33,7 +33,11 @@ getdents, getdents64 \- get directory entries .SH SYNOPSIS .nf -.BI "long getdents(unsigned int " fd ", struct linux_dirent *" dirp , +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include +.PP +.BI "long syscall(SYS_getdents, unsigned int " fd \ +", struct linux_dirent *" dirp , .BI " unsigned int " count ); .PP .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" @@ -43,9 +47,9 @@ getdents, getdents64 \- get directory entries .fi .PP .IR Note : -There is no glibc wrapper for -.BR getdents (); -see NOTES. +There is no definition of +.B struct linux_dirent +in glibc; see NOTES. .SH DESCRIPTION These are not the interfaces you are interested in. Look at From patchwork Sat Mar 13 19:25:23 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42529 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 5481E388C03D; Sat, 13 Mar 2021 19:26:05 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 5481E388C03D DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663565; bh=WAJ8l7S3N7jAAUiOrOBAwKqf/KXf6VsnLcR6sFmm34Q=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=DneLSh/jb4FUYLW9X6eQvoTiY7XQ+uhZAZ0qnSCzQacf73KZJuokuZEcjnRJeRjMM yjTZ2I2JlkpmnqU1rA+kS4VILPMrdo9MXrW83Xh8iD+EEi9j7IEsX4bbSIlEHoaDHm 8+27/QYofXmDdibbB6xF5qOAJpx4ApbX+QQSUgRk= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org 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 B00E6388C034 for ; Sat, 13 Mar 2021 19:26:00 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org B00E6388C034 Received: by mail-wr1-x42e.google.com with SMTP id l12so6605683wry.2 for ; Sat, 13 Mar 2021 11:26:00 -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=WAJ8l7S3N7jAAUiOrOBAwKqf/KXf6VsnLcR6sFmm34Q=; b=BCvadeShKFFuaR9fo8JEi5gbZ2l7cNgUhBTKYj8ZeuftpxOnPGUlgJNJuXL0GHL+Rc VuULUTpeYER5Pt5CTVBsu3yrsRsiHPc3i22vZLWZdc75W5xlw0lpBZ/Y3jSWod3ZsBbg QQJWSV0qkwPmaLe+mL3HJD9uNn08GX09PvILds9/ZmnGX19ZCBNrYU1iD+J8SchBxP4Z KxJhj81hCCuzmTgZBx7PpdJXf0o7DmmAZy6zZoY2WmO1S3S03Oe9zML9KI8VJ8FzRlTv 250y3NfRUnRdwmW6G0qxRPSNQFMmnAzDYRIrGIHUKPmpkoTNbatvumaiHr/SNLjCVjBs zirA== X-Gm-Message-State: AOAM532SLOj1CJyjYhnw41OD72EEwI+1RULg/4xS4GPO/SylaemhPQa8 yHpzpyLQR3IjY/9R/IyHg42ELj8hUaJjzw== X-Google-Smtp-Source: ABdhPJzkRm+ZA4vhU5vZItwDPwVrxlDWOs0deZ/6NNDvo21ELaqzPaYQgbY9quF8RLkyPjJ3BZ7nhw== X-Received: by 2002:adf:cf11:: with SMTP id o17mr20102411wrj.391.1615663559850; Sat, 13 Mar 2021 11:25:59 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:25:59 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 13/17] getunwind.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:23 +0100 Message-Id: <20210313192526.350200-14-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.5 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/getunwind.2 | 14 ++++---------- 1 file changed, 4 insertions(+), 10 deletions(-) diff --git a/man2/getunwind.2 b/man2/getunwind.2 index 9a58f43e4..3490a0617 100644 --- a/man2/getunwind.2 +++ b/man2/getunwind.2 @@ -29,16 +29,14 @@ getunwind \- copy the unwind data to caller's buffer .SH SYNOPSIS .nf -.B #include .B #include +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #inlcude .PP -.BI "long getunwind(void " *buf ", size_t " buf_size ); +.BI "long syscall(SYS_getunwind, void " *buf ", size_t " buf_size ); .fi -.PP -.IR Note : -There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION -.I Note: this function is obsolete. +.I Note: this system call is obsolete. .PP The IA-64-specific @@ -102,9 +100,5 @@ and is available only on the IA-64 architecture. This system call has been deprecated. The modern way to obtain the kernel's unwind data is via the .BR vdso (7). -.PP -Glibc does not provide a wrapper for this system call; -in the unlikely event that you want to call it, use -.BR syscall (2). .SH SEE ALSO .BR getauxval (3) From patchwork Sat Mar 13 19:25:24 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42530 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 DA720388E812; Sat, 13 Mar 2021 19:26:05 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org DA720388E812 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663565; bh=hSTdDcjje/hceZMxpO7qDIzVpu8KWXMOYCef8SD5Sy4=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=xbnQfS4X17caGB98CE8se/Zu9UVfvVunRR+vTc29KgPFhajdsXrFXG8YyRs07ct8X 1jAGec+r1pzwvjuGlTtMmuI8Yyevj4J+9ECbFDMs1yLyLJkrZeUQL+L+5H5FxorQDT cpxfuGdZ9zsAQg+dTepzZM2fZAtxALF9K8IhAROw= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x332.google.com (mail-wm1-x332.google.com [IPv6:2a00:1450:4864:20::332]) by sourceware.org (Postfix) with ESMTPS id 7130C388C00F for ; Sat, 13 Mar 2021 19:26:01 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 7130C388C00F Received: by mail-wm1-x332.google.com with SMTP id b2-20020a7bc2420000b029010be1081172so17104518wmj.1 for ; Sat, 13 Mar 2021 11:26:01 -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=hSTdDcjje/hceZMxpO7qDIzVpu8KWXMOYCef8SD5Sy4=; b=H8UNDWApPG7tNyi8WRmvjL4LtLoTPzSkZxfwxUsVHagXFeZhDjLXQKV133cW7mEMDJ hBIjxpF2l7veVgELKkE3399fy5Qadx81crcm8wMtbxeqM06uefAUIG+nzSkNevSIFvY5 An2H1O1b8xSWv0JIAesuq/u668rdyajIqoM9qrIODGtcpRjZd8Kb7AX3s5o86w5BOcsu 6JYyZZHRkb8KVq5J8cgxdBFKtv7KpoHZfwksKtYy27x1tWyo1ZmsCHd5zwPfqBmpS6jw hpCKcavxAp15ropmVQciXy20f9hpxCX/hVoMVR1wtJV3Tmk3NPSXBBkoV+rGrjuGE4fB h6lw== X-Gm-Message-State: AOAM531S2a1w1tPE6mQ0wxFQ3CNYN8ZQbIfR03LzROOQxwtW46+iJw5A 776quMZSxPU2bP47SLJ3vwXJ9BUEFMpBxQ== X-Google-Smtp-Source: ABdhPJwdRHI7UONCGKpzUUYdG5/c4LkiL+jfrlZ1Xo34nkDe10cswmF2DmJkFx8O2heFSuKKL01mzw== X-Received: by 2002:a05:600c:4f14:: with SMTP id l20mr18692607wmq.71.1615663560662; Sat, 13 Mar 2021 11:26:00 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.25.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:26:00 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 14/17] get_robust_list.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:24 +0100 Message-Id: <20210313192526.350200-15-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.5 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Also remove unused includes. Signed-off-by: Alejandro Colomar --- man2/get_robust_list.2 | 20 ++++++++------------ 1 file changed, 8 insertions(+), 12 deletions(-) diff --git a/man2/get_robust_list.2 b/man2/get_robust_list.2 index b1ae42dbd..9c8f14443 100644 --- a/man2/get_robust_list.2 +++ b/man2/get_robust_list.2 @@ -32,17 +32,16 @@ get_robust_list, set_robust_list \- get/set list of robust futexes .SH SYNOPSIS .nf -.B #include -.B #include -.B #include +.BR "#include " \ +" /* Definition of " "struct robust_list_head" " */" +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include .PP -.BI "long get_robust_list(int " pid ", struct robust_list_head **" head_ptr , -.BI " size_t *" len_ptr ); -.BI "long set_robust_list(struct robust_list_head *" head ", size_t " len ); +.BI "long syscall(SYS_get_robust_list, int " pid , +.BI " struct robust_list_head **" head_ptr ", size_t *" len_ptr ); +.BI "long syscall(SYS_set_robust_list," +.BI " struct robust_list_head *" head ", size_t " len ); .fi -.PP -.IR Note : -There are no glibc wrappers for these system calls; see NOTES. .SH DESCRIPTION These system calls deal with per-thread robust futex lists. These lists are managed in user space: @@ -139,9 +138,6 @@ could be found. These system calls were added in Linux 2.6.17. .SH NOTES These system calls are not needed by normal applications. -No support for them is provided in glibc. -In the unlikely event that you want to call them directly, use -.BR syscall (2). .PP A thread can have only one robust futex list; therefore applications that wish From patchwork Sat Mar 13 19:25:25 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42531 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 70532388E817; Sat, 13 Mar 2021 19:26:06 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 70532388E817 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663566; bh=iXXxzEq/i1zvFxmlPejyeaUZtpudNa9FZiKCSQB8D80=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=CR9TB+NzPtc+LlWat1XMugfopVCtVhnbyq1uEwW074KowG7X5CxVm4InWwSQjF9Pt V/crhwPUxEc2XsxcbMdIz2dOXe30O+EBDINVcJSvCDWNBvbhPPujYWBwhKMlbcRGxR fsbnQqIk41RaBmiGhHhwfBsKibI2eQZdAwv6Ffu0= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wr1-x431.google.com (mail-wr1-x431.google.com [IPv6:2a00:1450:4864:20::431]) by sourceware.org (Postfix) with ESMTPS id 4B817388CC10 for ; Sat, 13 Mar 2021 19:26:02 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 4B817388CC10 Received: by mail-wr1-x431.google.com with SMTP id o16so3590031wrn.0 for ; Sat, 13 Mar 2021 11:26:02 -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=iXXxzEq/i1zvFxmlPejyeaUZtpudNa9FZiKCSQB8D80=; b=RVwN1P2qOob8qrbD91EciwPxeN4exAKiFAdZPkfFwA+uwh2+VK81am5bWOTGJfcxWx t/e1MazE7qNFpYQQAISrL3Fy8m+Op4cj2+KBuw5+VBznkeSqfXPmkSsJtaxjB2gcJW10 vggWOUlBIIAJYC5L4juFO35Stkv3z7NtChfAG2meOeDE2gODd94i5tnsHzigzJ8DuV63 wuS1sTMuNyimm33w8kNf1+G6pyhIY7BWLVgUwz6fE+2U6zov32S2B9a+dS7beRguuDdT KDMH3yQNob0UXTZhu+eeksXOs57EGXvuzXTqzty9Lx2Ihb5TwbAYI3aUmgIrI25MkWSc 7Qeg== X-Gm-Message-State: AOAM5327gocsq2pnCF7a3JbOMY7ft71jn0fpjpIWBl7wCM77FdfLhN8Y QcrLCsvRIAL5A9ki+8GklXA= X-Google-Smtp-Source: ABdhPJwIIxTXko09NS0thsrhkFe+mFWr89bBrsTEyWVtSoe2bpZD4vk06WVJpYIC+8WY9qS+99IiEg== X-Received: by 2002:a5d:6cd2:: with SMTP id c18mr20006031wrc.330.1615663561484; Sat, 13 Mar 2021 11:26:01 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.26.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:26:01 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 16/17] init_module.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:25 +0100 Message-Id: <20210313192526.350200-16-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.5 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/init_module.2 | 21 ++++++++++++--------- 1 file changed, 12 insertions(+), 9 deletions(-) diff --git a/man2/init_module.2 b/man2/init_module.2 index 31229ea93..9bc2080a3 100644 --- a/man2/init_module.2 +++ b/man2/init_module.2 @@ -29,14 +29,22 @@ init_module, finit_module \- load a kernel module .SH SYNOPSIS .nf +.PP .BI "int init_module(void *" module_image ", unsigned long " len , -.BI " const char *" param_values ); -.BI "int finit_module(int " fd ", const char *" param_values , -.BI " int " flags ); +.BI " const char *" param_values ); +.PP +.BR "#include " " /* Definition of " MODULE_* " constants */" +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include +.PP +.BI "int syscall(SYS_finit_module, int " fd ", const char *" param_values , +.BI " int " flags ); .fi .PP .IR Note : -There are no glibc wrappers for these system calls; see NOTES. +No declaration of +.BR init_module () +is provided in glibc headers; see NOTES. .SH DESCRIPTION .BR init_module () loads an ELF image into kernel space, @@ -268,11 +276,6 @@ manually declare the interface in your code; alternatively, you can invoke the system call using .BR syscall (2). .PP -Glibc does not provide a wrapper for -.BR finit_module (); -call it using -.BR syscall (2). -.PP Information about currently loaded modules can be found in .IR /proc/modules and in the file trees under the per-module subdirectories under From patchwork Sat Mar 13 19:25:26 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 42532 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 02214388E81E; Sat, 13 Mar 2021 19:26:07 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 02214388E81E DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1615663567; bh=TV3DFVHVd/Io7+uLLsjFQR+YjYMaeU/o3Y+NljgszpQ=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To:Cc: From; b=JHzkjcqjP29SUwC4+EDy21ZiIXOd0AyVFctp5i52GTEPR/uqtpbff9lSQJmX/Dwg8 wmq38zBH9LfuUBH0cjqn3DJXKcpBMrSRO3Eg+rBSQV+AXZm3uIyRJSjQo1+WprLGeb yGVeGG0sAK1+DOyzyQp+RAUX40ZIvt5rtNy0W1u4= X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from mail-wm1-x32c.google.com (mail-wm1-x32c.google.com [IPv6:2a00:1450:4864:20::32c]) by sourceware.org (Postfix) with ESMTPS id 22911388CC08 for ; Sat, 13 Mar 2021 19:26:03 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 22911388CC08 Received: by mail-wm1-x32c.google.com with SMTP id r15-20020a05600c35cfb029010e639ca09eso17798400wmq.1 for ; Sat, 13 Mar 2021 11:26:03 -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=TV3DFVHVd/Io7+uLLsjFQR+YjYMaeU/o3Y+NljgszpQ=; b=AD3eBxI6ZmL61g3k+DXW7FkSqSosdFR/4MlH2CAdcZDkrw+R68bnSrkDLy1N96FcPS md2DzSq/A3cTMa1wxKH69t+qKA8Q4kF4RqQ7X0TL0NIeGvL/6s1uIbcCDR1kHZ8YeEQ2 vnA+9wacU2qsAqE9u4GIGKr2fo0+4plCDmJyh/V7H4Gaem8gQaVaJoPUwgnCw95nbQFD 0wZoP3vRT82fIDpeeegoMBP5t8ITP12BvtspZ0HyBGPOhDQcjlIBaGmmnI7wVlK6tQCX Eq+3giXh44KJbDf2bsQQoYA0YmWexxXaW2vt1n6cUtM9vRsP5N45ViyR/LnqkL7sUJUM SaoQ== X-Gm-Message-State: AOAM531H0nSrunadizvnqoEPCwaxSt8wLdfqb8jAMe0ww2jvO+tbbsvN MgjGiOPM+VoMGGl/DLzu9Go= X-Google-Smtp-Source: ABdhPJzD9hg/843Gf+kBtreorIu06vUEc1s2tjlQDq11kJvOeL5m5eeLMyzZy0+cVFL7C0Bnw5zxWg== X-Received: by 2002:a1c:dc42:: with SMTP id t63mr18807558wmg.153.1615663562323; Sat, 13 Mar 2021 11:26:02 -0800 (PST) Received: from localhost.localdomain ([170.253.51.130]) by smtp.googlemail.com with ESMTPSA id j136sm7670964wmj.35.2021.03.13.11.26.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 13 Mar 2021 11:26:02 -0800 (PST) To: mtk.manpages@gmail.com Subject: [RFC v3 17/17] ioprio_set.2: Use syscall(SYS_...); for system calls without a wrapper Date: Sat, 13 Mar 2021 20:25:26 +0100 Message-Id: <20210313192526.350200-17-alx.manpages@gmail.com> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20210214133907.157320-1-alx.manpages@gmail.com> References: <20210214133907.157320-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.5 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-Patchwork-Original-From: Alejandro Colomar via Libc-alpha From: Alejandro Colomar Reply-To: Alejandro Colomar Cc: Alejandro Colomar , linux-man@vger.kernel.org, libc-alpha@sourceware.org, linux-kernel@vger.kernel.org, Florian Weimer Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" Signed-off-by: Alejandro Colomar --- man2/ioprio_set.2 | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/man2/ioprio_set.2 b/man2/ioprio_set.2 index 91ec03f3b..f0c914ab0 100644 --- a/man2/ioprio_set.2 +++ b/man2/ioprio_set.2 @@ -26,12 +26,13 @@ ioprio_get, ioprio_set \- get/set I/O scheduling class and priority .SH SYNOPSIS .nf -.BI "int ioprio_get(int " which ", int " who ); -.BI "int ioprio_set(int " which ", int " who ", int " ioprio ); -.fi +.BR "#include " " /* Definition of " IOPRIO_* " constants */" +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include .PP -.IR Note : -There are no glibc wrappers for these system calls; see NOTES. +.BI "int syscall(SYS_ioprio_get, int " which ", int " who ); +.BI "int syscall(SYS_ioprio_set, int " which ", int " who ", int " ioprio ); +.fi .SH DESCRIPTION The .BR ioprio_get () @@ -199,9 +200,6 @@ kernel 2.6.13. .SH CONFORMING TO These system calls are Linux-specific. .SH NOTES -Glibc does not provide a wrapper for these system calls; call them using -.BR syscall (2). -.PP Two or more processes or threads can share an I/O context. This will be the case when .BR clone (2)