1. Feb 08, 2023
  2. Feb 07, 2023
  3. Feb 04, 2023
    • Florian Lehner's avatar
      bpf: fix typo in header for bpf_perf_prog_read_value · 17c9b4e1
      Florian Lehner authored
      
      
      Fix a simple typo in the documentation for bpf_perf_prog_read_value.
      
      Signed-off-by: default avatarFlorian Lehner <dev@der-flo.net>
      Acked-by: default avatarJohn Fastabend <john.fastabend@gmail.com>
      Link: https://lore.kernel.org/r/20230203121439.25884-1-dev@der-flo.net
      
      
      Signed-off-by: default avatarMartin KaFai Lau <martin.lau@kernel.org>
      17c9b4e1
    • David Vernet's avatar
      bpf/docs: Document kfunc lifecycle / stability expectations · 16c294a6
      David Vernet authored
      
      
      BPF kernel <-> kernel API stability has been discussed at length over
      the last several weeks and months. Now that we've largely aligned over
      kfuncs being the way forward, and BPF helpers being considered
      functionally frozen, it's time to document the expectations for kfunc
      lifecycles and stability so that everyone (BPF users, kfunc developers,
      and maintainers) are all aligned, and have a crystal-clear understanding
      of the expectations surrounding kfuncs.
      
      To do that, this patch adds that documentation to the main kfuncs
      documentation page via a new 'kfunc lifecycle expectations' section. The
      patch describes how decisions are made in the kernel regarding whether
      to include, keep, deprecate, or change / remove a kfunc. As described
      very overtly in the patch itself, but likely worth highlighting here:
      
      "kfunc stability" does not mean, nor ever will mean, "BPF APIs may block
      development elsewhere in the kernel".
      
      Rather, the intention and expectation is for kfuncs to be treated like
      EXPORT_SYMBOL_GPL symbols in the kernel. The goal is for kfuncs to be a
      safe and valuable option for maintainers and kfunc developers to extend
      the kernel, without tying anyone's hands, or imposing any kind of
      restrictions on maintainers in the same way that UAPI changes do.
      
      In addition to the 'kfunc lifecycle expectations' section, this patch
      also adds documentation for a new KF_DEPRECATED kfunc flag which kfunc
      authors or maintainers can choose to add to kfuncs if and when they
      decide to deprecate them. Note that as described in the patch itself, a
      kfunc need not be deprecated before being changed or removed -- this
      flag is simply provided as an available deprecation mechanism for those
      that want to provide a deprecation story / timeline to their users.
      When necessary, kfuncs may be changed or removed to accommodate changes
      elsewhere in the kernel without any deprecation at all.
      
      Reviewed-by: default avatarBagas Sanjaya <bagasdotme@gmail.com>
      Co-developed-by: default avatarToke Høiland-Jørgensen <toke@redhat.com>
      Signed-off-by: default avatarDavid Vernet <void@manifault.com>
      Link: https://lore.kernel.org/r/20230203155727.793518-2-void@manifault.com
      
      
      Signed-off-by: default avatarAlexei Starovoitov <ast@kernel.org>
      16c294a6
  4. Feb 03, 2023
  5. Feb 02, 2023