btrfs-progs: docs: update dump-super
[btrfs-progs-unstable/devel.git] / disk-io.h
blobb97b90bed3c086d2e418d5d03b93610727caeeac
1 /*
2 * Copyright (C) 2007 Oracle. All rights reserved.
4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public
6 * License v2 as published by the Free Software Foundation.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 * General Public License for more details.
13 * You should have received a copy of the GNU General Public
14 * License along with this program; if not, write to the
15 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
16 * Boston, MA 021110-1307, USA.
19 #ifndef __BTRFS_DISK_IO_H__
20 #define __BTRFS_DISK_IO_H__
22 #include "kerncompat.h"
23 #include "ctree.h"
25 #define BTRFS_SUPER_INFO_OFFSET (64 * 1024)
26 #define BTRFS_SUPER_INFO_SIZE 4096
28 #define BTRFS_SUPER_MIRROR_MAX 3
29 #define BTRFS_SUPER_MIRROR_SHIFT 12
31 enum btrfs_open_ctree_flags {
32 OPEN_CTREE_WRITES = (1 << 0),
33 OPEN_CTREE_PARTIAL = (1 << 1),
34 OPEN_CTREE_BACKUP_ROOT = (1 << 2),
35 OPEN_CTREE_RECOVER_SUPER = (1 << 3),
36 OPEN_CTREE_RESTORE = (1 << 4),
37 OPEN_CTREE_NO_BLOCK_GROUPS = (1 << 5),
38 OPEN_CTREE_EXCLUSIVE = (1 << 6),
39 OPEN_CTREE_NO_DEVICES = (1 << 7),
41 * Don't print error messages if bytenr or checksums do not match in
42 * tree block headers. Turn on by OPEN_CTREE_SUPPRESS_ERROR
44 OPEN_CTREE_SUPPRESS_CHECK_BLOCK_ERRORS = (1 << 8),
45 /* Return chunk root */
46 __OPEN_CTREE_RETURN_CHUNK_ROOT = (1 << 9),
47 OPEN_CTREE_CHUNK_ROOT_ONLY = OPEN_CTREE_PARTIAL +
48 OPEN_CTREE_SUPPRESS_CHECK_BLOCK_ERRORS +
49 __OPEN_CTREE_RETURN_CHUNK_ROOT,
51 * TODO: cleanup: Split the open_ctree_flags into more indepent
52 * tree bits.
53 * Like split PARTIAL into SKIP_CSUM/SKIP_EXTENT
56 OPEN_CTREE_IGNORE_FSID_MISMATCH = (1 << 10),
59 * Allow open_ctree_fs_info() to return a incomplete fs_info with
60 * system chunks from super block only.
61 * It's useful for chunk corruption case.
62 * Makes no sense for open_ctree variants returning btrfs_root.
64 OPEN_CTREE_IGNORE_CHUNK_TREE_ERROR = (1 << 11)
67 static inline u64 btrfs_sb_offset(int mirror)
69 u64 start = 16 * 1024;
70 if (mirror)
71 return start << (BTRFS_SUPER_MIRROR_SHIFT * mirror);
72 return BTRFS_SUPER_INFO_OFFSET;
75 struct btrfs_device;
77 int read_whole_eb(struct btrfs_fs_info *info, struct extent_buffer *eb, int mirror);
78 struct extent_buffer* read_tree_block_fs_info(
79 struct btrfs_fs_info *fs_info, u64 bytenr, u32 blocksize,
80 u64 parent_transid);
81 static inline struct extent_buffer* read_tree_block(
82 struct btrfs_root *root, u64 bytenr, u32 blocksize,
83 u64 parent_transid)
85 return read_tree_block_fs_info(root->fs_info, bytenr, blocksize,
86 parent_transid);
89 int read_extent_data(struct btrfs_root *root, char *data, u64 logical,
90 u64 *len, int mirror);
91 void readahead_tree_block(struct btrfs_root *root, u64 bytenr, u32 blocksize,
92 u64 parent_transid);
93 struct extent_buffer* btrfs_find_create_tree_block(
94 struct btrfs_fs_info *fs_info, u64 bytenr, u32 blocksize);
96 int __setup_root(u32 nodesize, u32 leafsize, u32 sectorsize,
97 u32 stripesize, struct btrfs_root *root,
98 struct btrfs_fs_info *fs_info, u64 objectid);
99 int clean_tree_block(struct btrfs_trans_handle *trans,
100 struct btrfs_root *root, struct extent_buffer *buf);
102 void btrfs_free_fs_info(struct btrfs_fs_info *fs_info);
103 struct btrfs_fs_info *btrfs_new_fs_info(int writable, u64 sb_bytenr);
104 int btrfs_check_fs_compatibility(struct btrfs_super_block *sb, int writable);
105 int btrfs_setup_all_roots(struct btrfs_fs_info *fs_info, u64 root_tree_bytenr,
106 enum btrfs_open_ctree_flags flags);
107 void btrfs_release_all_roots(struct btrfs_fs_info *fs_info);
108 void btrfs_cleanup_all_caches(struct btrfs_fs_info *fs_info);
109 int btrfs_scan_fs_devices(int fd, const char *path,
110 struct btrfs_fs_devices **fs_devices, u64 sb_bytenr,
111 int super_recover, int skip_devices);
112 int btrfs_setup_chunk_tree_and_device_map(struct btrfs_fs_info *fs_info,
113 u64 chunk_root_bytenr);
115 struct btrfs_root *open_ctree(const char *filename, u64 sb_bytenr,
116 enum btrfs_open_ctree_flags flags);
117 struct btrfs_root *open_ctree_fd(int fp, const char *path, u64 sb_bytenr,
118 enum btrfs_open_ctree_flags flags);
119 struct btrfs_fs_info *open_ctree_fs_info(const char *filename,
120 u64 sb_bytenr, u64 root_tree_bytenr,
121 u64 chunk_root_bytenr,
122 enum btrfs_open_ctree_flags flags);
123 int close_ctree_fs_info(struct btrfs_fs_info *fs_info);
124 static inline int close_ctree(struct btrfs_root *root)
126 BUG_ON(!root);
127 return close_ctree_fs_info(root->fs_info);
130 int write_all_supers(struct btrfs_root *root);
131 int write_ctree_super(struct btrfs_trans_handle *trans,
132 struct btrfs_root *root);
133 int btrfs_read_dev_super(int fd, struct btrfs_super_block *sb, u64 sb_bytenr,
134 int super_recover);
135 int btrfs_map_bh_to_logical(struct btrfs_root *root, struct extent_buffer *bh,
136 u64 logical);
137 struct extent_buffer *btrfs_find_tree_block(struct btrfs_root *root,
138 u64 bytenr, u32 blocksize);
139 struct btrfs_root *btrfs_read_fs_root(struct btrfs_fs_info *fs_info,
140 struct btrfs_key *location);
141 struct btrfs_root *btrfs_read_fs_root_no_cache(struct btrfs_fs_info *fs_info,
142 struct btrfs_key *location);
143 int btrfs_free_fs_root(struct btrfs_root *root);
144 void btrfs_mark_buffer_dirty(struct extent_buffer *buf);
145 int btrfs_buffer_uptodate(struct extent_buffer *buf, u64 parent_transid);
146 int btrfs_set_buffer_uptodate(struct extent_buffer *buf);
147 int wait_on_tree_block_writeback(struct btrfs_root *root,
148 struct extent_buffer *buf);
149 u32 btrfs_csum_data(struct btrfs_root *root, char *data, u32 seed, size_t len);
150 void btrfs_csum_final(u32 crc, char *result);
152 int btrfs_commit_transaction(struct btrfs_trans_handle *trans,
153 struct btrfs_root *root);
154 int btrfs_open_device(struct btrfs_device *dev);
155 int csum_tree_block_size(struct extent_buffer *buf, u16 csum_sectorsize,
156 int verify);
157 int verify_tree_block_csum_silent(struct extent_buffer *buf, u16 csum_size);
158 int btrfs_read_buffer(struct extent_buffer *buf, u64 parent_transid);
159 int write_tree_block(struct btrfs_trans_handle *trans,
160 struct btrfs_root *root,
161 struct extent_buffer *eb);
162 int write_and_map_eb(struct btrfs_trans_handle *trans, struct btrfs_root *root,
163 struct extent_buffer *eb);
165 /* raid6.c */
166 void raid6_gen_syndrome(int disks, size_t bytes, void **ptrs);
168 #endif