1 /* AFS filesystem file handling
3 * Copyright (C) 2002, 2007 Red Hat, Inc. All Rights Reserved.
4 * Written by David Howells (dhowells@redhat.com)
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
12 #include <linux/kernel.h>
13 #include <linux/module.h>
14 #include <linux/init.h>
16 #include <linux/pagemap.h>
17 #include <linux/writeback.h>
18 #include <linux/gfp.h>
21 static int afs_readpage(struct file *file, struct page *page);
22 static void afs_invalidatepage(struct page *page, unsigned int offset,
24 static int afs_releasepage(struct page *page, gfp_t gfp_flags);
25 static int afs_launder_page(struct page *page);
27 static int afs_readpages(struct file *filp, struct address_space *mapping,
28 struct list_head *pages, unsigned nr_pages);
30 const struct file_operations afs_file_operations = {
32 .release = afs_release,
33 .llseek = generic_file_llseek,
35 .write = do_sync_write,
36 .aio_read = generic_file_aio_read,
37 .aio_write = afs_file_write,
38 .mmap = generic_file_readonly_mmap,
39 .splice_read = generic_file_splice_read,
45 const struct inode_operations afs_file_inode_operations = {
46 .getattr = afs_getattr,
47 .setattr = afs_setattr,
48 .permission = afs_permission,
51 const struct address_space_operations afs_fs_aops = {
52 .readpage = afs_readpage,
53 .readpages = afs_readpages,
54 .set_page_dirty = afs_set_page_dirty,
55 .launder_page = afs_launder_page,
56 .releasepage = afs_releasepage,
57 .invalidatepage = afs_invalidatepage,
58 .write_begin = afs_write_begin,
59 .write_end = afs_write_end,
60 .writepage = afs_writepage,
61 .writepages = afs_writepages,
65 * open an AFS file or directory and attach a key to it
67 int afs_open(struct inode *inode, struct file *file)
69 struct afs_vnode *vnode = AFS_FS_I(inode);
73 _enter("{%x:%u},", vnode->fid.vid, vnode->fid.vnode);
75 key = afs_request_key(vnode->volume->cell);
77 _leave(" = %ld [key]", PTR_ERR(key));
81 ret = afs_validate(vnode, key);
83 _leave(" = %d [val]", ret);
87 file->private_data = key;
93 * release an AFS file or directory and discard its key
95 int afs_release(struct inode *inode, struct file *file)
97 struct afs_vnode *vnode = AFS_FS_I(inode);
99 _enter("{%x:%u},", vnode->fid.vid, vnode->fid.vnode);
101 key_put(file->private_data);
106 #ifdef CONFIG_AFS_FSCACHE
108 * deal with notification that a page was read from the cache
110 static void afs_file_readpage_read_complete(struct page *page,
114 _enter("%p,%p,%d", page, data, error);
116 /* if the read completes with an error, we just unlock the page and let
117 * the VM reissue the readpage */
119 SetPageUptodate(page);
125 * read page from file, directory or symlink, given a key to use
127 int afs_page_filler(void *data, struct page *page)
129 struct inode *inode = page->mapping->host;
130 struct afs_vnode *vnode = AFS_FS_I(inode);
131 struct key *key = data;
136 _enter("{%x},{%lu},{%lu}", key_serial(key), inode->i_ino, page->index);
138 BUG_ON(!PageLocked(page));
141 if (test_bit(AFS_VNODE_DELETED, &vnode->flags))
145 #ifdef CONFIG_AFS_FSCACHE
146 ret = fscache_read_or_alloc_page(vnode->cache,
148 afs_file_readpage_read_complete,
155 /* read BIO submitted (page in cache) */
159 /* page not yet cached */
161 _debug("cache said ENODATA");
164 /* page will not be cached */
166 _debug("cache said ENOBUFS");
169 offset = page->index << PAGE_CACHE_SHIFT;
170 len = min_t(size_t, i_size_read(inode) - offset, PAGE_SIZE);
172 /* read the contents of the file from the server into the
174 ret = afs_vnode_fetch_data(vnode, key, offset, len, page);
176 if (ret == -ENOENT) {
177 _debug("got NOENT from server"
178 " - marking file deleted and stale");
179 set_bit(AFS_VNODE_DELETED, &vnode->flags);
183 #ifdef CONFIG_AFS_FSCACHE
184 fscache_uncache_page(vnode->cache, page);
186 BUG_ON(PageFsCache(page));
190 SetPageUptodate(page);
192 /* send the page to the cache */
193 #ifdef CONFIG_AFS_FSCACHE
194 if (PageFsCache(page) &&
195 fscache_write_page(vnode->cache, page, GFP_KERNEL) != 0) {
196 fscache_uncache_page(vnode->cache, page);
197 BUG_ON(PageFsCache(page));
209 _leave(" = %d", ret);
214 * read page from file, directory or symlink, given a file to nominate the key
217 static int afs_readpage(struct file *file, struct page *page)
223 key = file->private_data;
225 ret = afs_page_filler(key, page);
227 struct inode *inode = page->mapping->host;
228 key = afs_request_key(AFS_FS_S(inode->i_sb)->volume->cell);
232 ret = afs_page_filler(key, page);
240 * read a set of pages
242 static int afs_readpages(struct file *file, struct address_space *mapping,
243 struct list_head *pages, unsigned nr_pages)
245 struct key *key = file->private_data;
246 struct afs_vnode *vnode;
249 _enter("{%d},{%lu},,%d",
250 key_serial(key), mapping->host->i_ino, nr_pages);
254 vnode = AFS_FS_I(mapping->host);
255 if (test_bit(AFS_VNODE_DELETED, &vnode->flags)) {
256 _leave(" = -ESTALE");
260 /* attempt to read as many of the pages as possible */
261 #ifdef CONFIG_AFS_FSCACHE
262 ret = fscache_read_or_alloc_pages(vnode->cache,
266 afs_file_readpage_read_complete,
268 mapping_gfp_mask(mapping));
274 /* all pages are being read from the cache */
276 BUG_ON(!list_empty(pages));
277 BUG_ON(nr_pages != 0);
278 _leave(" = 0 [reading all]");
281 /* there were pages that couldn't be read from the cache */
288 _leave(" = %d", ret);
292 /* load the missing pages from the network */
293 ret = read_cache_pages(mapping, pages, afs_page_filler, key);
295 _leave(" = %d [netting]", ret);
300 * write back a dirty page
302 static int afs_launder_page(struct page *page)
304 _enter("{%lu}", page->index);
310 * invalidate part or all of a page
311 * - release a page and clean up its private data if offset is 0 (indicating
314 static void afs_invalidatepage(struct page *page, unsigned int offset,
317 struct afs_writeback *wb = (struct afs_writeback *) page_private(page);
319 _enter("{%lu},%u,%u", page->index, offset, length);
321 BUG_ON(!PageLocked(page));
323 /* we clean up only if the entire page is being invalidated */
324 if (offset == 0 && length == PAGE_CACHE_SIZE) {
325 #ifdef CONFIG_AFS_FSCACHE
326 if (PageFsCache(page)) {
327 struct afs_vnode *vnode = AFS_FS_I(page->mapping->host);
328 fscache_wait_on_page_write(vnode->cache, page);
329 fscache_uncache_page(vnode->cache, page);
333 if (PagePrivate(page)) {
334 if (wb && !PageWriteback(page)) {
335 set_page_private(page, 0);
336 afs_put_writeback(wb);
339 if (!page_private(page))
340 ClearPagePrivate(page);
348 * release a page and clean up its private state if it's not busy
349 * - return true if the page can now be released, false if not
351 static int afs_releasepage(struct page *page, gfp_t gfp_flags)
353 struct afs_writeback *wb = (struct afs_writeback *) page_private(page);
354 struct afs_vnode *vnode = AFS_FS_I(page->mapping->host);
356 _enter("{{%x:%u}[%lu],%lx},%x",
357 vnode->fid.vid, vnode->fid.vnode, page->index, page->flags,
360 /* deny if page is being written to the cache and the caller hasn't
362 #ifdef CONFIG_AFS_FSCACHE
363 if (!fscache_maybe_release_page(vnode->cache, page, gfp_flags)) {
364 _leave(" = F [cache busy]");
369 if (PagePrivate(page)) {
371 set_page_private(page, 0);
372 afs_put_writeback(wb);
374 ClearPagePrivate(page);
377 /* indicate that the page can be released */