Runtime Services · Zephyr 3.7.0 LTS3 · source + diagram note

Networking

Zephyr 3.7.0 네이티브 수신의 패킷 소유권, 인터페이스 운영 상태, 소켓 오프로드 경계를 고정 소스와 함께 읽는다.

기준 버전: Zephyr 3.7.0 LTS3 형식: 사용 예제 + 설명 + 그림 분석 방법: 네이티브 RX와 오프로드 분리

본문 기준: Zephyr 3.7.0 LTS3 · 이후 유지보수 패치는 별도입니다.

전체 흐름

Zephyr의 네이티브 RX에서 드라이버는 프레임을 net_pkt와 그 데이터 조각인 net_buf에 담습니다. net_recv_data()가 음수를 반환하면 호출자가 패킷을 정리하고, 0을 반환하면 호출자는 패킷을 더 이상 만지지 않습니다. 반면 소켓 오프로드를 선택한 애플리케이션은 기기 구현에 따라 다른 경로로 갈 수 있습니다.

아래 그림은 Zephyr v3.7.0의 네이티브 수신 경로에서 소유권이 갈리는 지점을 보여 줍니다. 빌드 시 기능 선택, 인터페이스 상태, IP 주소와 경로는 이어지는 표에서 따로 확인합니다.

그림 1. RX 패킷의 소유권 경계와 소켓 오프로드 분기
드라이버가 프레임을 net_pkt와 net_buf에 기록합니다. net_recv_data가 음수를 반환하면 호출자가 net_pkt_unref를 하고, 0을 반환하면 스택이 필터에서 폐기하거나 즉시 또는 큐를 거쳐 처리할 수 있으므로 호출자는 재사용하지 않습니다. 0은 애플리케이션 수신 성공을 뜻하지 않습니다. 소켓 오프로드는 별도 구현 경로입니다.

고정 소스: net_pkt.c:1440–1540, net_core.c:466–523. 0 반환에는 필터가 함수 안에서 해제하는 경우와 즉시 처리 또는 RX 큐로 넘기는 경우가 포함됩니다. 애플리케이션 수신 성공을 증명하지 않습니다. 소켓 오프로드는 별도 등록 구현 선택입니다.

소스 코드 위치

먼저 확인할 Zephyr 3.7.0 LTS3 소스 파일

subsys/net/ip/net_if.c subsys/net/ip/net_pkt.c subsys/net/ip/net_core.c include/zephyr/net/net_pkt.h include/zephyr/net/socket.h

설명: 네이티브 RX의 패킷 할당·해제는 net_pkt.c, 수신 진입·필터·RX 처리는 net_core.c, 인터페이스 운영 상태는 net_if.c에서 확인합니다. 소켓 오프로드 구성에서는 등록된 소켓 구현을 따로 추적합니다. 빌드에 포함된 기능을 확인할 때는 최종 Kconfig와 devicetree 결과도 함께 봅니다.

원본 코드와 사용 예

아래는 소켓 사용, 네이티브 RX 패킷 소유권, 인터페이스 상태를 분리한 축약 예제입니다. 실제 애플리케이션에서는 입력 길이와 오류 처리를 더 검증해야 합니다.

1. socket 사용 패턴

설명용 예제 · 관련 API/설정: include/zephyr/net/socket.h
int fd = zsock_socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP);
zsock_sendto(fd, payload, len, 0,
             (struct sockaddr *)&peer, sizeof(peer));
라인별 설명
zsock_socket

Zephyr의 BSD 호환 소켓 API다. 등록된 구현의 선택과 실제 지원 범위는 구성에 따라 달라진다.

sendto

애플리케이션 버퍼를 선택된 소켓 구현에 전달한다. 반환값만으로 피어 수신을 알 수 없다.

peer

상대 주소와 인터페이스 정책, 소켓 오프로드 선택을 함께 확인한다.

읽는 방법: 소켓 API는 native 또는 등록된 offloaded 구현을 선택할 수 있습니다. zsock_socket()과 zsock_sendto()의 반환값을 확인하고 정상·오류 모두에서 소켓을 닫는 코드를 실제 애플리케이션에 넣어야 합니다.

2. 패킷 버퍼 소유권

설명용 예제 · 관련 API/설정: include/zephyr/net/net_pkt.h
/* 설명용: iface, frame, len은 RX 드라이버의 유효 입력 */
struct net_pkt *pkt = net_pkt_rx_alloc_with_buffer(iface,
        len, AF_UNSPEC, 0, K_NO_WAIT);
if (pkt == NULL) {
        return -ENOMEM;  /* 이 예제의 실패 매핑 */
}

int ret = net_pkt_write(pkt, frame, len);
if (ret < 0) {
        net_pkt_unref(pkt);
        return ret;
}

ret = net_recv_data(iface, pkt);
if (ret < 0) {
        net_pkt_unref(pkt); /* v3.7.0: 조기 오류는 호출자가 정리 */
}
return ret; /* 0이면 pkt를 다시 사용하거나 unref하지 않음 */
라인별 설명
alloc

RX slab에서 net_pkt를, pool에서 net_buf를 확보합니다. 할당 실패는 NULL이며 내부에서 부분 할당을 정리합니다. 호출자는 NULL을 다시 unref하지 않습니다.

K_NO_WAIT

이 설명용 RX 경로는 대기 없이 할당을 시도합니다. 실제 드라이버 문맥과 지연 예산에 맞는 timeout을 선택하고, pool 고갈 시 drop과 계측을 정합니다.

net_recv_data

v3.7.0에서 음수 반환은 조기 검증 실패이므로 호출자가 unref합니다. 0 반환이면 필터에서 이미 폐기했거나 즉시 또는 큐를 거쳐 처리할 수 있습니다. 호출자는 패킷을 재사용하거나 다시 unref하지 않습니다. 앱 수신 성공을 뜻하지도 않습니다.

읽는 방법: 이 코드는 패킷 데이터 기록까지 포함한 축약 예제입니다. net_pkt_write() 실패와 net_recv_data() 음수 반환에서는 각각 한 번 정리하고, 0 반환 뒤에는 소유권을 내려놓습니다. 이는 앱 수신 성공이 아닙니다. 실제 프레임 길이와 MTU도 검증합니다.

3. 네트워크 인터페이스 확인

설명용 예제 · 관련 API/설정: subsys/net/ip/net_if.c
struct net_if *iface = net_if_get_default();
if (iface == NULL) {
        return -ENODEV;
}
if (!net_if_is_up(iface)) {
        return -ENETDOWN;
}
/* IP 주소·route·상대 호스트 연결성은 별도 확인 */
라인별 설명
default iface

여러 interface가 있으면 routing/interface policy를 따져야 한다.

is_up

v3.7.0의 net_if_is_up()는 인터페이스가 operational up/running인지 확인합니다. 관리자 설정인 net_if_is_admin_up(), device readiness와 구분합니다.

-ENETDOWN

이 예제의 반환값은 인터페이스 확인 실패를 나타냅니다. 원인은 admin, device readiness, carrier, dormant를 나눠 기록하고, 주소·route 문제는 별도 진단합니다.

읽는 방법: 기본 인터페이스가 없는 경우부터 확인합니다. net_if_is_up()가 참이어도 IP 주소·route·DNS·상대 호스트의 상태는 별개이며, 오프로드 소켓 선택도 별도 구성에 따릅니다.

고정 소스를 따라 수신 경로 읽기

네이티브 드라이버가 받은 프레임부터 애플리케이션까지 한 번에 성공했다고 말할 수 없습니다. 아래 경계마다 별도의 반환·폐기·수신 여부를 확인해야 합니다.

표 1. v3.7.0 네이티브 RX의 확인 지점
경계고정 소스관찰할 사실
할당·기록net_pkt.c:1440–1540RX slab와 buffer pool 확보, 실패 시 NULL; 이후 net_pkt_write() 결과 검사
수신 진입net_core.c:466–523NULL·빈 패킷·NET_IF_UP 검사; 유효한 패킷을 넘겼다가 음수를 받으면 호출자가 계속 소유
필터·처리net_core.c:466–523필터 거부 시 내부 unref, 수락 시 즉시 처리 또는 RX 큐 제출; 모두 0 반환
L2·L3·소켓net_core.c의 process_data()NET_DROP은 처리 경로에서 해제될 수 있고, 실제 앱 수신은 별도 계측

소켓 오프로드를 등록한 구성에서는 zsock_socket()의 구현 선택부터 달라질 수 있습니다. 이 경우 위 네이티브 net_pkt 경로를 그 소켓의 공통 경로로 가정하지 않습니다. v3.7.0 Socket Offloading에서 family·type·protocol과 등록 우선순위를 확인합니다.

내부 동작: 책임이 바뀌는 세 경계

1. net_pkt와 데이터 조각

net_pkt는 패킷 메타데이터, net_buf 체인은 데이터를 담습니다. net_pkt_rx_alloc_with_buffer()가 NULL을 돌려주면 부분 할당은 내부에서 정리됩니다. 성공한 패킷에서 net_pkt_write()가 실패했다면 아직 드라이버가 소유하므로 한 번 net_pkt_unref()합니다. 해제 함수는 마지막 참조에서 데이터 조각과 패킷을 정리합니다. net_pkt.c:508–606

2. net_recv_data()의 0

이 함수는 유효 입력, 빈 패킷, 인터페이스의 NET_IF_UP 플래그를 검사한 뒤 필터로 갑니다. 필터가 거부하면 함수 안에서 해제하고도 0을 반환합니다. 통과하면 NET_TC_RX_COUNT == 0일 때 즉시 처리하고, 그 외에는 RX 큐로 제출합니다. 따라서 0은 호출자의 소유권 종료만 알려 줄 뿐, IP·소켓·애플리케이션 도착을 증명하지 않습니다. 음수 조기 반환에서는 함수가 해제하지 않습니다. 유효한 패킷을 전달했다면 호출자가 정리하며, NULL 패킷을 unref하지 않습니다. net_core.c:466–523

3. 인터페이스 상태와 소켓 구현

net_if_is_admin_up()의 설정값, net_if_is_up()의 운영 상태, IP 주소·경로·피어 도달 가능성은 서로 다른 확인 단계입니다. 운영 상태 갱신에는 관리자 상태, device readiness, carrier, dormant가 관여합니다. 또한 소켓 오프로드가 선택되면 실제 데이터 경로와 계측 지점이 네이티브 스택과 다를 수 있습니다. net_if.c:5234–5288 · Socket Offloading

반드시 지킬 불변 조건

표 2. 반환값과 패킷 책임
관찰값호출자의 책임단정할 수 없는 것
할당 NULL패킷을 사용·unref하지 않고 실패 처리프레임을 전달했다는 주장
할당 성공, 기록 실패보유한 패킷을 정확히 한 번 unref기록되지 않은 데이터를 스택에 전달
net_recv_data() < 0유효한 패킷을 전달했다면 정확히 한 번 unref하고 오류 기록. NULL은 unref하지 않음스택이 패킷을 이미 해제했다는 주장
net_recv_data() == 0패킷을 다시 읽거나 unref하지 않음애플리케이션이 수신했다는 주장

net_pkt_unref()는 참조수를 줄이고 마지막 참조에서 패킷과 fragment를 해제합니다. 이미 넘겨준 패킷을 다시 해제하는 코드는 double-unref·use-after-free 위험이 있습니다. 실제 드라이버가 별도 참조를 보유하는 특수 설계라면 그 참조의 획득·반납을 독립적으로 명시해야 합니다. net_pkt.c:508–606

패킷 소유권과 인터페이스 상태

수신 함수의 NET_IF_UP 플래그 검사와 인터페이스의 운영 상태 판정은 같은 질문이 아닙니다. 아래 그림은 운영 상태 갱신의 주요 관문을 압축한 것입니다.

그림 2. 인터페이스 OPER_UP 판정에 이르는 관문
관리자 허용?아니면 OPER_DOWN
device ready?아니면 LOWERLAYERDOWN
carrier 있음?아니면 DOWN 또는 LOWERLAYERDOWN
dormant 아님?아니면 DORMANT
OPER_UP주소·route·피어 수신은 별도 확인

왼쪽부터 조건을 통과할 때 오른쪽으로 진행합니다. carrier가 없을 때의 상태는 L2 종류에 따라 다릅니다. net_if.c:5234–5288.

표 3. 비슷한 이름의 서로 다른 질문
확인뜻추가로 필요한 것
net_if_is_admin_up()관리자 사용 설정device·carrier·dormant 상태
net_if_is_up()운영 상태가 up/runningIP 주소·route·피어 연결성
net_recv_data()의 NET_IF_UP 검사이 수신 진입의 admin 플래그 관문패킷의 필터·프로토콜·앱 도착 여부

공식 Network Interface State Management와 고정 net_core.c를 함께 읽으면 admin·oper 경계를 혼동하지 않을 수 있습니다.

네트워크 실패 조건표

표 4. 증상에서 확인 지점으로
증상먼저 확인할 지점패킷 처리
RX alloc NULLRX slab·buffer pool 잔량, 요청 길이와 MTU전달하지 않은 패킷을 unref하지 않음
net_pkt_write() < 0할당된 공간과 프레임 길이보유한 패킷을 한 번 unref
net_recv_data() < 0NULL·빈 패킷·NET_IF_UP 조기 검사유효한 패킷을 보유했다면 호출자가 한 번 unref
net_recv_data() == 0, 앱 미수신필터 drop, L2/L3 verdict, RX 큐, 소켓 매칭호출자는 이미 소유권을 넘겼으므로 unref 금지
admin up, 통신 불가device ready·carrier·dormant, 주소·route·피어인터페이스와 IP 계층을 따로 진단
소켓은 동작, native RX 계측 없음등록된 소켓 오프로드와 구현 우선순위선택된 경로의 계측을 사용

네트워킹에서 피할 접근

0 반환 뒤의 double-unref

net_recv_data()가 0을 반환하면 필터가 이미 해제했거나 처리 경로가 패킷을 보유합니다. 드라이버가 이 포인터를 다시 읽거나 해제하지 않습니다.

0을 애플리케이션 수신 성공으로 기록

0은 수신 진입 함수의 결과입니다. 필터·L2·L3·소켓 매칭 뒤 애플리케이션의 recv 결과를 따로 계측해야 합니다.

admin up을 네트워크 연결로 간주

운영 상태, IP 주소, route, 피어 도달 가능성은 서로 다른 단계입니다. 증상을 각 단계에 붙여 기록합니다.

모든 socket을 native net_pkt 경로로 추적

소켓 오프로드가 등록되면 다른 구현이 선택될 수 있습니다. 등록 조건과 우선순위를 먼저 확인합니다.

Linux와 비교할 때의 기준

두 시스템 모두 장치에서 받은 데이터를 프로토콜 계층과 소켓까지 전달하지만, Zephyr 3.7.0의 이 글은 net_pkt/net_buf와 net_recv_data() 계약을 기준으로 읽습니다. Linux의 sk_buff 해제 규칙이나 NAPI 흐름을 여기에 그대로 적용하면 반환값과 소유권을 잘못 판단하게 됩니다.

비교는 질문의 수준에만 둡니다. “누가 버퍼를 소유하는가”, “어디에서 drop되는가”, “소켓이 어떤 구현을 선택하는가”를 양쪽에서 따로 찾아보고, 이 페이지의 판단과 예제는 Zephyr v3.7.0 고정 코드로 검증합니다.

네이티브 RX 시간 축

표 5. 같은 패킷의 관찰 지점
시점동작계측할 값
T0드라이버가 프레임 수신프레임 길이, iface, 하드웨어 drop
T1RX packet·buffer 할당과 기록할당/기록 실패, pool 점유
T2net_recv_data() 진입음수 조기 반환 또는 0; 이 지점에서 호출자 소유권 분기
T3필터 또는 RX 처리필터 drop, 즉시 처리(NET_TC_RX_COUNT == 0) 또는 큐 제출
T4L2·L3·소켓 처리프로토콜 drop, socket 매칭
T5애플리케이션 수신별도 recv 결과와 지연

시간 측정은 T2의 0을 T5로 대체하지 않아야 의미가 있습니다. RX 큐가 없도록 구성하면 T3은 동기 처리이므로 “항상 스레드 큐에 들어간다”는 설명도 성립하지 않습니다. net_core.c

실제로 분리해 볼 세 가지 사례

1. 버퍼 부족

RX slab·pool 압박으로 할당이 NULL이면 드라이버는 전달할 패킷이 없습니다. 요청 길이, MTU, 동시 점유량과 drop 수를 함께 적습니다. 이미 내부 정리된 NULL을 unref하지 않습니다.

2. 관리자 상태만 up

net_if_is_admin_up()가 참이어도 carrier가 없거나 device가 준비되지 않으면 운영 상태는 up이 아닐 수 있습니다. 주소와 route는 그 다음 별도 검사입니다.

3. 소켓 오프로드 선택

애플리케이션은 같은 socket API를 사용하지만 선택된 구현이 외부 네트워크 스택을 이용할 수 있습니다. 네이티브 net_pkt 카운터에 변화가 없다는 이유만으로 앱 트래픽이 없었다고 결론 내리지 않습니다.

보드에서 추가 확인할 사항

고정 코드는 API 경계를 알려 주지만 실제 보드의 드라이버, Kconfig, 네트워크 매체와 부하 결과는 실험으로 확인해야 합니다.

  • 드라이버가 어느 문맥에서 net_recv_data()를 호출하고, 음수 반환 시 어떻게 한 번만 해제하는가?
  • RX pool이 포화될 때 할당 실패와 드라이버 drop이 얼마나 생기며, 트래픽 클래스 수가 즉시 처리/큐 경로를 어떻게 바꾸는가?
  • 인터페이스의 admin·carrier·dormant 변화 뒤 주소와 route가 언제 유효해지는가?
  • 해당 socket family·type·protocol이 native와 offloaded 구현 중 무엇을 선택하는가?

네트워킹 코드 리뷰 질문

패킷 책임

할당 NULL, 기록 실패, 수신 음수, 수신 0의 네 분기에서 각각 누가 마지막 참조를 반납하는가? 0 뒤에 포인터 사용이나 두 번째 unref가 남아 있지 않은가?

상태와 전달

관리자 상태와 운영 상태를 나눠 보았는가? 수신 함수의 0만으로 앱 수신을 주장하지 않고 필터·L2/L3·소켓 결과를 확인했는가?

구성 차이

RX 트래픽 클래스 구성과 socket offload 등록 여부를 확인했는가? 네이티브 경로 계측이 그 보드의 실제 선택 경로에 붙어 있는가?

디버깅 관찰 지점

한 번의 통신 실패를 “네트워크 오류”로 묶지 말고 드라이버 수신, 패킷 할당, net_recv_data() 결과, 필터/L2/L3, socket 선택, 앱 recv를 시간 순서로 적습니다.

표 6. 원인별 로그 키
경계로그에 남길 값판단
드라이버 / pooliface, frame 길이, alloc/write 결과스택으로 넘기기 전 실패인지
net_recv_data()반환값, 호출자 unref 횟수소유권이 어디에 남았는지
필터 / 처리filter verdict, RX 큐 구성, L2/L3 drop0 반환 후 어디서 사라졌는지
socket / 앱native·offload 선택, recv 결과앱까지 실제 도착했는지

Zephyr의 Network Stack Architecture는 일반적인 RX 계층을 보여 주고, 동기 처리·필터 분기는 고정 소스로 확인합니다.

실험 기록 양식

아래 원래 양식의 필드는 유지합니다. [예상 상태 전이]와 [실제 상태 전이]에는 admin→oper 변화와 RX 패킷 소유권 분기를 구분해 적고, [실패 시 return/log/assert]에는 수신 0 이후 앱 수신 여부까지 따로 적습니다.

[실험 주제] Networking
[Zephyr 버전] Zephyr 3.7.0 LTS3
[보드/SoC]
[west manifest revision]
[관련 Kconfig]
[관련 devicetree node]
[관찰한 원본 코드]
[예상 상태 전이]
[실제 상태 전이]
[실패 시 return/log/assert]
[latency 또는 memory 측정값]
[다음 실험]

기록 팁: 드라이버의 iface·프레임 길이, packet/pool 결과, net_recv_data() 반환, 실제 socket 구현, 앱 recv 결과를 같은 실험 ID로 연결합니다. 최종 .config와 보드/SoC를 함께 남겨 동기 RX와 큐 경로의 차이를 재현합니다.

네트워킹 용어 정리

표 7. 코드에서 구별할 이름
용어이 글에서의 뜻
net_pkt패킷의 메타데이터와 데이터 fragment 참조를 담는 객체
net_buf패킷 데이터 조각; 마지막 packet 참조 해제 때 fragment 체인도 정리
호출자 소유권오류 분기에서 마지막 참조를 반납할 책임. net_recv_data() == 0 뒤에는 그 포인터를 사용하지 않음
admin up / oper up관리자 설정과 실제 운영 상태. 둘 다 IP 주소·route·피어 도달을 보장하지 않음
socket offload조건에 맞는 등록 소켓 구현이 외부 스택 등의 경로를 맡을 수 있는 구성

다음 Zephyr RTOS 글