From mboxrd@z Thu Jan 1 00:00:00 1970 From: Andrea Arcangeli Subject: Re: [PATCH 01/23] userfaultfd: linux/Documentation/vm/userfaultfd.txt Date: Fri, 4 Dec 2015 18:55:03 +0100 Message-ID: <20151204175503.GZ29105@redhat.com> References: <1431624680-20153-1-git-send-email-aarcange@redhat.com> <1431624680-20153-2-git-send-email-aarcange@redhat.com> <55F29513.4030503@gmail.com> <5661B62B.2020409@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Content-Disposition: inline In-Reply-To: <5661B62B.2020409-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> Sender: linux-api-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org To: "Michael Kerrisk (man-pages)" Cc: Andrew Morton , linux-kernel-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, linux-mm-Bw31MaZKKs3YtjvyW6yDsg@public.gmane.org, qemu-devel-qX2TKyscuCcdnm+yROfE0A@public.gmane.org, kvm-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, linux-api-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, Pavel Emelyanov , Sanidhya Kashyap , zhang.zhanghailiang-hv44wF8Li93QT0dZR+AlfA@public.gmane.org, Linus Torvalds , "Kirill A. Shutemov" , Andres Lagar-Cavilla , Dave Hansen , Paolo Bonzini , Rik van Riel , Mel Gorman , Andy Lutomirski , Hugh Dickins , Peter Feiner , "Dr. David Alan Gilbert" , Johannes Weiner , "Huangpeng (Peter)" List-Id: linux-api@vger.kernel.org Hello Michael, On Fri, Dec 04, 2015 at 04:50:03PM +0100, Michael Kerrisk (man-pages) wrote: > Hi Andrea, > > On 09/11/2015 10:47 AM, Michael Kerrisk (man-pages) wrote: > > On 05/14/2015 07:30 PM, Andrea Arcangeli wrote: > >> Add documentation. > > > > Hi Andrea, > > > > I do not recall... Did you write a man page also for this new system call? > > No response to my last mail, so I'll try again... Did you > write any man page for this interface? I wished I would answer with the manpage itself to give a more satisfactory answer, but answer is still no at this time. Right now there's the write protection tracking feature posted to linux-mm and I'm currently reviewing that. It's worth documenting that part too in the manpage as it's going to happen sooner than later. Lack of manpage so far didn't prevent userland to use it (qemu postcopy is already in upstream qemu and it depends on userfaultfd), nor review of the code nor other kernel contributors to extend the syscall API. Other users started testing the syscall too. This is just to explain why unfortunately the manpage didn't get the top priority yet, but nevertheless the manpage should happen too and it's important. Advice on how to proceed is welcome. Thanks, Andrea From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-qg0-f41.google.com (mail-qg0-f41.google.com [209.85.192.41]) by kanga.kvack.org (Postfix) with ESMTP id 2774B6B025C for ; Fri, 4 Dec 2015 12:55:09 -0500 (EST) Received: by qgec40 with SMTP id c40so94094208qge.2 for ; Fri, 04 Dec 2015 09:55:09 -0800 (PST) Received: from mx1.redhat.com (mx1.redhat.com. [209.132.183.28]) by mx.google.com with ESMTPS id t130si13379347qhb.55.2015.12.04.09.55.07 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Fri, 04 Dec 2015 09:55:08 -0800 (PST) Date: Fri, 4 Dec 2015 18:55:03 +0100 From: Andrea Arcangeli Subject: Re: [PATCH 01/23] userfaultfd: linux/Documentation/vm/userfaultfd.txt Message-ID: <20151204175503.GZ29105@redhat.com> References: <1431624680-20153-1-git-send-email-aarcange@redhat.com> <1431624680-20153-2-git-send-email-aarcange@redhat.com> <55F29513.4030503@gmail.com> <5661B62B.2020409@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <5661B62B.2020409@gmail.com> Sender: owner-linux-mm@kvack.org List-ID: To: "Michael Kerrisk (man-pages)" Cc: Andrew Morton , linux-kernel@vger.kernel.org, linux-mm@kvack.org, qemu-devel@nongnu.org, kvm@vger.kernel.org, linux-api@vger.kernel.org, Pavel Emelyanov , Sanidhya Kashyap , zhang.zhanghailiang@huawei.com, Linus Torvalds , "Kirill A. Shutemov" , Andres Lagar-Cavilla , Dave Hansen , Paolo Bonzini , Rik van Riel , Mel Gorman , Andy Lutomirski , Hugh Dickins , Peter Feiner , "Dr. David Alan Gilbert" , Johannes Weiner , "Huangpeng (Peter)" Hello Michael, On Fri, Dec 04, 2015 at 04:50:03PM +0100, Michael Kerrisk (man-pages) wrote: > Hi Andrea, > > On 09/11/2015 10:47 AM, Michael Kerrisk (man-pages) wrote: > > On 05/14/2015 07:30 PM, Andrea Arcangeli wrote: > >> Add documentation. > > > > Hi Andrea, > > > > I do not recall... Did you write a man page also for this new system call? > > No response to my last mail, so I'll try again... Did you > write any man page for this interface? I wished I would answer with the manpage itself to give a more satisfactory answer, but answer is still no at this time. Right now there's the write protection tracking feature posted to linux-mm and I'm currently reviewing that. It's worth documenting that part too in the manpage as it's going to happen sooner than later. Lack of manpage so far didn't prevent userland to use it (qemu postcopy is already in upstream qemu and it depends on userfaultfd), nor review of the code nor other kernel contributors to extend the syscall API. Other users started testing the syscall too. This is just to explain why unfortunately the manpage didn't get the top priority yet, but nevertheless the manpage should happen too and it's important. Advice on how to proceed is welcome. Thanks, Andrea -- To unsubscribe, send a message with 'unsubscribe linux-mm' in the body to majordomo@kvack.org. For more info on Linux MM, see: http://www.linux-mm.org/ . Don't email: email@kvack.org From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753727AbbLDRzK (ORCPT ); Fri, 4 Dec 2015 12:55:10 -0500 Received: from mx1.redhat.com ([209.132.183.28]:49969 "EHLO mx1.redhat.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752359AbbLDRzH (ORCPT ); Fri, 4 Dec 2015 12:55:07 -0500 Date: Fri, 4 Dec 2015 18:55:03 +0100 From: Andrea Arcangeli To: "Michael Kerrisk (man-pages)" Cc: Andrew Morton , linux-kernel@vger.kernel.org, linux-mm@kvack.org, qemu-devel@nongnu.org, kvm@vger.kernel.org, linux-api@vger.kernel.org, Pavel Emelyanov , Sanidhya Kashyap , zhang.zhanghailiang@huawei.com, Linus Torvalds , "Kirill A. Shutemov" , Andres Lagar-Cavilla , Dave Hansen , Paolo Bonzini , Rik van Riel , Mel Gorman , Andy Lutomirski , Hugh Dickins , Peter Feiner , "Dr. David Alan Gilbert" , Johannes Weiner , "Huangpeng (Peter)" Subject: Re: [PATCH 01/23] userfaultfd: linux/Documentation/vm/userfaultfd.txt Message-ID: <20151204175503.GZ29105@redhat.com> References: <1431624680-20153-1-git-send-email-aarcange@redhat.com> <1431624680-20153-2-git-send-email-aarcange@redhat.com> <55F29513.4030503@gmail.com> <5661B62B.2020409@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <5661B62B.2020409@gmail.com> User-Agent: Mutt/1.5.24 (2015-08-30) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hello Michael, On Fri, Dec 04, 2015 at 04:50:03PM +0100, Michael Kerrisk (man-pages) wrote: > Hi Andrea, > > On 09/11/2015 10:47 AM, Michael Kerrisk (man-pages) wrote: > > On 05/14/2015 07:30 PM, Andrea Arcangeli wrote: > >> Add documentation. > > > > Hi Andrea, > > > > I do not recall... Did you write a man page also for this new system call? > > No response to my last mail, so I'll try again... Did you > write any man page for this interface? I wished I would answer with the manpage itself to give a more satisfactory answer, but answer is still no at this time. Right now there's the write protection tracking feature posted to linux-mm and I'm currently reviewing that. It's worth documenting that part too in the manpage as it's going to happen sooner than later. Lack of manpage so far didn't prevent userland to use it (qemu postcopy is already in upstream qemu and it depends on userfaultfd), nor review of the code nor other kernel contributors to extend the syscall API. Other users started testing the syscall too. This is just to explain why unfortunately the manpage didn't get the top priority yet, but nevertheless the manpage should happen too and it's important. Advice on how to proceed is welcome. Thanks, Andrea From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:36054) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a4uZd-0007vF-Cy for qemu-devel@nongnu.org; Fri, 04 Dec 2015 12:55:14 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1a4uZY-0000UE-DB for qemu-devel@nongnu.org; Fri, 04 Dec 2015 12:55:13 -0500 Received: from mx1.redhat.com ([209.132.183.28]:55353) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1a4uZY-0000Th-8n for qemu-devel@nongnu.org; Fri, 04 Dec 2015 12:55:08 -0500 Date: Fri, 4 Dec 2015 18:55:03 +0100 From: Andrea Arcangeli Message-ID: <20151204175503.GZ29105@redhat.com> References: <1431624680-20153-1-git-send-email-aarcange@redhat.com> <1431624680-20153-2-git-send-email-aarcange@redhat.com> <55F29513.4030503@gmail.com> <5661B62B.2020409@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <5661B62B.2020409@gmail.com> Subject: Re: [Qemu-devel] [PATCH 01/23] userfaultfd: linux/Documentation/vm/userfaultfd.txt List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: "Michael Kerrisk (man-pages)" Cc: kvm@vger.kernel.org, qemu-devel@nongnu.org, Sanidhya Kashyap , Dave Hansen , zhang.zhanghailiang@huawei.com, Pavel Emelyanov , Hugh Dickins , Mel Gorman , "Huangpeng (Peter)" , "Dr. David Alan Gilbert" , Andres Lagar-Cavilla , "Kirill A. Shutemov" , linux-mm@kvack.org, linux-api@vger.kernel.org, linux-kernel@vger.kernel.org, Andy Lutomirski , Johannes Weiner , Paolo Bonzini , Andrew Morton , Linus Torvalds , Peter Feiner Hello Michael, On Fri, Dec 04, 2015 at 04:50:03PM +0100, Michael Kerrisk (man-pages) wrote: > Hi Andrea, > > On 09/11/2015 10:47 AM, Michael Kerrisk (man-pages) wrote: > > On 05/14/2015 07:30 PM, Andrea Arcangeli wrote: > >> Add documentation. > > > > Hi Andrea, > > > > I do not recall... Did you write a man page also for this new system call? > > No response to my last mail, so I'll try again... Did you > write any man page for this interface? I wished I would answer with the manpage itself to give a more satisfactory answer, but answer is still no at this time. Right now there's the write protection tracking feature posted to linux-mm and I'm currently reviewing that. It's worth documenting that part too in the manpage as it's going to happen sooner than later. Lack of manpage so far didn't prevent userland to use it (qemu postcopy is already in upstream qemu and it depends on userfaultfd), nor review of the code nor other kernel contributors to extend the syscall API. Other users started testing the syscall too. This is just to explain why unfortunately the manpage didn't get the top priority yet, but nevertheless the manpage should happen too and it's important. Advice on how to proceed is welcome. Thanks, Andrea