2 * QEMU Block driver for NBD
4 * Copyright (C) 2008 Bull S.A.S.
5 * Author: Laurent Vivier <Laurent.Vivier@bull.net>
8 * Copyright (C) 2007 Anthony Liguori <anthony@codemonkey.ws>
10 * Permission is hereby granted, free of charge, to any person obtaining a copy
11 * of this software and associated documentation files (the "Software"), to deal
12 * in the Software without restriction, including without limitation the rights
13 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
14 * copies of the Software, and to permit persons to whom the Software is
15 * furnished to do so, subject to the following conditions:
17 * The above copyright notice and this permission notice shall be included in
18 * all copies or substantial portions of the Software.
20 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
21 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
23 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
24 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
25 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
29 #include "nbd-client.h"
30 #include "qemu/sockets.h"
32 #define HANDLE_TO_INDEX(bs, handle) ((handle) ^ ((uint64_t)(intptr_t)bs))
33 #define INDEX_TO_HANDLE(bs, index) ((index) ^ ((uint64_t)(intptr_t)bs))
35 static void nbd_recv_coroutines_enter_all(NbdClientSession
*s
)
39 for (i
= 0; i
< MAX_NBD_REQUESTS
; i
++) {
40 if (s
->recv_coroutine
[i
]) {
41 qemu_coroutine_enter(s
->recv_coroutine
[i
], NULL
);
46 static void nbd_teardown_connection(NbdClientSession
*client
)
48 /* finish any pending coroutines */
49 shutdown(client
->sock
, 2);
50 nbd_recv_coroutines_enter_all(client
);
52 nbd_client_session_detach_aio_context(client
);
53 closesocket(client
->sock
);
57 static void nbd_reply_ready(void *opaque
)
59 NbdClientSession
*s
= opaque
;
63 if (s
->reply
.handle
== 0) {
64 /* No reply already in flight. Fetch a header. It is possible
65 * that another thread has done the same thing in parallel, so
66 * the socket is not readable anymore.
68 ret
= nbd_receive_reply(s
->sock
, &s
->reply
);
78 /* There's no need for a mutex on the receive side, because the
79 * handler acts as a synchronization point and ensures that only
80 * one coroutine is called until the reply finishes. */
81 i
= HANDLE_TO_INDEX(s
, s
->reply
.handle
);
82 if (i
>= MAX_NBD_REQUESTS
) {
86 if (s
->recv_coroutine
[i
]) {
87 qemu_coroutine_enter(s
->recv_coroutine
[i
], NULL
);
92 nbd_teardown_connection(s
);
95 static void nbd_restart_write(void *opaque
)
97 NbdClientSession
*s
= opaque
;
99 qemu_coroutine_enter(s
->send_coroutine
, NULL
);
102 static int nbd_co_send_request(NbdClientSession
*s
,
103 struct nbd_request
*request
,
104 QEMUIOVector
*qiov
, int offset
)
106 AioContext
*aio_context
;
109 qemu_co_mutex_lock(&s
->send_mutex
);
110 s
->send_coroutine
= qemu_coroutine_self();
111 aio_context
= bdrv_get_aio_context(s
->bs
);
112 aio_set_fd_handler(aio_context
, s
->sock
,
113 nbd_reply_ready
, nbd_restart_write
, s
);
116 socket_set_cork(s
->sock
, 1);
118 rc
= nbd_send_request(s
->sock
, request
);
120 ret
= qemu_co_sendv(s
->sock
, qiov
->iov
, qiov
->niov
,
121 offset
, request
->len
);
122 if (ret
!= request
->len
) {
127 socket_set_cork(s
->sock
, 0);
130 rc
= nbd_send_request(s
->sock
, request
);
132 aio_set_fd_handler(aio_context
, s
->sock
, nbd_reply_ready
, NULL
, s
);
133 s
->send_coroutine
= NULL
;
134 qemu_co_mutex_unlock(&s
->send_mutex
);
138 static void nbd_co_receive_reply(NbdClientSession
*s
,
139 struct nbd_request
*request
, struct nbd_reply
*reply
,
140 QEMUIOVector
*qiov
, int offset
)
144 /* Wait until we're woken up by the read handler. TODO: perhaps
145 * peek at the next reply and avoid yielding if it's ours? */
146 qemu_coroutine_yield();
148 if (reply
->handle
!= request
->handle
) {
151 if (qiov
&& reply
->error
== 0) {
152 ret
= qemu_co_recvv(s
->sock
, qiov
->iov
, qiov
->niov
,
153 offset
, request
->len
);
154 if (ret
!= request
->len
) {
159 /* Tell the read handler to read another header. */
164 static void nbd_coroutine_start(NbdClientSession
*s
,
165 struct nbd_request
*request
)
169 /* Poor man semaphore. The free_sema is locked when no other request
170 * can be accepted, and unlocked after receiving one reply. */
171 if (s
->in_flight
>= MAX_NBD_REQUESTS
- 1) {
172 qemu_co_mutex_lock(&s
->free_sema
);
173 assert(s
->in_flight
< MAX_NBD_REQUESTS
);
177 for (i
= 0; i
< MAX_NBD_REQUESTS
; i
++) {
178 if (s
->recv_coroutine
[i
] == NULL
) {
179 s
->recv_coroutine
[i
] = qemu_coroutine_self();
184 assert(i
< MAX_NBD_REQUESTS
);
185 request
->handle
= INDEX_TO_HANDLE(s
, i
);
188 static void nbd_coroutine_end(NbdClientSession
*s
,
189 struct nbd_request
*request
)
191 int i
= HANDLE_TO_INDEX(s
, request
->handle
);
192 s
->recv_coroutine
[i
] = NULL
;
193 if (s
->in_flight
-- == MAX_NBD_REQUESTS
) {
194 qemu_co_mutex_unlock(&s
->free_sema
);
198 static int nbd_co_readv_1(NbdClientSession
*client
, int64_t sector_num
,
199 int nb_sectors
, QEMUIOVector
*qiov
,
202 struct nbd_request request
= { .type
= NBD_CMD_READ
};
203 struct nbd_reply reply
;
206 request
.from
= sector_num
* 512;
207 request
.len
= nb_sectors
* 512;
209 nbd_coroutine_start(client
, &request
);
210 ret
= nbd_co_send_request(client
, &request
, NULL
, 0);
214 nbd_co_receive_reply(client
, &request
, &reply
, qiov
, offset
);
216 nbd_coroutine_end(client
, &request
);
221 static int nbd_co_writev_1(NbdClientSession
*client
, int64_t sector_num
,
222 int nb_sectors
, QEMUIOVector
*qiov
,
225 struct nbd_request request
= { .type
= NBD_CMD_WRITE
};
226 struct nbd_reply reply
;
229 if (!bdrv_enable_write_cache(client
->bs
) &&
230 (client
->nbdflags
& NBD_FLAG_SEND_FUA
)) {
231 request
.type
|= NBD_CMD_FLAG_FUA
;
234 request
.from
= sector_num
* 512;
235 request
.len
= nb_sectors
* 512;
237 nbd_coroutine_start(client
, &request
);
238 ret
= nbd_co_send_request(client
, &request
, qiov
, offset
);
242 nbd_co_receive_reply(client
, &request
, &reply
, NULL
, 0);
244 nbd_coroutine_end(client
, &request
);
248 /* qemu-nbd has a limit of slightly less than 1M per request. Try to
249 * remain aligned to 4K. */
250 #define NBD_MAX_SECTORS 2040
252 int nbd_client_session_co_readv(NbdClientSession
*client
, int64_t sector_num
,
253 int nb_sectors
, QEMUIOVector
*qiov
)
257 while (nb_sectors
> NBD_MAX_SECTORS
) {
258 ret
= nbd_co_readv_1(client
, sector_num
,
259 NBD_MAX_SECTORS
, qiov
, offset
);
263 offset
+= NBD_MAX_SECTORS
* 512;
264 sector_num
+= NBD_MAX_SECTORS
;
265 nb_sectors
-= NBD_MAX_SECTORS
;
267 return nbd_co_readv_1(client
, sector_num
, nb_sectors
, qiov
, offset
);
270 int nbd_client_session_co_writev(NbdClientSession
*client
, int64_t sector_num
,
271 int nb_sectors
, QEMUIOVector
*qiov
)
275 while (nb_sectors
> NBD_MAX_SECTORS
) {
276 ret
= nbd_co_writev_1(client
, sector_num
,
277 NBD_MAX_SECTORS
, qiov
, offset
);
281 offset
+= NBD_MAX_SECTORS
* 512;
282 sector_num
+= NBD_MAX_SECTORS
;
283 nb_sectors
-= NBD_MAX_SECTORS
;
285 return nbd_co_writev_1(client
, sector_num
, nb_sectors
, qiov
, offset
);
288 int nbd_client_session_co_flush(NbdClientSession
*client
)
290 struct nbd_request request
= { .type
= NBD_CMD_FLUSH
};
291 struct nbd_reply reply
;
294 if (!(client
->nbdflags
& NBD_FLAG_SEND_FLUSH
)) {
298 if (client
->nbdflags
& NBD_FLAG_SEND_FUA
) {
299 request
.type
|= NBD_CMD_FLAG_FUA
;
305 nbd_coroutine_start(client
, &request
);
306 ret
= nbd_co_send_request(client
, &request
, NULL
, 0);
310 nbd_co_receive_reply(client
, &request
, &reply
, NULL
, 0);
312 nbd_coroutine_end(client
, &request
);
316 int nbd_client_session_co_discard(NbdClientSession
*client
, int64_t sector_num
,
319 struct nbd_request request
= { .type
= NBD_CMD_TRIM
};
320 struct nbd_reply reply
;
323 if (!(client
->nbdflags
& NBD_FLAG_SEND_TRIM
)) {
326 request
.from
= sector_num
* 512;
327 request
.len
= nb_sectors
* 512;
329 nbd_coroutine_start(client
, &request
);
330 ret
= nbd_co_send_request(client
, &request
, NULL
, 0);
334 nbd_co_receive_reply(client
, &request
, &reply
, NULL
, 0);
336 nbd_coroutine_end(client
, &request
);
341 void nbd_client_session_detach_aio_context(NbdClientSession
*client
)
343 aio_set_fd_handler(bdrv_get_aio_context(client
->bs
), client
->sock
,
347 void nbd_client_session_attach_aio_context(NbdClientSession
*client
,
348 AioContext
*new_context
)
350 aio_set_fd_handler(new_context
, client
->sock
,
351 nbd_reply_ready
, NULL
, client
);
354 void nbd_client_session_close(NbdClientSession
*client
)
356 struct nbd_request request
= {
357 .type
= NBD_CMD_DISC
,
365 if (client
->sock
== -1) {
369 nbd_send_request(client
->sock
, &request
);
371 nbd_teardown_connection(client
);
375 int nbd_client_session_init(NbdClientSession
*client
, BlockDriverState
*bs
,
376 int sock
, const char *export
)
381 logout("session init %s\n", export
);
382 qemu_set_block(sock
);
383 ret
= nbd_receive_negotiate(sock
, export
,
384 &client
->nbdflags
, &client
->size
,
387 logout("Failed to negotiate with the NBD server\n");
392 qemu_co_mutex_init(&client
->send_mutex
);
393 qemu_co_mutex_init(&client
->free_sema
);
397 /* Now that we're connected, set the socket to be non-blocking and
398 * kick the reply mechanism. */
399 qemu_set_nonblock(sock
);
400 nbd_client_session_attach_aio_context(client
, bdrv_get_aio_context(bs
));
402 logout("Established connection with NBD server\n");