Received: by 2002:a05:6a10:9848:0:0:0:0 with SMTP id x8csp4069515pxf; Tue, 23 Mar 2021 01:35:17 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxdBNK/URppRqzSMp5Dyin57gyHAzK/kZjNpXJ6xIC0MVFTt/iQp517JohLgmY4cPs27XDa X-Received: by 2002:aa7:d3ca:: with SMTP id o10mr3527048edr.374.1616488517564; Tue, 23 Mar 2021 01:35:17 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1616488517; cv=none; d=google.com; s=arc-20160816; b=gJmdrjMfsDL9opMOgEvofRCp/9mSmw9wi9WH/LRMn+BiGG17uNhacp8cyH0uh6xLMD r+QjOcRJAyI1HHoVOiPwUWaBTSgJwlqRXXTwbj2fuCiKYRw5nKhh2kCOZcqs+PAc248p TCQnktlQg4Ex9XWIxh2/7UHl765jijFfobN0+0RcFs1lBbGBjuZdB57giLlAXasKtBFQ IKqIAHEMkVBwxJcOIatt97yodkrioDgyAwoiYa0a7NM2S8n2Z/c1GfJHvCiFV6A3OI0/ N/5DgP1XnQDeWDeVmmvh2Q2OZJInsV68t3Rd81LoRHJMk+Bhnc4HrNswPGypn0UA1QG1 uKVA== 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=RgkkpCY1i5Xe5JLu7SA08Rzz6GvG3yThCD9je1unTSo=; b=y9FgRXsDIEknlwogx3EnNTPBsRpBEClVGnPfLSuqAId0x6lTibs3bLd+07NbZMYhBL P9tjVixBWM/1AUreSeoz6NiRHE/rz/pliO6Iz8aEWO6UabLR5ELF4vhR2cdhgyYd1l4R G8QLPxgEAmKI4h7188ApFeZJJGMaUKHFYlZfBUaha9pi89tzF2L4us6XiFSTj7/ozHQN A7iXd0/Z+9OObqsJcEtyjL+VDKN92XgVdgvIiGxr4M/xtoFPFrebXxj19DGecqwd77b8 BxnHQg4RD+k/H36+aYSvHaiGLHFWwQX62EZFWEh0cGzQHDN9pdmIw1QReDFsVkKcleAO mO4w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@ibm.com header.s=pp1 header.b=Fqxzxa+B; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=ibm.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id ga16si12682322ejc.102.2021.03.23.01.34.54; Tue, 23 Mar 2021 01:35:17 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@ibm.com header.s=pp1 header.b=Fqxzxa+B; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229639AbhCWIbu (ORCPT + 99 others); Tue, 23 Mar 2021 04:31:50 -0400 Received: from mx0a-001b2d01.pphosted.com ([148.163.156.1]:32580 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229576AbhCWIbn (ORCPT ); Tue, 23 Mar 2021 04:31:43 -0400 Received: from pps.filterd (m0098393.ppops.net [127.0.0.1]) by mx0a-001b2d01.pphosted.com (8.16.0.43/8.16.0.43) with SMTP id 12N84bZZ142104; Tue, 23 Mar 2021 04:31:41 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=date : from : to : cc : subject : message-id : references : mime-version : content-type : in-reply-to; s=pp1; bh=RgkkpCY1i5Xe5JLu7SA08Rzz6GvG3yThCD9je1unTSo=; b=Fqxzxa+B+hxQNRp9z9861gD6Pth90FL4z2Fx97u//S25e22wSm3QTm1g5Mya5+LtfYL9 +yyxRjlZg5uMSUp5Dx/MXq62e6eLe1lpt7gOGPS4TLpXOMSpOMimlc66mv0JI9Xlw2Yj vsdQ/RGBLo8RHTJtULJW2BrlzxD6cVYEwhnscRxLDqfxMoZDlwaFnLXWlVs4x8x76a7j 1wSuHdbnGE32q81V+s0lO9y+Q86pgsAnzWPNEAN7bxxNcS3sCk9Bb+S+I5dK6R01k5Lo Rdy863IVOVIa64SLZJALO+u8ktcUk+LyH2XXZOSCfCTkmFpONDsi2J4hdQzl78vUb3Cd Hw== Received: from pps.reinject (localhost [127.0.0.1]) by mx0a-001b2d01.pphosted.com with ESMTP id 37dx4at77t-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 23 Mar 2021 04:31:40 -0400 Received: from m0098393.ppops.net (m0098393.ppops.net [127.0.0.1]) by pps.reinject (8.16.0.43/8.16.0.43) with SMTP id 12N85PGi145585; Tue, 23 Mar 2021 04:31:40 -0400 Received: from ppma06ams.nl.ibm.com (66.31.33a9.ip4.static.sl-reverse.com [169.51.49.102]) by mx0a-001b2d01.pphosted.com with ESMTP id 37dx4at776-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 23 Mar 2021 04:31:40 -0400 Received: from pps.filterd (ppma06ams.nl.ibm.com [127.0.0.1]) by ppma06ams.nl.ibm.com (8.16.0.43/8.16.0.43) with SMTP id 12N8Qkb9008395; Tue, 23 Mar 2021 08:31:38 GMT Received: from b06cxnps4075.portsmouth.uk.ibm.com (d06relay12.portsmouth.uk.ibm.com [9.149.109.197]) by ppma06ams.nl.ibm.com with ESMTP id 37d9bmk4q6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 23 Mar 2021 08:31:37 +0000 Received: from d06av24.portsmouth.uk.ibm.com (d06av24.portsmouth.uk.ibm.com [9.149.105.60]) by b06cxnps4075.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id 12N8VZAM1114874 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 23 Mar 2021 08:31:35 GMT Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id A731A42041; Tue, 23 Mar 2021 08:31:35 +0000 (GMT) Received: from d06av24.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 544524204B; Tue, 23 Mar 2021 08:31:34 +0000 (GMT) Received: from linux.ibm.com (unknown [9.145.165.64]) by d06av24.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Tue, 23 Mar 2021 08:31:34 +0000 (GMT) Date: Tue, 23 Mar 2021 10:31:31 +0200 From: Mike Rapoport To: Peter Xu Cc: linux-man@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org, Andrea Arcangeli , Mike Rapoport , Axel Rasmussen , Alejandro Colomar , Michael Kerrisk , Nadav Amit , Andrew Morton Subject: Re: [PATCH v4 0/4] man2: udpate mm/userfaultfd manpages to latest Message-ID: References: <20210322220848.52162-1-peterx@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20210322220848.52162-1-peterx@redhat.com> X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.369,18.0.761 definitions=2021-03-23_02:2021-03-22,2021-03-23 signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 phishscore=0 impostorscore=0 spamscore=0 suspectscore=0 mlxlogscore=999 priorityscore=1501 mlxscore=0 adultscore=0 bulkscore=0 malwarescore=0 lowpriorityscore=0 clxscore=1015 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2103230057 Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, Mar 22, 2021 at 06:08:44PM -0400, Peter Xu wrote: > v4: > - Fixed a few "subordinate clauses" (SC) cases [Alex] > - Reword in ioctl_userfaultfd.2 to use bold font for the two modes referenced, > so as to be clear on what is "both" referring to [Alex] > > v3: > - Don't use "Currently", instead add "(since x.y)" mark where proper [Alex] > - Always use semantic newlines across the whole patchset [Alex] > - Use quote when possible, rather than escapes [Alex] > - Fix one missing replacement of ".BR" -> ".B" [Alex] > - Some other trivial rephrases here and there when fixing up above > > v2 changes: > - Fix wordings as suggested [MikeR] > - convert ".BR" to ".B" where proper for the patchset [Alex] > - rearrange a few lines in the last two patches where they got messed up > - document more things, e.g. UFFDIO_COPY_MODE_WP; and also on how to resolve a > wr-protect page fault. > > There're two features missing in current manpage, namely: > > (1) Userfaultfd Thread-ID feature > (2) Userfaultfd write protect mode > > There's also a 3rd one which was just contributed from Axel - Axel, I think it > would be great if you can add that part too, probably after the whole > hugetlbfs/shmem minor mode reaches the linux master branch. > > Please review, thanks. > > Peter Xu (4): > userfaultfd.2: Add UFFD_FEATURE_THREAD_ID docs > userfaultfd.2: Add write-protect mode > ioctl_userfaultfd.2: Add UFFD_FEATURE_THREAD_ID docs > ioctl_userfaultfd.2: Add write-protect mode docs > > man2/ioctl_userfaultfd.2 | 89 ++++++++++++++++++++++++++++- > man2/userfaultfd.2 | 117 ++++++++++++++++++++++++++++++++++++++- > 2 files changed, 201 insertions(+), 5 deletions(-) Acked-by: Mike Rapoport > -- > 2.26.2 > > -- Sincerely yours, Mike.