fs/xfs/xfs_dmapi.h

   1 /*
   2  * Copyright (c) 2000-2004 Silicon Graphics, Inc.  All Rights Reserved.
   3  *
   4  * This program is free software; you can redistribute it and/or modify it
   5  * under the terms of version 2 of the GNU General Public License as
   6  * published by the Free Software Foundation.
   7  *
   8  * This program is distributed in the hope that it would be useful, but
   9  * WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  11  *
  12  * Further, this software is distributed without any warranty that it is
  13  * free of the rightful claim of any third person regarding infringement
  14  * or the like.  Any license provided herein, whether implied or
  15  * otherwise, applies only to this software file.  Patent licenses, if
  16  * any, provided herein do not apply to combinations of this program with
  17  * other software, or any other product whatsoever.
  18  *
  19  * You should have received a copy of the GNU General Public License along
  20  * with this program; if not, write the Free Software Foundation, Inc., 59
  21  * Temple Place - Suite 330, Boston MA 02111-1307, USA.
  22  *
  23  * Contact information: Silicon Graphics, Inc., 1600 Amphitheatre Pkwy,
  24  * Mountain View, CA  94043, or:
  25  *
  26  * http://www.sgi.com
  27  *
  28  * For further information regarding this notice, see:
  29  *
  30  * http://oss.sgi.com/projects/GenInfo/SGIGPLNoticeExplan/
  31  */
  32 #ifndef __XFS_DMAPI_H__
  33 #define __XFS_DMAPI_H__
  34
  35 /*      Values used to define the on-disk version of dm_attrname_t. All
  36  *      on-disk attribute names start with the 8-byte string "SGI_DMI_".
  37  *
  38  *      In the on-disk inode, DMAPI attribute names consist of the user-provided
  39  *      name with the DMATTR_PREFIXSTRING pre-pended.  This string must NEVER be
  40  *      changed.
  41  */
  42
  43 #define DMATTR_PREFIXLEN        8
  44 #define DMATTR_PREFIXSTRING     "SGI_DMI_"
  45
  46 typedef enum {
  47         DM_EVENT_INVALID        = -1,
  48         DM_EVENT_CANCEL         = 0,            /* not supported */
  49         DM_EVENT_MOUNT          = 1,
  50         DM_EVENT_PREUNMOUNT     = 2,
  51         DM_EVENT_UNMOUNT        = 3,
  52         DM_EVENT_DEBUT          = 4,            /* not supported */
  53         DM_EVENT_CREATE         = 5,
  54         DM_EVENT_CLOSE          = 6,            /* not supported */
  55         DM_EVENT_POSTCREATE     = 7,
  56         DM_EVENT_REMOVE         = 8,
  57         DM_EVENT_POSTREMOVE     = 9,
  58         DM_EVENT_RENAME         = 10,
  59         DM_EVENT_POSTRENAME     = 11,
  60         DM_EVENT_LINK           = 12,
  61         DM_EVENT_POSTLINK       = 13,
  62         DM_EVENT_SYMLINK        = 14,
  63         DM_EVENT_POSTSYMLINK    = 15,
  64         DM_EVENT_READ           = 16,
  65         DM_EVENT_WRITE          = 17,
  66         DM_EVENT_TRUNCATE       = 18,
  67         DM_EVENT_ATTRIBUTE      = 19,
  68         DM_EVENT_DESTROY        = 20,
  69         DM_EVENT_NOSPACE        = 21,
  70         DM_EVENT_USER           = 22,
  71         DM_EVENT_MAX            = 23
  72 } dm_eventtype_t;
  73 #define HAVE_DM_EVENTTYPE_T
  74
  75 typedef enum {
  76         DM_RIGHT_NULL,
  77         DM_RIGHT_SHARED,
  78         DM_RIGHT_EXCL
  79 } dm_right_t;
  80 #define HAVE_DM_RIGHT_T
  81
  82 /* Defines for determining if an event message should be sent. */
  83 #define DM_EVENT_ENABLED(vfsp, ip, event) ( \
  84         unlikely ((vfsp)->vfs_flag & VFS_DMI) && \
  85                 ( ((ip)->i_d.di_dmevmask & (1 << event)) || \
  86                   ((ip)->i_mount->m_dmevmask & (1 << event)) ) \
  87         )
  88
  89 #define DM_EVENT_ENABLED_IO(vfsp, io, event) ( \
  90         unlikely ((vfsp)->vfs_flag & VFS_DMI) && \
  91                 ( ((io)->io_dmevmask & (1 << event)) || \
  92                   ((io)->io_mount->m_dmevmask & (1 << event)) ) \
  93         )
  94
  95 #define DM_XFS_VALID_FS_EVENTS          ( \
  96         (1 << DM_EVENT_PREUNMOUNT)      | \
  97         (1 << DM_EVENT_UNMOUNT)         | \
  98         (1 << DM_EVENT_NOSPACE)         | \
  99         (1 << DM_EVENT_DEBUT)           | \
 100         (1 << DM_EVENT_CREATE)          | \
 101         (1 << DM_EVENT_POSTCREATE)      | \
 102         (1 << DM_EVENT_REMOVE)          | \
 103         (1 << DM_EVENT_POSTREMOVE)      | \
 104         (1 << DM_EVENT_RENAME)          | \
 105         (1 << DM_EVENT_POSTRENAME)      | \
 106         (1 << DM_EVENT_LINK)            | \
 107         (1 << DM_EVENT_POSTLINK)        | \
 108         (1 << DM_EVENT_SYMLINK)         | \
 109         (1 << DM_EVENT_POSTSYMLINK)     | \
 110         (1 << DM_EVENT_ATTRIBUTE)       | \
 111         (1 << DM_EVENT_DESTROY)         )
 112
 113 /* Events valid in dm_set_eventlist() when called with a file handle for
 114    a regular file or a symlink.  These events are persistent.
 115 */
 116
 117 #define DM_XFS_VALID_FILE_EVENTS        ( \
 118         (1 << DM_EVENT_ATTRIBUTE)       | \
 119         (1 << DM_EVENT_DESTROY)         )
 120
 121 /* Events valid in dm_set_eventlist() when called with a file handle for
 122    a directory.  These events are persistent.
 123 */
 124
 125 #define DM_XFS_VALID_DIRECTORY_EVENTS   ( \
 126         (1 << DM_EVENT_CREATE)          | \
 127         (1 << DM_EVENT_POSTCREATE)      | \
 128         (1 << DM_EVENT_REMOVE)          | \
 129         (1 << DM_EVENT_POSTREMOVE)      | \
 130         (1 << DM_EVENT_RENAME)          | \
 131         (1 << DM_EVENT_POSTRENAME)      | \
 132         (1 << DM_EVENT_LINK)            | \
 133         (1 << DM_EVENT_POSTLINK)        | \
 134         (1 << DM_EVENT_SYMLINK)         | \
 135         (1 << DM_EVENT_POSTSYMLINK)     | \
 136         (1 << DM_EVENT_ATTRIBUTE)       | \
 137         (1 << DM_EVENT_DESTROY)         )
 138
 139 /* Events supported by the XFS filesystem. */
 140 #define DM_XFS_SUPPORTED_EVENTS         ( \
 141         (1 << DM_EVENT_MOUNT)           | \
 142         (1 << DM_EVENT_PREUNMOUNT)      | \
 143         (1 << DM_EVENT_UNMOUNT)         | \
 144         (1 << DM_EVENT_NOSPACE)         | \
 145         (1 << DM_EVENT_CREATE)          | \
 146         (1 << DM_EVENT_POSTCREATE)      | \
 147         (1 << DM_EVENT_REMOVE)          | \
 148         (1 << DM_EVENT_POSTREMOVE)      | \
 149         (1 << DM_EVENT_RENAME)          | \
 150         (1 << DM_EVENT_POSTRENAME)      | \
 151         (1 << DM_EVENT_LINK)            | \
 152         (1 << DM_EVENT_POSTLINK)        | \
 153         (1 << DM_EVENT_SYMLINK)         | \
 154         (1 << DM_EVENT_POSTSYMLINK)     | \
 155         (1 << DM_EVENT_READ)            | \
 156         (1 << DM_EVENT_WRITE)           | \
 157         (1 << DM_EVENT_TRUNCATE)        | \
 158         (1 << DM_EVENT_ATTRIBUTE)       | \
 159         (1 << DM_EVENT_DESTROY)         )
 160
 161
 162 /*
 163  *      Definitions used for the flags field on dm_send_*_event().
 164  */
 165
 166 #define DM_FLAGS_NDELAY         0x001   /* return EAGAIN after dm_pending() */
 167 #define DM_FLAGS_UNWANTED       0x002   /* event not in fsys dm_eventset_t */
 168 #define DM_FLAGS_ISEM           0x004   /* thread holds i_sem */
 169 #define DM_FLAGS_IALLOCSEM_RD   0x010   /* thread holds i_alloc_sem rd */
 170 #define DM_FLAGS_IALLOCSEM_WR   0x020   /* thread holds i_alloc_sem wr */
 171
 172 /*
 173  *      Based on IO_ISDIRECT, decide which i_ flag is set.
 174  */
 175 #if LINUX_VERSION_CODE > KERNEL_VERSION(2,6,0)
 176 #define DM_SEM_FLAG_RD(ioflags) (((ioflags) & IO_ISDIRECT) ? \
 177                               DM_FLAGS_ISEM : 0)
 178 #define DM_SEM_FLAG_WR  (DM_FLAGS_IALLOCSEM_WR | DM_FLAGS_ISEM)
 179 #endif
 180
 181 #if (LINUX_VERSION_CODE < KERNEL_VERSION(2,6,0)) && \
 182     (LINUX_VERSION_CODE >= KERNEL_VERSION(2,4,22))
 183 #define DM_SEM_FLAG_RD(ioflags) (((ioflags) & IO_ISDIRECT) ? \
 184                               DM_FLAGS_IALLOCSEM_RD : DM_FLAGS_ISEM)
 185 #define DM_SEM_FLAG_WR  (DM_FLAGS_IALLOCSEM_WR | DM_FLAGS_ISEM)
 186 #endif
 187
 188 #if LINUX_VERSION_CODE <= KERNEL_VERSION(2,4,21)
 189 #define DM_SEM_FLAG_RD(ioflags) (((ioflags) & IO_ISDIRECT) ? \
 190                               0 : DM_FLAGS_ISEM)
 191 #define DM_SEM_FLAG_WR  (DM_FLAGS_ISEM)
 192 #endif
 193
 194
 195 /*
 196  *      Macros to turn caller specified delay/block flags into
 197  *      dm_send_xxxx_event flag DM_FLAGS_NDELAY.
 198  */
 199
 200 #define FILP_DELAY_FLAG(filp) ((filp->f_flags&(O_NDELAY|O_NONBLOCK)) ? \
 201                         DM_FLAGS_NDELAY : 0)
 202 #define AT_DELAY_FLAG(f) ((f&ATTR_NONBLOCK) ? DM_FLAGS_NDELAY : 0)
 203
 204
 205 extern struct bhv_vfsops xfs_dmops;
 206
 207 #ifdef CONFIG_XFS_DMAPI
 208 void xfs_dm_init(struct file_system_type *);
 209 void xfs_dm_exit(struct file_system_type *);
 210 #define XFS_DM_INIT(fstype)     xfs_dm_init(fstype)
 211 #define XFS_DM_EXIT(fstype)     xfs_dm_exit(fstype)
 212 #else
 213 #define XFS_DM_INIT(fstype)
 214 #define XFS_DM_EXIT(fstype)
 215 #endif
 216
 217 #endif  /* __XFS_DMAPI_H__ */