[mirror_ubuntu-bionic-kernel.git] / fs / hfsplus / super.c

/*
 *  linux/fs/hfsplus/super.c
 *
 * Copyright (C) 2001
 * Brad Boyer (flar@allandria.com)
 * (C) 2003 Ardis Technologies <roman@ardistech.com>
 *
 */

#include <linux/module.h>
#include <linux/init.h>
#include <linux/pagemap.h>
#include <linux/fs.h>
#include <linux/slab.h>
#include <linux/vfs.h>
#include <linux/nls.h>

static struct inode *hfsplus_alloc_inode(struct super_block *sb);
static void hfsplus_destroy_inode(struct inode *inode);

#include "hfsplus_fs.h"

static int hfsplus_system_read_inode(struct inode *inode)
{
	struct hfsplus_vh *vhdr = HFSPLUS_SB(inode->i_sb)->s_vhdr;

	switch (inode->i_ino) {
	case HFSPLUS_EXT_CNID:
		hfsplus_inode_read_fork(inode, &vhdr->ext_file);
		inode->i_mapping->a_ops = &hfsplus_btree_aops;
		break;
	case HFSPLUS_CAT_CNID:
		hfsplus_inode_read_fork(inode, &vhdr->cat_file);
		inode->i_mapping->a_ops = &hfsplus_btree_aops;
		break;
	case HFSPLUS_ALLOC_CNID:
		hfsplus_inode_read_fork(inode, &vhdr->alloc_file);
		inode->i_mapping->a_ops = &hfsplus_aops;
		break;
	case HFSPLUS_START_CNID:
		hfsplus_inode_read_fork(inode, &vhdr->start_file);
		break;
	case HFSPLUS_ATTR_CNID:
		hfsplus_inode_read_fork(inode, &vhdr->attr_file);
		inode->i_mapping->a_ops = &hfsplus_btree_aops;
		break;
	default:
		return -EIO;
	}

	return 0;
}

struct inode *hfsplus_iget(struct super_block *sb, unsigned long ino)
{
	struct hfs_find_data fd;
	struct inode *inode;
	int err;

	inode = iget_locked(sb, ino);
	if (!inode)
		return ERR_PTR(-ENOMEM);
	if (!(inode->i_state & I_NEW))
		return inode;

	INIT_LIST_HEAD(&HFSPLUS_I(inode)->open_dir_list);
	mutex_init(&HFSPLUS_I(inode)->extents_lock);
	HFSPLUS_I(inode)->flags = 0;
	HFSPLUS_I(inode)->rsrc_inode = NULL;
	atomic_set(&HFSPLUS_I(inode)->opencnt, 0);

	if (inode->i_ino >= HFSPLUS_FIRSTUSER_CNID ||
	    inode->i_ino == HFSPLUS_ROOT_CNID) {
		hfs_find_init(HFSPLUS_SB(inode->i_sb)->cat_tree, &fd);
		err = hfsplus_find_cat(inode->i_sb, inode->i_ino, &fd);
		if (!err)
			err = hfsplus_cat_read_inode(inode, &fd);
		hfs_find_exit(&fd);
	} else {
		err = hfsplus_system_read_inode(inode);
	}

	if (err) {
		iget_failed(inode);
		return ERR_PTR(err);
	}

	unlock_new_inode(inode);
	return inode;
}

static int hfsplus_system_write_inode(struct inode *inode)
{
	struct hfsplus_sb_info *sbi = HFSPLUS_SB(inode->i_sb);
	struct hfsplus_vh *vhdr = sbi->s_vhdr;
	struct hfsplus_fork_raw *fork;
	struct hfs_btree *tree = NULL;

	switch (inode->i_ino) {
	case HFSPLUS_EXT_CNID:
		fork = &vhdr->ext_file;
		tree = sbi->ext_tree;
		break;
	case HFSPLUS_CAT_CNID:
		fork = &vhdr->cat_file;
		tree = sbi->cat_tree;
		break;
	case HFSPLUS_ALLOC_CNID:
		fork = &vhdr->alloc_file;
		break;
	case HFSPLUS_START_CNID:
		fork = &vhdr->start_file;
		break;
	case HFSPLUS_ATTR_CNID:
		fork = &vhdr->attr_file;
		tree = sbi->attr_tree;
	default:
		return -EIO;
	}

	if (fork->total_size != cpu_to_be64(inode->i_size)) {
		set_bit(HFSPLUS_SB_WRITEBACKUP, &sbi->flags);
		inode->i_sb->s_dirt = 1;
	}
	hfsplus_inode_write_fork(inode, fork);
	if (tree)
		hfs_btree_write(tree);
	return 0;
}

static int hfsplus_write_inode(struct inode *inode,
		struct writeback_control *wbc)
{
	dprint(DBG_INODE, "hfsplus_write_inode: %lu\n", inode->i_ino);

	hfsplus_ext_write_extent(inode);

	if (inode->i_ino >= HFSPLUS_FIRSTUSER_CNID ||
	    inode->i_ino == HFSPLUS_ROOT_CNID)
		return hfsplus_cat_write_inode(inode);
	else
		return hfsplus_system_write_inode(inode);
}

static void hfsplus_evict_inode(struct inode *inode)
{
	dprint(DBG_INODE, "hfsplus_evict_inode: %lu\n", inode->i_ino);
	truncate_inode_pages(&inode->i_data, 0);
	end_writeback(inode);
	if (HFSPLUS_IS_RSRC(inode)) {
		HFSPLUS_I(HFSPLUS_I(inode)->rsrc_inode)->rsrc_inode = NULL;
		iput(HFSPLUS_I(inode)->rsrc_inode);
	}
}

int hfsplus_sync_fs(struct super_block *sb, int wait)
{
	struct hfsplus_sb_info *sbi = HFSPLUS_SB(sb);
	struct hfsplus_vh *vhdr = sbi->s_vhdr;

	dprint(DBG_SUPER, "hfsplus_write_super\n");

	mutex_lock(&sbi->vh_mutex);
	mutex_lock(&sbi->alloc_mutex);
	sb->s_dirt = 0;

	vhdr->free_blocks = cpu_to_be32(sbi->free_blocks);
	vhdr->next_cnid = cpu_to_be32(sbi->next_cnid);
	vhdr->folder_count = cpu_to_be32(sbi->folder_count);
	vhdr->file_count = cpu_to_be32(sbi->file_count);

	mark_buffer_dirty(sbi->s_vhbh);
	if (test_and_clear_bit(HFSPLUS_SB_WRITEBACKUP, &sbi->flags)) {
		if (sbi->sect_count) {
			struct buffer_head *bh;
			u32 block, offset;

			block = sbi->blockoffset;
			block += (sbi->sect_count - 2) >> (sb->s_blocksize_bits - 9);
			offset = ((sbi->sect_count - 2) << 9) & (sb->s_blocksize - 1);
			printk(KERN_DEBUG "hfs: backup: %u,%u,%u,%u\n",
					  sbi->blockoffset, sbi->sect_count,
					  block, offset);
			bh = sb_bread(sb, block);
			if (bh) {
				vhdr = (struct hfsplus_vh *)(bh->b_data + offset);
				if (be16_to_cpu(vhdr->signature) == HFSPLUS_VOLHEAD_SIG) {
					memcpy(vhdr, sbi->s_vhdr, sizeof(*vhdr));
					mark_buffer_dirty(bh);
					brelse(bh);
				} else
					printk(KERN_WARNING "hfs: backup not found!\n");
			}
		}
	}
	mutex_unlock(&sbi->alloc_mutex);
	mutex_unlock(&sbi->vh_mutex);
	return 0;
}

static void hfsplus_write_super(struct super_block *sb)
{
	if (!(sb->s_flags & MS_RDONLY))
		hfsplus_sync_fs(sb, 1);
	else
		sb->s_dirt = 0;
}

static void hfsplus_put_super(struct super_block *sb)
{
	struct hfsplus_sb_info *sbi = HFSPLUS_SB(sb);

	dprint(DBG_SUPER, "hfsplus_put_super\n");

	if (!sb->s_fs_info)
		return;

	if (sb->s_dirt)
		hfsplus_write_super(sb);
	if (!(sb->s_flags & MS_RDONLY) && sbi->s_vhdr) {
		struct hfsplus_vh *vhdr = sbi->s_vhdr;

		vhdr->modify_date = hfsp_now2mt();
		vhdr->attributes |= cpu_to_be32(HFSPLUS_VOL_UNMNT);
		vhdr->attributes &= cpu_to_be32(~HFSPLUS_VOL_INCNSTNT);
		mark_buffer_dirty(sbi->s_vhbh);
		sync_dirty_buffer(sbi->s_vhbh);
	}

	hfs_btree_close(sbi->cat_tree);
	hfs_btree_close(sbi->ext_tree);
	iput(sbi->alloc_file);
	iput(sbi->hidden_dir);
	brelse(sbi->s_vhbh);
	unload_nls(sbi->nls);
	kfree(sb->s_fs_info);
	sb->s_fs_info = NULL;
}

static int hfsplus_statfs(struct dentry *dentry, struct kstatfs *buf)
{
	struct super_block *sb = dentry->d_sb;
	struct hfsplus_sb_info *sbi = HFSPLUS_SB(sb);
	u64 id = huge_encode_dev(sb->s_bdev->bd_dev);

	buf->f_type = HFSPLUS_SUPER_MAGIC;
	buf->f_bsize = sb->s_blocksize;
	buf->f_blocks = sbi->total_blocks << sbi->fs_shift;
	buf->f_bfree = sbi->free_blocks << sbi->fs_shift;
	buf->f_bavail = buf->f_bfree;
	buf->f_files = 0xFFFFFFFF;
	buf->f_ffree = 0xFFFFFFFF - sbi->next_cnid;
	buf->f_fsid.val[0] = (u32)id;
	buf->f_fsid.val[1] = (u32)(id >> 32);
	buf->f_namelen = HFSPLUS_MAX_STRLEN;

	return 0;
}

static int hfsplus_remount(struct super_block *sb, int *flags, char *data)
{
	if ((*flags & MS_RDONLY) == (sb->s_flags & MS_RDONLY))
		return 0;
	if (!(*flags & MS_RDONLY)) {
		struct hfsplus_vh *vhdr = HFSPLUS_SB(sb)->s_vhdr;
		int force = 0;

		if (!hfsplus_parse_options_remount(data, &force))
			return -EINVAL;

		if (!(vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_UNMNT))) {
			printk(KERN_WARNING "hfs: filesystem was not cleanly unmounted, "
			       "running fsck.hfsplus is recommended.  leaving read-only.\n");
			sb->s_flags |= MS_RDONLY;
			*flags |= MS_RDONLY;
		} else if (force) {
			/* nothing */
		} else if (vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_SOFTLOCK)) {
			printk(KERN_WARNING "hfs: filesystem is marked locked, leaving read-only.\n");
			sb->s_flags |= MS_RDONLY;
			*flags |= MS_RDONLY;
		} else if (vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_JOURNALED)) {
			printk(KERN_WARNING "hfs: filesystem is marked journaled, leaving read-only.\n");
			sb->s_flags |= MS_RDONLY;
			*flags |= MS_RDONLY;
		}
	}
	return 0;
}

static const struct super_operations hfsplus_sops = {
	.alloc_inode	= hfsplus_alloc_inode,
	.destroy_inode	= hfsplus_destroy_inode,
	.write_inode	= hfsplus_write_inode,
	.evict_inode	= hfsplus_evict_inode,
	.put_super	= hfsplus_put_super,
	.write_super	= hfsplus_write_super,
	.sync_fs	= hfsplus_sync_fs,
	.statfs		= hfsplus_statfs,
	.remount_fs	= hfsplus_remount,
	.show_options	= hfsplus_show_options,
};

static int hfsplus_fill_super(struct super_block *sb, void *data, int silent)
{
	struct hfsplus_vh *vhdr;
	struct hfsplus_sb_info *sbi;
	hfsplus_cat_entry entry;
	struct hfs_find_data fd;
	struct inode *root, *inode;
	struct qstr str;
	struct nls_table *nls = NULL;
	int err = -EINVAL;

	sbi = kzalloc(sizeof(*sbi), GFP_KERNEL);
	if (!sbi)
		return -ENOMEM;

	sb->s_fs_info = sbi;
	mutex_init(&sbi->alloc_mutex);
	mutex_init(&sbi->vh_mutex);
	hfsplus_fill_defaults(sbi);
	if (!hfsplus_parse_options(data, sbi)) {
		printk(KERN_ERR "hfs: unable to parse mount options\n");
		err = -EINVAL;
		goto cleanup;
	}

	/* temporarily use utf8 to correctly find the hidden dir below */
	nls = sbi->nls;
	sbi->nls = load_nls("utf8");
	if (!sbi->nls) {
		printk(KERN_ERR "hfs: unable to load nls for utf8\n");
		err = -EINVAL;
		goto cleanup;
	}

	/* Grab the volume header */
	if (hfsplus_read_wrapper(sb)) {
		if (!silent)
			printk(KERN_WARNING "hfs: unable to find HFS+ superblock\n");
		err = -EINVAL;
		goto cleanup;
	}
	vhdr = sbi->s_vhdr;

	/* Copy parts of the volume header into the superblock */
	sb->s_magic = HFSPLUS_VOLHEAD_SIG;
	if (be16_to_cpu(vhdr->version) < HFSPLUS_MIN_VERSION ||
	    be16_to_cpu(vhdr->version) > HFSPLUS_CURRENT_VERSION) {
		printk(KERN_ERR "hfs: wrong filesystem version\n");
		goto cleanup;
	}
	sbi->total_blocks = be32_to_cpu(vhdr->total_blocks);
	sbi->free_blocks = be32_to_cpu(vhdr->free_blocks);
	sbi->next_cnid = be32_to_cpu(vhdr->next_cnid);
	sbi->file_count = be32_to_cpu(vhdr->file_count);
	sbi->folder_count = be32_to_cpu(vhdr->folder_count);
	sbi->data_clump_blocks =
		be32_to_cpu(vhdr->data_clump_sz) >> sbi->alloc_blksz_shift;
	if (!sbi->data_clump_blocks)
		sbi->data_clump_blocks = 1;
	sbi->rsrc_clump_blocks =
		be32_to_cpu(vhdr->rsrc_clump_sz) >> sbi->alloc_blksz_shift;
	if (!sbi->rsrc_clump_blocks)
		sbi->rsrc_clump_blocks = 1;

	/* Set up operations so we can load metadata */
	sb->s_op = &hfsplus_sops;
	sb->s_maxbytes = MAX_LFS_FILESIZE;

	if (!(vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_UNMNT))) {
		printk(KERN_WARNING "hfs: Filesystem was not cleanly unmounted, "
		       "running fsck.hfsplus is recommended.  mounting read-only.\n");
		sb->s_flags |= MS_RDONLY;
	} else if (test_and_clear_bit(HFSPLUS_SB_FORCE, &sbi->flags)) {
		/* nothing */
	} else if (vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_SOFTLOCK)) {
		printk(KERN_WARNING "hfs: Filesystem is marked locked, mounting read-only.\n");
		sb->s_flags |= MS_RDONLY;
	} else if ((vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_JOURNALED)) && !(sb->s_flags & MS_RDONLY)) {
		printk(KERN_WARNING "hfs: write access to a journaled filesystem is not supported, "
		       "use the force option at your own risk, mounting read-only.\n");
		sb->s_flags |= MS_RDONLY;
	}

	/* Load metadata objects (B*Trees) */
	sbi->ext_tree = hfs_btree_open(sb, HFSPLUS_EXT_CNID);
	if (!sbi->ext_tree) {
		printk(KERN_ERR "hfs: failed to load extents file\n");
		goto cleanup;
	}
	sbi->cat_tree = hfs_btree_open(sb, HFSPLUS_CAT_CNID);
	if (!sbi->cat_tree) {
		printk(KERN_ERR "hfs: failed to load catalog file\n");
		goto cleanup;
	}

	inode = hfsplus_iget(sb, HFSPLUS_ALLOC_CNID);
	if (IS_ERR(inode)) {
		printk(KERN_ERR "hfs: failed to load allocation file\n");
		err = PTR_ERR(inode);
		goto cleanup;
	}
	sbi->alloc_file = inode;

	/* Load the root directory */
	root = hfsplus_iget(sb, HFSPLUS_ROOT_CNID);
	if (IS_ERR(root)) {
		printk(KERN_ERR "hfs: failed to load root directory\n");
		err = PTR_ERR(root);
		goto cleanup;
	}
	sb->s_root = d_alloc_root(root);
	if (!sb->s_root) {
		iput(root);
		err = -ENOMEM;
		goto cleanup;
	}
	sb->s_root->d_op = &hfsplus_dentry_operations;

	str.len = sizeof(HFSP_HIDDENDIR_NAME) - 1;
	str.name = HFSP_HIDDENDIR_NAME;
	hfs_find_init(sbi->cat_tree, &fd);
	hfsplus_cat_build_key(sb, fd.search_key, HFSPLUS_ROOT_CNID, &str);
	if (!hfs_brec_read(&fd, &entry, sizeof(entry))) {
		hfs_find_exit(&fd);
		if (entry.type != cpu_to_be16(HFSPLUS_FOLDER))
			goto cleanup;
		inode = hfsplus_iget(sb, be32_to_cpu(entry.folder.id));
		if (IS_ERR(inode)) {
			err = PTR_ERR(inode);
			goto cleanup;
		}
		sbi->hidden_dir = inode;
	} else
		hfs_find_exit(&fd);

	if (sb->s_flags & MS_RDONLY)
		goto out;

	/* H+LX == hfsplusutils, H+Lx == this driver, H+lx is unused
	 * all three are registered with Apple for our use
	 */
	vhdr->last_mount_vers = cpu_to_be32(HFSP_MOUNT_VERSION);
	vhdr->modify_date = hfsp_now2mt();
	be32_add_cpu(&vhdr->write_count, 1);
	vhdr->attributes &= cpu_to_be32(~HFSPLUS_VOL_UNMNT);
	vhdr->attributes |= cpu_to_be32(HFSPLUS_VOL_INCNSTNT);
	mark_buffer_dirty(sbi->s_vhbh);
	sync_dirty_buffer(sbi->s_vhbh);

	if (!sbi->hidden_dir) {
		mutex_lock(&sbi->vh_mutex);
		sbi->hidden_dir = hfsplus_new_inode(sb, S_IFDIR);
		hfsplus_create_cat(sbi->hidden_dir->i_ino, sb->s_root->d_inode,
				   &str, sbi->hidden_dir);
		mutex_unlock(&sbi->vh_mutex);

		mark_inode_dirty(sbi->hidden_dir);
	}
out:
	unload_nls(sbi->nls);
	sbi->nls = nls;
	return 0;

cleanup:
	hfsplus_put_super(sb);
	unload_nls(nls);
	return err;
}

MODULE_AUTHOR("Brad Boyer");
MODULE_DESCRIPTION("Extended Macintosh Filesystem");
MODULE_LICENSE("GPL");

static struct kmem_cache *hfsplus_inode_cachep;

static struct inode *hfsplus_alloc_inode(struct super_block *sb)
{
	struct hfsplus_inode_info *i;

	i = kmem_cache_alloc(hfsplus_inode_cachep, GFP_KERNEL);
	return i ? &i->vfs_inode : NULL;
}

static void hfsplus_destroy_inode(struct inode *inode)
{
	kmem_cache_free(hfsplus_inode_cachep, HFSPLUS_I(inode));
}

#define HFSPLUS_INODE_SIZE	sizeof(struct hfsplus_inode_info)

static struct dentry *hfsplus_mount(struct file_system_type *fs_type,
			  int flags, const char *dev_name, void *data)
{
	return mount_bdev(fs_type, flags, dev_name, data, hfsplus_fill_super);
}

static struct file_system_type hfsplus_fs_type = {
	.owner		= THIS_MODULE,
	.name		= "hfsplus",
	.mount		= hfsplus_mount,
	.kill_sb	= kill_block_super,
	.fs_flags	= FS_REQUIRES_DEV,
};

static void hfsplus_init_once(void *p)
{
	struct hfsplus_inode_info *i = p;

	inode_init_once(&i->vfs_inode);
}

static int __init init_hfsplus_fs(void)
{
	int err;

	hfsplus_inode_cachep = kmem_cache_create("hfsplus_icache",
		HFSPLUS_INODE_SIZE, 0, SLAB_HWCACHE_ALIGN,
		hfsplus_init_once);
	if (!hfsplus_inode_cachep)
		return -ENOMEM;
	err = register_filesystem(&hfsplus_fs_type);
	if (err)
		kmem_cache_destroy(hfsplus_inode_cachep);
	return err;
}

static void __exit exit_hfsplus_fs(void)
{
	unregister_filesystem(&hfsplus_fs_type);
	kmem_cache_destroy(hfsplus_inode_cachep);
}

module_init(init_hfsplus_fs)
module_exit(exit_hfsplus_fs)
Commit	Line	Data
1da177e4 LT	1	/*
	2	* linux/fs/hfsplus/super.c
	3	*
	4	* Copyright (C) 2001
	5	* Brad Boyer (flar@allandria.com)
	6	* (C) 2003 Ardis Technologies <roman@ardistech.com>
	7	*
	8	*/
	9
1da177e4 LT	10	#include <linux/module.h>
	11	#include <linux/init.h>
	12	#include <linux/pagemap.h>
	13	#include <linux/fs.h>
1da177e4	14	#include <linux/slab.h>
1da177e4 LT	15	#include <linux/vfs.h>
	16	#include <linux/nls.h>
	17
	18	static struct inode hfsplus_alloc_inode(struct super_block sb);
	19	static void hfsplus_destroy_inode(struct inode *inode);
	20
	21	#include "hfsplus_fs.h"
	22
fc4fff82 CH	23	static int hfsplus_system_read_inode(struct inode *inode)
	24	{
	25	struct hfsplus_vh *vhdr = HFSPLUS_SB(inode->i_sb)->s_vhdr;
	26
	27	switch (inode->i_ino) {
	28	case HFSPLUS_EXT_CNID:
	29	hfsplus_inode_read_fork(inode, &vhdr->ext_file);
	30	inode->i_mapping->a_ops = &hfsplus_btree_aops;
	31	break;
	32	case HFSPLUS_CAT_CNID:
	33	hfsplus_inode_read_fork(inode, &vhdr->cat_file);
	34	inode->i_mapping->a_ops = &hfsplus_btree_aops;
	35	break;
	36	case HFSPLUS_ALLOC_CNID:
	37	hfsplus_inode_read_fork(inode, &vhdr->alloc_file);
	38	inode->i_mapping->a_ops = &hfsplus_aops;
	39	break;
	40	case HFSPLUS_START_CNID:
	41	hfsplus_inode_read_fork(inode, &vhdr->start_file);
	42	break;
	43	case HFSPLUS_ATTR_CNID:
	44	hfsplus_inode_read_fork(inode, &vhdr->attr_file);
	45	inode->i_mapping->a_ops = &hfsplus_btree_aops;
	46	break;
	47	default:
	48	return -EIO;
	49	}
	50
	51	return 0;
	52	}
	53
63525391	54	struct inode hfsplus_iget(struct super_block sb, unsigned long ino)
1da177e4 LT	55	{
1da177e4 LT	56	struct hfs_find_data fd;
63525391	57	struct inode *inode;
fc4fff82	58	int err;
63525391 DH	59
	60	inode = iget_locked(sb, ino);
	61	if (!inode)
	62	return ERR_PTR(-ENOMEM);
	63	if (!(inode->i_state & I_NEW))
	64	return inode;
1da177e4	65
6af502de CH	66	INIT_LIST_HEAD(&HFSPLUS_I(inode)->open_dir_list);
	67	mutex_init(&HFSPLUS_I(inode)->extents_lock);
	68	HFSPLUS_I(inode)->flags = 0;
	69	HFSPLUS_I(inode)->rsrc_inode = NULL;
	70	atomic_set(&HFSPLUS_I(inode)->opencnt, 0);
1da177e4	71
fc4fff82 CH	72	if (inode->i_ino >= HFSPLUS_FIRSTUSER_CNID \|\|
fc4fff82 CH	73	inode->i_ino == HFSPLUS_ROOT_CNID) {
dd73a01a	74	hfs_find_init(HFSPLUS_SB(inode->i_sb)->cat_tree, &fd);
1da177e4 LT	75	err = hfsplus_find_cat(inode->i_sb, inode->i_ino, &fd);
	76	if (!err)
	77	err = hfsplus_cat_read_inode(inode, &fd);
	78	hfs_find_exit(&fd);
fc4fff82 CH	79	} else {
fc4fff82 CH	80	err = hfsplus_system_read_inode(inode);
1da177e4	81	}
fc4fff82 CH	82
	83	if (err) {
	84	iget_failed(inode);
	85	return ERR_PTR(err);
1da177e4 LT	86	}
1da177e4 LT	87
63525391 DH	88	unlock_new_inode(inode);
63525391 DH	89	return inode;
1da177e4 LT	90	}
1da177e4 LT	91
b5080f77	92	static int hfsplus_system_write_inode(struct inode *inode)
1da177e4	93	{
dd73a01a	94	struct hfsplus_sb_info *sbi = HFSPLUS_SB(inode->i_sb);
b5080f77 CH	95	struct hfsplus_vh *vhdr = sbi->s_vhdr;
	96	struct hfsplus_fork_raw *fork;
	97	struct hfs_btree *tree = NULL;
1da177e4	98
1da177e4	99	switch (inode->i_ino) {
1da177e4	100	case HFSPLUS_EXT_CNID:
b5080f77 CH	101	fork = &vhdr->ext_file;
b5080f77 CH	102	tree = sbi->ext_tree;
1da177e4 LT	103	break;
1da177e4 LT	104	case HFSPLUS_CAT_CNID:
b5080f77 CH	105	fork = &vhdr->cat_file;
b5080f77 CH	106	tree = sbi->cat_tree;
1da177e4 LT	107	break;
1da177e4 LT	108	case HFSPLUS_ALLOC_CNID:
b5080f77	109	fork = &vhdr->alloc_file;
1da177e4 LT	110	break;
1da177e4 LT	111	case HFSPLUS_START_CNID:
b5080f77	112	fork = &vhdr->start_file;
1da177e4 LT	113	break;
1da177e4 LT	114	case HFSPLUS_ATTR_CNID:
b5080f77 CH	115	fork = &vhdr->attr_file;
	116	tree = sbi->attr_tree;
	117	default:
	118	return -EIO;
	119	}
	120
	121	if (fork->total_size != cpu_to_be64(inode->i_size)) {
84adede3	122	set_bit(HFSPLUS_SB_WRITEBACKUP, &sbi->flags);
b5080f77	123	inode->i_sb->s_dirt = 1;
1da177e4	124	}
b5080f77 CH	125	hfsplus_inode_write_fork(inode, fork);
	126	if (tree)
	127	hfs_btree_write(tree);
	128	return 0;
	129	}
	130
	131	static int hfsplus_write_inode(struct inode *inode,
	132	struct writeback_control *wbc)
	133	{
	134	dprint(DBG_INODE, "hfsplus_write_inode: %lu\n", inode->i_ino);
	135
	136	hfsplus_ext_write_extent(inode);
	137
	138	if (inode->i_ino >= HFSPLUS_FIRSTUSER_CNID \|\|
	139	inode->i_ino == HFSPLUS_ROOT_CNID)
	140	return hfsplus_cat_write_inode(inode);
	141	else
	142	return hfsplus_system_write_inode(inode);
1da177e4 LT	143	}
1da177e4 LT	144
b57922d9	145	static void hfsplus_evict_inode(struct inode *inode)
1da177e4	146	{
b57922d9 AV	147	dprint(DBG_INODE, "hfsplus_evict_inode: %lu\n", inode->i_ino);
	148	truncate_inode_pages(&inode->i_data, 0);
	149	end_writeback(inode);
1da177e4	150	if (HFSPLUS_IS_RSRC(inode)) {
6af502de CH	151	HFSPLUS_I(HFSPLUS_I(inode)->rsrc_inode)->rsrc_inode = NULL;
6af502de CH	152	iput(HFSPLUS_I(inode)->rsrc_inode);
1da177e4	153	}
1da177e4 LT	154	}
1da177e4 LT	155
b5fc510c	156	int hfsplus_sync_fs(struct super_block *sb, int wait)
1da177e4	157	{
dd73a01a CH	158	struct hfsplus_sb_info *sbi = HFSPLUS_SB(sb);
dd73a01a CH	159	struct hfsplus_vh *vhdr = sbi->s_vhdr;
1da177e4 LT	160
1da177e4 LT	161	dprint(DBG_SUPER, "hfsplus_write_super\n");
ebc1ac16	162
7ac9fb9c	163	mutex_lock(&sbi->vh_mutex);
dd73a01a	164	mutex_lock(&sbi->alloc_mutex);
1da177e4	165	sb->s_dirt = 0;
1da177e4	166
dd73a01a	167	vhdr->free_blocks = cpu_to_be32(sbi->free_blocks);
dd73a01a CH	168	vhdr->next_cnid = cpu_to_be32(sbi->next_cnid);
	169	vhdr->folder_count = cpu_to_be32(sbi->folder_count);
	170	vhdr->file_count = cpu_to_be32(sbi->file_count);
1da177e4	171
dd73a01a	172	mark_buffer_dirty(sbi->s_vhbh);
84adede3	173	if (test_and_clear_bit(HFSPLUS_SB_WRITEBACKUP, &sbi->flags)) {
dd73a01a	174	if (sbi->sect_count) {
1da177e4 LT	175	struct buffer_head *bh;
	176	u32 block, offset;
	177
dd73a01a CH	178	block = sbi->blockoffset;
	179	block += (sbi->sect_count - 2) >> (sb->s_blocksize_bits - 9);
	180	offset = ((sbi->sect_count - 2) << 9) & (sb->s_blocksize - 1);
	181	printk(KERN_DEBUG "hfs: backup: %u,%u,%u,%u\n",
	182	sbi->blockoffset, sbi->sect_count,
	183	block, offset);
1da177e4 LT	184	bh = sb_bread(sb, block);
	185	if (bh) {
	186	vhdr = (struct hfsplus_vh *)(bh->b_data + offset);
	187	if (be16_to_cpu(vhdr->signature) == HFSPLUS_VOLHEAD_SIG) {
dd73a01a	188	memcpy(vhdr, sbi->s_vhdr, sizeof(*vhdr));
1da177e4 LT	189	mark_buffer_dirty(bh);
	190	brelse(bh);
	191	} else
634725a9	192	printk(KERN_WARNING "hfs: backup not found!\n");
1da177e4 LT	193	}
1da177e4 LT	194	}
1da177e4	195	}
dd73a01a	196	mutex_unlock(&sbi->alloc_mutex);
7ac9fb9c	197	mutex_unlock(&sbi->vh_mutex);
7fbc6df0 CH	198	return 0;
	199	}
	200
	201	static void hfsplus_write_super(struct super_block *sb)
	202	{
	203	if (!(sb->s_flags & MS_RDONLY))
	204	hfsplus_sync_fs(sb, 1);
	205	else
	206	sb->s_dirt = 0;
1da177e4 LT	207	}
	208
	209	static void hfsplus_put_super(struct super_block *sb)
	210	{
dd73a01a CH	211	struct hfsplus_sb_info *sbi = HFSPLUS_SB(sb);
dd73a01a CH	212
1da177e4	213	dprint(DBG_SUPER, "hfsplus_put_super\n");
dd73a01a	214
945b0920 CL	215	if (!sb->s_fs_info)
945b0920 CL	216	return;
6cfd0148	217
8c85e125 CH	218	if (sb->s_dirt)
8c85e125 CH	219	hfsplus_write_super(sb);
dd73a01a CH	220	if (!(sb->s_flags & MS_RDONLY) && sbi->s_vhdr) {
dd73a01a CH	221	struct hfsplus_vh *vhdr = sbi->s_vhdr;
1da177e4 LT	222
	223	vhdr->modify_date = hfsp_now2mt();
	224	vhdr->attributes \|= cpu_to_be32(HFSPLUS_VOL_UNMNT);
	225	vhdr->attributes &= cpu_to_be32(~HFSPLUS_VOL_INCNSTNT);
dd73a01a CH	226	mark_buffer_dirty(sbi->s_vhbh);
dd73a01a CH	227	sync_dirty_buffer(sbi->s_vhbh);
1da177e4 LT	228	}
1da177e4 LT	229
dd73a01a CH	230	hfs_btree_close(sbi->cat_tree);
	231	hfs_btree_close(sbi->ext_tree);
	232	iput(sbi->alloc_file);
	233	iput(sbi->hidden_dir);
	234	brelse(sbi->s_vhbh);
	235	unload_nls(sbi->nls);
945b0920 CL	236	kfree(sb->s_fs_info);
945b0920 CL	237	sb->s_fs_info = NULL;
1da177e4 LT	238	}
1da177e4 LT	239
726c3342	240	static int hfsplus_statfs(struct dentry dentry, struct kstatfs buf)
1da177e4	241	{
726c3342	242	struct super_block *sb = dentry->d_sb;
dd73a01a	243	struct hfsplus_sb_info *sbi = HFSPLUS_SB(sb);
25564dd8	244	u64 id = huge_encode_dev(sb->s_bdev->bd_dev);
726c3342	245
1da177e4 LT	246	buf->f_type = HFSPLUS_SUPER_MAGIC;
1da177e4 LT	247	buf->f_bsize = sb->s_blocksize;
dd73a01a CH	248	buf->f_blocks = sbi->total_blocks << sbi->fs_shift;
dd73a01a CH	249	buf->f_bfree = sbi->free_blocks << sbi->fs_shift;
1da177e4 LT	250	buf->f_bavail = buf->f_bfree;
1da177e4 LT	251	buf->f_files = 0xFFFFFFFF;
dd73a01a	252	buf->f_ffree = 0xFFFFFFFF - sbi->next_cnid;
25564dd8 CL	253	buf->f_fsid.val[0] = (u32)id;
25564dd8 CL	254	buf->f_fsid.val[1] = (u32)(id >> 32);
1da177e4 LT	255	buf->f_namelen = HFSPLUS_MAX_STRLEN;
	256
	257	return 0;
	258	}
	259
	260	static int hfsplus_remount(struct super_block sb, int flags, char *data)
	261	{
	262	if ((*flags & MS_RDONLY) == (sb->s_flags & MS_RDONLY))
	263	return 0;
	264	if (!(*flags & MS_RDONLY)) {
dd73a01a	265	struct hfsplus_vh *vhdr = HFSPLUS_SB(sb)->s_vhdr;
6f80dfe5	266	int force = 0;
b0b623c3	267
6f80dfe5	268	if (!hfsplus_parse_options_remount(data, &force))
b0b623c3	269	return -EINVAL;
1da177e4 LT	270
1da177e4 LT	271	if (!(vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_UNMNT))) {
634725a9	272	printk(KERN_WARNING "hfs: filesystem was not cleanly unmounted, "
1da177e4 LT	273	"running fsck.hfsplus is recommended. leaving read-only.\n");
	274	sb->s_flags \|= MS_RDONLY;
	275	*flags \|= MS_RDONLY;
6f80dfe5	276	} else if (force) {
b0b623c3	277	/* nothing */
1da177e4	278	} else if (vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_SOFTLOCK)) {
634725a9	279	printk(KERN_WARNING "hfs: filesystem is marked locked, leaving read-only.\n");
1da177e4 LT	280	sb->s_flags \|= MS_RDONLY;
1da177e4 LT	281	*flags \|= MS_RDONLY;
b0b623c3	282	} else if (vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_JOURNALED)) {
634725a9	283	printk(KERN_WARNING "hfs: filesystem is marked journaled, leaving read-only.\n");
b0b623c3 RZ	284	sb->s_flags \|= MS_RDONLY;
b0b623c3 RZ	285	*flags \|= MS_RDONLY;
1da177e4 LT	286	}
	287	}
	288	return 0;
	289	}
	290
ee9b6d61	291	static const struct super_operations hfsplus_sops = {
1da177e4 LT	292	.alloc_inode = hfsplus_alloc_inode,
1da177e4 LT	293	.destroy_inode = hfsplus_destroy_inode,
1da177e4	294	.write_inode = hfsplus_write_inode,
b57922d9	295	.evict_inode = hfsplus_evict_inode,
1da177e4 LT	296	.put_super = hfsplus_put_super,
1da177e4 LT	297	.write_super = hfsplus_write_super,
7fbc6df0	298	.sync_fs = hfsplus_sync_fs,
1da177e4 LT	299	.statfs = hfsplus_statfs,
1da177e4 LT	300	.remount_fs = hfsplus_remount,
717dd80e	301	.show_options = hfsplus_show_options,
1da177e4 LT	302	};
	303
	304	static int hfsplus_fill_super(struct super_block sb, void data, int silent)
	305	{
	306	struct hfsplus_vh *vhdr;
	307	struct hfsplus_sb_info *sbi;
	308	hfsplus_cat_entry entry;
	309	struct hfs_find_data fd;
63525391	310	struct inode root, inode;
1da177e4 LT	311	struct qstr str;
	312	struct nls_table *nls = NULL;
	313	int err = -EINVAL;
	314
a5001a27	315	sbi = kzalloc(sizeof(*sbi), GFP_KERNEL);
1da177e4 LT	316	if (!sbi)
	317	return -ENOMEM;
	318
1da177e4	319	sb->s_fs_info = sbi;
40bf48af	320	mutex_init(&sbi->alloc_mutex);
7ac9fb9c	321	mutex_init(&sbi->vh_mutex);
717dd80e RZ	322	hfsplus_fill_defaults(sbi);
717dd80e RZ	323	if (!hfsplus_parse_options(data, sbi)) {
634725a9	324	printk(KERN_ERR "hfs: unable to parse mount options\n");
1da177e4 LT	325	err = -EINVAL;
	326	goto cleanup;
	327	}
	328
	329	/* temporarily use utf8 to correctly find the hidden dir below */
	330	nls = sbi->nls;
	331	sbi->nls = load_nls("utf8");
bd6a59b2	332	if (!sbi->nls) {
634725a9	333	printk(KERN_ERR "hfs: unable to load nls for utf8\n");
1da177e4 LT	334	err = -EINVAL;
	335	goto cleanup;
	336	}
	337
	338	/* Grab the volume header */
	339	if (hfsplus_read_wrapper(sb)) {
	340	if (!silent)
634725a9	341	printk(KERN_WARNING "hfs: unable to find HFS+ superblock\n");
1da177e4 LT	342	err = -EINVAL;
	343	goto cleanup;
	344	}
dd73a01a	345	vhdr = sbi->s_vhdr;
1da177e4 LT	346
1da177e4 LT	347	/* Copy parts of the volume header into the superblock */
2179d372 DE	348	sb->s_magic = HFSPLUS_VOLHEAD_SIG;
	349	if (be16_to_cpu(vhdr->version) < HFSPLUS_MIN_VERSION \|\|
	350	be16_to_cpu(vhdr->version) > HFSPLUS_CURRENT_VERSION) {
634725a9	351	printk(KERN_ERR "hfs: wrong filesystem version\n");
1da177e4 LT	352	goto cleanup;
1da177e4 LT	353	}
dd73a01a CH	354	sbi->total_blocks = be32_to_cpu(vhdr->total_blocks);
dd73a01a CH	355	sbi->free_blocks = be32_to_cpu(vhdr->free_blocks);
dd73a01a CH	356	sbi->next_cnid = be32_to_cpu(vhdr->next_cnid);
	357	sbi->file_count = be32_to_cpu(vhdr->file_count);
	358	sbi->folder_count = be32_to_cpu(vhdr->folder_count);
	359	sbi->data_clump_blocks =
	360	be32_to_cpu(vhdr->data_clump_sz) >> sbi->alloc_blksz_shift;
	361	if (!sbi->data_clump_blocks)
	362	sbi->data_clump_blocks = 1;
	363	sbi->rsrc_clump_blocks =
	364	be32_to_cpu(vhdr->rsrc_clump_sz) >> sbi->alloc_blksz_shift;
	365	if (!sbi->rsrc_clump_blocks)
	366	sbi->rsrc_clump_blocks = 1;
1da177e4 LT	367
	368	/* Set up operations so we can load metadata */
	369	sb->s_op = &hfsplus_sops;
	370	sb->s_maxbytes = MAX_LFS_FILESIZE;
	371
	372	if (!(vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_UNMNT))) {
634725a9 RZ	373	printk(KERN_WARNING "hfs: Filesystem was not cleanly unmounted, "
634725a9 RZ	374	"running fsck.hfsplus is recommended. mounting read-only.\n");
1da177e4	375	sb->s_flags \|= MS_RDONLY;
84adede3	376	} else if (test_and_clear_bit(HFSPLUS_SB_FORCE, &sbi->flags)) {
b0b623c3	377	/* nothing */
1da177e4	378	} else if (vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_SOFTLOCK)) {
634725a9	379	printk(KERN_WARNING "hfs: Filesystem is marked locked, mounting read-only.\n");
1da177e4	380	sb->s_flags \|= MS_RDONLY;
81a73719	381	} else if ((vhdr->attributes & cpu_to_be32(HFSPLUS_VOL_JOURNALED)) && !(sb->s_flags & MS_RDONLY)) {
355a4696	382	printk(KERN_WARNING "hfs: write access to a journaled filesystem is not supported, "
634725a9	383	"use the force option at your own risk, mounting read-only.\n");
b0b623c3	384	sb->s_flags \|= MS_RDONLY;
1da177e4 LT	385	}
	386
	387	/* Load metadata objects (BTrees) /
dd73a01a CH	388	sbi->ext_tree = hfs_btree_open(sb, HFSPLUS_EXT_CNID);
dd73a01a CH	389	if (!sbi->ext_tree) {
634725a9	390	printk(KERN_ERR "hfs: failed to load extents file\n");
1da177e4 LT	391	goto cleanup;
1da177e4 LT	392	}
dd73a01a CH	393	sbi->cat_tree = hfs_btree_open(sb, HFSPLUS_CAT_CNID);
dd73a01a CH	394	if (!sbi->cat_tree) {
634725a9	395	printk(KERN_ERR "hfs: failed to load catalog file\n");
1da177e4 LT	396	goto cleanup;
	397	}
	398
63525391 DH	399	inode = hfsplus_iget(sb, HFSPLUS_ALLOC_CNID);
63525391 DH	400	if (IS_ERR(inode)) {
634725a9	401	printk(KERN_ERR "hfs: failed to load allocation file\n");
63525391	402	err = PTR_ERR(inode);
1da177e4 LT	403	goto cleanup;
1da177e4 LT	404	}
dd73a01a	405	sbi->alloc_file = inode;
1da177e4 LT	406
1da177e4 LT	407	/* Load the root directory */
63525391 DH	408	root = hfsplus_iget(sb, HFSPLUS_ROOT_CNID);
	409	if (IS_ERR(root)) {
	410	printk(KERN_ERR "hfs: failed to load root directory\n");
	411	err = PTR_ERR(root);
	412	goto cleanup;
	413	}
1da177e4 LT	414	sb->s_root = d_alloc_root(root);
1da177e4 LT	415	if (!sb->s_root) {
1da177e4	416	iput(root);
63525391	417	err = -ENOMEM;
1da177e4 LT	418	goto cleanup;
1da177e4 LT	419	}
d45bce8f	420	sb->s_root->d_op = &hfsplus_dentry_operations;
1da177e4 LT	421
	422	str.len = sizeof(HFSP_HIDDENDIR_NAME) - 1;
	423	str.name = HFSP_HIDDENDIR_NAME;
dd73a01a	424	hfs_find_init(sbi->cat_tree, &fd);
1da177e4 LT	425	hfsplus_cat_build_key(sb, fd.search_key, HFSPLUS_ROOT_CNID, &str);
	426	if (!hfs_brec_read(&fd, &entry, sizeof(entry))) {
	427	hfs_find_exit(&fd);
	428	if (entry.type != cpu_to_be16(HFSPLUS_FOLDER))
	429	goto cleanup;
63525391 DH	430	inode = hfsplus_iget(sb, be32_to_cpu(entry.folder.id));
	431	if (IS_ERR(inode)) {
	432	err = PTR_ERR(inode);
1da177e4	433	goto cleanup;
63525391	434	}
dd73a01a	435	sbi->hidden_dir = inode;
1da177e4 LT	436	} else
	437	hfs_find_exit(&fd);
	438
	439	if (sb->s_flags & MS_RDONLY)
	440	goto out;
	441
	442	/* H+LX == hfsplusutils, H+Lx == this driver, H+lx is unused
	443	* all three are registered with Apple for our use
	444	*/
	445	vhdr->last_mount_vers = cpu_to_be32(HFSP_MOUNT_VERSION);
	446	vhdr->modify_date = hfsp_now2mt();
20c79e78	447	be32_add_cpu(&vhdr->write_count, 1);
1da177e4 LT	448	vhdr->attributes &= cpu_to_be32(~HFSPLUS_VOL_UNMNT);
1da177e4 LT	449	vhdr->attributes \|= cpu_to_be32(HFSPLUS_VOL_INCNSTNT);
dd73a01a CH	450	mark_buffer_dirty(sbi->s_vhbh);
dd73a01a CH	451	sync_dirty_buffer(sbi->s_vhbh);
1da177e4	452
dd73a01a	453	if (!sbi->hidden_dir) {
7ac9fb9c	454	mutex_lock(&sbi->vh_mutex);
dd73a01a CH	455	sbi->hidden_dir = hfsplus_new_inode(sb, S_IFDIR);
	456	hfsplus_create_cat(sbi->hidden_dir->i_ino, sb->s_root->d_inode,
	457	&str, sbi->hidden_dir);
7ac9fb9c CH	458	mutex_unlock(&sbi->vh_mutex);
7ac9fb9c CH	459
dd73a01a	460	mark_inode_dirty(sbi->hidden_dir);
1da177e4 LT	461	}
	462	out:
	463	unload_nls(sbi->nls);
	464	sbi->nls = nls;
	465	return 0;
	466
	467	cleanup:
	468	hfsplus_put_super(sb);
6d729e44	469	unload_nls(nls);
1da177e4 LT	470	return err;
	471	}
	472
	473	MODULE_AUTHOR("Brad Boyer");
	474	MODULE_DESCRIPTION("Extended Macintosh Filesystem");
	475	MODULE_LICENSE("GPL");
	476
e18b890b	477	static struct kmem_cache *hfsplus_inode_cachep;
1da177e4 LT	478
	479	static struct inode hfsplus_alloc_inode(struct super_block sb)
	480	{
	481	struct hfsplus_inode_info *i;
	482
e94b1766	483	i = kmem_cache_alloc(hfsplus_inode_cachep, GFP_KERNEL);
1da177e4 LT	484	return i ? &i->vfs_inode : NULL;
	485	}
	486
	487	static void hfsplus_destroy_inode(struct inode *inode)
	488	{
6af502de	489	kmem_cache_free(hfsplus_inode_cachep, HFSPLUS_I(inode));
1da177e4 LT	490	}
	491
	492	#define HFSPLUS_INODE_SIZE sizeof(struct hfsplus_inode_info)
	493
152a0836 AV	494	static struct dentry hfsplus_mount(struct file_system_type fs_type,
152a0836 AV	495	int flags, const char dev_name, void data)
1da177e4	496	{
152a0836	497	return mount_bdev(fs_type, flags, dev_name, data, hfsplus_fill_super);
1da177e4 LT	498	}
	499
	500	static struct file_system_type hfsplus_fs_type = {
	501	.owner = THIS_MODULE,
	502	.name = "hfsplus",
152a0836	503	.mount = hfsplus_mount,
1da177e4 LT	504	.kill_sb = kill_block_super,
	505	.fs_flags = FS_REQUIRES_DEV,
	506	};
	507
51cc5068	508	static void hfsplus_init_once(void *p)
1da177e4 LT	509	{
	510	struct hfsplus_inode_info *i = p;
	511
a35afb83	512	inode_init_once(&i->vfs_inode);
1da177e4 LT	513	}
	514
	515	static int __init init_hfsplus_fs(void)
	516	{
	517	int err;
	518
	519	hfsplus_inode_cachep = kmem_cache_create("hfsplus_icache",
	520	HFSPLUS_INODE_SIZE, 0, SLAB_HWCACHE_ALIGN,
20c2df83	521	hfsplus_init_once);
1da177e4 LT	522	if (!hfsplus_inode_cachep)
	523	return -ENOMEM;
	524	err = register_filesystem(&hfsplus_fs_type);
	525	if (err)
	526	kmem_cache_destroy(hfsplus_inode_cachep);
	527	return err;
	528	}
	529
	530	static void __exit exit_hfsplus_fs(void)
	531	{
	532	unregister_filesystem(&hfsplus_fs_type);
1a1d92c1	533	kmem_cache_destroy(hfsplus_inode_cachep);
1da177e4 LT	534	}
	535
	536	module_init(init_hfsplus_fs)
	537	module_exit(exit_hfsplus_fs)