eBPF확장 버클리 패킷 필터 · extended Berkeley Packet Filter
사용자가 만든 작은 프로그램을 검증기로 안전을 확인한 뒤 커널 안 사건 지점(시스템 호출 · 함수 진입 · 패킷 수신)에 붙여 실행하는 리눅스 커널의 실행 환경이다. 커널 소스를 고치거나 모듈을 넣지 않고 관측 · 네트워크 처리 · 보안 정책을 더한다.
1요약
- eBPF 는 리눅스 3.18(2014)의 bpf() 시스템 호출로 들어온 커널 안 실행 환경으로, 그 위에서 패킷 필터 · 성능 추적 도구 · 컨테이너 네트워크 · 보안 감사 프로그램이 돈다(bpf(2) · 명령 형식 = RFC 9669).
- 커널 경로를 보려고 모듈을 넣으면 잘못된 포인터 하나가 커널 전체를 멈추고, 모든 사건을 사용자 공간으로 복사하면 비용이 커진다 — 커널 안에서 먼저 거르는 1993년 BPF 는 같은 장비에서 Sun NIT 보다 최대 100배 빨랐다(McCanne 1993).
- 「eBPF 가 안 된다」는 어느 단계에서 멈췄는가로 가른다 — 적재가 거부되면 검증기, 적재됐는데 횟수가 0이면 부착 지점, 횟수는 느는데 결과가 비면 맵 읽기 쪽이다.
2등장 배경
감시 도구는 사용자 공간에서 돌므로 패킷이 커널 · 사용자 경계를 넘어 복사되고, 1980년 CMU · Stanford 의 CSPF 는 이를 줄이려 커널 안 필터를 두었지만 스택 기반 평가기라 RISC CPU 에서 느렸다. 1992년 12월 McCanne · Jacobson 은 레지스터 기반 평가기의 BSD Packet Filter(BPF)로 같은 장비에서 CSPF 보다 1.5 ~ 20배 빠른 결과를 냈다(McCanne 1993). 이 방식(classic BPF)은 레지스터 둘(A · X)의 32비트 기계로 tcpdump 필터에 쓰였다(classic vs eBPF 문서).
2014년 리눅스 3.18 이 레지스터를 64비트 11개로 늘리고 맵 · 헬퍼 호출을 더한 eBPF 를 bpf() 로 열었다. 3.19 에서 소켓, 4.1 에서 kprobe 에 붙었고(bpf(2)), classic BPF 필터도 커널 안에서는 eBPF 로 바뀌어 돈다. 2024년 10월 RFC 9669 가 명령 형식을 IETF 표준으로 정해, 리눅스 밖 구현도 같은 바이트코드를 읽는 기준이 생겼다.
3쉽게 이해하기 — 생산 라인에 계수기를 다는 공장
공장 생산 라인은 멈추면 안 되는데, 품질 담당이 라인의 한 지점을 지나는 물건 수를 세고 싶다. 담당은 계수기 설계도를 내고, 공장 안전 관리자는 설계도가 끝없이 돌거나 라인 부품을 건드리지 않는지 따져 본 뒤에야 승인한다. 정비공이 승인된 계수기를 라인 규격에 맞게 조립해 정해진 고리에 달면, 계수기는 물건이 지날 때마다 사물함 장부에 숫자를 적고 담당은 사무실에서 장부만 읽는다.
그림 1 · 설계도는 안전 관리자의 승인을 받아야 라인에 붙고, 계수기는 라인을 멈추지 않은 채 사물함에 숫자를 쌓으며 사무실은 그 숫자만 읽는다.
그림 2 · 물건을 모두 사무실로 실어 나르지 않고 라인 옆에서 센다 — 실제로는 사건 2,000건을 복사하는 대신 맵 항목 넷만 읽는다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 품질 담당 | 로더(libbpf · bpftool) | 객체 파일을 읽어 bpf() 로 맵을 만들고 프로그램을 적재한다 |
| 계수기 설계도 | BPF 바이트코드 | 64비트 명령 형식의 프로그램(RFC 9669 3절) |
| 안전 관리자 | 검증기 | 모든 경로를 모의 실행해 종료 · 메모리 안전을 확인한다 |
| 정비공 | JIT 컴파일러 | 검증된 명령을 그 CPU 의 기계어로 바꾼다 |
| 고리에 단 계수기 | 훅 지점의 프로그램 | tracepoint · kprobe · 패킷 수신에서 사건마다 실행된다 |
| 사물함 장부 | 맵 | 커널 프로그램과 사용자 공간이 함께 읽고 쓰는 키 · 값 저장소 |
| 사무실 결과판 | 사용자 공간 도구 | 맵을 읽어 집계 결과를 보여 준다 |
| 반려 | 적재 거부 | 검증 실패 시 프로그램이 커널에 들어가지 않는다 |
⚠ 비유가 맞지 않는 곳: 계수기는 물건을 세기만 하지 않고, 네트워크 훅에서는 패킷을 버리거나 방향을 바꾸는 판정까지 한다. 안전 관리자도 설계도를 사람처럼 읽지 않고 명령마다 레지스터 상태를 기계적으로 따라간다.
4구조 — 적재 경로와 실행 요소
eBPF 는 사용자 공간의 로더가 bpf() 시스템 호출로 맵과 프로그램을 넘기고, 커널 안에서 검증 → JIT → 부착 순서로 실행 자리에 놓이는 구조다. 프로그램은 레지스터 R0 ~ R10(64비트 · R10 = 읽기 전용 프레임 포인터)을 쓰고, 정해진 헬퍼 함수만 인자 5개까지로 부른다(classic vs eBPF 문서).
그림 3 · 사용자 공간은 bpf() 로 넘기기만 하고, 커널 안에서 검증기를 통과한 프로그램만 기계어가 되어 훅 지점에 붙는다.
| 요소 | 역할 | 값 · 근거 |
|---|---|---|
| 명령 · 레지스터 | 프로그램 표현 | 기본 64비트 · 넓은 명령 128비트 · 레지스터 번호 0 ~ 10(RFC 9669 3.1 · 3.2절) |
| 검증기 | 적재 전 안전 확인 | 1단계 DAG 검사 · 2단계 경로 모의 실행(verifier 문서) · 분석 한도 100만 명령(BPF Design Q&A) |
| JIT | 기계어 변환 | x86-64 에서 R1 → rdi · R10 → rbp(classic vs eBPF 문서) |
| 훅 지점 | 실행 자리 | 소켓 3.19 · kprobe 4.1(bpf(2)) · kprobe · tracepoint 자리는 안정 ABI 아님(BPF Design Q&A) |
| 맵 | 커널 ↔ 사용자 공유 저장 | 해시 · 배열 · LRU 해시 · 프로그램 배열(꼬리 호출 32단 · bpf(2)) |
| 스택 | 함수 안 임시 공간 | 512바이트 · 큰 스택 JIT(x86-64 · arm64)는 호출 사슬 합계 2 KiB(BPF Design Q&A) |
| 권한 | 적재 자격 | CAP_ |
🔑 커널 모듈은 넣은 뒤에 믿고, eBPF 는 넣기 전에 증명한다 — 검증기를 통과하지 못한 코드는 한 명령도 커널에서 실행되지 않는다(verifier 문서).
5동작 — openat 호출을 프로세스별로 세는 추적
리눅스 x86-64 서버에서 10초 동안 openat() 시스템 호출을 프로세스별로 세는 사례다. PID 4321 · 호출 1,250번 · 맵 최대 1,024 항목은 설명용 가정 값이다.
- 작성자가 tracepoint
syscalls/에 붙일 C 코드를 쓰고sys_enter_openat clang -target bpf로 ELF 객체 count.o 를 만든다 — 키 = PID(u32) · 값 = 횟수(u64). - 로더가
BPF_MAP_CREATE로 해시 맵(최대 1,024 항목)을 만들고 맵 파일 서술자를 받는다(bpf(2)). - 로더가
BPF_PROG_LOAD로 프로그램 종류 TRACEPOINT 와 명령 묶음을 넘긴다. - 검증기가 모든 분기를 따라가며
bpf_map_lookup_elem반환값이 NULL 일 수 있는 경로에서 맵 값을 건드리지 않는지 확인하고 통과시킨다(verifier 문서). - JIT 가 명령을 x86-64 기계어로 바꾸고, 로더가 그 프로그램을 tracepoint 에 부착한다.
- PID 4321 이 openat() 을 부를 때마다 프로그램이 돌아 맵의 4321 항목을 1씩 올리고, 10초 뒤 값은 1,250 이 된다.
- 사용자 공간 도구가
BPF_MAP_LOOKUP_ELEM(또는bpftool map dump)으로 항목 4개만 읽어 「4321 → 1,250」을 출력한다. - 로더가 프로그램 · 맵 서술자를 닫으면 부착이 풀리고 커널이 프로그램을 내린다.
그림 4 · 적재 · 검증 · 부착은 한 번이고, 그 뒤 openat 1,250번은 커널 안에서만 세어져 사용자 공간은 끝에 한 번 읽는다.
그림 5 · 검증기는 분기마다 레지스터 상태를 나눠 따라가므로, NULL 확인이 없는 경로에서 맵 값을 쓰면 적재 전에 거부된다.
🔑 검증기는 실행하지 않고 실행 경로를 센다 — 분기가 늘수록 따라갈 상태가 늘어나므로, 거부의 흔한 원인은 «틀린 코드»보다 «증명할 수 없는 코드»다(verifier 문서 · 분석 한도 100만 명령).
6비교 — 커널 모듈 · 사용자 공간 추적과의 차이
| 기준 | eBPF | 커널 모듈 | 사용자 공간 추적(strace · ptrace) |
|---|---|---|---|
| 실행 위치 | 커널 훅 지점 | 커널 어디나 | 사용자 공간 · 사건마다 문맥 전환 |
| 안전 확인 | 적재 전 검증기 | 없음 — 작성자 책임 | 커널 밖이라 필요 없음 |
| 커널을 멈출 위험 | 임의 메모리 읽기 · 쓰기 불가(BPF Design Q&A) | 있음 | 없음 |
| 쓸 수 있는 기능 | 헬퍼 · kfunc 만 · 스택 512바이트 | 커널 함수 전부 | 시스템 호출 경계에서 보이는 것만 |
| 판이 바뀔 때 | 명령 · 헬퍼는 안정 ABI · kprobe 자리는 아님 | 커널 판마다 다시 빌드 | 거의 영향 없음 |
분석새 장치 드라이버처럼 커널 기능 자체를 더하면 모듈, 운영 중 서버의 경로를 재부팅 없이 보거나 패킷을 거르면 eBPF, 한 프로세스의 호출을 잠깐 볼 때는 strace 가 맞다. 근거는 표의 「안전 확인」 · 「쓸 수 있는 기능」 행 — eBPF 는 검증기가 허용한 기능 안에서만 안전을 얻는다.
7실무 진단 — 적재 · 부착 · 읽기 단계 가르기
분석로더의 오류 위치로 적재 · 부착 · 읽기 세 단계를 먼저 가른다. 검증 실패는 커널에 프로그램이 아예 없고(verifier 문서), 부착 실패는 bpftool prog show 에 프로그램은 있는데 실행 횟수가 늘지 않는다(sysctl kernel 문서 bpf_stats_enabled).
| # | 증상 | 의심 원인 | 단계 | 확인 명령 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 적재 때 invalid mem access 'map_value_or_null' | 조회 결과 NULL 확인 누락 | 검증 | 검증 로그(로더 출력) | 분기 뒤에만 PTR_ |
| 2 | 적재 때 프로그램이 너무 크다는 거부 | 분기 폭증 · 분석 한도 | 검증 | 검증 로그의 처리 명령 수 | 100만 명령 한도(BPF Design Q&A) · 함수 나눔 · 꼬리 호출 |
| 3 | 일반 사용자로 적재 시 EPERM | 권한 · 비권한 bpf 차단 | 적재 | sysctl kernel. | 1 · 2 = 차단 · CAP_ |
| 4 | 적재됐는데 횟수 0 | 커널 판에서 함수 이름 · 자리가 바뀜 | 부착 | bpftool prog show · sysctl -w kernel. | kprobe 자리는 안정 ABI 아님 → tracepoint 로 옮김(BPF Design Q&A) |
검증 로그를 먼저 보는 까닭은 적재 거부면 부착 · 맵을 볼 필요가 없기 때문이다. 적재가 됐으면 실행 횟수로 부착을, 횟수가 느는데 결과가 비면 맵 키 형식(PID ↔ 스레드 ID)을 대조한다.
8시험 대비
시험에서는 개념 · 검증기 · 맵을 묻는 정의 · 특징형과, classic BPF 에서 관측 · 네트워크 · 보안 기반으로 넓어진 흐름을 묻는 동향 · 발전형으로 나올 수 있다. 동향형은 RFC 9669 표준화와 리눅스 밖 구현을 함께 적으면 답안이 달라진다.
- 개요 — 정의 · 커널 안 검증된 실행 환경 · classic BPF(McCanne 1993) → eBPF(리눅스 3.18)
- 구조 — 그림 3 적재 경로(로더 · bpf() · 검증기 · JIT · 훅 · 맵 · 헬퍼) + 요소 표(레지스터 11개 · 스택 512바이트)
- 동작 — 그림 4 순서도(맵 생성 · 적재 · 검증 · 부착 · 사건마다 실행 · 맵 읽기)
- 안전 원리 — 그림 5 검증기 경로 추적(NULL 확인 · 거부 메시지) + 분석 한도 100만 명령
- 활용 — 관측(tracepoint · kprobe) · 네트워크(XDP · tc) · 보안(LSM) 표와 커널 모듈 비교
- 동향 · 한계 — RFC 9669 표준화 · 비권한 적재 차단 · kprobe 자리 비안정 ABI
꼭 쓸 키워드
검증기JIT맵헬퍼 함수훅tracepointkprobeXDPbpf() 시스템 호출RFC 9669
9오해와 사실
- 오해eBPF 는 패킷 필터라 네트워크에만 쓴다.사실프로그램 종류에 소켓 필터 외에 kprobe · tracepoint · perf 사건이 있어(bpf(2)) 함수 진입 · 시스템 호출 추적이 큰 몫이다.
- 오해검증기를 통과하면 성능 영향도 없다.사실검증기는 종료와 메모리 안전만 확인하고, 사건마다 실행되는 비용은 남는다 — 통계 수집만 켜도 실행마다 조금 느려진다(sysctl kernel 문서 bpf_stats_enabled).
- 오해한 번 짠 kprobe 프로그램은 모든 커널 판에서 그대로 돈다.사실명령 · 헬퍼는 안정 ABI 이지만 kprobe 가 붙는 함수 자리와 tracepoint 는 안정 ABI 가 아니다(BPF Design Q&A).
10핵심 정리
| 요소 | 맡는 일 | 위치 | 확인 명령 · 값 | 실패 모습 |
|---|---|---|---|---|
| 로더 | 맵 생성 · 적재 · 부착 | 사용자 공간 | bpf() 명령 · bpftool prog load | EPERM · EINVAL |
| 검증기 | 적재 전 안전 증명 | 커널 | 검증 로그 · 100만 명령 한도 | 적재 거부 |
| JIT | 기계어 변환 | 커널 | bpftool prog dump jited | 꺼지면 해석기 실행 |
| 훅 | 사건마다 실행 | 커널 경로 | bpftool prog show 실행 횟수 | 횟수 0 |
| 맵 | 커널 ↔ 사용자 공유 | 커널 메모리 | bpftool map dump | 빈 결과 · 키 불일치 |
| 헬퍼 · kfunc | 허용된 커널 기능 | 커널 | 인자 최대 5개 | 검증 거부 |
11참고 문헌
- 먼저 볼 문헌
- ★ bpf(2) Linux manual page — 맵 · 프로그램 적재 명령과 부착 방법 · 도입 판을 볼 때
- ★ Linux kernel documentation · eBPF verifier — 검증기의 두 단계와 레지스터 상태 · 거부 메시지를 볼 때
- ★ RFC 9669 BPF Instruction Set Architecture (ISA) — 명령 64비트 형식과 레지스터 번호를 표준으로 볼 때
- ★ The BSD Packet Filter: A New Architecture for User-level Packet Capture (Steven McCanne · Van Jacobson) — 커널 안에서 걸러 복사를 줄이는 처음 발상을 볼 때
- 본문 근거
- Linux kernel documentation · BPF Design Q&A — kernel.org · 2026-11 ·
docs.kernel.org/bpf/bpf_design_QA.html· 확인 2026-11-14 - Linux kernel documentation · Classic BPF vs eBPF — kernel.org · 2026-11 ·
docs.kernel.org/bpf/classic_vs_extended.html· 확인 2026-11-14 - Linux kernel documentation · Documentation for /proc/sys/kernel/ — kernel.org · 2026-11 ·
docs.kernel.org/admin-guide/sysctl/kernel.html· 확인 2026-11-14 - capabilities(7) Linux manual page — man7.org · 2026-11 ·
man7.org/linux/man-pages/man7/capabilities.7.html· 확인 2026-11-14 - bpftool-prog (Linux kernel tools/bpf/bpftool/Documentation) — kernel.org · 2026-11 ·
github.com/torvalds/linux/blob/master/tools/bpf/bpftool/Documentation/bpftool-prog.rst· 확인 2026-11-14