/src/uWebSockets/fuzzing/EpollHelloWorld.cpp

Source
/* We rely on wrapped syscalls */
#include "libEpollFuzzer/epoll_fuzzer.h"

#include "App.h"

/* We keep this one for teardown later on */
struct us_listen_socket_t *listen_socket;
struct us_socket_t *client;

/* This test is run by libEpollFuzzer */
void test() {
  /* ws->getUserData returns one of these */
    struct PerSocketData {
        /* Fill with user data */
    };

    {
        /* Keep in mind that uWS::SSLApp({options}) is the same as uWS::App() when compiled without SSL support.
        * You may swap to using uWS:App() if you don't need SSL */
        auto app = uWS::App({
            /* There are example certificates in uWebSockets.js repo */
            .key_file_name = "../misc/key.pem",
            .cert_file_name = "../misc/cert.pem",
            .passphrase = "1234"
        }).ws<PerSocketData>("/empty", {
        /* Having no handlers here should not crash */
        }).get("/*", [](auto *res, auto *req) {
            if (req->getHeader("write").length()) {
                res->writeStatus("200 OK")->writeHeader("write", "true")->write("Hello");
                res->write(" world!");
                res->end();
            } else if (req->getQuery().length()) {
                res->close();
            } else {
                res->end("Hello world!");
            }
        }).post("/*", [](auto *res, auto *req) {
            res->onAborted([]() {
                /* We might as well use this opportunity to stress the loop a bit */
                uWS::Loop::get()->defer([]() {

                });
            });
            res->onData([res](std::string_view chunk, bool isEnd) {
                if (isEnd) {
                    res->cork([res, chunk]() {
                        res->write("something ahead");
                        res->end(chunk);
                    });
                }
            });
        }).any("/:candy/*", [](auto *res, auto *req) {
            if (req->getParameter(0).length() == 0) {
                free((void *) -1);
            }
            /* Some invalid queries */
            req->getParameter(30000);
            req->getParameter((unsigned short) -34234);
            req->getHeader("yhello");
            req->getQuery();
            req->getQuery("assd");

            res->end("done");
        }).ws<PerSocketData>("/*", {
            /* Settings */
            .compression = uWS::SHARED_COMPRESSOR,
            .maxPayloadLength = 16 * 1024,
            .idleTimeout = 12,
            .maxBackpressure = 1024,
            /* Handlers */
            .open = [](auto *ws) {
                /* Open event here, you may access ws->getUserData() which points to a PerSocketData struct */
                ws->getNativeHandle();
                ws->getRemoteAddressAsText();
                us_poll_ext((struct us_poll_t *) ws);
            },
            .message = [](auto *ws, std::string_view message, uWS::OpCode opCode) {
                ws->send(message, opCode, true);
            },
            .drain = [](auto *ws) {
                /* Check ws->getBufferedAmount() here */
            },
            .ping = [](auto *ws, std::string_view) {
                /* We use this to trigger the async/wakeup feature */
                uWS::Loop::get()->defer([]() {
                    /* Do nothing */
                });
            },
            .pong = [](auto *ws, std::string_view) {
                /* Not implemented yet */
            },
            .close = [](auto *ws, int code, std::string_view message) {
                /* You may access ws->getUserData() here */
            }
        }).listen(9001, [](auto *listenSocket) {
            listen_socket = listenSocket;
        });

        /* Here we want to stress the connect feature, since nothing else stresses it */
        struct us_loop_t *loop = (struct us_loop_t *) uWS::Loop::get();
        /* This function is stupid */
        us_loop_iteration_number(loop);
        struct us_socket_context_t *client_context = us_create_socket_context(0, loop, 0, {});
        us_socket_context_timestamp(0, client_context);
        client = us_socket_context_connect(0, client_context, "hostname", 5000, "localhost", 0, 0);
      
        if (client) {
            us_socket_is_established(0, client);
            us_socket_local_port(0, client);
        }

        us_socket_context_on_connect_error(0, client_context, [](struct us_socket_t *s, int code) {
            client = nullptr;
            return s;
        });

        us_socket_context_on_open(0, client_context, [](struct us_socket_t *s, int is_client, char *ip, int ip_length) {
            us_socket_flush(0, s);
            return s;
        });

        us_socket_context_on_end(0, client_context, [](struct us_socket_t *s) {
            /* Someone sent is a FIN, but we can still send data */
            us_socket_write(0, s, "asdadasdasdasdaddfgdfhdfgdfg", 28, false);
            return s;
        });

        us_socket_context_on_data(0, client_context, [](struct us_socket_t *s, char *data, int length) {
            return s;
        });

        us_socket_context_on_writable(0, client_context, [](struct us_socket_t *s) {
            /* Let's defer a close here */
            us_socket_shutdown_read(0, s);
            return s;
        });

        us_socket_context_on_close(0, client_context, [](struct us_socket_t *s, int code, void *reason) {
            client = NULL;
            return s;
        });

        /* Trigger some context functions */
        app.addServerName("servername", {});
        app.removeServerName("servername");
        app.missingServerName(nullptr);
        app.getNativeHandle();

        app.run();

        /* After done we also free the client context */
        us_socket_context_free(0, client_context);
    }
    uWS::Loop::get()->setSilent(true);
    uWS::Loop::get()->free();
}

/* Thus function should shutdown the event-loop and let the test fall through */
void teardown() {
  /* If we are called twice there's a bug (it potentially could if
   * all open sockets cannot be error-closed in one epoll_wait call).
   * But we only allow 1k FDs and we have a buffer of 1024 from epoll_wait */
  if (!listen_socket && !client) {
    exit(-1);
  }

    if (client) {
        us_socket_close(0, client, 0, 0);
        client = NULL;
    }

  /* We might have open sockets still, and these will be error-closed by epoll_wait */
  // us_socket_context_close - close all open sockets created with this socket context
    if (listen_socket) {
        us_listen_socket_close(0, listen_socket);
        listen_socket = NULL;
    }
}

Line	Count	Source
1		/* We rely on wrapped syscalls */
2		#include "libEpollFuzzer/epoll_fuzzer.h"
3
4		#include "App.h"
5
6		/* We keep this one for teardown later on */
7		struct us_listen_socket_t *listen_socket;
8		struct us_socket_t *client;
9
10		/* This test is run by libEpollFuzzer */
11	6.40k	void test() {
12		/* ws->getUserData returns one of these */
13	6.40k	struct PerSocketData {
14		/* Fill with user data */
15	6.40k	};
16
17	6.40k	{
18		/* Keep in mind that uWS::SSLApp({options}) is the same as uWS::App() when compiled without SSL support.
19		* You may swap to using uWS:App() if you don't need SSL */
20	6.40k	auto app = uWS::App({
21		/* There are example certificates in uWebSockets.js repo */
22	6.40k	.key_file_name = "../misc/key.pem",
23	6.40k	.cert_file_name = "../misc/cert.pem",
24	6.40k	.passphrase = "1234"
25	6.40k	}).ws<PerSocketData>("/empty", {
26		/* Having no handlers here should not crash */
27	9.73k	}).get("/", [](auto res, auto *req) {
28	9.73k	if (req->getHeader("write").length()) {
29	2.27k	res->writeStatus("200 OK")->writeHeader("write", "true")->write("Hello");
30	2.27k	res->write(" world!");
31	2.27k	res->end();
32	7.45k	} else if (req->getQuery().length()) {
33	784	res->close();
34	6.67k	} else {
35	6.67k	res->end("Hello world!");
36	6.67k	}
37	9.73k	}).post("/", [](auto res, auto *req) {
38	2.30k	res->onAborted([]() {
39		/* We might as well use this opportunity to stress the loop a bit */
40	1.08k	uWS::Loop::get()->defer([]() {
41
42	908	});
43	1.08k	});
44	29.5k	res->onData([res](std::string_view chunk, bool isEnd) {
45	29.5k	if (isEnd) {
46	1.22k	res->cork([res, chunk]() {
47	1.22k	res->write("something ahead");
48	1.22k	res->end(chunk);
49	1.22k	});
50	1.22k	}
51	29.5k	});
52	2.30k	}).any("/:candy/", [](auto res, auto *req) {
53	1.87k	if (req->getParameter(0).length() == 0) {
54	0	free((void *) -1);
55	0	}
56		/* Some invalid queries */
57	1.87k	req->getParameter(30000);
58	1.87k	req->getParameter((unsigned short) -34234);
59	1.87k	req->getHeader("yhello");
60	1.87k	req->getQuery();
61	1.87k	req->getQuery("assd");
62
63	1.87k	res->end("done");
64	1.87k	}).ws<PerSocketData>("/*", {
65		/* Settings */
66	6.40k	.compression = uWS::SHARED_COMPRESSOR,
67	6.40k	.maxPayloadLength = 16 * 1024,
68	6.40k	.idleTimeout = 12,
69	6.40k	.maxBackpressure = 1024,
70		/* Handlers */
71	38.7k	.open = [](auto *ws) {
72		/* Open event here, you may access ws->getUserData() which points to a PerSocketData struct */
73	38.7k	ws->getNativeHandle();
74	38.7k	ws->getRemoteAddressAsText();
75	38.7k	us_poll_ext((struct us_poll_t *) ws);
76	38.7k	},
77	11.9k	.message = [](auto *ws, std::string_view message, uWS::OpCode opCode) {
78	11.9k	ws->send(message, opCode, true);
79	11.9k	},
80	6.40k	.drain = [](auto *ws) {
81		/* Check ws->getBufferedAmount() here */
82	3.88k	},
83	10.9k	.ping = [](auto *ws, std::string_view) {
84		/* We use this to trigger the async/wakeup feature */
85	10.9k	uWS::Loop::get()->defer([]() {
86		/* Do nothing */
87	8.26k	});
88	10.9k	},
89	6.40k	.pong = [](auto *ws, std::string_view) {
90		/* Not implemented yet */
91	1.10k	},
92	38.7k	.close = [](auto *ws, int code, std::string_view message) {
93		/* You may access ws->getUserData() here */
94	38.7k	}
95	6.40k	}).listen(9001, [](auto *listenSocket) {
96	6.40k	listen_socket = listenSocket;
97	6.40k	});
98
99		/* Here we want to stress the connect feature, since nothing else stresses it */
100	6.40k	struct us_loop_t loop = (struct us_loop_t ) uWS::Loop::get();
101		/* This function is stupid */
102	6.40k	us_loop_iteration_number(loop);
103	6.40k	struct us_socket_context_t *client_context = us_create_socket_context(0, loop, 0, {});
104	6.40k	us_socket_context_timestamp(0, client_context);
105	6.40k	client = us_socket_context_connect(0, client_context, "hostname", 5000, "localhost", 0, 0);
106
107	6.40k	if (client) {
108	1.92k	us_socket_is_established(0, client);
109	1.92k	us_socket_local_port(0, client);
110	1.92k	}
111
112	6.40k	us_socket_context_on_connect_error(0, client_context, [](struct us_socket_t *s, int code) {
113	1.66k	client = nullptr;
114	1.66k	return s;
115	1.66k	});
116
117	6.40k	us_socket_context_on_open(0, client_context, [](struct us_socket_t s, int is_client, char ip, int ip_length) {
118	213	us_socket_flush(0, s);
119	213	return s;
120	213	});
121
122	6.40k	us_socket_context_on_end(0, client_context, [](struct us_socket_t *s) {
123		/* Someone sent is a FIN, but we can still send data */
124	860	us_socket_write(0, s, "asdadasdasdasdaddfgdfhdfgdfg", 28, false);
125	860	return s;
126	860	});
127
128	6.40k	us_socket_context_on_data(0, client_context, [](struct us_socket_t s, char data, int length) {
129	224	return s;
130	224	});
131
132	6.40k	us_socket_context_on_writable(0, client_context, [](struct us_socket_t *s) {
133		/* Let's defer a close here */
134	769	us_socket_shutdown_read(0, s);
135	769	return s;
136	769	});
137
138	6.40k	us_socket_context_on_close(0, client_context, [](struct us_socket_t s, int code, void reason) {
139	253	client = NULL;
140	253	return s;
141	253	});
142
143		/* Trigger some context functions */
144	6.40k	app.addServerName("servername", {});
145	6.40k	app.removeServerName("servername");
146	6.40k	app.missingServerName(nullptr);
147	6.40k	app.getNativeHandle();
148
149	6.40k	app.run();
150
151		/* After done we also free the client context */
152	6.40k	us_socket_context_free(0, client_context);
153	6.40k	}
154	6.40k	uWS::Loop::get()->setSilent(true);
155	6.40k	uWS::Loop::get()->free();
156	6.40k	}
157
158		/* Thus function should shutdown the event-loop and let the test fall through */
159	6.36k	void teardown() {
160		/* If we are called twice there's a bug (it potentially could if
161		* all open sockets cannot be error-closed in one epoll_wait call).
162		* But we only allow 1k FDs and we have a buffer of 1024 from epoll_wait */
163	6.36k	if (!listen_socket && !client) {
164	0	exit(-1);
165	0	}
166
167	6.36k	if (client) {
168	132	us_socket_close(0, client, 0, 0);
169	132	client = NULL;
170	132	}
171
172		/* We might have open sockets still, and these will be error-closed by epoll_wait */
173		// us_socket_context_close - close all open sockets created with this socket context
174	6.36k	if (listen_socket) {
175	6.25k	us_listen_socket_close(0, listen_socket);
176		listen_socket = NULL;
177	6.25k	}
178	6.36k	}

Coverage Report

Created: 2026-06-07 06:38