6 * Partial copy of Linus' read cache modifications to fs/nfs/file.c
7 * modified for async RPC by okir@monad.swb.de
10 #include <linux/time.h>
11 #include <linux/kernel.h>
12 #include <linux/errno.h>
13 #include <linux/fcntl.h>
14 #include <linux/stat.h>
16 #include <linux/slab.h>
17 #include <linux/pagemap.h>
18 #include <linux/sunrpc/clnt.h>
19 #include <linux/nfs_fs.h>
20 #include <linux/nfs_page.h>
21 #include <linux/module.h>
29 #define NFSDBG_FACILITY NFSDBG_PAGECACHE
31 static const struct nfs_pageio_ops nfs_pageio_read_ops;
32 static const struct nfs_pgio_completion_ops nfs_async_read_completion_ops;
33 static const struct nfs_rw_ops nfs_rw_read_ops;
35 static struct kmem_cache *nfs_rdata_cachep;
37 static struct nfs_rw_header *nfs_readhdr_alloc(void)
39 return kmem_cache_zalloc(nfs_rdata_cachep, GFP_KERNEL);
42 static void nfs_readhdr_free(struct nfs_rw_header *rhdr)
44 kmem_cache_free(nfs_rdata_cachep, rhdr);
48 int nfs_return_empty_page(struct page *page)
50 zero_user(page, 0, PAGE_CACHE_SIZE);
51 SetPageUptodate(page);
56 void nfs_pageio_init_read(struct nfs_pageio_descriptor *pgio,
57 struct inode *inode, bool force_mds,
58 const struct nfs_pgio_completion_ops *compl_ops)
60 struct nfs_server *server = NFS_SERVER(inode);
61 const struct nfs_pageio_ops *pg_ops = &nfs_pageio_read_ops;
63 #ifdef CONFIG_NFS_V4_1
64 if (server->pnfs_curr_ld && !force_mds)
65 pg_ops = server->pnfs_curr_ld->pg_read_ops;
67 nfs_pageio_init(pgio, inode, pg_ops, compl_ops, &nfs_rw_read_ops,
70 EXPORT_SYMBOL_GPL(nfs_pageio_init_read);
72 void nfs_pageio_reset_read_mds(struct nfs_pageio_descriptor *pgio)
74 pgio->pg_ops = &nfs_pageio_read_ops;
75 pgio->pg_bsize = NFS_SERVER(pgio->pg_inode)->rsize;
77 EXPORT_SYMBOL_GPL(nfs_pageio_reset_read_mds);
79 int nfs_readpage_async(struct nfs_open_context *ctx, struct inode *inode,
84 struct nfs_pageio_descriptor pgio;
86 len = nfs_page_length(page);
88 return nfs_return_empty_page(page);
89 new = nfs_create_request(ctx, inode, page, 0, len);
94 if (len < PAGE_CACHE_SIZE)
95 zero_user_segment(page, len, PAGE_CACHE_SIZE);
97 nfs_pageio_init_read(&pgio, inode, false,
98 &nfs_async_read_completion_ops);
99 nfs_pageio_add_request(&pgio, new);
100 nfs_pageio_complete(&pgio);
101 NFS_I(inode)->read_io += pgio.pg_bytes_written;
105 static void nfs_readpage_release(struct nfs_page *req)
107 struct inode *d_inode = req->wb_context->dentry->d_inode;
109 if (PageUptodate(req->wb_page))
110 nfs_readpage_to_fscache(d_inode, req->wb_page, 0);
112 unlock_page(req->wb_page);
114 dprintk("NFS: read done (%s/%Lu %d@%Ld)\n",
115 req->wb_context->dentry->d_inode->i_sb->s_id,
116 (unsigned long long)NFS_FILEID(req->wb_context->dentry->d_inode),
118 (long long)req_offset(req));
119 nfs_release_request(req);
122 /* Note io was page aligned */
123 static void nfs_read_completion(struct nfs_pgio_header *hdr)
125 unsigned long bytes = 0;
127 if (test_bit(NFS_IOHDR_REDO, &hdr->flags))
129 while (!list_empty(&hdr->pages)) {
130 struct nfs_page *req = nfs_list_entry(hdr->pages.next);
131 struct page *page = req->wb_page;
133 if (test_bit(NFS_IOHDR_EOF, &hdr->flags)) {
134 if (bytes > hdr->good_bytes)
135 zero_user(page, 0, PAGE_SIZE);
136 else if (hdr->good_bytes - bytes < PAGE_SIZE)
137 zero_user_segment(page,
138 hdr->good_bytes & ~PAGE_MASK,
141 bytes += req->wb_bytes;
142 if (test_bit(NFS_IOHDR_ERROR, &hdr->flags)) {
143 if (bytes <= hdr->good_bytes)
144 SetPageUptodate(page);
146 SetPageUptodate(page);
147 nfs_list_remove_request(req);
148 nfs_readpage_release(req);
154 int nfs_initiate_read(struct rpc_clnt *clnt,
155 struct nfs_pgio_data *data,
156 const struct rpc_call_ops *call_ops, int flags)
158 struct inode *inode = data->header->inode;
159 int swap_flags = IS_SWAPFILE(inode) ? NFS_RPC_SWAPFLAGS : 0;
160 struct rpc_task *task;
161 struct rpc_message msg = {
162 .rpc_argp = &data->args,
163 .rpc_resp = &data->res,
164 .rpc_cred = data->header->cred,
166 struct rpc_task_setup task_setup_data = {
170 .callback_ops = call_ops,
171 .callback_data = data,
172 .workqueue = nfsiod_workqueue,
173 .flags = RPC_TASK_ASYNC | swap_flags | flags,
176 /* Set up the initial task struct. */
177 NFS_PROTO(inode)->read_setup(data, &msg);
179 dprintk("NFS: %5u initiated read call (req %s/%llu, %u bytes @ "
183 (unsigned long long)NFS_FILEID(inode),
185 (unsigned long long)data->args.offset);
187 task = rpc_run_task(&task_setup_data);
189 return PTR_ERR(task);
193 EXPORT_SYMBOL_GPL(nfs_initiate_read);
196 * Set up the NFS read request struct
198 static void nfs_read_rpcsetup(struct nfs_pgio_data *data,
199 unsigned int count, unsigned int offset)
201 struct nfs_page *req = data->header->req;
203 data->args.fh = NFS_FH(data->header->inode);
204 data->args.offset = req_offset(req) + offset;
205 data->args.pgbase = req->wb_pgbase + offset;
206 data->args.pages = data->pages.pagevec;
207 data->args.count = count;
208 data->args.context = get_nfs_open_context(req->wb_context);
209 data->args.lock_context = req->wb_lock_context;
211 data->res.fattr = &data->fattr;
212 data->res.count = count;
214 nfs_fattr_init(&data->fattr);
217 static int nfs_do_read(struct nfs_pgio_data *data,
218 const struct rpc_call_ops *call_ops)
220 struct inode *inode = data->header->inode;
222 return nfs_initiate_read(NFS_CLIENT(inode), data, call_ops, 0);
226 nfs_do_multiple_reads(struct list_head *head,
227 const struct rpc_call_ops *call_ops)
229 struct nfs_pgio_data *data;
232 while (!list_empty(head)) {
235 data = list_first_entry(head, struct nfs_pgio_data, list);
236 list_del_init(&data->list);
238 ret2 = nfs_do_read(data, call_ops);
246 nfs_async_read_error(struct list_head *head)
248 struct nfs_page *req;
250 while (!list_empty(head)) {
251 req = nfs_list_entry(head->next);
252 nfs_list_remove_request(req);
253 nfs_readpage_release(req);
257 static const struct nfs_pgio_completion_ops nfs_async_read_completion_ops = {
258 .error_cleanup = nfs_async_read_error,
259 .completion = nfs_read_completion,
262 static void nfs_pagein_error(struct nfs_pageio_descriptor *desc,
263 struct nfs_pgio_header *hdr)
265 set_bit(NFS_IOHDR_REDO, &hdr->flags);
266 while (!list_empty(&hdr->rpc_list)) {
267 struct nfs_pgio_data *data = list_first_entry(&hdr->rpc_list,
268 struct nfs_pgio_data, list);
269 list_del(&data->list);
270 nfs_pgio_data_release(data);
272 desc->pg_completion_ops->error_cleanup(&desc->pg_list);
276 * Generate multiple requests to fill a single page.
278 * We optimize to reduce the number of read operations on the wire. If we
279 * detect that we're reading a page, or an area of a page, that is past the
280 * end of file, we do not generate NFS read operations but just clear the
281 * parts of the page that would have come back zero from the server anyway.
283 * We rely on the cached value of i_size to make this determination; another
284 * client can fill pages on the server past our cached end-of-file, but we
285 * won't see the new data until our attribute cache is updated. This is more
286 * or less conventional NFS client behavior.
288 static int nfs_pagein_multi(struct nfs_pageio_descriptor *desc,
289 struct nfs_pgio_header *hdr)
291 struct nfs_page *req = hdr->req;
292 struct page *page = req->wb_page;
293 struct nfs_pgio_data *data;
294 size_t rsize = desc->pg_bsize, nbytes;
298 nbytes = desc->pg_count;
300 size_t len = min(nbytes,rsize);
302 data = nfs_pgio_data_alloc(hdr, 1);
304 nfs_pagein_error(desc, hdr);
307 data->pages.pagevec[0] = page;
308 nfs_read_rpcsetup(data, len, offset);
309 list_add(&data->list, &hdr->rpc_list);
312 } while (nbytes != 0);
314 nfs_list_remove_request(req);
315 nfs_list_add_request(req, &hdr->pages);
316 desc->pg_rpc_callops = &nfs_pgio_common_ops;
320 static int nfs_pagein_one(struct nfs_pageio_descriptor *desc,
321 struct nfs_pgio_header *hdr)
323 struct nfs_page *req;
325 struct nfs_pgio_data *data;
326 struct list_head *head = &desc->pg_list;
328 data = nfs_pgio_data_alloc(hdr, nfs_page_array_len(desc->pg_base,
331 nfs_pagein_error(desc, hdr);
335 pages = data->pages.pagevec;
336 while (!list_empty(head)) {
337 req = nfs_list_entry(head->next);
338 nfs_list_remove_request(req);
339 nfs_list_add_request(req, &hdr->pages);
340 *pages++ = req->wb_page;
343 nfs_read_rpcsetup(data, desc->pg_count, 0);
344 list_add(&data->list, &hdr->rpc_list);
345 desc->pg_rpc_callops = &nfs_pgio_common_ops;
349 int nfs_generic_pagein(struct nfs_pageio_descriptor *desc,
350 struct nfs_pgio_header *hdr)
352 if (desc->pg_bsize < PAGE_CACHE_SIZE)
353 return nfs_pagein_multi(desc, hdr);
354 return nfs_pagein_one(desc, hdr);
356 EXPORT_SYMBOL_GPL(nfs_generic_pagein);
358 static int nfs_generic_pg_readpages(struct nfs_pageio_descriptor *desc)
360 struct nfs_rw_header *rhdr;
361 struct nfs_pgio_header *hdr;
364 rhdr = nfs_rw_header_alloc(desc->pg_rw_ops);
366 desc->pg_completion_ops->error_cleanup(&desc->pg_list);
370 nfs_pgheader_init(desc, hdr, nfs_rw_header_free);
371 atomic_inc(&hdr->refcnt);
372 ret = nfs_generic_pagein(desc, hdr);
374 ret = nfs_do_multiple_reads(&hdr->rpc_list,
375 desc->pg_rpc_callops);
376 if (atomic_dec_and_test(&hdr->refcnt))
377 hdr->completion_ops->completion(hdr);
381 static const struct nfs_pageio_ops nfs_pageio_read_ops = {
382 .pg_test = nfs_generic_pg_test,
383 .pg_doio = nfs_generic_pg_readpages,
387 * This is the callback from RPC telling us whether a reply was
388 * received or some error occurred (timeout or socket shutdown).
390 static int nfs_readpage_done(struct rpc_task *task, struct nfs_pgio_data *data,
393 int status = NFS_PROTO(inode)->read_done(task, data);
397 nfs_add_stats(inode, NFSIOS_SERVERREADBYTES, data->res.count);
399 if (task->tk_status == -ESTALE) {
400 set_bit(NFS_INO_STALE, &NFS_I(inode)->flags);
401 nfs_mark_for_revalidate(inode);
406 static void nfs_readpage_retry(struct rpc_task *task, struct nfs_pgio_data *data)
408 struct nfs_pgio_args *argp = &data->args;
409 struct nfs_pgio_res *resp = &data->res;
411 /* This is a short read! */
412 nfs_inc_stats(data->header->inode, NFSIOS_SHORTREAD);
413 /* Has the server at least made some progress? */
414 if (resp->count == 0) {
415 nfs_set_pgio_error(data->header, -EIO, argp->offset);
418 /* Yes, so retry the read at the end of the data */
419 data->mds_offset += resp->count;
420 argp->offset += resp->count;
421 argp->pgbase += resp->count;
422 argp->count -= resp->count;
423 rpc_restart_call_prepare(task);
426 static void nfs_readpage_result(struct rpc_task *task, struct nfs_pgio_data *data)
428 struct nfs_pgio_header *hdr = data->header;
433 bound = data->args.offset + data->res.count;
434 spin_lock(&hdr->lock);
435 if (bound < hdr->io_start + hdr->good_bytes) {
436 set_bit(NFS_IOHDR_EOF, &hdr->flags);
437 clear_bit(NFS_IOHDR_ERROR, &hdr->flags);
438 hdr->good_bytes = bound - hdr->io_start;
440 spin_unlock(&hdr->lock);
441 } else if (data->res.count != data->args.count)
442 nfs_readpage_retry(task, data);
446 * Read a page over NFS.
447 * We read the page synchronously in the following case:
448 * - The error flag is set for this page. This happens only when a
449 * previous async read operation failed.
451 int nfs_readpage(struct file *file, struct page *page)
453 struct nfs_open_context *ctx;
454 struct inode *inode = page_file_mapping(page)->host;
457 dprintk("NFS: nfs_readpage (%p %ld@%lu)\n",
458 page, PAGE_CACHE_SIZE, page_file_index(page));
459 nfs_inc_stats(inode, NFSIOS_VFSREADPAGE);
460 nfs_add_stats(inode, NFSIOS_READPAGES, 1);
463 * Try to flush any pending writes to the file..
465 * NOTE! Because we own the page lock, there cannot
466 * be any new pending writes generated at this point
467 * for this page (other pages can be written to).
469 error = nfs_wb_page(inode, page);
472 if (PageUptodate(page))
476 if (NFS_STALE(inode))
481 ctx = nfs_find_open_context(inode, NULL, FMODE_READ);
485 ctx = get_nfs_open_context(nfs_file_open_context(file));
487 if (!IS_SYNC(inode)) {
488 error = nfs_readpage_from_fscache(ctx, inode, page);
493 error = nfs_readpage_async(ctx, inode, page);
496 put_nfs_open_context(ctx);
503 struct nfs_readdesc {
504 struct nfs_pageio_descriptor *pgio;
505 struct nfs_open_context *ctx;
509 readpage_async_filler(void *data, struct page *page)
511 struct nfs_readdesc *desc = (struct nfs_readdesc *)data;
512 struct inode *inode = page_file_mapping(page)->host;
513 struct nfs_page *new;
517 len = nfs_page_length(page);
519 return nfs_return_empty_page(page);
521 new = nfs_create_request(desc->ctx, inode, page, 0, len);
525 if (len < PAGE_CACHE_SIZE)
526 zero_user_segment(page, len, PAGE_CACHE_SIZE);
527 if (!nfs_pageio_add_request(desc->pgio, new)) {
528 error = desc->pgio->pg_error;
533 error = PTR_ERR(new);
539 int nfs_readpages(struct file *filp, struct address_space *mapping,
540 struct list_head *pages, unsigned nr_pages)
542 struct nfs_pageio_descriptor pgio;
543 struct nfs_readdesc desc = {
546 struct inode *inode = mapping->host;
547 unsigned long npages;
550 dprintk("NFS: nfs_readpages (%s/%Lu %d)\n",
552 (unsigned long long)NFS_FILEID(inode),
554 nfs_inc_stats(inode, NFSIOS_VFSREADPAGES);
556 if (NFS_STALE(inode))
560 desc.ctx = nfs_find_open_context(inode, NULL, FMODE_READ);
561 if (desc.ctx == NULL)
564 desc.ctx = get_nfs_open_context(nfs_file_open_context(filp));
566 /* attempt to read as many of the pages as possible from the cache
567 * - this returns -ENOBUFS immediately if the cookie is negative
569 ret = nfs_readpages_from_fscache(desc.ctx, inode, mapping,
572 goto read_complete; /* all pages were read */
574 nfs_pageio_init_read(&pgio, inode, false,
575 &nfs_async_read_completion_ops);
577 ret = read_cache_pages(mapping, pages, readpage_async_filler, &desc);
579 nfs_pageio_complete(&pgio);
580 NFS_I(inode)->read_io += pgio.pg_bytes_written;
581 npages = (pgio.pg_bytes_written + PAGE_CACHE_SIZE - 1) >> PAGE_CACHE_SHIFT;
582 nfs_add_stats(inode, NFSIOS_READPAGES, npages);
584 put_nfs_open_context(desc.ctx);
589 int __init nfs_init_readpagecache(void)
591 nfs_rdata_cachep = kmem_cache_create("nfs_read_data",
592 sizeof(struct nfs_rw_header),
593 0, SLAB_HWCACHE_ALIGN,
595 if (nfs_rdata_cachep == NULL)
601 void nfs_destroy_readpagecache(void)
603 kmem_cache_destroy(nfs_rdata_cachep);
606 static const struct nfs_rw_ops nfs_rw_read_ops = {
607 .rw_mode = FMODE_READ,
608 .rw_alloc_header = nfs_readhdr_alloc,
609 .rw_free_header = nfs_readhdr_free,
610 .rw_done = nfs_readpage_done,
611 .rw_result = nfs_readpage_result,