From patchwork Tue Sep 19 19:01:58 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Axel Rasmussen X-Patchwork-Id: 142142 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:172:b0:3f2:4152:657d with SMTP id h50csp3778780vqi; Tue, 19 Sep 2023 17:36:34 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFmJTru0ruhxFwCdUgwNFPPbMYRe4+pO6hY4mQtpr8xhv4ZWdmuLLww8CzkQ3Tw8Z8ATDWq X-Received: by 2002:aca:2214:0:b0:3ac:cf91:9157 with SMTP id b20-20020aca2214000000b003accf919157mr868494oic.53.1695170193803; Tue, 19 Sep 2023 17:36:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695170193; cv=none; d=google.com; s=arc-20160816; b=EwyuEtFzorHOUWOixQmow0oyIgWMCtkoxHxPk07OEHEV+UQwY6NnLOZ5JKpw6HM0sG EeztxuXNtmBsCkfvie/kLaIRxaliXby8FfQFvU87lEDDnUeSkLYbr8dLlFDT45siR+WF 5TrymPQGxa52LuZ+SXQXhyjysb3y3jR8wwhhkHBB5kI6B3xhSG843D0P8KX8E/BI46PR Dr02AykNdCs7BHvWwXgGI7Al2IhcaMxj3o06rrLOFTZrf7sGN7fI9yPDpNv6f36vm+zO g4dpflcIhxDMzi+mfAVwQx47E/XGSqgE/+Onj9wa1QoEzfVEpVx9HpyguC6HcqHTXXjO JKOQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:from:subject:message-id:references :mime-version:in-reply-to:date:dkim-signature; bh=x6ui7w7cp8TYbfd07TcF3y+H8C9qnaw+znngkakEYjM=; fh=SqwPTGdhTS3wVH9FltNQ4n/lDM1p3ApEDnroT8zra0U=; b=VTxVoNc8MV54NM0oDE7q4DI3PBt21DTHgpA7Ja022q1L5bDfWaH0UNoHmxoDdNesb8 J4+qQrPAnMSnWs5/zB5T84U+kbbRPmvgPQRdY93NcPicnkE2OW10iRouqeKddtQDCTQU DxKFqipSpIFbA4Nh2u7ciJLtytD0biA2TZEHPmh23JLEhCCbWQNogOuJXMHvZaZ8jwky kGShbATC1bOJ5iEYxCO9C4uVoO4xw9q7mI80xeNh2ixtRNxbvvrWMLrz6ObZKlI5U2np 2/90YNNNTFESApwOufdHqxfjrrIjfR4U8pS0Nleq12ckiqCUDKgGnoI/QykHAJMGl0+P ud9g== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b=LcscbQOX; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from groat.vger.email (groat.vger.email. [2620:137:e000::3:5]) by mx.google.com with ESMTPS id i3-20020a63e903000000b00543c84bf588si10703806pgh.473.2023.09.19.17.36.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Sep 2023 17:36:33 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) client-ip=2620:137:e000::3:5; Authentication-Results: mx.google.com; dkim=pass header.i=@google.com header.s=20230601 header.b=LcscbQOX; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:5 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=google.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by groat.vger.email (Postfix) with ESMTP id 46EC48301481; Tue, 19 Sep 2023 12:02:49 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at groat.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232717AbjISTCd (ORCPT + 26 others); Tue, 19 Sep 2023 15:02:33 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48734 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232590AbjISTCY (ORCPT ); Tue, 19 Sep 2023 15:02:24 -0400 Received: from mail-yb1-xb4a.google.com (mail-yb1-xb4a.google.com [IPv6:2607:f8b0:4864:20::b4a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7A974B3 for ; Tue, 19 Sep 2023 12:02:18 -0700 (PDT) Received: by mail-yb1-xb4a.google.com with SMTP id 3f1490d57ef6-d8141d6fbe3so6614023276.3 for ; Tue, 19 Sep 2023 12:02:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20230601; t=1695150137; x=1695754937; darn=vger.kernel.org; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=x6ui7w7cp8TYbfd07TcF3y+H8C9qnaw+znngkakEYjM=; b=LcscbQOX3ImqVLH+5kec+ofiycAZm4qAuxza/IugfiRNp3zXc+GMQm+POfpFCPEeA+ 5lTTbanDD9Po9U/OHM6kYeaK9UKFVaj+CJPjwyfROJcdBXnmIHrShKZxCV8SuXBgvVBg UES1b6xTUdQZsGckZk+azzRakl5HCQYatGRqrDRPqetyEOrF4ARqjNgIr3Ppw8QL6lR4 RHjnz87lUQ7kE0cFJJfhGatk7AGkyeYXPh0LqIriz1pALWbB1JPkQn0Cz/IMDhAPM5fa YXkIlmKEm4AmLQIU7wOU5hVxLXPUTK9OziWtaeGheuhn+tJVeKBd/zZMlCpqxP5hF+ae JUfw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1695150137; x=1695754937; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=x6ui7w7cp8TYbfd07TcF3y+H8C9qnaw+znngkakEYjM=; b=Lz+Z1NjYwI8cofXe870KzDGjaol/KuTEdGuojwUudfApL4pvz69MWmp2FVFTt47TX1 QGY2NwReCtM1y1gEuFh/TF0gE6DLfey3wxdLU7VjzsL+FgtfkcrYv3l8joOSX7fxiOKl LS1nnpkkJueid+gT+eY/fa5z9OcPV1wpwhLW+S2qCpsmCRwAp/+tOzWQEzRTbzw0Ph17 Zv+D52tEFSotr1zDiIOtNe3OyOJpK8xnXvEbfdk9Kw4eGHjR65j0ah4+N/AYX/MzUFGl 9vowQMOv+4+qBm9dt/Rg6TUSs0MeMy7hSn9tqMCTiNM7XPfv9GWDV787b02wyz4RIXay KozQ== X-Gm-Message-State: AOJu0YwNUsYlRKGakid8sSvKU6EvOQoQEQ763SEma/Z3YUpveGlUL27d 2WWzmijpSj0FsGBlFbMI5MhhDRiZ6eZly+u7LJTJ X-Received: from axel.svl.corp.google.com ([2620:15c:2a3:200:8f5a:6a6a:cafc:a3ad]) (user=axelrasmussen job=sendgmr) by 2002:a25:8b0c:0:b0:cf9:3564:33cc with SMTP id i12-20020a258b0c000000b00cf9356433ccmr8307ybl.13.1695150137798; Tue, 19 Sep 2023 12:02:17 -0700 (PDT) Date: Tue, 19 Sep 2023 12:01:58 -0700 In-Reply-To: <20230919190206.388896-1-axelrasmussen@google.com> Mime-Version: 1.0 References: <20230919190206.388896-1-axelrasmussen@google.com> X-Mailer: git-send-email 2.42.0.459.ge4e396fd5e-goog Message-ID: <20230919190206.388896-3-axelrasmussen@google.com> Subject: [PATCH 02/10] userfaultfd.2: reword to account for new fault resolution ioctls From: Axel Rasmussen To: Alejandro Colomar , Peter Xu Cc: linux-man@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org, Axel Rasmussen X-Spam-Status: No, score=-8.4 required=5.0 tests=DKIMWL_WL_MED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_IN_DEF_DKIM_WL autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on groat.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (groat.vger.email [0.0.0.0]); Tue, 19 Sep 2023 12:02:49 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1777514781190239540 X-GMAIL-MSGID: 1777514781190239540 Basically, reword the sentence to clarify that this isn't a complete list. I don't believe it's worth maintaining a fully complete list here, instead ioctl_userfaultfd.2 is the place to do that. Let this just be an example. Signed-off-by: Axel Rasmussen Reviewed-by: Mike Rapoport (IBM) --- man2/userfaultfd.2 | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 index 1b2af22f9..00d94e514 100644 --- a/man2/userfaultfd.2 +++ b/man2/userfaultfd.2 @@ -222,11 +222,12 @@ operation, a page fault occurring in the requested memory range, and satisfying the mode defined at the registration time, will be forwarded by the kernel to the user-space application. -The application can then use the +The application can then use various (e.g. .B UFFDIO_COPY , .B UFFDIO_ZEROPAGE , or .B UFFDIO_CONTINUE +) .BR ioctl (2) operations to resolve the page fault. .PP