some fixes in sockets and complete tcp client/server test

src/Network/sockets/knSocketUDP.h

@@ -1,45 +1,49 @@
-#pragma once
-
-#if __cplusplus
-extern "C" {
-#endif
-
-#include "../network_types.h"
-
-typedef struct knSocketUDP {
-    i64 socketfd;
-    knIPV4Endpoint localEndpoint;
-    // TODO socket status enum
-} knSocketUDP;
-ktid_declare(knSocketUDP);
-
-///@return Maybe<knSocketUDP*> new socket
-Maybe knSocketUDP_open();
-
-///@param direction receive/send/both
-///@return Maybe<void> error or nothing
-Maybe knSocketUDP_shutdown(knSocketUDP* socket, knShutdownType direction);
-
-///@return Maybe<void> error or nothing
-Maybe knSocketUDP_close(knSocketUDP* socket);
-
-///start listening at local endpoint
-///@return Maybe<void> error or nothing
-Maybe knSocketUDP_listen(knSocketUDP* socket, knIPV4Endpoint localEndp);
-
-///@return Maybe<knSocketUDP*> new socket connected to client
-Maybe knSocketUDP_accept(knSocketUDP* socket);
-
-///@param dataLength 0-4294967295
-///@return Maybe<void>
-Maybe knSocketUDP_sendto(knSocketUDP* socket, char* data, u32 dataLength, knIPV4Endpoint destination);
-
-///@param buffer buffer for receiving data
-///@param bufferLength 0-4294967295
-///@return Maybe<u64> received bytes amount
-Maybe knSocketUDP_receive(knSocketUDP* socket, char* buffer, u32 bufferLength);
-
-
-#if __cplusplus
-}
+#pragma once
+
+#if __cplusplus
+extern "C" {
+#endif
+
+#include "../network_types.h"
+
+typedef struct knSocketUDP {
+    i64 socketfd;
+    knIPV4Endpoint localEndpoint;
+    // TODO socket status enum
+} knSocketUDP;
+ktid_declare(knSocketUDP);
+
+///@note EXAMPLE 1: socket = open(false); bind(socket, localhost:8080); close(socket); - the socket on port 8080 still unavaliable for several minutes
+///@note EXAMPLE 2: socket = open(true); bind(socket, localhost:8080); close(socket); - the socket on port 8080 can be opened again
+///@param allowReuse enables binding multiple sockets to single port. Set to TRUE on a listening socket if you want to bind it to the same port after close.
+///@return Maybe<knSocketUDP*> new socket
+Maybe knSocketUDP_open(bool allowReuse);
+
+///@param direction receive/send/both
+///@return Maybe<void> error or nothing
+Maybe knSocketUDP_shutdown(knSocketUDP* socket, knShutdownType direction);
+
+/// closes file descriptor and frees socket pointer
+///@return Maybe<void> error or nothing
+Maybe knSocketUDP_close(knSocketUDP* socket);
+
+///start listening at local endpoint
+///@return Maybe<void> error or nothing
+Maybe knSocketUDP_listen(knSocketUDP* socket, knIPV4Endpoint localEndp);
+
+///@return Maybe<knSocketUDP*> new socket connected to client
+Maybe knSocketUDP_accept(knSocketUDP* socket);
+
+///@param dataLength 0-4294967295
+///@return Maybe<void>
+Maybe knSocketUDP_sendto(knSocketUDP* socket, char* data, u32 dataLength, knIPV4Endpoint destination);
+
+///@param buffer buffer for receiving data
+///@param bufferLength 0-4294967295
+///@return Maybe<u64> received bytes amount
+Maybe knSocketUDP_receive(knSocketUDP* socket, char* buffer, u32 bufferLength);
+
+
+#if __cplusplus
+}
 #endif