Extend the libbpf documentation with a table of program types, attach points and ELF section names. The table uses data from program_types.csv which is generated from tools/lib/bpf/libbpf.c during the documentation build. Patch 1 adds subdir support to Documentation/Makefile and changes userspace-api/media to use this instead of being a special case. Patch 2 adds the program_types documentation with a new makefile in the libbpf doc directory to generate program_types.csv, using scripts/gen-bpf-progtypes.sh The generator is now in scripts/gen-bpf-progtypes.sh so that it can be exported to the libbpf git repository along with the libbpf docs. The libbpf repository will need to be updated to sync and use scripts/gen-btf-progtypes.sh after this patch lands. I plan to look at adding info about the format of section "extras" for each program type as a follow-on. v3 -> v4: Fix typo reported by Jesper Brouer Move the generator from the Makefile to a separate script v2 -> v3: Put program_types after API docs in TOC as suggested by Andrii Nakryiko Fix formatting as reported by Andrii Nakryiko Include USDT extras example as suggested by Andrii Nakryiko Include sample of program_types.csv as suggested by Andrii Nakryiko v1 -> v2: Automate the generation of program_types.csv as suggested by Andrii Nakryiko. Donald Hunter (2): Add subdir support to Documentation makefile Add table of BPF program types to libbpf docs Documentation/Makefile | 16 ++++++++-- Documentation/bpf/libbpf/.gitignore | 1 + Documentation/bpf/libbpf/Makefile | 29 ++++++++++++++++++ Documentation/bpf/libbpf/index.rst | 3 ++ Documentation/bpf/libbpf/program_types.rst | 32 ++++++++++++++++++++ Documentation/bpf/programs.rst | 3 ++ Documentation/userspace-api/media/Makefile | 2 ++ scripts/gen-bpf-progtypes.sh | 34 ++++++++++++++++++++++ 8 files changed, 118 insertions(+), 2 deletions(-) create mode 100644 Documentation/bpf/libbpf/.gitignore create mode 100644 Documentation/bpf/libbpf/Makefile create mode 100644 Documentation/bpf/libbpf/program_types.rst create mode 100755 scripts/gen-bpf-progtypes.sh -- 2.35.1
