Received: by 2002:a05:6a10:a852:0:0:0:0 with SMTP id d18csp4032059pxy; Tue, 4 May 2021 16:12:03 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz7uJvHaS726LrJXkGwMs6dF+GQMQNkOqlD3pGFEcyoZa0dbCLLkM0h++hKadKTvmTvDLLv X-Received: by 2002:a17:906:2287:: with SMTP id p7mr24044089eja.377.1620169923700; Tue, 04 May 2021 16:12:03 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1620169923; cv=none; d=google.com; s=arc-20160816; b=lxXciOi+6N421i5AgCb7Lh0lbtC0xvhpPCvCycVoQ8YvI3co2CqpMoX84gDSFJiWig Zj1NftQecHjy3AR5cA1YAYAxZ/K7xtxV5HttvCBogI789uiJE2rjIbbmgUit3/J3JuAI CrKsyXWZZvUPvTJiWi7b/m12hx7M6l0oE1HuPd8ILajL7s8CHBGdoPI2BvCVPyBqR3vm Jnpb8RzwAy3OE+yO9LT39EqtGxZqgQE03Jjvwk/HNZAWt/Ev6W9XvlfWrlpaCtc5ile5 osceUsfcMzxAdeAIcAsTMRF18O0s1am9cSyHT64NV4STl5HmdURHKb6Sx9Z7jDoZz84u maEg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:dkim-signature; bh=t8wotz3AhGgeTQp5SZs5xSv5MZsNA5QgTSconl9j5TM=; b=kQ4uzu+bqynLwMb904e2dIy/tsd/1m6Puv/Aaj4Hc/vdiHR761myx8/QwmrAdRrL07 RMxkVNLQS0mkZs5UPAn/3D3Z87GYx7vfYOYoQbgLuuGgsdb1WYXKMlx30+tTNKFFA+nj vaImRg8RkA0IZ2RQcWZtU3CpG6nxkl2f3kgz2h4HYhXoQtVEXbtFpMnGbZhbqSxuUfd2 b6pLE7vWArHdz603CENPBjLl2mJ+ttl4gcMgN6GYxUkVBvZ4YgDjqtwDsY3FoRnQ5QdK vUz+skG37/N8pdr87Z4vxZccb+rIFJkKP3ZarRVl6+reHRAjQIjr2+oH/v3U1YtLrQAe jgWw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=bu10H0MI; 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=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id jl17si3992175ejc.327.2021.05.04.16.11.36; Tue, 04 May 2021 16:12:03 -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=@gmail.com header.s=20161025 header.b=bu10H0MI; 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=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232885AbhEDVYp (ORCPT + 99 others); Tue, 4 May 2021 17:24:45 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:38358 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232782AbhEDVYp (ORCPT ); Tue, 4 May 2021 17:24:45 -0400 Received: from mail-lj1-x234.google.com (mail-lj1-x234.google.com [IPv6:2a00:1450:4864:20::234]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 77D59C061574; Tue, 4 May 2021 14:23:49 -0700 (PDT) Received: by mail-lj1-x234.google.com with SMTP id b7so9194869ljr.4; Tue, 04 May 2021 14:23:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=t8wotz3AhGgeTQp5SZs5xSv5MZsNA5QgTSconl9j5TM=; b=bu10H0MIFzOEkwtjWen71MackfzXsnWN6MZXNRc/W/GcLULK6ZhoaOh5oaLH+41zu+ VwdEsKswhub4hu2UYG4wp+ZpuOwqPyZHoR+k5bCwf7o4/3rkUu3LE21z8mEsrL3JiKPa Zdx7srKYQ8Gp5kF5UUIfL63XhseNUY+E+okCJGV6LuiwOfp5gx8wL0Vb1aI/c1hJQDU7 mOoMesB+BBckt+Q944oLu3rDaKRXF6+mCis9CzbXFkKRmMWwFjE7jW7VEov5fl2cNb5C mO8H2pbIidyO9uUYH76fmbw+M7Ltzq61yV1uy9yKh6foDNMy+xAsFdNJvcbMujalmED1 Y6Ww== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=t8wotz3AhGgeTQp5SZs5xSv5MZsNA5QgTSconl9j5TM=; b=id4mH/sXdi0P2A+ine7yjfA738Mip2fxCP0OvqMTOjHvAZOWs/EC4oVjuVMQac+Guk IlZSt4JiwYnUG8EFI+/Y+EPJ72W3TWzqE1ZT9LpYTYRpIzDC+k8L3pfTJQW+z7hfjHn1 EKIv4xkj5AnXYgEKrfX1JNG+HtusobpDNb5FJ1FiOULeIvI7fz3nFmV0BLjWg5MqqR6z uuwC+2jycU6MVMoKJ+G0A0cVUF8LqHkaeiMmL454PW28h8XMQAzIH5aFfvVZ3VHpldWm zQPyMOE5l9IaBeBMKK4KanFr9cfS/HKNCA8JiXn4AYc+SGYamZDA7uZqZHqDPHKMowm7 QMqg== X-Gm-Message-State: AOAM532iHk5osvImHe66FrJoaE4WmwldgNLj4T/qFSRXWzhwjKJbrxDn suYr7qNepKNoA3IkmdrRZLeBsJO0PpMcfViNptY= X-Received: by 2002:a2e:a489:: with SMTP id h9mr8855179lji.21.1620163428021; Tue, 04 May 2021 14:23:48 -0700 (PDT) MIME-Version: 1.0 References: <20210423230609.13519-1-alx.manpages@gmail.com> <20210504110519.16097-1-alx.manpages@gmail.com> <69fb22e0-84bd-47fb-35b5-537a7d39c692@gmail.com> <6740a229-842e-b368-86eb-defc786b3658@gmail.com> <8a184afe-14b7-ed15-eb6a-960ea05251d1@iogearbox.net> In-Reply-To: From: Alexei Starovoitov Date: Tue, 4 May 2021 14:23:36 -0700 Message-ID: Subject: Re: [RFC v2] bpf.2: Use standard types and attributes To: Zack Weinberg Cc: Daniel Borkmann , "Alejandro Colomar (man-pages)" , Greg KH , "Michael Kerrisk (man-pages)" , linux-man , LKML , glibc , GCC , bpf , Joseph Myers , David Laight , David Miller Content-Type: text/plain; charset="UTF-8" Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, May 4, 2021 at 1:33 PM Zack Weinberg wrote: > the information that should > appear in the manpages is the information that is most relevant to > user space programmers. The bpf programs are compiled for the kernel and run in the kernel. Hence bpf man pages must reflect the kernel. Also there is BTF where type names are part of the verification process. if a user decides to rename a type it will be rejected by the kernel verifier.