From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <alexei.starovoitov@gmail.com>
Received: from mail-lj1-x236.google.com (mail-lj1-x236.google.com
 [IPv6:2a00:1450:4864:20::236])
 by sourceware.org (Postfix) with ESMTPS id 28C38385E017
 for <libc-alpha@sourceware.org>; Tue,  4 May 2021 21:23:49 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 28C38385E017
Received: by mail-lj1-x236.google.com with SMTP id u25so13003548ljg.7
 for <libc-alpha@sourceware.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=QVzM8qip7vN4+RrB4+Em0v/5LT3F+ihgovRmwFoNMf2H1MaZJkojxFtJU83M8pr0vY
 wJiRMX1dlBOHAbWcNVJZPIH3PUxpnqvfGb3ciJxhk1N2LsTr/3uFBYdHd7IwDPIshJXw
 g2kYlUKvRX1GONcs42L75PT9hArJ+T+5otRkwaQnXmWNRmyCq33hqtPFxtrT8BYX4isr
 JjCcgfrKG6vOPDtyy9Ck+jjHwGyAEFsiinwcmVe1wqUEZnNi/p0e4InukTAq4hJWu9Ul
 /BTvoA5fME8aO/dmktOkyDx333unyks+Fqfn51QluyYI1IoZQhctuVYyXaIqBEDbCsmn
 14Mw==
X-Gm-Message-State: AOAM530wc4vzH9emcHBzY5C4pu6wmse3rP5bSlJD0lEPp6RjW4BN/JNH
 k0t6sRBnqhhK2ftMYIYa4DlzDuVU1dzGUk5Bzto=
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.2 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=ham autolearn_force=no version=3.4.2
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on
 server2.sourceware.org
X-BeenThere: libc-alpha@sourceware.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Libc-alpha mailing list <libc-alpha.sourceware.org>
List-Unsubscribe: <https://sourceware.org/mailman/options/libc-alpha>,
 <mailto:libc-alpha-request@sourceware.org?subject=unsubscribe>
List-Archive: <https://sourceware.org/pipermail/libc-alpha/>
List-Post: <mailto:libc-alpha@sourceware.org>
List-Help: <mailto:libc-alpha-request@sourceware.org?subject=help>
List-Subscribe: <https://sourceware.org/mailman/listinfo/libc-alpha>,
 <mailto:libc-alpha-request@sourceware.org?subject=subscribe>
X-List-Received-Date: Tue, 04 May 2021 21:23:50 -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.