docs: add blkdebug block driver documentation
[qemu/cris-port.git] / nbd.c
blobe9b539be58307b880fec09463a97d9ab94c505bb
1 /*
2 * Copyright (C) 2005 Anthony Liguori <anthony@codemonkey.ws>
4 * Network Block Device
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; under version 2 of the License.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program; if not, see <http://www.gnu.org/licenses/>.
19 #include "block/nbd.h"
20 #include "block/block.h"
21 #include "block/block_int.h"
23 #include "block/coroutine.h"
25 #include <errno.h>
26 #include <string.h>
27 #ifndef _WIN32
28 #include <sys/ioctl.h>
29 #endif
30 #if defined(__sun__) || defined(__HAIKU__)
31 #include <sys/ioccom.h>
32 #endif
33 #include <ctype.h>
34 #include <inttypes.h>
36 #ifdef __linux__
37 #include <linux/fs.h>
38 #endif
40 #include "qemu/sockets.h"
41 #include "qemu/queue.h"
42 #include "qemu/main-loop.h"
44 //#define DEBUG_NBD
46 #ifdef DEBUG_NBD
47 #define TRACE(msg, ...) do { \
48 LOG(msg, ## __VA_ARGS__); \
49 } while(0)
50 #else
51 #define TRACE(msg, ...) \
52 do { } while (0)
53 #endif
55 #define LOG(msg, ...) do { \
56 fprintf(stderr, "%s:%s():L%d: " msg "\n", \
57 __FILE__, __FUNCTION__, __LINE__, ## __VA_ARGS__); \
58 } while(0)
60 /* This is all part of the "official" NBD API.
62 * The most up-to-date documentation is available at:
63 * https://github.com/yoe/nbd/blob/master/doc/proto.txt
66 #define NBD_REQUEST_SIZE (4 + 4 + 8 + 8 + 4)
67 #define NBD_REPLY_SIZE (4 + 4 + 8)
68 #define NBD_REQUEST_MAGIC 0x25609513
69 #define NBD_REPLY_MAGIC 0x67446698
70 #define NBD_OPTS_MAGIC 0x49484156454F5054LL
71 #define NBD_CLIENT_MAGIC 0x0000420281861253LL
72 #define NBD_REP_MAGIC 0x3e889045565a9LL
74 #define NBD_SET_SOCK _IO(0xab, 0)
75 #define NBD_SET_BLKSIZE _IO(0xab, 1)
76 #define NBD_SET_SIZE _IO(0xab, 2)
77 #define NBD_DO_IT _IO(0xab, 3)
78 #define NBD_CLEAR_SOCK _IO(0xab, 4)
79 #define NBD_CLEAR_QUE _IO(0xab, 5)
80 #define NBD_PRINT_DEBUG _IO(0xab, 6)
81 #define NBD_SET_SIZE_BLOCKS _IO(0xab, 7)
82 #define NBD_DISCONNECT _IO(0xab, 8)
83 #define NBD_SET_TIMEOUT _IO(0xab, 9)
84 #define NBD_SET_FLAGS _IO(0xab, 10)
86 #define NBD_OPT_EXPORT_NAME (1)
87 #define NBD_OPT_ABORT (2)
88 #define NBD_OPT_LIST (3)
90 /* Definitions for opaque data types */
92 typedef struct NBDRequest NBDRequest;
94 struct NBDRequest {
95 QSIMPLEQ_ENTRY(NBDRequest) entry;
96 NBDClient *client;
97 uint8_t *data;
100 struct NBDExport {
101 int refcount;
102 void (*close)(NBDExport *exp);
104 BlockDriverState *bs;
105 char *name;
106 off_t dev_offset;
107 off_t size;
108 uint32_t nbdflags;
109 QTAILQ_HEAD(, NBDClient) clients;
110 QTAILQ_ENTRY(NBDExport) next;
112 AioContext *ctx;
115 static QTAILQ_HEAD(, NBDExport) exports = QTAILQ_HEAD_INITIALIZER(exports);
117 struct NBDClient {
118 int refcount;
119 void (*close)(NBDClient *client);
121 NBDExport *exp;
122 int sock;
124 Coroutine *recv_coroutine;
126 CoMutex send_lock;
127 Coroutine *send_coroutine;
129 bool can_read;
131 QTAILQ_ENTRY(NBDClient) next;
132 int nb_requests;
133 bool closing;
136 /* That's all folks */
138 static void nbd_set_handlers(NBDClient *client);
139 static void nbd_unset_handlers(NBDClient *client);
140 static void nbd_update_can_read(NBDClient *client);
142 ssize_t nbd_wr_sync(int fd, void *buffer, size_t size, bool do_read)
144 size_t offset = 0;
145 int err;
147 if (qemu_in_coroutine()) {
148 if (do_read) {
149 return qemu_co_recv(fd, buffer, size);
150 } else {
151 return qemu_co_send(fd, buffer, size);
155 while (offset < size) {
156 ssize_t len;
158 if (do_read) {
159 len = qemu_recv(fd, buffer + offset, size - offset, 0);
160 } else {
161 len = send(fd, buffer + offset, size - offset, 0);
164 if (len < 0) {
165 err = socket_error();
167 /* recoverable error */
168 if (err == EINTR || (offset > 0 && (err == EAGAIN || err == EWOULDBLOCK))) {
169 continue;
172 /* unrecoverable error */
173 return -err;
176 /* eof */
177 if (len == 0) {
178 break;
181 offset += len;
184 return offset;
187 static ssize_t read_sync(int fd, void *buffer, size_t size)
189 /* Sockets are kept in blocking mode in the negotiation phase. After
190 * that, a non-readable socket simply means that another thread stole
191 * our request/reply. Synchronization is done with recv_coroutine, so
192 * that this is coroutine-safe.
194 return nbd_wr_sync(fd, buffer, size, true);
197 static ssize_t write_sync(int fd, void *buffer, size_t size)
199 int ret;
200 do {
201 /* For writes, we do expect the socket to be writable. */
202 ret = nbd_wr_sync(fd, buffer, size, false);
203 } while (ret == -EAGAIN);
204 return ret;
207 /* Basic flow for negotiation
209 Server Client
210 Negotiate
214 Server Client
215 Negotiate #1
216 Option
217 Negotiate #2
219 ----
221 followed by
223 Server Client
224 Request
225 Response
226 Request
227 Response
230 Request (type == 2)
234 static int nbd_send_rep(int csock, uint32_t type, uint32_t opt)
236 uint64_t magic;
237 uint32_t len;
239 magic = cpu_to_be64(NBD_REP_MAGIC);
240 if (write_sync(csock, &magic, sizeof(magic)) != sizeof(magic)) {
241 LOG("write failed (rep magic)");
242 return -EINVAL;
244 opt = cpu_to_be32(opt);
245 if (write_sync(csock, &opt, sizeof(opt)) != sizeof(opt)) {
246 LOG("write failed (rep opt)");
247 return -EINVAL;
249 type = cpu_to_be32(type);
250 if (write_sync(csock, &type, sizeof(type)) != sizeof(type)) {
251 LOG("write failed (rep type)");
252 return -EINVAL;
254 len = cpu_to_be32(0);
255 if (write_sync(csock, &len, sizeof(len)) != sizeof(len)) {
256 LOG("write failed (rep data length)");
257 return -EINVAL;
259 return 0;
262 static int nbd_send_rep_list(int csock, NBDExport *exp)
264 uint64_t magic, name_len;
265 uint32_t opt, type, len;
267 name_len = strlen(exp->name);
268 magic = cpu_to_be64(NBD_REP_MAGIC);
269 if (write_sync(csock, &magic, sizeof(magic)) != sizeof(magic)) {
270 LOG("write failed (magic)");
271 return -EINVAL;
273 opt = cpu_to_be32(NBD_OPT_LIST);
274 if (write_sync(csock, &opt, sizeof(opt)) != sizeof(opt)) {
275 LOG("write failed (opt)");
276 return -EINVAL;
278 type = cpu_to_be32(NBD_REP_SERVER);
279 if (write_sync(csock, &type, sizeof(type)) != sizeof(type)) {
280 LOG("write failed (reply type)");
281 return -EINVAL;
283 len = cpu_to_be32(name_len + sizeof(len));
284 if (write_sync(csock, &len, sizeof(len)) != sizeof(len)) {
285 LOG("write failed (length)");
286 return -EINVAL;
288 len = cpu_to_be32(name_len);
289 if (write_sync(csock, &len, sizeof(len)) != sizeof(len)) {
290 LOG("write failed (length)");
291 return -EINVAL;
293 if (write_sync(csock, exp->name, name_len) != name_len) {
294 LOG("write failed (buffer)");
295 return -EINVAL;
297 return 0;
300 static int nbd_handle_list(NBDClient *client, uint32_t length)
302 int csock;
303 NBDExport *exp;
305 csock = client->sock;
306 if (length) {
307 return nbd_send_rep(csock, NBD_REP_ERR_INVALID, NBD_OPT_LIST);
310 /* For each export, send a NBD_REP_SERVER reply. */
311 QTAILQ_FOREACH(exp, &exports, next) {
312 if (nbd_send_rep_list(csock, exp)) {
313 return -EINVAL;
316 /* Finish with a NBD_REP_ACK. */
317 return nbd_send_rep(csock, NBD_REP_ACK, NBD_OPT_LIST);
320 static int nbd_handle_export_name(NBDClient *client, uint32_t length)
322 int rc = -EINVAL, csock = client->sock;
323 char name[256];
325 /* Client sends:
326 [20 .. xx] export name (length bytes)
328 TRACE("Checking length");
329 if (length > 255) {
330 LOG("Bad length received");
331 goto fail;
333 if (read_sync(csock, name, length) != length) {
334 LOG("read failed");
335 goto fail;
337 name[length] = '\0';
339 client->exp = nbd_export_find(name);
340 if (!client->exp) {
341 LOG("export not found");
342 goto fail;
345 QTAILQ_INSERT_TAIL(&client->exp->clients, client, next);
346 nbd_export_get(client->exp);
347 rc = 0;
348 fail:
349 return rc;
352 static int nbd_receive_options(NBDClient *client)
354 while (1) {
355 int csock = client->sock;
356 uint32_t tmp, length;
357 uint64_t magic;
359 /* Client sends:
360 [ 0 .. 3] client flags
361 [ 4 .. 11] NBD_OPTS_MAGIC
362 [12 .. 15] NBD option
363 [16 .. 19] length
364 ... Rest of request
367 if (read_sync(csock, &tmp, sizeof(tmp)) != sizeof(tmp)) {
368 LOG("read failed");
369 return -EINVAL;
371 TRACE("Checking client flags");
372 tmp = be32_to_cpu(tmp);
373 if (tmp != 0 && tmp != NBD_FLAG_C_FIXED_NEWSTYLE) {
374 LOG("Bad client flags received");
375 return -EINVAL;
378 if (read_sync(csock, &magic, sizeof(magic)) != sizeof(magic)) {
379 LOG("read failed");
380 return -EINVAL;
382 TRACE("Checking opts magic");
383 if (magic != be64_to_cpu(NBD_OPTS_MAGIC)) {
384 LOG("Bad magic received");
385 return -EINVAL;
388 if (read_sync(csock, &tmp, sizeof(tmp)) != sizeof(tmp)) {
389 LOG("read failed");
390 return -EINVAL;
393 if (read_sync(csock, &length, sizeof(length)) != sizeof(length)) {
394 LOG("read failed");
395 return -EINVAL;
397 length = be32_to_cpu(length);
399 TRACE("Checking option");
400 switch (be32_to_cpu(tmp)) {
401 case NBD_OPT_LIST:
402 if (nbd_handle_list(client, length) < 0) {
403 return 1;
405 break;
407 case NBD_OPT_ABORT:
408 return -EINVAL;
410 case NBD_OPT_EXPORT_NAME:
411 return nbd_handle_export_name(client, length);
413 default:
414 tmp = be32_to_cpu(tmp);
415 LOG("Unsupported option 0x%x", tmp);
416 nbd_send_rep(client->sock, NBD_REP_ERR_UNSUP, tmp);
417 return -EINVAL;
422 static int nbd_send_negotiate(NBDClient *client)
424 int csock = client->sock;
425 char buf[8 + 8 + 8 + 128];
426 int rc;
427 const int myflags = (NBD_FLAG_HAS_FLAGS | NBD_FLAG_SEND_TRIM |
428 NBD_FLAG_SEND_FLUSH | NBD_FLAG_SEND_FUA);
430 /* Negotiation header without options:
431 [ 0 .. 7] passwd ("NBDMAGIC")
432 [ 8 .. 15] magic (NBD_CLIENT_MAGIC)
433 [16 .. 23] size
434 [24 .. 25] server flags (0)
435 [26 .. 27] export flags
436 [28 .. 151] reserved (0)
438 Negotiation header with options, part 1:
439 [ 0 .. 7] passwd ("NBDMAGIC")
440 [ 8 .. 15] magic (NBD_OPTS_MAGIC)
441 [16 .. 17] server flags (0)
443 part 2 (after options are sent):
444 [18 .. 25] size
445 [26 .. 27] export flags
446 [28 .. 151] reserved (0)
449 qemu_set_block(csock);
450 rc = -EINVAL;
452 TRACE("Beginning negotiation.");
453 memset(buf, 0, sizeof(buf));
454 memcpy(buf, "NBDMAGIC", 8);
455 if (client->exp) {
456 assert ((client->exp->nbdflags & ~65535) == 0);
457 cpu_to_be64w((uint64_t*)(buf + 8), NBD_CLIENT_MAGIC);
458 cpu_to_be64w((uint64_t*)(buf + 16), client->exp->size);
459 cpu_to_be16w((uint16_t*)(buf + 26), client->exp->nbdflags | myflags);
460 } else {
461 cpu_to_be64w((uint64_t*)(buf + 8), NBD_OPTS_MAGIC);
462 cpu_to_be16w((uint16_t *)(buf + 16), NBD_FLAG_FIXED_NEWSTYLE);
465 if (client->exp) {
466 if (write_sync(csock, buf, sizeof(buf)) != sizeof(buf)) {
467 LOG("write failed");
468 goto fail;
470 } else {
471 if (write_sync(csock, buf, 18) != 18) {
472 LOG("write failed");
473 goto fail;
475 rc = nbd_receive_options(client);
476 if (rc != 0) {
477 LOG("option negotiation failed");
478 goto fail;
481 assert ((client->exp->nbdflags & ~65535) == 0);
482 cpu_to_be64w((uint64_t*)(buf + 18), client->exp->size);
483 cpu_to_be16w((uint16_t*)(buf + 26), client->exp->nbdflags | myflags);
484 if (write_sync(csock, buf + 18, sizeof(buf) - 18) != sizeof(buf) - 18) {
485 LOG("write failed");
486 goto fail;
490 TRACE("Negotiation succeeded.");
491 rc = 0;
492 fail:
493 qemu_set_nonblock(csock);
494 return rc;
497 int nbd_receive_negotiate(int csock, const char *name, uint32_t *flags,
498 off_t *size, size_t *blocksize)
500 char buf[256];
501 uint64_t magic, s;
502 uint16_t tmp;
503 int rc;
505 TRACE("Receiving negotiation.");
507 rc = -EINVAL;
509 if (read_sync(csock, buf, 8) != 8) {
510 LOG("read failed");
511 goto fail;
514 buf[8] = '\0';
515 if (strlen(buf) == 0) {
516 LOG("server connection closed");
517 goto fail;
520 TRACE("Magic is %c%c%c%c%c%c%c%c",
521 qemu_isprint(buf[0]) ? buf[0] : '.',
522 qemu_isprint(buf[1]) ? buf[1] : '.',
523 qemu_isprint(buf[2]) ? buf[2] : '.',
524 qemu_isprint(buf[3]) ? buf[3] : '.',
525 qemu_isprint(buf[4]) ? buf[4] : '.',
526 qemu_isprint(buf[5]) ? buf[5] : '.',
527 qemu_isprint(buf[6]) ? buf[6] : '.',
528 qemu_isprint(buf[7]) ? buf[7] : '.');
530 if (memcmp(buf, "NBDMAGIC", 8) != 0) {
531 LOG("Invalid magic received");
532 goto fail;
535 if (read_sync(csock, &magic, sizeof(magic)) != sizeof(magic)) {
536 LOG("read failed");
537 goto fail;
539 magic = be64_to_cpu(magic);
540 TRACE("Magic is 0x%" PRIx64, magic);
542 if (name) {
543 uint32_t reserved = 0;
544 uint32_t opt;
545 uint32_t namesize;
547 TRACE("Checking magic (opts_magic)");
548 if (magic != NBD_OPTS_MAGIC) {
549 LOG("Bad magic received");
550 goto fail;
552 if (read_sync(csock, &tmp, sizeof(tmp)) != sizeof(tmp)) {
553 LOG("flags read failed");
554 goto fail;
556 *flags = be16_to_cpu(tmp) << 16;
557 /* reserved for future use */
558 if (write_sync(csock, &reserved, sizeof(reserved)) !=
559 sizeof(reserved)) {
560 LOG("write failed (reserved)");
561 goto fail;
563 /* write the export name */
564 magic = cpu_to_be64(magic);
565 if (write_sync(csock, &magic, sizeof(magic)) != sizeof(magic)) {
566 LOG("write failed (magic)");
567 goto fail;
569 opt = cpu_to_be32(NBD_OPT_EXPORT_NAME);
570 if (write_sync(csock, &opt, sizeof(opt)) != sizeof(opt)) {
571 LOG("write failed (opt)");
572 goto fail;
574 namesize = cpu_to_be32(strlen(name));
575 if (write_sync(csock, &namesize, sizeof(namesize)) !=
576 sizeof(namesize)) {
577 LOG("write failed (namesize)");
578 goto fail;
580 if (write_sync(csock, (char*)name, strlen(name)) != strlen(name)) {
581 LOG("write failed (name)");
582 goto fail;
584 } else {
585 TRACE("Checking magic (cli_magic)");
587 if (magic != NBD_CLIENT_MAGIC) {
588 LOG("Bad magic received");
589 goto fail;
593 if (read_sync(csock, &s, sizeof(s)) != sizeof(s)) {
594 LOG("read failed");
595 goto fail;
597 *size = be64_to_cpu(s);
598 *blocksize = 1024;
599 TRACE("Size is %" PRIu64, *size);
601 if (!name) {
602 if (read_sync(csock, flags, sizeof(*flags)) != sizeof(*flags)) {
603 LOG("read failed (flags)");
604 goto fail;
606 *flags = be32_to_cpup(flags);
607 } else {
608 if (read_sync(csock, &tmp, sizeof(tmp)) != sizeof(tmp)) {
609 LOG("read failed (tmp)");
610 goto fail;
612 *flags |= be32_to_cpu(tmp);
614 if (read_sync(csock, &buf, 124) != 124) {
615 LOG("read failed (buf)");
616 goto fail;
618 rc = 0;
620 fail:
621 return rc;
624 #ifdef __linux__
625 int nbd_init(int fd, int csock, uint32_t flags, off_t size, size_t blocksize)
627 TRACE("Setting NBD socket");
629 if (ioctl(fd, NBD_SET_SOCK, csock) < 0) {
630 int serrno = errno;
631 LOG("Failed to set NBD socket");
632 return -serrno;
635 TRACE("Setting block size to %lu", (unsigned long)blocksize);
637 if (ioctl(fd, NBD_SET_BLKSIZE, blocksize) < 0) {
638 int serrno = errno;
639 LOG("Failed setting NBD block size");
640 return -serrno;
643 TRACE("Setting size to %zd block(s)", (size_t)(size / blocksize));
645 if (ioctl(fd, NBD_SET_SIZE_BLOCKS, size / blocksize) < 0) {
646 int serrno = errno;
647 LOG("Failed setting size (in blocks)");
648 return -serrno;
651 if (ioctl(fd, NBD_SET_FLAGS, flags) < 0) {
652 if (errno == ENOTTY) {
653 int read_only = (flags & NBD_FLAG_READ_ONLY) != 0;
654 TRACE("Setting readonly attribute");
656 if (ioctl(fd, BLKROSET, (unsigned long) &read_only) < 0) {
657 int serrno = errno;
658 LOG("Failed setting read-only attribute");
659 return -serrno;
661 } else {
662 int serrno = errno;
663 LOG("Failed setting flags");
664 return -serrno;
668 TRACE("Negotiation ended");
670 return 0;
673 int nbd_disconnect(int fd)
675 ioctl(fd, NBD_CLEAR_QUE);
676 ioctl(fd, NBD_DISCONNECT);
677 ioctl(fd, NBD_CLEAR_SOCK);
678 return 0;
681 int nbd_client(int fd)
683 int ret;
684 int serrno;
686 TRACE("Doing NBD loop");
688 ret = ioctl(fd, NBD_DO_IT);
689 if (ret < 0 && errno == EPIPE) {
690 /* NBD_DO_IT normally returns EPIPE when someone has disconnected
691 * the socket via NBD_DISCONNECT. We do not want to return 1 in
692 * that case.
694 ret = 0;
696 serrno = errno;
698 TRACE("NBD loop returned %d: %s", ret, strerror(serrno));
700 TRACE("Clearing NBD queue");
701 ioctl(fd, NBD_CLEAR_QUE);
703 TRACE("Clearing NBD socket");
704 ioctl(fd, NBD_CLEAR_SOCK);
706 errno = serrno;
707 return ret;
709 #else
710 int nbd_init(int fd, int csock, uint32_t flags, off_t size, size_t blocksize)
712 return -ENOTSUP;
715 int nbd_disconnect(int fd)
717 return -ENOTSUP;
720 int nbd_client(int fd)
722 return -ENOTSUP;
724 #endif
726 ssize_t nbd_send_request(int csock, struct nbd_request *request)
728 uint8_t buf[NBD_REQUEST_SIZE];
729 ssize_t ret;
731 cpu_to_be32w((uint32_t*)buf, NBD_REQUEST_MAGIC);
732 cpu_to_be32w((uint32_t*)(buf + 4), request->type);
733 cpu_to_be64w((uint64_t*)(buf + 8), request->handle);
734 cpu_to_be64w((uint64_t*)(buf + 16), request->from);
735 cpu_to_be32w((uint32_t*)(buf + 24), request->len);
737 TRACE("Sending request to client: "
738 "{ .from = %" PRIu64", .len = %u, .handle = %" PRIu64", .type=%i}",
739 request->from, request->len, request->handle, request->type);
741 ret = write_sync(csock, buf, sizeof(buf));
742 if (ret < 0) {
743 return ret;
746 if (ret != sizeof(buf)) {
747 LOG("writing to socket failed");
748 return -EINVAL;
750 return 0;
753 static ssize_t nbd_receive_request(int csock, struct nbd_request *request)
755 uint8_t buf[NBD_REQUEST_SIZE];
756 uint32_t magic;
757 ssize_t ret;
759 ret = read_sync(csock, buf, sizeof(buf));
760 if (ret < 0) {
761 return ret;
764 if (ret != sizeof(buf)) {
765 LOG("read failed");
766 return -EINVAL;
769 /* Request
770 [ 0 .. 3] magic (NBD_REQUEST_MAGIC)
771 [ 4 .. 7] type (0 == READ, 1 == WRITE)
772 [ 8 .. 15] handle
773 [16 .. 23] from
774 [24 .. 27] len
777 magic = be32_to_cpup((uint32_t*)buf);
778 request->type = be32_to_cpup((uint32_t*)(buf + 4));
779 request->handle = be64_to_cpup((uint64_t*)(buf + 8));
780 request->from = be64_to_cpup((uint64_t*)(buf + 16));
781 request->len = be32_to_cpup((uint32_t*)(buf + 24));
783 TRACE("Got request: "
784 "{ magic = 0x%x, .type = %d, from = %" PRIu64" , len = %u }",
785 magic, request->type, request->from, request->len);
787 if (magic != NBD_REQUEST_MAGIC) {
788 LOG("invalid magic (got 0x%x)", magic);
789 return -EINVAL;
791 return 0;
794 ssize_t nbd_receive_reply(int csock, struct nbd_reply *reply)
796 uint8_t buf[NBD_REPLY_SIZE];
797 uint32_t magic;
798 ssize_t ret;
800 ret = read_sync(csock, buf, sizeof(buf));
801 if (ret < 0) {
802 return ret;
805 if (ret != sizeof(buf)) {
806 LOG("read failed");
807 return -EINVAL;
810 /* Reply
811 [ 0 .. 3] magic (NBD_REPLY_MAGIC)
812 [ 4 .. 7] error (0 == no error)
813 [ 7 .. 15] handle
816 magic = be32_to_cpup((uint32_t*)buf);
817 reply->error = be32_to_cpup((uint32_t*)(buf + 4));
818 reply->handle = be64_to_cpup((uint64_t*)(buf + 8));
820 TRACE("Got reply: "
821 "{ magic = 0x%x, .error = %d, handle = %" PRIu64" }",
822 magic, reply->error, reply->handle);
824 if (magic != NBD_REPLY_MAGIC) {
825 LOG("invalid magic (got 0x%x)", magic);
826 return -EINVAL;
828 return 0;
831 static ssize_t nbd_send_reply(int csock, struct nbd_reply *reply)
833 uint8_t buf[NBD_REPLY_SIZE];
834 ssize_t ret;
836 /* Reply
837 [ 0 .. 3] magic (NBD_REPLY_MAGIC)
838 [ 4 .. 7] error (0 == no error)
839 [ 7 .. 15] handle
841 cpu_to_be32w((uint32_t*)buf, NBD_REPLY_MAGIC);
842 cpu_to_be32w((uint32_t*)(buf + 4), reply->error);
843 cpu_to_be64w((uint64_t*)(buf + 8), reply->handle);
845 TRACE("Sending response to client");
847 ret = write_sync(csock, buf, sizeof(buf));
848 if (ret < 0) {
849 return ret;
852 if (ret != sizeof(buf)) {
853 LOG("writing to socket failed");
854 return -EINVAL;
856 return 0;
859 #define MAX_NBD_REQUESTS 16
861 void nbd_client_get(NBDClient *client)
863 client->refcount++;
866 void nbd_client_put(NBDClient *client)
868 if (--client->refcount == 0) {
869 /* The last reference should be dropped by client->close,
870 * which is called by nbd_client_close.
872 assert(client->closing);
874 nbd_unset_handlers(client);
875 close(client->sock);
876 client->sock = -1;
877 if (client->exp) {
878 QTAILQ_REMOVE(&client->exp->clients, client, next);
879 nbd_export_put(client->exp);
881 g_free(client);
885 void nbd_client_close(NBDClient *client)
887 if (client->closing) {
888 return;
891 client->closing = true;
893 /* Force requests to finish. They will drop their own references,
894 * then we'll close the socket and free the NBDClient.
896 shutdown(client->sock, 2);
898 /* Also tell the client, so that they release their reference. */
899 if (client->close) {
900 client->close(client);
904 static NBDRequest *nbd_request_get(NBDClient *client)
906 NBDRequest *req;
908 assert(client->nb_requests <= MAX_NBD_REQUESTS - 1);
909 client->nb_requests++;
910 nbd_update_can_read(client);
912 req = g_slice_new0(NBDRequest);
913 nbd_client_get(client);
914 req->client = client;
915 return req;
918 static void nbd_request_put(NBDRequest *req)
920 NBDClient *client = req->client;
922 if (req->data) {
923 qemu_vfree(req->data);
925 g_slice_free(NBDRequest, req);
927 client->nb_requests--;
928 nbd_update_can_read(client);
929 nbd_client_put(client);
932 static void bs_aio_attached(AioContext *ctx, void *opaque)
934 NBDExport *exp = opaque;
935 NBDClient *client;
937 TRACE("Export %s: Attaching clients to AIO context %p\n", exp->name, ctx);
939 exp->ctx = ctx;
941 QTAILQ_FOREACH(client, &exp->clients, next) {
942 nbd_set_handlers(client);
946 static void bs_aio_detach(void *opaque)
948 NBDExport *exp = opaque;
949 NBDClient *client;
951 TRACE("Export %s: Detaching clients from AIO context %p\n", exp->name, exp->ctx);
953 QTAILQ_FOREACH(client, &exp->clients, next) {
954 nbd_unset_handlers(client);
957 exp->ctx = NULL;
960 NBDExport *nbd_export_new(BlockDriverState *bs, off_t dev_offset,
961 off_t size, uint32_t nbdflags,
962 void (*close)(NBDExport *))
964 NBDExport *exp = g_malloc0(sizeof(NBDExport));
965 exp->refcount = 1;
966 QTAILQ_INIT(&exp->clients);
967 exp->bs = bs;
968 exp->dev_offset = dev_offset;
969 exp->nbdflags = nbdflags;
970 exp->size = size == -1 ? bdrv_getlength(bs) : size;
971 exp->close = close;
972 exp->ctx = bdrv_get_aio_context(bs);
973 bdrv_ref(bs);
974 bdrv_add_aio_context_notifier(bs, bs_aio_attached, bs_aio_detach, exp);
975 return exp;
978 NBDExport *nbd_export_find(const char *name)
980 NBDExport *exp;
981 QTAILQ_FOREACH(exp, &exports, next) {
982 if (strcmp(name, exp->name) == 0) {
983 return exp;
987 return NULL;
990 void nbd_export_set_name(NBDExport *exp, const char *name)
992 if (exp->name == name) {
993 return;
996 nbd_export_get(exp);
997 if (exp->name != NULL) {
998 g_free(exp->name);
999 exp->name = NULL;
1000 QTAILQ_REMOVE(&exports, exp, next);
1001 nbd_export_put(exp);
1003 if (name != NULL) {
1004 nbd_export_get(exp);
1005 exp->name = g_strdup(name);
1006 QTAILQ_INSERT_TAIL(&exports, exp, next);
1008 nbd_export_put(exp);
1011 void nbd_export_close(NBDExport *exp)
1013 NBDClient *client, *next;
1015 nbd_export_get(exp);
1016 QTAILQ_FOREACH_SAFE(client, &exp->clients, next, next) {
1017 nbd_client_close(client);
1019 nbd_export_set_name(exp, NULL);
1020 nbd_export_put(exp);
1021 if (exp->bs) {
1022 bdrv_remove_aio_context_notifier(exp->bs, bs_aio_attached,
1023 bs_aio_detach, exp);
1024 bdrv_unref(exp->bs);
1025 exp->bs = NULL;
1029 void nbd_export_get(NBDExport *exp)
1031 assert(exp->refcount > 0);
1032 exp->refcount++;
1035 void nbd_export_put(NBDExport *exp)
1037 assert(exp->refcount > 0);
1038 if (exp->refcount == 1) {
1039 nbd_export_close(exp);
1042 if (--exp->refcount == 0) {
1043 assert(exp->name == NULL);
1045 if (exp->close) {
1046 exp->close(exp);
1049 g_free(exp);
1053 BlockDriverState *nbd_export_get_blockdev(NBDExport *exp)
1055 return exp->bs;
1058 void nbd_export_close_all(void)
1060 NBDExport *exp, *next;
1062 QTAILQ_FOREACH_SAFE(exp, &exports, next, next) {
1063 nbd_export_close(exp);
1067 static ssize_t nbd_co_send_reply(NBDRequest *req, struct nbd_reply *reply,
1068 int len)
1070 NBDClient *client = req->client;
1071 int csock = client->sock;
1072 ssize_t rc, ret;
1074 qemu_co_mutex_lock(&client->send_lock);
1075 client->send_coroutine = qemu_coroutine_self();
1076 nbd_set_handlers(client);
1078 if (!len) {
1079 rc = nbd_send_reply(csock, reply);
1080 } else {
1081 socket_set_cork(csock, 1);
1082 rc = nbd_send_reply(csock, reply);
1083 if (rc >= 0) {
1084 ret = qemu_co_send(csock, req->data, len);
1085 if (ret != len) {
1086 rc = -EIO;
1089 socket_set_cork(csock, 0);
1092 client->send_coroutine = NULL;
1093 nbd_set_handlers(client);
1094 qemu_co_mutex_unlock(&client->send_lock);
1095 return rc;
1098 static ssize_t nbd_co_receive_request(NBDRequest *req, struct nbd_request *request)
1100 NBDClient *client = req->client;
1101 int csock = client->sock;
1102 uint32_t command;
1103 ssize_t rc;
1105 client->recv_coroutine = qemu_coroutine_self();
1106 nbd_update_can_read(client);
1108 rc = nbd_receive_request(csock, request);
1109 if (rc < 0) {
1110 if (rc != -EAGAIN) {
1111 rc = -EIO;
1113 goto out;
1116 if (request->len > NBD_MAX_BUFFER_SIZE) {
1117 LOG("len (%u) is larger than max len (%u)",
1118 request->len, NBD_MAX_BUFFER_SIZE);
1119 rc = -EINVAL;
1120 goto out;
1123 if ((request->from + request->len) < request->from) {
1124 LOG("integer overflow detected! "
1125 "you're probably being attacked");
1126 rc = -EINVAL;
1127 goto out;
1130 TRACE("Decoding type");
1132 command = request->type & NBD_CMD_MASK_COMMAND;
1133 if (command == NBD_CMD_READ || command == NBD_CMD_WRITE) {
1134 req->data = qemu_blockalign(client->exp->bs, request->len);
1136 if (command == NBD_CMD_WRITE) {
1137 TRACE("Reading %u byte(s)", request->len);
1139 if (qemu_co_recv(csock, req->data, request->len) != request->len) {
1140 LOG("reading from socket failed");
1141 rc = -EIO;
1142 goto out;
1145 rc = 0;
1147 out:
1148 client->recv_coroutine = NULL;
1149 nbd_update_can_read(client);
1151 return rc;
1154 static void nbd_trip(void *opaque)
1156 NBDClient *client = opaque;
1157 NBDExport *exp = client->exp;
1158 NBDRequest *req;
1159 struct nbd_request request;
1160 struct nbd_reply reply;
1161 ssize_t ret;
1162 uint32_t command;
1164 TRACE("Reading request.");
1165 if (client->closing) {
1166 return;
1169 req = nbd_request_get(client);
1170 ret = nbd_co_receive_request(req, &request);
1171 if (ret == -EAGAIN) {
1172 goto done;
1174 if (ret == -EIO) {
1175 goto out;
1178 reply.handle = request.handle;
1179 reply.error = 0;
1181 if (ret < 0) {
1182 reply.error = -ret;
1183 goto error_reply;
1185 command = request.type & NBD_CMD_MASK_COMMAND;
1186 if (command != NBD_CMD_DISC && (request.from + request.len) > exp->size) {
1187 LOG("From: %" PRIu64 ", Len: %u, Size: %" PRIu64
1188 ", Offset: %" PRIu64 "\n",
1189 request.from, request.len,
1190 (uint64_t)exp->size, (uint64_t)exp->dev_offset);
1191 LOG("requested operation past EOF--bad client?");
1192 goto invalid_request;
1195 switch (command) {
1196 case NBD_CMD_READ:
1197 TRACE("Request type is READ");
1199 if (request.type & NBD_CMD_FLAG_FUA) {
1200 ret = bdrv_co_flush(exp->bs);
1201 if (ret < 0) {
1202 LOG("flush failed");
1203 reply.error = -ret;
1204 goto error_reply;
1208 ret = bdrv_read(exp->bs, (request.from + exp->dev_offset) / 512,
1209 req->data, request.len / 512);
1210 if (ret < 0) {
1211 LOG("reading from file failed");
1212 reply.error = -ret;
1213 goto error_reply;
1216 TRACE("Read %u byte(s)", request.len);
1217 if (nbd_co_send_reply(req, &reply, request.len) < 0)
1218 goto out;
1219 break;
1220 case NBD_CMD_WRITE:
1221 TRACE("Request type is WRITE");
1223 if (exp->nbdflags & NBD_FLAG_READ_ONLY) {
1224 TRACE("Server is read-only, return error");
1225 reply.error = EROFS;
1226 goto error_reply;
1229 TRACE("Writing to device");
1231 ret = bdrv_write(exp->bs, (request.from + exp->dev_offset) / 512,
1232 req->data, request.len / 512);
1233 if (ret < 0) {
1234 LOG("writing to file failed");
1235 reply.error = -ret;
1236 goto error_reply;
1239 if (request.type & NBD_CMD_FLAG_FUA) {
1240 ret = bdrv_co_flush(exp->bs);
1241 if (ret < 0) {
1242 LOG("flush failed");
1243 reply.error = -ret;
1244 goto error_reply;
1248 if (nbd_co_send_reply(req, &reply, 0) < 0) {
1249 goto out;
1251 break;
1252 case NBD_CMD_DISC:
1253 TRACE("Request type is DISCONNECT");
1254 errno = 0;
1255 goto out;
1256 case NBD_CMD_FLUSH:
1257 TRACE("Request type is FLUSH");
1259 ret = bdrv_co_flush(exp->bs);
1260 if (ret < 0) {
1261 LOG("flush failed");
1262 reply.error = -ret;
1264 if (nbd_co_send_reply(req, &reply, 0) < 0) {
1265 goto out;
1267 break;
1268 case NBD_CMD_TRIM:
1269 TRACE("Request type is TRIM");
1270 ret = bdrv_co_discard(exp->bs, (request.from + exp->dev_offset) / 512,
1271 request.len / 512);
1272 if (ret < 0) {
1273 LOG("discard failed");
1274 reply.error = -ret;
1276 if (nbd_co_send_reply(req, &reply, 0) < 0) {
1277 goto out;
1279 break;
1280 default:
1281 LOG("invalid request type (%u) received", request.type);
1282 invalid_request:
1283 reply.error = -EINVAL;
1284 error_reply:
1285 if (nbd_co_send_reply(req, &reply, 0) < 0) {
1286 goto out;
1288 break;
1291 TRACE("Request/Reply complete");
1293 done:
1294 nbd_request_put(req);
1295 return;
1297 out:
1298 nbd_request_put(req);
1299 nbd_client_close(client);
1302 static void nbd_read(void *opaque)
1304 NBDClient *client = opaque;
1306 if (client->recv_coroutine) {
1307 qemu_coroutine_enter(client->recv_coroutine, NULL);
1308 } else {
1309 qemu_coroutine_enter(qemu_coroutine_create(nbd_trip), client);
1313 static void nbd_restart_write(void *opaque)
1315 NBDClient *client = opaque;
1317 qemu_coroutine_enter(client->send_coroutine, NULL);
1320 static void nbd_set_handlers(NBDClient *client)
1322 if (client->exp && client->exp->ctx) {
1323 aio_set_fd_handler(client->exp->ctx, client->sock,
1324 client->can_read ? nbd_read : NULL,
1325 client->send_coroutine ? nbd_restart_write : NULL,
1326 client);
1330 static void nbd_unset_handlers(NBDClient *client)
1332 if (client->exp && client->exp->ctx) {
1333 aio_set_fd_handler(client->exp->ctx, client->sock, NULL, NULL, NULL);
1337 static void nbd_update_can_read(NBDClient *client)
1339 bool can_read = client->recv_coroutine ||
1340 client->nb_requests < MAX_NBD_REQUESTS;
1342 if (can_read != client->can_read) {
1343 client->can_read = can_read;
1344 nbd_set_handlers(client);
1346 /* There is no need to invoke aio_notify(), since aio_set_fd_handler()
1347 * in nbd_set_handlers() will have taken care of that */
1351 NBDClient *nbd_client_new(NBDExport *exp, int csock,
1352 void (*close)(NBDClient *))
1354 NBDClient *client;
1355 client = g_malloc0(sizeof(NBDClient));
1356 client->refcount = 1;
1357 client->exp = exp;
1358 client->sock = csock;
1359 client->can_read = true;
1360 if (nbd_send_negotiate(client)) {
1361 g_free(client);
1362 return NULL;
1364 client->close = close;
1365 qemu_co_mutex_init(&client->send_lock);
1366 nbd_set_handlers(client);
1368 if (exp) {
1369 QTAILQ_INSERT_TAIL(&exp->clients, client, next);
1370 nbd_export_get(exp);
1372 return client;