Received: by 2002:a05:7412:2a8c:b0:e2:908c:2ebd with SMTP id u12csp1537451rdh; Mon, 25 Sep 2023 16:29:01 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFHMYKSeexXxsZoRHUZRf5ZHOGBzwANJlQqNH5jWHrkIfYKoIp4goCBLxw2oIzfw79WVA3m X-Received: by 2002:a05:6a00:850:b0:68e:2b17:a729 with SMTP id q16-20020a056a00085000b0068e2b17a729mr7666689pfk.24.1695684540941; Mon, 25 Sep 2023 16:29:00 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1695684540; cv=none; d=google.com; s=arc-20160816; b=UFV4ROeJ4QwZh6wi85LKTX4ZeJOrEyAmT3i5pfF6jfvJHaJeA3AEtEzRri80ypvmKL mcLcFBZWZqGYeGXBcba9OxcWgoIC9vVtTsPaQpoMFFgDYMCnAbWZ4dOhBd8TMA21/Xmj KJPg+kyvLavsv7vhEc1RG8CWeWOXhdapIWwoTZrMnYGu0Cwdzh58NQVB5fPecyHDAGHH hh8J4Rrds+ihhXA4xtnTuoR/mGOberGJs85ITAu24WjrrWa1fmRSQkU400WyDXicBuPp nVpgbqAYydJxx3OWr4V7/0S49pU5pZaw2wytovoSlhatjEdxEdj0nKQMooFomIXFtYV8 wO+w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=L0VedKTNVQ77inTCGMlPKRuNEqlYGc3T+6p6BqjcC58=; fh=wtPNz5QEtytCPPuNNoj9k3ZLKUvhc5S3xSbNrMwZr3o=; b=nzdDpW5GaAXZeCkvCu9cI34wX0fh4xBhdelnZtZvQrsCIJUV1GJCqLJu5iWk20yZV6 zNpm4K4O3BqJFzzxI7vJvOFmQBNS9MgKmosDzjMdHiX+tbS532ywOx+UWNxtSTMR6mkZ Hi9HE0hFN1YBrRunU0EJVdZVPC5OHdhs7hPtD+VsHL/gufmXcb79SLZFkZhTw/lPjDWs OlmoGYJBLcG6BgOe6eXSvRkey21o7idnAxuYpuqvcY4z2ZulBVDp0itXJ5jpnUKewrZe K45BkILAzlrLPh8Tt86kbRSfrXxme4WfEis5PJ0Sp12Fhon10+pV/5Qrx9MVP/Q3WD+X uaRQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=ENn3siKc; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from morse.vger.email (morse.vger.email. [2620:137:e000::3:1]) by mx.google.com with ESMTPS id cw16-20020a056a00451000b006906a716917si10894279pfb.398.2023.09.25.16.29.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 25 Sep 2023 16:29:00 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) client-ip=2620:137:e000::3:1; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=ENn3siKc; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:1 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by morse.vger.email (Postfix) with ESMTP id 749E380A5B7A; Mon, 25 Sep 2023 16:26:29 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at morse.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233510AbjIYX0Y (ORCPT + 99 others); Mon, 25 Sep 2023 19:26:24 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:36820 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233505AbjIYX0X (ORCPT ); Mon, 25 Sep 2023 19:26:23 -0400 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id CF2D6116; Mon, 25 Sep 2023 16:26:16 -0700 (PDT) Received: by smtp.kernel.org (Postfix) with ESMTPSA id A4B2EC433C7; Mon, 25 Sep 2023 23:26:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1695684375; bh=jOyx67uC5SiTnS8BEffUOwQ+irVxWeLVnsb6YQnLZ84=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=ENn3siKcf22oNZBRFZiFRGe/3kDZ1cRe9VhX5fs/gkJBge9tHAM1fZopaBsx5kzOa UYnUkWT+oamvExA76HoT8LZYfjQvRxOVqYytGdap9IBp7BMCAltVUfFKNKbX2s1up3 ZuHYMD4E9NWowqb2LDIPZD5HvYRajIsGtJRRKoRqeUki3hXSJCExTHQ6N90cYlBQ2h uHUb0SuYEcye3oxNG9zxY5ImyODNCCsUQkBvae9v6eMO8cOs9bjvI1HS76NZnZnVio 1FqQZflt18eeAqblAD3uPi9Er1noWnfu+1XpEeAG7DsSRpvxXb+UlYsibskoT83aOb Wt7gIbWKNfexA== Date: Tue, 26 Sep 2023 01:26:12 +0200 From: Alejandro Colomar To: Axel Rasmussen Cc: Peter Xu , linux-man@vger.kernel.org, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 01/10] userfaultfd.2: briefly mention two-step feature handshake process Message-ID: References: <20230919190206.388896-1-axelrasmussen@google.com> <20230919190206.388896-2-axelrasmussen@google.com> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="tgqgkjx42vy67lq3" Content-Disposition: inline In-Reply-To: <20230919190206.388896-2-axelrasmussen@google.com> X-Spam-Status: No, score=-1.2 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on morse.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 (morse.vger.email [0.0.0.0]); Mon, 25 Sep 2023 16:26:29 -0700 (PDT) --tgqgkjx42vy67lq3 Content-Type: text/plain; protected-headers=v1; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Subject: Re: [PATCH 01/10] userfaultfd.2: briefly mention two-step feature handshake process MIME-Version: 1.0 On Tue, Sep 19, 2023 at 12:01:57PM -0700, Axel Rasmussen wrote: > This process is critical for programs which depend on extra features, so > it's worth mentioning here. >=20 > Future commits will much more fully describe it in ioctl_userfaultfd.2. >=20 > Signed-off-by: Axel Rasmussen Patch applied. Thanks, Alex > --- > man2/userfaultfd.2 | 5 +++-- > 1 file changed, 3 insertions(+), 2 deletions(-) >=20 > diff --git a/man2/userfaultfd.2 b/man2/userfaultfd.2 > index 40354065c..1b2af22f9 100644 > --- a/man2/userfaultfd.2 > +++ b/man2/userfaultfd.2 > @@ -200,8 +200,9 @@ the application must enable it using the > .B UFFDIO_API > .BR ioctl (2) > operation. > -This operation allows a handshake between the kernel and user space > -to determine the API version and supported features. > +This operation allows a two-step handshake between the kernel and user s= pace > +to determine what API version and features the kernel supports, > +and then to enable those features user space wants. > This operation must be performed before any of the other > .BR ioctl (2) > operations described below (or those operations fail with the > --=20 > 2.42.0.459.ge4e396fd5e-goog >=20 --tgqgkjx42vy67lq3 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCgAdFiEE6jqH8KTroDDkXfJAnowa+77/2zIFAmUSFxQACgkQnowa+77/ 2zJzhQ//fs/V8Tpm5+m/k8G4xl6w0oXrzif8flzrufdNp4if/Z5VGlrNmo8xPh7G YsRjHzLKAXQrn79h8vRvC459DSkMixazhRhmxcnPi45kkMJX53LNMNyzugY/20Vc CSya5HdMV5/5m43RITW+PCQsnSmgByKP+KuPn3cuANpSF1Hyvwz1E3OXmTJN+qL2 8KPz+fRrC25+eMGmM4K/+pIwPGctelcXAx13icBj50ae+4VDsmNR9tXKuq5m0tNo Z34PEQp2rt+PW3XnyGSsZ2k2RQV2F1utm8Jm9G7gRkb7Ub5sab9xxdt4kUDM4Faj WawMXG/x7PfB37cU440t7eytXOhBCpHAA5SwIdPcI/V453pQs+hRYwXCwVR6UgpZ vV6BUf/2NcHLwEp3L3dUHfgSslaoK2o+/bsZZkj/JrpdJ3PpV4DhWNCz3y4XerEu M4huVEtzmbXFoKWHzLz2hZVZxSxNnfFY2AbZnnfi1tZVhFXeXXvNqWO98Uhyk6bE MRqi8pEWB0fWRyya7gG7/THkrejuNtlGcxCbNH9ucqe55eZZBiDYWDopWS56P7iy LLS2NgOsXXmBM3I/TVKmu3NvlDMt9VOzCQ4rPk6kU4i03eOPloqKqe/phCYZbBDa Kx2cT2wxyr1TzPd/Z3iZno58u7KDTYkJhgGt+BRCkCZCL3VqBoI= =2ZdH -----END PGP SIGNATURE----- --tgqgkjx42vy67lq3--