xref: /qemu/nbd/server.c (revision ac132d05)
1 /*
2  *  Copyright Red Hat
3  *  Copyright (C) 2005  Anthony Liguori <anthony@codemonkey.ws>
4  *
5  *  Network Block Device Server Side
6  *
7  *  This program is free software; you can redistribute it and/or modify
8  *  it under the terms of the GNU General Public License as published by
9  *  the Free Software Foundation; under version 2 of the License.
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 "qemu/osdep.h"
21 
22 #include "block/block_int.h"
23 #include "block/export.h"
24 #include "block/dirty-bitmap.h"
25 #include "qapi/error.h"
26 #include "qemu/queue.h"
27 #include "trace.h"
28 #include "nbd-internal.h"
29 #include "qemu/units.h"
30 #include "qemu/memalign.h"
31 
32 #define NBD_META_ID_BASE_ALLOCATION 0
33 #define NBD_META_ID_ALLOCATION_DEPTH 1
34 /* Dirty bitmaps use 'NBD_META_ID_DIRTY_BITMAP + i', so keep this id last. */
35 #define NBD_META_ID_DIRTY_BITMAP 2
36 
37 /*
38  * NBD_MAX_BLOCK_STATUS_EXTENTS: 1 MiB of extents data. An empirical
39  * constant. If an increase is needed, note that the NBD protocol
40  * recommends no larger than 32 mb, so that the client won't consider
41  * the reply as a denial of service attack.
42  */
43 #define NBD_MAX_BLOCK_STATUS_EXTENTS (1 * MiB / 8)
44 
45 static int system_errno_to_nbd_errno(int err)
46 {
47     switch (err) {
48     case 0:
49         return NBD_SUCCESS;
50     case EPERM:
51     case EROFS:
52         return NBD_EPERM;
53     case EIO:
54         return NBD_EIO;
55     case ENOMEM:
56         return NBD_ENOMEM;
57 #ifdef EDQUOT
58     case EDQUOT:
59 #endif
60     case EFBIG:
61     case ENOSPC:
62         return NBD_ENOSPC;
63     case EOVERFLOW:
64         return NBD_EOVERFLOW;
65     case ENOTSUP:
66 #if ENOTSUP != EOPNOTSUPP
67     case EOPNOTSUPP:
68 #endif
69         return NBD_ENOTSUP;
70     case ESHUTDOWN:
71         return NBD_ESHUTDOWN;
72     case EINVAL:
73     default:
74         return NBD_EINVAL;
75     }
76 }
77 
78 /* Definitions for opaque data types */
79 
80 typedef struct NBDRequestData NBDRequestData;
81 
82 struct NBDRequestData {
83     NBDClient *client;
84     uint8_t *data;
85     bool complete;
86 };
87 
88 struct NBDExport {
89     BlockExport common;
90 
91     char *name;
92     char *description;
93     uint64_t size;
94     uint16_t nbdflags;
95     QTAILQ_HEAD(, NBDClient) clients;
96     QTAILQ_ENTRY(NBDExport) next;
97 
98     BlockBackend *eject_notifier_blk;
99     Notifier eject_notifier;
100 
101     bool allocation_depth;
102     BdrvDirtyBitmap **export_bitmaps;
103     size_t nr_export_bitmaps;
104 };
105 
106 static QTAILQ_HEAD(, NBDExport) exports = QTAILQ_HEAD_INITIALIZER(exports);
107 
108 /* NBDExportMetaContexts represents a list of contexts to be exported,
109  * as selected by NBD_OPT_SET_META_CONTEXT. Also used for
110  * NBD_OPT_LIST_META_CONTEXT. */
111 typedef struct NBDExportMetaContexts {
112     NBDExport *exp;
113     size_t count; /* number of negotiated contexts */
114     bool base_allocation; /* export base:allocation context (block status) */
115     bool allocation_depth; /* export qemu:allocation-depth */
116     bool *bitmaps; /*
117                     * export qemu:dirty-bitmap:<export bitmap name>,
118                     * sized by exp->nr_export_bitmaps
119                     */
120 } NBDExportMetaContexts;
121 
122 struct NBDClient {
123     int refcount;
124     void (*close_fn)(NBDClient *client, bool negotiated);
125 
126     NBDExport *exp;
127     QCryptoTLSCreds *tlscreds;
128     char *tlsauthz;
129     QIOChannelSocket *sioc; /* The underlying data channel */
130     QIOChannel *ioc; /* The current I/O channel which may differ (eg TLS) */
131 
132     Coroutine *recv_coroutine;
133 
134     CoMutex send_lock;
135     Coroutine *send_coroutine;
136 
137     bool read_yielding;
138     bool quiescing;
139 
140     QTAILQ_ENTRY(NBDClient) next;
141     int nb_requests;
142     bool closing;
143 
144     uint32_t check_align; /* If non-zero, check for aligned client requests */
145 
146     NBDMode mode;
147     NBDExportMetaContexts export_meta;
148 
149     uint32_t opt; /* Current option being negotiated */
150     uint32_t optlen; /* remaining length of data in ioc for the option being
151                         negotiated now */
152 };
153 
154 static void nbd_client_receive_next_request(NBDClient *client);
155 
156 /* Basic flow for negotiation
157 
158    Server         Client
159    Negotiate
160 
161    or
162 
163    Server         Client
164    Negotiate #1
165                   Option
166    Negotiate #2
167 
168    ----
169 
170    followed by
171 
172    Server         Client
173                   Request
174    Response
175                   Request
176    Response
177                   ...
178    ...
179                   Request (type == 2)
180 
181 */
182 
183 static inline void set_be_option_rep(NBDOptionReply *rep, uint32_t option,
184                                      uint32_t type, uint32_t length)
185 {
186     stq_be_p(&rep->magic, NBD_REP_MAGIC);
187     stl_be_p(&rep->option, option);
188     stl_be_p(&rep->type, type);
189     stl_be_p(&rep->length, length);
190 }
191 
192 /* Send a reply header, including length, but no payload.
193  * Return -errno on error, 0 on success. */
194 static int nbd_negotiate_send_rep_len(NBDClient *client, uint32_t type,
195                                       uint32_t len, Error **errp)
196 {
197     NBDOptionReply rep;
198 
199     trace_nbd_negotiate_send_rep_len(client->opt, nbd_opt_lookup(client->opt),
200                                      type, nbd_rep_lookup(type), len);
201 
202     assert(len < NBD_MAX_BUFFER_SIZE);
203 
204     set_be_option_rep(&rep, client->opt, type, len);
205     return nbd_write(client->ioc, &rep, sizeof(rep), errp);
206 }
207 
208 /* Send a reply header with default 0 length.
209  * Return -errno on error, 0 on success. */
210 static int nbd_negotiate_send_rep(NBDClient *client, uint32_t type,
211                                   Error **errp)
212 {
213     return nbd_negotiate_send_rep_len(client, type, 0, errp);
214 }
215 
216 /* Send an error reply.
217  * Return -errno on error, 0 on success. */
218 static int G_GNUC_PRINTF(4, 0)
219 nbd_negotiate_send_rep_verr(NBDClient *client, uint32_t type,
220                             Error **errp, const char *fmt, va_list va)
221 {
222     ERRP_GUARD();
223     g_autofree char *msg = NULL;
224     int ret;
225     size_t len;
226 
227     msg = g_strdup_vprintf(fmt, va);
228     len = strlen(msg);
229     assert(len < NBD_MAX_STRING_SIZE);
230     trace_nbd_negotiate_send_rep_err(msg);
231     ret = nbd_negotiate_send_rep_len(client, type, len, errp);
232     if (ret < 0) {
233         return ret;
234     }
235     if (nbd_write(client->ioc, msg, len, errp) < 0) {
236         error_prepend(errp, "write failed (error message): ");
237         return -EIO;
238     }
239 
240     return 0;
241 }
242 
243 /*
244  * Return a malloc'd copy of @name suitable for use in an error reply.
245  */
246 static char *
247 nbd_sanitize_name(const char *name)
248 {
249     if (strnlen(name, 80) < 80) {
250         return g_strdup(name);
251     }
252     /* XXX Should we also try to sanitize any control characters? */
253     return g_strdup_printf("%.80s...", name);
254 }
255 
256 /* Send an error reply.
257  * Return -errno on error, 0 on success. */
258 static int G_GNUC_PRINTF(4, 5)
259 nbd_negotiate_send_rep_err(NBDClient *client, uint32_t type,
260                            Error **errp, const char *fmt, ...)
261 {
262     va_list va;
263     int ret;
264 
265     va_start(va, fmt);
266     ret = nbd_negotiate_send_rep_verr(client, type, errp, fmt, va);
267     va_end(va);
268     return ret;
269 }
270 
271 /* Drop remainder of the current option, and send a reply with the
272  * given error type and message. Return -errno on read or write
273  * failure; or 0 if connection is still live. */
274 static int G_GNUC_PRINTF(4, 0)
275 nbd_opt_vdrop(NBDClient *client, uint32_t type, Error **errp,
276               const char *fmt, va_list va)
277 {
278     int ret = nbd_drop(client->ioc, client->optlen, errp);
279 
280     client->optlen = 0;
281     if (!ret) {
282         ret = nbd_negotiate_send_rep_verr(client, type, errp, fmt, va);
283     }
284     return ret;
285 }
286 
287 static int G_GNUC_PRINTF(4, 5)
288 nbd_opt_drop(NBDClient *client, uint32_t type, Error **errp,
289              const char *fmt, ...)
290 {
291     int ret;
292     va_list va;
293 
294     va_start(va, fmt);
295     ret = nbd_opt_vdrop(client, type, errp, fmt, va);
296     va_end(va);
297 
298     return ret;
299 }
300 
301 static int G_GNUC_PRINTF(3, 4)
302 nbd_opt_invalid(NBDClient *client, Error **errp, const char *fmt, ...)
303 {
304     int ret;
305     va_list va;
306 
307     va_start(va, fmt);
308     ret = nbd_opt_vdrop(client, NBD_REP_ERR_INVALID, errp, fmt, va);
309     va_end(va);
310 
311     return ret;
312 }
313 
314 /* Read size bytes from the unparsed payload of the current option.
315  * If @check_nul, require that no NUL bytes appear in buffer.
316  * Return -errno on I/O error, 0 if option was completely handled by
317  * sending a reply about inconsistent lengths, or 1 on success. */
318 static int nbd_opt_read(NBDClient *client, void *buffer, size_t size,
319                         bool check_nul, Error **errp)
320 {
321     if (size > client->optlen) {
322         return nbd_opt_invalid(client, errp,
323                                "Inconsistent lengths in option %s",
324                                nbd_opt_lookup(client->opt));
325     }
326     client->optlen -= size;
327     if (qio_channel_read_all(client->ioc, buffer, size, errp) < 0) {
328         return -EIO;
329     }
330 
331     if (check_nul && strnlen(buffer, size) != size) {
332         return nbd_opt_invalid(client, errp,
333                                "Unexpected embedded NUL in option %s",
334                                nbd_opt_lookup(client->opt));
335     }
336     return 1;
337 }
338 
339 /* Drop size bytes from the unparsed payload of the current option.
340  * Return -errno on I/O error, 0 if option was completely handled by
341  * sending a reply about inconsistent lengths, or 1 on success. */
342 static int nbd_opt_skip(NBDClient *client, size_t size, Error **errp)
343 {
344     if (size > client->optlen) {
345         return nbd_opt_invalid(client, errp,
346                                "Inconsistent lengths in option %s",
347                                nbd_opt_lookup(client->opt));
348     }
349     client->optlen -= size;
350     return nbd_drop(client->ioc, size, errp) < 0 ? -EIO : 1;
351 }
352 
353 /* nbd_opt_read_name
354  *
355  * Read a string with the format:
356  *   uint32_t len     (<= NBD_MAX_STRING_SIZE)
357  *   len bytes string (not 0-terminated)
358  *
359  * On success, @name will be allocated.
360  * If @length is non-null, it will be set to the actual string length.
361  *
362  * Return -errno on I/O error, 0 if option was completely handled by
363  * sending a reply about inconsistent lengths, or 1 on success.
364  */
365 static int nbd_opt_read_name(NBDClient *client, char **name, uint32_t *length,
366                              Error **errp)
367 {
368     int ret;
369     uint32_t len;
370     g_autofree char *local_name = NULL;
371 
372     *name = NULL;
373     ret = nbd_opt_read(client, &len, sizeof(len), false, errp);
374     if (ret <= 0) {
375         return ret;
376     }
377     len = cpu_to_be32(len);
378 
379     if (len > NBD_MAX_STRING_SIZE) {
380         return nbd_opt_invalid(client, errp,
381                                "Invalid name length: %" PRIu32, len);
382     }
383 
384     local_name = g_malloc(len + 1);
385     ret = nbd_opt_read(client, local_name, len, true, errp);
386     if (ret <= 0) {
387         return ret;
388     }
389     local_name[len] = '\0';
390 
391     if (length) {
392         *length = len;
393     }
394     *name = g_steal_pointer(&local_name);
395 
396     return 1;
397 }
398 
399 /* Send a single NBD_REP_SERVER reply to NBD_OPT_LIST, including payload.
400  * Return -errno on error, 0 on success. */
401 static int nbd_negotiate_send_rep_list(NBDClient *client, NBDExport *exp,
402                                        Error **errp)
403 {
404     ERRP_GUARD();
405     size_t name_len, desc_len;
406     uint32_t len;
407     const char *name = exp->name ? exp->name : "";
408     const char *desc = exp->description ? exp->description : "";
409     QIOChannel *ioc = client->ioc;
410     int ret;
411 
412     trace_nbd_negotiate_send_rep_list(name, desc);
413     name_len = strlen(name);
414     desc_len = strlen(desc);
415     assert(name_len <= NBD_MAX_STRING_SIZE && desc_len <= NBD_MAX_STRING_SIZE);
416     len = name_len + desc_len + sizeof(len);
417     ret = nbd_negotiate_send_rep_len(client, NBD_REP_SERVER, len, errp);
418     if (ret < 0) {
419         return ret;
420     }
421 
422     len = cpu_to_be32(name_len);
423     if (nbd_write(ioc, &len, sizeof(len), errp) < 0) {
424         error_prepend(errp, "write failed (name length): ");
425         return -EINVAL;
426     }
427 
428     if (nbd_write(ioc, name, name_len, errp) < 0) {
429         error_prepend(errp, "write failed (name buffer): ");
430         return -EINVAL;
431     }
432 
433     if (nbd_write(ioc, desc, desc_len, errp) < 0) {
434         error_prepend(errp, "write failed (description buffer): ");
435         return -EINVAL;
436     }
437 
438     return 0;
439 }
440 
441 /* Process the NBD_OPT_LIST command, with a potential series of replies.
442  * Return -errno on error, 0 on success. */
443 static int nbd_negotiate_handle_list(NBDClient *client, Error **errp)
444 {
445     NBDExport *exp;
446     assert(client->opt == NBD_OPT_LIST);
447 
448     /* For each export, send a NBD_REP_SERVER reply. */
449     QTAILQ_FOREACH(exp, &exports, next) {
450         if (nbd_negotiate_send_rep_list(client, exp, errp)) {
451             return -EINVAL;
452         }
453     }
454     /* Finish with a NBD_REP_ACK. */
455     return nbd_negotiate_send_rep(client, NBD_REP_ACK, errp);
456 }
457 
458 static void nbd_check_meta_export(NBDClient *client)
459 {
460     if (client->exp != client->export_meta.exp) {
461         client->export_meta.count = 0;
462     }
463 }
464 
465 /* Send a reply to NBD_OPT_EXPORT_NAME.
466  * Return -errno on error, 0 on success. */
467 static int nbd_negotiate_handle_export_name(NBDClient *client, bool no_zeroes,
468                                             Error **errp)
469 {
470     ERRP_GUARD();
471     g_autofree char *name = NULL;
472     char buf[NBD_REPLY_EXPORT_NAME_SIZE] = "";
473     size_t len;
474     int ret;
475     uint16_t myflags;
476 
477     /* Client sends:
478         [20 ..  xx]   export name (length bytes)
479        Server replies:
480         [ 0 ..   7]   size
481         [ 8 ..   9]   export flags
482         [10 .. 133]   reserved     (0) [unless no_zeroes]
483      */
484     trace_nbd_negotiate_handle_export_name();
485     if (client->optlen > NBD_MAX_STRING_SIZE) {
486         error_setg(errp, "Bad length received");
487         return -EINVAL;
488     }
489     name = g_malloc(client->optlen + 1);
490     if (nbd_read(client->ioc, name, client->optlen, "export name", errp) < 0) {
491         return -EIO;
492     }
493     name[client->optlen] = '\0';
494     client->optlen = 0;
495 
496     trace_nbd_negotiate_handle_export_name_request(name);
497 
498     client->exp = nbd_export_find(name);
499     if (!client->exp) {
500         error_setg(errp, "export not found");
501         return -EINVAL;
502     }
503 
504     myflags = client->exp->nbdflags;
505     if (client->mode >= NBD_MODE_STRUCTURED) {
506         myflags |= NBD_FLAG_SEND_DF;
507     }
508     trace_nbd_negotiate_new_style_size_flags(client->exp->size, myflags);
509     stq_be_p(buf, client->exp->size);
510     stw_be_p(buf + 8, myflags);
511     len = no_zeroes ? 10 : sizeof(buf);
512     ret = nbd_write(client->ioc, buf, len, errp);
513     if (ret < 0) {
514         error_prepend(errp, "write failed: ");
515         return ret;
516     }
517 
518     QTAILQ_INSERT_TAIL(&client->exp->clients, client, next);
519     blk_exp_ref(&client->exp->common);
520     nbd_check_meta_export(client);
521 
522     return 0;
523 }
524 
525 /* Send a single NBD_REP_INFO, with a buffer @buf of @length bytes.
526  * The buffer does NOT include the info type prefix.
527  * Return -errno on error, 0 if ready to send more. */
528 static int nbd_negotiate_send_info(NBDClient *client,
529                                    uint16_t info, uint32_t length, void *buf,
530                                    Error **errp)
531 {
532     int rc;
533 
534     trace_nbd_negotiate_send_info(info, nbd_info_lookup(info), length);
535     rc = nbd_negotiate_send_rep_len(client, NBD_REP_INFO,
536                                     sizeof(info) + length, errp);
537     if (rc < 0) {
538         return rc;
539     }
540     info = cpu_to_be16(info);
541     if (nbd_write(client->ioc, &info, sizeof(info), errp) < 0) {
542         return -EIO;
543     }
544     if (nbd_write(client->ioc, buf, length, errp) < 0) {
545         return -EIO;
546     }
547     return 0;
548 }
549 
550 /* nbd_reject_length: Handle any unexpected payload.
551  * @fatal requests that we quit talking to the client, even if we are able
552  * to successfully send an error reply.
553  * Return:
554  * -errno  transmission error occurred or @fatal was requested, errp is set
555  * 0       error message successfully sent to client, errp is not set
556  */
557 static int nbd_reject_length(NBDClient *client, bool fatal, Error **errp)
558 {
559     int ret;
560 
561     assert(client->optlen);
562     ret = nbd_opt_invalid(client, errp, "option '%s' has unexpected length",
563                           nbd_opt_lookup(client->opt));
564     if (fatal && !ret) {
565         error_setg(errp, "option '%s' has unexpected length",
566                    nbd_opt_lookup(client->opt));
567         return -EINVAL;
568     }
569     return ret;
570 }
571 
572 /* Handle NBD_OPT_INFO and NBD_OPT_GO.
573  * Return -errno on error, 0 if ready for next option, and 1 to move
574  * into transmission phase.  */
575 static int nbd_negotiate_handle_info(NBDClient *client, Error **errp)
576 {
577     int rc;
578     g_autofree char *name = NULL;
579     NBDExport *exp;
580     uint16_t requests;
581     uint16_t request;
582     uint32_t namelen = 0;
583     bool sendname = false;
584     bool blocksize = false;
585     uint32_t sizes[3];
586     char buf[sizeof(uint64_t) + sizeof(uint16_t)];
587     uint32_t check_align = 0;
588     uint16_t myflags;
589 
590     /* Client sends:
591         4 bytes: L, name length (can be 0)
592         L bytes: export name
593         2 bytes: N, number of requests (can be 0)
594         N * 2 bytes: N requests
595     */
596     rc = nbd_opt_read_name(client, &name, &namelen, errp);
597     if (rc <= 0) {
598         return rc;
599     }
600     trace_nbd_negotiate_handle_export_name_request(name);
601 
602     rc = nbd_opt_read(client, &requests, sizeof(requests), false, errp);
603     if (rc <= 0) {
604         return rc;
605     }
606     requests = be16_to_cpu(requests);
607     trace_nbd_negotiate_handle_info_requests(requests);
608     while (requests--) {
609         rc = nbd_opt_read(client, &request, sizeof(request), false, errp);
610         if (rc <= 0) {
611             return rc;
612         }
613         request = be16_to_cpu(request);
614         trace_nbd_negotiate_handle_info_request(request,
615                                                 nbd_info_lookup(request));
616         /* We care about NBD_INFO_NAME and NBD_INFO_BLOCK_SIZE;
617          * everything else is either a request we don't know or
618          * something we send regardless of request */
619         switch (request) {
620         case NBD_INFO_NAME:
621             sendname = true;
622             break;
623         case NBD_INFO_BLOCK_SIZE:
624             blocksize = true;
625             break;
626         }
627     }
628     if (client->optlen) {
629         return nbd_reject_length(client, false, errp);
630     }
631 
632     exp = nbd_export_find(name);
633     if (!exp) {
634         g_autofree char *sane_name = nbd_sanitize_name(name);
635 
636         return nbd_negotiate_send_rep_err(client, NBD_REP_ERR_UNKNOWN,
637                                           errp, "export '%s' not present",
638                                           sane_name);
639     }
640 
641     /* Don't bother sending NBD_INFO_NAME unless client requested it */
642     if (sendname) {
643         rc = nbd_negotiate_send_info(client, NBD_INFO_NAME, namelen, name,
644                                      errp);
645         if (rc < 0) {
646             return rc;
647         }
648     }
649 
650     /* Send NBD_INFO_DESCRIPTION only if available, regardless of
651      * client request */
652     if (exp->description) {
653         size_t len = strlen(exp->description);
654 
655         assert(len <= NBD_MAX_STRING_SIZE);
656         rc = nbd_negotiate_send_info(client, NBD_INFO_DESCRIPTION,
657                                      len, exp->description, errp);
658         if (rc < 0) {
659             return rc;
660         }
661     }
662 
663     /* Send NBD_INFO_BLOCK_SIZE always, but tweak the minimum size
664      * according to whether the client requested it, and according to
665      * whether this is OPT_INFO or OPT_GO. */
666     /* minimum - 1 for back-compat, or actual if client will obey it. */
667     if (client->opt == NBD_OPT_INFO || blocksize) {
668         check_align = sizes[0] = blk_get_request_alignment(exp->common.blk);
669     } else {
670         sizes[0] = 1;
671     }
672     assert(sizes[0] <= NBD_MAX_BUFFER_SIZE);
673     /* preferred - Hard-code to 4096 for now.
674      * TODO: is blk_bs(blk)->bl.opt_transfer appropriate? */
675     sizes[1] = MAX(4096, sizes[0]);
676     /* maximum - At most 32M, but smaller as appropriate. */
677     sizes[2] = MIN(blk_get_max_transfer(exp->common.blk), NBD_MAX_BUFFER_SIZE);
678     trace_nbd_negotiate_handle_info_block_size(sizes[0], sizes[1], sizes[2]);
679     sizes[0] = cpu_to_be32(sizes[0]);
680     sizes[1] = cpu_to_be32(sizes[1]);
681     sizes[2] = cpu_to_be32(sizes[2]);
682     rc = nbd_negotiate_send_info(client, NBD_INFO_BLOCK_SIZE,
683                                  sizeof(sizes), sizes, errp);
684     if (rc < 0) {
685         return rc;
686     }
687 
688     /* Send NBD_INFO_EXPORT always */
689     myflags = exp->nbdflags;
690     if (client->mode >= NBD_MODE_STRUCTURED) {
691         myflags |= NBD_FLAG_SEND_DF;
692     }
693     trace_nbd_negotiate_new_style_size_flags(exp->size, myflags);
694     stq_be_p(buf, exp->size);
695     stw_be_p(buf + 8, myflags);
696     rc = nbd_negotiate_send_info(client, NBD_INFO_EXPORT,
697                                  sizeof(buf), buf, errp);
698     if (rc < 0) {
699         return rc;
700     }
701 
702     /*
703      * If the client is just asking for NBD_OPT_INFO, but forgot to
704      * request block sizes in a situation that would impact
705      * performance, then return an error. But for NBD_OPT_GO, we
706      * tolerate all clients, regardless of alignments.
707      */
708     if (client->opt == NBD_OPT_INFO && !blocksize &&
709         blk_get_request_alignment(exp->common.blk) > 1) {
710         return nbd_negotiate_send_rep_err(client,
711                                           NBD_REP_ERR_BLOCK_SIZE_REQD,
712                                           errp,
713                                           "request NBD_INFO_BLOCK_SIZE to "
714                                           "use this export");
715     }
716 
717     /* Final reply */
718     rc = nbd_negotiate_send_rep(client, NBD_REP_ACK, errp);
719     if (rc < 0) {
720         return rc;
721     }
722 
723     if (client->opt == NBD_OPT_GO) {
724         client->exp = exp;
725         client->check_align = check_align;
726         QTAILQ_INSERT_TAIL(&client->exp->clients, client, next);
727         blk_exp_ref(&client->exp->common);
728         nbd_check_meta_export(client);
729         rc = 1;
730     }
731     return rc;
732 }
733 
734 
735 /* Handle NBD_OPT_STARTTLS. Return NULL to drop connection, or else the
736  * new channel for all further (now-encrypted) communication. */
737 static QIOChannel *nbd_negotiate_handle_starttls(NBDClient *client,
738                                                  Error **errp)
739 {
740     QIOChannel *ioc;
741     QIOChannelTLS *tioc;
742     struct NBDTLSHandshakeData data = { 0 };
743 
744     assert(client->opt == NBD_OPT_STARTTLS);
745 
746     trace_nbd_negotiate_handle_starttls();
747     ioc = client->ioc;
748 
749     if (nbd_negotiate_send_rep(client, NBD_REP_ACK, errp) < 0) {
750         return NULL;
751     }
752 
753     tioc = qio_channel_tls_new_server(ioc,
754                                       client->tlscreds,
755                                       client->tlsauthz,
756                                       errp);
757     if (!tioc) {
758         return NULL;
759     }
760 
761     qio_channel_set_name(QIO_CHANNEL(tioc), "nbd-server-tls");
762     trace_nbd_negotiate_handle_starttls_handshake();
763     data.loop = g_main_loop_new(g_main_context_default(), FALSE);
764     qio_channel_tls_handshake(tioc,
765                               nbd_tls_handshake,
766                               &data,
767                               NULL,
768                               NULL);
769 
770     if (!data.complete) {
771         g_main_loop_run(data.loop);
772     }
773     g_main_loop_unref(data.loop);
774     if (data.error) {
775         object_unref(OBJECT(tioc));
776         error_propagate(errp, data.error);
777         return NULL;
778     }
779 
780     return QIO_CHANNEL(tioc);
781 }
782 
783 /* nbd_negotiate_send_meta_context
784  *
785  * Send one chunk of reply to NBD_OPT_{LIST,SET}_META_CONTEXT
786  *
787  * For NBD_OPT_LIST_META_CONTEXT @context_id is ignored, 0 is used instead.
788  */
789 static int nbd_negotiate_send_meta_context(NBDClient *client,
790                                            const char *context,
791                                            uint32_t context_id,
792                                            Error **errp)
793 {
794     NBDOptionReplyMetaContext opt;
795     struct iovec iov[] = {
796         {.iov_base = &opt, .iov_len = sizeof(opt)},
797         {.iov_base = (void *)context, .iov_len = strlen(context)}
798     };
799 
800     assert(iov[1].iov_len <= NBD_MAX_STRING_SIZE);
801     if (client->opt == NBD_OPT_LIST_META_CONTEXT) {
802         context_id = 0;
803     }
804 
805     trace_nbd_negotiate_meta_query_reply(context, context_id);
806     set_be_option_rep(&opt.h, client->opt, NBD_REP_META_CONTEXT,
807                       sizeof(opt) - sizeof(opt.h) + iov[1].iov_len);
808     stl_be_p(&opt.context_id, context_id);
809 
810     return qio_channel_writev_all(client->ioc, iov, 2, errp) < 0 ? -EIO : 0;
811 }
812 
813 /*
814  * Return true if @query matches @pattern, or if @query is empty when
815  * the @client is performing _LIST_.
816  */
817 static bool nbd_meta_empty_or_pattern(NBDClient *client, const char *pattern,
818                                       const char *query)
819 {
820     if (!*query) {
821         trace_nbd_negotiate_meta_query_parse("empty");
822         return client->opt == NBD_OPT_LIST_META_CONTEXT;
823     }
824     if (strcmp(query, pattern) == 0) {
825         trace_nbd_negotiate_meta_query_parse(pattern);
826         return true;
827     }
828     trace_nbd_negotiate_meta_query_skip("pattern not matched");
829     return false;
830 }
831 
832 /*
833  * Return true and adjust @str in place if it begins with @prefix.
834  */
835 static bool nbd_strshift(const char **str, const char *prefix)
836 {
837     size_t len = strlen(prefix);
838 
839     if (strncmp(*str, prefix, len) == 0) {
840         *str += len;
841         return true;
842     }
843     return false;
844 }
845 
846 /* nbd_meta_base_query
847  *
848  * Handle queries to 'base' namespace. For now, only the base:allocation
849  * context is available.  Return true if @query has been handled.
850  */
851 static bool nbd_meta_base_query(NBDClient *client, NBDExportMetaContexts *meta,
852                                 const char *query)
853 {
854     if (!nbd_strshift(&query, "base:")) {
855         return false;
856     }
857     trace_nbd_negotiate_meta_query_parse("base:");
858 
859     if (nbd_meta_empty_or_pattern(client, "allocation", query)) {
860         meta->base_allocation = true;
861     }
862     return true;
863 }
864 
865 /* nbd_meta_qemu_query
866  *
867  * Handle queries to 'qemu' namespace. For now, only the qemu:dirty-bitmap:
868  * and qemu:allocation-depth contexts are available.  Return true if @query
869  * has been handled.
870  */
871 static bool nbd_meta_qemu_query(NBDClient *client, NBDExportMetaContexts *meta,
872                                 const char *query)
873 {
874     size_t i;
875 
876     if (!nbd_strshift(&query, "qemu:")) {
877         return false;
878     }
879     trace_nbd_negotiate_meta_query_parse("qemu:");
880 
881     if (!*query) {
882         if (client->opt == NBD_OPT_LIST_META_CONTEXT) {
883             meta->allocation_depth = meta->exp->allocation_depth;
884             if (meta->exp->nr_export_bitmaps) {
885                 memset(meta->bitmaps, 1, meta->exp->nr_export_bitmaps);
886             }
887         }
888         trace_nbd_negotiate_meta_query_parse("empty");
889         return true;
890     }
891 
892     if (strcmp(query, "allocation-depth") == 0) {
893         trace_nbd_negotiate_meta_query_parse("allocation-depth");
894         meta->allocation_depth = meta->exp->allocation_depth;
895         return true;
896     }
897 
898     if (nbd_strshift(&query, "dirty-bitmap:")) {
899         trace_nbd_negotiate_meta_query_parse("dirty-bitmap:");
900         if (!*query) {
901             if (client->opt == NBD_OPT_LIST_META_CONTEXT &&
902                 meta->exp->nr_export_bitmaps) {
903                 memset(meta->bitmaps, 1, meta->exp->nr_export_bitmaps);
904             }
905             trace_nbd_negotiate_meta_query_parse("empty");
906             return true;
907         }
908 
909         for (i = 0; i < meta->exp->nr_export_bitmaps; i++) {
910             const char *bm_name;
911 
912             bm_name = bdrv_dirty_bitmap_name(meta->exp->export_bitmaps[i]);
913             if (strcmp(bm_name, query) == 0) {
914                 meta->bitmaps[i] = true;
915                 trace_nbd_negotiate_meta_query_parse(query);
916                 return true;
917             }
918         }
919         trace_nbd_negotiate_meta_query_skip("no dirty-bitmap match");
920         return true;
921     }
922 
923     trace_nbd_negotiate_meta_query_skip("unknown qemu context");
924     return true;
925 }
926 
927 /* nbd_negotiate_meta_query
928  *
929  * Parse namespace name and call corresponding function to parse body of the
930  * query.
931  *
932  * The only supported namespaces are 'base' and 'qemu'.
933  *
934  * Return -errno on I/O error, 0 if option was completely handled by
935  * sending a reply about inconsistent lengths, or 1 on success. */
936 static int nbd_negotiate_meta_query(NBDClient *client,
937                                     NBDExportMetaContexts *meta, Error **errp)
938 {
939     int ret;
940     g_autofree char *query = NULL;
941     uint32_t len;
942 
943     ret = nbd_opt_read(client, &len, sizeof(len), false, errp);
944     if (ret <= 0) {
945         return ret;
946     }
947     len = cpu_to_be32(len);
948 
949     if (len > NBD_MAX_STRING_SIZE) {
950         trace_nbd_negotiate_meta_query_skip("length too long");
951         return nbd_opt_skip(client, len, errp);
952     }
953 
954     query = g_malloc(len + 1);
955     ret = nbd_opt_read(client, query, len, true, errp);
956     if (ret <= 0) {
957         return ret;
958     }
959     query[len] = '\0';
960 
961     if (nbd_meta_base_query(client, meta, query)) {
962         return 1;
963     }
964     if (nbd_meta_qemu_query(client, meta, query)) {
965         return 1;
966     }
967 
968     trace_nbd_negotiate_meta_query_skip("unknown namespace");
969     return 1;
970 }
971 
972 /* nbd_negotiate_meta_queries
973  * Handle NBD_OPT_LIST_META_CONTEXT and NBD_OPT_SET_META_CONTEXT
974  *
975  * Return -errno on I/O error, or 0 if option was completely handled. */
976 static int nbd_negotiate_meta_queries(NBDClient *client,
977                                       NBDExportMetaContexts *meta, Error **errp)
978 {
979     int ret;
980     g_autofree char *export_name = NULL;
981     /* Mark unused to work around https://bugs.llvm.org/show_bug.cgi?id=3888 */
982     g_autofree G_GNUC_UNUSED bool *bitmaps = NULL;
983     NBDExportMetaContexts local_meta = {0};
984     uint32_t nb_queries;
985     size_t i;
986     size_t count = 0;
987 
988     if (client->opt == NBD_OPT_SET_META_CONTEXT &&
989         client->mode < NBD_MODE_STRUCTURED) {
990         return nbd_opt_invalid(client, errp,
991                                "request option '%s' when structured reply "
992                                "is not negotiated",
993                                nbd_opt_lookup(client->opt));
994     }
995 
996     if (client->opt == NBD_OPT_LIST_META_CONTEXT) {
997         /* Only change the caller's meta on SET. */
998         meta = &local_meta;
999     }
1000 
1001     g_free(meta->bitmaps);
1002     memset(meta, 0, sizeof(*meta));
1003 
1004     ret = nbd_opt_read_name(client, &export_name, NULL, errp);
1005     if (ret <= 0) {
1006         return ret;
1007     }
1008 
1009     meta->exp = nbd_export_find(export_name);
1010     if (meta->exp == NULL) {
1011         g_autofree char *sane_name = nbd_sanitize_name(export_name);
1012 
1013         return nbd_opt_drop(client, NBD_REP_ERR_UNKNOWN, errp,
1014                             "export '%s' not present", sane_name);
1015     }
1016     meta->bitmaps = g_new0(bool, meta->exp->nr_export_bitmaps);
1017     if (client->opt == NBD_OPT_LIST_META_CONTEXT) {
1018         bitmaps = meta->bitmaps;
1019     }
1020 
1021     ret = nbd_opt_read(client, &nb_queries, sizeof(nb_queries), false, errp);
1022     if (ret <= 0) {
1023         return ret;
1024     }
1025     nb_queries = cpu_to_be32(nb_queries);
1026     trace_nbd_negotiate_meta_context(nbd_opt_lookup(client->opt),
1027                                      export_name, nb_queries);
1028 
1029     if (client->opt == NBD_OPT_LIST_META_CONTEXT && !nb_queries) {
1030         /* enable all known contexts */
1031         meta->base_allocation = true;
1032         meta->allocation_depth = meta->exp->allocation_depth;
1033         if (meta->exp->nr_export_bitmaps) {
1034             memset(meta->bitmaps, 1, meta->exp->nr_export_bitmaps);
1035         }
1036     } else {
1037         for (i = 0; i < nb_queries; ++i) {
1038             ret = nbd_negotiate_meta_query(client, meta, errp);
1039             if (ret <= 0) {
1040                 return ret;
1041             }
1042         }
1043     }
1044 
1045     if (meta->base_allocation) {
1046         ret = nbd_negotiate_send_meta_context(client, "base:allocation",
1047                                               NBD_META_ID_BASE_ALLOCATION,
1048                                               errp);
1049         if (ret < 0) {
1050             return ret;
1051         }
1052         count++;
1053     }
1054 
1055     if (meta->allocation_depth) {
1056         ret = nbd_negotiate_send_meta_context(client, "qemu:allocation-depth",
1057                                               NBD_META_ID_ALLOCATION_DEPTH,
1058                                               errp);
1059         if (ret < 0) {
1060             return ret;
1061         }
1062         count++;
1063     }
1064 
1065     for (i = 0; i < meta->exp->nr_export_bitmaps; i++) {
1066         const char *bm_name;
1067         g_autofree char *context = NULL;
1068 
1069         if (!meta->bitmaps[i]) {
1070             continue;
1071         }
1072 
1073         bm_name = bdrv_dirty_bitmap_name(meta->exp->export_bitmaps[i]);
1074         context = g_strdup_printf("qemu:dirty-bitmap:%s", bm_name);
1075 
1076         ret = nbd_negotiate_send_meta_context(client, context,
1077                                               NBD_META_ID_DIRTY_BITMAP + i,
1078                                               errp);
1079         if (ret < 0) {
1080             return ret;
1081         }
1082         count++;
1083     }
1084 
1085     ret = nbd_negotiate_send_rep(client, NBD_REP_ACK, errp);
1086     if (ret == 0) {
1087         meta->count = count;
1088     }
1089 
1090     return ret;
1091 }
1092 
1093 /* nbd_negotiate_options
1094  * Process all NBD_OPT_* client option commands, during fixed newstyle
1095  * negotiation.
1096  * Return:
1097  * -errno  on error, errp is set
1098  * 0       on successful negotiation, errp is not set
1099  * 1       if client sent NBD_OPT_ABORT, i.e. on valid disconnect,
1100  *         errp is not set
1101  */
1102 static int nbd_negotiate_options(NBDClient *client, Error **errp)
1103 {
1104     uint32_t flags;
1105     bool fixedNewstyle = false;
1106     bool no_zeroes = false;
1107 
1108     /* Client sends:
1109         [ 0 ..   3]   client flags
1110 
1111        Then we loop until NBD_OPT_EXPORT_NAME or NBD_OPT_GO:
1112         [ 0 ..   7]   NBD_OPTS_MAGIC
1113         [ 8 ..  11]   NBD option
1114         [12 ..  15]   Data length
1115         ...           Rest of request
1116 
1117         [ 0 ..   7]   NBD_OPTS_MAGIC
1118         [ 8 ..  11]   Second NBD option
1119         [12 ..  15]   Data length
1120         ...           Rest of request
1121     */
1122 
1123     if (nbd_read32(client->ioc, &flags, "flags", errp) < 0) {
1124         return -EIO;
1125     }
1126     client->mode = NBD_MODE_EXPORT_NAME;
1127     trace_nbd_negotiate_options_flags(flags);
1128     if (flags & NBD_FLAG_C_FIXED_NEWSTYLE) {
1129         fixedNewstyle = true;
1130         flags &= ~NBD_FLAG_C_FIXED_NEWSTYLE;
1131         client->mode = NBD_MODE_SIMPLE;
1132     }
1133     if (flags & NBD_FLAG_C_NO_ZEROES) {
1134         no_zeroes = true;
1135         flags &= ~NBD_FLAG_C_NO_ZEROES;
1136     }
1137     if (flags != 0) {
1138         error_setg(errp, "Unknown client flags 0x%" PRIx32 " received", flags);
1139         return -EINVAL;
1140     }
1141 
1142     while (1) {
1143         int ret;
1144         uint32_t option, length;
1145         uint64_t magic;
1146 
1147         if (nbd_read64(client->ioc, &magic, "opts magic", errp) < 0) {
1148             return -EINVAL;
1149         }
1150         trace_nbd_negotiate_options_check_magic(magic);
1151         if (magic != NBD_OPTS_MAGIC) {
1152             error_setg(errp, "Bad magic received");
1153             return -EINVAL;
1154         }
1155 
1156         if (nbd_read32(client->ioc, &option, "option", errp) < 0) {
1157             return -EINVAL;
1158         }
1159         client->opt = option;
1160 
1161         if (nbd_read32(client->ioc, &length, "option length", errp) < 0) {
1162             return -EINVAL;
1163         }
1164         assert(!client->optlen);
1165         client->optlen = length;
1166 
1167         if (length > NBD_MAX_BUFFER_SIZE) {
1168             error_setg(errp, "len (%" PRIu32" ) is larger than max len (%u)",
1169                        length, NBD_MAX_BUFFER_SIZE);
1170             return -EINVAL;
1171         }
1172 
1173         trace_nbd_negotiate_options_check_option(option,
1174                                                  nbd_opt_lookup(option));
1175         if (client->tlscreds &&
1176             client->ioc == (QIOChannel *)client->sioc) {
1177             QIOChannel *tioc;
1178             if (!fixedNewstyle) {
1179                 error_setg(errp, "Unsupported option 0x%" PRIx32, option);
1180                 return -EINVAL;
1181             }
1182             switch (option) {
1183             case NBD_OPT_STARTTLS:
1184                 if (length) {
1185                     /* Unconditionally drop the connection if the client
1186                      * can't start a TLS negotiation correctly */
1187                     return nbd_reject_length(client, true, errp);
1188                 }
1189                 tioc = nbd_negotiate_handle_starttls(client, errp);
1190                 if (!tioc) {
1191                     return -EIO;
1192                 }
1193                 ret = 0;
1194                 object_unref(OBJECT(client->ioc));
1195                 client->ioc = tioc;
1196                 break;
1197 
1198             case NBD_OPT_EXPORT_NAME:
1199                 /* No way to return an error to client, so drop connection */
1200                 error_setg(errp, "Option 0x%x not permitted before TLS",
1201                            option);
1202                 return -EINVAL;
1203 
1204             default:
1205                 /* Let the client keep trying, unless they asked to
1206                  * quit. Always try to give an error back to the
1207                  * client; but when replying to OPT_ABORT, be aware
1208                  * that the client may hang up before receiving the
1209                  * error, in which case we are fine ignoring the
1210                  * resulting EPIPE. */
1211                 ret = nbd_opt_drop(client, NBD_REP_ERR_TLS_REQD,
1212                                    option == NBD_OPT_ABORT ? NULL : errp,
1213                                    "Option 0x%" PRIx32
1214                                    " not permitted before TLS", option);
1215                 if (option == NBD_OPT_ABORT) {
1216                     return 1;
1217                 }
1218                 break;
1219             }
1220         } else if (fixedNewstyle) {
1221             switch (option) {
1222             case NBD_OPT_LIST:
1223                 if (length) {
1224                     ret = nbd_reject_length(client, false, errp);
1225                 } else {
1226                     ret = nbd_negotiate_handle_list(client, errp);
1227                 }
1228                 break;
1229 
1230             case NBD_OPT_ABORT:
1231                 /* NBD spec says we must try to reply before
1232                  * disconnecting, but that we must also tolerate
1233                  * guests that don't wait for our reply. */
1234                 nbd_negotiate_send_rep(client, NBD_REP_ACK, NULL);
1235                 return 1;
1236 
1237             case NBD_OPT_EXPORT_NAME:
1238                 return nbd_negotiate_handle_export_name(client, no_zeroes,
1239                                                         errp);
1240 
1241             case NBD_OPT_INFO:
1242             case NBD_OPT_GO:
1243                 ret = nbd_negotiate_handle_info(client, errp);
1244                 if (ret == 1) {
1245                     assert(option == NBD_OPT_GO);
1246                     return 0;
1247                 }
1248                 break;
1249 
1250             case NBD_OPT_STARTTLS:
1251                 if (length) {
1252                     ret = nbd_reject_length(client, false, errp);
1253                 } else if (client->tlscreds) {
1254                     ret = nbd_negotiate_send_rep_err(client,
1255                                                      NBD_REP_ERR_INVALID, errp,
1256                                                      "TLS already enabled");
1257                 } else {
1258                     ret = nbd_negotiate_send_rep_err(client,
1259                                                      NBD_REP_ERR_POLICY, errp,
1260                                                      "TLS not configured");
1261                 }
1262                 break;
1263 
1264             case NBD_OPT_STRUCTURED_REPLY:
1265                 if (length) {
1266                     ret = nbd_reject_length(client, false, errp);
1267                 } else if (client->mode >= NBD_MODE_STRUCTURED) {
1268                     ret = nbd_negotiate_send_rep_err(
1269                         client, NBD_REP_ERR_INVALID, errp,
1270                         "structured reply already negotiated");
1271                 } else {
1272                     ret = nbd_negotiate_send_rep(client, NBD_REP_ACK, errp);
1273                     client->mode = NBD_MODE_STRUCTURED;
1274                 }
1275                 break;
1276 
1277             case NBD_OPT_LIST_META_CONTEXT:
1278             case NBD_OPT_SET_META_CONTEXT:
1279                 ret = nbd_negotiate_meta_queries(client, &client->export_meta,
1280                                                  errp);
1281                 break;
1282 
1283             default:
1284                 ret = nbd_opt_drop(client, NBD_REP_ERR_UNSUP, errp,
1285                                    "Unsupported option %" PRIu32 " (%s)",
1286                                    option, nbd_opt_lookup(option));
1287                 break;
1288             }
1289         } else {
1290             /*
1291              * If broken new-style we should drop the connection
1292              * for anything except NBD_OPT_EXPORT_NAME
1293              */
1294             switch (option) {
1295             case NBD_OPT_EXPORT_NAME:
1296                 return nbd_negotiate_handle_export_name(client, no_zeroes,
1297                                                         errp);
1298 
1299             default:
1300                 error_setg(errp, "Unsupported option %" PRIu32 " (%s)",
1301                            option, nbd_opt_lookup(option));
1302                 return -EINVAL;
1303             }
1304         }
1305         if (ret < 0) {
1306             return ret;
1307         }
1308     }
1309 }
1310 
1311 /* nbd_negotiate
1312  * Return:
1313  * -errno  on error, errp is set
1314  * 0       on successful negotiation, errp is not set
1315  * 1       if client sent NBD_OPT_ABORT, i.e. on valid disconnect,
1316  *         errp is not set
1317  */
1318 static coroutine_fn int nbd_negotiate(NBDClient *client, Error **errp)
1319 {
1320     ERRP_GUARD();
1321     char buf[NBD_OLDSTYLE_NEGOTIATE_SIZE] = "";
1322     int ret;
1323 
1324     /* Old style negotiation header, no room for options
1325         [ 0 ..   7]   passwd       ("NBDMAGIC")
1326         [ 8 ..  15]   magic        (NBD_CLIENT_MAGIC)
1327         [16 ..  23]   size
1328         [24 ..  27]   export flags (zero-extended)
1329         [28 .. 151]   reserved     (0)
1330 
1331        New style negotiation header, client can send options
1332         [ 0 ..   7]   passwd       ("NBDMAGIC")
1333         [ 8 ..  15]   magic        (NBD_OPTS_MAGIC)
1334         [16 ..  17]   server flags (0)
1335         ....options sent, ending in NBD_OPT_EXPORT_NAME or NBD_OPT_GO....
1336      */
1337 
1338     qio_channel_set_blocking(client->ioc, false, NULL);
1339     qio_channel_set_follow_coroutine_ctx(client->ioc, true);
1340 
1341     trace_nbd_negotiate_begin();
1342     memcpy(buf, "NBDMAGIC", 8);
1343 
1344     stq_be_p(buf + 8, NBD_OPTS_MAGIC);
1345     stw_be_p(buf + 16, NBD_FLAG_FIXED_NEWSTYLE | NBD_FLAG_NO_ZEROES);
1346 
1347     if (nbd_write(client->ioc, buf, 18, errp) < 0) {
1348         error_prepend(errp, "write failed: ");
1349         return -EINVAL;
1350     }
1351     ret = nbd_negotiate_options(client, errp);
1352     if (ret != 0) {
1353         if (ret < 0) {
1354             error_prepend(errp, "option negotiation failed: ");
1355         }
1356         return ret;
1357     }
1358 
1359     assert(!client->optlen);
1360     trace_nbd_negotiate_success();
1361 
1362     return 0;
1363 }
1364 
1365 /* nbd_read_eof
1366  * Tries to read @size bytes from @ioc. This is a local implementation of
1367  * qio_channel_readv_all_eof. We have it here because we need it to be
1368  * interruptible and to know when the coroutine is yielding.
1369  * Returns 1 on success
1370  *         0 on eof, when no data was read (errp is not set)
1371  *         negative errno on failure (errp is set)
1372  */
1373 static inline int coroutine_fn
1374 nbd_read_eof(NBDClient *client, void *buffer, size_t size, Error **errp)
1375 {
1376     bool partial = false;
1377 
1378     assert(size);
1379     while (size > 0) {
1380         struct iovec iov = { .iov_base = buffer, .iov_len = size };
1381         ssize_t len;
1382 
1383         len = qio_channel_readv(client->ioc, &iov, 1, errp);
1384         if (len == QIO_CHANNEL_ERR_BLOCK) {
1385             client->read_yielding = true;
1386             qio_channel_yield(client->ioc, G_IO_IN);
1387             client->read_yielding = false;
1388             if (client->quiescing) {
1389                 return -EAGAIN;
1390             }
1391             continue;
1392         } else if (len < 0) {
1393             return -EIO;
1394         } else if (len == 0) {
1395             if (partial) {
1396                 error_setg(errp,
1397                            "Unexpected end-of-file before all bytes were read");
1398                 return -EIO;
1399             } else {
1400                 return 0;
1401             }
1402         }
1403 
1404         partial = true;
1405         size -= len;
1406         buffer = (uint8_t *) buffer + len;
1407     }
1408     return 1;
1409 }
1410 
1411 static int coroutine_fn nbd_receive_request(NBDClient *client, NBDRequest *request,
1412                                             Error **errp)
1413 {
1414     uint8_t buf[NBD_REQUEST_SIZE];
1415     uint32_t magic;
1416     int ret;
1417 
1418     ret = nbd_read_eof(client, buf, sizeof(buf), errp);
1419     if (ret < 0) {
1420         return ret;
1421     }
1422     if (ret == 0) {
1423         return -EIO;
1424     }
1425 
1426     /* Request
1427        [ 0 ..  3]   magic   (NBD_REQUEST_MAGIC)
1428        [ 4 ..  5]   flags   (NBD_CMD_FLAG_FUA, ...)
1429        [ 6 ..  7]   type    (NBD_CMD_READ, ...)
1430        [ 8 .. 15]   cookie
1431        [16 .. 23]   from
1432        [24 .. 27]   len
1433      */
1434 
1435     magic = ldl_be_p(buf);
1436     request->flags  = lduw_be_p(buf + 4);
1437     request->type   = lduw_be_p(buf + 6);
1438     request->cookie = ldq_be_p(buf + 8);
1439     request->from   = ldq_be_p(buf + 16);
1440     request->len    = ldl_be_p(buf + 24);
1441 
1442     trace_nbd_receive_request(magic, request->flags, request->type,
1443                               request->from, request->len);
1444 
1445     if (magic != NBD_REQUEST_MAGIC) {
1446         error_setg(errp, "invalid magic (got 0x%" PRIx32 ")", magic);
1447         return -EINVAL;
1448     }
1449     return 0;
1450 }
1451 
1452 #define MAX_NBD_REQUESTS 16
1453 
1454 void nbd_client_get(NBDClient *client)
1455 {
1456     client->refcount++;
1457 }
1458 
1459 void nbd_client_put(NBDClient *client)
1460 {
1461     if (--client->refcount == 0) {
1462         /* The last reference should be dropped by client->close,
1463          * which is called by client_close.
1464          */
1465         assert(client->closing);
1466 
1467         object_unref(OBJECT(client->sioc));
1468         object_unref(OBJECT(client->ioc));
1469         if (client->tlscreds) {
1470             object_unref(OBJECT(client->tlscreds));
1471         }
1472         g_free(client->tlsauthz);
1473         if (client->exp) {
1474             QTAILQ_REMOVE(&client->exp->clients, client, next);
1475             blk_exp_unref(&client->exp->common);
1476         }
1477         g_free(client->export_meta.bitmaps);
1478         g_free(client);
1479     }
1480 }
1481 
1482 static void client_close(NBDClient *client, bool negotiated)
1483 {
1484     if (client->closing) {
1485         return;
1486     }
1487 
1488     client->closing = true;
1489 
1490     /* Force requests to finish.  They will drop their own references,
1491      * then we'll close the socket and free the NBDClient.
1492      */
1493     qio_channel_shutdown(client->ioc, QIO_CHANNEL_SHUTDOWN_BOTH,
1494                          NULL);
1495 
1496     /* Also tell the client, so that they release their reference.  */
1497     if (client->close_fn) {
1498         client->close_fn(client, negotiated);
1499     }
1500 }
1501 
1502 static NBDRequestData *nbd_request_get(NBDClient *client)
1503 {
1504     NBDRequestData *req;
1505 
1506     assert(client->nb_requests <= MAX_NBD_REQUESTS - 1);
1507     client->nb_requests++;
1508 
1509     req = g_new0(NBDRequestData, 1);
1510     nbd_client_get(client);
1511     req->client = client;
1512     return req;
1513 }
1514 
1515 static void nbd_request_put(NBDRequestData *req)
1516 {
1517     NBDClient *client = req->client;
1518 
1519     if (req->data) {
1520         qemu_vfree(req->data);
1521     }
1522     g_free(req);
1523 
1524     client->nb_requests--;
1525 
1526     if (client->quiescing && client->nb_requests == 0) {
1527         aio_wait_kick();
1528     }
1529 
1530     nbd_client_receive_next_request(client);
1531 
1532     nbd_client_put(client);
1533 }
1534 
1535 static void blk_aio_attached(AioContext *ctx, void *opaque)
1536 {
1537     NBDExport *exp = opaque;
1538     NBDClient *client;
1539 
1540     trace_nbd_blk_aio_attached(exp->name, ctx);
1541 
1542     exp->common.ctx = ctx;
1543 
1544     QTAILQ_FOREACH(client, &exp->clients, next) {
1545         assert(client->nb_requests == 0);
1546         assert(client->recv_coroutine == NULL);
1547         assert(client->send_coroutine == NULL);
1548     }
1549 }
1550 
1551 static void blk_aio_detach(void *opaque)
1552 {
1553     NBDExport *exp = opaque;
1554 
1555     trace_nbd_blk_aio_detach(exp->name, exp->common.ctx);
1556 
1557     exp->common.ctx = NULL;
1558 }
1559 
1560 static void nbd_drained_begin(void *opaque)
1561 {
1562     NBDExport *exp = opaque;
1563     NBDClient *client;
1564 
1565     QTAILQ_FOREACH(client, &exp->clients, next) {
1566         client->quiescing = true;
1567     }
1568 }
1569 
1570 static void nbd_drained_end(void *opaque)
1571 {
1572     NBDExport *exp = opaque;
1573     NBDClient *client;
1574 
1575     QTAILQ_FOREACH(client, &exp->clients, next) {
1576         client->quiescing = false;
1577         nbd_client_receive_next_request(client);
1578     }
1579 }
1580 
1581 static bool nbd_drained_poll(void *opaque)
1582 {
1583     NBDExport *exp = opaque;
1584     NBDClient *client;
1585 
1586     QTAILQ_FOREACH(client, &exp->clients, next) {
1587         if (client->nb_requests != 0) {
1588             /*
1589              * If there's a coroutine waiting for a request on nbd_read_eof()
1590              * enter it here so we don't depend on the client to wake it up.
1591              */
1592             if (client->recv_coroutine != NULL && client->read_yielding) {
1593                 qio_channel_wake_read(client->ioc);
1594             }
1595 
1596             return true;
1597         }
1598     }
1599 
1600     return false;
1601 }
1602 
1603 static void nbd_eject_notifier(Notifier *n, void *data)
1604 {
1605     NBDExport *exp = container_of(n, NBDExport, eject_notifier);
1606 
1607     blk_exp_request_shutdown(&exp->common);
1608 }
1609 
1610 void nbd_export_set_on_eject_blk(BlockExport *exp, BlockBackend *blk)
1611 {
1612     NBDExport *nbd_exp = container_of(exp, NBDExport, common);
1613     assert(exp->drv == &blk_exp_nbd);
1614     assert(nbd_exp->eject_notifier_blk == NULL);
1615 
1616     blk_ref(blk);
1617     nbd_exp->eject_notifier_blk = blk;
1618     nbd_exp->eject_notifier.notify = nbd_eject_notifier;
1619     blk_add_remove_bs_notifier(blk, &nbd_exp->eject_notifier);
1620 }
1621 
1622 static const BlockDevOps nbd_block_ops = {
1623     .drained_begin = nbd_drained_begin,
1624     .drained_end = nbd_drained_end,
1625     .drained_poll = nbd_drained_poll,
1626 };
1627 
1628 static int nbd_export_create(BlockExport *blk_exp, BlockExportOptions *exp_args,
1629                              Error **errp)
1630 {
1631     NBDExport *exp = container_of(blk_exp, NBDExport, common);
1632     BlockExportOptionsNbd *arg = &exp_args->u.nbd;
1633     const char *name = arg->name ?: exp_args->node_name;
1634     BlockBackend *blk = blk_exp->blk;
1635     int64_t size;
1636     uint64_t perm, shared_perm;
1637     bool readonly = !exp_args->writable;
1638     BlockDirtyBitmapOrStrList *bitmaps;
1639     size_t i;
1640     int ret;
1641 
1642     assert(exp_args->type == BLOCK_EXPORT_TYPE_NBD);
1643 
1644     if (!nbd_server_is_running()) {
1645         error_setg(errp, "NBD server not running");
1646         return -EINVAL;
1647     }
1648 
1649     if (strlen(name) > NBD_MAX_STRING_SIZE) {
1650         error_setg(errp, "export name '%s' too long", name);
1651         return -EINVAL;
1652     }
1653 
1654     if (arg->description && strlen(arg->description) > NBD_MAX_STRING_SIZE) {
1655         error_setg(errp, "description '%s' too long", arg->description);
1656         return -EINVAL;
1657     }
1658 
1659     if (nbd_export_find(name)) {
1660         error_setg(errp, "NBD server already has export named '%s'", name);
1661         return -EEXIST;
1662     }
1663 
1664     size = blk_getlength(blk);
1665     if (size < 0) {
1666         error_setg_errno(errp, -size,
1667                          "Failed to determine the NBD export's length");
1668         return size;
1669     }
1670 
1671     /* Don't allow resize while the NBD server is running, otherwise we don't
1672      * care what happens with the node. */
1673     blk_get_perm(blk, &perm, &shared_perm);
1674     ret = blk_set_perm(blk, perm, shared_perm & ~BLK_PERM_RESIZE, errp);
1675     if (ret < 0) {
1676         return ret;
1677     }
1678 
1679     QTAILQ_INIT(&exp->clients);
1680     exp->name = g_strdup(name);
1681     exp->description = g_strdup(arg->description);
1682     exp->nbdflags = (NBD_FLAG_HAS_FLAGS | NBD_FLAG_SEND_FLUSH |
1683                      NBD_FLAG_SEND_FUA | NBD_FLAG_SEND_CACHE);
1684 
1685     if (nbd_server_max_connections() != 1) {
1686         exp->nbdflags |= NBD_FLAG_CAN_MULTI_CONN;
1687     }
1688     if (readonly) {
1689         exp->nbdflags |= NBD_FLAG_READ_ONLY;
1690     } else {
1691         exp->nbdflags |= (NBD_FLAG_SEND_TRIM | NBD_FLAG_SEND_WRITE_ZEROES |
1692                           NBD_FLAG_SEND_FAST_ZERO);
1693     }
1694     exp->size = QEMU_ALIGN_DOWN(size, BDRV_SECTOR_SIZE);
1695 
1696     for (bitmaps = arg->bitmaps; bitmaps; bitmaps = bitmaps->next) {
1697         exp->nr_export_bitmaps++;
1698     }
1699     exp->export_bitmaps = g_new0(BdrvDirtyBitmap *, exp->nr_export_bitmaps);
1700     for (i = 0, bitmaps = arg->bitmaps; bitmaps;
1701          i++, bitmaps = bitmaps->next)
1702     {
1703         const char *bitmap;
1704         BlockDriverState *bs = blk_bs(blk);
1705         BdrvDirtyBitmap *bm = NULL;
1706 
1707         switch (bitmaps->value->type) {
1708         case QTYPE_QSTRING:
1709             bitmap = bitmaps->value->u.local;
1710             while (bs) {
1711                 bm = bdrv_find_dirty_bitmap(bs, bitmap);
1712                 if (bm != NULL) {
1713                     break;
1714                 }
1715 
1716                 bs = bdrv_filter_or_cow_bs(bs);
1717             }
1718 
1719             if (bm == NULL) {
1720                 ret = -ENOENT;
1721                 error_setg(errp, "Bitmap '%s' is not found",
1722                            bitmaps->value->u.local);
1723                 goto fail;
1724             }
1725 
1726             if (readonly && bdrv_is_writable(bs) &&
1727                 bdrv_dirty_bitmap_enabled(bm)) {
1728                 ret = -EINVAL;
1729                 error_setg(errp, "Enabled bitmap '%s' incompatible with "
1730                            "readonly export", bitmap);
1731                 goto fail;
1732             }
1733             break;
1734         case QTYPE_QDICT:
1735             bitmap = bitmaps->value->u.external.name;
1736             bm = block_dirty_bitmap_lookup(bitmaps->value->u.external.node,
1737                                            bitmap, NULL, errp);
1738             if (!bm) {
1739                 ret = -ENOENT;
1740                 goto fail;
1741             }
1742             break;
1743         default:
1744             abort();
1745         }
1746 
1747         assert(bm);
1748 
1749         if (bdrv_dirty_bitmap_check(bm, BDRV_BITMAP_ALLOW_RO, errp)) {
1750             ret = -EINVAL;
1751             goto fail;
1752         }
1753 
1754         exp->export_bitmaps[i] = bm;
1755         assert(strlen(bitmap) <= BDRV_BITMAP_MAX_NAME_SIZE);
1756     }
1757 
1758     /* Mark bitmaps busy in a separate loop, to simplify roll-back concerns. */
1759     for (i = 0; i < exp->nr_export_bitmaps; i++) {
1760         bdrv_dirty_bitmap_set_busy(exp->export_bitmaps[i], true);
1761     }
1762 
1763     exp->allocation_depth = arg->allocation_depth;
1764 
1765     /*
1766      * We need to inhibit request queuing in the block layer to ensure we can
1767      * be properly quiesced when entering a drained section, as our coroutines
1768      * servicing pending requests might enter blk_pread().
1769      */
1770     blk_set_disable_request_queuing(blk, true);
1771 
1772     blk_add_aio_context_notifier(blk, blk_aio_attached, blk_aio_detach, exp);
1773 
1774     blk_set_dev_ops(blk, &nbd_block_ops, exp);
1775 
1776     QTAILQ_INSERT_TAIL(&exports, exp, next);
1777 
1778     return 0;
1779 
1780 fail:
1781     g_free(exp->export_bitmaps);
1782     g_free(exp->name);
1783     g_free(exp->description);
1784     return ret;
1785 }
1786 
1787 NBDExport *nbd_export_find(const char *name)
1788 {
1789     NBDExport *exp;
1790     QTAILQ_FOREACH(exp, &exports, next) {
1791         if (strcmp(name, exp->name) == 0) {
1792             return exp;
1793         }
1794     }
1795 
1796     return NULL;
1797 }
1798 
1799 AioContext *
1800 nbd_export_aio_context(NBDExport *exp)
1801 {
1802     return exp->common.ctx;
1803 }
1804 
1805 static void nbd_export_request_shutdown(BlockExport *blk_exp)
1806 {
1807     NBDExport *exp = container_of(blk_exp, NBDExport, common);
1808     NBDClient *client, *next;
1809 
1810     blk_exp_ref(&exp->common);
1811     /*
1812      * TODO: Should we expand QMP NbdServerRemoveNode enum to allow a
1813      * close mode that stops advertising the export to new clients but
1814      * still permits existing clients to run to completion? Because of
1815      * that possibility, nbd_export_close() can be called more than
1816      * once on an export.
1817      */
1818     QTAILQ_FOREACH_SAFE(client, &exp->clients, next, next) {
1819         client_close(client, true);
1820     }
1821     if (exp->name) {
1822         g_free(exp->name);
1823         exp->name = NULL;
1824         QTAILQ_REMOVE(&exports, exp, next);
1825     }
1826     blk_exp_unref(&exp->common);
1827 }
1828 
1829 static void nbd_export_delete(BlockExport *blk_exp)
1830 {
1831     size_t i;
1832     NBDExport *exp = container_of(blk_exp, NBDExport, common);
1833 
1834     assert(exp->name == NULL);
1835     assert(QTAILQ_EMPTY(&exp->clients));
1836 
1837     g_free(exp->description);
1838     exp->description = NULL;
1839 
1840     if (exp->eject_notifier_blk) {
1841         notifier_remove(&exp->eject_notifier);
1842         blk_unref(exp->eject_notifier_blk);
1843     }
1844     blk_remove_aio_context_notifier(exp->common.blk, blk_aio_attached,
1845                                     blk_aio_detach, exp);
1846     blk_set_disable_request_queuing(exp->common.blk, false);
1847 
1848     for (i = 0; i < exp->nr_export_bitmaps; i++) {
1849         bdrv_dirty_bitmap_set_busy(exp->export_bitmaps[i], false);
1850     }
1851 }
1852 
1853 const BlockExportDriver blk_exp_nbd = {
1854     .type               = BLOCK_EXPORT_TYPE_NBD,
1855     .instance_size      = sizeof(NBDExport),
1856     .create             = nbd_export_create,
1857     .delete             = nbd_export_delete,
1858     .request_shutdown   = nbd_export_request_shutdown,
1859 };
1860 
1861 static int coroutine_fn nbd_co_send_iov(NBDClient *client, struct iovec *iov,
1862                                         unsigned niov, Error **errp)
1863 {
1864     int ret;
1865 
1866     g_assert(qemu_in_coroutine());
1867     qemu_co_mutex_lock(&client->send_lock);
1868     client->send_coroutine = qemu_coroutine_self();
1869 
1870     ret = qio_channel_writev_all(client->ioc, iov, niov, errp) < 0 ? -EIO : 0;
1871 
1872     client->send_coroutine = NULL;
1873     qemu_co_mutex_unlock(&client->send_lock);
1874 
1875     return ret;
1876 }
1877 
1878 static inline void set_be_simple_reply(NBDSimpleReply *reply, uint64_t error,
1879                                        uint64_t cookie)
1880 {
1881     stl_be_p(&reply->magic, NBD_SIMPLE_REPLY_MAGIC);
1882     stl_be_p(&reply->error, error);
1883     stq_be_p(&reply->cookie, cookie);
1884 }
1885 
1886 static int coroutine_fn nbd_co_send_simple_reply(NBDClient *client,
1887                                                  NBDRequest *request,
1888                                                  uint32_t error,
1889                                                  void *data,
1890                                                  size_t len,
1891                                                  Error **errp)
1892 {
1893     NBDSimpleReply reply;
1894     int nbd_err = system_errno_to_nbd_errno(error);
1895     struct iovec iov[] = {
1896         {.iov_base = &reply, .iov_len = sizeof(reply)},
1897         {.iov_base = data, .iov_len = len}
1898     };
1899 
1900     assert(!len || !nbd_err);
1901     assert(client->mode < NBD_MODE_STRUCTURED ||
1902            (client->mode == NBD_MODE_STRUCTURED &&
1903             request->type != NBD_CMD_READ));
1904     trace_nbd_co_send_simple_reply(request->cookie, nbd_err,
1905                                    nbd_err_lookup(nbd_err), len);
1906     set_be_simple_reply(&reply, nbd_err, request->cookie);
1907 
1908     return nbd_co_send_iov(client, iov, 2, errp);
1909 }
1910 
1911 /*
1912  * Prepare the header of a reply chunk for network transmission.
1913  *
1914  * On input, @iov is partially initialized: iov[0].iov_base must point
1915  * to an uninitialized NBDReply, while the remaining @niov elements
1916  * (if any) must be ready for transmission.  This function then
1917  * populates iov[0] for transmission.
1918  */
1919 static inline void set_be_chunk(NBDClient *client, struct iovec *iov,
1920                                 size_t niov, uint16_t flags, uint16_t type,
1921                                 NBDRequest *request)
1922 {
1923     /* TODO - handle structured vs. extended replies */
1924     NBDStructuredReplyChunk *chunk = iov->iov_base;
1925     size_t i, length = 0;
1926 
1927     for (i = 1; i < niov; i++) {
1928         length += iov[i].iov_len;
1929     }
1930     assert(length <= NBD_MAX_BUFFER_SIZE + sizeof(NBDStructuredReadData));
1931 
1932     iov[0].iov_len = sizeof(*chunk);
1933     stl_be_p(&chunk->magic, NBD_STRUCTURED_REPLY_MAGIC);
1934     stw_be_p(&chunk->flags, flags);
1935     stw_be_p(&chunk->type, type);
1936     stq_be_p(&chunk->cookie, request->cookie);
1937     stl_be_p(&chunk->length, length);
1938 }
1939 
1940 static int coroutine_fn nbd_co_send_chunk_done(NBDClient *client,
1941                                                NBDRequest *request,
1942                                                Error **errp)
1943 {
1944     NBDReply hdr;
1945     struct iovec iov[] = {
1946         {.iov_base = &hdr},
1947     };
1948 
1949     trace_nbd_co_send_chunk_done(request->cookie);
1950     set_be_chunk(client, iov, 1, NBD_REPLY_FLAG_DONE,
1951                  NBD_REPLY_TYPE_NONE, request);
1952     return nbd_co_send_iov(client, iov, 1, errp);
1953 }
1954 
1955 static int coroutine_fn nbd_co_send_chunk_read(NBDClient *client,
1956                                                NBDRequest *request,
1957                                                uint64_t offset,
1958                                                void *data,
1959                                                size_t size,
1960                                                bool final,
1961                                                Error **errp)
1962 {
1963     NBDReply hdr;
1964     NBDStructuredReadData chunk;
1965     struct iovec iov[] = {
1966         {.iov_base = &hdr},
1967         {.iov_base = &chunk, .iov_len = sizeof(chunk)},
1968         {.iov_base = data, .iov_len = size}
1969     };
1970 
1971     assert(size);
1972     trace_nbd_co_send_chunk_read(request->cookie, offset, data, size);
1973     set_be_chunk(client, iov, 3, final ? NBD_REPLY_FLAG_DONE : 0,
1974                  NBD_REPLY_TYPE_OFFSET_DATA, request);
1975     stq_be_p(&chunk.offset, offset);
1976 
1977     return nbd_co_send_iov(client, iov, 3, errp);
1978 }
1979 
1980 static int coroutine_fn nbd_co_send_chunk_error(NBDClient *client,
1981                                                 NBDRequest *request,
1982                                                 uint32_t error,
1983                                                 const char *msg,
1984                                                 Error **errp)
1985 {
1986     NBDReply hdr;
1987     NBDStructuredError chunk;
1988     int nbd_err = system_errno_to_nbd_errno(error);
1989     struct iovec iov[] = {
1990         {.iov_base = &hdr},
1991         {.iov_base = &chunk, .iov_len = sizeof(chunk)},
1992         {.iov_base = (char *)msg, .iov_len = msg ? strlen(msg) : 0},
1993     };
1994 
1995     assert(nbd_err);
1996     trace_nbd_co_send_chunk_error(request->cookie, nbd_err,
1997                                   nbd_err_lookup(nbd_err), msg ? msg : "");
1998     set_be_chunk(client, iov, 3, NBD_REPLY_FLAG_DONE,
1999                  NBD_REPLY_TYPE_ERROR, request);
2000     stl_be_p(&chunk.error, nbd_err);
2001     stw_be_p(&chunk.message_length, iov[2].iov_len);
2002 
2003     return nbd_co_send_iov(client, iov, 3, errp);
2004 }
2005 
2006 /* Do a sparse read and send the structured reply to the client.
2007  * Returns -errno if sending fails. blk_co_block_status_above() failure is
2008  * reported to the client, at which point this function succeeds.
2009  */
2010 static int coroutine_fn nbd_co_send_sparse_read(NBDClient *client,
2011                                                 NBDRequest *request,
2012                                                 uint64_t offset,
2013                                                 uint8_t *data,
2014                                                 size_t size,
2015                                                 Error **errp)
2016 {
2017     int ret = 0;
2018     NBDExport *exp = client->exp;
2019     size_t progress = 0;
2020 
2021     while (progress < size) {
2022         int64_t pnum;
2023         int status = blk_co_block_status_above(exp->common.blk, NULL,
2024                                                offset + progress,
2025                                                size - progress, &pnum, NULL,
2026                                                NULL);
2027         bool final;
2028 
2029         if (status < 0) {
2030             char *msg = g_strdup_printf("unable to check for holes: %s",
2031                                         strerror(-status));
2032 
2033             ret = nbd_co_send_chunk_error(client, request, -status, msg, errp);
2034             g_free(msg);
2035             return ret;
2036         }
2037         assert(pnum && pnum <= size - progress);
2038         final = progress + pnum == size;
2039         if (status & BDRV_BLOCK_ZERO) {
2040             NBDReply hdr;
2041             NBDStructuredReadHole chunk;
2042             struct iovec iov[] = {
2043                 {.iov_base = &hdr},
2044                 {.iov_base = &chunk, .iov_len = sizeof(chunk)},
2045             };
2046 
2047             trace_nbd_co_send_chunk_read_hole(request->cookie,
2048                                               offset + progress, pnum);
2049             set_be_chunk(client, iov, 2,
2050                          final ? NBD_REPLY_FLAG_DONE : 0,
2051                          NBD_REPLY_TYPE_OFFSET_HOLE, request);
2052             stq_be_p(&chunk.offset, offset + progress);
2053             stl_be_p(&chunk.length, pnum);
2054             ret = nbd_co_send_iov(client, iov, 2, errp);
2055         } else {
2056             ret = blk_co_pread(exp->common.blk, offset + progress, pnum,
2057                                data + progress, 0);
2058             if (ret < 0) {
2059                 error_setg_errno(errp, -ret, "reading from file failed");
2060                 break;
2061             }
2062             ret = nbd_co_send_chunk_read(client, request, offset + progress,
2063                                          data + progress, pnum, final, errp);
2064         }
2065 
2066         if (ret < 0) {
2067             break;
2068         }
2069         progress += pnum;
2070     }
2071     return ret;
2072 }
2073 
2074 typedef struct NBDExtentArray {
2075     NBDExtent *extents;
2076     unsigned int nb_alloc;
2077     unsigned int count;
2078     uint64_t total_length;
2079     bool can_add;
2080     bool converted_to_be;
2081 } NBDExtentArray;
2082 
2083 static NBDExtentArray *nbd_extent_array_new(unsigned int nb_alloc)
2084 {
2085     NBDExtentArray *ea = g_new0(NBDExtentArray, 1);
2086 
2087     ea->nb_alloc = nb_alloc;
2088     ea->extents = g_new(NBDExtent, nb_alloc);
2089     ea->can_add = true;
2090 
2091     return ea;
2092 }
2093 
2094 static void nbd_extent_array_free(NBDExtentArray *ea)
2095 {
2096     g_free(ea->extents);
2097     g_free(ea);
2098 }
2099 G_DEFINE_AUTOPTR_CLEANUP_FUNC(NBDExtentArray, nbd_extent_array_free)
2100 
2101 /* Further modifications of the array after conversion are abandoned */
2102 static void nbd_extent_array_convert_to_be(NBDExtentArray *ea)
2103 {
2104     int i;
2105 
2106     assert(!ea->converted_to_be);
2107     ea->can_add = false;
2108     ea->converted_to_be = true;
2109 
2110     for (i = 0; i < ea->count; i++) {
2111         ea->extents[i].flags = cpu_to_be32(ea->extents[i].flags);
2112         ea->extents[i].length = cpu_to_be32(ea->extents[i].length);
2113     }
2114 }
2115 
2116 /*
2117  * Add extent to NBDExtentArray. If extent can't be added (no available space),
2118  * return -1.
2119  * For safety, when returning -1 for the first time, .can_add is set to false,
2120  * and further calls to nbd_extent_array_add() will crash.
2121  * (this avoids the situation where a caller ignores failure to add one extent,
2122  * where adding another extent that would squash into the last array entry
2123  * would result in an incorrect range reported to the client)
2124  */
2125 static int nbd_extent_array_add(NBDExtentArray *ea,
2126                                 uint32_t length, uint32_t flags)
2127 {
2128     assert(ea->can_add);
2129 
2130     if (!length) {
2131         return 0;
2132     }
2133 
2134     /* Extend previous extent if flags are the same */
2135     if (ea->count > 0 && flags == ea->extents[ea->count - 1].flags) {
2136         uint64_t sum = (uint64_t)length + ea->extents[ea->count - 1].length;
2137 
2138         if (sum <= UINT32_MAX) {
2139             ea->extents[ea->count - 1].length = sum;
2140             ea->total_length += length;
2141             return 0;
2142         }
2143     }
2144 
2145     if (ea->count >= ea->nb_alloc) {
2146         ea->can_add = false;
2147         return -1;
2148     }
2149 
2150     ea->total_length += length;
2151     ea->extents[ea->count] = (NBDExtent) {.length = length, .flags = flags};
2152     ea->count++;
2153 
2154     return 0;
2155 }
2156 
2157 static int coroutine_fn blockstatus_to_extents(BlockBackend *blk,
2158                                                uint64_t offset, uint64_t bytes,
2159                                                NBDExtentArray *ea)
2160 {
2161     while (bytes) {
2162         uint32_t flags;
2163         int64_t num;
2164         int ret = blk_co_block_status_above(blk, NULL, offset, bytes, &num,
2165                                             NULL, NULL);
2166 
2167         if (ret < 0) {
2168             return ret;
2169         }
2170 
2171         flags = (ret & BDRV_BLOCK_DATA ? 0 : NBD_STATE_HOLE) |
2172                 (ret & BDRV_BLOCK_ZERO ? NBD_STATE_ZERO : 0);
2173 
2174         if (nbd_extent_array_add(ea, num, flags) < 0) {
2175             return 0;
2176         }
2177 
2178         offset += num;
2179         bytes -= num;
2180     }
2181 
2182     return 0;
2183 }
2184 
2185 static int coroutine_fn blockalloc_to_extents(BlockBackend *blk,
2186                                               uint64_t offset, uint64_t bytes,
2187                                               NBDExtentArray *ea)
2188 {
2189     while (bytes) {
2190         int64_t num;
2191         int ret = blk_co_is_allocated_above(blk, NULL, false, offset, bytes,
2192                                             &num);
2193 
2194         if (ret < 0) {
2195             return ret;
2196         }
2197 
2198         if (nbd_extent_array_add(ea, num, ret) < 0) {
2199             return 0;
2200         }
2201 
2202         offset += num;
2203         bytes -= num;
2204     }
2205 
2206     return 0;
2207 }
2208 
2209 /*
2210  * nbd_co_send_extents
2211  *
2212  * @ea is converted to BE by the function
2213  * @last controls whether NBD_REPLY_FLAG_DONE is sent.
2214  */
2215 static int coroutine_fn
2216 nbd_co_send_extents(NBDClient *client, NBDRequest *request, NBDExtentArray *ea,
2217                     bool last, uint32_t context_id, Error **errp)
2218 {
2219     NBDReply hdr;
2220     NBDStructuredMeta chunk;
2221     struct iovec iov[] = {
2222         {.iov_base = &hdr},
2223         {.iov_base = &chunk, .iov_len = sizeof(chunk)},
2224         {.iov_base = ea->extents, .iov_len = ea->count * sizeof(ea->extents[0])}
2225     };
2226 
2227     nbd_extent_array_convert_to_be(ea);
2228 
2229     trace_nbd_co_send_extents(request->cookie, ea->count, context_id,
2230                               ea->total_length, last);
2231     set_be_chunk(client, iov, 3, last ? NBD_REPLY_FLAG_DONE : 0,
2232                  NBD_REPLY_TYPE_BLOCK_STATUS, request);
2233     stl_be_p(&chunk.context_id, context_id);
2234 
2235     return nbd_co_send_iov(client, iov, 3, errp);
2236 }
2237 
2238 /* Get block status from the exported device and send it to the client */
2239 static int
2240 coroutine_fn nbd_co_send_block_status(NBDClient *client, NBDRequest *request,
2241                                       BlockBackend *blk, uint64_t offset,
2242                                       uint32_t length, bool dont_fragment,
2243                                       bool last, uint32_t context_id,
2244                                       Error **errp)
2245 {
2246     int ret;
2247     unsigned int nb_extents = dont_fragment ? 1 : NBD_MAX_BLOCK_STATUS_EXTENTS;
2248     g_autoptr(NBDExtentArray) ea = nbd_extent_array_new(nb_extents);
2249 
2250     if (context_id == NBD_META_ID_BASE_ALLOCATION) {
2251         ret = blockstatus_to_extents(blk, offset, length, ea);
2252     } else {
2253         ret = blockalloc_to_extents(blk, offset, length, ea);
2254     }
2255     if (ret < 0) {
2256         return nbd_co_send_chunk_error(client, request, -ret,
2257                                        "can't get block status", errp);
2258     }
2259 
2260     return nbd_co_send_extents(client, request, ea, last, context_id, errp);
2261 }
2262 
2263 /* Populate @ea from a dirty bitmap. */
2264 static void bitmap_to_extents(BdrvDirtyBitmap *bitmap,
2265                               uint64_t offset, uint64_t length,
2266                               NBDExtentArray *es)
2267 {
2268     int64_t start, dirty_start, dirty_count;
2269     int64_t end = offset + length;
2270     bool full = false;
2271 
2272     bdrv_dirty_bitmap_lock(bitmap);
2273 
2274     for (start = offset;
2275          bdrv_dirty_bitmap_next_dirty_area(bitmap, start, end, INT32_MAX,
2276                                            &dirty_start, &dirty_count);
2277          start = dirty_start + dirty_count)
2278     {
2279         if ((nbd_extent_array_add(es, dirty_start - start, 0) < 0) ||
2280             (nbd_extent_array_add(es, dirty_count, NBD_STATE_DIRTY) < 0))
2281         {
2282             full = true;
2283             break;
2284         }
2285     }
2286 
2287     if (!full) {
2288         /* last non dirty extent, nothing to do if array is now full */
2289         (void) nbd_extent_array_add(es, end - start, 0);
2290     }
2291 
2292     bdrv_dirty_bitmap_unlock(bitmap);
2293 }
2294 
2295 static int coroutine_fn nbd_co_send_bitmap(NBDClient *client,
2296                                            NBDRequest *request,
2297                                            BdrvDirtyBitmap *bitmap,
2298                                            uint64_t offset,
2299                                            uint32_t length, bool dont_fragment,
2300                                            bool last, uint32_t context_id,
2301                                            Error **errp)
2302 {
2303     unsigned int nb_extents = dont_fragment ? 1 : NBD_MAX_BLOCK_STATUS_EXTENTS;
2304     g_autoptr(NBDExtentArray) ea = nbd_extent_array_new(nb_extents);
2305 
2306     bitmap_to_extents(bitmap, offset, length, ea);
2307 
2308     return nbd_co_send_extents(client, request, ea, last, context_id, errp);
2309 }
2310 
2311 /* nbd_co_receive_request
2312  * Collect a client request. Return 0 if request looks valid, -EIO to drop
2313  * connection right away, -EAGAIN to indicate we were interrupted and the
2314  * channel should be quiesced, and any other negative value to report an error
2315  * to the client (although the caller may still need to disconnect after
2316  * reporting the error).
2317  */
2318 static int coroutine_fn nbd_co_receive_request(NBDRequestData *req, NBDRequest *request,
2319                                                Error **errp)
2320 {
2321     NBDClient *client = req->client;
2322     int valid_flags;
2323     int ret;
2324 
2325     g_assert(qemu_in_coroutine());
2326     assert(client->recv_coroutine == qemu_coroutine_self());
2327     ret = nbd_receive_request(client, request, errp);
2328     if (ret < 0) {
2329         return ret;
2330     }
2331 
2332     trace_nbd_co_receive_request_decode_type(request->cookie, request->type,
2333                                              nbd_cmd_lookup(request->type));
2334 
2335     if (request->type != NBD_CMD_WRITE) {
2336         /* No payload, we are ready to read the next request.  */
2337         req->complete = true;
2338     }
2339 
2340     if (request->type == NBD_CMD_DISC) {
2341         /* Special case: we're going to disconnect without a reply,
2342          * whether or not flags, from, or len are bogus */
2343         return -EIO;
2344     }
2345 
2346     if (request->type == NBD_CMD_READ || request->type == NBD_CMD_WRITE ||
2347         request->type == NBD_CMD_CACHE)
2348     {
2349         if (request->len > NBD_MAX_BUFFER_SIZE) {
2350             error_setg(errp, "len (%" PRIu32" ) is larger than max len (%u)",
2351                        request->len, NBD_MAX_BUFFER_SIZE);
2352             return -EINVAL;
2353         }
2354 
2355         if (request->type != NBD_CMD_CACHE) {
2356             req->data = blk_try_blockalign(client->exp->common.blk,
2357                                            request->len);
2358             if (req->data == NULL) {
2359                 error_setg(errp, "No memory");
2360                 return -ENOMEM;
2361             }
2362         }
2363     }
2364 
2365     if (request->type == NBD_CMD_WRITE) {
2366         if (nbd_read(client->ioc, req->data, request->len, "CMD_WRITE data",
2367                      errp) < 0)
2368         {
2369             return -EIO;
2370         }
2371         req->complete = true;
2372 
2373         trace_nbd_co_receive_request_payload_received(request->cookie,
2374                                                       request->len);
2375     }
2376 
2377     /* Sanity checks. */
2378     if (client->exp->nbdflags & NBD_FLAG_READ_ONLY &&
2379         (request->type == NBD_CMD_WRITE ||
2380          request->type == NBD_CMD_WRITE_ZEROES ||
2381          request->type == NBD_CMD_TRIM)) {
2382         error_setg(errp, "Export is read-only");
2383         return -EROFS;
2384     }
2385     if (request->from > client->exp->size ||
2386         request->len > client->exp->size - request->from) {
2387         error_setg(errp, "operation past EOF; From: %" PRIu64 ", Len: %" PRIu32
2388                    ", Size: %" PRIu64, request->from, request->len,
2389                    client->exp->size);
2390         return (request->type == NBD_CMD_WRITE ||
2391                 request->type == NBD_CMD_WRITE_ZEROES) ? -ENOSPC : -EINVAL;
2392     }
2393     if (client->check_align && !QEMU_IS_ALIGNED(request->from | request->len,
2394                                                 client->check_align)) {
2395         /*
2396          * The block layer gracefully handles unaligned requests, but
2397          * it's still worth tracing client non-compliance
2398          */
2399         trace_nbd_co_receive_align_compliance(nbd_cmd_lookup(request->type),
2400                                               request->from,
2401                                               request->len,
2402                                               client->check_align);
2403     }
2404     valid_flags = NBD_CMD_FLAG_FUA;
2405     if (request->type == NBD_CMD_READ && client->mode >= NBD_MODE_STRUCTURED) {
2406         valid_flags |= NBD_CMD_FLAG_DF;
2407     } else if (request->type == NBD_CMD_WRITE_ZEROES) {
2408         valid_flags |= NBD_CMD_FLAG_NO_HOLE | NBD_CMD_FLAG_FAST_ZERO;
2409     } else if (request->type == NBD_CMD_BLOCK_STATUS) {
2410         valid_flags |= NBD_CMD_FLAG_REQ_ONE;
2411     }
2412     if (request->flags & ~valid_flags) {
2413         error_setg(errp, "unsupported flags for command %s (got 0x%x)",
2414                    nbd_cmd_lookup(request->type), request->flags);
2415         return -EINVAL;
2416     }
2417 
2418     return 0;
2419 }
2420 
2421 /* Send simple reply without a payload, or a structured error
2422  * @error_msg is ignored if @ret >= 0
2423  * Returns 0 if connection is still live, -errno on failure to talk to client
2424  */
2425 static coroutine_fn int nbd_send_generic_reply(NBDClient *client,
2426                                                NBDRequest *request,
2427                                                int ret,
2428                                                const char *error_msg,
2429                                                Error **errp)
2430 {
2431     if (client->mode >= NBD_MODE_STRUCTURED && ret < 0) {
2432         return nbd_co_send_chunk_error(client, request, -ret, error_msg, errp);
2433     } else {
2434         return nbd_co_send_simple_reply(client, request, ret < 0 ? -ret : 0,
2435                                         NULL, 0, errp);
2436     }
2437 }
2438 
2439 /* Handle NBD_CMD_READ request.
2440  * Return -errno if sending fails. Other errors are reported directly to the
2441  * client as an error reply. */
2442 static coroutine_fn int nbd_do_cmd_read(NBDClient *client, NBDRequest *request,
2443                                         uint8_t *data, Error **errp)
2444 {
2445     int ret;
2446     NBDExport *exp = client->exp;
2447 
2448     assert(request->type == NBD_CMD_READ);
2449 
2450     /* XXX: NBD Protocol only documents use of FUA with WRITE */
2451     if (request->flags & NBD_CMD_FLAG_FUA) {
2452         ret = blk_co_flush(exp->common.blk);
2453         if (ret < 0) {
2454             return nbd_send_generic_reply(client, request, ret,
2455                                           "flush failed", errp);
2456         }
2457     }
2458 
2459     if (client->mode >= NBD_MODE_STRUCTURED &&
2460         !(request->flags & NBD_CMD_FLAG_DF) && request->len)
2461     {
2462         return nbd_co_send_sparse_read(client, request, request->from,
2463                                        data, request->len, errp);
2464     }
2465 
2466     ret = blk_co_pread(exp->common.blk, request->from, request->len, data, 0);
2467     if (ret < 0) {
2468         return nbd_send_generic_reply(client, request, ret,
2469                                       "reading from file failed", errp);
2470     }
2471 
2472     if (client->mode >= NBD_MODE_STRUCTURED) {
2473         if (request->len) {
2474             return nbd_co_send_chunk_read(client, request, request->from, data,
2475                                           request->len, true, errp);
2476         } else {
2477             return nbd_co_send_chunk_done(client, request, errp);
2478         }
2479     } else {
2480         return nbd_co_send_simple_reply(client, request, 0,
2481                                         data, request->len, errp);
2482     }
2483 }
2484 
2485 /*
2486  * nbd_do_cmd_cache
2487  *
2488  * Handle NBD_CMD_CACHE request.
2489  * Return -errno if sending fails. Other errors are reported directly to the
2490  * client as an error reply.
2491  */
2492 static coroutine_fn int nbd_do_cmd_cache(NBDClient *client, NBDRequest *request,
2493                                          Error **errp)
2494 {
2495     int ret;
2496     NBDExport *exp = client->exp;
2497 
2498     assert(request->type == NBD_CMD_CACHE);
2499 
2500     ret = blk_co_preadv(exp->common.blk, request->from, request->len,
2501                         NULL, BDRV_REQ_COPY_ON_READ | BDRV_REQ_PREFETCH);
2502 
2503     return nbd_send_generic_reply(client, request, ret,
2504                                   "caching data failed", errp);
2505 }
2506 
2507 /* Handle NBD request.
2508  * Return -errno if sending fails. Other errors are reported directly to the
2509  * client as an error reply. */
2510 static coroutine_fn int nbd_handle_request(NBDClient *client,
2511                                            NBDRequest *request,
2512                                            uint8_t *data, Error **errp)
2513 {
2514     int ret;
2515     int flags;
2516     NBDExport *exp = client->exp;
2517     char *msg;
2518     size_t i;
2519 
2520     switch (request->type) {
2521     case NBD_CMD_CACHE:
2522         return nbd_do_cmd_cache(client, request, errp);
2523 
2524     case NBD_CMD_READ:
2525         return nbd_do_cmd_read(client, request, data, errp);
2526 
2527     case NBD_CMD_WRITE:
2528         flags = 0;
2529         if (request->flags & NBD_CMD_FLAG_FUA) {
2530             flags |= BDRV_REQ_FUA;
2531         }
2532         ret = blk_co_pwrite(exp->common.blk, request->from, request->len, data,
2533                             flags);
2534         return nbd_send_generic_reply(client, request, ret,
2535                                       "writing to file failed", errp);
2536 
2537     case NBD_CMD_WRITE_ZEROES:
2538         flags = 0;
2539         if (request->flags & NBD_CMD_FLAG_FUA) {
2540             flags |= BDRV_REQ_FUA;
2541         }
2542         if (!(request->flags & NBD_CMD_FLAG_NO_HOLE)) {
2543             flags |= BDRV_REQ_MAY_UNMAP;
2544         }
2545         if (request->flags & NBD_CMD_FLAG_FAST_ZERO) {
2546             flags |= BDRV_REQ_NO_FALLBACK;
2547         }
2548         ret = blk_co_pwrite_zeroes(exp->common.blk, request->from, request->len,
2549                                    flags);
2550         return nbd_send_generic_reply(client, request, ret,
2551                                       "writing to file failed", errp);
2552 
2553     case NBD_CMD_DISC:
2554         /* unreachable, thanks to special case in nbd_co_receive_request() */
2555         abort();
2556 
2557     case NBD_CMD_FLUSH:
2558         ret = blk_co_flush(exp->common.blk);
2559         return nbd_send_generic_reply(client, request, ret,
2560                                       "flush failed", errp);
2561 
2562     case NBD_CMD_TRIM:
2563         ret = blk_co_pdiscard(exp->common.blk, request->from, request->len);
2564         if (ret >= 0 && request->flags & NBD_CMD_FLAG_FUA) {
2565             ret = blk_co_flush(exp->common.blk);
2566         }
2567         return nbd_send_generic_reply(client, request, ret,
2568                                       "discard failed", errp);
2569 
2570     case NBD_CMD_BLOCK_STATUS:
2571         if (!request->len) {
2572             return nbd_send_generic_reply(client, request, -EINVAL,
2573                                           "need non-zero length", errp);
2574         }
2575         if (client->export_meta.count) {
2576             bool dont_fragment = request->flags & NBD_CMD_FLAG_REQ_ONE;
2577             int contexts_remaining = client->export_meta.count;
2578 
2579             if (client->export_meta.base_allocation) {
2580                 ret = nbd_co_send_block_status(client, request,
2581                                                exp->common.blk,
2582                                                request->from,
2583                                                request->len, dont_fragment,
2584                                                !--contexts_remaining,
2585                                                NBD_META_ID_BASE_ALLOCATION,
2586                                                errp);
2587                 if (ret < 0) {
2588                     return ret;
2589                 }
2590             }
2591 
2592             if (client->export_meta.allocation_depth) {
2593                 ret = nbd_co_send_block_status(client, request,
2594                                                exp->common.blk,
2595                                                request->from, request->len,
2596                                                dont_fragment,
2597                                                !--contexts_remaining,
2598                                                NBD_META_ID_ALLOCATION_DEPTH,
2599                                                errp);
2600                 if (ret < 0) {
2601                     return ret;
2602                 }
2603             }
2604 
2605             for (i = 0; i < client->exp->nr_export_bitmaps; i++) {
2606                 if (!client->export_meta.bitmaps[i]) {
2607                     continue;
2608                 }
2609                 ret = nbd_co_send_bitmap(client, request,
2610                                          client->exp->export_bitmaps[i],
2611                                          request->from, request->len,
2612                                          dont_fragment, !--contexts_remaining,
2613                                          NBD_META_ID_DIRTY_BITMAP + i, errp);
2614                 if (ret < 0) {
2615                     return ret;
2616                 }
2617             }
2618 
2619             assert(!contexts_remaining);
2620 
2621             return 0;
2622         } else {
2623             return nbd_send_generic_reply(client, request, -EINVAL,
2624                                           "CMD_BLOCK_STATUS not negotiated",
2625                                           errp);
2626         }
2627 
2628     default:
2629         msg = g_strdup_printf("invalid request type (%" PRIu32 ") received",
2630                               request->type);
2631         ret = nbd_send_generic_reply(client, request, -EINVAL, msg,
2632                                      errp);
2633         g_free(msg);
2634         return ret;
2635     }
2636 }
2637 
2638 /* Owns a reference to the NBDClient passed as opaque.  */
2639 static coroutine_fn void nbd_trip(void *opaque)
2640 {
2641     NBDClient *client = opaque;
2642     NBDRequestData *req;
2643     NBDRequest request = { 0 };    /* GCC thinks it can be used uninitialized */
2644     int ret;
2645     Error *local_err = NULL;
2646 
2647     trace_nbd_trip();
2648     if (client->closing) {
2649         nbd_client_put(client);
2650         return;
2651     }
2652 
2653     if (client->quiescing) {
2654         /*
2655          * We're switching between AIO contexts. Don't attempt to receive a new
2656          * request and kick the main context which may be waiting for us.
2657          */
2658         nbd_client_put(client);
2659         client->recv_coroutine = NULL;
2660         aio_wait_kick();
2661         return;
2662     }
2663 
2664     req = nbd_request_get(client);
2665     ret = nbd_co_receive_request(req, &request, &local_err);
2666     client->recv_coroutine = NULL;
2667 
2668     if (client->closing) {
2669         /*
2670          * The client may be closed when we are blocked in
2671          * nbd_co_receive_request()
2672          */
2673         goto done;
2674     }
2675 
2676     if (ret == -EAGAIN) {
2677         assert(client->quiescing);
2678         goto done;
2679     }
2680 
2681     nbd_client_receive_next_request(client);
2682     if (ret == -EIO) {
2683         goto disconnect;
2684     }
2685 
2686     qio_channel_set_cork(client->ioc, true);
2687 
2688     if (ret < 0) {
2689         /* It wasn't -EIO, so, according to nbd_co_receive_request()
2690          * semantics, we should return the error to the client. */
2691         Error *export_err = local_err;
2692 
2693         local_err = NULL;
2694         ret = nbd_send_generic_reply(client, &request, -EINVAL,
2695                                      error_get_pretty(export_err), &local_err);
2696         error_free(export_err);
2697     } else {
2698         ret = nbd_handle_request(client, &request, req->data, &local_err);
2699     }
2700     if (ret < 0) {
2701         error_prepend(&local_err, "Failed to send reply: ");
2702         goto disconnect;
2703     }
2704 
2705     /* We must disconnect after NBD_CMD_WRITE if we did not
2706      * read the payload.
2707      */
2708     if (!req->complete) {
2709         error_setg(&local_err, "Request handling failed in intermediate state");
2710         goto disconnect;
2711     }
2712 
2713     qio_channel_set_cork(client->ioc, false);
2714 done:
2715     nbd_request_put(req);
2716     nbd_client_put(client);
2717     return;
2718 
2719 disconnect:
2720     if (local_err) {
2721         error_reportf_err(local_err, "Disconnect client, due to: ");
2722     }
2723     nbd_request_put(req);
2724     client_close(client, true);
2725     nbd_client_put(client);
2726 }
2727 
2728 static void nbd_client_receive_next_request(NBDClient *client)
2729 {
2730     if (!client->recv_coroutine && client->nb_requests < MAX_NBD_REQUESTS &&
2731         !client->quiescing) {
2732         nbd_client_get(client);
2733         client->recv_coroutine = qemu_coroutine_create(nbd_trip, client);
2734         aio_co_schedule(client->exp->common.ctx, client->recv_coroutine);
2735     }
2736 }
2737 
2738 static coroutine_fn void nbd_co_client_start(void *opaque)
2739 {
2740     NBDClient *client = opaque;
2741     Error *local_err = NULL;
2742 
2743     qemu_co_mutex_init(&client->send_lock);
2744 
2745     if (nbd_negotiate(client, &local_err)) {
2746         if (local_err) {
2747             error_report_err(local_err);
2748         }
2749         client_close(client, false);
2750         return;
2751     }
2752 
2753     nbd_client_receive_next_request(client);
2754 }
2755 
2756 /*
2757  * Create a new client listener using the given channel @sioc.
2758  * Begin servicing it in a coroutine.  When the connection closes, call
2759  * @close_fn with an indication of whether the client completed negotiation.
2760  */
2761 void nbd_client_new(QIOChannelSocket *sioc,
2762                     QCryptoTLSCreds *tlscreds,
2763                     const char *tlsauthz,
2764                     void (*close_fn)(NBDClient *, bool))
2765 {
2766     NBDClient *client;
2767     Coroutine *co;
2768 
2769     client = g_new0(NBDClient, 1);
2770     client->refcount = 1;
2771     client->tlscreds = tlscreds;
2772     if (tlscreds) {
2773         object_ref(OBJECT(client->tlscreds));
2774     }
2775     client->tlsauthz = g_strdup(tlsauthz);
2776     client->sioc = sioc;
2777     qio_channel_set_delay(QIO_CHANNEL(sioc), false);
2778     object_ref(OBJECT(client->sioc));
2779     client->ioc = QIO_CHANNEL(sioc);
2780     object_ref(OBJECT(client->ioc));
2781     client->close_fn = close_fn;
2782 
2783     co = qemu_coroutine_create(nbd_co_client_start, client);
2784     qemu_coroutine_enter(co);
2785 }
2786