qemu

FORK: QEMU emulator
git clone https://git.neptards.moe/neptards/qemu.git
Log | Files | Refs | Submodules | LICENSE

virtio-9p-client.c (27529B)


      1 /*
      2  * 9P network client for VirtIO 9P test cases (based on QTest)
      3  *
      4  * Copyright (c) 2014 SUSE LINUX Products GmbH
      5  *
      6  * This work is licensed under the terms of the GNU GPL, version 2 or later.
      7  * See the COPYING file in the top-level directory.
      8  */
      9 
     10 /*
     11  * Not so fast! You might want to read the 9p developer docs first:
     12  * https://wiki.qemu.org/Documentation/9p
     13  */
     14 
     15 #include "qemu/osdep.h"
     16 #include "virtio-9p-client.h"
     17 
     18 #define QVIRTIO_9P_TIMEOUT_US (10 * 1000 * 1000)
     19 static QGuestAllocator *alloc;
     20 
     21 void v9fs_set_allocator(QGuestAllocator *t_alloc)
     22 {
     23     alloc = t_alloc;
     24 }
     25 
     26 /*
     27  * Used to auto generate new fids. Start with arbitrary high value to avoid
     28  * collision with hard coded fids in basic test code.
     29  */
     30 static uint32_t fid_generator = 1000;
     31 
     32 static uint32_t genfid(void)
     33 {
     34     return fid_generator++;
     35 }
     36 
     37 /**
     38  * Splits the @a in string by @a delim into individual (non empty) strings
     39  * and outputs them to @a out. The output array @a out is NULL terminated.
     40  *
     41  * Output array @a out must be freed by calling split_free().
     42  *
     43  * @returns number of individual elements in output array @a out (without the
     44  *          final NULL terminating element)
     45  */
     46 static int split(const char *in, const char *delim, char ***out)
     47 {
     48     int n = 0, i = 0;
     49     char *tmp, *p;
     50 
     51     tmp = g_strdup(in);
     52     for (p = strtok(tmp, delim); p != NULL; p = strtok(NULL, delim)) {
     53         if (strlen(p) > 0) {
     54             ++n;
     55         }
     56     }
     57     g_free(tmp);
     58 
     59     *out = g_new0(char *, n + 1); /* last element NULL delimiter */
     60 
     61     tmp = g_strdup(in);
     62     for (p = strtok(tmp, delim); p != NULL; p = strtok(NULL, delim)) {
     63         if (strlen(p) > 0) {
     64             (*out)[i++] = g_strdup(p);
     65         }
     66     }
     67     g_free(tmp);
     68 
     69     return n;
     70 }
     71 
     72 static void split_free(char ***out)
     73 {
     74     int i;
     75     if (!*out) {
     76         return;
     77     }
     78     for (i = 0; (*out)[i]; ++i) {
     79         g_free((*out)[i]);
     80     }
     81     g_free(*out);
     82     *out = NULL;
     83 }
     84 
     85 void v9fs_memwrite(P9Req *req, const void *addr, size_t len)
     86 {
     87     qtest_memwrite(req->qts, req->t_msg + req->t_off, addr, len);
     88     req->t_off += len;
     89 }
     90 
     91 void v9fs_memskip(P9Req *req, size_t len)
     92 {
     93     req->r_off += len;
     94 }
     95 
     96 void v9fs_memread(P9Req *req, void *addr, size_t len)
     97 {
     98     qtest_memread(req->qts, req->r_msg + req->r_off, addr, len);
     99     req->r_off += len;
    100 }
    101 
    102 void v9fs_uint8_read(P9Req *req, uint8_t *val)
    103 {
    104     v9fs_memread(req, val, 1);
    105 }
    106 
    107 void v9fs_uint16_write(P9Req *req, uint16_t val)
    108 {
    109     uint16_t le_val = cpu_to_le16(val);
    110 
    111     v9fs_memwrite(req, &le_val, 2);
    112 }
    113 
    114 void v9fs_uint16_read(P9Req *req, uint16_t *val)
    115 {
    116     v9fs_memread(req, val, 2);
    117     le16_to_cpus(val);
    118 }
    119 
    120 void v9fs_uint32_write(P9Req *req, uint32_t val)
    121 {
    122     uint32_t le_val = cpu_to_le32(val);
    123 
    124     v9fs_memwrite(req, &le_val, 4);
    125 }
    126 
    127 void v9fs_uint64_write(P9Req *req, uint64_t val)
    128 {
    129     uint64_t le_val = cpu_to_le64(val);
    130 
    131     v9fs_memwrite(req, &le_val, 8);
    132 }
    133 
    134 void v9fs_uint32_read(P9Req *req, uint32_t *val)
    135 {
    136     v9fs_memread(req, val, 4);
    137     le32_to_cpus(val);
    138 }
    139 
    140 void v9fs_uint64_read(P9Req *req, uint64_t *val)
    141 {
    142     v9fs_memread(req, val, 8);
    143     le64_to_cpus(val);
    144 }
    145 
    146 /* len[2] string[len] */
    147 uint16_t v9fs_string_size(const char *string)
    148 {
    149     size_t len = strlen(string);
    150 
    151     g_assert_cmpint(len, <=, UINT16_MAX - 2);
    152 
    153     return 2 + len;
    154 }
    155 
    156 void v9fs_string_write(P9Req *req, const char *string)
    157 {
    158     int len = strlen(string);
    159 
    160     g_assert_cmpint(len, <=, UINT16_MAX);
    161 
    162     v9fs_uint16_write(req, (uint16_t) len);
    163     v9fs_memwrite(req, string, len);
    164 }
    165 
    166 void v9fs_string_read(P9Req *req, uint16_t *len, char **string)
    167 {
    168     uint16_t local_len;
    169 
    170     v9fs_uint16_read(req, &local_len);
    171     if (len) {
    172         *len = local_len;
    173     }
    174     if (string) {
    175         *string = g_malloc(local_len + 1);
    176         v9fs_memread(req, *string, local_len);
    177         (*string)[local_len] = 0;
    178     } else {
    179         v9fs_memskip(req, local_len);
    180     }
    181 }
    182 
    183 typedef struct {
    184     uint32_t size;
    185     uint8_t id;
    186     uint16_t tag;
    187 } QEMU_PACKED P9Hdr;
    188 
    189 P9Req *v9fs_req_init(QVirtio9P *v9p, uint32_t size, uint8_t id,
    190                      uint16_t tag)
    191 {
    192     P9Req *req = g_new0(P9Req, 1);
    193     uint32_t total_size = 7; /* 9P header has well-known size of 7 bytes */
    194     P9Hdr hdr = {
    195         .id = id,
    196         .tag = cpu_to_le16(tag)
    197     };
    198 
    199     g_assert_cmpint(total_size, <=, UINT32_MAX - size);
    200     total_size += size;
    201     hdr.size = cpu_to_le32(total_size);
    202 
    203     g_assert_cmpint(total_size, <=, P9_MAX_SIZE);
    204 
    205     req->qts = global_qtest;
    206     req->v9p = v9p;
    207     req->t_size = total_size;
    208     req->t_msg = guest_alloc(alloc, req->t_size);
    209     v9fs_memwrite(req, &hdr, 7);
    210     req->tag = tag;
    211     return req;
    212 }
    213 
    214 void v9fs_req_send(P9Req *req)
    215 {
    216     QVirtio9P *v9p = req->v9p;
    217 
    218     req->r_msg = guest_alloc(alloc, P9_MAX_SIZE);
    219     req->free_head = qvirtqueue_add(req->qts, v9p->vq, req->t_msg, req->t_size,
    220                                     false, true);
    221     qvirtqueue_add(req->qts, v9p->vq, req->r_msg, P9_MAX_SIZE, true, false);
    222     qvirtqueue_kick(req->qts, v9p->vdev, v9p->vq, req->free_head);
    223     req->t_off = 0;
    224 }
    225 
    226 static const char *rmessage_name(uint8_t id)
    227 {
    228     return
    229         id == P9_RLERROR ? "RLERROR" :
    230         id == P9_RVERSION ? "RVERSION" :
    231         id == P9_RATTACH ? "RATTACH" :
    232         id == P9_RWALK ? "RWALK" :
    233         id == P9_RLOPEN ? "RLOPEN" :
    234         id == P9_RWRITE ? "RWRITE" :
    235         id == P9_RMKDIR ? "RMKDIR" :
    236         id == P9_RLCREATE ? "RLCREATE" :
    237         id == P9_RSYMLINK ? "RSYMLINK" :
    238         id == P9_RLINK ? "RLINK" :
    239         id == P9_RUNLINKAT ? "RUNLINKAT" :
    240         id == P9_RFLUSH ? "RFLUSH" :
    241         id == P9_RREADDIR ? "READDIR" :
    242         "<unknown>";
    243 }
    244 
    245 void v9fs_req_wait_for_reply(P9Req *req, uint32_t *len)
    246 {
    247     QVirtio9P *v9p = req->v9p;
    248 
    249     qvirtio_wait_used_elem(req->qts, v9p->vdev, v9p->vq, req->free_head, len,
    250                            QVIRTIO_9P_TIMEOUT_US);
    251 }
    252 
    253 void v9fs_req_recv(P9Req *req, uint8_t id)
    254 {
    255     P9Hdr hdr;
    256 
    257     v9fs_memread(req, &hdr, 7);
    258     hdr.size = ldl_le_p(&hdr.size);
    259     hdr.tag = lduw_le_p(&hdr.tag);
    260 
    261     g_assert_cmpint(hdr.size, >=, 7);
    262     g_assert_cmpint(hdr.size, <=, P9_MAX_SIZE);
    263     g_assert_cmpint(hdr.tag, ==, req->tag);
    264 
    265     if (hdr.id != id) {
    266         g_printerr("Received response %d (%s) instead of %d (%s)\n",
    267                    hdr.id, rmessage_name(hdr.id), id, rmessage_name(id));
    268 
    269         if (hdr.id == P9_RLERROR) {
    270             uint32_t err;
    271             v9fs_uint32_read(req, &err);
    272             g_printerr("Rlerror has errno %d (%s)\n", err, strerror(err));
    273         }
    274     }
    275     g_assert_cmpint(hdr.id, ==, id);
    276 }
    277 
    278 void v9fs_req_free(P9Req *req)
    279 {
    280     guest_free(alloc, req->t_msg);
    281     guest_free(alloc, req->r_msg);
    282     g_free(req);
    283 }
    284 
    285 /* size[4] Rlerror tag[2] ecode[4] */
    286 void v9fs_rlerror(P9Req *req, uint32_t *err)
    287 {
    288     v9fs_req_recv(req, P9_RLERROR);
    289     v9fs_uint32_read(req, err);
    290     v9fs_req_free(req);
    291 }
    292 
    293 /* size[4] Tversion tag[2] msize[4] version[s] */
    294 TVersionRes v9fs_tversion(TVersionOpt opt)
    295 {
    296     P9Req *req;
    297     uint32_t err;
    298     uint32_t body_size = 4;
    299     uint16_t string_size;
    300     uint16_t server_len;
    301     g_autofree char *server_version = NULL;
    302 
    303     g_assert(opt.client);
    304 
    305     if (!opt.msize) {
    306         opt.msize = P9_MAX_SIZE;
    307     }
    308 
    309     if (!opt.tag) {
    310         opt.tag = P9_NOTAG;
    311     }
    312 
    313     if (!opt.version) {
    314         opt.version = "9P2000.L";
    315     }
    316 
    317     string_size = v9fs_string_size(opt.version);
    318     g_assert_cmpint(body_size, <=, UINT32_MAX - string_size);
    319     body_size += string_size;
    320     req = v9fs_req_init(opt.client, body_size, P9_TVERSION, opt.tag);
    321 
    322     v9fs_uint32_write(req, opt.msize);
    323     v9fs_string_write(req, opt.version);
    324     v9fs_req_send(req);
    325 
    326     if (!opt.requestOnly) {
    327         v9fs_req_wait_for_reply(req, NULL);
    328         if (opt.expectErr) {
    329             v9fs_rlerror(req, &err);
    330             g_assert_cmpint(err, ==, opt.expectErr);
    331         } else {
    332             v9fs_rversion(req, &server_len, &server_version);
    333             g_assert_cmpmem(server_version, server_len,
    334                             opt.version, strlen(opt.version));
    335         }
    336         req = NULL; /* request was freed */
    337     }
    338 
    339     return (TVersionRes) {
    340         .req = req,
    341     };
    342 }
    343 
    344 /* size[4] Rversion tag[2] msize[4] version[s] */
    345 void v9fs_rversion(P9Req *req, uint16_t *len, char **version)
    346 {
    347     uint32_t msize;
    348 
    349     v9fs_req_recv(req, P9_RVERSION);
    350     v9fs_uint32_read(req, &msize);
    351 
    352     g_assert_cmpint(msize, ==, P9_MAX_SIZE);
    353 
    354     if (len || version) {
    355         v9fs_string_read(req, len, version);
    356     }
    357 
    358     v9fs_req_free(req);
    359 }
    360 
    361 /* size[4] Tattach tag[2] fid[4] afid[4] uname[s] aname[s] n_uname[4] */
    362 TAttachRes v9fs_tattach(TAttachOpt opt)
    363 {
    364     uint32_t err;
    365     const char *uname = ""; /* ignored by QEMU */
    366     const char *aname = ""; /* ignored by QEMU */
    367 
    368     g_assert(opt.client);
    369     /* expecting either Rattach or Rlerror, but obviously not both */
    370     g_assert(!opt.expectErr || !opt.rattach.qid);
    371 
    372     if (!opt.requestOnly) {
    373         v9fs_tversion((TVersionOpt) { .client = opt.client });
    374     }
    375 
    376     if (!opt.n_uname) {
    377         opt.n_uname = getuid();
    378     }
    379 
    380     P9Req *req = v9fs_req_init(opt.client, 4 + 4 + 2 + 2 + 4, P9_TATTACH,
    381                                opt.tag);
    382 
    383     v9fs_uint32_write(req, opt.fid);
    384     v9fs_uint32_write(req, P9_NOFID);
    385     v9fs_string_write(req, uname);
    386     v9fs_string_write(req, aname);
    387     v9fs_uint32_write(req, opt.n_uname);
    388     v9fs_req_send(req);
    389 
    390     if (!opt.requestOnly) {
    391         v9fs_req_wait_for_reply(req, NULL);
    392         if (opt.expectErr) {
    393             v9fs_rlerror(req, &err);
    394             g_assert_cmpint(err, ==, opt.expectErr);
    395         } else {
    396             v9fs_rattach(req, opt.rattach.qid);
    397         }
    398         req = NULL; /* request was freed */
    399     }
    400 
    401     return (TAttachRes) {
    402         .req = req,
    403     };
    404 }
    405 
    406 /* size[4] Rattach tag[2] qid[13] */
    407 void v9fs_rattach(P9Req *req, v9fs_qid *qid)
    408 {
    409     v9fs_req_recv(req, P9_RATTACH);
    410     if (qid) {
    411         v9fs_memread(req, qid, 13);
    412     }
    413     v9fs_req_free(req);
    414 }
    415 
    416 /* size[4] Twalk tag[2] fid[4] newfid[4] nwname[2] nwname*(wname[s]) */
    417 TWalkRes v9fs_twalk(TWalkOpt opt)
    418 {
    419     P9Req *req;
    420     int i;
    421     uint32_t body_size = 4 + 4 + 2;
    422     uint32_t err;
    423     char **wnames = NULL;
    424 
    425     g_assert(opt.client);
    426     /* expecting either high- or low-level path, both not both */
    427     g_assert(!opt.path || !(opt.nwname || opt.wnames));
    428     /* expecting either Rwalk or Rlerror, but obviously not both */
    429     g_assert(!opt.expectErr || !(opt.rwalk.nwqid || opt.rwalk.wqid));
    430 
    431     if (!opt.newfid) {
    432         opt.newfid = genfid();
    433     }
    434 
    435     if (opt.path) {
    436         opt.nwname = split(opt.path, "/", &wnames);
    437         opt.wnames = wnames;
    438     }
    439 
    440     for (i = 0; i < opt.nwname; i++) {
    441         uint16_t wname_size = v9fs_string_size(opt.wnames[i]);
    442 
    443         g_assert_cmpint(body_size, <=, UINT32_MAX - wname_size);
    444         body_size += wname_size;
    445     }
    446     req = v9fs_req_init(opt.client, body_size, P9_TWALK, opt.tag);
    447     v9fs_uint32_write(req, opt.fid);
    448     v9fs_uint32_write(req, opt.newfid);
    449     v9fs_uint16_write(req, opt.nwname);
    450     for (i = 0; i < opt.nwname; i++) {
    451         v9fs_string_write(req, opt.wnames[i]);
    452     }
    453     v9fs_req_send(req);
    454 
    455     if (!opt.requestOnly) {
    456         v9fs_req_wait_for_reply(req, NULL);
    457         if (opt.expectErr) {
    458             v9fs_rlerror(req, &err);
    459             g_assert_cmpint(err, ==, opt.expectErr);
    460         } else {
    461             v9fs_rwalk(req, opt.rwalk.nwqid, opt.rwalk.wqid);
    462         }
    463         req = NULL; /* request was freed */
    464     }
    465 
    466     split_free(&wnames);
    467 
    468     return (TWalkRes) {
    469         .newfid = opt.newfid,
    470         .req = req,
    471     };
    472 }
    473 
    474 /* size[4] Rwalk tag[2] nwqid[2] nwqid*(wqid[13]) */
    475 void v9fs_rwalk(P9Req *req, uint16_t *nwqid, v9fs_qid **wqid)
    476 {
    477     uint16_t local_nwqid;
    478 
    479     v9fs_req_recv(req, P9_RWALK);
    480     v9fs_uint16_read(req, &local_nwqid);
    481     if (nwqid) {
    482         *nwqid = local_nwqid;
    483     }
    484     if (wqid) {
    485         *wqid = g_malloc(local_nwqid * 13);
    486         v9fs_memread(req, *wqid, local_nwqid * 13);
    487     }
    488     v9fs_req_free(req);
    489 }
    490 
    491 /* size[4] Tgetattr tag[2] fid[4] request_mask[8] */
    492 TGetAttrRes v9fs_tgetattr(TGetAttrOpt opt)
    493 {
    494     P9Req *req;
    495     uint32_t err;
    496 
    497     g_assert(opt.client);
    498     /* expecting either Rgetattr or Rlerror, but obviously not both */
    499     g_assert(!opt.expectErr || !opt.rgetattr.attr);
    500 
    501     if (!opt.request_mask) {
    502         opt.request_mask = P9_GETATTR_ALL;
    503     }
    504 
    505     req = v9fs_req_init(opt.client, 4 + 8, P9_TGETATTR, opt.tag);
    506     v9fs_uint32_write(req, opt.fid);
    507     v9fs_uint64_write(req, opt.request_mask);
    508     v9fs_req_send(req);
    509 
    510     if (!opt.requestOnly) {
    511         v9fs_req_wait_for_reply(req, NULL);
    512         if (opt.expectErr) {
    513             v9fs_rlerror(req, &err);
    514             g_assert_cmpint(err, ==, opt.expectErr);
    515         } else {
    516             v9fs_rgetattr(req, opt.rgetattr.attr);
    517         }
    518         req = NULL; /* request was freed */
    519     }
    520 
    521     return (TGetAttrRes) { .req = req };
    522 }
    523 
    524 /*
    525  * size[4] Rgetattr tag[2] valid[8] qid[13] mode[4] uid[4] gid[4] nlink[8]
    526  *                  rdev[8] size[8] blksize[8] blocks[8]
    527  *                  atime_sec[8] atime_nsec[8] mtime_sec[8] mtime_nsec[8]
    528  *                  ctime_sec[8] ctime_nsec[8] btime_sec[8] btime_nsec[8]
    529  *                  gen[8] data_version[8]
    530  */
    531 void v9fs_rgetattr(P9Req *req, v9fs_attr *attr)
    532 {
    533     v9fs_req_recv(req, P9_RGETATTR);
    534 
    535     v9fs_uint64_read(req, &attr->valid);
    536     v9fs_memread(req, &attr->qid, 13);
    537     v9fs_uint32_read(req, &attr->mode);
    538     v9fs_uint32_read(req, &attr->uid);
    539     v9fs_uint32_read(req, &attr->gid);
    540     v9fs_uint64_read(req, &attr->nlink);
    541     v9fs_uint64_read(req, &attr->rdev);
    542     v9fs_uint64_read(req, &attr->size);
    543     v9fs_uint64_read(req, &attr->blksize);
    544     v9fs_uint64_read(req, &attr->blocks);
    545     v9fs_uint64_read(req, &attr->atime_sec);
    546     v9fs_uint64_read(req, &attr->atime_nsec);
    547     v9fs_uint64_read(req, &attr->mtime_sec);
    548     v9fs_uint64_read(req, &attr->mtime_nsec);
    549     v9fs_uint64_read(req, &attr->ctime_sec);
    550     v9fs_uint64_read(req, &attr->ctime_nsec);
    551     v9fs_uint64_read(req, &attr->btime_sec);
    552     v9fs_uint64_read(req, &attr->btime_nsec);
    553     v9fs_uint64_read(req, &attr->gen);
    554     v9fs_uint64_read(req, &attr->data_version);
    555 
    556     v9fs_req_free(req);
    557 }
    558 
    559 /* size[4] Treaddir tag[2] fid[4] offset[8] count[4] */
    560 TReadDirRes v9fs_treaddir(TReadDirOpt opt)
    561 {
    562     P9Req *req;
    563     uint32_t err;
    564 
    565     g_assert(opt.client);
    566     /* expecting either Rreaddir or Rlerror, but obviously not both */
    567     g_assert(!opt.expectErr || !(opt.rreaddir.count ||
    568              opt.rreaddir.nentries || opt.rreaddir.entries));
    569 
    570     req = v9fs_req_init(opt.client, 4 + 8 + 4, P9_TREADDIR, opt.tag);
    571     v9fs_uint32_write(req, opt.fid);
    572     v9fs_uint64_write(req, opt.offset);
    573     v9fs_uint32_write(req, opt.count);
    574     v9fs_req_send(req);
    575 
    576     if (!opt.requestOnly) {
    577         v9fs_req_wait_for_reply(req, NULL);
    578         if (opt.expectErr) {
    579             v9fs_rlerror(req, &err);
    580             g_assert_cmpint(err, ==, opt.expectErr);
    581         } else {
    582             v9fs_rreaddir(req, opt.rreaddir.count, opt.rreaddir.nentries,
    583                           opt.rreaddir.entries);
    584         }
    585         req = NULL; /* request was freed */
    586     }
    587 
    588     return (TReadDirRes) { .req = req };
    589 }
    590 
    591 /* size[4] Rreaddir tag[2] count[4] data[count] */
    592 void v9fs_rreaddir(P9Req *req, uint32_t *count, uint32_t *nentries,
    593                    struct V9fsDirent **entries)
    594 {
    595     uint32_t local_count;
    596     struct V9fsDirent *e = NULL;
    597     uint16_t slen;
    598     uint32_t n = 0;
    599 
    600     v9fs_req_recv(req, P9_RREADDIR);
    601     v9fs_uint32_read(req, &local_count);
    602 
    603     if (count) {
    604         *count = local_count;
    605     }
    606 
    607     for (int32_t togo = (int32_t)local_count;
    608          togo >= 13 + 8 + 1 + 2;
    609          togo -= 13 + 8 + 1 + 2 + slen, ++n)
    610     {
    611         if (!e) {
    612             e = g_new(struct V9fsDirent, 1);
    613             if (entries) {
    614                 *entries = e;
    615             }
    616         } else {
    617             e = e->next = g_new(struct V9fsDirent, 1);
    618         }
    619         e->next = NULL;
    620         /* qid[13] offset[8] type[1] name[s] */
    621         v9fs_memread(req, &e->qid, 13);
    622         v9fs_uint64_read(req, &e->offset);
    623         v9fs_uint8_read(req, &e->type);
    624         v9fs_string_read(req, &slen, &e->name);
    625     }
    626 
    627     if (nentries) {
    628         *nentries = n;
    629     }
    630 
    631     v9fs_req_free(req);
    632 }
    633 
    634 void v9fs_free_dirents(struct V9fsDirent *e)
    635 {
    636     struct V9fsDirent *next = NULL;
    637 
    638     for (; e; e = next) {
    639         next = e->next;
    640         g_free(e->name);
    641         g_free(e);
    642     }
    643 }
    644 
    645 /* size[4] Tlopen tag[2] fid[4] flags[4] */
    646 TLOpenRes v9fs_tlopen(TLOpenOpt opt)
    647 {
    648     P9Req *req;
    649     uint32_t err;
    650 
    651     g_assert(opt.client);
    652     /* expecting either Rlopen or Rlerror, but obviously not both */
    653     g_assert(!opt.expectErr || !(opt.rlopen.qid || opt.rlopen.iounit));
    654 
    655     req = v9fs_req_init(opt.client,  4 + 4, P9_TLOPEN, opt.tag);
    656     v9fs_uint32_write(req, opt.fid);
    657     v9fs_uint32_write(req, opt.flags);
    658     v9fs_req_send(req);
    659 
    660     if (!opt.requestOnly) {
    661         v9fs_req_wait_for_reply(req, NULL);
    662         if (opt.expectErr) {
    663             v9fs_rlerror(req, &err);
    664             g_assert_cmpint(err, ==, opt.expectErr);
    665         } else {
    666             v9fs_rlopen(req, opt.rlopen.qid, opt.rlopen.iounit);
    667         }
    668         req = NULL; /* request was freed */
    669     }
    670 
    671     return (TLOpenRes) { .req = req };
    672 }
    673 
    674 /* size[4] Rlopen tag[2] qid[13] iounit[4] */
    675 void v9fs_rlopen(P9Req *req, v9fs_qid *qid, uint32_t *iounit)
    676 {
    677     v9fs_req_recv(req, P9_RLOPEN);
    678     if (qid) {
    679         v9fs_memread(req, qid, 13);
    680     } else {
    681         v9fs_memskip(req, 13);
    682     }
    683     if (iounit) {
    684         v9fs_uint32_read(req, iounit);
    685     }
    686     v9fs_req_free(req);
    687 }
    688 
    689 /* size[4] Twrite tag[2] fid[4] offset[8] count[4] data[count] */
    690 TWriteRes v9fs_twrite(TWriteOpt opt)
    691 {
    692     P9Req *req;
    693     uint32_t err;
    694     uint32_t body_size = 4 + 8 + 4;
    695     uint32_t written = 0;
    696 
    697     g_assert(opt.client);
    698 
    699     g_assert_cmpint(body_size, <=, UINT32_MAX - opt.count);
    700     body_size += opt.count;
    701     req = v9fs_req_init(opt.client, body_size, P9_TWRITE, opt.tag);
    702     v9fs_uint32_write(req, opt.fid);
    703     v9fs_uint64_write(req, opt.offset);
    704     v9fs_uint32_write(req, opt.count);
    705     v9fs_memwrite(req, opt.data, opt.count);
    706     v9fs_req_send(req);
    707 
    708     if (!opt.requestOnly) {
    709         v9fs_req_wait_for_reply(req, NULL);
    710         if (opt.expectErr) {
    711             v9fs_rlerror(req, &err);
    712             g_assert_cmpint(err, ==, opt.expectErr);
    713         } else {
    714             v9fs_rwrite(req, &written);
    715         }
    716         req = NULL; /* request was freed */
    717     }
    718 
    719     return (TWriteRes) {
    720         .req = req,
    721         .count = written
    722     };
    723 }
    724 
    725 /* size[4] Rwrite tag[2] count[4] */
    726 void v9fs_rwrite(P9Req *req, uint32_t *count)
    727 {
    728     v9fs_req_recv(req, P9_RWRITE);
    729     if (count) {
    730         v9fs_uint32_read(req, count);
    731     }
    732     v9fs_req_free(req);
    733 }
    734 
    735 /* size[4] Tflush tag[2] oldtag[2] */
    736 TFlushRes v9fs_tflush(TFlushOpt opt)
    737 {
    738     P9Req *req;
    739     uint32_t err;
    740 
    741     g_assert(opt.client);
    742 
    743     req = v9fs_req_init(opt.client, 2, P9_TFLUSH, opt.tag);
    744     v9fs_uint32_write(req, opt.oldtag);
    745     v9fs_req_send(req);
    746 
    747     if (!opt.requestOnly) {
    748         v9fs_req_wait_for_reply(req, NULL);
    749         if (opt.expectErr) {
    750             v9fs_rlerror(req, &err);
    751             g_assert_cmpint(err, ==, opt.expectErr);
    752         } else {
    753             v9fs_rflush(req);
    754         }
    755         req = NULL; /* request was freed */
    756     }
    757 
    758     return (TFlushRes) { .req = req };
    759 }
    760 
    761 /* size[4] Rflush tag[2] */
    762 void v9fs_rflush(P9Req *req)
    763 {
    764     v9fs_req_recv(req, P9_RFLUSH);
    765     v9fs_req_free(req);
    766 }
    767 
    768 /* size[4] Tmkdir tag[2] dfid[4] name[s] mode[4] gid[4] */
    769 TMkdirRes v9fs_tmkdir(TMkdirOpt opt)
    770 {
    771     P9Req *req;
    772     uint32_t err;
    773 
    774     g_assert(opt.client);
    775     /* expecting either hi-level atPath or low-level dfid, but not both */
    776     g_assert(!opt.atPath || !opt.dfid);
    777     /* expecting either Rmkdir or Rlerror, but obviously not both */
    778     g_assert(!opt.expectErr || !opt.rmkdir.qid);
    779 
    780     if (opt.atPath) {
    781         opt.dfid = v9fs_twalk((TWalkOpt) { .client = opt.client,
    782                                            .path = opt.atPath }).newfid;
    783     }
    784 
    785     if (!opt.mode) {
    786         opt.mode = 0750;
    787     }
    788 
    789     uint32_t body_size = 4 + 4 + 4;
    790     uint16_t string_size = v9fs_string_size(opt.name);
    791 
    792     g_assert_cmpint(body_size, <=, UINT32_MAX - string_size);
    793     body_size += string_size;
    794 
    795     req = v9fs_req_init(opt.client, body_size, P9_TMKDIR, opt.tag);
    796     v9fs_uint32_write(req, opt.dfid);
    797     v9fs_string_write(req, opt.name);
    798     v9fs_uint32_write(req, opt.mode);
    799     v9fs_uint32_write(req, opt.gid);
    800     v9fs_req_send(req);
    801 
    802     if (!opt.requestOnly) {
    803         v9fs_req_wait_for_reply(req, NULL);
    804         if (opt.expectErr) {
    805             v9fs_rlerror(req, &err);
    806             g_assert_cmpint(err, ==, opt.expectErr);
    807         } else {
    808             v9fs_rmkdir(req, opt.rmkdir.qid);
    809         }
    810         req = NULL; /* request was freed */
    811     }
    812 
    813     return (TMkdirRes) { .req = req };
    814 }
    815 
    816 /* size[4] Rmkdir tag[2] qid[13] */
    817 void v9fs_rmkdir(P9Req *req, v9fs_qid *qid)
    818 {
    819     v9fs_req_recv(req, P9_RMKDIR);
    820     if (qid) {
    821         v9fs_memread(req, qid, 13);
    822     } else {
    823         v9fs_memskip(req, 13);
    824     }
    825     v9fs_req_free(req);
    826 }
    827 
    828 /* size[4] Tlcreate tag[2] fid[4] name[s] flags[4] mode[4] gid[4] */
    829 TlcreateRes v9fs_tlcreate(TlcreateOpt opt)
    830 {
    831     P9Req *req;
    832     uint32_t err;
    833 
    834     g_assert(opt.client);
    835     /* expecting either hi-level atPath or low-level fid, but not both */
    836     g_assert(!opt.atPath || !opt.fid);
    837     /* expecting either Rlcreate or Rlerror, but obviously not both */
    838     g_assert(!opt.expectErr || !(opt.rlcreate.qid || opt.rlcreate.iounit));
    839 
    840     if (opt.atPath) {
    841         opt.fid = v9fs_twalk((TWalkOpt) { .client = opt.client,
    842                                           .path = opt.atPath }).newfid;
    843     }
    844 
    845     if (!opt.mode) {
    846         opt.mode = 0750;
    847     }
    848 
    849     uint32_t body_size = 4 + 4 + 4 + 4;
    850     uint16_t string_size = v9fs_string_size(opt.name);
    851 
    852     g_assert_cmpint(body_size, <=, UINT32_MAX - string_size);
    853     body_size += string_size;
    854 
    855     req = v9fs_req_init(opt.client, body_size, P9_TLCREATE, opt.tag);
    856     v9fs_uint32_write(req, opt.fid);
    857     v9fs_string_write(req, opt.name);
    858     v9fs_uint32_write(req, opt.flags);
    859     v9fs_uint32_write(req, opt.mode);
    860     v9fs_uint32_write(req, opt.gid);
    861     v9fs_req_send(req);
    862 
    863     if (!opt.requestOnly) {
    864         v9fs_req_wait_for_reply(req, NULL);
    865         if (opt.expectErr) {
    866             v9fs_rlerror(req, &err);
    867             g_assert_cmpint(err, ==, opt.expectErr);
    868         } else {
    869             v9fs_rlcreate(req, opt.rlcreate.qid, opt.rlcreate.iounit);
    870         }
    871         req = NULL; /* request was freed */
    872     }
    873 
    874     return (TlcreateRes) { .req = req };
    875 }
    876 
    877 /* size[4] Rlcreate tag[2] qid[13] iounit[4] */
    878 void v9fs_rlcreate(P9Req *req, v9fs_qid *qid, uint32_t *iounit)
    879 {
    880     v9fs_req_recv(req, P9_RLCREATE);
    881     if (qid) {
    882         v9fs_memread(req, qid, 13);
    883     } else {
    884         v9fs_memskip(req, 13);
    885     }
    886     if (iounit) {
    887         v9fs_uint32_read(req, iounit);
    888     }
    889     v9fs_req_free(req);
    890 }
    891 
    892 /* size[4] Tsymlink tag[2] fid[4] name[s] symtgt[s] gid[4] */
    893 TsymlinkRes v9fs_tsymlink(TsymlinkOpt opt)
    894 {
    895     P9Req *req;
    896     uint32_t err;
    897 
    898     g_assert(opt.client);
    899     /* expecting either hi-level atPath or low-level fid, but not both */
    900     g_assert(!opt.atPath || !opt.fid);
    901     /* expecting either Rsymlink or Rlerror, but obviously not both */
    902     g_assert(!opt.expectErr || !opt.rsymlink.qid);
    903 
    904     if (opt.atPath) {
    905         opt.fid = v9fs_twalk((TWalkOpt) { .client = opt.client,
    906                                           .path = opt.atPath }).newfid;
    907     }
    908 
    909     uint32_t body_size = 4 + 4;
    910     uint16_t string_size = v9fs_string_size(opt.name) +
    911                            v9fs_string_size(opt.symtgt);
    912 
    913     g_assert_cmpint(body_size, <=, UINT32_MAX - string_size);
    914     body_size += string_size;
    915 
    916     req = v9fs_req_init(opt.client, body_size, P9_TSYMLINK, opt.tag);
    917     v9fs_uint32_write(req, opt.fid);
    918     v9fs_string_write(req, opt.name);
    919     v9fs_string_write(req, opt.symtgt);
    920     v9fs_uint32_write(req, opt.gid);
    921     v9fs_req_send(req);
    922 
    923     if (!opt.requestOnly) {
    924         v9fs_req_wait_for_reply(req, NULL);
    925         if (opt.expectErr) {
    926             v9fs_rlerror(req, &err);
    927             g_assert_cmpint(err, ==, opt.expectErr);
    928         } else {
    929             v9fs_rsymlink(req, opt.rsymlink.qid);
    930         }
    931         req = NULL; /* request was freed */
    932     }
    933 
    934     return (TsymlinkRes) { .req = req };
    935 }
    936 
    937 /* size[4] Rsymlink tag[2] qid[13] */
    938 void v9fs_rsymlink(P9Req *req, v9fs_qid *qid)
    939 {
    940     v9fs_req_recv(req, P9_RSYMLINK);
    941     if (qid) {
    942         v9fs_memread(req, qid, 13);
    943     } else {
    944         v9fs_memskip(req, 13);
    945     }
    946     v9fs_req_free(req);
    947 }
    948 
    949 /* size[4] Tlink tag[2] dfid[4] fid[4] name[s] */
    950 TlinkRes v9fs_tlink(TlinkOpt opt)
    951 {
    952     P9Req *req;
    953     uint32_t err;
    954 
    955     g_assert(opt.client);
    956     /* expecting either hi-level atPath or low-level dfid, but not both */
    957     g_assert(!opt.atPath || !opt.dfid);
    958     /* expecting either hi-level toPath or low-level fid, but not both */
    959     g_assert(!opt.toPath || !opt.fid);
    960 
    961     if (opt.atPath) {
    962         opt.dfid = v9fs_twalk((TWalkOpt) { .client = opt.client,
    963                                            .path = opt.atPath }).newfid;
    964     }
    965     if (opt.toPath) {
    966         opt.fid = v9fs_twalk((TWalkOpt) { .client = opt.client,
    967                                           .path = opt.toPath }).newfid;
    968     }
    969 
    970     uint32_t body_size = 4 + 4;
    971     uint16_t string_size = v9fs_string_size(opt.name);
    972 
    973     g_assert_cmpint(body_size, <=, UINT32_MAX - string_size);
    974     body_size += string_size;
    975 
    976     req = v9fs_req_init(opt.client, body_size, P9_TLINK, opt.tag);
    977     v9fs_uint32_write(req, opt.dfid);
    978     v9fs_uint32_write(req, opt.fid);
    979     v9fs_string_write(req, opt.name);
    980     v9fs_req_send(req);
    981 
    982     if (!opt.requestOnly) {
    983         v9fs_req_wait_for_reply(req, NULL);
    984         if (opt.expectErr) {
    985             v9fs_rlerror(req, &err);
    986             g_assert_cmpint(err, ==, opt.expectErr);
    987         } else {
    988             v9fs_rlink(req);
    989         }
    990         req = NULL; /* request was freed */
    991     }
    992 
    993     return (TlinkRes) { .req = req };
    994 }
    995 
    996 /* size[4] Rlink tag[2] */
    997 void v9fs_rlink(P9Req *req)
    998 {
    999     v9fs_req_recv(req, P9_RLINK);
   1000     v9fs_req_free(req);
   1001 }
   1002 
   1003 /* size[4] Tunlinkat tag[2] dirfd[4] name[s] flags[4] */
   1004 TunlinkatRes v9fs_tunlinkat(TunlinkatOpt opt)
   1005 {
   1006     P9Req *req;
   1007     uint32_t err;
   1008 
   1009     g_assert(opt.client);
   1010     /* expecting either hi-level atPath or low-level dirfd, but not both */
   1011     g_assert(!opt.atPath || !opt.dirfd);
   1012 
   1013     if (opt.atPath) {
   1014         opt.dirfd = v9fs_twalk((TWalkOpt) { .client = opt.client,
   1015                                             .path = opt.atPath }).newfid;
   1016     }
   1017 
   1018     uint32_t body_size = 4 + 4;
   1019     uint16_t string_size = v9fs_string_size(opt.name);
   1020 
   1021     g_assert_cmpint(body_size, <=, UINT32_MAX - string_size);
   1022     body_size += string_size;
   1023 
   1024     req = v9fs_req_init(opt.client, body_size, P9_TUNLINKAT, opt.tag);
   1025     v9fs_uint32_write(req, opt.dirfd);
   1026     v9fs_string_write(req, opt.name);
   1027     v9fs_uint32_write(req, opt.flags);
   1028     v9fs_req_send(req);
   1029 
   1030     if (!opt.requestOnly) {
   1031         v9fs_req_wait_for_reply(req, NULL);
   1032         if (opt.expectErr) {
   1033             v9fs_rlerror(req, &err);
   1034             g_assert_cmpint(err, ==, opt.expectErr);
   1035         } else {
   1036             v9fs_runlinkat(req);
   1037         }
   1038         req = NULL; /* request was freed */
   1039     }
   1040 
   1041     return (TunlinkatRes) { .req = req };
   1042 }
   1043 
   1044 /* size[4] Runlinkat tag[2] */
   1045 void v9fs_runlinkat(P9Req *req)
   1046 {
   1047     v9fs_req_recv(req, P9_RUNLINKAT);
   1048     v9fs_req_free(req);
   1049 }