xref: /freebsd/tests/sys/kern/pipe/pipe_kqueue_test.c (revision e86cf8ada1ac24f3f3119d63d284dc75cf4b8828)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
3  *
4  * Copyright (c) 2020 Jan Kokemüller
5  *
6  * Redistribution and use in source and binary forms, with or without
7  * modification, are permitted provided that the following conditions
8  * are met:
9  * 1. Redistributions of source code must retain the above copyright
10  *    notice, this list of conditions and the following disclaimer.
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in the
13  *    documentation and/or other materials provided with the distribution.
14  *
15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25  * SUCH DAMAGE.
26  */
27 
28 #include <sys/cdefs.h>
29 __FBSDID("$FreeBSD$");
30 
31 #include <sys/param.h>
32 #include <sys/event.h>
33 #include <sys/stat.h>
34 
35 #include <errno.h>
36 #include <fcntl.h>
37 #include <limits.h>
38 #include <poll.h>
39 #include <stdio.h>
40 #include <stdlib.h>
41 #include <time.h>
42 #include <unistd.h>
43 
44 #include <atf-c.h>
45 
46 ATF_TC_WITHOUT_HEAD(pipe_kqueue__write_end);
47 ATF_TC_BODY(pipe_kqueue__write_end, tc)
48 {
49 	int p[2] = { -1, -1 };
50 
51 	ATF_REQUIRE(pipe2(p, O_CLOEXEC | O_NONBLOCK) == 0);
52 	ATF_REQUIRE(p[0] >= 0);
53 	ATF_REQUIRE(p[1] >= 0);
54 
55 	int kq = kqueue();
56 	ATF_REQUIRE(kq >= 0);
57 
58 	struct kevent kev[32];
59 	EV_SET(&kev[0], p[1], EVFILT_WRITE, EV_ADD | EV_CLEAR, 0, 0, 0);
60 
61 	ATF_REQUIRE(kevent(kq, kev, 1, NULL, 0, NULL) == 0);
62 
63 	/* Test that EVFILT_WRITE behaves sensibly on the write end. */
64 
65 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
66 	    &(struct timespec) { 0, 0 }) == 1);
67 	ATF_REQUIRE(kev[0].ident == (uintptr_t)p[1]);
68 	ATF_REQUIRE(kev[0].filter == EVFILT_WRITE);
69 	ATF_REQUIRE(kev[0].flags == EV_CLEAR);
70 	ATF_REQUIRE(kev[0].fflags == 0);
71 	ATF_REQUIRE(kev[0].data == 16384);
72 	ATF_REQUIRE(kev[0].udata == 0);
73 
74 	/* Filling up the pipe should make the EVFILT_WRITE disappear. */
75 
76 	char c = 0;
77 	ssize_t r;
78 	while ((r = write(p[1], &c, 1)) == 1) {
79 	}
80 	ATF_REQUIRE(r < 0);
81 	ATF_REQUIRE(errno == EAGAIN || errno == EWOULDBLOCK);
82 
83 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
84 	    &(struct timespec) { 0, 0 }) == 0);
85 
86 	/* Reading (PIPE_BUF - 1) bytes will not trigger a EVFILT_WRITE yet. */
87 
88 	for (int i = 0; i < PIPE_BUF - 1; ++i) {
89 		ATF_REQUIRE(read(p[0], &c, 1) == 1);
90 	}
91 
92 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
93 	    &(struct timespec) { 0, 0 }) == 0);
94 
95 	/* Reading one additional byte triggers the EVFILT_WRITE. */
96 
97 	ATF_REQUIRE(read(p[0], &c, 1) == 1);
98 
99 	r = kevent(kq, NULL, 0, kev, nitems(kev), &(struct timespec) { 0, 0 });
100 	ATF_REQUIRE(r == 1);
101 	ATF_REQUIRE(kev[0].ident == (uintptr_t)p[1]);
102 	ATF_REQUIRE(kev[0].filter == EVFILT_WRITE);
103 	ATF_REQUIRE(kev[0].flags == EV_CLEAR);
104 	ATF_REQUIRE(kev[0].fflags == 0);
105 	ATF_REQUIRE(kev[0].data == PIPE_BUF);
106 	ATF_REQUIRE(kev[0].udata == 0);
107 
108 	/*
109 	 * Reading another byte triggers the EVFILT_WRITE again with a changed
110 	 * 'data' field.
111 	 */
112 
113 	ATF_REQUIRE(read(p[0], &c, 1) == 1);
114 
115 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
116 	    &(struct timespec) { 0, 0 }) == 1);
117 	ATF_REQUIRE(kev[0].ident == (uintptr_t)p[1]);
118 	ATF_REQUIRE(kev[0].filter == EVFILT_WRITE);
119 	ATF_REQUIRE(kev[0].flags == EV_CLEAR);
120 	ATF_REQUIRE(kev[0].fflags == 0);
121 	ATF_REQUIRE(kev[0].data == PIPE_BUF + 1);
122 	ATF_REQUIRE(kev[0].udata == 0);
123 
124 	/*
125 	 * Closing the read end should make a EV_EOF appear but leave the 'data'
126 	 * field unchanged.
127 	 */
128 
129 	ATF_REQUIRE(close(p[0]) == 0);
130 
131 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
132 	    &(struct timespec) { 0, 0 }) == 1);
133 	ATF_REQUIRE(kev[0].ident == (uintptr_t)p[1]);
134 	ATF_REQUIRE(kev[0].filter == EVFILT_WRITE);
135 	ATF_REQUIRE(kev[0].flags == (EV_CLEAR | EV_EOF | EV_ONESHOT));
136 	ATF_REQUIRE(kev[0].fflags == 0);
137 	ATF_REQUIRE(kev[0].data == PIPE_BUF + 1);
138 	ATF_REQUIRE(kev[0].udata == 0);
139 
140 	ATF_REQUIRE(close(kq) == 0);
141 	ATF_REQUIRE(close(p[1]) == 0);
142 }
143 
144 ATF_TC_WITHOUT_HEAD(pipe_kqueue__closed_read_end);
145 ATF_TC_BODY(pipe_kqueue__closed_read_end, tc)
146 {
147 	int p[2] = { -1, -1 };
148 
149 	ATF_REQUIRE(pipe2(p, O_CLOEXEC | O_NONBLOCK) == 0);
150 	ATF_REQUIRE(p[0] >= 0);
151 	ATF_REQUIRE(p[1] >= 0);
152 
153 	ATF_REQUIRE(close(p[0]) == 0);
154 
155 	int kq = kqueue();
156 	ATF_REQUIRE(kq >= 0);
157 
158 	struct kevent kev[32];
159 	EV_SET(&kev[0], p[1], EVFILT_READ, EV_ADD | EV_CLEAR | EV_RECEIPT, /**/
160 	    0, 0, 0);
161 	EV_SET(&kev[1], p[1], EVFILT_WRITE, EV_ADD | EV_CLEAR | EV_RECEIPT, /**/
162 	    0, 0, 0);
163 
164 	/*
165 	 * Trying to register EVFILT_WRITE when the pipe is closed leads to an
166 	 * EPIPE error.
167 	 */
168 
169 	ATF_REQUIRE(kevent(kq, kev, 2, kev, 2, NULL) == 2);
170 	ATF_REQUIRE((kev[0].flags & EV_ERROR) != 0);
171 	ATF_REQUIRE(kev[0].data == 0);
172 	ATF_REQUIRE((kev[1].flags & EV_ERROR) != 0);
173 	ATF_REQUIRE(kev[1].data == EPIPE);
174 
175 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
176 	    &(struct timespec) { 0, 0 }) == 1);
177 	ATF_REQUIRE(kev[0].ident == (uintptr_t)p[1]);
178 	ATF_REQUIRE(kev[0].filter == EVFILT_READ);
179 	ATF_REQUIRE(kev[0].flags == (EV_EOF | EV_CLEAR | EV_RECEIPT));
180 	ATF_REQUIRE(kev[0].fflags == 0);
181 	ATF_REQUIRE(kev[0].data == 0);
182 	ATF_REQUIRE(kev[0].udata == 0);
183 
184 	ATF_REQUIRE(close(kq) == 0);
185 	ATF_REQUIRE(close(p[1]) == 0);
186 }
187 
188 ATF_TC_WITHOUT_HEAD(pipe_kqueue__closed_read_end_register_before_close);
189 ATF_TC_BODY(pipe_kqueue__closed_read_end_register_before_close, tc)
190 {
191 	int p[2] = { -1, -1 };
192 
193 	ATF_REQUIRE(pipe2(p, O_CLOEXEC | O_NONBLOCK) == 0);
194 	ATF_REQUIRE(p[0] >= 0);
195 	ATF_REQUIRE(p[1] >= 0);
196 
197 	int kq = kqueue();
198 	ATF_REQUIRE(kq >= 0);
199 
200 	struct kevent kev[32];
201 	EV_SET(&kev[0], p[1], EVFILT_READ, EV_ADD | EV_CLEAR | EV_RECEIPT, /**/
202 	    0, 0, 0);
203 	EV_SET(&kev[1], p[1], EVFILT_WRITE, EV_ADD | EV_CLEAR | EV_RECEIPT, /**/
204 	    0, 0, 0);
205 
206 	/*
207 	 * Registering EVFILT_WRITE before the pipe is closed leads to a
208 	 * EVFILT_WRITE event with EV_EOF set.
209 	 */
210 
211 	ATF_REQUIRE(kevent(kq, kev, 2, kev, 2, NULL) == 2);
212 	ATF_REQUIRE((kev[0].flags & EV_ERROR) != 0);
213 	ATF_REQUIRE(kev[0].data == 0);
214 	ATF_REQUIRE((kev[1].flags & EV_ERROR) != 0);
215 	ATF_REQUIRE(kev[1].data == 0);
216 
217 	ATF_REQUIRE(close(p[0]) == 0);
218 
219 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
220 	    &(struct timespec) { 0, 0 }) == 2);
221 	{
222 		ATF_REQUIRE(kev[0].ident == (uintptr_t)p[1]);
223 		ATF_REQUIRE(kev[0].filter == EVFILT_WRITE);
224 		ATF_REQUIRE(kev[0].flags ==
225 		    (EV_EOF | EV_CLEAR | EV_ONESHOT | EV_RECEIPT));
226 		ATF_REQUIRE(kev[0].fflags == 0);
227 		ATF_REQUIRE(kev[0].data == 16384);
228 		ATF_REQUIRE(kev[0].udata == 0);
229 	}
230 	{
231 		ATF_REQUIRE(kev[1].ident == (uintptr_t)p[1]);
232 		ATF_REQUIRE(kev[1].filter == EVFILT_READ);
233 		ATF_REQUIRE(kev[1].flags == (EV_EOF | EV_CLEAR | EV_RECEIPT));
234 		ATF_REQUIRE(kev[1].fflags == 0);
235 		ATF_REQUIRE(kev[1].data == 0);
236 		ATF_REQUIRE(kev[1].udata == 0);
237 	}
238 
239 	ATF_REQUIRE(close(kq) == 0);
240 	ATF_REQUIRE(close(p[1]) == 0);
241 }
242 
243 ATF_TC_WITHOUT_HEAD(pipe_kqueue__closed_write_end);
244 ATF_TC_BODY(pipe_kqueue__closed_write_end, tc)
245 {
246 	int p[2] = { -1, -1 };
247 
248 	ATF_REQUIRE(pipe2(p, O_CLOEXEC | O_NONBLOCK) == 0);
249 	ATF_REQUIRE(p[0] >= 0);
250 	ATF_REQUIRE(p[1] >= 0);
251 
252 	char c = 0;
253 	ssize_t r;
254 	while ((r = write(p[1], &c, 1)) == 1) {
255 	}
256 	ATF_REQUIRE(r < 0);
257 	ATF_REQUIRE(errno == EAGAIN || errno == EWOULDBLOCK);
258 
259 	ATF_REQUIRE(close(p[1]) == 0);
260 
261 	int kq = kqueue();
262 	ATF_REQUIRE(kq >= 0);
263 
264 	struct kevent kev[32];
265 	EV_SET(&kev[0], p[0], EVFILT_READ, EV_ADD | EV_CLEAR | EV_RECEIPT, /**/
266 	    0, 0, 0);
267 	EV_SET(&kev[1], p[0], EVFILT_WRITE, EV_ADD | EV_CLEAR | EV_RECEIPT, /**/
268 	    0, 0, 0);
269 
270 	/*
271 	 * Trying to register EVFILT_WRITE when the pipe is closed leads to an
272 	 * EPIPE error.
273 	 */
274 
275 	ATF_REQUIRE(kevent(kq, kev, 2, kev, 2, NULL) == 2);
276 	ATF_REQUIRE((kev[0].flags & EV_ERROR) != 0);
277 	ATF_REQUIRE(kev[0].data == 0);
278 	ATF_REQUIRE((kev[1].flags & EV_ERROR) != 0);
279 	ATF_REQUIRE(kev[1].data == EPIPE);
280 
281 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
282 	    &(struct timespec) { 0, 0 }) == 1);
283 	ATF_REQUIRE(kev[0].ident == (uintptr_t)p[0]);
284 	ATF_REQUIRE(kev[0].filter == EVFILT_READ);
285 	ATF_REQUIRE(kev[0].flags == (EV_EOF | EV_CLEAR | EV_RECEIPT));
286 	ATF_REQUIRE(kev[0].fflags == 0);
287 	ATF_REQUIRE(kev[0].data == 65536);
288 	ATF_REQUIRE(kev[0].udata == 0);
289 
290 	ATF_REQUIRE(close(kq) == 0);
291 	ATF_REQUIRE(close(p[0]) == 0);
292 }
293 
294 ATF_TC_WITHOUT_HEAD(pipe_kqueue__closed_write_end_register_before_close);
295 ATF_TC_BODY(pipe_kqueue__closed_write_end_register_before_close, tc)
296 {
297 	int p[2] = { -1, -1 };
298 
299 	ATF_REQUIRE(pipe2(p, O_CLOEXEC | O_NONBLOCK) == 0);
300 	ATF_REQUIRE(p[0] >= 0);
301 	ATF_REQUIRE(p[1] >= 0);
302 
303 	int kq = kqueue();
304 	ATF_REQUIRE(kq >= 0);
305 
306 	struct kevent kev[32];
307 	EV_SET(&kev[0], p[0], EVFILT_READ, EV_ADD | EV_CLEAR | EV_RECEIPT, /**/
308 	    0, 0, 0);
309 	EV_SET(&kev[1], p[0], EVFILT_WRITE, EV_ADD | EV_CLEAR | EV_RECEIPT, /**/
310 	    0, 0, 0);
311 
312 	/*
313 	 * Registering EVFILT_WRITE before the pipe is closed leads to a
314 	 * EVFILT_WRITE event with EV_EOF set.
315 	 */
316 
317 	ATF_REQUIRE(kevent(kq, kev, 2, kev, 2, NULL) == 2);
318 	ATF_REQUIRE((kev[0].flags & EV_ERROR) != 0);
319 	ATF_REQUIRE(kev[0].data == 0);
320 	ATF_REQUIRE((kev[1].flags & EV_ERROR) != 0);
321 	ATF_REQUIRE(kev[1].data == 0);
322 
323 	char c = 0;
324 	ssize_t r;
325 	while ((r = write(p[1], &c, 1)) == 1) {
326 	}
327 	ATF_REQUIRE(r < 0);
328 	ATF_REQUIRE(errno == EAGAIN || errno == EWOULDBLOCK);
329 
330 	ATF_REQUIRE(close(p[1]) == 0);
331 
332 	ATF_REQUIRE(kevent(kq, NULL, 0, kev, nitems(kev),
333 	    &(struct timespec) { 0, 0 }) == 2);
334 	{
335 		ATF_REQUIRE(kev[0].ident == (uintptr_t)p[0]);
336 		ATF_REQUIRE(kev[0].filter == EVFILT_WRITE);
337 		ATF_REQUIRE(kev[0].flags ==
338 		    (EV_EOF | EV_CLEAR | EV_ONESHOT | EV_RECEIPT));
339 		ATF_REQUIRE(kev[0].fflags == 0);
340 		ATF_REQUIRE(kev[0].data == 4096 ||
341 		    kev[0].data == 512 /* on FreeBSD 11.3 */);
342 		ATF_REQUIRE(kev[0].udata == 0);
343 	}
344 	{
345 		ATF_REQUIRE(kev[1].ident == (uintptr_t)p[0]);
346 		ATF_REQUIRE(kev[1].filter == EVFILT_READ);
347 		ATF_REQUIRE(kev[1].flags == (EV_EOF | EV_CLEAR | EV_RECEIPT));
348 		ATF_REQUIRE(kev[1].fflags == 0);
349 		ATF_REQUIRE(kev[1].data == 65536);
350 		ATF_REQUIRE(kev[1].udata == 0);
351 	}
352 
353 	ATF_REQUIRE(close(kq) == 0);
354 	ATF_REQUIRE(close(p[0]) == 0);
355 }
356 
357 ATF_TP_ADD_TCS(tp)
358 {
359 	ATF_TP_ADD_TC(tp, pipe_kqueue__write_end);
360 	ATF_TP_ADD_TC(tp, pipe_kqueue__closed_read_end);
361 	ATF_TP_ADD_TC(tp, pipe_kqueue__closed_read_end_register_before_close);
362 	ATF_TP_ADD_TC(tp, pipe_kqueue__closed_write_end);
363 	ATF_TP_ADD_TC(tp, pipe_kqueue__closed_write_end_register_before_close);
364 
365 	return atf_no_error();
366 }
367