From patchwork Mon May 10 17:55: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: 1476622 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=sourceware.org (client-ip=8.43.85.97; helo=sourceware.org; envelope-from=libc-alpha-bounces@sourceware.org; receiver=) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; secure) header.d=sourceware.org header.i=@sourceware.org header.a=rsa-sha256 header.s=default header.b=dYhaYza9; dkim-atps=neutral Received: from sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4Ff7zJ0HYkz9sX1 for ; Tue, 11 May 2021 03:56:44 +1000 (AEST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 85A0B3982074; Mon, 10 May 2021 17:56:28 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 85A0B3982074 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1620669388; bh=R3yQ/6vYV/DqTQrt26JFGj8U/NpSE9wmxiu+INGL8i0=; 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=dYhaYza9rvT1Br9+RPEgUNKaoBSwDwAx9/w9iBNasyEpcIYIIyhllazvuCDK8LGLc M1TtMJj5T/3v7JcUbBz+WHPYXXwgKKbBqE51lTGBthm2ktLjTqPaGOTcxYhN/pGedb 2KmoEM0vaNBUAFIVKlReyJz9qGkAnNrfm/dnwO64= 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 77740398205D for ; Mon, 10 May 2021 17:56:26 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 77740398205D Received: by mail-wm1-x332.google.com with SMTP id o26-20020a1c4d1a0000b0290146e1feccdaso10139207wmh.0 for ; Mon, 10 May 2021 10:56:26 -0700 (PDT) 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=R3yQ/6vYV/DqTQrt26JFGj8U/NpSE9wmxiu+INGL8i0=; b=VTurWoXOKO8Y94823Gu1xJ+Zg/bNW4ArLNcQPmsRIXDUb4TKMAKEo2jwb+kUs4ezYW rU3dAGZkaR79VTzzDM/yZtbLHJL2okODwn17xFPgom5MpsqqLVlOYEhG1EceJK3tmqG6 TiIisSByvhudRWOt7iNP+cit7dD3ZKNQkUo2RubHYB7/s/SMNAxRNV1pOsdmqCyonxO9 G9OFgm+HxTXS4CTPtLEvvbr9YCTSVqJ/lcEDQYU/zPewXG3N3Pi8COdUrrF24t5F8t0e 22gHte0Gzm7gZ5SRoPzxlIqqmix9kjCTj/zBLiKmHpC5ylAJ8a8cP+KnnLQwQ97igIIX 05Qw== X-Gm-Message-State: AOAM531VFj++Gf9L2f86frSe/syuHjo2Sxiy9pGHHnujqVlOnc7vXFXD pmESLsn66YQiMJOX2D3yb2w= X-Google-Smtp-Source: ABdhPJztXA8ckbJE60dZWFpzZ5+z9fDi25XZHmIrFUUh5qS2ACSUb430n4J8+NcEWqieIKlYMMk9Zw== X-Received: by 2002:a7b:c195:: with SMTP id y21mr387745wmi.108.1620669385652; Mon, 10 May 2021 10:56:25 -0700 (PDT) Received: from sqli.sqli.com ([195.53.121.100]) by smtp.googlemail.com with ESMTPSA id m13sm24318830wrw.86.2021.05.10.10.56.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 10 May 2021 10:56:25 -0700 (PDT) To: mtk.manpages@gmail.com Subject: [PATCH 06/39] io_getevents.2: Use syscall(SYS_...); for system calls without a wrapper Date: Mon, 10 May 2021 19:55:15 +0200 Message-Id: <20210510175546.28445-7-alx.manpages@gmail.com> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210510175546.28445-1-alx.manpages@gmail.com> References: <20210510175546.28445-1-alx.manpages@gmail.com> MIME-Version: 1.0 X-Spam-Status: No, score=-12.2 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: Florian Weimer , Jakub Wilk , Alejandro Colomar , libc-alpha@sourceware.org, linux-man@vger.kernel.org Errors-To: libc-alpha-bounces@sourceware.org Sender: "Libc-alpha" In this case there's a wrapper provided by libaio, but this page documents the raw syscall. Also remove from the includes: 'struct timespec' is already documented in system_data_types(7), where the information is more up to date. Signed-off-by: Alejandro Colomar --- man2/io_getevents.2 | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/man2/io_getevents.2 b/man2/io_getevents.2 index 87eefdd92..7c7e625bf 100644 --- a/man2/io_getevents.2 +++ b/man2/io_getevents.2 @@ -9,16 +9,20 @@ io_getevents \- read asynchronous I/O events from the completion queue .SH SYNOPSIS .nf -.BR "#include " " /* Defines needed types */" -.BR "#include " " /* Defines 'struct timespec' */" +.BR "#include " " /* Definition of " *io_* " types */" +.BR "#include " " /* Definition of " SYS_* " constants */" +.B #include .PP -.BI "int io_getevents(aio_context_t " ctx_id ", long " min_nr ", long " nr , -.BI " struct io_event *" events \ -", struct timespec *" timeout ); +.BI "int syscall(SYS_io_getevents, aio_context_t " ctx_id , +.BI " long " min_nr ", long " nr ", struct io_event *" events , +.BI " struct timespec *" timeout ); .fi .PP .IR Note : -There is no glibc wrapper for this system call; see NOTES. +glibc provides no wrapper for +.BR io_getevents (), +necessitating the use of +.BR syscall (2). .SH DESCRIPTION .IR Note : this page describes the raw Linux system call interface. @@ -94,10 +98,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 for this system call. -You could invoke it using -.BR syscall (2). -But instead, you probably want to use the +You probably want to use the .BR io_getevents () wrapper function provided by .\" http://git.fedorahosted.org/git/?p=libaio.git