linux_dsm_epyc7002/Documentation/bpf
Jesper Dangaard Brouer 1a6ac1d59d bpf, doc: convert bpf_design_QA.rst to use RST formatting
The RST formatting is done such that that when rendered or converted
to different formats, an automatic index with links are created to the
subsections.

Thus, the questions are created as sections (or subsections), in-order
to get the wanted auto-generated FAQ/QA index.

Special thanks to Quentin Monnet <quentin.monnet@netronome.com> who
have reviewed and corrected both RST formatting and GitHub rendering
issues in this file.  Those commits have been squashed.

I've manually tested that this also renders nicely if included as part
of the kernel 'make htmldocs'.  As the end-goal is for this to become
more integrated with kernel-doc project/movement.

Signed-off-by: Jesper Dangaard Brouer <brouer@redhat.com>
Signed-off-by: Alexei Starovoitov <ast@kernel.org>
2018-05-14 23:02:58 -07:00
..
bpf_design_QA.rst bpf, doc: convert bpf_design_QA.rst to use RST formatting 2018-05-14 23:02:58 -07:00
bpf_devel_QA.rst bpf, doc: rename txt files to rst files 2018-05-14 23:02:58 -07:00
README.rst bpf, doc: rename txt files to rst files 2018-05-14 23:02:58 -07:00

=================
BPF documentation
=================

This directory contains documentation for the BPF (Berkeley Packet
Filter) facility, with a focus on the extended BPF version (eBPF).

This kernel side documentation is still work in progress.  The main
textual documentation is (for historical reasons) described in
`Documentation/networking/filter.txt`_, which describe both classical
and extended BPF instruction-set.
The Cilium project also maintains a `BPF and XDP Reference Guide`_
that goes into great technical depth about the BPF Architecture.

The primary info for the bpf syscall is available in the `man-pages`_
for `bpf(2)`_.



Frequently asked questions (FAQ)
================================

Two sets of Questions and Answers (Q&A) are maintained.

* QA for common questions about BPF see: bpf_design_QA_

* QA for developers interacting with BPF subsystem: bpf_devel_QA_


.. Links:
.. _bpf_design_QA: bpf_design_QA.rst
.. _bpf_devel_QA:  bpf_devel_QA.rst
.. _Documentation/networking/filter.txt: ../networking/filter.txt
.. _man-pages: https://www.kernel.org/doc/man-pages/
.. _bpf(2): http://man7.org/linux/man-pages/man2/bpf.2.html
.. _BPF and XDP Reference Guide: http://cilium.readthedocs.io/en/latest/bpf/