1 /* AFS superblock handling
3 * Copyright (c) 2002, 2007, 2018 Red Hat, Inc. All rights reserved.
5 * This software may be freely redistributed under the terms of the
6 * GNU General Public License.
8 * You should have received a copy of the GNU General Public License
9 * along with this program; if not, write to the Free Software
10 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
12 * Authors: David Howells <dhowells@redhat.com>
13 * David Woodhouse <dwmw2@infradead.org>
17 #include <linux/kernel.h>
18 #include <linux/module.h>
19 #include <linux/mount.h>
20 #include <linux/init.h>
21 #include <linux/slab.h>
23 #include <linux/pagemap.h>
24 #include <linux/fs_parser.h>
25 #include <linux/statfs.h>
26 #include <linux/sched.h>
27 #include <linux/nsproxy.h>
28 #include <linux/magic.h>
29 #include <net/net_namespace.h>
32 static void afs_i_init_once(void *foo);
33 static void afs_kill_super(struct super_block *sb);
34 static struct inode *afs_alloc_inode(struct super_block *sb);
35 static void afs_destroy_inode(struct inode *inode);
36 static void afs_free_inode(struct inode *inode);
37 static int afs_statfs(struct dentry *dentry, struct kstatfs *buf);
38 static int afs_show_devname(struct seq_file *m, struct dentry *root);
39 static int afs_show_options(struct seq_file *m, struct dentry *root);
40 static int afs_init_fs_context(struct fs_context *fc);
41 static const struct fs_parameter_spec afs_fs_parameters[];
43 struct file_system_type afs_fs_type = {
46 .init_fs_context = afs_init_fs_context,
47 .parameters = afs_fs_parameters,
48 .kill_sb = afs_kill_super,
49 .fs_flags = FS_RENAME_DOES_D_MOVE,
51 MODULE_ALIAS_FS("afs");
55 static const struct super_operations afs_super_ops = {
57 .alloc_inode = afs_alloc_inode,
58 .write_inode = afs_write_inode,
59 .drop_inode = afs_drop_inode,
60 .destroy_inode = afs_destroy_inode,
61 .free_inode = afs_free_inode,
62 .evict_inode = afs_evict_inode,
63 .show_devname = afs_show_devname,
64 .show_options = afs_show_options,
67 static struct kmem_cache *afs_inode_cachep;
68 static atomic_t afs_count_active_inodes;
77 static const struct constant_table afs_param_flock[] = {
78 {"local", afs_flock_mode_local },
79 {"openafs", afs_flock_mode_openafs },
80 {"strict", afs_flock_mode_strict },
81 {"write", afs_flock_mode_write },
85 static const struct fs_parameter_spec afs_fs_parameters[] = {
86 fsparam_flag ("autocell", Opt_autocell),
87 fsparam_flag ("dyn", Opt_dyn),
88 fsparam_enum ("flock", Opt_flock, afs_param_flock),
89 fsparam_string("source", Opt_source),
94 * initialise the filesystem
96 int __init afs_fs_init(void)
102 /* create ourselves an inode cache */
103 atomic_set(&afs_count_active_inodes, 0);
106 afs_inode_cachep = kmem_cache_create("afs_inode_cache",
107 sizeof(struct afs_vnode),
109 SLAB_HWCACHE_ALIGN|SLAB_ACCOUNT,
111 if (!afs_inode_cachep) {
112 printk(KERN_NOTICE "kAFS: Failed to allocate inode cache\n");
116 /* now export our filesystem to lesser mortals */
117 ret = register_filesystem(&afs_fs_type);
119 kmem_cache_destroy(afs_inode_cachep);
120 _leave(" = %d", ret);
129 * clean up the filesystem
131 void afs_fs_exit(void)
135 afs_mntpt_kill_timer();
136 unregister_filesystem(&afs_fs_type);
138 if (atomic_read(&afs_count_active_inodes) != 0) {
139 printk("kAFS: %d active inode objects still present\n",
140 atomic_read(&afs_count_active_inodes));
145 * Make sure all delayed rcu free inodes are flushed before we
149 kmem_cache_destroy(afs_inode_cachep);
154 * Display the mount device name in /proc/mounts.
156 static int afs_show_devname(struct seq_file *m, struct dentry *root)
158 struct afs_super_info *as = AFS_FS_S(root->d_sb);
159 struct afs_volume *volume = as->volume;
160 struct afs_cell *cell = as->cell;
161 const char *suf = "";
169 switch (volume->type) {
174 if (volume->type_force)
183 seq_printf(m, "%c%s:%s%s", pref, cell->name, volume->name, suf);
188 * Display the mount options in /proc/mounts.
190 static int afs_show_options(struct seq_file *m, struct dentry *root)
192 struct afs_super_info *as = AFS_FS_S(root->d_sb);
193 const char *p = NULL;
197 if (test_bit(AFS_VNODE_AUTOCELL, &AFS_FS_I(d_inode(root))->flags))
198 seq_puts(m, ",autocell");
199 switch (as->flock_mode) {
200 case afs_flock_mode_unset: break;
201 case afs_flock_mode_local: p = "local"; break;
202 case afs_flock_mode_openafs: p = "openafs"; break;
203 case afs_flock_mode_strict: p = "strict"; break;
204 case afs_flock_mode_write: p = "write"; break;
207 seq_printf(m, ",flock=%s", p);
213 * Parse the source name to get cell name, volume name, volume type and R/W
216 * This can be one of the following:
217 * "%[cell:]volume[.]" R/W volume
218 * "#[cell:]volume[.]" R/O or R/W volume (R/O parent),
219 * or R/W (R/W parent) volume
220 * "%[cell:]volume.readonly" R/O volume
221 * "#[cell:]volume.readonly" R/O volume
222 * "%[cell:]volume.backup" Backup volume
223 * "#[cell:]volume.backup" Backup volume
225 static int afs_parse_source(struct fs_context *fc, struct fs_parameter *param)
227 struct afs_fs_context *ctx = fc->fs_private;
228 struct afs_cell *cell;
229 const char *cellname, *suffix, *name = param->string;
235 return invalf(fc, "kAFS: Multiple sources not supported");
238 printk(KERN_ERR "kAFS: no volume name specified\n");
242 if ((name[0] != '%' && name[0] != '#') || !name[1]) {
243 /* To use dynroot, we don't want to have to provide a source */
244 if (strcmp(name, "none") == 0) {
248 printk(KERN_ERR "kAFS: unparsable volume name\n");
252 /* determine the type of volume we're looking for */
253 if (name[0] == '%') {
254 ctx->type = AFSVL_RWVOL;
259 /* split the cell name out if there is one */
260 ctx->volname = strchr(name, ':');
263 cellnamesz = ctx->volname - name;
271 /* the volume type is further affected by a possible suffix */
272 suffix = strrchr(ctx->volname, '.');
274 if (strcmp(suffix, ".readonly") == 0) {
275 ctx->type = AFSVL_ROVOL;
277 } else if (strcmp(suffix, ".backup") == 0) {
278 ctx->type = AFSVL_BACKVOL;
280 } else if (suffix[1] == 0) {
286 ctx->volnamesz = suffix ?
287 suffix - ctx->volname : strlen(ctx->volname);
289 _debug("cell %*.*s [%p]",
290 cellnamesz, cellnamesz, cellname ?: "", ctx->cell);
292 /* lookup the cell record */
294 cell = afs_lookup_cell(ctx->net, cellname, cellnamesz,
297 pr_err("kAFS: unable to lookup cell '%*.*s'\n",
298 cellnamesz, cellnamesz, cellname ?: "");
299 return PTR_ERR(cell);
301 afs_unuse_cell(ctx->net, ctx->cell, afs_cell_trace_unuse_parse);
302 afs_see_cell(cell, afs_cell_trace_see_source);
306 _debug("CELL:%s [%p] VOLUME:%*.*s SUFFIX:%s TYPE:%d%s",
307 ctx->cell->name, ctx->cell,
308 ctx->volnamesz, ctx->volnamesz, ctx->volname,
309 suffix ?: "-", ctx->type, ctx->force ? " FORCE" : "");
311 fc->source = param->string;
312 param->string = NULL;
317 * Parse a single mount parameter.
319 static int afs_parse_param(struct fs_context *fc, struct fs_parameter *param)
321 struct fs_parse_result result;
322 struct afs_fs_context *ctx = fc->fs_private;
325 opt = fs_parse(fc, afs_fs_parameters, param, &result);
331 return afs_parse_source(fc, param);
334 ctx->autocell = true;
338 ctx->dyn_root = true;
342 ctx->flock_mode = result.uint_32;
354 * Validate the options, get the cell key and look up the volume.
356 static int afs_validate_fc(struct fs_context *fc)
358 struct afs_fs_context *ctx = fc->fs_private;
359 struct afs_volume *volume;
360 struct afs_cell *cell;
364 if (!ctx->dyn_root) {
366 pr_warn("kAFS: Can only specify source 'none' with -o dyn\n");
371 pr_warn("kAFS: No cell specified\n");
372 return -EDESTADDRREQ;
376 /* We try to do the mount securely. */
377 key = afs_request_key(ctx->cell);
384 afs_put_volume(ctx->net, ctx->volume,
385 afs_volume_trace_put_validate_fc);
389 if (test_bit(AFS_CELL_FL_CHECK_ALIAS, &ctx->cell->flags)) {
390 ret = afs_cell_detect_alias(ctx->cell, key);
394 _debug("switch to alias");
397 cell = afs_use_cell(ctx->cell->alias_of,
398 afs_cell_trace_use_fc_alias);
399 afs_unuse_cell(ctx->net, ctx->cell, afs_cell_trace_unuse_fc);
405 volume = afs_create_volume(ctx);
407 return PTR_ERR(volume);
409 ctx->volume = volume;
410 if (volume->type != AFSVL_RWVOL)
411 ctx->flock_mode = afs_flock_mode_local;
418 * check a superblock to see if it's the one we're looking for
420 static int afs_test_super(struct super_block *sb, struct fs_context *fc)
422 struct afs_fs_context *ctx = fc->fs_private;
423 struct afs_super_info *as = AFS_FS_S(sb);
425 return (as->net_ns == fc->net_ns &&
427 as->volume->vid == ctx->volume->vid &&
428 as->cell == ctx->cell &&
432 static int afs_dynroot_test_super(struct super_block *sb, struct fs_context *fc)
434 struct afs_super_info *as = AFS_FS_S(sb);
436 return (as->net_ns == fc->net_ns &&
440 static int afs_set_super(struct super_block *sb, struct fs_context *fc)
442 return set_anon_super(sb, NULL);
446 * fill in the superblock
448 static int afs_fill_super(struct super_block *sb, struct afs_fs_context *ctx)
450 struct afs_super_info *as = AFS_FS_S(sb);
451 struct inode *inode = NULL;
456 /* fill in the superblock */
457 sb->s_blocksize = PAGE_SIZE;
458 sb->s_blocksize_bits = PAGE_SHIFT;
459 sb->s_maxbytes = MAX_LFS_FILESIZE;
460 sb->s_magic = AFS_FS_MAGIC;
461 sb->s_op = &afs_super_ops;
463 sb->s_xattr = afs_xattr_handlers;
464 ret = super_setup_bdi(sb);
468 /* allocate the root inode and dentry */
470 inode = afs_iget_pseudo_dir(sb, true);
472 sprintf(sb->s_id, "%llu", as->volume->vid);
473 afs_activate_volume(as->volume);
474 inode = afs_root_iget(sb, ctx->key);
478 return PTR_ERR(inode);
480 if (ctx->autocell || as->dyn_root)
481 set_bit(AFS_VNODE_AUTOCELL, &AFS_FS_I(inode)->flags);
484 sb->s_root = d_make_root(inode);
489 sb->s_d_op = &afs_dynroot_dentry_operations;
490 ret = afs_dynroot_populate(sb);
494 sb->s_d_op = &afs_fs_dentry_operations;
495 rcu_assign_pointer(as->volume->sb, sb);
502 _leave(" = %d", ret);
506 static struct afs_super_info *afs_alloc_sbi(struct fs_context *fc)
508 struct afs_fs_context *ctx = fc->fs_private;
509 struct afs_super_info *as;
511 as = kzalloc(sizeof(struct afs_super_info), GFP_KERNEL);
513 as->net_ns = get_net(fc->net_ns);
514 as->flock_mode = ctx->flock_mode;
518 as->cell = afs_use_cell(ctx->cell, afs_cell_trace_use_sbi);
519 as->volume = afs_get_volume(ctx->volume,
520 afs_volume_trace_get_alloc_sbi);
526 static void afs_destroy_sbi(struct afs_super_info *as)
529 struct afs_net *net = afs_net(as->net_ns);
530 afs_put_volume(net, as->volume, afs_volume_trace_put_destroy_sbi);
531 afs_unuse_cell(net, as->cell, afs_cell_trace_unuse_sbi);
537 static void afs_kill_super(struct super_block *sb)
539 struct afs_super_info *as = AFS_FS_S(sb);
542 afs_dynroot_depopulate(sb);
544 /* Clear the callback interests (which will do ilookup5) before
545 * deactivating the superblock.
548 rcu_assign_pointer(as->volume->sb, NULL);
551 afs_deactivate_volume(as->volume);
556 * Get an AFS superblock and root directory.
558 static int afs_get_tree(struct fs_context *fc)
560 struct afs_fs_context *ctx = fc->fs_private;
561 struct super_block *sb;
562 struct afs_super_info *as;
565 ret = afs_validate_fc(fc);
571 /* allocate a superblock info record */
573 as = afs_alloc_sbi(fc);
578 /* allocate a deviceless superblock */
580 as->dyn_root ? afs_dynroot_test_super : afs_test_super,
588 /* initial superblock/root creation */
590 ret = afs_fill_super(sb, ctx);
593 sb->s_flags |= SB_ACTIVE;
596 ASSERTCMP(sb->s_flags, &, SB_ACTIVE);
599 fc->root = dget(sb->s_root);
600 trace_afs_get_tree(as->cell, as->volume);
601 _leave(" = 0 [%p]", sb);
605 deactivate_locked_super(sb);
607 _leave(" = %d", ret);
611 static void afs_free_fc(struct fs_context *fc)
613 struct afs_fs_context *ctx = fc->fs_private;
615 afs_destroy_sbi(fc->s_fs_info);
616 afs_put_volume(ctx->net, ctx->volume, afs_volume_trace_put_free_fc);
617 afs_unuse_cell(ctx->net, ctx->cell, afs_cell_trace_unuse_fc);
622 static const struct fs_context_operations afs_context_ops = {
624 .parse_param = afs_parse_param,
625 .get_tree = afs_get_tree,
629 * Set up the filesystem mount context.
631 static int afs_init_fs_context(struct fs_context *fc)
633 struct afs_fs_context *ctx;
634 struct afs_cell *cell;
636 ctx = kzalloc(sizeof(struct afs_fs_context), GFP_KERNEL);
640 ctx->type = AFSVL_ROVOL;
641 ctx->net = afs_net(fc->net_ns);
643 /* Default to the workstation cell. */
644 cell = afs_find_cell(ctx->net, NULL, 0, afs_cell_trace_use_fc);
649 fc->fs_private = ctx;
650 fc->ops = &afs_context_ops;
655 * Initialise an inode cache slab element prior to any use. Note that
656 * afs_alloc_inode() *must* reset anything that could incorrectly leak from one
659 static void afs_i_init_once(void *_vnode)
661 struct afs_vnode *vnode = _vnode;
663 memset(vnode, 0, sizeof(*vnode));
664 inode_init_once(&vnode->netfs.inode);
665 mutex_init(&vnode->io_lock);
666 init_rwsem(&vnode->validate_lock);
667 spin_lock_init(&vnode->wb_lock);
668 spin_lock_init(&vnode->lock);
669 INIT_LIST_HEAD(&vnode->wb_keys);
670 INIT_LIST_HEAD(&vnode->pending_locks);
671 INIT_LIST_HEAD(&vnode->granted_locks);
672 INIT_DELAYED_WORK(&vnode->lock_work, afs_lock_work);
673 INIT_LIST_HEAD(&vnode->cb_mmap_link);
674 seqlock_init(&vnode->cb_lock);
678 * allocate an AFS inode struct from our slab cache
680 static struct inode *afs_alloc_inode(struct super_block *sb)
682 struct afs_vnode *vnode;
684 vnode = alloc_inode_sb(sb, afs_inode_cachep, GFP_KERNEL);
688 atomic_inc(&afs_count_active_inodes);
690 /* Reset anything that shouldn't leak from one inode to the next. */
691 memset(&vnode->fid, 0, sizeof(vnode->fid));
692 memset(&vnode->status, 0, sizeof(vnode->status));
693 afs_vnode_set_cache(vnode, NULL);
695 vnode->volume = NULL;
696 vnode->lock_key = NULL;
697 vnode->permit_cache = NULL;
699 vnode->flags = 1 << AFS_VNODE_UNSET;
700 vnode->lock_state = AFS_VNODE_LOCK_NONE;
702 init_rwsem(&vnode->rmdir_lock);
703 INIT_WORK(&vnode->cb_work, afs_invalidate_mmap_work);
705 _leave(" = %p", &vnode->netfs.inode);
706 return &vnode->netfs.inode;
709 static void afs_free_inode(struct inode *inode)
711 kmem_cache_free(afs_inode_cachep, AFS_FS_I(inode));
715 * destroy an AFS inode struct
717 static void afs_destroy_inode(struct inode *inode)
719 struct afs_vnode *vnode = AFS_FS_I(inode);
721 _enter("%p{%llx:%llu}", inode, vnode->fid.vid, vnode->fid.vnode);
723 _debug("DESTROY INODE %p", inode);
725 atomic_dec(&afs_count_active_inodes);
728 static void afs_get_volume_status_success(struct afs_operation *op)
730 struct afs_volume_status *vs = &op->volstatus.vs;
731 struct kstatfs *buf = op->volstatus.buf;
733 if (vs->max_quota == 0)
734 buf->f_blocks = vs->part_max_blocks;
736 buf->f_blocks = vs->max_quota;
738 if (buf->f_blocks > vs->blocks_in_use)
739 buf->f_bavail = buf->f_bfree =
740 buf->f_blocks - vs->blocks_in_use;
743 static const struct afs_operation_ops afs_get_volume_status_operation = {
744 .issue_afs_rpc = afs_fs_get_volume_status,
745 .issue_yfs_rpc = yfs_fs_get_volume_status,
746 .success = afs_get_volume_status_success,
750 * return information about an AFS volume
752 static int afs_statfs(struct dentry *dentry, struct kstatfs *buf)
754 struct afs_super_info *as = AFS_FS_S(dentry->d_sb);
755 struct afs_operation *op;
756 struct afs_vnode *vnode = AFS_FS_I(d_inode(dentry));
758 buf->f_type = dentry->d_sb->s_magic;
759 buf->f_bsize = AFS_BLOCK_SIZE;
760 buf->f_namelen = AFSNAMEMAX - 1;
769 op = afs_alloc_operation(NULL, as->volume);
773 afs_op_set_vnode(op, 0, vnode);
775 op->volstatus.buf = buf;
776 op->ops = &afs_get_volume_status_operation;
777 return afs_do_sync_operation(op);