From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-7.2 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,MENTIONS_GIT_HOSTING,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED, USER_AGENT_SANE_1 autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 4DD99CA9EC4 for ; Tue, 29 Oct 2019 11:27:12 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 2D26F20663 for ; Tue, 29 Oct 2019 11:27:12 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728343AbfJ2L1L (ORCPT ); Tue, 29 Oct 2019 07:27:11 -0400 Received: from youngberry.canonical.com ([91.189.89.112]:37084 "EHLO youngberry.canonical.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725839AbfJ2L1K (ORCPT ); Tue, 29 Oct 2019 07:27:10 -0400 Received: from [91.217.168.176] (helo=wittgenstein) by youngberry.canonical.com with esmtpsa (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.86_2) (envelope-from ) id 1iPPeW-0005r1-8D; Tue, 29 Oct 2019 11:27:08 +0000 Date: Tue, 29 Oct 2019 12:27:07 +0100 From: Christian Brauner To: Jann Horn Cc: Michael Kerrisk-manpages , lkml , linux-man , Kees Cook , Florian Weimer , Oleg Nesterov , Arnd Bergmann , David Howells , Pavel Emelyanov , Andrew Morton , Adrian Reber , Andrei Vagin , Linux API Subject: Re: For review: documentation of clone3() system call Message-ID: <20191029112706.p5dd5yzpcgouo6n5@wittgenstein> References: <20191028172143.4vnnjpdljfnexaq5@wittgenstein> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: User-Agent: NeoMutt/20180716 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, Oct 28, 2019 at 08:09:13PM +0100, Jann Horn wrote: > On Mon, Oct 28, 2019 at 6:21 PM Christian Brauner > wrote: > > On Mon, Oct 28, 2019 at 04:12:09PM +0100, Jann Horn wrote: > > > On Fri, Oct 25, 2019 at 6:59 PM Michael Kerrisk (man-pages) > > > wrote: > > > > I've made a first shot at adding documentation for clone3(). You can > > > > see the diff here: > > > > https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/commit/?id=faa0e55ae9e490d71c826546bbdef954a1800969 > [...] > > > You might want to note somewhere that its flags can't be > > > seccomp-filtered because they're stored in memory, making it > > > inappropriate to use in heavily sandboxed processes. > > > > Hm, I don't think that belongs on the clone manpage. Granted that > > process creation is an important syscall but so are a bunch of others > > that aren't filterable because of pointer arguments. > > We can probably mention on the seccomp manpage that seccomp can't filter > > on pointer arguments and then provide a list of examples. If you setup a > > seccomp filter and don't know that you can't filter syscalls with > > pointer args that seems pretty bad to begin with. > > Fair enough. > > [...] > > One thing I never liked about clone() was that userspace had to know > > about stack direction. And there is a lot of ugly code in userspace that > > has nasty clone() wrappers like: > [...] > > where stack + stack_size is addition on a void pointer which usually > > clang and gcc are not very happy about. > > I wanted to bring this up on the mailing list soon: If possible, I don't > > want userspace to need to know about stack direction and just have stack > > point to the beginning and then have the kernel do the + stack_size > > after the copy_clone_args_from_user() if the arch needs it. For example, > > by having a dumb helder similar to copy_thread_tls()/coyp_thread() that > > either does the + stack_size or not. Right now, clone3() is supported on > > parisc and afaict, the stack grows upwards for it. I'm not sure if there > > are obvious reasons why that won't work or it would be a bad idea... > > That would mean adding a new clone flag that redefines how those > parameters work and describing the current behavior in the manpage as > the behavior without the flag (which doesn't exist on 5.3), right? I would break API and if someone reports breakage we'll revert and go the more complicated route you outlined (see [1]). But I don't think it will a big deal. First, we haven't documented how stack needs to be passed so who knows what people currently do. Second, clone3() has not been out for a long time and currently does _not_ provide features that legacy clone() does not provide apart from a cleaner interface. So userspace has no incentive to use clone3() over clone() right now. That'll change latest with v5.5 where we have new features on top of clone3() (CLONE_CLEAR_SIGHAND). So let's just try and fix it. [1]: This is basically what Linus has repeatedly said: it's not about never breaking api in principle but rather about whether this breaks someones usecase. And if it does break, we need to revert. Christian