fs/ntfs/mft.h

   1 /*
   2  * mft.h - Defines for mft record handling in NTFS Linux kernel driver.
   3  *         Part of the Linux-NTFS project.
   4  *
   5  * Copyright (c) 2001-2004 Anton Altaparmakov
   6  *
   7  * This program/include file is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU General Public License as published
   9  * by the Free Software Foundation; either version 2 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program/include file is distributed in the hope that it will be
  13  * useful, but WITHOUT ANY WARRANTY; without even the implied warranty
  14  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU General Public License
  18  * along with this program (in the main directory of the Linux-NTFS
  19  * distribution in the file COPYING); if not, write to the Free Software
  20  * Foundation,Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  */
  22
  23 #ifndef _LINUX_NTFS_MFT_H
  24 #define _LINUX_NTFS_MFT_H
  25
  26 #include <linux/fs.h>
  27
  28 #include "inode.h"
  29
  30 extern int format_mft_record(ntfs_inode *ni, MFT_RECORD *m);
  31
  32 extern MFT_RECORD *map_mft_record(ntfs_inode *ni);
  33 extern void unmap_mft_record(ntfs_inode *ni);
  34
  35 extern MFT_RECORD *map_extent_mft_record(ntfs_inode *base_ni, MFT_REF mref,
  36                 ntfs_inode **ntfs_ino);
  37
  38 static inline void unmap_extent_mft_record(ntfs_inode *ni)
  39 {
  40         unmap_mft_record(ni);
  41         return;
  42 }
  43
  44 #ifdef NTFS_RW
  45
  46 /**
  47  * flush_dcache_mft_record_page - flush_dcache_page() for mft records
  48  * @ni:         ntfs inode structure of mft record
  49  *
  50  * Call flush_dcache_page() for the page in which an mft record resides.
  51  *
  52  * This must be called every time an mft record is modified, just after the
  53  * modification.
  54  */
  55 static inline void flush_dcache_mft_record_page(ntfs_inode *ni)
  56 {
  57         flush_dcache_page(ni->page);
  58 }
  59
  60 extern void __mark_mft_record_dirty(ntfs_inode *ni);
  61
  62 /**
  63  * mark_mft_record_dirty - set the mft record and the page containing it dirty
  64  * @ni:         ntfs inode describing the mapped mft record
  65  *
  66  * Set the mapped (extent) mft record of the (base or extent) ntfs inode @ni,
  67  * as well as the page containing the mft record, dirty.  Also, mark the base
  68  * vfs inode dirty.  This ensures that any changes to the mft record are
  69  * written out to disk.
  70  *
  71  * NOTE:  Do not do anything if the mft record is already marked dirty.
  72  */
  73 static inline void mark_mft_record_dirty(ntfs_inode *ni)
  74 {
  75         if (!NInoTestSetDirty(ni))
  76                 __mark_mft_record_dirty(ni);
  77 }
  78
  79 extern int write_mft_record_nolock(ntfs_inode *ni, MFT_RECORD *m, int sync);
  80
  81 /**
  82  * write_mft_record - write out a mapped (extent) mft record
  83  * @ni:         ntfs inode describing the mapped (extent) mft record
  84  * @m:          mapped (extent) mft record to write
  85  * @sync:       if true, wait for i/o completion
  86  *
  87  * This is just a wrapper for write_mft_record_nolock() (see mft.c), which
  88  * locks the page for the duration of the write.  This ensures that there are
  89  * no race conditions between writing the mft record via the dirty inode code
  90  * paths and via the page cache write back code paths or between writing
  91  * neighbouring mft records residing in the same page.
  92  *
  93  * Locking the page also serializes us against ->readpage() if the page is not
  94  * uptodate.
  95  *
  96  * On success, clean the mft record and return 0.  On error, leave the mft
  97  * record dirty and return -errno.  The caller should call make_bad_inode() on
  98  * the base inode to ensure no more access happens to this inode.  We do not do
  99  * it here as the caller may want to finish writing other extent mft records
 100  * first to minimize on-disk metadata inconsistencies.
 101  */
 102 static inline int write_mft_record(ntfs_inode *ni, MFT_RECORD *m, int sync)
 103 {
 104         struct page *page = ni->page;
 105         int err;
 106
 107         BUG_ON(!page);
 108         lock_page(page);
 109         err = write_mft_record_nolock(ni, m, sync);
 110         unlock_page(page);
 111         return err;
 112 }
 113
 114 #endif /* NTFS_RW */
 115
 116 #endif /* _LINUX_NTFS_MFT_H */