xref: /openbmc/qemu/block/nfs.c (revision 38472890)
1 /*
2  * QEMU Block driver for native access to files on NFS shares
3  *
4  * Copyright (c) 2014-2017 Peter Lieven <pl@kamp.de>
5  *
6  * Permission is hereby granted, free of charge, to any person obtaining a copy
7  * of this software and associated documentation files (the "Software"), to deal
8  * in the Software without restriction, including without limitation the rights
9  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10  * copies of the Software, and to permit persons to whom the Software is
11  * furnished to do so, subject to the following conditions:
12  *
13  * The above copyright notice and this permission notice shall be included in
14  * all copies or substantial portions of the Software.
15  *
16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
22  * THE SOFTWARE.
23  */
24 
25 #include "qemu/osdep.h"
26 
27 #include <poll.h>
28 #include "qemu/config-file.h"
29 #include "qemu/error-report.h"
30 #include "qapi/error.h"
31 #include "block/block_int.h"
32 #include "block/qdict.h"
33 #include "trace.h"
34 #include "qemu/iov.h"
35 #include "qemu/main-loop.h"
36 #include "qemu/module.h"
37 #include "qemu/option.h"
38 #include "qemu/uri.h"
39 #include "qemu/cutils.h"
40 #include "sysemu/sysemu.h"
41 #include "sysemu/replay.h"
42 #include "qapi/qapi-visit-block-core.h"
43 #include "qapi/qmp/qdict.h"
44 #include "qapi/qmp/qstring.h"
45 #include "qapi/qobject-input-visitor.h"
46 #include "qapi/qobject-output-visitor.h"
47 #include <nfsc/libnfs.h>
48 
49 
50 #define QEMU_NFS_MAX_READAHEAD_SIZE 1048576
51 #define QEMU_NFS_MAX_PAGECACHE_SIZE (8388608 / NFS_BLKSIZE)
52 #define QEMU_NFS_MAX_DEBUG_LEVEL 2
53 
54 typedef struct NFSClient {
55     struct nfs_context *context;
56     struct nfsfh *fh;
57     int events;
58     bool has_zero_init;
59     AioContext *aio_context;
60     QemuMutex mutex;
61     blkcnt_t st_blocks;
62     bool cache_used;
63     NFSServer *server;
64     char *path;
65     int64_t uid, gid, tcp_syncnt, readahead, pagecache, debug;
66 } NFSClient;
67 
68 typedef struct NFSRPC {
69     BlockDriverState *bs;
70     int ret;
71     int complete;
72     QEMUIOVector *iov;
73     struct stat *st;
74     Coroutine *co;
75     NFSClient *client;
76 } NFSRPC;
77 
78 static int nfs_parse_uri(const char *filename, QDict *options, Error **errp)
79 {
80     URI *uri = NULL;
81     QueryParams *qp = NULL;
82     int ret = -EINVAL, i;
83 
84     uri = uri_parse(filename);
85     if (!uri) {
86         error_setg(errp, "Invalid URI specified");
87         goto out;
88     }
89     if (g_strcmp0(uri->scheme, "nfs") != 0) {
90         error_setg(errp, "URI scheme must be 'nfs'");
91         goto out;
92     }
93 
94     if (!uri->server) {
95         error_setg(errp, "missing hostname in URI");
96         goto out;
97     }
98 
99     if (!uri->path) {
100         error_setg(errp, "missing file path in URI");
101         goto out;
102     }
103 
104     qp = query_params_parse(uri->query);
105     if (!qp) {
106         error_setg(errp, "could not parse query parameters");
107         goto out;
108     }
109 
110     qdict_put_str(options, "server.host", uri->server);
111     qdict_put_str(options, "server.type", "inet");
112     qdict_put_str(options, "path", uri->path);
113 
114     for (i = 0; i < qp->n; i++) {
115         unsigned long long val;
116         if (!qp->p[i].value) {
117             error_setg(errp, "Value for NFS parameter expected: %s",
118                        qp->p[i].name);
119             goto out;
120         }
121         if (parse_uint_full(qp->p[i].value, &val, 0)) {
122             error_setg(errp, "Illegal value for NFS parameter: %s",
123                        qp->p[i].name);
124             goto out;
125         }
126         if (!strcmp(qp->p[i].name, "uid")) {
127             qdict_put_str(options, "user", qp->p[i].value);
128         } else if (!strcmp(qp->p[i].name, "gid")) {
129             qdict_put_str(options, "group", qp->p[i].value);
130         } else if (!strcmp(qp->p[i].name, "tcp-syncnt")) {
131             qdict_put_str(options, "tcp-syn-count", qp->p[i].value);
132         } else if (!strcmp(qp->p[i].name, "readahead")) {
133             qdict_put_str(options, "readahead-size", qp->p[i].value);
134         } else if (!strcmp(qp->p[i].name, "pagecache")) {
135             qdict_put_str(options, "page-cache-size", qp->p[i].value);
136         } else if (!strcmp(qp->p[i].name, "debug")) {
137             qdict_put_str(options, "debug", qp->p[i].value);
138         } else {
139             error_setg(errp, "Unknown NFS parameter name: %s",
140                        qp->p[i].name);
141             goto out;
142         }
143     }
144     ret = 0;
145 out:
146     if (qp) {
147         query_params_free(qp);
148     }
149     if (uri) {
150         uri_free(uri);
151     }
152     return ret;
153 }
154 
155 static bool nfs_has_filename_options_conflict(QDict *options, Error **errp)
156 {
157     const QDictEntry *qe;
158 
159     for (qe = qdict_first(options); qe; qe = qdict_next(options, qe)) {
160         if (!strcmp(qe->key, "host") ||
161             !strcmp(qe->key, "path") ||
162             !strcmp(qe->key, "user") ||
163             !strcmp(qe->key, "group") ||
164             !strcmp(qe->key, "tcp-syn-count") ||
165             !strcmp(qe->key, "readahead-size") ||
166             !strcmp(qe->key, "page-cache-size") ||
167             !strcmp(qe->key, "debug") ||
168             strstart(qe->key, "server.", NULL))
169         {
170             error_setg(errp, "Option %s cannot be used with a filename",
171                        qe->key);
172             return true;
173         }
174     }
175 
176     return false;
177 }
178 
179 static void nfs_parse_filename(const char *filename, QDict *options,
180                                Error **errp)
181 {
182     if (nfs_has_filename_options_conflict(options, errp)) {
183         return;
184     }
185 
186     nfs_parse_uri(filename, options, errp);
187 }
188 
189 static void nfs_process_read(void *arg);
190 static void nfs_process_write(void *arg);
191 
192 /* Called with QemuMutex held.  */
193 static void nfs_set_events(NFSClient *client)
194 {
195     int ev = nfs_which_events(client->context);
196     if (ev != client->events) {
197         aio_set_fd_handler(client->aio_context, nfs_get_fd(client->context),
198                            false,
199                            (ev & POLLIN) ? nfs_process_read : NULL,
200                            (ev & POLLOUT) ? nfs_process_write : NULL,
201                            NULL, client);
202 
203     }
204     client->events = ev;
205 }
206 
207 static void nfs_process_read(void *arg)
208 {
209     NFSClient *client = arg;
210 
211     qemu_mutex_lock(&client->mutex);
212     nfs_service(client->context, POLLIN);
213     nfs_set_events(client);
214     qemu_mutex_unlock(&client->mutex);
215 }
216 
217 static void nfs_process_write(void *arg)
218 {
219     NFSClient *client = arg;
220 
221     qemu_mutex_lock(&client->mutex);
222     nfs_service(client->context, POLLOUT);
223     nfs_set_events(client);
224     qemu_mutex_unlock(&client->mutex);
225 }
226 
227 static void nfs_co_init_task(BlockDriverState *bs, NFSRPC *task)
228 {
229     *task = (NFSRPC) {
230         .co             = qemu_coroutine_self(),
231         .bs             = bs,
232         .client         = bs->opaque,
233     };
234 }
235 
236 static void nfs_co_generic_bh_cb(void *opaque)
237 {
238     NFSRPC *task = opaque;
239 
240     task->complete = 1;
241     aio_co_wake(task->co);
242 }
243 
244 /* Called (via nfs_service) with QemuMutex held.  */
245 static void
246 nfs_co_generic_cb(int ret, struct nfs_context *nfs, void *data,
247                   void *private_data)
248 {
249     NFSRPC *task = private_data;
250     task->ret = ret;
251     assert(!task->st);
252     if (task->ret > 0 && task->iov) {
253         if (task->ret <= task->iov->size) {
254             qemu_iovec_from_buf(task->iov, 0, data, task->ret);
255         } else {
256             task->ret = -EIO;
257         }
258     }
259     if (task->ret < 0) {
260         error_report("NFS Error: %s", nfs_get_error(nfs));
261     }
262     replay_bh_schedule_oneshot_event(task->client->aio_context,
263                                      nfs_co_generic_bh_cb, task);
264 }
265 
266 static int coroutine_fn nfs_co_preadv(BlockDriverState *bs, uint64_t offset,
267                                       uint64_t bytes, QEMUIOVector *iov,
268                                       int flags)
269 {
270     NFSClient *client = bs->opaque;
271     NFSRPC task;
272 
273     nfs_co_init_task(bs, &task);
274     task.iov = iov;
275 
276     qemu_mutex_lock(&client->mutex);
277     if (nfs_pread_async(client->context, client->fh,
278                         offset, bytes, nfs_co_generic_cb, &task) != 0) {
279         qemu_mutex_unlock(&client->mutex);
280         return -ENOMEM;
281     }
282 
283     nfs_set_events(client);
284     qemu_mutex_unlock(&client->mutex);
285     while (!task.complete) {
286         qemu_coroutine_yield();
287     }
288 
289     if (task.ret < 0) {
290         return task.ret;
291     }
292 
293     /* zero pad short reads */
294     if (task.ret < iov->size) {
295         qemu_iovec_memset(iov, task.ret, 0, iov->size - task.ret);
296     }
297 
298     return 0;
299 }
300 
301 static int coroutine_fn nfs_co_pwritev(BlockDriverState *bs, uint64_t offset,
302                                        uint64_t bytes, QEMUIOVector *iov,
303                                        int flags)
304 {
305     NFSClient *client = bs->opaque;
306     NFSRPC task;
307     char *buf = NULL;
308     bool my_buffer = false;
309 
310     nfs_co_init_task(bs, &task);
311 
312     if (iov->niov != 1) {
313         buf = g_try_malloc(bytes);
314         if (bytes && buf == NULL) {
315             return -ENOMEM;
316         }
317         qemu_iovec_to_buf(iov, 0, buf, bytes);
318         my_buffer = true;
319     } else {
320         buf = iov->iov[0].iov_base;
321     }
322 
323     qemu_mutex_lock(&client->mutex);
324     if (nfs_pwrite_async(client->context, client->fh,
325                          offset, bytes, buf,
326                          nfs_co_generic_cb, &task) != 0) {
327         qemu_mutex_unlock(&client->mutex);
328         if (my_buffer) {
329             g_free(buf);
330         }
331         return -ENOMEM;
332     }
333 
334     nfs_set_events(client);
335     qemu_mutex_unlock(&client->mutex);
336     while (!task.complete) {
337         qemu_coroutine_yield();
338     }
339 
340     if (my_buffer) {
341         g_free(buf);
342     }
343 
344     if (task.ret != bytes) {
345         return task.ret < 0 ? task.ret : -EIO;
346     }
347 
348     return 0;
349 }
350 
351 static int coroutine_fn nfs_co_flush(BlockDriverState *bs)
352 {
353     NFSClient *client = bs->opaque;
354     NFSRPC task;
355 
356     nfs_co_init_task(bs, &task);
357 
358     qemu_mutex_lock(&client->mutex);
359     if (nfs_fsync_async(client->context, client->fh, nfs_co_generic_cb,
360                         &task) != 0) {
361         qemu_mutex_unlock(&client->mutex);
362         return -ENOMEM;
363     }
364 
365     nfs_set_events(client);
366     qemu_mutex_unlock(&client->mutex);
367     while (!task.complete) {
368         qemu_coroutine_yield();
369     }
370 
371     return task.ret;
372 }
373 
374 static void nfs_detach_aio_context(BlockDriverState *bs)
375 {
376     NFSClient *client = bs->opaque;
377 
378     aio_set_fd_handler(client->aio_context, nfs_get_fd(client->context),
379                        false, NULL, NULL, NULL, NULL);
380     client->events = 0;
381 }
382 
383 static void nfs_attach_aio_context(BlockDriverState *bs,
384                                    AioContext *new_context)
385 {
386     NFSClient *client = bs->opaque;
387 
388     client->aio_context = new_context;
389     nfs_set_events(client);
390 }
391 
392 static void nfs_client_close(NFSClient *client)
393 {
394     if (client->context) {
395         qemu_mutex_lock(&client->mutex);
396         aio_set_fd_handler(client->aio_context, nfs_get_fd(client->context),
397                            false, NULL, NULL, NULL, NULL);
398         qemu_mutex_unlock(&client->mutex);
399         if (client->fh) {
400             nfs_close(client->context, client->fh);
401             client->fh = NULL;
402         }
403 #ifdef LIBNFS_FEATURE_UMOUNT
404         nfs_umount(client->context);
405 #endif
406         nfs_destroy_context(client->context);
407         client->context = NULL;
408     }
409     g_free(client->path);
410     qemu_mutex_destroy(&client->mutex);
411     qapi_free_NFSServer(client->server);
412     client->server = NULL;
413 }
414 
415 static void nfs_file_close(BlockDriverState *bs)
416 {
417     NFSClient *client = bs->opaque;
418     nfs_client_close(client);
419 }
420 
421 static int64_t nfs_client_open(NFSClient *client, BlockdevOptionsNfs *opts,
422                                int flags, int open_flags, Error **errp)
423 {
424     int64_t ret = -EINVAL;
425     struct stat st;
426     char *file = NULL, *strp = NULL;
427 
428     qemu_mutex_init(&client->mutex);
429 
430     client->path = g_strdup(opts->path);
431 
432     strp = strrchr(client->path, '/');
433     if (strp == NULL) {
434         error_setg(errp, "Invalid URL specified");
435         goto fail;
436     }
437     file = g_strdup(strp);
438     *strp = 0;
439 
440     /* Steal the NFSServer object from opts; set the original pointer to NULL
441      * to avoid use after free and double free. */
442     client->server = opts->server;
443     opts->server = NULL;
444 
445     client->context = nfs_init_context();
446     if (client->context == NULL) {
447         error_setg(errp, "Failed to init NFS context");
448         goto fail;
449     }
450 
451     if (opts->has_user) {
452         client->uid = opts->user;
453         nfs_set_uid(client->context, client->uid);
454     }
455 
456     if (opts->has_group) {
457         client->gid = opts->group;
458         nfs_set_gid(client->context, client->gid);
459     }
460 
461     if (opts->has_tcp_syn_count) {
462         client->tcp_syncnt = opts->tcp_syn_count;
463         nfs_set_tcp_syncnt(client->context, client->tcp_syncnt);
464     }
465 
466 #ifdef LIBNFS_FEATURE_READAHEAD
467     if (opts->has_readahead_size) {
468         if (open_flags & BDRV_O_NOCACHE) {
469             error_setg(errp, "Cannot enable NFS readahead "
470                              "if cache.direct = on");
471             goto fail;
472         }
473         client->readahead = opts->readahead_size;
474         if (client->readahead > QEMU_NFS_MAX_READAHEAD_SIZE) {
475             warn_report("Truncating NFS readahead size to %d",
476                         QEMU_NFS_MAX_READAHEAD_SIZE);
477             client->readahead = QEMU_NFS_MAX_READAHEAD_SIZE;
478         }
479         nfs_set_readahead(client->context, client->readahead);
480 #ifdef LIBNFS_FEATURE_PAGECACHE
481         nfs_set_pagecache_ttl(client->context, 0);
482 #endif
483         client->cache_used = true;
484     }
485 #endif
486 
487 #ifdef LIBNFS_FEATURE_PAGECACHE
488     if (opts->has_page_cache_size) {
489         if (open_flags & BDRV_O_NOCACHE) {
490             error_setg(errp, "Cannot enable NFS pagecache "
491                              "if cache.direct = on");
492             goto fail;
493         }
494         client->pagecache = opts->page_cache_size;
495         if (client->pagecache > QEMU_NFS_MAX_PAGECACHE_SIZE) {
496             warn_report("Truncating NFS pagecache size to %d pages",
497                         QEMU_NFS_MAX_PAGECACHE_SIZE);
498             client->pagecache = QEMU_NFS_MAX_PAGECACHE_SIZE;
499         }
500         nfs_set_pagecache(client->context, client->pagecache);
501         nfs_set_pagecache_ttl(client->context, 0);
502         client->cache_used = true;
503     }
504 #endif
505 
506 #ifdef LIBNFS_FEATURE_DEBUG
507     if (opts->has_debug) {
508         client->debug = opts->debug;
509         /* limit the maximum debug level to avoid potential flooding
510          * of our log files. */
511         if (client->debug > QEMU_NFS_MAX_DEBUG_LEVEL) {
512             warn_report("Limiting NFS debug level to %d",
513                         QEMU_NFS_MAX_DEBUG_LEVEL);
514             client->debug = QEMU_NFS_MAX_DEBUG_LEVEL;
515         }
516         nfs_set_debug(client->context, client->debug);
517     }
518 #endif
519 
520     ret = nfs_mount(client->context, client->server->host, client->path);
521     if (ret < 0) {
522         error_setg(errp, "Failed to mount nfs share: %s",
523                    nfs_get_error(client->context));
524         goto fail;
525     }
526 
527     if (flags & O_CREAT) {
528         ret = nfs_creat(client->context, file, 0600, &client->fh);
529         if (ret < 0) {
530             error_setg(errp, "Failed to create file: %s",
531                        nfs_get_error(client->context));
532             goto fail;
533         }
534     } else {
535         ret = nfs_open(client->context, file, flags, &client->fh);
536         if (ret < 0) {
537             error_setg(errp, "Failed to open file : %s",
538                        nfs_get_error(client->context));
539             goto fail;
540         }
541     }
542 
543     ret = nfs_fstat(client->context, client->fh, &st);
544     if (ret < 0) {
545         error_setg(errp, "Failed to fstat file: %s",
546                    nfs_get_error(client->context));
547         goto fail;
548     }
549 
550     ret = DIV_ROUND_UP(st.st_size, BDRV_SECTOR_SIZE);
551     client->st_blocks = st.st_blocks;
552     client->has_zero_init = S_ISREG(st.st_mode);
553     *strp = '/';
554     goto out;
555 
556 fail:
557     nfs_client_close(client);
558 out:
559     g_free(file);
560     return ret;
561 }
562 
563 static BlockdevOptionsNfs *nfs_options_qdict_to_qapi(QDict *options,
564                                                      Error **errp)
565 {
566     BlockdevOptionsNfs *opts = NULL;
567     Visitor *v;
568     const QDictEntry *e;
569     Error *local_err = NULL;
570 
571     v = qobject_input_visitor_new_flat_confused(options, errp);
572     if (!v) {
573         return NULL;
574     }
575 
576     visit_type_BlockdevOptionsNfs(v, NULL, &opts, &local_err);
577     visit_free(v);
578 
579     if (local_err) {
580         error_propagate(errp, local_err);
581         return NULL;
582     }
583 
584     /* Remove the processed options from the QDict (the visitor processes
585      * _all_ options in the QDict) */
586     while ((e = qdict_first(options))) {
587         qdict_del(options, e->key);
588     }
589 
590     return opts;
591 }
592 
593 static int64_t nfs_client_open_qdict(NFSClient *client, QDict *options,
594                                      int flags, int open_flags, Error **errp)
595 {
596     BlockdevOptionsNfs *opts;
597     int ret;
598 
599     opts = nfs_options_qdict_to_qapi(options, errp);
600     if (opts == NULL) {
601         ret = -EINVAL;
602         goto fail;
603     }
604 
605     ret = nfs_client_open(client, opts, flags, open_flags, errp);
606 fail:
607     qapi_free_BlockdevOptionsNfs(opts);
608     return ret;
609 }
610 
611 static int nfs_file_open(BlockDriverState *bs, QDict *options, int flags,
612                          Error **errp) {
613     NFSClient *client = bs->opaque;
614     int64_t ret;
615 
616     client->aio_context = bdrv_get_aio_context(bs);
617 
618     ret = nfs_client_open_qdict(client, options,
619                                 (flags & BDRV_O_RDWR) ? O_RDWR : O_RDONLY,
620                                 bs->open_flags, errp);
621     if (ret < 0) {
622         return ret;
623     }
624 
625     bs->total_sectors = ret;
626     ret = 0;
627     return ret;
628 }
629 
630 static QemuOptsList nfs_create_opts = {
631     .name = "nfs-create-opts",
632     .head = QTAILQ_HEAD_INITIALIZER(nfs_create_opts.head),
633     .desc = {
634         {
635             .name = BLOCK_OPT_SIZE,
636             .type = QEMU_OPT_SIZE,
637             .help = "Virtual disk size"
638         },
639         { /* end of list */ }
640     }
641 };
642 
643 static int nfs_file_co_create(BlockdevCreateOptions *options, Error **errp)
644 {
645     BlockdevCreateOptionsNfs *opts = &options->u.nfs;
646     NFSClient *client = g_new0(NFSClient, 1);
647     int ret;
648 
649     assert(options->driver == BLOCKDEV_DRIVER_NFS);
650 
651     client->aio_context = qemu_get_aio_context();
652 
653     ret = nfs_client_open(client, opts->location, O_CREAT, 0, errp);
654     if (ret < 0) {
655         goto out;
656     }
657     ret = nfs_ftruncate(client->context, client->fh, opts->size);
658     nfs_client_close(client);
659 
660 out:
661     g_free(client);
662     return ret;
663 }
664 
665 static int coroutine_fn nfs_file_co_create_opts(BlockDriver *drv,
666                                                 const char *url,
667                                                 QemuOpts *opts,
668                                                 Error **errp)
669 {
670     BlockdevCreateOptions *create_options;
671     BlockdevCreateOptionsNfs *nfs_opts;
672     QDict *options;
673     int ret;
674 
675     create_options = g_new0(BlockdevCreateOptions, 1);
676     create_options->driver = BLOCKDEV_DRIVER_NFS;
677     nfs_opts = &create_options->u.nfs;
678 
679     /* Read out options */
680     nfs_opts->size = ROUND_UP(qemu_opt_get_size_del(opts, BLOCK_OPT_SIZE, 0),
681                               BDRV_SECTOR_SIZE);
682 
683     options = qdict_new();
684     ret = nfs_parse_uri(url, options, errp);
685     if (ret < 0) {
686         goto out;
687     }
688 
689     nfs_opts->location = nfs_options_qdict_to_qapi(options, errp);
690     if (nfs_opts->location == NULL) {
691         ret = -EINVAL;
692         goto out;
693     }
694 
695     ret = nfs_file_co_create(create_options, errp);
696     if (ret < 0) {
697         goto out;
698     }
699 
700     ret = 0;
701 out:
702     qobject_unref(options);
703     qapi_free_BlockdevCreateOptions(create_options);
704     return ret;
705 }
706 
707 static int nfs_has_zero_init(BlockDriverState *bs)
708 {
709     NFSClient *client = bs->opaque;
710     return client->has_zero_init;
711 }
712 
713 /* Called (via nfs_service) with QemuMutex held.  */
714 static void
715 nfs_get_allocated_file_size_cb(int ret, struct nfs_context *nfs, void *data,
716                                void *private_data)
717 {
718     NFSRPC *task = private_data;
719     task->ret = ret;
720     if (task->ret == 0) {
721         memcpy(task->st, data, sizeof(struct stat));
722     }
723     if (task->ret < 0) {
724         error_report("NFS Error: %s", nfs_get_error(nfs));
725     }
726 
727     /* Set task->complete before reading bs->wakeup.  */
728     atomic_mb_set(&task->complete, 1);
729     bdrv_wakeup(task->bs);
730 }
731 
732 static int64_t nfs_get_allocated_file_size(BlockDriverState *bs)
733 {
734     NFSClient *client = bs->opaque;
735     NFSRPC task = {0};
736     struct stat st;
737 
738     if (bdrv_is_read_only(bs) &&
739         !(bs->open_flags & BDRV_O_NOCACHE)) {
740         return client->st_blocks * 512;
741     }
742 
743     task.bs = bs;
744     task.st = &st;
745     if (nfs_fstat_async(client->context, client->fh, nfs_get_allocated_file_size_cb,
746                         &task) != 0) {
747         return -ENOMEM;
748     }
749 
750     nfs_set_events(client);
751     BDRV_POLL_WHILE(bs, !task.complete);
752 
753     return (task.ret < 0 ? task.ret : st.st_blocks * 512);
754 }
755 
756 static int coroutine_fn
757 nfs_file_co_truncate(BlockDriverState *bs, int64_t offset, bool exact,
758                      PreallocMode prealloc, Error **errp)
759 {
760     NFSClient *client = bs->opaque;
761     int ret;
762 
763     if (prealloc != PREALLOC_MODE_OFF) {
764         error_setg(errp, "Unsupported preallocation mode '%s'",
765                    PreallocMode_str(prealloc));
766         return -ENOTSUP;
767     }
768 
769     ret = nfs_ftruncate(client->context, client->fh, offset);
770     if (ret < 0) {
771         error_setg_errno(errp, -ret, "Failed to truncate file");
772         return ret;
773     }
774 
775     return 0;
776 }
777 
778 /* Note that this will not re-establish a connection with the NFS server
779  * - it is effectively a NOP.  */
780 static int nfs_reopen_prepare(BDRVReopenState *state,
781                               BlockReopenQueue *queue, Error **errp)
782 {
783     NFSClient *client = state->bs->opaque;
784     struct stat st;
785     int ret = 0;
786 
787     if (state->flags & BDRV_O_RDWR && bdrv_is_read_only(state->bs)) {
788         error_setg(errp, "Cannot open a read-only mount as read-write");
789         return -EACCES;
790     }
791 
792     if ((state->flags & BDRV_O_NOCACHE) && client->cache_used) {
793         error_setg(errp, "Cannot disable cache if libnfs readahead or"
794                          " pagecache is enabled");
795         return -EINVAL;
796     }
797 
798     /* Update cache for read-only reopens */
799     if (!(state->flags & BDRV_O_RDWR)) {
800         ret = nfs_fstat(client->context, client->fh, &st);
801         if (ret < 0) {
802             error_setg(errp, "Failed to fstat file: %s",
803                        nfs_get_error(client->context));
804             return ret;
805         }
806         client->st_blocks = st.st_blocks;
807     }
808 
809     return 0;
810 }
811 
812 static void nfs_refresh_filename(BlockDriverState *bs)
813 {
814     NFSClient *client = bs->opaque;
815 
816     if (client->uid && !client->gid) {
817         snprintf(bs->exact_filename, sizeof(bs->exact_filename),
818                  "nfs://%s%s?uid=%" PRId64, client->server->host, client->path,
819                  client->uid);
820     } else if (!client->uid && client->gid) {
821         snprintf(bs->exact_filename, sizeof(bs->exact_filename),
822                  "nfs://%s%s?gid=%" PRId64, client->server->host, client->path,
823                  client->gid);
824     } else if (client->uid && client->gid) {
825         snprintf(bs->exact_filename, sizeof(bs->exact_filename),
826                  "nfs://%s%s?uid=%" PRId64 "&gid=%" PRId64,
827                  client->server->host, client->path, client->uid, client->gid);
828     } else {
829         snprintf(bs->exact_filename, sizeof(bs->exact_filename),
830                  "nfs://%s%s", client->server->host, client->path);
831     }
832 }
833 
834 static char *nfs_dirname(BlockDriverState *bs, Error **errp)
835 {
836     NFSClient *client = bs->opaque;
837 
838     if (client->uid || client->gid) {
839         bdrv_refresh_filename(bs);
840         error_setg(errp, "Cannot generate a base directory for NFS node '%s'",
841                    bs->filename);
842         return NULL;
843     }
844 
845     return g_strdup_printf("nfs://%s%s/", client->server->host, client->path);
846 }
847 
848 #ifdef LIBNFS_FEATURE_PAGECACHE
849 static void coroutine_fn nfs_co_invalidate_cache(BlockDriverState *bs,
850                                                  Error **errp)
851 {
852     NFSClient *client = bs->opaque;
853     nfs_pagecache_invalidate(client->context, client->fh);
854 }
855 #endif
856 
857 static const char *nfs_strong_runtime_opts[] = {
858     "path",
859     "user",
860     "group",
861     "server.",
862 
863     NULL
864 };
865 
866 static BlockDriver bdrv_nfs = {
867     .format_name                    = "nfs",
868     .protocol_name                  = "nfs",
869 
870     .instance_size                  = sizeof(NFSClient),
871     .bdrv_parse_filename            = nfs_parse_filename,
872     .create_opts                    = &nfs_create_opts,
873 
874     .bdrv_has_zero_init             = nfs_has_zero_init,
875     .bdrv_has_zero_init_truncate    = nfs_has_zero_init,
876     .bdrv_get_allocated_file_size   = nfs_get_allocated_file_size,
877     .bdrv_co_truncate               = nfs_file_co_truncate,
878 
879     .bdrv_file_open                 = nfs_file_open,
880     .bdrv_close                     = nfs_file_close,
881     .bdrv_co_create                 = nfs_file_co_create,
882     .bdrv_co_create_opts            = nfs_file_co_create_opts,
883     .bdrv_reopen_prepare            = nfs_reopen_prepare,
884 
885     .bdrv_co_preadv                 = nfs_co_preadv,
886     .bdrv_co_pwritev                = nfs_co_pwritev,
887     .bdrv_co_flush_to_disk          = nfs_co_flush,
888 
889     .bdrv_detach_aio_context        = nfs_detach_aio_context,
890     .bdrv_attach_aio_context        = nfs_attach_aio_context,
891     .bdrv_refresh_filename          = nfs_refresh_filename,
892     .bdrv_dirname                   = nfs_dirname,
893 
894     .strong_runtime_opts            = nfs_strong_runtime_opts,
895 
896 #ifdef LIBNFS_FEATURE_PAGECACHE
897     .bdrv_co_invalidate_cache       = nfs_co_invalidate_cache,
898 #endif
899 };
900 
901 static void nfs_block_init(void)
902 {
903     bdrv_register(&bdrv_nfs);
904 }
905 
906 block_init(nfs_block_init);
907