Skip to content

Latest commit

 

History

History

src

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
pcp
pcp
 
 
.gitignore
.gitignore
 
 
Makefile
Makefile
 
 
README.md
README.md
 
 
bpftune.c
bpftune.c
 
 
bpftune.service
bpftune.service
 
 
buffer_sizing.md
buffer_sizing.md
 
 
ip_frag_tuner.bpf.c
ip_frag_tuner.bpf.c
 
 
ip_frag_tuner.c
ip_frag_tuner.c
 
 
ip_frag_tuner.h
ip_frag_tuner.h
 
 
libbpftune.c
libbpftune.c
 
 
libbpftune.map
libbpftune.map
 
 
neigh_table_tuner.bpf.c
neigh_table_tuner.bpf.c
 
 
neigh_table_tuner.c
neigh_table_tuner.c
 
 
neigh_table_tuner.h
neigh_table_tuner.h
 
 
net_buffer_tuner.bpf.c
net_buffer_tuner.bpf.c
 
 
net_buffer_tuner.c
net_buffer_tuner.c
 
 
net_buffer_tuner.h
net_buffer_tuner.h
 
 
netns_tuner.bpf.c
netns_tuner.bpf.c
 
 
netns_tuner.c
netns_tuner.c
 
 
netns_tuner.h
netns_tuner.h
 
 
probe.bpf.c
probe.bpf.c
 
 
route_table_tuner.bpf.c
route_table_tuner.bpf.c
 
 
route_table_tuner.c
route_table_tuner.c
 
 
route_table_tuner.h
route_table_tuner.h
 
 
sysctl_tuner.bpf.c
sysctl_tuner.bpf.c
 
 
sysctl_tuner.c
sysctl_tuner.c
 
 
tcp_buffer_tuner.bpf.c
tcp_buffer_tuner.bpf.c
 
 
tcp_buffer_tuner.c
tcp_buffer_tuner.c
 
 
tcp_buffer_tuner.h
tcp_buffer_tuner.h
 
 
tcp_conn_tuner.bpf.c
tcp_conn_tuner.bpf.c
 
 
tcp_conn_tuner.c
tcp_conn_tuner.c
 
 
tcp_conn_tuner.h
tcp_conn_tuner.h
 
 
udp_buffer_tuner.bpf.c
udp_buffer_tuner.bpf.c
 
 
udp_buffer_tuner.c
udp_buffer_tuner.c
 
 
udp_buffer_tuner.h
udp_buffer_tuner.h
 
 

README.md

Adding new tuners

  1. Create
    • tuner_name_tuner.bpf.c containing BPF programs. It must
#include "bpftune.bpf.h"
  • tuner_name_tuner.c containing init, fini and event handler. It must
#include <libbpftune.h>
  • tuner_name_tuner.h containing common definitions for bpf/userspace; examples of these are enumerated values covering tunable and scenario ids (see tcp_buffer_tuner.h for examples).

Ensure that LOG_INFO events are logged when tunable updates are made; this allows the admin to understand what changes were made and motivations for doing so. bpftuner_tunable_sysctl_write() can be used as a wrapper for sysctl changes which takes care of logging (additional reasons can be supplied) and bpftuner_tunable_update() can be used for other cases (see cong_tuner.c for example).

  1. Add tuner_name to TUNERS in Makefile so it will be built.

  2. Add bpftune-tuner-name.rst to docs and add tuner-name to TUNERS in Makefile there also.

Example

neigh_table_tuner.bpf.c monitors neighbour table updates, and when the neighbour table is approaching garbage collection limits, those limits are raised. It consists of

  • src/neigh_table_tuner.bpf.c
  • src/neigh_table_tuner.c
  • src/neigh_table_tuner.h
  • docs/bpftune-neigh.rst

We see that ringbuf messages are sent from the BPF program when the neighbour table approaches being full, and these are handled in the event_handler function.