rewrite comments into one, unified style

This commit is contained in:
maksw committed 2026-06-15 10:17:48 +02:00
1 parent 6260de0085
commit 467a58c9c6
163 files changed
+3560 -2556

No files matched your search

+34 -1
View File
@@ -1,4 +1,4 @@
// lwip_stack.c - lwIP network stack provider driver.
// lwIP stack provider glue. This file bridges the kernel network-device model into lwIP.
#include <stdint.h>
#include <stddef.h>
@@ -130,6 +130,7 @@ static const NET_STACK_PROVIDER gLwipProvider = {
LwipProviderResolveHostIpv4,
};
// Implements the err To Status operation.
static KSTATUS LwipErrToStatus(err_t err) {
switch (err) {
case ERR_OK: return STATUS_SUCCESS;
@@ -150,10 +151,12 @@ static KSTATUS LwipErrToStatus(err_t err) {
}
}
// Implements the ascii Is Digit operation.
static int LwipAsciiIsDigit(char c) {
return c >= '0' && c <= '9';
}
// Parses ipv4 Part.
static int LwipParseIpv4Part(const char** cursor, uint8_t* out) {
const char* p = *cursor;
uint32_t value = 0;
@@ -175,6 +178,7 @@ static int LwipParseIpv4Part(const char** cursor, uint8_t* out) {
return 1;
}
// Parses ipv4.
static int LwipParseIpv4(const char* text, ip4_addr_t* out) {
if (!text || !out)
return 0;
@@ -205,6 +209,7 @@ static KSTATUS LwipGetSettingIpv4(const char* section, const char* key,
return STATUS_SUCCESS;
}
// Copies section Name.
static KSTATUS LwipCopySectionName(char* out, size_t outSize, const char* prefix, const char* name) {
if (!out || !outSize || !prefix || !name)
return STATUS_INVALID_PARAMETER;
@@ -219,6 +224,7 @@ static KSTATUS LwipCopySectionName(char* out, size_t outSize, const char* prefix
return STATUS_SUCCESS;
}
// Loads config From Section.
static KSTATUS LwipLoadConfigFromSection(const char* section, LWIP_NETIF_CONFIG* cfg) {
if (!section || !cfg)
return STATUS_INVALID_PARAMETER;
@@ -262,6 +268,7 @@ static KSTATUS LwipLoadConfigFromSection(const char* section, LWIP_NETIF_CONFIG*
return STATUS_INVALID_PARAMETER;
}
// Loads netif Config.
static KSTATUS LwipLoadNetifConfig(const NET_DEVICE* device, LWIP_NETIF_CONFIG* cfg) {
if (!device || !cfg)
return STATUS_INVALID_PARAMETER;
@@ -291,17 +298,20 @@ static KSTATUS LwipLoadNetifConfig(const NET_DEVICE* device, LWIP_NETIF_CONFIG*
return STATUS_SUCCESS;
}
// Implements the socket Lock operation.
static KSTATUS LwipSocketLock(LWIP_PROVIDER_SOCKET* s) {
if (!s || !s->Lock)
return STATUS_INVALID_PARAMETER;
return KeWaitSemaphore(s->Lock);
}
// Implements the socket Unlock operation.
static void LwipSocketUnlock(LWIP_PROVIDER_SOCKET* s) {
if (s && s->Lock)
KeSignalSemaphore(s->Lock);
}
// Implements the socket Callback operation.
static void LwipSocketCallback(struct netconn* conn, enum netconn_evt evt, u16_t len) {
(void)len;
if (!conn)
@@ -362,10 +372,12 @@ static KSTATUS LwipSocketAllocateWithConn(uint32_t domain, uint32_t type, uint32
return STATUS_SUCCESS;
}
// Implements the socket Make Ip operation.
static void LwipSocketMakeIp(const SYS_SOCKET_ADDRESS_IPV4_K* address, ip_addr_t* out) {
IP_ADDR4(out, address->Address[0], address->Address[1], address->Address[2], address->Address[3]);
}
// Implements the socket Fill Address operation.
static void LwipSocketFillAddress(SYS_SOCKET_ADDRESS_IPV4_K* out, const ip_addr_t* ip, u16_t port) {
if (!out)
return;
@@ -378,6 +390,7 @@ static void LwipSocketFillAddress(SYS_SOCKET_ADDRESS_IPV4_K* out, const ip_addr_
out->Address[3] = (uint8_t)ip4_addr4(ip_2_ip4(ip));
}
// Implements the low Level Output operation.
static err_t LwipLowLevelOutput(struct netif* netif, struct pbuf* p) {
LWIP_BINDING* b = (LWIP_BINDING*)netif->state;
if (!b || !b->Device || !p || p->tot_len < NET_ETHERNET_HEADER_LENGTH)
@@ -405,6 +418,7 @@ static err_t LwipLowLevelOutput(struct netif* netif, struct pbuf* p) {
return KSUCCESS(st) ? ERR_OK : ERR_IF;
}
// Implements the netif Init operation.
static err_t LwipNetifInit(struct netif* netif) {
LWIP_BINDING* b = (LWIP_BINDING*)netif->state;
if (!b || !b->Device)
@@ -422,6 +436,7 @@ static err_t LwipNetifInit(struct netif* netif) {
return ERR_OK;
}
// Attaches callback.
static void LwipAttachCallback(void* arg) {
LWIP_ATTACH_CTX* ctx = (LWIP_ATTACH_CTX*)arg;
LWIP_BINDING* b = ctx->Binding;
@@ -490,11 +505,13 @@ static void LwipAttachCallback(void* arg) {
KeSignalSemaphore(ctx->Done);
}
// Initializes done.
static void LwipInitDone(void* arg) {
SEMAPHORE* sem = (SEMAPHORE*)arg;
KeSignalSemaphore(sem);
}
// Implements the stack Initialize operation.
static KSTATUS LwipStackInitialize(const HAL_API* hal) {
if (gLwipInitialized)
return STATUS_SUCCESS;
@@ -519,6 +536,7 @@ static KSTATUS LwipStackInitialize(const HAL_API* hal) {
return STATUS_SUCCESS;
}
// Implements the provider Attach Device operation.
static KSTATUS LwipProviderAttachDevice(NET_DEVICE* device) {
if (!gLwipInitialized)
return STATUS_NOT_SUPPORTED;
@@ -576,6 +594,7 @@ static KSTATUS LwipProviderAttachDevice(NET_DEVICE* device) {
return STATUS_SUCCESS;
}
// Implements the provider Receive Frame operation.
static KSTATUS LwipProviderReceiveFrame(NET_DEVICE* device, const void* frame, size_t length) {
if (!gLwipInitialized)
return STATUS_NOT_SUPPORTED;
@@ -609,6 +628,7 @@ static KSTATUS LwipProviderReceiveFrame(NET_DEVICE* device, const void* frame, s
return STATUS_SUCCESS;
}
// Implements the provider Socket Create operation.
static KSTATUS LwipProviderSocketCreate(uint32_t domain, uint32_t type, uint32_t protocol, void** outSocket) {
if (!outSocket)
return STATUS_INVALID_PARAMETER;
@@ -655,6 +675,7 @@ static KSTATUS LwipProviderSocketCreate(uint32_t domain, uint32_t type, uint32_t
return STATUS_SUCCESS;
}
// Implements the provider Socket Close operation.
static void LwipProviderSocketClose(void* socket) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (!s)
@@ -681,6 +702,7 @@ static void LwipProviderSocketClose(void* socket) {
MmFreePool(s);
}
// Implements the provider Bind operation.
static KSTATUS LwipProviderBind(void* socket, const SYS_SOCKET_ADDRESS_IPV4_K* address, size_t addressSize) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (!s || !address)
@@ -711,6 +733,7 @@ static KSTATUS LwipProviderBind(void* socket, const SYS_SOCKET_ADDRESS_IPV4_K* a
return LwipErrToStatus(err);
}
// Implements the provider Listen operation.
static KSTATUS LwipProviderListen(void* socket, uint32_t backlog) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (!s)
@@ -739,6 +762,7 @@ static KSTATUS LwipProviderListen(void* socket, uint32_t backlog) {
return LwipErrToStatus(err);
}
// Implements the provider Accept operation.
static KSTATUS LwipProviderAccept(void* socket, void** acceptedOut, SYS_SOCKET_ADDRESS_IPV4_K* remoteOut) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (!s || !acceptedOut)
@@ -795,6 +819,7 @@ static KSTATUS LwipProviderAccept(void* socket, void** acceptedOut, SYS_SOCKET_A
return STATUS_SUCCESS;
}
// Implements the provider Connect operation.
static KSTATUS LwipProviderConnect(void* socket, const SYS_SOCKET_ADDRESS_IPV4_K* address, size_t addressSize) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (!s || !address)
@@ -830,6 +855,7 @@ static KSTATUS LwipProviderConnect(void* socket, const SYS_SOCKET_ADDRESS_IPV4_K
return LwipErrToStatus(err);
}
// Implements the provider Send operation.
static KSTATUS LwipProviderSend(void* socket, const void* buffer, size_t length, uint32_t flags, size_t* sentOut) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (sentOut)
@@ -913,6 +939,7 @@ static KSTATUS LwipReceiveFromBuffered(LWIP_PROVIDER_SOCKET* s, uint8_t* out,
return STATUS_SUCCESS;
}
// Implements the provider Receive operation.
static KSTATUS LwipProviderReceive(void* socket, void* buffer, size_t length, uint32_t flags, size_t* receivedOut) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (receivedOut)
@@ -1103,6 +1130,7 @@ static KSTATUS LwipProviderReceiveFrom(void* socket, void* buffer, size_t length
return LwipErrToStatus(err);
}
// Implements the provider Set Option operation.
static KSTATUS LwipProviderSetOption(void* socket, uint32_t option, const void* value, size_t valueSize) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (!s || !value)
@@ -1141,6 +1169,7 @@ static KSTATUS LwipProviderSetOption(void* socket, uint32_t option, const void*
return STATUS_SUCCESS;
}
// Implements the provider Get Option operation.
static KSTATUS LwipProviderGetOption(void* socket, uint32_t option, void* value, size_t valueSize, size_t* actualSizeOut) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (actualSizeOut)
@@ -1177,6 +1206,7 @@ static KSTATUS LwipProviderGetOption(void* socket, uint32_t option, void* value,
return STATUS_SUCCESS;
}
// Implements the provider Poll operation.
static KSTATUS LwipProviderPoll(void* socket, uint32_t events, uint32_t* returnedEventsOut) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (!s || !returnedEventsOut)
@@ -1215,6 +1245,7 @@ static KSTATUS LwipProviderPoll(void* socket, uint32_t events, uint32_t* returne
return STATUS_SUCCESS;
}
// Implements the provider Shutdown operation.
static KSTATUS LwipProviderShutdown(void* socket, uint32_t how) {
LWIP_PROVIDER_SOCKET* s = (LWIP_PROVIDER_SOCKET*)socket;
if (!s)
@@ -1240,6 +1271,7 @@ static KSTATUS LwipProviderShutdown(void* socket, uint32_t how) {
return LwipErrToStatus(err);
}
// Implements the provider Resolve Host Ipv4 operation.
static KSTATUS LwipProviderResolveHostIpv4(const char* name, SYS_SOCKET_ADDRESS_IPV4_K* addressOut) {
if (!name || !addressOut)
return STATUS_INVALID_PARAMETER;
@@ -1263,6 +1295,7 @@ static KSTATUS LwipProviderResolveHostIpv4(const char* name, SYS_SOCKET_ADDRESS_
return STATUS_SUCCESS;
}
// Implements the driver Entry operation.
KSTATUS DriverEntry(const HAL_API* hal) {
DbgPrint("lwIP: driver loading...\n");