From 50234b1d1363a27a86822a810932584226e86262 Mon Sep 17 00:00:00 2001
From: MasterRoby3 <master.roby3@protonmail.com>
Date: Sun, 27 Aug 2023 16:11:01 +0200
Subject: [PATCH] Finished connection method and fully implemented threads

---
 testing/connection_method/readme.txt          |   2 +
 .../epoll_data_stats_100.csv                  |   0
 .../epoll_data_stats_1000.csv                 |   0
 .../epoll_data_stats_1000_TIMEOUT.csv         |   0
 .../epoll_data_stats_1000_TIMEOUT_HARD.csv    |   0
 .../results/epoll_data_stats_1000_multith.csv |  19 +
 .../epoll_data_stats_1000_multith_TIMEOUT.csv |  19 +
 ...l_data_stats_1000_multith_TIMEOUT_HARD.csv |  19 +
 .../epoll_data_stats_500.csv                  |   0
 ...ct_data_stats_1000desc_NOBLOCK_TIMEOUT.csv |   0
 ...ta_stats_1000desc_NOBLOCK_TIMEOUT_HARD.csv |   0
 testing/threads/ev_build.out                  | Bin 0 -> 98096 bytes
 .../threads/event_builder_epoll_multhread.cxx | 351 ++++++++++++++++++
 testing/threads/prov.out                      | Bin 0 -> 17752 bytes
 testing/threads/provider.cxx                  |  82 ++++
 testing/threads/readme.md                     |  18 +
 testing/threads/spawn_clients.sh              |  15 +
 17 files changed, 525 insertions(+)
 rename testing/{connection_method => results}/epoll_data_stats_100.csv (100%)
 rename testing/{connection_method => results}/epoll_data_stats_1000.csv (100%)
 rename testing/{connection_method => results}/epoll_data_stats_1000_TIMEOUT.csv (100%)
 rename testing/{connection_method => results}/epoll_data_stats_1000_TIMEOUT_HARD.csv (100%)
 create mode 100644 testing/results/epoll_data_stats_1000_multith.csv
 create mode 100644 testing/results/epoll_data_stats_1000_multith_TIMEOUT.csv
 create mode 100644 testing/results/epoll_data_stats_1000_multith_TIMEOUT_HARD.csv
 rename testing/{connection_method => results}/epoll_data_stats_500.csv (100%)
 rename testing/{connection_method => results}/select_data_stats_1000desc_NOBLOCK_TIMEOUT.csv (100%)
 rename testing/{connection_method => results}/select_data_stats_1000desc_NOBLOCK_TIMEOUT_HARD.csv (100%)
 create mode 100755 testing/threads/ev_build.out
 create mode 100644 testing/threads/event_builder_epoll_multhread.cxx
 create mode 100755 testing/threads/prov.out
 create mode 100644 testing/threads/provider.cxx
 create mode 100644 testing/threads/readme.md
 create mode 100755 testing/threads/spawn_clients.sh

diff --git a/testing/connection_method/readme.txt b/testing/connection_method/readme.txt
index be42d79..0ebc290 100644
--- a/testing/connection_method/readme.txt
+++ b/testing/connection_method/readme.txt
@@ -15,3 +15,5 @@ The timeout is pretty hard, we're talking 1 second, to hilight the difference in
 With epoll we see a big rise in throughput with the 2 clients, since we kill cpu time for iteration and optimize the 30 seconds time analysis, 
 in the 50 clients it's not so evident. With 50 we start to see already big improvements with epoll vs select.
 
+Now I try to multithread epoll, to see if the data acquired increases. I'll measure the full bandwith received, I expect a semi-linear increase in performance.
+For the multithreading thread check the threads folder
\ No newline at end of file
diff --git a/testing/connection_method/epoll_data_stats_100.csv b/testing/results/epoll_data_stats_100.csv
similarity index 100%
rename from testing/connection_method/epoll_data_stats_100.csv
rename to testing/results/epoll_data_stats_100.csv
diff --git a/testing/connection_method/epoll_data_stats_1000.csv b/testing/results/epoll_data_stats_1000.csv
similarity index 100%
rename from testing/connection_method/epoll_data_stats_1000.csv
rename to testing/results/epoll_data_stats_1000.csv
diff --git a/testing/connection_method/epoll_data_stats_1000_TIMEOUT.csv b/testing/results/epoll_data_stats_1000_TIMEOUT.csv
similarity index 100%
rename from testing/connection_method/epoll_data_stats_1000_TIMEOUT.csv
rename to testing/results/epoll_data_stats_1000_TIMEOUT.csv
diff --git a/testing/connection_method/epoll_data_stats_1000_TIMEOUT_HARD.csv b/testing/results/epoll_data_stats_1000_TIMEOUT_HARD.csv
similarity index 100%
rename from testing/connection_method/epoll_data_stats_1000_TIMEOUT_HARD.csv
rename to testing/results/epoll_data_stats_1000_TIMEOUT_HARD.csv
diff --git a/testing/results/epoll_data_stats_1000_multith.csv b/testing/results/epoll_data_stats_1000_multith.csv
new file mode 100644
index 0000000..147718c
--- /dev/null
+++ b/testing/results/epoll_data_stats_1000_multith.csv
@@ -0,0 +1,19 @@
+buffer_size;time;total_received_data;
+1;30001.8;121453;
+500;30001.8;38315920;
+1000;30013.8;60329152;
+2000;30005.2;74660074;
+3000;30005.9;85193274;
+4000;30006.5;96597573;
+5000;30008.5;106440822;
+10000;30011.8;137147617;
+20000;30007.9;176761989;
+30000;30006.4;156482849;
+40000;30014;177159351;
+50000;30049.3;171875036;
+100000;30053.9;224264206;
+200000;30048.3;225628771;
+300000;30121;180069213;
+400000;30016.7;156804334;
+500000;30000.6;230636978;
+1000000;30135;159812471;
diff --git a/testing/results/epoll_data_stats_1000_multith_TIMEOUT.csv b/testing/results/epoll_data_stats_1000_multith_TIMEOUT.csv
new file mode 100644
index 0000000..cbcb9d5
--- /dev/null
+++ b/testing/results/epoll_data_stats_1000_multith_TIMEOUT.csv
@@ -0,0 +1,19 @@
+buffer_size;time;total_received_data;
+1;30002.1;140629;
+500;30003.8;31440572;
+1000;30004.1;48545615;
+2000;30010.9;65841163;
+3000;30011.9;79191486;
+4000;30008.6;83061533;
+5000;30011.5;82064998;
+10000;30005.2;96952555;
+20000;30007;132912119;
+30000;30005.2;138298731;
+40000;30017.7;138156188;
+50000;30017.2;139215949;
+100000;30051.2;139854062;
+200000;30008.9;146022695;
+300000;30061.5;142890809;
+400000;30083.1;138006324;
+500000;30074.4;133424935;
+1000000;30000.5;114451148;
diff --git a/testing/results/epoll_data_stats_1000_multith_TIMEOUT_HARD.csv b/testing/results/epoll_data_stats_1000_multith_TIMEOUT_HARD.csv
new file mode 100644
index 0000000..0b7500d
--- /dev/null
+++ b/testing/results/epoll_data_stats_1000_multith_TIMEOUT_HARD.csv
@@ -0,0 +1,19 @@
+buffer_size;time;total_received_data;
+1;30002.1;163986;
+500;30019;34088098;
+1000;30005.1;50801994;
+2000;30006.2;69301651;
+3000;30005.4;80399265;
+4000;30012.7;90123946;
+5000;30010.8;98647263;
+10000;30011.7;116325174;
+20000;30049.7;134726431;
+30000;30025;144562322;
+40000;30028.7;147823821;
+50000;30012.3;146218628;
+100000;30069.2;151376815;
+200000;30011.5;138831476;
+300000;30022.2;145632228;
+400000;30096.8;146447339;
+500000;30143.2;134063359;
+1000000;30000.4;123787063;
diff --git a/testing/connection_method/epoll_data_stats_500.csv b/testing/results/epoll_data_stats_500.csv
similarity index 100%
rename from testing/connection_method/epoll_data_stats_500.csv
rename to testing/results/epoll_data_stats_500.csv
diff --git a/testing/connection_method/select_data_stats_1000desc_NOBLOCK_TIMEOUT.csv b/testing/results/select_data_stats_1000desc_NOBLOCK_TIMEOUT.csv
similarity index 100%
rename from testing/connection_method/select_data_stats_1000desc_NOBLOCK_TIMEOUT.csv
rename to testing/results/select_data_stats_1000desc_NOBLOCK_TIMEOUT.csv
diff --git a/testing/connection_method/select_data_stats_1000desc_NOBLOCK_TIMEOUT_HARD.csv b/testing/results/select_data_stats_1000desc_NOBLOCK_TIMEOUT_HARD.csv
similarity index 100%
rename from testing/connection_method/select_data_stats_1000desc_NOBLOCK_TIMEOUT_HARD.csv
rename to testing/results/select_data_stats_1000desc_NOBLOCK_TIMEOUT_HARD.csv
diff --git a/testing/threads/ev_build.out b/testing/threads/ev_build.out
new file mode 100755
index 0000000000000000000000000000000000000000..7c9cac044ee7d9e51c9c86b3f2f14aacdf83c2e9
GIT binary patch
literal 98096
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
ao&S=#){lH3c3o=!$c423nhmt3{r>?_Wq+yw

literal 0
HcmV?d00001

diff --git a/testing/threads/event_builder_epoll_multhread.cxx b/testing/threads/event_builder_epoll_multhread.cxx
new file mode 100644
index 0000000..aa8cc98
--- /dev/null
+++ b/testing/threads/event_builder_epoll_multhread.cxx
@@ -0,0 +1,351 @@
+#include <asm-generic/errno-base.h>
+#include <asm-generic/errno.h>
+#include <cerrno>
+#include <cstddef>
+#include <cstdint>
+#include <cstdio>     // for fprintf()
+#include <functional>
+#include <iostream>
+#include <ratio>
+#include <unistd.h>    // for close(), read()
+#include <sys/epoll.h> // for epoll_create1(), epoll_ctl(), struct epoll_event
+#include <cstring>    // for strncmp
+
+//my addition to the online guide
+#include <csignal>
+#include <cstdlib>
+#include <arpa/inet.h>
+#include <netinet/in.h>
+#include <sys/socket.h>
+
+#include <fcntl.h>
+#include <utility>
+#include <vector>
+#include <chrono>
+#include <fstream>
+
+#include <thread>
+#include <mutex>
+#include <atomic>
+#include <array>
+
+
+#define MAX_EVENTS 20000
+
+int makeSocket() {
+    int sockfd;
+    if ((sockfd = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
+        perror("socket failed");
+        exit(EXIT_FAILURE);
+    }
+    return sockfd;
+}
+
+void bindSocketPort(int server_fd, int port) {
+    struct sockaddr_in localAddr;
+    localAddr.sin_family = AF_INET;
+    localAddr.sin_addr.s_addr = INADDR_ANY;
+    localAddr.sin_port = htons(port);
+
+    if (bind(server_fd, (struct sockaddr *)&localAddr, sizeof(localAddr)) < 0) {
+        perror("bind failed");
+        exit(EXIT_FAILURE);
+    }
+    printf("FD %d bound to port %d\n", server_fd, port);
+}
+
+void startListening(int server_fd) {
+    if (listen(server_fd, 20000) < 0) {
+        perror("listen");
+        exit(EXIT_FAILURE);
+    }
+    printf("FD %d listening to new connections\n", server_fd);
+}
+
+int acceptConnection(int server_fd) {
+    int client_fd;
+    struct sockaddr_in remoteAddr;
+
+    size_t addrlen = sizeof(remoteAddr);
+    if ((client_fd = accept(server_fd, (struct sockaddr *)&remoteAddr, (socklen_t *)&addrlen)) < 0) {
+        perror("accept");
+        exit(EXIT_FAILURE);
+    } else {
+        int flags = fcntl(client_fd, F_GETFL);
+        fcntl(client_fd, F_SETFL, flags | O_NONBLOCK);
+    }
+    printf("Connection from host %s, port %d, FD %d\n", inet_ntoa(remoteAddr.sin_addr), ntohs(remoteAddr.sin_port), client_fd);
+    return client_fd;
+}
+
+void acceptConnectionEpollStyle(int server_fd, int &efd) {
+    struct sockaddr_in new_remoteAddr;
+    int addrlen = sizeof(struct sockaddr_in);
+
+    while (true) {
+        int conn_sock = accept(server_fd, (struct sockaddr*)&new_remoteAddr, (socklen_t*)&addrlen);
+
+        if (conn_sock == -1) {
+            // All incoming connections have been processed
+            if ((errno == EAGAIN) || (errno == EWOULDBLOCK)) {
+                break;
+            } else {
+                perror("accept");
+                break;
+            }
+        }
+
+        // make new connection non-blocking
+        int flags = fcntl(conn_sock, F_GETFL, 0);
+        fcntl(conn_sock, F_SETFL, flags | O_NONBLOCK);
+
+        // monitor new connection for read events, always in edge triggered
+        struct epoll_event event;
+        event.events = EPOLLIN | EPOLLEXCLUSIVE;//| EPOLLET;
+        event.data.fd = conn_sock;
+
+        // Allow epoll to monitor the new connection
+        if (epoll_ctl(efd, EPOLL_CTL_ADD, conn_sock, &event) == -1) {
+            perror("epoll_ctl: conn_sock");
+            break;
+        }
+        printf("Accepted epoll style connection from %s:%d from fd: %d\n", inet_ntoa(new_remoteAddr.sin_addr), ntohs(new_remoteAddr.sin_port), conn_sock);
+
+    }
+}
+
+void term_handler(int signal) {
+    printf("Terminated, received SIGNAL %d", signal);
+    exit(EXIT_SUCCESS);
+}
+
+std::atomic<uint64_t> grandtotal_kb;
+
+
+void thradizable(int &epoll_fd, int &master_socket, int buf_size, const int &th_flag, const int thread_index) {
+    epoll_event events[MAX_EVENTS];
+    uint64_t bytes_read = 0;
+    uint64_t kBytes_read = 0;
+
+    while (true) {
+        if (th_flag == 1) {
+            grandtotal_kb += kBytes_read;
+            break;
+        }
+        // Time measurements
+        ///auto start = std::chrono::high_resolution_clock::now();
+
+        // Returns only the sockets for which there are events
+        //printf("Before wait\n");
+        int nfds = epoll_wait(epoll_fd, events, MAX_EVENTS, -1);
+        //printf("After wait\n");
+        if (nfds == -1) {
+            perror("epoll_wait");
+            exit(EXIT_FAILURE);
+        }
+
+        // Iterate on the sockets having events
+        for (int i = 0; i < nfds; i++) {
+            //printf("Tot fds = %d reading from %d\n", nfds, i);
+            int fd = events[i].data.fd;
+            if (fd == master_socket) {
+                // If the activity is on the master socket, than it's a new connection request
+                acceptConnectionEpollStyle(master_socket, epoll_fd);
+
+            } else if ((events[i].events & EPOLLERR) || (events[i].events & EPOLLHUP) || (!(events[i].events & EPOLLIN))) {
+                // Than the client connection is closed, so I close it
+                printf("Closing %d", fd);
+                close(fd);
+            } else {
+                // Than we received data from one of the monitored sockets
+                char buffer[buf_size];
+                int valread = 0;
+                //while (valread != EAGAIN) {
+                    valread = recv(fd, &buffer, buf_size, 0);
+                    if (valread > 0) {
+                        //printf("[RICEVUTO]\t FROM %d\n", fd);
+                        bytes_read += valread;
+                        int kilos = 0;
+                        if ((kilos = bytes_read / 1024) > 0) {
+                            kBytes_read += kilos;
+                            bytes_read -= (kilos * 1024);
+                            //printf("reade bites %lu", bytes_read);
+                        }
+                    }
+                //}
+
+            }
+        }
+
+        ///auto end = std::chrono::high_resolution_clock::now();
+        ///double time_taken = std::chrono::duration_cast<std::chrono::nanoseconds>(end - start).count();
+        //time taken in milliseconds
+        ///
+        /*time_taken *= 1e-6;
+        total_time_taken += time_taken;
+
+        if (total_time_taken > 3e4) {
+            times.push_back(total_time_taken);
+            tot_received_data.push_back(kBytes_read);
+            break;
+        }*/
+        ///
+    }
+
+}
+
+
+int main(int argc, char const *argv[]) {
+
+    signal(SIGTERM, term_handler);
+
+
+    if (argc != 2) {
+        printf("Usage: %s portNumber \n", argv[0]);
+        exit(EXIT_FAILURE);
+    }
+    int port = atoi(argv[1]);
+    printf("Start socket port %d\n", port);
+ 
+    int master_socket;
+    const int opt = 1;
+
+
+    master_socket = makeSocket();
+
+    //set master socket to allow multiple connections , 
+    //this is just a good habit, it will work without this 
+    if( setsockopt(master_socket, SOL_SOCKET, SO_REUSEADDR, (char *)&opt, 
+          sizeof(opt)) < 0 )  
+    {  
+        perror("setsockopt");  
+        exit(EXIT_FAILURE);  
+    }
+
+    bindSocketPort(master_socket, port);
+    startListening(master_socket);
+
+    int flags = fcntl(master_socket, F_GETFL, 0);
+    fcntl(master_socket, F_SETFL, flags | O_NONBLOCK);
+
+    epoll_event ev, events[MAX_EVENTS];
+    std::array<std::mutex, MAX_EVENTS> mutex_array;
+    std::array<uint64_t, MAX_EVENTS> kBytes_read_on_descr;
+
+    //The atomic here is used as a flag to tell the thread to stop
+    std::vector<std::thread> vThreads;
+
+    //create the epoll instance
+    int epoll_fd = epoll_create1(0);
+    if (epoll_fd == -1) {
+        printf("Failed to create epoll file descriptor\n");
+        exit(EXIT_FAILURE);
+    }
+
+    ev.data.fd = master_socket;
+    // Reading events with edge triggered mode
+    ev.events = EPOLLIN | EPOLLEXCLUSIVE;//| EPOLLET;
+
+    // Allowing epoll to monitor the master_socket
+    if (epoll_ctl(epoll_fd, EPOLL_CTL_ADD, master_socket, &ev) == -1){
+        perror("epoll_ctl");
+        exit(EXIT_FAILURE);
+    }
+
+    std::vector<int> sizes;
+    std::vector<uint64_t> tot_received_data;
+    std::vector<double> times; 
+
+    grandtotal_kb = 0;
+    int increment = 499;
+
+    for (int buf_size = 1; buf_size < 1e6 + 1; ) {
+        switch (buf_size) {
+            case 500:
+                increment = 500;
+                break;
+            case (int) 1e3:
+                increment = 1e3;
+                break;
+            case (int) 5e3:
+                increment = 5e3;
+                break;
+            case (int) 1e4:
+                increment = 1e4;
+                break;
+            case (int) 5e4:
+                increment = 5e4;
+                break;
+            case (int) 1e5:
+                increment = 1e5;
+                break;
+            case (int) 5e5:
+                increment = 5e5;
+                break;
+        }
+        printf("Next increment %d with current i: %d\n", increment, buf_size);
+    
+        std::array<std::thread, 4> vT;
+        std::array<int, 4> thread_flags;
+
+        for (int t_i = 0; t_i < 4; t_i++) {
+            thread_flags[t_i] = 0;
+            vT[t_i] = std::thread(thradizable, std::ref(epoll_fd), std::ref(master_socket), buf_size, std::cref(thread_flags.at(t_i)), t_i);
+        }
+
+        std::string command = "";
+        std::string ref("go");
+        if ( increment == 499){
+            while (command != "go") {
+                std::cout << "Insert command: ";
+                std::cin >> command;
+                std::cout << command << std::endl;
+            }
+        }
+
+        std::cout << "starting measurement with current buf size: " << buf_size << std::endl;
+
+        auto start = std::chrono::high_resolution_clock::now();
+        grandtotal_kb = 0;
+
+        sleep(30);
+        for (int t_i = 0; t_i < 4; t_i++) {
+            thread_flags[t_i] = 1;
+            vT[t_i].join();
+        }
+        uint64_t local_kB = grandtotal_kb;
+        auto end = std::chrono::high_resolution_clock::now();
+        double time_taken = std::chrono::duration_cast<std::chrono::nanoseconds>(end - start).count();
+        //time taken in milliseconds
+        time_taken *= 1e-6;
+
+        times.push_back(time_taken);
+        sizes.push_back(buf_size);
+        tot_received_data.push_back(local_kB);
+
+        buf_size += increment;
+    }
+
+       
+
+    std::ofstream fout;
+    fout.open("epoll_data_stats_1000_multith_TIMEOUT.csv");
+    //the time is in milliseconds and the data in kbytes
+    fout << "buffer_size;time;total_received_data;\n";
+    auto iter_sizes = sizes.begin();
+    auto iter_times = times.begin();
+    auto iter_data = tot_received_data.begin();
+
+    for ( ; (iter_sizes != sizes.end()) && (iter_times != times.end()) && (iter_data != tot_received_data.end()) ; (++iter_sizes, ++iter_times, ++iter_data) ) {
+        fout << *iter_sizes << ";" << *iter_times <<  ";" << *iter_data << ";\n";
+    }
+
+    fout.close();
+
+    if (close(epoll_fd)) {
+        printf("Failed to close epoll file descriptor");
+        exit(EXIT_FAILURE);
+    }
+
+    return 0;
+}
\ No newline at end of file
diff --git a/testing/threads/prov.out b/testing/threads/prov.out
new file mode 100755
index 0000000000000000000000000000000000000000..47dc96b92145ed19ce9d4716869df053327e7169
GIT binary patch
literal 17752
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

literal 0
HcmV?d00001

diff --git a/testing/threads/provider.cxx b/testing/threads/provider.cxx
new file mode 100644
index 0000000..a7b2038
--- /dev/null
+++ b/testing/threads/provider.cxx
@@ -0,0 +1,82 @@
+#include <algorithm>
+#include <arpa/inet.h>
+#include <cstddef>
+#include <cstdint>
+#include <cstdio>
+#include <cstdlib>
+#include <cstring>
+#include <ctime>
+#include <netinet/in.h>
+#include <sys/socket.h>
+#include <csignal>
+#include <iostream>
+#include <iomanip>
+#include <tuple>
+#include <unistd.h>
+
+
+int makeSocket() {
+    int sockfd;
+    if ((sockfd = socket(AF_INET, SOCK_STREAM, 0)) < 0) {
+        perror("socket failed");
+        exit(EXIT_FAILURE);
+    }
+    return sockfd;
+}
+
+void connectTo(int sock, const char* host, int port) {
+    struct sockaddr_in serv_addr;
+    serv_addr.sin_family = AF_INET;
+    serv_addr.sin_addr.s_addr = inet_addr(host);
+    serv_addr.sin_port = htons(port);
+
+    if (connect(sock, (struct sockaddr *)&serv_addr, sizeof(serv_addr)) < 0) {
+        perror("Connection failed");
+        exit(EXIT_FAILURE);
+    }
+
+    printf("Connected to %s: %d\n", host, port);
+}
+
+int main(int argc, char* argv[]) {
+
+     if (argc != 2) {
+        printf("Usage: ./prov.out timeout (ms)");
+        exit(EXIT_FAILURE);
+    }
+
+    int timeout = atoi(argv[1]);
+    //printf("Selected timeout: %f", static_cast<double>(timeout) / 1000);
+
+    int socket = makeSocket();
+    connectTo(socket, "127.0.0.1", 7777);
+
+    //allocating 100 megabytes of memory
+    uint64_t* chunky_boy = new uint64_t[67108];
+    size_t chunky_boy_size = 67108 * sizeof(uint64_t);
+    printf("chonky size %d", static_cast<int>(chunky_boy_size));
+
+    //setting memory to verify non-emptyness
+    memset(chunky_boy, 45678, chunky_boy_size);
+
+    int buffer_size = 1024 * 32;
+
+
+    for ( ;;) {
+        
+        for ( int j = 0; j < chunky_boy_size; ) {
+            
+            ssize_t bytes = send(socket, reinterpret_cast<char*>(chunky_boy) + j, std::min(static_cast<int>(chunky_boy_size) - j, buffer_size), 0);
+            if (timeout != 0) {
+                sleep(timeout);
+            }
+            j += buffer_size;
+        }
+
+        //usleep(1000);
+
+    }
+    
+
+    return 0;
+}
\ No newline at end of file
diff --git a/testing/threads/readme.md b/testing/threads/readme.md
new file mode 100644
index 0000000..963c1e4
--- /dev/null
+++ b/testing/threads/readme.md
@@ -0,0 +1,18 @@
+# Multithreaded epoll()
+
+### Not a naïve implementation
+To correctly set a multithreaded `epoll()` it's necessary to specifically set some flags. We'll consider level triggered mode since that's what we're using. Since we'll split the requests on different worker threads I expect the performance to scale semi-linearly with the number of workers.
+
+The provider implementation doesen't change. I'll spawn providers with no timeout.
+
+#### Results
+With 4 threads we manage to see from ~1.5x to ~3x increase in performance without timeout. In prod we can maximize cpu cores using for read 8-n-1 threads, where 1 is for the main thread and n is the number of thrads used to build the full event (probably would be n=1).
+
+With timeout, I dont see improvement with the TIMEOUT_HARD (only 2 clients sending continuously), actually some worse perfomance in some cases. Prob this is due the EPOLLEXCLUSIVE which waste time distributing on more threads.
+With the TIMEOUD (50 clients sending continuously) I get some improvement, but not comparable to the all continuous ones. That's probably because of the fact that i'm getting some sort of tradeoff between exec time in incoming connection and time needed to distribute load on threads.
+
+In an environment with a lot of clients and short timeouts, the approach with more than one thread is obviously preferrable for scalability reasons (50 cont + 950 1 sec timeout shows improvement already).
+
+In such enviroment, a multito avoid reordering.hread instance should use mutexes on read data to avoid reordering of received data. It's gonna be explained in detail during the presentations.
+
+(thats to study a little better)
diff --git a/testing/threads/spawn_clients.sh b/testing/threads/spawn_clients.sh
new file mode 100755
index 0000000..023b916
--- /dev/null
+++ b/testing/threads/spawn_clients.sh
@@ -0,0 +1,15 @@
+#!/bin/bash
+echo "Usage: $0 host port runNumber numberOfProviders"
+if [ $# -eq 1 ]
+then
+    for i in $(seq 1 $1);
+    do
+        echo "Spawning provider number $i"
+        if [ $i -le 50 ]
+        then
+            ./prov.out 1&
+        else
+            ./prov.out 0&
+        fi
+    done
+fi