fs/xfs/linux-2.6/xfs_vnode.h

   1 /*
   2  * Copyright (c) 2000-2005 Silicon Graphics, Inc.
   3  * All Rights Reserved.
   4  *
   5  * This program is free software; you can redistribute it and/or
   6  * modify it under the terms of the GNU General Public License as
   7  * published by the Free Software Foundation.
   8  *
   9  * This program is distributed in the hope that it would be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program; if not, write the Free Software Foundation,
  16  * Inc.,  51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  17  */
  18 #ifndef __XFS_VNODE_H__
  19 #define __XFS_VNODE_H__
  20
  21 struct file;
  22 struct bhv_vattr;
  23 struct xfs_iomap;
  24 struct attrlist_cursor_kern;
  25
  26 typedef struct dentry   bhv_vname_t;
  27 typedef __u64           bhv_vnumber_t;
  28 typedef struct inode    bhv_vnode_t;
  29
  30 #define VN_ISLNK(vp)    S_ISLNK((vp)->i_mode)
  31 #define VN_ISREG(vp)    S_ISREG((vp)->i_mode)
  32 #define VN_ISDIR(vp)    S_ISDIR((vp)->i_mode)
  33 #define VN_ISCHR(vp)    S_ISCHR((vp)->i_mode)
  34 #define VN_ISBLK(vp)    S_ISBLK((vp)->i_mode)
  35
  36 /*
  37  * Vnode to Linux inode mapping.
  38  */
  39 static inline bhv_vnode_t *vn_from_inode(struct inode *inode)
  40 {
  41         return inode;
  42 }
  43 static inline struct inode *vn_to_inode(bhv_vnode_t *vnode)
  44 {
  45         return vnode;
  46 }
  47
  48 /*
  49  * Values for the vop_rwlock/rwunlock flags parameter.
  50  */
  51 typedef enum bhv_vrwlock {
  52         VRWLOCK_NONE,
  53         VRWLOCK_READ,
  54         VRWLOCK_WRITE,
  55         VRWLOCK_WRITE_DIRECT,
  56         VRWLOCK_TRY_READ,
  57         VRWLOCK_TRY_WRITE
  58 } bhv_vrwlock_t;
  59
  60 /*
  61  * Return values for xfs_inactive.  A return value of
  62  * VN_INACTIVE_NOCACHE implies that the file system behavior
  63  * has disassociated its state and bhv_desc_t from the vnode.
  64  */
  65 #define VN_INACTIVE_CACHE       0
  66 #define VN_INACTIVE_NOCACHE     1
  67
  68 /*
  69  * Flags for read/write calls - same values as IRIX
  70  */
  71 #define IO_ISAIO        0x00001         /* don't wait for completion */
  72 #define IO_ISDIRECT     0x00004         /* bypass page cache */
  73 #define IO_INVIS        0x00020         /* don't update inode timestamps */
  74
  75 /*
  76  * Flags for vop_iflush call
  77  */
  78 #define FLUSH_SYNC              1       /* wait for flush to complete   */
  79 #define FLUSH_INODE             2       /* flush the inode itself       */
  80 #define FLUSH_LOG               4       /* force the last log entry for
  81                                          * this inode out to disk       */
  82
  83 /*
  84  * Flush/Invalidate options for vop_toss/flush/flushinval_pages.
  85  */
  86 #define FI_NONE                 0       /* none */
  87 #define FI_REMAPF               1       /* Do a remapf prior to the operation */
  88 #define FI_REMAPF_LOCKED        2       /* Do a remapf prior to the operation.
  89                                            Prevent VM access to the pages until
  90                                            the operation completes. */
  91
  92 /*
  93  * Vnode attributes.  va_mask indicates those attributes the caller
  94  * wants to set or extract.
  95  */
  96 typedef struct bhv_vattr {
  97         int             va_mask;        /* bit-mask of attributes present */
  98         mode_t          va_mode;        /* file access mode and type */
  99         xfs_nlink_t     va_nlink;       /* number of references to file */
 100         uid_t           va_uid;         /* owner user id */
 101         gid_t           va_gid;         /* owner group id */
 102         xfs_ino_t       va_nodeid;      /* file id */
 103         xfs_off_t       va_size;        /* file size in bytes */
 104         u_long          va_blocksize;   /* blocksize preferred for i/o */
 105         struct timespec va_atime;       /* time of last access */
 106         struct timespec va_mtime;       /* time of last modification */
 107         struct timespec va_ctime;       /* time file changed */
 108         u_int           va_gen;         /* generation number of file */
 109         xfs_dev_t       va_rdev;        /* device the special file represents */
 110         __int64_t       va_nblocks;     /* number of blocks allocated */
 111         u_long          va_xflags;      /* random extended file flags */
 112         u_long          va_extsize;     /* file extent size */
 113         u_long          va_nextents;    /* number of extents in file */
 114         u_long          va_anextents;   /* number of attr extents in file */
 115         prid_t          va_projid;      /* project id */
 116 } bhv_vattr_t;
 117
 118 /*
 119  * setattr or getattr attributes
 120  */
 121 #define XFS_AT_TYPE             0x00000001
 122 #define XFS_AT_MODE             0x00000002
 123 #define XFS_AT_UID              0x00000004
 124 #define XFS_AT_GID              0x00000008
 125 #define XFS_AT_FSID             0x00000010
 126 #define XFS_AT_NODEID           0x00000020
 127 #define XFS_AT_NLINK            0x00000040
 128 #define XFS_AT_SIZE             0x00000080
 129 #define XFS_AT_ATIME            0x00000100
 130 #define XFS_AT_MTIME            0x00000200
 131 #define XFS_AT_CTIME            0x00000400
 132 #define XFS_AT_RDEV             0x00000800
 133 #define XFS_AT_BLKSIZE          0x00001000
 134 #define XFS_AT_NBLOCKS          0x00002000
 135 #define XFS_AT_VCODE            0x00004000
 136 #define XFS_AT_MAC              0x00008000
 137 #define XFS_AT_UPDATIME         0x00010000
 138 #define XFS_AT_UPDMTIME         0x00020000
 139 #define XFS_AT_UPDCTIME         0x00040000
 140 #define XFS_AT_ACL              0x00080000
 141 #define XFS_AT_CAP              0x00100000
 142 #define XFS_AT_INF              0x00200000
 143 #define XFS_AT_XFLAGS           0x00400000
 144 #define XFS_AT_EXTSIZE          0x00800000
 145 #define XFS_AT_NEXTENTS         0x01000000
 146 #define XFS_AT_ANEXTENTS        0x02000000
 147 #define XFS_AT_PROJID           0x04000000
 148 #define XFS_AT_SIZE_NOPERM      0x08000000
 149 #define XFS_AT_GENCOUNT         0x10000000
 150
 151 #define XFS_AT_ALL      (XFS_AT_TYPE|XFS_AT_MODE|XFS_AT_UID|XFS_AT_GID|\
 152                 XFS_AT_FSID|XFS_AT_NODEID|XFS_AT_NLINK|XFS_AT_SIZE|\
 153                 XFS_AT_ATIME|XFS_AT_MTIME|XFS_AT_CTIME|XFS_AT_RDEV|\
 154                 XFS_AT_BLKSIZE|XFS_AT_NBLOCKS|XFS_AT_VCODE|XFS_AT_MAC|\
 155                 XFS_AT_ACL|XFS_AT_CAP|XFS_AT_INF|XFS_AT_XFLAGS|XFS_AT_EXTSIZE|\
 156                 XFS_AT_NEXTENTS|XFS_AT_ANEXTENTS|XFS_AT_PROJID|XFS_AT_GENCOUNT)
 157
 158 #define XFS_AT_STAT     (XFS_AT_TYPE|XFS_AT_MODE|XFS_AT_UID|XFS_AT_GID|\
 159                 XFS_AT_FSID|XFS_AT_NODEID|XFS_AT_NLINK|XFS_AT_SIZE|\
 160                 XFS_AT_ATIME|XFS_AT_MTIME|XFS_AT_CTIME|XFS_AT_RDEV|\
 161                 XFS_AT_BLKSIZE|XFS_AT_NBLOCKS|XFS_AT_PROJID)
 162
 163 #define XFS_AT_TIMES    (XFS_AT_ATIME|XFS_AT_MTIME|XFS_AT_CTIME)
 164
 165 #define XFS_AT_UPDTIMES (XFS_AT_UPDATIME|XFS_AT_UPDMTIME|XFS_AT_UPDCTIME)
 166
 167 #define XFS_AT_NOSET    (XFS_AT_NLINK|XFS_AT_RDEV|XFS_AT_FSID|XFS_AT_NODEID|\
 168                 XFS_AT_TYPE|XFS_AT_BLKSIZE|XFS_AT_NBLOCKS|XFS_AT_VCODE|\
 169                 XFS_AT_NEXTENTS|XFS_AT_ANEXTENTS|XFS_AT_GENCOUNT)
 170
 171 /*
 172  *  Modes.
 173  */
 174 #define VSUID   S_ISUID         /* set user id on execution */
 175 #define VSGID   S_ISGID         /* set group id on execution */
 176 #define VSVTX   S_ISVTX         /* save swapped text even after use */
 177 #define VREAD   S_IRUSR         /* read, write, execute permissions */
 178 #define VWRITE  S_IWUSR
 179 #define VEXEC   S_IXUSR
 180
 181 #define MODEMASK S_IALLUGO      /* mode bits plus permission bits */
 182
 183 /*
 184  * Check whether mandatory file locking is enabled.
 185  */
 186 #define MANDLOCK(vp, mode)      \
 187         (VN_ISREG(vp) && ((mode) & (VSGID|(VEXEC>>3))) == VSGID)
 188
 189 extern void     vn_init(void);
 190 extern int      vn_revalidate(bhv_vnode_t *);
 191
 192 /*
 193  * Yeah, these don't take vnode anymore at all, all this should be
 194  * cleaned up at some point.
 195  */
 196 extern void     vn_iowait(struct xfs_inode *ip);
 197 extern void     vn_iowake(struct xfs_inode *ip);
 198 extern void     vn_ioerror(struct xfs_inode *ip, int error, char *f, int l);
 199
 200 static inline int vn_count(bhv_vnode_t *vp)
 201 {
 202         return atomic_read(&vn_to_inode(vp)->i_count);
 203 }
 204
 205 /*
 206  * Vnode reference counting functions (and macros for compatibility).
 207  */
 208 extern bhv_vnode_t      *vn_hold(bhv_vnode_t *);
 209
 210 #if defined(XFS_INODE_TRACE)
 211 #define VN_HOLD(vp)             \
 212         ((void)vn_hold(vp),     \
 213           xfs_itrace_hold(xfs_vtoi(vp), __FILE__, __LINE__, (inst_t *)__return_address))
 214 #define VN_RELE(vp)             \
 215           (xfs_itrace_rele(xfs_vtoi(vp), __FILE__, __LINE__, (inst_t *)__return_address), \
 216            iput(vn_to_inode(vp)))
 217 #else
 218 #define VN_HOLD(vp)             ((void)vn_hold(vp))
 219 #define VN_RELE(vp)             (iput(vn_to_inode(vp)))
 220 #endif
 221
 222 static inline bhv_vnode_t *vn_grab(bhv_vnode_t *vp)
 223 {
 224         struct inode *inode = igrab(vn_to_inode(vp));
 225         return inode ? vn_from_inode(inode) : NULL;
 226 }
 227
 228 /*
 229  * Vname handling macros.
 230  */
 231 #define VNAME(dentry)           ((char *) (dentry)->d_name.name)
 232 #define VNAMELEN(dentry)        ((dentry)->d_name.len)
 233 #define VNAME_TO_VNODE(dentry)  (vn_from_inode((dentry)->d_inode))
 234
 235 /*
 236  * Dealing with bad inodes
 237  */
 238 static inline int VN_BAD(bhv_vnode_t *vp)
 239 {
 240         return is_bad_inode(vn_to_inode(vp));
 241 }
 242
 243 /*
 244  * Extracting atime values in various formats
 245  */
 246 static inline void vn_atime_to_bstime(bhv_vnode_t *vp, xfs_bstime_t *bs_atime)
 247 {
 248         bs_atime->tv_sec = vp->i_atime.tv_sec;
 249         bs_atime->tv_nsec = vp->i_atime.tv_nsec;
 250 }
 251
 252 static inline void vn_atime_to_timespec(bhv_vnode_t *vp, struct timespec *ts)
 253 {
 254         *ts = vp->i_atime;
 255 }
 256
 257 static inline void vn_atime_to_time_t(bhv_vnode_t *vp, time_t *tt)
 258 {
 259         *tt = vp->i_atime.tv_sec;
 260 }
 261
 262 /*
 263  * Some useful predicates.
 264  */
 265 #define VN_MAPPED(vp)   mapping_mapped(vn_to_inode(vp)->i_mapping)
 266 #define VN_CACHED(vp)   (vn_to_inode(vp)->i_mapping->nrpages)
 267 #define VN_DIRTY(vp)    mapping_tagged(vn_to_inode(vp)->i_mapping, \
 268                                         PAGECACHE_TAG_DIRTY)
 269
 270 /*
 271  * Flags to vop_setattr/getattr.
 272  */
 273 #define ATTR_UTIME      0x01    /* non-default utime(2) request */
 274 #define ATTR_DMI        0x08    /* invocation from a DMI function */
 275 #define ATTR_LAZY       0x80    /* set/get attributes lazily */
 276 #define ATTR_NONBLOCK   0x100   /* return EAGAIN if operation would block */
 277 #define ATTR_NOLOCK     0x200   /* Don't grab any conflicting locks */
 278 #define ATTR_NOSIZETOK  0x400   /* Don't get the SIZE token */
 279
 280 /*
 281  * Flags to vop_fsync/reclaim.
 282  */
 283 #define FSYNC_NOWAIT    0       /* asynchronous flush */
 284 #define FSYNC_WAIT      0x1     /* synchronous fsync or forced reclaim */
 285 #define FSYNC_INVAL     0x2     /* flush and invalidate cached data */
 286 #define FSYNC_DATA      0x4     /* synchronous fsync of data only */
 287
 288 /*
 289  * Tracking vnode activity.
 290  */
 291 #if defined(XFS_INODE_TRACE)
 292
 293 #define INODE_TRACE_SIZE        16              /* number of trace entries */
 294 #define INODE_KTRACE_ENTRY      1
 295 #define INODE_KTRACE_EXIT       2
 296 #define INODE_KTRACE_HOLD       3
 297 #define INODE_KTRACE_REF        4
 298 #define INODE_KTRACE_RELE       5
 299
 300 extern void _xfs_itrace_entry(struct xfs_inode *, const char *, inst_t *);
 301 extern void _xfs_itrace_exit(struct xfs_inode *, const char *, inst_t *);
 302 extern void xfs_itrace_hold(struct xfs_inode *, char *, int, inst_t *);
 303 extern void _xfs_itrace_ref(struct xfs_inode *, char *, int, inst_t *);
 304 extern void xfs_itrace_rele(struct xfs_inode *, char *, int, inst_t *);
 305 #define xfs_itrace_entry(ip)    \
 306         _xfs_itrace_entry(ip, __FUNCTION__, (inst_t *)__return_address)
 307 #define xfs_itrace_exit(ip)     \
 308         _xfs_itrace_exit(ip, __FUNCTION__, (inst_t *)__return_address)
 309 #define xfs_itrace_exit_tag(ip, tag)    \
 310         _xfs_itrace_exit(ip, tag, (inst_t *)__return_address)
 311 #define xfs_itrace_ref(ip)      \
 312         _xfs_itrace_ref(ip, __FILE__, __LINE__, (inst_t *)__return_address)
 313
 314 #else
 315 #define xfs_itrace_entry(a)
 316 #define xfs_itrace_exit(a)
 317 #define xfs_itrace_exit_tag(a, b)
 318 #define xfs_itrace_hold(a, b, c, d)
 319 #define xfs_itrace_ref(a)
 320 #define xfs_itrace_rele(a, b, c, d)
 321 #endif
 322
 323 #endif  /* __XFS_VNODE_H__ */