IT › 컴퓨터 시스템 › 운영체제 › 운영체제 입출력 구조

eBPF확장 버클리 패킷 필터 · extended Berkeley Packet Filter

사용자가 만든 작은 프로그램을 검증기로 안전을 확인한 뒤 커널 안 사건 지점(시스템 호출 · 함수 진입 · 패킷 수신)에 붙여 실행하는 리눅스 커널의 실행 환경이다. 커널 소스를 고치거나 모듈을 넣지 않고 관측 · 네트워크 처리 · 보안 정책을 더한다.

1요약

  1. eBPF 는 리눅스 3.18(2014)의 bpf() 시스템 호출로 들어온 커널 안 실행 환경으로, 그 위에서 패킷 필터 · 성능 추적 도구 · 컨테이너 네트워크 · 보안 감사 프로그램이 돈다(bpf(2) · 명령 형식 = RFC 9669).
  2. 커널 경로를 보려고 모듈을 넣으면 잘못된 포인터 하나가 커널 전체를 멈추고, 모든 사건을 사용자 공간으로 복사하면 비용이 커진다 — 커널 안에서 먼저 거르는 1993년 BPF 는 같은 장비에서 Sun NIT 보다 최대 100배 빨랐다(McCanne 1993).
  3. 「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쉽게 이해하기 — 생산 라인에 계수기를 다는 공장

공장 생산 라인은 멈추면 안 되는데, 품질 담당이 라인의 한 지점을 지나는 물건 수를 세고 싶다. 담당은 계수기 설계도를 내고, 공장 안전 관리자는 설계도가 끝없이 돌거나 라인 부품을 건드리지 않는지 따져 본 뒤에야 승인한다. 정비공이 승인된 계수기를 라인 규격에 맞게 조립해 정해진 고리에 달면, 계수기는 물건이 지날 때마다 사물함 장부에 숫자를 적고 담당은 사무실에서 장부만 읽는다.

사무실 사용자 공간 품질 담당 로더 프로그램 계수기 설계도 BPF 바이트코드 결과판 맵 읽기 · 출력 라인은 그대로 · 숫자만 받음 공장 커널 안전 관리자 검증기 정비공 JIT 컴파일러 위험한 설계도는 반려 적재 거부 사물함 맵 계수기 훅 지점의 프로그램 생산 라인 = 커널 실행 경로(시스템 호출 · 패킷 수신) 1 2 3 4 5

그림 1 · 설계도는 안전 관리자의 승인을 받아야 라인에 붙고, 계수기는 라인을 멈추지 않은 채 사물함에 숫자를 쌓으며 사무실은 그 숫자만 읽는다.

설계도 제출계수기 도면을 공장에 냄
안전 심사끝없이 돌거나 부품을 건드리면 반려
조립라인 규격에 맞게 만듦
고리에 달기정해진 지점에만
장부 쌓기지날 때마다 숫자 하나
장부 읽기사무실에서 결과만
비유 — 실어 나르기와 라인 옆 계수 실제 — 복사와 맵 집계 물건 2,000개를 모두 사무실로 사건 2,000건 복사 사용자 공간에서 셈 라인 옆 계수기가 세고 장부 네 줄만 1,250 430 220 100 맵 항목 4개 읽기 커널 안에서 셈 합계 2,000 = 1,250 + 430 + 220 + 100 위 상자 하나 = 100건 · 아래 상자 하나 = 프로세스 하나의 openat 횟수 · 10초 동안 · 설명용 가정 값 복사량은 사건 수에 비례하고, 맵 읽기 양은 키(프로세스) 수에 비례한다

그림 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 문서).

사용자 공간 ELF 객체 바이트코드 · 맵 정의 로더 libbpf · bpftool 맵 읽기 도구 bpftool map dump bpf() 시스템 호출 경계 커널 PROG_LOAD · MAP_CREATE 적재 거부 검증 로그 · 오류 코드 검증기 모든 경로 모의 실행 JIT 컴파일러 기계어로 실패 통과 헬퍼 · kfunc 정해진 커널 함수만 훅 지점의 프로그램 kprobe · tracepoint · XDP · tc · LSM 맵 해시 · 배열 부착 호출 읽기 사용자 쪽 프로그램 코드 · 데이터 판정 변환 실행 위치 거부

그림 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_BPF(5.8 · capabilities(7)) · unprivileged_bpf_disabled 0 · 1 · 2(sysctl kernel 문서)

🔑 커널 모듈은 넣은 뒤에 믿고, eBPF 는 넣기 전에 증명한다 — 검증기를 통과하지 못한 코드는 한 명령도 커널에서 실행되지 않는다(verifier 문서).

5동작 — openat 호출을 프로세스별로 세는 추적

리눅스 x86-64 서버에서 10초 동안 openat() 시스템 호출을 프로세스별로 세는 사례다. PID 4321 · 호출 1,250번 · 맵 최대 1,024 항목은 설명용 가정 값이다.

  1. 작성자가 tracepoint syscalls/sys_enter_openat 에 붙일 C 코드를 쓰고 clang -target bpf 로 ELF 객체 count.o 를 만든다 — 키 = PID(u32) · 값 = 횟수(u64).
  2. 로더가 BPF_MAP_CREATE 로 해시 맵(최대 1,024 항목)을 만들고 맵 파일 서술자를 받는다(bpf(2)).
  3. 로더가 BPF_PROG_LOAD 로 프로그램 종류 TRACEPOINT 와 명령 묶음을 넘긴다.
  4. 검증기가 모든 분기를 따라가며 bpf_map_lookup_elem 반환값이 NULL 일 수 있는 경로에서 맵 값을 건드리지 않는지 확인하고 통과시킨다(verifier 문서).
  5. JIT 가 명령을 x86-64 기계어로 바꾸고, 로더가 그 프로그램을 tracepoint 에 부착한다.
  6. PID 4321 이 openat() 을 부를 때마다 프로그램이 돌아 맵의 4321 항목을 1씩 올리고, 10초 뒤 값은 1,250 이 된다.
  7. 사용자 공간 도구가 BPF_MAP_LOOKUP_ELEM(또는 bpftool map dump)으로 항목 4개만 읽어 「4321 → 1,250」을 출력한다.
  8. 로더가 프로그램 · 맵 서술자를 닫으면 부착이 풀리고 커널이 프로그램을 내린다.
로더 사용자 공간 커널 bpf() · 검증기 · JIT 훅 · 맵 sys_enter_openat PID 4321 대상 프로세스 ① count.o 컴파일 ② BPF_MAP_CREATE ③ BPF_PROG_LOAD ④ 검증 통과 ⑤ JIT · 기계어 부착 ⑥ openat() 1번째 … 1,250번째 맵[4321] = 1,250 ⑦ BPF_MAP_LOOKUP_ELEM → 1,250 ⑧ 서술자 닫기 → 해제 · 내림 시간 사건마다 커널 안 실행 읽기

그림 4 · 적재 · 검증 · 부착은 한 번이고, 그 뒤 openat 1,250번은 커널 안에서만 세어져 사용자 공간은 끝에 한 번 읽는다.

NULL 확인 없음 — 거부 NULL 확인 있음 — 통과 r0 = bpf_map_lookup_elem(맵, 키) R0 = map_value_or_null *(u64 *)r0 += 1 거부 — 적재 실패 R0 invalid mem access 'map_value_or_null' r0 = bpf_map_lookup_elem(맵, 키) R0 = map_value_or_null if r0 == 0 goto 끝 경로 A · r0 = 0 R0 = 스칼라 경로 B · r0 ≠ 0 R0 = map_value 끝 · 맵 접근 없음 *r0 += 1 허용 검증기가 추적한 레지스터 상태 거부 허용된 맵 접근 r0 = 헬퍼 반환값 · 키가 맵에 없으면 0(NULL) · 실제 명령은 바이트코드이고 여기서는 C 꼴로 줄여 적음

그림 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_TO_MAP_VALUE(verifier 문서)
2적재 때 프로그램이 너무 크다는 거부분기 폭증 · 분석 한도검증검증 로그의 처리 명령 수100만 명령 한도(BPF Design Q&A) · 함수 나눔 · 꼬리 호출
3일반 사용자로 적재 시 EPERM권한 · 비권한 bpf 차단적재sysctl kernel.unprivileged_bpf_disabled1 · 2 = 차단 · CAP_BPF 필요(sysctl kernel 문서 · capabilities(7))
4적재됐는데 횟수 0커널 판에서 함수 이름 · 자리가 바뀜부착bpftool prog show · sysctl -w kernel.bpf_stats_enabled=1kprobe 자리는 안정 ABI 아님 → tracepoint 로 옮김(BPF Design Q&A)

검증 로그를 먼저 보는 까닭은 적재 거부면 부착 · 맵을 볼 필요가 없기 때문이다. 적재가 됐으면 실행 횟수로 부착을, 횟수가 느는데 결과가 비면 맵 키 형식(PID ↔ 스레드 ID)을 대조한다.

8시험 대비

시험에서는 개념 · 검증기 · 맵을 묻는 정의 · 특징형과, classic BPF 에서 관측 · 네트워크 · 보안 기반으로 넓어진 흐름을 묻는 동향 · 발전형으로 나올 수 있다. 동향형은 RFC 9669 표준화와 리눅스 밖 구현을 함께 적으면 답안이 달라진다.

답안 목차
  1. 개요 — 정의 · 커널 안 검증된 실행 환경 · classic BPF(McCanne 1993) → eBPF(리눅스 3.18)
  2. 구조 — 그림 3 적재 경로(로더 · bpf() · 검증기 · JIT · 훅 · 맵 · 헬퍼) + 요소 표(레지스터 11개 · 스택 512바이트)
  3. 동작 — 그림 4 순서도(맵 생성 · 적재 · 검증 · 부착 · 사건마다 실행 · 맵 읽기)
  4. 안전 원리 — 그림 5 검증기 경로 추적(NULL 확인 · 거부 메시지) + 분석 한도 100만 명령
  5. 활용 — 관측(tracepoint · kprobe) · 네트워크(XDP · tc) · 보안(LSM) 표와 커널 모듈 비교
  6. 동향 · 한계 — 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 loadEPERM · EINVAL
검증기적재 전 안전 증명커널검증 로그 · 100만 명령 한도적재 거부
JIT기계어 변환커널bpftool prog dump jited꺼지면 해석기 실행
훅사건마다 실행커널 경로bpftool prog show 실행 횟수횟수 0
맵커널 ↔ 사용자 공유커널 메모리bpftool map dump빈 결과 · 키 불일치
헬퍼 · kfunc허용된 커널 기능커널인자 최대 5개검증 거부

11참고 문헌

  1. 먼저 볼 문헌
  2. ★ bpf(2) Linux manual page — 맵 · 프로그램 적재 명령과 부착 방법 · 도입 판을 볼 때
    man7.org · 2026-11 · man7.org/linux/man-pages/man2/bpf.2.html · 확인 2026-11-14
  3. ★ Linux kernel documentation · eBPF verifier — 검증기의 두 단계와 레지스터 상태 · 거부 메시지를 볼 때
    kernel.org · 2026-11 · docs.kernel.org/bpf/verifier.html · 확인 2026-11-14
  4. ★ RFC 9669 BPF Instruction Set Architecture (ISA) — 명령 64비트 형식과 레지스터 번호를 표준으로 볼 때
    IETF · 2024-10 · www.rfc-editor.org/rfc/rfc9669 · 확인 2026-11-14
  5. ★ The BSD Packet Filter: A New Architecture for User-level Packet Capture (Steven McCanne · Van Jacobson) — 커널 안에서 걸러 복사를 줄이는 처음 발상을 볼 때
    Lawrence Berkeley Laboratory · USENIX Winter 1993 · 1993-01 · www.tcpdump.org/papers/bpf-usenix93.pdf · 확인 2026-11-14
  6. 본문 근거
  7. Linux kernel documentation · BPF Design Q&A — kernel.org · 2026-11 · docs.kernel.org/bpf/bpf_design_QA.html · 확인 2026-11-14
  8. Linux kernel documentation · Classic BPF vs eBPF — kernel.org · 2026-11 · docs.kernel.org/bpf/classic_vs_extended.html · 확인 2026-11-14
  9. Linux kernel documentation · Documentation for /proc/sys/kernel/ — kernel.org · 2026-11 · docs.kernel.org/admin-guide/sysctl/kernel.html · 확인 2026-11-14
  10. capabilities(7) Linux manual page — man7.org · 2026-11 · man7.org/linux/man-pages/man7/capabilities.7.html · 확인 2026-11-14
  11. 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