rewrite comments into one, unified style

code/kernel/net_socket.c

@@ -1,4 +1,4 @@
-// net_socket.c - process-owned socket objects with provider-neutral dispatch.
+// Kernel socket layer. This file owns process socket objects and provider-neutral socket dispatch.
 
 #include <stdint.h>
 #include <stddef.h>
@@ -12,6 +12,7 @@
 #define NET_SOCKET_UDP_MAX_BYTES 65507u
 #define NET_SOCKET_RAW_MAX_BYTES 65535u
 
+// Implements the net Socket Destroy operation.
 static void NetSocketDestroy(OBJECT* object) {
     SOCKET_OBJECT* socket = (SOCKET_OBJECT*)object;
     if (socket->Provider && socket->ProviderSocket) {
@@ -56,6 +57,7 @@ static KSTATUS NetSocketGetProviderSocket(SOCKET_OBJECT* socket,
     return STATUS_SUCCESS;
 }
 
+// Implements the net Socket Create operation.
 KSTATUS NetSocketCreate(uint32_t domain, uint32_t type, uint32_t protocol, SOCKET_OBJECT** out) {
     if (!out)
         return STATUS_INVALID_PARAMETER;
@@ -78,6 +80,7 @@ KSTATUS NetSocketCreate(uint32_t domain, uint32_t type, uint32_t protocol, SOCKE
     return st;
 }
 
+// Implements the net Socket Bind operation.
 KSTATUS NetSocketBind(SOCKET_OBJECT* socket, const SYS_SOCKET_ADDRESS_IPV4_K* address, size_t addressSize) {
     const NET_STACK_PROVIDER* provider = NULL;
     void* providerSocket = NULL;
@@ -85,6 +88,7 @@ KSTATUS NetSocketBind(SOCKET_OBJECT* socket, const SYS_SOCKET_ADDRESS_IPV4_K* ad
     return KSUCCESS(st) ? provider->Bind(providerSocket, address, addressSize) : st;
 }
 
+// Implements the net Socket Listen operation.
 KSTATUS NetSocketListen(SOCKET_OBJECT* socket, uint32_t backlog) {
     const NET_STACK_PROVIDER* provider = NULL;
     void* providerSocket = NULL;
@@ -92,6 +96,7 @@ KSTATUS NetSocketListen(SOCKET_OBJECT* socket, uint32_t backlog) {
     return KSUCCESS(st) ? provider->Listen(providerSocket, backlog) : st;
 }
 
+// Implements the net Socket Accept operation.
 KSTATUS NetSocketAccept(SOCKET_OBJECT* socket, SOCKET_OBJECT** acceptedOut, SYS_SOCKET_ADDRESS_IPV4_K* remoteOut) {
     if (!acceptedOut)
         return STATUS_INVALID_PARAMETER;
@@ -121,6 +126,7 @@ KSTATUS NetSocketAccept(SOCKET_OBJECT* socket, SOCKET_OBJECT** acceptedOut, SYS_
     return st;
 }
 
+// Implements the net Socket Connect operation.
 KSTATUS NetSocketConnect(SOCKET_OBJECT* socket, const SYS_SOCKET_ADDRESS_IPV4_K* address, size_t addressSize) {
     const NET_STACK_PROVIDER* provider = NULL;
     void* providerSocket = NULL;
@@ -128,6 +134,7 @@ KSTATUS NetSocketConnect(SOCKET_OBJECT* socket, const SYS_SOCKET_ADDRESS_IPV4_K*
     return KSUCCESS(st) ? provider->Connect(providerSocket, address, addressSize) : st;
 }
 
+// Implements the net Socket Send operation.
 KSTATUS NetSocketSend(SOCKET_OBJECT* socket, const void* buffer, size_t length, uint32_t flags, size_t* sentOut) {
     if (sentOut)
         *sentOut = 0;
@@ -142,6 +149,7 @@ KSTATUS NetSocketSend(SOCKET_OBJECT* socket, const void* buffer, size_t length,
     return KSUCCESS(st) ? provider->Send(providerSocket, buffer, length, flags, sentOut) : st;
 }
 
+// Implements the net Socket Receive operation.
 KSTATUS NetSocketReceive(SOCKET_OBJECT* socket, void* buffer, size_t length, uint32_t flags, size_t* receivedOut) {
     if (receivedOut)
         *receivedOut = 0;
@@ -194,6 +202,7 @@ KSTATUS NetSocketReceiveFrom(SOCKET_OBJECT* socket, void* buffer, size_t length,
     return KSUCCESS(st) ? provider->ReceiveFrom(providerSocket, buffer, length, flags, remoteOut, receivedOut) : st;
 }
 
+// Implements the net Socket Shutdown operation.
 KSTATUS NetSocketShutdown(SOCKET_OBJECT* socket, uint32_t how) {
     const NET_STACK_PROVIDER* provider = NULL;
     void* providerSocket = NULL;
@@ -201,6 +210,7 @@ KSTATUS NetSocketShutdown(SOCKET_OBJECT* socket, uint32_t how) {
     return KSUCCESS(st) ? provider->Shutdown(providerSocket, how) : st;
 }
 
+// Implements the net Socket Set Option operation.
 KSTATUS NetSocketSetOption(SOCKET_OBJECT* socket, uint32_t option, const void* value, size_t valueSize) {
     const NET_STACK_PROVIDER* provider = NULL;
     void* providerSocket = NULL;
@@ -208,6 +218,7 @@ KSTATUS NetSocketSetOption(SOCKET_OBJECT* socket, uint32_t option, const void* v
     return KSUCCESS(st) ? provider->SetOption(providerSocket, option, value, valueSize) : st;
 }
 
+// Implements the net Socket Get Option operation.
 KSTATUS NetSocketGetOption(SOCKET_OBJECT* socket, uint32_t option, void* value, size_t valueSize, size_t* actualSizeOut) {
     const NET_STACK_PROVIDER* provider = NULL;
     void* providerSocket = NULL;
@@ -215,6 +226,7 @@ KSTATUS NetSocketGetOption(SOCKET_OBJECT* socket, uint32_t option, void* value,
     return KSUCCESS(st) ? provider->GetOption(providerSocket, option, value, valueSize, actualSizeOut) : st;
 }
 
+// Implements the net Socket Poll operation.
 KSTATUS NetSocketPoll(SOCKET_OBJECT* socket, uint32_t events, uint32_t* returnedEventsOut) {
     if (!returnedEventsOut)
         return STATUS_INVALID_PARAMETER;
@@ -226,6 +238,7 @@ KSTATUS NetSocketPoll(SOCKET_OBJECT* socket, uint32_t events, uint32_t* returned
     return KSUCCESS(st) ? provider->Poll(providerSocket, events, returnedEventsOut) : st;
 }
 
+// Implements the net Resolve Host Ipv4 operation.
 KSTATUS NetResolveHostIpv4(const char* name, SYS_SOCKET_ADDRESS_IPV4_K* addressOut) {
     if (!name || !addressOut)
         return STATUS_INVALID_PARAMETER;