2 * linux/fs/nfs/direct.c
4 * Copyright (C) 2003 by Chuck Lever <cel@netapp.com>
6 * High-performance uncached I/O for the Linux NFS client
8 * There are important applications whose performance or correctness
9 * depends on uncached access to file data. Database clusters
10 * (multiple copies of the same instance running on separate hosts)
11 * implement their own cache coherency protocol that subsumes file
12 * system cache protocols. Applications that process datasets
13 * considerably larger than the client's memory do not always benefit
14 * from a local cache. A streaming video server, for instance, has no
15 * need to cache the contents of a file.
17 * When an application requests uncached I/O, all read and write requests
18 * are made directly to the server; data stored or fetched via these
19 * requests is not cached in the Linux page cache. The client does not
20 * correct unaligned requests from applications. All requested bytes are
21 * held on permanent storage before a direct write system call returns to
24 * Solaris implements an uncached I/O facility called directio() that
25 * is used for backups and sequential I/O to very large files. Solaris
26 * also supports uncaching whole NFS partitions with "-o forcedirectio,"
27 * an undocumented mount option.
29 * Designed by Jeff Kimmel, Chuck Lever, and Trond Myklebust, with
30 * help from Andrew Morton.
32 * 18 Dec 2001 Initial implementation for 2.4 --cel
33 * 08 Jul 2002 Version for 2.4.19, with bug fixes --trondmy
34 * 08 Jun 2003 Port to 2.5 APIs --cel
35 * 31 Mar 2004 Handle direct I/O without VFS support --cel
36 * 15 Sep 2004 Parallel async reads --cel
37 * 04 May 2005 support O_DIRECT with aio --cel
41 #include <linux/errno.h>
42 #include <linux/sched.h>
43 #include <linux/kernel.h>
44 #include <linux/smp_lock.h>
45 #include <linux/file.h>
46 #include <linux/pagemap.h>
47 #include <linux/kref.h>
49 #include <linux/nfs_fs.h>
50 #include <linux/nfs_page.h>
51 #include <linux/sunrpc/clnt.h>
53 #include <asm/system.h>
54 #include <asm/uaccess.h>
55 #include <asm/atomic.h>
59 #define NFSDBG_FACILITY NFSDBG_VFS
61 static struct kmem_cache
*nfs_direct_cachep
;
64 * This represents a set of asynchronous requests that we're waiting on
66 struct nfs_direct_req
{
67 struct kref kref
; /* release manager */
70 struct nfs_open_context
*ctx
; /* file open context info */
71 struct kiocb
* iocb
; /* controlling i/o request */
72 struct inode
* inode
; /* target file of i/o */
74 /* completion state */
75 atomic_t io_count
; /* i/os we're waiting for */
76 spinlock_t lock
; /* protect completion state */
77 ssize_t count
, /* bytes actually processed */
78 error
; /* any reported error */
79 struct completion completion
; /* wait for i/o completion */
82 struct list_head rewrite_list
; /* saved nfs_write_data structs */
83 struct nfs_write_data
* commit_data
; /* special write_data for commits */
85 #define NFS_ODIRECT_DO_COMMIT (1) /* an unstable reply was received */
86 #define NFS_ODIRECT_RESCHED_WRITES (2) /* write verification failed */
87 struct nfs_writeverf verf
; /* unstable write verifier */
90 static void nfs_direct_write_complete(struct nfs_direct_req
*dreq
, struct inode
*inode
);
91 static const struct rpc_call_ops nfs_write_direct_ops
;
93 static inline void get_dreq(struct nfs_direct_req
*dreq
)
95 atomic_inc(&dreq
->io_count
);
98 static inline int put_dreq(struct nfs_direct_req
*dreq
)
100 return atomic_dec_and_test(&dreq
->io_count
);
104 * nfs_direct_IO - NFS address space operation for direct I/O
105 * @rw: direction (read or write)
106 * @iocb: target I/O control block
107 * @iov: array of vectors that define I/O buffer
108 * @pos: offset in file to begin the operation
109 * @nr_segs: size of iovec array
111 * The presence of this routine in the address space ops vector means
112 * the NFS client supports direct I/O. However, we shunt off direct
113 * read and write requests before the VFS gets them, so this method
114 * should never be called.
116 ssize_t
nfs_direct_IO(int rw
, struct kiocb
*iocb
, const struct iovec
*iov
, loff_t pos
, unsigned long nr_segs
)
118 dprintk("NFS: nfs_direct_IO (%s) off/no(%Ld/%lu) EINVAL\n",
119 iocb
->ki_filp
->f_path
.dentry
->d_name
.name
,
120 (long long) pos
, nr_segs
);
125 static void nfs_direct_dirty_pages(struct page
**pages
, int npages
)
128 for (i
= 0; i
< npages
; i
++) {
129 struct page
*page
= pages
[i
];
130 if (!PageCompound(page
))
131 set_page_dirty_lock(page
);
135 static void nfs_direct_release_pages(struct page
**pages
, int npages
)
138 for (i
= 0; i
< npages
; i
++)
139 page_cache_release(pages
[i
]);
142 static inline struct nfs_direct_req
*nfs_direct_req_alloc(void)
144 struct nfs_direct_req
*dreq
;
146 dreq
= kmem_cache_alloc(nfs_direct_cachep
, GFP_KERNEL
);
150 kref_init(&dreq
->kref
);
151 kref_get(&dreq
->kref
);
152 init_completion(&dreq
->completion
);
153 INIT_LIST_HEAD(&dreq
->rewrite_list
);
156 spin_lock_init(&dreq
->lock
);
157 atomic_set(&dreq
->io_count
, 0);
165 static void nfs_direct_req_release(struct kref
*kref
)
167 struct nfs_direct_req
*dreq
= container_of(kref
, struct nfs_direct_req
, kref
);
169 if (dreq
->ctx
!= NULL
)
170 put_nfs_open_context(dreq
->ctx
);
171 kmem_cache_free(nfs_direct_cachep
, dreq
);
175 * Collects and returns the final error value/byte-count.
177 static ssize_t
nfs_direct_wait(struct nfs_direct_req
*dreq
)
179 ssize_t result
= -EIOCBQUEUED
;
181 /* Async requests don't wait here */
185 result
= wait_for_completion_interruptible(&dreq
->completion
);
188 result
= dreq
->error
;
190 result
= dreq
->count
;
193 kref_put(&dreq
->kref
, nfs_direct_req_release
);
194 return (ssize_t
) result
;
198 * Synchronous I/O uses a stack-allocated iocb. Thus we can't trust
199 * the iocb is still valid here if this is a synchronous request.
201 static void nfs_direct_complete(struct nfs_direct_req
*dreq
)
204 long res
= (long) dreq
->error
;
206 res
= (long) dreq
->count
;
207 aio_complete(dreq
->iocb
, res
, 0);
209 complete_all(&dreq
->completion
);
211 kref_put(&dreq
->kref
, nfs_direct_req_release
);
215 * We must hold a reference to all the pages in this direct read request
216 * until the RPCs complete. This could be long *after* we are woken up in
217 * nfs_direct_wait (for instance, if someone hits ^C on a slow server).
219 static void nfs_direct_read_result(struct rpc_task
*task
, void *calldata
)
221 struct nfs_read_data
*data
= calldata
;
222 struct nfs_direct_req
*dreq
= (struct nfs_direct_req
*) data
->req
;
224 if (nfs_readpage_result(task
, data
) != 0)
227 nfs_direct_dirty_pages(data
->pagevec
, data
->npages
);
228 nfs_direct_release_pages(data
->pagevec
, data
->npages
);
230 spin_lock(&dreq
->lock
);
232 if (likely(task
->tk_status
>= 0))
233 dreq
->count
+= data
->res
.count
;
235 dreq
->error
= task
->tk_status
;
237 spin_unlock(&dreq
->lock
);
240 nfs_direct_complete(dreq
);
243 static const struct rpc_call_ops nfs_read_direct_ops
= {
244 .rpc_call_done
= nfs_direct_read_result
,
245 .rpc_release
= nfs_readdata_release
,
249 * For each rsize'd chunk of the user's buffer, dispatch an NFS READ
250 * operation. If nfs_readdata_alloc() or get_user_pages() fails,
251 * bail and stop sending more reads. Read length accounting is
252 * handled automatically by nfs_direct_read_result(). Otherwise, if
253 * no requests have been sent, just return an error.
255 static ssize_t
nfs_direct_read_schedule(struct nfs_direct_req
*dreq
, unsigned long user_addr
, size_t count
, loff_t pos
)
257 struct nfs_open_context
*ctx
= dreq
->ctx
;
258 struct inode
*inode
= ctx
->dentry
->d_inode
;
259 size_t rsize
= NFS_SERVER(inode
)->rsize
;
267 struct nfs_read_data
*data
;
270 pgbase
= user_addr
& ~PAGE_MASK
;
271 bytes
= min(rsize
,count
);
274 data
= nfs_readdata_alloc(pgbase
+ bytes
);
278 down_read(¤t
->mm
->mmap_sem
);
279 result
= get_user_pages(current
, current
->mm
, user_addr
,
280 data
->npages
, 1, 0, data
->pagevec
, NULL
);
281 up_read(¤t
->mm
->mmap_sem
);
282 if (unlikely(result
< data
->npages
)) {
284 nfs_direct_release_pages(data
->pagevec
, result
);
285 nfs_readdata_release(data
);
291 data
->req
= (struct nfs_page
*) dreq
;
293 data
->cred
= ctx
->cred
;
294 data
->args
.fh
= NFS_FH(inode
);
295 data
->args
.context
= ctx
;
296 data
->args
.offset
= pos
;
297 data
->args
.pgbase
= pgbase
;
298 data
->args
.pages
= data
->pagevec
;
299 data
->args
.count
= bytes
;
300 data
->res
.fattr
= &data
->fattr
;
302 data
->res
.count
= bytes
;
304 rpc_init_task(&data
->task
, NFS_CLIENT(inode
), RPC_TASK_ASYNC
,
305 &nfs_read_direct_ops
, data
);
306 NFS_PROTO(inode
)->read_setup(data
);
308 data
->task
.tk_cookie
= (unsigned long) inode
;
310 rpc_execute(&data
->task
);
312 dfprintk(VFS
, "NFS: %5u initiated direct read call (req %s/%Ld, %zu bytes @ offset %Lu)\n",
315 (long long)NFS_FILEID(inode
),
317 (unsigned long long)data
->args
.offset
);
322 /* FIXME: Remove this unnecessary math from final patch */
324 pgbase
&= ~PAGE_MASK
;
325 BUG_ON(pgbase
!= (user_addr
& ~PAGE_MASK
));
328 } while (count
!= 0);
331 nfs_direct_complete(dreq
);
335 return result
< 0 ? (ssize_t
) result
: -EFAULT
;
338 static ssize_t
nfs_direct_read(struct kiocb
*iocb
, unsigned long user_addr
, size_t count
, loff_t pos
)
342 struct inode
*inode
= iocb
->ki_filp
->f_mapping
->host
;
343 struct rpc_clnt
*clnt
= NFS_CLIENT(inode
);
344 struct nfs_direct_req
*dreq
;
346 dreq
= nfs_direct_req_alloc();
351 dreq
->ctx
= get_nfs_open_context((struct nfs_open_context
*)iocb
->ki_filp
->private_data
);
352 if (!is_sync_kiocb(iocb
))
355 nfs_add_stats(inode
, NFSIOS_DIRECTREADBYTES
, count
);
356 rpc_clnt_sigmask(clnt
, &oldset
);
357 result
= nfs_direct_read_schedule(dreq
, user_addr
, count
, pos
);
359 result
= nfs_direct_wait(dreq
);
360 rpc_clnt_sigunmask(clnt
, &oldset
);
365 static void nfs_direct_free_writedata(struct nfs_direct_req
*dreq
)
367 while (!list_empty(&dreq
->rewrite_list
)) {
368 struct nfs_write_data
*data
= list_entry(dreq
->rewrite_list
.next
, struct nfs_write_data
, pages
);
369 list_del(&data
->pages
);
370 nfs_direct_release_pages(data
->pagevec
, data
->npages
);
371 nfs_writedata_release(data
);
375 #if defined(CONFIG_NFS_V3) || defined(CONFIG_NFS_V4)
376 static void nfs_direct_write_reschedule(struct nfs_direct_req
*dreq
)
378 struct inode
*inode
= dreq
->inode
;
380 struct nfs_write_data
*data
;
385 list_for_each(p
, &dreq
->rewrite_list
) {
386 data
= list_entry(p
, struct nfs_write_data
, pages
);
393 nfs_fattr_init(&data
->fattr
);
394 data
->res
.count
= data
->args
.count
;
395 memset(&data
->verf
, 0, sizeof(data
->verf
));
398 * Reuse data->task; data->args should not have changed
399 * since the original request was sent.
401 rpc_init_task(&data
->task
, NFS_CLIENT(inode
), RPC_TASK_ASYNC
,
402 &nfs_write_direct_ops
, data
);
403 NFS_PROTO(inode
)->write_setup(data
, FLUSH_STABLE
);
405 data
->task
.tk_priority
= RPC_PRIORITY_NORMAL
;
406 data
->task
.tk_cookie
= (unsigned long) inode
;
409 * We're called via an RPC callback, so BKL is already held.
411 rpc_execute(&data
->task
);
413 dprintk("NFS: %5u rescheduled direct write call (req %s/%Ld, %u bytes @ offset %Lu)\n",
416 (long long)NFS_FILEID(inode
),
418 (unsigned long long)data
->args
.offset
);
422 nfs_direct_write_complete(dreq
, inode
);
425 static void nfs_direct_commit_result(struct rpc_task
*task
, void *calldata
)
427 struct nfs_write_data
*data
= calldata
;
428 struct nfs_direct_req
*dreq
= (struct nfs_direct_req
*) data
->req
;
430 /* Call the NFS version-specific code */
431 if (NFS_PROTO(data
->inode
)->commit_done(task
, data
) != 0)
433 if (unlikely(task
->tk_status
< 0)) {
434 dreq
->error
= task
->tk_status
;
435 dreq
->flags
= NFS_ODIRECT_RESCHED_WRITES
;
437 if (memcmp(&dreq
->verf
, &data
->verf
, sizeof(data
->verf
))) {
438 dprintk("NFS: %5u commit verify failed\n", task
->tk_pid
);
439 dreq
->flags
= NFS_ODIRECT_RESCHED_WRITES
;
442 dprintk("NFS: %5u commit returned %d\n", task
->tk_pid
, task
->tk_status
);
443 nfs_direct_write_complete(dreq
, data
->inode
);
446 static const struct rpc_call_ops nfs_commit_direct_ops
= {
447 .rpc_call_done
= nfs_direct_commit_result
,
448 .rpc_release
= nfs_commit_release
,
451 static void nfs_direct_commit_schedule(struct nfs_direct_req
*dreq
)
453 struct nfs_write_data
*data
= dreq
->commit_data
;
455 data
->inode
= dreq
->inode
;
456 data
->cred
= dreq
->ctx
->cred
;
458 data
->args
.fh
= NFS_FH(data
->inode
);
459 data
->args
.offset
= 0;
460 data
->args
.count
= 0;
462 data
->res
.fattr
= &data
->fattr
;
463 data
->res
.verf
= &data
->verf
;
465 rpc_init_task(&data
->task
, NFS_CLIENT(dreq
->inode
), RPC_TASK_ASYNC
,
466 &nfs_commit_direct_ops
, data
);
467 NFS_PROTO(data
->inode
)->commit_setup(data
, 0);
469 data
->task
.tk_priority
= RPC_PRIORITY_NORMAL
;
470 data
->task
.tk_cookie
= (unsigned long)data
->inode
;
471 /* Note: task.tk_ops->rpc_release will free dreq->commit_data */
472 dreq
->commit_data
= NULL
;
474 dprintk("NFS: %5u initiated commit call\n", data
->task
.tk_pid
);
476 rpc_execute(&data
->task
);
479 static void nfs_direct_write_complete(struct nfs_direct_req
*dreq
, struct inode
*inode
)
481 int flags
= dreq
->flags
;
485 case NFS_ODIRECT_DO_COMMIT
:
486 nfs_direct_commit_schedule(dreq
);
488 case NFS_ODIRECT_RESCHED_WRITES
:
489 nfs_direct_write_reschedule(dreq
);
492 nfs_end_data_update(inode
);
493 if (dreq
->commit_data
!= NULL
)
494 nfs_commit_free(dreq
->commit_data
);
495 nfs_direct_free_writedata(dreq
);
496 nfs_zap_mapping(inode
, inode
->i_mapping
);
497 nfs_direct_complete(dreq
);
501 static void nfs_alloc_commit_data(struct nfs_direct_req
*dreq
)
503 dreq
->commit_data
= nfs_commit_alloc();
504 if (dreq
->commit_data
!= NULL
)
505 dreq
->commit_data
->req
= (struct nfs_page
*) dreq
;
508 static inline void nfs_alloc_commit_data(struct nfs_direct_req
*dreq
)
510 dreq
->commit_data
= NULL
;
513 static void nfs_direct_write_complete(struct nfs_direct_req
*dreq
, struct inode
*inode
)
515 nfs_end_data_update(inode
);
516 nfs_direct_free_writedata(dreq
);
517 nfs_zap_mapping(inode
, inode
->i_mapping
);
518 nfs_direct_complete(dreq
);
522 static void nfs_direct_write_result(struct rpc_task
*task
, void *calldata
)
524 struct nfs_write_data
*data
= calldata
;
525 struct nfs_direct_req
*dreq
= (struct nfs_direct_req
*) data
->req
;
526 int status
= task
->tk_status
;
528 if (nfs_writeback_done(task
, data
) != 0)
531 spin_lock(&dreq
->lock
);
533 if (unlikely(status
< 0)) {
534 dreq
->error
= status
;
538 dreq
->count
+= data
->res
.count
;
540 if (data
->res
.verf
->committed
!= NFS_FILE_SYNC
) {
541 switch (dreq
->flags
) {
543 memcpy(&dreq
->verf
, &data
->verf
, sizeof(dreq
->verf
));
544 dreq
->flags
= NFS_ODIRECT_DO_COMMIT
;
546 case NFS_ODIRECT_DO_COMMIT
:
547 if (memcmp(&dreq
->verf
, &data
->verf
, sizeof(dreq
->verf
))) {
548 dprintk("NFS: %5u write verify failed\n", task
->tk_pid
);
549 dreq
->flags
= NFS_ODIRECT_RESCHED_WRITES
;
554 spin_unlock(&dreq
->lock
);
558 * NB: Return the value of the first error return code. Subsequent
559 * errors after the first one are ignored.
561 static void nfs_direct_write_release(void *calldata
)
563 struct nfs_write_data
*data
= calldata
;
564 struct nfs_direct_req
*dreq
= (struct nfs_direct_req
*) data
->req
;
567 nfs_direct_write_complete(dreq
, data
->inode
);
570 static const struct rpc_call_ops nfs_write_direct_ops
= {
571 .rpc_call_done
= nfs_direct_write_result
,
572 .rpc_release
= nfs_direct_write_release
,
576 * For each wsize'd chunk of the user's buffer, dispatch an NFS WRITE
577 * operation. If nfs_writedata_alloc() or get_user_pages() fails,
578 * bail and stop sending more writes. Write length accounting is
579 * handled automatically by nfs_direct_write_result(). Otherwise, if
580 * no requests have been sent, just return an error.
582 static ssize_t
nfs_direct_write_schedule(struct nfs_direct_req
*dreq
, unsigned long user_addr
, size_t count
, loff_t pos
, int sync
)
584 struct nfs_open_context
*ctx
= dreq
->ctx
;
585 struct inode
*inode
= ctx
->dentry
->d_inode
;
586 size_t wsize
= NFS_SERVER(inode
)->wsize
;
594 struct nfs_write_data
*data
;
597 pgbase
= user_addr
& ~PAGE_MASK
;
598 bytes
= min(wsize
,count
);
601 data
= nfs_writedata_alloc(pgbase
+ bytes
);
605 down_read(¤t
->mm
->mmap_sem
);
606 result
= get_user_pages(current
, current
->mm
, user_addr
,
607 data
->npages
, 0, 0, data
->pagevec
, NULL
);
608 up_read(¤t
->mm
->mmap_sem
);
609 if (unlikely(result
< data
->npages
)) {
611 nfs_direct_release_pages(data
->pagevec
, result
);
612 nfs_writedata_release(data
);
618 list_move_tail(&data
->pages
, &dreq
->rewrite_list
);
620 data
->req
= (struct nfs_page
*) dreq
;
622 data
->cred
= ctx
->cred
;
623 data
->args
.fh
= NFS_FH(inode
);
624 data
->args
.context
= ctx
;
625 data
->args
.offset
= pos
;
626 data
->args
.pgbase
= pgbase
;
627 data
->args
.pages
= data
->pagevec
;
628 data
->args
.count
= bytes
;
629 data
->res
.fattr
= &data
->fattr
;
630 data
->res
.count
= bytes
;
631 data
->res
.verf
= &data
->verf
;
633 rpc_init_task(&data
->task
, NFS_CLIENT(inode
), RPC_TASK_ASYNC
,
634 &nfs_write_direct_ops
, data
);
635 NFS_PROTO(inode
)->write_setup(data
, sync
);
637 data
->task
.tk_priority
= RPC_PRIORITY_NORMAL
;
638 data
->task
.tk_cookie
= (unsigned long) inode
;
640 rpc_execute(&data
->task
);
642 dfprintk(VFS
, "NFS: %5u initiated direct write call (req %s/%Ld, %zu bytes @ offset %Lu)\n",
645 (long long)NFS_FILEID(inode
),
647 (unsigned long long)data
->args
.offset
);
653 /* FIXME: Remove this useless math from the final patch */
655 pgbase
&= ~PAGE_MASK
;
656 BUG_ON(pgbase
!= (user_addr
& ~PAGE_MASK
));
659 } while (count
!= 0);
662 nfs_direct_write_complete(dreq
, inode
);
666 return result
< 0 ? (ssize_t
) result
: -EFAULT
;
669 static ssize_t
nfs_direct_write(struct kiocb
*iocb
, unsigned long user_addr
, size_t count
, loff_t pos
)
673 struct inode
*inode
= iocb
->ki_filp
->f_mapping
->host
;
674 struct rpc_clnt
*clnt
= NFS_CLIENT(inode
);
675 struct nfs_direct_req
*dreq
;
676 size_t wsize
= NFS_SERVER(inode
)->wsize
;
679 dreq
= nfs_direct_req_alloc();
682 nfs_alloc_commit_data(dreq
);
684 if (dreq
->commit_data
== NULL
|| count
< wsize
)
688 dreq
->ctx
= get_nfs_open_context((struct nfs_open_context
*)iocb
->ki_filp
->private_data
);
689 if (!is_sync_kiocb(iocb
))
692 nfs_add_stats(inode
, NFSIOS_DIRECTWRITTENBYTES
, count
);
694 nfs_begin_data_update(inode
);
696 rpc_clnt_sigmask(clnt
, &oldset
);
697 result
= nfs_direct_write_schedule(dreq
, user_addr
, count
, pos
, sync
);
699 result
= nfs_direct_wait(dreq
);
700 rpc_clnt_sigunmask(clnt
, &oldset
);
706 * nfs_file_direct_read - file direct read operation for NFS files
707 * @iocb: target I/O control block
708 * @iov: vector of user buffers into which to read data
709 * @nr_segs: size of iov vector
710 * @pos: byte offset in file where reading starts
712 * We use this function for direct reads instead of calling
713 * generic_file_aio_read() in order to avoid gfar's check to see if
714 * the request starts before the end of the file. For that check
715 * to work, we must generate a GETATTR before each direct read, and
716 * even then there is a window between the GETATTR and the subsequent
717 * READ where the file size could change. Our preference is simply
718 * to do all reads the application wants, and the server will take
719 * care of managing the end of file boundary.
721 * This function also eliminates unnecessarily updating the file's
722 * atime locally, as the NFS server sets the file's atime, and this
723 * client must read the updated atime from the server back into its
726 ssize_t
nfs_file_direct_read(struct kiocb
*iocb
, const struct iovec
*iov
,
727 unsigned long nr_segs
, loff_t pos
)
729 ssize_t retval
= -EINVAL
;
730 struct file
*file
= iocb
->ki_filp
;
731 struct address_space
*mapping
= file
->f_mapping
;
733 const char __user
*buf
= iov
[0].iov_base
;
734 size_t count
= iov
[0].iov_len
;
736 dprintk("nfs: direct read(%s/%s, %lu@%Ld)\n",
737 file
->f_path
.dentry
->d_parent
->d_name
.name
,
738 file
->f_path
.dentry
->d_name
.name
,
739 (unsigned long) count
, (long long) pos
);
747 if (!access_ok(VERIFY_WRITE
, buf
, count
))
753 retval
= nfs_sync_mapping(mapping
);
757 retval
= nfs_direct_read(iocb
, (unsigned long) buf
, count
, pos
);
759 iocb
->ki_pos
= pos
+ retval
;
766 * nfs_file_direct_write - file direct write operation for NFS files
767 * @iocb: target I/O control block
768 * @iov: vector of user buffers from which to write data
769 * @nr_segs: size of iov vector
770 * @pos: byte offset in file where writing starts
772 * We use this function for direct writes instead of calling
773 * generic_file_aio_write() in order to avoid taking the inode
774 * semaphore and updating the i_size. The NFS server will set
775 * the new i_size and this client must read the updated size
776 * back into its cache. We let the server do generic write
777 * parameter checking and report problems.
779 * We also avoid an unnecessary invocation of generic_osync_inode(),
780 * as it is fairly meaningless to sync the metadata of an NFS file.
782 * We eliminate local atime updates, see direct read above.
784 * We avoid unnecessary page cache invalidations for normal cached
785 * readers of this file.
787 * Note that O_APPEND is not supported for NFS direct writes, as there
788 * is no atomic O_APPEND write facility in the NFS protocol.
790 ssize_t
nfs_file_direct_write(struct kiocb
*iocb
, const struct iovec
*iov
,
791 unsigned long nr_segs
, loff_t pos
)
794 struct file
*file
= iocb
->ki_filp
;
795 struct address_space
*mapping
= file
->f_mapping
;
797 const char __user
*buf
= iov
[0].iov_base
;
798 size_t count
= iov
[0].iov_len
;
800 dfprintk(VFS
, "nfs: direct write(%s/%s, %lu@%Ld)\n",
801 file
->f_path
.dentry
->d_parent
->d_name
.name
,
802 file
->f_path
.dentry
->d_name
.name
,
803 (unsigned long) count
, (long long) pos
);
808 retval
= generic_write_checks(file
, &pos
, &count
, 0);
813 if ((ssize_t
) count
< 0)
820 if (!access_ok(VERIFY_READ
, buf
, count
))
823 retval
= nfs_sync_mapping(mapping
);
827 retval
= nfs_direct_write(iocb
, (unsigned long) buf
, count
, pos
);
830 iocb
->ki_pos
= pos
+ retval
;
837 * nfs_init_directcache - create a slab cache for nfs_direct_req structures
840 int __init
nfs_init_directcache(void)
842 nfs_direct_cachep
= kmem_cache_create("nfs_direct_cache",
843 sizeof(struct nfs_direct_req
),
844 0, (SLAB_RECLAIM_ACCOUNT
|
847 if (nfs_direct_cachep
== NULL
)
854 * nfs_destroy_directcache - destroy the slab cache for nfs_direct_req structures
857 void nfs_destroy_directcache(void)
859 kmem_cache_destroy(nfs_direct_cachep
);