2 * The Guest 9p transport driver
4 * This is a block based transport driver based on the lguest block driver
9 * Copyright (C) 2007 Eric Van Hensbergen, IBM Corporation
11 * Based on virtio console driver
12 * Copyright (C) 2006, 2007 Rusty Russell, IBM Corporation
14 * This program is free software; you can redistribute it and/or modify
15 * it under the terms of the GNU General Public License version 2
16 * as published by the Free Software Foundation.
18 * This program is distributed in the hope that it will be useful,
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 * GNU General Public License for more details.
23 * You should have received a copy of the GNU General Public License
24 * along with this program; if not, write to:
25 * Free Software Foundation
26 * 51 Franklin Street, Fifth Floor
27 * Boston, MA 02111-1301 USA
32 #include <linux/module.h>
33 #include <linux/net.h>
34 #include <linux/ipv6.h>
35 #include <linux/errno.h>
36 #include <linux/kernel.h>
38 #include <linux/uaccess.h>
39 #include <linux/inet.h>
40 #include <linux/idr.h>
41 #include <linux/file.h>
42 #include <net/9p/9p.h>
43 #include <linux/parser.h>
44 #include <net/9p/transport.h>
45 #include <linux/scatterlist.h>
46 #include <linux/virtio.h>
47 #include <linux/virtio_9p.h>
49 #define VIRTQUEUE_NUM 128
51 /* a single mutex to manage channel initialization and attachment */
52 static DECLARE_MUTEX(virtio_9p_lock);
53 /* global which tracks highest initialized channel */
54 static int chan_index;
56 #define P9_INIT_MAXTAG 16
60 * enum p9_req_status_t - virtio request status
61 * @REQ_STATUS_IDLE: request slot unused
62 * @REQ_STATUS_SENT: request sent to server
63 * @REQ_STATUS_RCVD: response received from server
64 * @REQ_STATUS_FLSH: request has been flushed
66 * The @REQ_STATUS_IDLE state is used to mark a request slot as unused
67 * but use is actually tracked by the idpool structure which handles tag
72 enum p9_req_status_t {
80 * struct p9_req_t - virtio request slots
81 * @status: status of this request slot
82 * @wq: wait_queue for the client to block on for this request
84 * The virtio transport uses an array to track outstanding requests
85 * instead of a list. While this may incurr overhead during initial
86 * allocation or expansion, it makes request lookup much easier as the
87 * tag id is a index into an array. (We use tag+1 so that we can accomodate
88 * the -1 tag for the T_VERSION request).
89 * This also has the nice effect of only having to allocate wait_queues
90 * once, instead of constantly allocating and freeing them. Its possible
91 * other resources could benefit from this scheme as well.
97 wait_queue_head_t *wq;
101 * struct virtio_chan - per-instance transport information
102 * @initialized: whether the channel is initialized
103 * @inuse: whether the channel is in use
104 * @lock: protects multiple elements within this structure
105 * @vdev: virtio dev associated with this channel
106 * @vq: virtio queue associated with this channel
107 * @tagpool: accounting for tag ids (and request slots)
108 * @reqs: array of request slots
109 * @max_tag: current number of request_slots allocated
110 * @sg: scatter gather list which is used to pack a request (protected?)
112 * We keep all per-channel information in a structure.
113 * This structure is allocated within the devices dev->mem space.
114 * A pointer to the structure will get put in the transport private.
118 static struct virtio_chan {
124 struct virtio_device *vdev;
125 struct virtqueue *vq;
127 struct p9_idpool *tagpool;
128 struct p9_req_t *reqs;
131 /* Scatterlist: can be too big for stack. */
132 struct scatterlist sg[VIRTQUEUE_NUM];
133 } channels[MAX_9P_CHAN];
136 * p9_lookup_tag - Lookup requests by tag
137 * @c: virtio channel to lookup tag within
138 * @tag: numeric id for transaction
140 * this is a simple array lookup, but will grow the
141 * request_slots as necessary to accomodate transaction
142 * ids which did not previously have a slot.
144 * Bugs: there is currently no upper limit on request slots set
145 * here, but that should be constrained by the id accounting.
148 static struct p9_req_t *p9_lookup_tag(struct virtio_chan *c, u16 tag)
150 /* This looks up the original request by tag so we know which
151 * buffer to read the data into */
154 while (tag >= c->max_tag) {
155 int old_max = c->max_tag;
161 c->max_tag = P9_INIT_MAXTAG;
163 c->reqs = krealloc(c->reqs, sizeof(struct p9_req_t)*c->max_tag,
166 printk(KERN_ERR "Couldn't grow tag array\n");
169 for (count = old_max; count < c->max_tag; count++) {
170 c->reqs[count].status = REQ_STATUS_IDLE;
171 c->reqs[count].wq = kmalloc(sizeof(wait_queue_head_t),
173 if (!c->reqs[count].wq) {
174 printk(KERN_ERR "Couldn't grow tag array\n");
177 init_waitqueue_head(c->reqs[count].wq);
181 return &c->reqs[tag];
185 /* How many bytes left in this page. */
186 static unsigned int rest_of_page(void *data)
188 return PAGE_SIZE - ((unsigned long)data % PAGE_SIZE);
192 * p9_virtio_close - reclaim resources of a channel
193 * @trans: transport state
195 * This reclaims a channel by freeing its resources and
196 * reseting its inuse flag.
200 static void p9_virtio_close(struct p9_trans *trans)
202 struct virtio_chan *chan = trans->priv;
206 spin_lock_irqsave(&chan->lock, flags);
207 p9_idpool_destroy(chan->tagpool);
208 for (count = 0; count < chan->max_tag; count++)
209 kfree(chan->reqs[count].wq);
212 spin_unlock_irqrestore(&chan->lock, flags);
214 down(&virtio_9p_lock);
222 * req_done - callback which signals activity from the server
223 * @vq: virtio queue activity was received on
225 * This notifies us that the server has triggered some activity
226 * on the virtio channel - most likely a response to request we
227 * sent. Figure out which requests now have responses and wake up
230 * Bugs: could do with some additional sanity checking, but appears to work.
234 static void req_done(struct virtqueue *vq)
236 struct virtio_chan *chan = vq->vdev->priv;
240 struct p9_req_t *req;
242 spin_lock_irqsave(&chan->lock, flags);
243 while ((rc = chan->vq->vq_ops->get_buf(chan->vq, &len)) != NULL) {
244 req = p9_lookup_tag(chan, rc->tag);
245 req->status = REQ_STATUS_RCVD;
248 /* In case queue is stopped waiting for more buffers. */
249 spin_unlock_irqrestore(&chan->lock, flags);
253 * pack_sg_list - pack a scatter gather list from a linear buffer
254 * @sg: scatter/gather list to pack into
255 * @start: which segment of the sg_list to start at
256 * @limit: maximum segment to pack data to
257 * @data: data to pack into scatter/gather list
258 * @count: amount of data to pack into the scatter/gather list
260 * sg_lists have multiple segments of various sizes. This will pack
261 * arbitrary data into an existing scatter gather list, segmenting the
262 * data as necessary within constraints.
267 pack_sg_list(struct scatterlist *sg, int start, int limit, char *data,
274 s = rest_of_page(data);
277 sg_set_buf(&sg[index++], data, s);
280 BUG_ON(index > limit);
287 * p9_virtio_rpc - issue a request and wait for a response
288 * @t: transport state
289 * @tc: &p9_fcall request to transmit
290 * @rc: &p9_fcall to put reponse into
295 p9_virtio_rpc(struct p9_trans *t, struct p9_fcall *tc, struct p9_fcall **rc)
299 struct virtio_chan *chan = t->priv;
301 struct p9_req_t *req;
305 *rc = kmalloc(sizeof(struct p9_fcall) + t->msize, GFP_KERNEL);
310 rdata = (char *)*rc+sizeof(struct p9_fcall);
313 if (tc->id != P9_TVERSION) {
314 n = p9_idpool_get(chan->tagpool);
319 spin_lock_irqsave(&chan->lock, flags);
320 req = p9_lookup_tag(chan, n);
321 spin_unlock_irqrestore(&chan->lock, flags);
325 P9_DPRINTK(P9_DEBUG_TRANS, "9p debug: virtio rpc tag %d\n", n);
327 out = pack_sg_list(chan->sg, 0, VIRTQUEUE_NUM, tc->sdata, tc->size);
328 in = pack_sg_list(chan->sg, out, VIRTQUEUE_NUM-out, rdata, t->msize);
330 req->status = REQ_STATUS_SENT;
332 if (chan->vq->vq_ops->add_buf(chan->vq, chan->sg, out, in, tc)) {
333 P9_DPRINTK(P9_DEBUG_TRANS,
334 "9p debug: virtio rpc add_buf returned failure");
338 chan->vq->vq_ops->kick(chan->vq);
340 wait_event(*req->wq, req->status == REQ_STATUS_RCVD);
342 size = le32_to_cpu(*(__le32 *) rdata);
344 err = p9_deserialize_fcall(rdata, size, *rc, t->extended);
346 P9_DPRINTK(P9_DEBUG_TRANS,
347 "9p debug: virtio rpc deserialize returned %d\n", err);
351 #ifdef CONFIG_NET_9P_DEBUG
352 if ((p9_debug_level&P9_DEBUG_FCALL) == P9_DEBUG_FCALL) {
355 p9_printfcall(buf, sizeof(buf), *rc, t->extended);
356 printk(KERN_NOTICE ">>> %p %s\n", t, buf);
360 if (n != P9_NOTAG && p9_idpool_check(n, chan->tagpool))
361 p9_idpool_put(n, chan->tagpool);
363 req->status = REQ_STATUS_IDLE;
369 * p9_virtio_probe - probe for existence of 9P virtio channels
370 * @vdev: virtio device to probe
372 * This probes for existing virtio channels. At present only
373 * a single channel is in use, so in the future more work may need
378 static int p9_virtio_probe(struct virtio_device *vdev)
381 struct virtio_chan *chan;
384 down(&virtio_9p_lock);
385 index = chan_index++;
386 chan = &channels[index];
389 if (chan_index > MAX_9P_CHAN) {
390 printk(KERN_ERR "9p: virtio: Maximum channels exceeded\n");
398 /* We expect one virtqueue, for requests. */
399 chan->vq = vdev->config->find_vq(vdev, 0, req_done);
400 if (IS_ERR(chan->vq)) {
401 err = PTR_ERR(chan->vq);
404 chan->vq->vdev->priv = chan;
405 spin_lock_init(&chan->lock);
407 sg_init_table(chan->sg, VIRTQUEUE_NUM);
410 chan->initialized = true;
414 vdev->config->del_vq(chan->vq);
416 down(&virtio_9p_lock);
424 * p9_virtio_create - allocate a new virtio channel
425 * @devname: string identifying the channel to connect to (unused)
426 * @args: args passed from sys_mount() for per-transport options (unused)
427 * @msize: requested maximum packet size
428 * @extended: 9p2000.u enabled flag
430 * This sets up a transport channel for 9p communication. Right now
431 * we only match the first available channel, but eventually we couldlook up
432 * alternate channels by matching devname versus a virtio_config entry.
433 * We use a simple reference count mechanism to ensure that only a single
434 * mount has a channel open at a time.
436 * Bugs: doesn't allow identification of a specific channel
437 * to allocate, channels are allocated sequentially. This was
438 * a pragmatic decision to get things rolling, but ideally some
439 * way of identifying the channel to attach to would be nice
440 * if we are going to support multiple channels.
444 static struct p9_trans *
445 p9_virtio_create(const char *devname, char *args, int msize,
446 unsigned char extended)
448 struct p9_trans *trans;
449 struct virtio_chan *chan = channels;
452 down(&virtio_9p_lock);
453 while (index < MAX_9P_CHAN) {
454 if (chan->initialized && !chan->inuse) {
459 chan = &channels[index];
464 if (index >= MAX_9P_CHAN) {
465 printk(KERN_ERR "9p: no channels available\n");
466 return ERR_PTR(-ENODEV);
469 chan->tagpool = p9_idpool_create();
470 if (IS_ERR(chan->tagpool)) {
471 printk(KERN_ERR "9p: couldn't allocate tagpool\n");
472 return ERR_PTR(-ENOMEM);
474 p9_idpool_get(chan->tagpool); /* reserve tag 0 */
478 trans = kmalloc(sizeof(struct p9_trans), GFP_KERNEL);
480 printk(KERN_ERR "9p: couldn't allocate transport\n");
481 return ERR_PTR(-ENOMEM);
483 trans->extended = extended;
484 trans->msize = msize;
485 trans->close = p9_virtio_close;
486 trans->rpc = p9_virtio_rpc;
493 * p9_virtio_remove - clean up resources associated with a virtio device
494 * @vdev: virtio device to remove
498 static void p9_virtio_remove(struct virtio_device *vdev)
500 struct virtio_chan *chan = vdev->priv;
504 if (chan->initialized) {
505 vdev->config->del_vq(chan->vq);
506 chan->initialized = false;
510 #define VIRTIO_ID_9P 9
512 static struct virtio_device_id id_table[] = {
513 { VIRTIO_ID_9P, VIRTIO_DEV_ANY_ID },
517 /* The standard "struct lguest_driver": */
518 static struct virtio_driver p9_virtio_drv = {
519 .driver.name = KBUILD_MODNAME,
520 .driver.owner = THIS_MODULE,
521 .id_table = id_table,
522 .probe = p9_virtio_probe,
523 .remove = p9_virtio_remove,
526 static struct p9_trans_module p9_virtio_trans = {
528 .create = p9_virtio_create,
529 .maxsize = PAGE_SIZE*16,
533 /* The standard init function */
534 static int __init p9_virtio_init(void)
538 for (count = 0; count < MAX_9P_CHAN; count++)
539 channels[count].initialized = false;
541 v9fs_register_trans(&p9_virtio_trans);
542 return register_virtio_driver(&p9_virtio_drv);
545 static void __exit p9_virtio_cleanup(void)
547 unregister_virtio_driver(&p9_virtio_drv);
550 module_init(p9_virtio_init);
551 module_exit(p9_virtio_cleanup);
553 MODULE_DEVICE_TABLE(virtio, id_table);
554 MODULE_AUTHOR("Eric Van Hensbergen <ericvh@gmail.com>");
555 MODULE_DESCRIPTION("Virtio 9p Transport");
556 MODULE_LICENSE("GPL");