xref: /dragonfly/sys/vfs/ufs/inode.h (revision af79c6e5)
1 /*
2  * Copyright (c) 1982, 1989, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  * (c) UNIX System Laboratories, Inc.
5  * All or some portions of this file are derived from material licensed
6  * to the University of California by American Telephone and Telegraph
7  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
8  * the permission of UNIX System Laboratories, Inc.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  * 3. All advertising materials mentioning features or use of this software
19  *    must display the following acknowledgement:
20  *	This product includes software developed by the University of
21  *	California, Berkeley and its contributors.
22  * 4. Neither the name of the University nor the names of its contributors
23  *    may be used to endorse or promote products derived from this software
24  *    without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
27  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
30  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
35  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36  * SUCH DAMAGE.
37  *
38  *	@(#)inode.h	8.9 (Berkeley) 5/14/95
39  * $FreeBSD: src/sys/ufs/ufs/inode.h,v 1.28.2.2 2001/09/29 12:52:52 iedowse Exp $
40  * $DragonFly: src/sys/vfs/ufs/inode.h,v 1.5 2003/11/21 22:46:14 dillon Exp $
41  */
42 
43 #ifndef _UFS_UFS_INODE_H_
44 #define	_UFS_UFS_INODE_H_
45 
46 #ifndef _SYS_LOCK_H_
47 #include <sys/lock.h>
48 #endif
49 #ifndef _SYS_QUEUE_H_
50 #include <sys/queue.h>
51 #endif
52 #include "dinode.h"
53 
54 /*
55  * The size of a logical block number.
56  */
57 typedef long ufs_lbn_t;
58 
59 /*
60  * This must agree with the definition in <ufs/ufs/dir.h>.
61  */
62 #define	doff_t		int32_t
63 
64 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
65 
66 /*
67  * The inode is used to describe each active (or recently active) file in the
68  * UFS filesystem. It is composed of two types of information. The first part
69  * is the information that is needed only while the file is active (such as
70  * the identity of the file and linkage to speed its lookup). The second part
71  * is the permanent meta-data associated with the file which is read in
72  * from the permanent dinode from long term storage when the file becomes
73  * active, and is put back when the file is no longer being used.
74  */
75 struct inode {
76 	struct	 lock i_lock;	/* Inode lock. >Keep this first< */
77 	LIST_ENTRY(inode) i_hash;/* Hash chain. */
78 	struct	vnode  *i_vnode;/* Vnode associated with this inode. */
79 	struct	vnode  *i_devvp;/* Vnode for block I/O. */
80 	u_int32_t i_flag;	/* flags, see below */
81 	dev_t	  i_dev;	/* Device associated with the inode. */
82 	ino_t	  i_number;	/* The identity of the inode. */
83 	int	  i_effnlink;	/* i_nlink when I/O completes */
84 
85 	union {			/* Associated filesystem. */
86 		struct	fs *fs;		/* FFS */
87 		struct	ext2_sb_info *e2fs;	/* EXT2FS */
88 	} inode_u;
89 #define	i_fs	inode_u.fs
90 #define	i_e2fs	inode_u.e2fs
91 	struct	 dquot *i_dquot[MAXQUOTAS]; /* Dquot structures. */
92 	u_quad_t i_modrev;	/* Revision level for NFS lease. */
93 	struct	 lockf *i_lockf;/* Head of byte-level lock list. */
94 	/*
95 	 * Side effects; used during directory lookup.
96 	 */
97 	int32_t	  i_count;	/* Size of free slot in directory. */
98 	doff_t	  i_endoff;	/* End of useful stuff in directory. */
99 	doff_t	  i_diroff;	/* Offset in dir, where we found last entry. */
100 	doff_t	  i_offset;	/* Offset of free space in directory. */
101 	ino_t	  i_ino;	/* Inode number of found directory. */
102 	u_int32_t i_reclen;	/* Size of found directory entry. */
103 	u_int32_t i_spare[3];	/* XXX actually non-spare (for ext2fs). */
104 
105 	struct dirhash *i_dirhash; /* Hashing for large directories */
106 	/*
107 	 * The on-disk dinode itself.
108 	 */
109 	struct	dinode i_din;	/* 128 bytes of the on-disk dinode. */
110 };
111 
112 #define	i_atime		i_din.di_atime
113 #define	i_atimensec	i_din.di_atimensec
114 #define	i_blocks	i_din.di_blocks
115 #define	i_ctime		i_din.di_ctime
116 #define	i_ctimensec	i_din.di_ctimensec
117 #define	i_db		i_din.di_db
118 #define	i_flags		i_din.di_flags
119 #define	i_gen		i_din.di_gen
120 #define	i_gid		i_din.di_gid
121 #define	i_ib		i_din.di_ib
122 #define	i_mode		i_din.di_mode
123 #define	i_mtime		i_din.di_mtime
124 #define	i_mtimensec	i_din.di_mtimensec
125 #define	i_nlink		i_din.di_nlink
126 #define	i_rdev		i_din.di_rdev
127 #define	i_shortlink	i_din.di_shortlink
128 #define	i_size		i_din.di_size
129 #define	i_uid		i_din.di_uid
130 
131 #endif
132 
133 /* These flags are kept in i_flag. */
134 #define	IN_ACCESS	0x0001		/* Access time update request. */
135 #define	IN_CHANGE	0x0002		/* Inode change time update request. */
136 #define	IN_UPDATE	0x0004		/* Modification time update request. */
137 #define	IN_MODIFIED	0x0008		/* Inode has been modified. */
138 #define	IN_RENAME	0x0010		/* Inode is being renamed. */
139 #define	IN_SHLOCK	0x0020		/* File has shared lock. */
140 #define	IN_EXLOCK	0x0040		/* File has exclusive lock. */
141 #define	IN_HASHED	0x0080		/* Inode is on hash list */
142 #define	IN_LAZYMOD	0x0100		/* Modified, but don't write yet. */
143 
144 #if defined(_KERNEL) || defined(_KERNEL_STRUCTURES)
145 
146 /*
147  * Structure used to pass around logical block paths generated by
148  * ufs_getlbns and used by truncate and bmap code.
149  */
150 struct indir {
151 	ufs_daddr_t in_lbn;		/* Logical block number. */
152 	int	in_off;			/* Offset in buffer. */
153 	int	in_exists;		/* Flag if the block exists. */
154 };
155 
156 /* Convert between inode pointers and vnode pointers. */
157 #define VTOI(vp)	((struct inode *)(vp)->v_data)
158 #define ITOV(ip)	((ip)->i_vnode)
159 
160 /* Determine if soft dependencies are being done */
161 #define DOINGSOFTDEP(vp)	((vp)->v_mount->mnt_flag & MNT_SOFTDEP)
162 #define DOINGASYNC(vp)		((vp)->v_mount->mnt_flag & MNT_ASYNC)
163 
164 /* This overlays the fid structure (see mount.h). */
165 struct ufid {
166 	u_int16_t ufid_len;	/* Length of structure. */
167 	u_int16_t ufid_pad;	/* Force 32-bit alignment. */
168 	ino_t	  ufid_ino;	/* File number (ino). */
169 	int32_t	  ufid_gen;	/* Generation number. */
170 };
171 #endif /* _KERNEL || _KERNEL_STRUCTURES */
172 
173 #endif /* !_UFS_UFS_INODE_H_ */
174