1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ |
2 | /* |
3 | * mft.h - Defines for mft record handling in NTFS Linux kernel driver. |
4 | * Part of the Linux-NTFS project. |
5 | * |
6 | * Copyright (c) 2001-2004 Anton Altaparmakov |
7 | */ |
8 | |
9 | #ifndef _LINUX_NTFS_MFT_H |
10 | #define _LINUX_NTFS_MFT_H |
11 | |
12 | #include <linux/fs.h> |
13 | #include <linux/highmem.h> |
14 | #include <linux/pagemap.h> |
15 | |
16 | #include "inode.h" |
17 | |
18 | extern MFT_RECORD *map_mft_record(ntfs_inode *ni); |
19 | extern void unmap_mft_record(ntfs_inode *ni); |
20 | |
21 | extern MFT_RECORD *map_extent_mft_record(ntfs_inode *base_ni, MFT_REF mref, |
22 | ntfs_inode **ntfs_ino); |
23 | |
24 | static inline void unmap_extent_mft_record(ntfs_inode *ni) |
25 | { |
26 | unmap_mft_record(ni); |
27 | return; |
28 | } |
29 | |
30 | #ifdef NTFS_RW |
31 | |
32 | /** |
33 | * flush_dcache_mft_record_page - flush_dcache_page() for mft records |
34 | * @ni: ntfs inode structure of mft record |
35 | * |
36 | * Call flush_dcache_page() for the page in which an mft record resides. |
37 | * |
38 | * This must be called every time an mft record is modified, just after the |
39 | * modification. |
40 | */ |
41 | static inline void flush_dcache_mft_record_page(ntfs_inode *ni) |
42 | { |
43 | flush_dcache_page(page: ni->page); |
44 | } |
45 | |
46 | extern void __mark_mft_record_dirty(ntfs_inode *ni); |
47 | |
48 | /** |
49 | * mark_mft_record_dirty - set the mft record and the page containing it dirty |
50 | * @ni: ntfs inode describing the mapped mft record |
51 | * |
52 | * Set the mapped (extent) mft record of the (base or extent) ntfs inode @ni, |
53 | * as well as the page containing the mft record, dirty. Also, mark the base |
54 | * vfs inode dirty. This ensures that any changes to the mft record are |
55 | * written out to disk. |
56 | * |
57 | * NOTE: Do not do anything if the mft record is already marked dirty. |
58 | */ |
59 | static inline void mark_mft_record_dirty(ntfs_inode *ni) |
60 | { |
61 | if (!NInoTestSetDirty(ni)) |
62 | __mark_mft_record_dirty(ni); |
63 | } |
64 | |
65 | extern int ntfs_sync_mft_mirror(ntfs_volume *vol, const unsigned long mft_no, |
66 | MFT_RECORD *m, int sync); |
67 | |
68 | extern int write_mft_record_nolock(ntfs_inode *ni, MFT_RECORD *m, int sync); |
69 | |
70 | /** |
71 | * write_mft_record - write out a mapped (extent) mft record |
72 | * @ni: ntfs inode describing the mapped (extent) mft record |
73 | * @m: mapped (extent) mft record to write |
74 | * @sync: if true, wait for i/o completion |
75 | * |
76 | * This is just a wrapper for write_mft_record_nolock() (see mft.c), which |
77 | * locks the page for the duration of the write. This ensures that there are |
78 | * no race conditions between writing the mft record via the dirty inode code |
79 | * paths and via the page cache write back code paths or between writing |
80 | * neighbouring mft records residing in the same page. |
81 | * |
82 | * Locking the page also serializes us against ->read_folio() if the page is not |
83 | * uptodate. |
84 | * |
85 | * On success, clean the mft record and return 0. On error, leave the mft |
86 | * record dirty and return -errno. |
87 | */ |
88 | static inline int write_mft_record(ntfs_inode *ni, MFT_RECORD *m, int sync) |
89 | { |
90 | struct page *page = ni->page; |
91 | int err; |
92 | |
93 | BUG_ON(!page); |
94 | lock_page(page); |
95 | err = write_mft_record_nolock(ni, m, sync); |
96 | unlock_page(page); |
97 | return err; |
98 | } |
99 | |
100 | extern bool ntfs_may_write_mft_record(ntfs_volume *vol, |
101 | const unsigned long mft_no, const MFT_RECORD *m, |
102 | ntfs_inode **locked_ni); |
103 | |
104 | extern ntfs_inode *ntfs_mft_record_alloc(ntfs_volume *vol, const int mode, |
105 | ntfs_inode *base_ni, MFT_RECORD **mrec); |
106 | extern int ntfs_extent_mft_record_free(ntfs_inode *ni, MFT_RECORD *m); |
107 | |
108 | #endif /* NTFS_RW */ |
109 | |
110 | #endif /* _LINUX_NTFS_MFT_H */ |
111 | |