[linux-2.6-block.git] / include / linux / ext3_fs_i.h

/*
 *  linux/include/linux/ext3_fs_i.h
 *
 * Copyright (C) 1992, 1993, 1994, 1995
 * Remy Card (card@masi.ibp.fr)
 * Laboratoire MASI - Institut Blaise Pascal
 * Universite Pierre et Marie Curie (Paris VI)
 *
 *  from
 *
 *  linux/include/linux/minix_fs_i.h
 *
 *  Copyright (C) 1991, 1992  Linus Torvalds
 */

#ifndef _LINUX_EXT3_FS_I
#define _LINUX_EXT3_FS_I

#include <linux/rwsem.h>
#include <linux/rbtree.h>
#include <linux/seqlock.h>
#include <linux/mutex.h>
#include <linux/extent_map.h>

/* data type for block offset of block group */
typedef int ext3_grpblk_t;

/* data type for filesystem-wide blocks number */
typedef unsigned long ext3_fsblk_t;

#define E3FSBLK "%lu"

struct ext3_reserve_window {
	ext3_fsblk_t	_rsv_start;	/* First byte reserved */
	ext3_fsblk_t	_rsv_end;	/* Last byte reserved or 0 */
};

struct ext3_reserve_window_node {
	struct rb_node		rsv_node;
	__u32			rsv_goal_size;
	__u32			rsv_alloc_hit;
	struct ext3_reserve_window	rsv_window;
};

struct ext3_block_alloc_info {
	/* information about reservation window */
	struct ext3_reserve_window_node	rsv_window_node;
	/*
	 * was i_next_alloc_block in ext3_inode_info
	 * is the logical (file-relative) number of the
	 * most-recently-allocated block in this file.
	 * We use this for detecting linearly ascending allocation requests.
	 */
	__u32                   last_alloc_logical_block;
	/*
	 * Was i_next_alloc_goal in ext3_inode_info
	 * is the *physical* companion to i_next_alloc_block.
	 * it the physical block number of the block which was most-recentl
	 * allocated to this file.  This give us the goal (target) for the next
	 * allocation when we detect linearly ascending requests.
	 */
	ext3_fsblk_t		last_alloc_physical_block;
};

#define rsv_start rsv_window._rsv_start
#define rsv_end rsv_window._rsv_end

/*
 * third extended file system inode data in memory
 */
struct ext3_inode_info {
	__le32	i_data[15];	/* unconverted */
	__u32	i_flags;
#ifdef EXT3_FRAGMENTS
	__u32	i_faddr;
	__u8	i_frag_no;
	__u8	i_frag_size;
#endif
	ext3_fsblk_t	i_file_acl;
	__u32	i_dir_acl;
	__u32	i_dtime;

	/*
	 * i_block_group is the number of the block group which contains
	 * this file's inode.  Constant across the lifetime of the inode,
	 * it is ued for making block allocation decisions - we try to
	 * place a file's data blocks near its inode block, and new inodes
	 * near to their parent directory's inode.
	 */
	__u32	i_block_group;
	__u32	i_state;		/* Dynamic state flags for ext3 */

	/* block reservation info */
	struct ext3_block_alloc_info *i_block_alloc_info;

	__u32	i_dir_start_lookup;
#ifdef CONFIG_EXT3_FS_XATTR
	/*
	 * Extended attributes can be read independently of the main file
	 * data. Taking i_mutex even when reading would cause contention
	 * between readers of EAs and writers of regular file data, so
	 * instead we synchronize on xattr_sem when reading or changing
	 * EAs.
	 */
	struct rw_semaphore xattr_sem;
#endif
#ifdef CONFIG_EXT3_FS_POSIX_ACL
	struct posix_acl	*i_acl;
	struct posix_acl	*i_default_acl;
#endif

	struct list_head i_orphan;	/* unlinked but open inodes */

	/*
	 * i_disksize keeps track of what the inode size is ON DISK, not
	 * in memory.  During truncate, i_size is set to the new size by
	 * the VFS prior to calling ext3_truncate(), but the filesystem won't
	 * set i_disksize to 0 until the truncate is actually under way.
	 *
	 * The intent is that i_disksize always represents the blocks which
	 * are used by this file.  This allows recovery to restart truncate
	 * on orphans if we crash during truncate.  We actually write i_disksize
	 * into the on-disk inode when writing inodes out, instead of i_size.
	 *
	 * The only time when i_disksize and i_size may be different is when
	 * a truncate is in progress.  The only things which change i_disksize
	 * are ext3_get_block (growth) and ext3_truncate (shrinkth).
	 */
	loff_t	i_disksize;

	/* on-disk additional length */
	__u16 i_extra_isize;

	/*
	 * truncate_mutex is for serialising ext3_truncate() against
	 * ext3_getblock().  In the 2.4 ext2 design, great chunks of inode's
	 * data tree are chopped off during truncate. We can't do that in
	 * ext3 because whenever we perform intermediate commits during
	 * truncate, the inode and all the metadata blocks *must* be in a
	 * consistent state which allows truncation of the orphans to restart
	 * during recovery.  Hence we must fix the get_block-vs-truncate race
	 * by other means, so we have truncate_mutex.
	 */
	struct mutex truncate_mutex;
	struct inode vfs_inode;

	struct extent_map_tree extent_tree;
};

#endif	/* _LINUX_EXT3_FS_I */
Commit	Line	Data
1da177e4 LT	1	/*
	2	* linux/include/linux/ext3_fs_i.h
	3	*
	4	* Copyright (C) 1992, 1993, 1994, 1995
	5	* Remy Card (card@masi.ibp.fr)
	6	* Laboratoire MASI - Institut Blaise Pascal
	7	* Universite Pierre et Marie Curie (Paris VI)
	8	*
	9	* from
	10	*
	11	* linux/include/linux/minix_fs_i.h
	12	*
	13	* Copyright (C) 1991, 1992 Linus Torvalds
	14	*/
	15
	16	#ifndef _LINUX_EXT3_FS_I
	17	#define _LINUX_EXT3_FS_I
	18
	19	#include <linux/rwsem.h>
	20	#include <linux/rbtree.h>
	21	#include <linux/seqlock.h>
97461518	22	#include <linux/mutex.h>
31bd2bc7	23	#include <linux/extent_map.h>
1da177e4	24
1c2bf374 MC	25	/* data type for block offset of block group */
	26	typedef int ext3_grpblk_t;
	27
	28	/* data type for filesystem-wide blocks number */
	29	typedef unsigned long ext3_fsblk_t;
	30
	31	#define E3FSBLK "%lu"
	32
1da177e4	33	struct ext3_reserve_window {
43d23f90 MC	34	ext3_fsblk_t _rsv_start; /* First byte reserved */
43d23f90 MC	35	ext3_fsblk_t _rsv_end; /* Last byte reserved or 0 */
1da177e4 LT	36	};
	37
	38	struct ext3_reserve_window_node {
e9ad5620	39	struct rb_node rsv_node;
1da177e4 LT	40	__u32 rsv_goal_size;
	41	__u32 rsv_alloc_hit;
	42	struct ext3_reserve_window rsv_window;
	43	};
	44
	45	struct ext3_block_alloc_info {
	46	/* information about reservation window */
	47	struct ext3_reserve_window_node rsv_window_node;
	48	/*
	49	* was i_next_alloc_block in ext3_inode_info
	50	* is the logical (file-relative) number of the
	51	* most-recently-allocated block in this file.
	52	* We use this for detecting linearly ascending allocation requests.
	53	*/
	54	__u32 last_alloc_logical_block;
	55	/*
	56	* Was i_next_alloc_goal in ext3_inode_info
	57	* is the physical companion to i_next_alloc_block.
59c51591	58	* it the physical block number of the block which was most-recentl
1da177e4 LT	59	* allocated to this file. This give us the goal (target) for the next
	60	* allocation when we detect linearly ascending requests.
	61	*/
43d23f90	62	ext3_fsblk_t last_alloc_physical_block;
1da177e4 LT	63	};
	64
	65	#define rsv_start rsv_window._rsv_start
	66	#define rsv_end rsv_window._rsv_end
	67
	68	/*
	69	* third extended file system inode data in memory
	70	*/
	71	struct ext3_inode_info {
	72	__le32 i_data[15]; /* unconverted */
	73	__u32 i_flags;
	74	#ifdef EXT3_FRAGMENTS
	75	__u32 i_faddr;
	76	__u8 i_frag_no;
	77	__u8 i_frag_size;
	78	#endif
43d23f90	79	ext3_fsblk_t i_file_acl;
1da177e4 LT	80	__u32 i_dir_acl;
	81	__u32 i_dtime;
	82
	83	/*
	84	* i_block_group is the number of the block group which contains
	85	* this file's inode. Constant across the lifetime of the inode,
	86	* it is ued for making block allocation decisions - we try to
	87	* place a file's data blocks near its inode block, and new inodes
	88	* near to their parent directory's inode.
	89	*/
	90	__u32 i_block_group;
	91	__u32 i_state; /* Dynamic state flags for ext3 */
	92
	93	/* block reservation info */
	94	struct ext3_block_alloc_info *i_block_alloc_info;
	95
	96	__u32 i_dir_start_lookup;
	97	#ifdef CONFIG_EXT3_FS_XATTR
	98	/*
	99	* Extended attributes can be read independently of the main file
1b1dcc1b	100	* data. Taking i_mutex even when reading would cause contention
1da177e4 LT	101	* between readers of EAs and writers of regular file data, so
	102	* instead we synchronize on xattr_sem when reading or changing
	103	* EAs.
	104	*/
	105	struct rw_semaphore xattr_sem;
	106	#endif
	107	#ifdef CONFIG_EXT3_FS_POSIX_ACL
	108	struct posix_acl *i_acl;
	109	struct posix_acl *i_default_acl;
	110	#endif
	111
	112	struct list_head i_orphan; /* unlinked but open inodes */
	113
	114	/*
	115	* i_disksize keeps track of what the inode size is ON DISK, not
	116	* in memory. During truncate, i_size is set to the new size by
	117	* the VFS prior to calling ext3_truncate(), but the filesystem won't
	118	* set i_disksize to 0 until the truncate is actually under way.
	119	*
	120	* The intent is that i_disksize always represents the blocks which
	121	* are used by this file. This allows recovery to restart truncate
	122	* on orphans if we crash during truncate. We actually write i_disksize
	123	* into the on-disk inode when writing inodes out, instead of i_size.
	124	*
	125	* The only time when i_disksize and i_size may be different is when
	126	* a truncate is in progress. The only things which change i_disksize
	127	* are ext3_get_block (growth) and ext3_truncate (shrinkth).
	128	*/
	129	loff_t i_disksize;
	130
	131	/* on-disk additional length */
	132	__u16 i_extra_isize;
	133
	134	/*
97461518	135	* truncate_mutex is for serialising ext3_truncate() against
1da177e4 LT	136	* ext3_getblock(). In the 2.4 ext2 design, great chunks of inode's
	137	* data tree are chopped off during truncate. We can't do that in
	138	* ext3 because whenever we perform intermediate commits during
	139	* truncate, the inode and all the metadata blocks must be in a
	140	* consistent state which allows truncation of the orphans to restart
	141	* during recovery. Hence we must fix the get_block-vs-truncate race
97461518	142	* by other means, so we have truncate_mutex.
1da177e4	143	*/
97461518	144	struct mutex truncate_mutex;
1da177e4	145	struct inode vfs_inode;
31bd2bc7 JA	146
31bd2bc7 JA	147	struct extent_map_tree extent_tree;
1da177e4 LT	148	};
	149
	150	#endif /* _LINUX_EXT3_FS_I */