Allow NULL queue to writev_send
[samba.git] / lib / async_req / async_sock.c
1 /*
2    Unix SMB/CIFS implementation.
3    async socket syscalls
4    Copyright (C) Volker Lendecke 2008
5
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 3 of the License, or
9    (at your option) any later version.
10
11    This program is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with this program.  If not, see <http://www.gnu.org/licenses/>.
18 */
19
20 #include "includes.h"
21 #include "lib/talloc/talloc.h"
22 #include "lib/tevent/tevent.h"
23 #include "lib/async_req/async_req.h"
24 #include "lib/async_req/async_sock.h"
25 #include "lib/util/tevent_unix.h"
26 #include <fcntl.h>
27
28 #ifndef TALLOC_FREE
29 #define TALLOC_FREE(ctx) do { talloc_free(ctx); ctx=NULL; } while(0)
30 #endif
31
32 /**
33  * @brief Map async_req states to unix-style errnos
34  * @param[in]  req      The async req to get the state from
35  * @param[out] err      Pointer to take the unix-style errno
36  *
37  * @return true if the async_req is in an error state, false otherwise
38  */
39
40 bool async_req_is_errno(struct async_req *req, int *err)
41 {
42         enum async_req_state state;
43         uint64_t error;
44
45         if (!async_req_is_error(req, &state, &error)) {
46                 return false;
47         }
48
49         switch (state) {
50         case ASYNC_REQ_USER_ERROR:
51                 *err = (int)error;
52                 break;
53         case ASYNC_REQ_TIMED_OUT:
54 #ifdef ETIMEDOUT
55                 *err = ETIMEDOUT;
56 #else
57                 *err = EAGAIN;
58 #endif
59                 break;
60         case ASYNC_REQ_NO_MEMORY:
61                 *err = ENOMEM;
62                 break;
63         default:
64                 *err = EIO;
65                 break;
66         }
67         return true;
68 }
69
70 int async_req_simple_recv_errno(struct async_req *req)
71 {
72         int err;
73
74         if (async_req_is_errno(req, &err)) {
75                 return err;
76         }
77
78         return 0;
79 }
80
81 struct async_send_state {
82         int fd;
83         const void *buf;
84         size_t len;
85         int flags;
86         ssize_t sent;
87 };
88
89 static void async_send_handler(struct tevent_context *ev,
90                                struct tevent_fd *fde,
91                                uint16_t flags, void *private_data);
92
93 struct tevent_req *async_send_send(TALLOC_CTX *mem_ctx,
94                                    struct tevent_context *ev,
95                                    int fd, const void *buf, size_t len,
96                                    int flags)
97 {
98         struct tevent_req *result;
99         struct async_send_state *state;
100         struct tevent_fd *fde;
101
102         result = tevent_req_create(mem_ctx, &state, struct async_send_state);
103         if (result == NULL) {
104                 return result;
105         }
106         state->fd = fd;
107         state->buf = buf;
108         state->len = len;
109         state->flags = flags;
110
111         fde = tevent_add_fd(ev, state, fd, TEVENT_FD_WRITE, async_send_handler,
112                             result);
113         if (fde == NULL) {
114                 TALLOC_FREE(result);
115                 return NULL;
116         }
117         return result;
118 }
119
120 static void async_send_handler(struct tevent_context *ev,
121                                struct tevent_fd *fde,
122                                uint16_t flags, void *private_data)
123 {
124         struct tevent_req *req = talloc_get_type_abort(
125                 private_data, struct tevent_req);
126         struct async_send_state *state =
127                 tevent_req_data(req, struct async_send_state);
128
129         state->sent = send(state->fd, state->buf, state->len, state->flags);
130         if (state->sent == -1) {
131                 tevent_req_error(req, errno);
132                 return;
133         }
134         tevent_req_done(req);
135 }
136
137 ssize_t async_send_recv(struct tevent_req *req, int *perrno)
138 {
139         struct async_send_state *state =
140                 tevent_req_data(req, struct async_send_state);
141
142         if (tevent_req_is_unix_error(req, perrno)) {
143                 return -1;
144         }
145         return state->sent;
146 }
147
148 struct async_recv_state {
149         int fd;
150         void *buf;
151         size_t len;
152         int flags;
153         ssize_t received;
154 };
155
156 static void async_recv_handler(struct tevent_context *ev,
157                                struct tevent_fd *fde,
158                                uint16_t flags, void *private_data);
159
160 struct tevent_req *async_recv_send(TALLOC_CTX *mem_ctx,
161                                    struct tevent_context *ev,
162                                    int fd, void *buf, size_t len, int flags)
163 {
164         struct tevent_req *result;
165         struct async_recv_state *state;
166         struct tevent_fd *fde;
167
168         result = tevent_req_create(mem_ctx, &state, struct async_recv_state);
169         if (result == NULL) {
170                 return result;
171         }
172         state->fd = fd;
173         state->buf = buf;
174         state->len = len;
175         state->flags = flags;
176
177         fde = tevent_add_fd(ev, state, fd, TEVENT_FD_READ, async_recv_handler,
178                             result);
179         if (fde == NULL) {
180                 TALLOC_FREE(result);
181                 return NULL;
182         }
183         return result;
184 }
185
186 static void async_recv_handler(struct tevent_context *ev,
187                                struct tevent_fd *fde,
188                                uint16_t flags, void *private_data)
189 {
190         struct tevent_req *req = talloc_get_type_abort(
191                 private_data, struct tevent_req);
192         struct async_recv_state *state =
193                 tevent_req_data(req, struct async_recv_state);
194
195         state->received = recv(state->fd, state->buf, state->len,
196                                state->flags);
197         if (state->received == -1) {
198                 tevent_req_error(req, errno);
199                 return;
200         }
201         tevent_req_done(req);
202 }
203
204 ssize_t async_recv_recv(struct tevent_req *req, int *perrno)
205 {
206         struct async_recv_state *state =
207                 tevent_req_data(req, struct async_recv_state);
208
209         if (tevent_req_is_unix_error(req, perrno)) {
210                 return -1;
211         }
212         return state->received;
213 }
214
215 struct async_connect_state {
216         int fd;
217         int result;
218         int sys_errno;
219         long old_sockflags;
220 };
221
222 static void async_connect_connected(struct tevent_context *ev,
223                                     struct tevent_fd *fde, uint16_t flags,
224                                     void *priv);
225
226 /**
227  * @brief async version of connect(2)
228  * @param[in] mem_ctx   The memory context to hang the result off
229  * @param[in] ev        The event context to work from
230  * @param[in] fd        The socket to recv from
231  * @param[in] address   Where to connect?
232  * @param[in] address_len Length of *address
233  * @retval The async request
234  *
235  * This function sets the socket into non-blocking state to be able to call
236  * connect in an async state. This will be reset when the request is finished.
237  */
238
239 struct tevent_req *async_connect_send(TALLOC_CTX *mem_ctx,
240                                       struct tevent_context *ev,
241                                       int fd, const struct sockaddr *address,
242                                       socklen_t address_len)
243 {
244         struct tevent_req *result;
245         struct async_connect_state *state;
246         struct tevent_fd *fde;
247
248         result = tevent_req_create(
249                 mem_ctx, &state, struct async_connect_state);
250         if (result == NULL) {
251                 return NULL;
252         }
253
254         /**
255          * We have to set the socket to nonblocking for async connect(2). Keep
256          * the old sockflags around.
257          */
258
259         state->fd = fd;
260         state->sys_errno = 0;
261
262         state->old_sockflags = fcntl(fd, F_GETFL, 0);
263         if (state->old_sockflags == -1) {
264                 goto post_errno;
265         }
266
267         set_blocking(fd, false);
268
269         state->result = connect(fd, address, address_len);
270         if (state->result == 0) {
271                 tevent_req_done(result);
272                 goto done;
273         }
274
275         /**
276          * A number of error messages show that something good is progressing
277          * and that we have to wait for readability.
278          *
279          * If none of them are present, bail out.
280          */
281
282         if (!(errno == EINPROGRESS || errno == EALREADY ||
283 #ifdef EISCONN
284               errno == EISCONN ||
285 #endif
286               errno == EAGAIN || errno == EINTR)) {
287                 state->sys_errno = errno;
288                 goto post_errno;
289         }
290
291         fde = tevent_add_fd(ev, state, fd, TEVENT_FD_READ | TEVENT_FD_WRITE,
292                            async_connect_connected, result);
293         if (fde == NULL) {
294                 state->sys_errno = ENOMEM;
295                 goto post_errno;
296         }
297         return result;
298
299  post_errno:
300         tevent_req_error(result, state->sys_errno);
301  done:
302         fcntl(fd, F_SETFL, state->old_sockflags);
303         return tevent_req_post(result, ev);
304 }
305
306 /**
307  * fde event handler for connect(2)
308  * @param[in] ev        The event context that sent us here
309  * @param[in] fde       The file descriptor event associated with the connect
310  * @param[in] flags     Indicate read/writeability of the socket
311  * @param[in] priv      private data, "struct async_req *" in this case
312  */
313
314 static void async_connect_connected(struct tevent_context *ev,
315                                     struct tevent_fd *fde, uint16_t flags,
316                                     void *priv)
317 {
318         struct tevent_req *req = talloc_get_type_abort(
319                 priv, struct tevent_req);
320         struct async_connect_state *state =
321                 tevent_req_data(req, struct async_connect_state);
322
323         TALLOC_FREE(fde);
324
325         /*
326          * Stevens, Network Programming says that if there's a
327          * successful connect, the socket is only writable. Upon an
328          * error, it's both readable and writable.
329          */
330         if ((flags & (TEVENT_FD_READ|TEVENT_FD_WRITE))
331             == (TEVENT_FD_READ|TEVENT_FD_WRITE)) {
332                 int sockerr;
333                 socklen_t err_len = sizeof(sockerr);
334
335                 if (getsockopt(state->fd, SOL_SOCKET, SO_ERROR,
336                                (void *)&sockerr, &err_len) == 0) {
337                         errno = sockerr;
338                 }
339
340                 state->sys_errno = errno;
341
342                 DEBUG(10, ("connect returned %s\n", strerror(errno)));
343
344                 fcntl(state->fd, F_SETFL, state->old_sockflags);
345                 tevent_req_error(req, state->sys_errno);
346                 return;
347         }
348
349         state->sys_errno = 0;
350         tevent_req_done(req);
351 }
352
353 int async_connect_recv(struct tevent_req *req, int *perrno)
354 {
355         struct async_connect_state *state =
356                 tevent_req_data(req, struct async_connect_state);
357         int err;
358
359         fcntl(state->fd, F_SETFL, state->old_sockflags);
360
361         if (tevent_req_is_unix_error(req, &err)) {
362                 *perrno = err;
363                 return -1;
364         }
365
366         if (state->sys_errno == 0) {
367                 return 0;
368         }
369
370         *perrno = state->sys_errno;
371         return -1;
372 }
373
374 struct writev_state {
375         struct tevent_context *ev;
376         int fd;
377         struct iovec *iov;
378         int count;
379         size_t total_size;
380 };
381
382 static void writev_trigger(struct tevent_req *req, void *private_data);
383 static void writev_handler(struct tevent_context *ev, struct tevent_fd *fde,
384                            uint16_t flags, void *private_data);
385
386 struct tevent_req *writev_send(TALLOC_CTX *mem_ctx, struct tevent_context *ev,
387                                struct tevent_queue *queue, int fd,
388                                struct iovec *iov, int count)
389 {
390         struct tevent_req *req;
391         struct writev_state *state;
392
393         req = tevent_req_create(mem_ctx, &state, struct writev_state);
394         if (req == NULL) {
395                 return NULL;
396         }
397         state->ev = ev;
398         state->fd = fd;
399         state->total_size = 0;
400         state->count = count;
401         state->iov = (struct iovec *)talloc_memdup(
402                 state, iov, sizeof(struct iovec) * count);
403         if (state->iov == NULL) {
404                 goto fail;
405         }
406
407         if (queue == NULL) {
408                 struct tevent_fd *fde;
409                 fde = tevent_add_fd(state->ev, state, state->fd,
410                                     TEVENT_FD_WRITE, writev_handler, req);
411                 if (tevent_req_nomem(fde, req)) {
412                         return tevent_req_post(req, ev);
413                 }
414                 return req;
415         }
416
417         if (!tevent_queue_add(queue, ev, req, writev_trigger, NULL)) {
418                 goto fail;
419         }
420         return req;
421  fail:
422         TALLOC_FREE(req);
423         return NULL;
424 }
425
426 static void writev_trigger(struct tevent_req *req, void *private_data)
427 {
428         struct writev_state *state = tevent_req_data(req, struct writev_state);
429         struct tevent_fd *fde;
430
431         fde = tevent_add_fd(state->ev, state, state->fd, TEVENT_FD_WRITE,
432                             writev_handler, req);
433         if (fde == NULL) {
434                 tevent_req_error(req, ENOMEM);
435         }
436 }
437
438 static void writev_handler(struct tevent_context *ev, struct tevent_fd *fde,
439                            uint16_t flags, void *private_data)
440 {
441         struct tevent_req *req = talloc_get_type_abort(
442                 private_data, struct tevent_req);
443         struct writev_state *state =
444                 tevent_req_data(req, struct writev_state);
445         size_t to_write, written;
446         int i;
447
448         to_write = 0;
449
450         for (i=0; i<state->count; i++) {
451                 to_write += state->iov[i].iov_len;
452         }
453
454         written = sys_writev(state->fd, state->iov, state->count);
455         if (written == -1) {
456                 tevent_req_error(req, errno);
457                 return;
458         }
459         if (written == 0) {
460                 tevent_req_error(req, EPIPE);
461                 return;
462         }
463         state->total_size += written;
464
465         if (written == to_write) {
466                 tevent_req_done(req);
467                 return;
468         }
469
470         /*
471          * We've written less than we were asked to, drop stuff from
472          * state->iov.
473          */
474
475         while (written > 0) {
476                 if (written < state->iov[0].iov_len) {
477                         state->iov[0].iov_base =
478                                 (char *)state->iov[0].iov_base + written;
479                         state->iov[0].iov_len -= written;
480                         break;
481                 }
482                 written -= state->iov[0].iov_len;
483                 state->iov += 1;
484                 state->count -= 1;
485         }
486 }
487
488 ssize_t writev_recv(struct tevent_req *req, int *perrno)
489 {
490         struct writev_state *state =
491                 tevent_req_data(req, struct writev_state);
492
493         if (tevent_req_is_unix_error(req, perrno)) {
494                 return -1;
495         }
496         return state->total_size;
497 }
498
499 struct read_packet_state {
500         int fd;
501         uint8_t *buf;
502         size_t nread;
503         ssize_t (*more)(uint8_t *buf, size_t buflen, void *private_data);
504         void *private_data;
505 };
506
507 static void read_packet_handler(struct tevent_context *ev,
508                                 struct tevent_fd *fde,
509                                 uint16_t flags, void *private_data);
510
511 struct tevent_req *read_packet_send(TALLOC_CTX *mem_ctx,
512                                     struct tevent_context *ev,
513                                     int fd, size_t initial,
514                                     ssize_t (*more)(uint8_t *buf,
515                                                     size_t buflen,
516                                                     void *private_data),
517                                     void *private_data)
518 {
519         struct tevent_req *result;
520         struct read_packet_state *state;
521         struct tevent_fd *fde;
522
523         result = tevent_req_create(mem_ctx, &state, struct read_packet_state);
524         if (result == NULL) {
525                 return NULL;
526         }
527         state->fd = fd;
528         state->nread = 0;
529         state->more = more;
530         state->private_data = private_data;
531
532         state->buf = talloc_array(state, uint8_t, initial);
533         if (state->buf == NULL) {
534                 goto fail;
535         }
536
537         fde = tevent_add_fd(ev, state, fd, TEVENT_FD_READ, read_packet_handler,
538                             result);
539         if (fde == NULL) {
540                 goto fail;
541         }
542         return result;
543  fail:
544         TALLOC_FREE(result);
545         return NULL;
546 }
547
548 static void read_packet_handler(struct tevent_context *ev,
549                                 struct tevent_fd *fde,
550                                 uint16_t flags, void *private_data)
551 {
552         struct tevent_req *req = talloc_get_type_abort(
553                 private_data, struct tevent_req);
554         struct read_packet_state *state =
555                 tevent_req_data(req, struct read_packet_state);
556         size_t total = talloc_get_size(state->buf);
557         ssize_t nread, more;
558         uint8_t *tmp;
559
560         nread = recv(state->fd, state->buf+state->nread, total-state->nread,
561                      0);
562         if (nread == -1) {
563                 tevent_req_error(req, errno);
564                 return;
565         }
566         if (nread == 0) {
567                 tevent_req_error(req, EPIPE);
568                 return;
569         }
570
571         state->nread += nread;
572         if (state->nread < total) {
573                 /* Come back later */
574                 return;
575         }
576
577         /*
578          * We got what was initially requested. See if "more" asks for -- more.
579          */
580         if (state->more == NULL) {
581                 /* Nobody to ask, this is a async read_data */
582                 tevent_req_done(req);
583                 return;
584         }
585
586         more = state->more(state->buf, total, state->private_data);
587         if (more == -1) {
588                 /* We got an invalid packet, tell the caller */
589                 tevent_req_error(req, EIO);
590                 return;
591         }
592         if (more == 0) {
593                 /* We're done, full packet received */
594                 tevent_req_done(req);
595                 return;
596         }
597
598         tmp = TALLOC_REALLOC_ARRAY(state, state->buf, uint8_t, total+more);
599         if (tevent_req_nomem(tmp, req)) {
600                 return;
601         }
602         state->buf = tmp;
603 }
604
605 ssize_t read_packet_recv(struct tevent_req *req, TALLOC_CTX *mem_ctx,
606                          uint8_t **pbuf, int *perrno)
607 {
608         struct read_packet_state *state =
609                 tevent_req_data(req, struct read_packet_state);
610
611         if (tevent_req_is_unix_error(req, perrno)) {
612                 return -1;
613         }
614         *pbuf = talloc_move(mem_ctx, &state->buf);
615         return talloc_get_size(*pbuf);
616 }