From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <alexei.starovoitov@gmail.com>
Received: from mail-lj1-x229.google.com (mail-lj1-x229.google.com
 [IPv6:2a00:1450:4864:20::229])
 by sourceware.org (Postfix) with ESMTPS id A77373848419
 for <gcc-patches@gcc.gnu.org>; Tue,  4 May 2021 21:23:49 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org A77373848419
Received: by mail-lj1-x229.google.com with SMTP id p12so13022654ljg.1
 for <gcc-patches@gcc.gnu.org>; Tue, 04 May 2021 14:23:49 -0700 (PDT)
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=Tf1AjLzPagrb5nHn7BJ0HY4VTwSOX0FF3w5LOvC/fglJdOoD0xSZnE/G6tBeCozNKU
 8786h7qWHuS9elPQJu+GtTWUm6XObZgk9jxW3Y94zZjMnWm3qHqyCU2/sE9EG02CMBQq
 PVXsjMTyL1Ema9d6H4PGwRwt8OwqOLZ/iyZXjEKHusB3ZDz3dDxVcWIYp/vD7U0Iq7Ki
 va8IUV2IG/8nwuDYOxMEWcWgVMqcFd2v/E7tptKMo2g0A/DWYaVgzW9zBEBTk1SaoD7R
 eUnKAb787vvruQuVaCc+Cs/WYL13w4ZJ5IZrWzQXR48FjDczc4IUutHaZgvZWN2Twx9e
 ZRZw==
X-Gm-Message-State: AOAM533qpeiOCLnsX9JAUAjDzlqzMaGC9IUtkw/PfqiYzYv8mAre/Pqy
 PCefqhqFD2rRu6BEKyzgG0hDum8U7bbTPgxgfxk=
X-Google-Smtp-Source: ABdhPJxNURHBTrrBxV0JDij/y6syf0fcI1QGRqpV/yO5lQyEdW71DJjeS5K7n35sHBs2PkzJqrKd5X+lXQYlbWyXvpc=
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>
 <CAADnVQLdW=jH1CUP02jokEu3Sh+=xKsCXvjA19kfz7KOn9mzkA@mail.gmail.com>
 <YJFZHW2afbAMVOmE@kroah.com> <69fb22e0-84bd-47fb-35b5-537a7d39c692@gmail.com>
 <YJFxArfp8wN3ILJb@kroah.com>
 <CAKCAbMg_eRCsD-HYmryL8XEuZcaM1Qdfp4XD85QKT6To+h3QcQ@mail.gmail.com>
 <6740a229-842e-b368-86eb-defc786b3658@gmail.com>
 <8a184afe-14b7-ed15-eb6a-960ea05251d1@iogearbox.net>
 <CAKCAbMidJ=UhsMumDcwiqvkGEG5SROPnv=OA379w_=0dZk5W5g@mail.gmail.com>
In-Reply-To: <CAKCAbMidJ=UhsMumDcwiqvkGEG5SROPnv=OA379w_=0dZk5W5g@mail.gmail.com>
From: Alexei Starovoitov <alexei.starovoitov@gmail.com>
Date: Tue, 4 May 2021 14:23:36 -0700
Message-ID: <CAADnVQ+bPMsfva8YyAfvmXATDcykSkznskEtQueu=GKhOnYeZQ@mail.gmail.com>
Subject: Re: [RFC v2] bpf.2: Use standard types and attributes
To: Zack Weinberg <zackw@panix.com>
Cc: Daniel Borkmann <daniel@iogearbox.net>, 
 "Alejandro Colomar (man-pages)" <alx.manpages@gmail.com>,
 Greg KH <gregkh@linuxfoundation.org>, 
 "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com>,
 linux-man <linux-man@vger.kernel.org>, 
 LKML <linux-kernel@vger.kernel.org>, glibc <libc-alpha@sourceware.org>, 
 GCC <gcc-patches@gcc.gnu.org>, bpf <bpf@vger.kernel.org>, 
 Joseph Myers <joseph@codesourcery.com>, David Laight <David.Laight@aculab.com>,
 David Miller <davem@davemloft.net>
Content-Type: text/plain; charset="UTF-8"
X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00, DKIM_SIGNED,
 DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, FREEMAIL_FROM, RCVD_IN_DNSWL_NONE,
 SPF_HELO_NONE, SPF_PASS,
 TXREP autolearn=unavailable autolearn_force=no version=3.4.2
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on
 server2.sourceware.org
X-BeenThere: gcc-patches@gcc.gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Gcc-patches mailing list <gcc-patches.gcc.gnu.org>
List-Unsubscribe: <https://gcc.gnu.org/mailman/options/gcc-patches>,
 <mailto:gcc-patches-request@gcc.gnu.org?subject=unsubscribe>
List-Archive: <https://gcc.gnu.org/pipermail/gcc-patches/>
List-Post: <mailto:gcc-patches@gcc.gnu.org>
List-Help: <mailto:gcc-patches-request@gcc.gnu.org?subject=help>
List-Subscribe: <https://gcc.gnu.org/mailman/listinfo/gcc-patches>,
 <mailto:gcc-patches-request@gcc.gnu.org?subject=subscribe>
X-List-Received-Date: Tue, 04 May 2021 21:23:51 -0000

On Tue, May 4, 2021 at 1:33 PM Zack Weinberg <zackw@panix.com> 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.