blob: ec432e0c208df3da8236298c47c7ce8ab95ee57d [file] [log] [blame]
David Teiglandb3b94fa2006-01-16 16:50:04 +00001/*
Steven Whitehousefc69d0d2006-02-13 16:21:47 +00002* Copyright (C) Sistina Software, Inc. 1997-2003 All rights reserved.
3* Copyright (C) 2004-2005 Red Hat, Inc. All rights reserved.
4*
5* This copyrighted material is made available to anyone wishing to use,
6* modify, copy, or redistribute it subject to the terms and conditions
7* of the GNU General Public License v.2.
8*/
David Teiglandb3b94fa2006-01-16 16:50:04 +00009
10#ifndef __GFS2_ONDISK_DOT_H__
11#define __GFS2_ONDISK_DOT_H__
12
13#define GFS2_MAGIC 0x01161970
14#define GFS2_BASIC_BLOCK 512
15#define GFS2_BASIC_BLOCK_SHIFT 9
16
17/* Lock numbers of the LM_TYPE_NONDISK type */
18
19#define GFS2_MOUNT_LOCK 0
20#define GFS2_LIVE_LOCK 1
21#define GFS2_TRANS_LOCK 2
22#define GFS2_RENAME_LOCK 3
23
24/* Format numbers for various metadata types */
25
26#define GFS2_FORMAT_NONE 0
27#define GFS2_FORMAT_SB 100
28#define GFS2_FORMAT_RG 200
29#define GFS2_FORMAT_RB 300
30#define GFS2_FORMAT_DI 400
31#define GFS2_FORMAT_IN 500
32#define GFS2_FORMAT_LF 600
33#define GFS2_FORMAT_JD 700
34#define GFS2_FORMAT_LH 800
35#define GFS2_FORMAT_LD 900
36#define GFS2_FORMAT_LB 1000
Steven Whitehousefc69d0d2006-02-13 16:21:47 +000037#define GFS2_FORMAT_EA 1600
38#define GFS2_FORMAT_ED 1700
David Teiglandb3b94fa2006-01-16 16:50:04 +000039#define GFS2_FORMAT_UT 1300
40#define GFS2_FORMAT_QC 1400
41/* These are format numbers for entities contained in files */
Steven Whitehousefc69d0d2006-02-13 16:21:47 +000042#define GFS2_FORMAT_RI 1100
43#define GFS2_FORMAT_DE 1200
44#define GFS2_FORMAT_QU 1500
David Teiglandb3b94fa2006-01-16 16:50:04 +000045/* These are part of the superblock */
46#define GFS2_FORMAT_FS 1801
47#define GFS2_FORMAT_MULTI 1900
48
49/*
50 * An on-disk inode number
51 */
52
53#define gfs2_inum_equal(ino1, ino2) \
54 (((ino1)->no_formal_ino == (ino2)->no_formal_ino) && \
55 ((ino1)->no_addr == (ino2)->no_addr))
56
57struct gfs2_inum {
58 __be64 no_formal_ino;
59 __be64 no_addr;
60};
61
62/*
63 * Generic metadata head structure
64 * Every inplace buffer logged in the journal must start with this.
65 */
66
67#define GFS2_METATYPE_NONE 0
68#define GFS2_METATYPE_SB 1
69#define GFS2_METATYPE_RG 2
70#define GFS2_METATYPE_RB 3
71#define GFS2_METATYPE_DI 4
72#define GFS2_METATYPE_IN 5
73#define GFS2_METATYPE_LF 6
74#define GFS2_METATYPE_JD 7
75#define GFS2_METATYPE_LH 8
76#define GFS2_METATYPE_LD 9
Steven Whitehousefc69d0d2006-02-13 16:21:47 +000077#define GFS2_METATYPE_LB 12
78#define GFS2_METATYPE_EA 10
79#define GFS2_METATYPE_ED 11
David Teiglandb3b94fa2006-01-16 16:50:04 +000080#define GFS2_METATYPE_UT 13
81#define GFS2_METATYPE_QC 14
82
83struct gfs2_meta_header {
84 __be32 mh_magic;
85 __be32 mh_type;
86 __be64 __pad0; /* Was generation number in gfs1 */
87 __be32 mh_format;
88 __be32 __pad1; /* Was incarnation number in gfs1 */
89};
90
91/*
92 * super-block structure
93 *
94 * It's probably good if SIZEOF_SB <= GFS2_BASIC_BLOCK (512 bytes)
95 *
96 * Order is important, need to be able to read old superblocks to do on-disk
97 * version upgrades.
98 */
99
100/* Address of superblock in GFS2 basic blocks */
101#define GFS2_SB_ADDR 128
102
103/* The lock number for the superblock (must be zero) */
104#define GFS2_SB_LOCK 0
105
106/* Requirement: GFS2_LOCKNAME_LEN % 8 == 0
107 Includes: the fencing zero at the end */
108#define GFS2_LOCKNAME_LEN 64
109
110struct gfs2_sb {
111 struct gfs2_meta_header sb_header;
112
113 __be32 sb_fs_format;
114 __be32 sb_multihost_format;
115 __u32 __pad0; /* Was superblock flags in gfs1 */
116
117 __be32 sb_bsize;
118 __be32 sb_bsize_shift;
119 __u32 __pad1; /* Was journal segment size in gfs1 */
120
121 struct gfs2_inum sb_master_dir; /* Was jindex dinode in gfs1 */
122 struct gfs2_inum __pad2; /* Was rindex dinode in gfs1 */
123 struct gfs2_inum sb_root_dir;
124
125 char sb_lockproto[GFS2_LOCKNAME_LEN];
126 char sb_locktable[GFS2_LOCKNAME_LEN];
127 /* In gfs1, quota and license dinodes followed */
128};
129
130/*
131 * resource index structure
132 */
133
134struct gfs2_rindex {
135 __be64 ri_addr; /* grp block disk address */
136 __be32 ri_length; /* length of rgrp header in fs blocks */
137 __u32 __pad;
138
139 __be64 ri_data0; /* first data location */
140 __be32 ri_data; /* num of data blocks in rgrp */
141
142 __be32 ri_bitbytes; /* number of bytes in data bitmaps */
143
144 __u8 ri_reserved[64];
145};
146
147/*
148 * resource group header structure
149 */
150
151/* Number of blocks per byte in rgrp */
152#define GFS2_NBBY 4
153#define GFS2_BIT_SIZE 2
154#define GFS2_BIT_MASK 0x00000003
155
156#define GFS2_BLKST_FREE 0
157#define GFS2_BLKST_USED 1
158#define GFS2_BLKST_INVALID 2
159#define GFS2_BLKST_DINODE 3
160
161#define GFS2_RGF_JOURNAL 0x00000001
162#define GFS2_RGF_METAONLY 0x00000002
163#define GFS2_RGF_DATAONLY 0x00000004
164#define GFS2_RGF_NOALLOC 0x00000008
165
166struct gfs2_rgrp {
167 struct gfs2_meta_header rg_header;
168
169 __be32 rg_flags;
170 __be32 rg_free;
171 __be32 rg_dinodes;
172
173 __u8 rg_reserved[92]; /* Several fields from gfs1 now reserved */
174};
175
176/*
177 * quota structure
178 */
179
180struct gfs2_quota {
181 __be64 qu_limit;
182 __be64 qu_warn;
183 __be64 qu_value;
Steven Whitehousefc69d0d2006-02-13 16:21:47 +0000184 __u8 qu_reserved[64];
David Teiglandb3b94fa2006-01-16 16:50:04 +0000185};
186
187/*
188 * dinode structure
189 */
190
191#define GFS2_MAX_META_HEIGHT 10
192#define GFS2_DIR_MAX_DEPTH 17
193
194#define DT2IF(dt) (((dt) << 12) & S_IFMT)
195#define IF2DT(sif) (((sif) & S_IFMT) >> 12)
196
197/* Dinode flags */
198#define GFS2_DIF_JDATA 0x00000001
199#define GFS2_DIF_EXHASH 0x00000002
200#define GFS2_DIF_UNUSED 0x00000004 /* only in gfs1 */
201#define GFS2_DIF_EA_INDIRECT 0x00000008
202#define GFS2_DIF_DIRECTIO 0x00000010
203#define GFS2_DIF_IMMUTABLE 0x00000020
204#define GFS2_DIF_APPENDONLY 0x00000040
205#define GFS2_DIF_NOATIME 0x00000080
206#define GFS2_DIF_SYNC 0x00000100
207#define GFS2_DIF_SYSTEM 0x00000200 /* New in gfs2 */
208#define GFS2_DIF_TRUNC_IN_PROG 0x20000000 /* New in gfs2 */
209#define GFS2_DIF_INHERIT_DIRECTIO 0x40000000
210#define GFS2_DIF_INHERIT_JDATA 0x80000000
211
212struct gfs2_dinode {
213 struct gfs2_meta_header di_header;
214
215 struct gfs2_inum di_num;
216
217 __be32 di_mode; /* mode of file */
218 __be32 di_uid; /* owner's user id */
219 __be32 di_gid; /* owner's group id */
220 __be32 di_nlink; /* number of links to this file */
221 __be64 di_size; /* number of bytes in file */
222 __be64 di_blocks; /* number of blocks in file */
223 __be64 di_atime; /* time last accessed */
224 __be64 di_mtime; /* time last modified */
225 __be64 di_ctime; /* time last changed */
226 __be32 di_major; /* device major number */
227 __be32 di_minor; /* device minor number */
228
229 /* This section varies from gfs1. Padding added to align with
230 * remainder of dinode
231 */
232 __be64 di_goal_meta; /* rgrp to alloc from next */
233 __be64 di_goal_data; /* data block goal */
234 __u32 __pad[2];
235
236 __be32 di_flags; /* GFS2_DIF_... */
237 __be32 di_payload_format; /* GFS2_FORMAT_... */
238 __u16 __pad1; /* Was ditype in gfs1 */
239 __be16 di_height; /* height of metadata */
240 __u32 __pad2; /* Unused incarnation number from gfs1 */
241
242 /* These only apply to directories */
243 __u16 __pad3; /* Padding */
244 __be16 di_depth; /* Number of bits in the table */
245 __be32 di_entries; /* The number of entries in the directory */
246
247 struct gfs2_inum __pad4; /* Unused even in current gfs1 */
248
249 __be64 di_eattr; /* extended attribute block number */
250
251 __u8 di_reserved[56];
252};
253
254/*
255 * directory structure - many of these per directory file
256 */
257
258#define GFS2_FNAMESIZE 255
259#define GFS2_DIRENT_SIZE(name_len) ((sizeof(struct gfs2_dirent) + (name_len) + 7) & ~7)
260
261struct gfs2_dirent {
262 struct gfs2_inum de_inum;
263 __be32 de_hash;
Steven Whitehousefc69d0d2006-02-13 16:21:47 +0000264 __be16 de_rec_len;
265 __be16 de_name_len;
266 __be16 de_type;
267 __u8 __pad[14];
David Teiglandb3b94fa2006-01-16 16:50:04 +0000268};
269
270/*
271 * Header of leaf directory nodes
272 */
273
274struct gfs2_leaf {
275 struct gfs2_meta_header lf_header;
276
277 __be16 lf_depth; /* Depth of leaf */
278 __be16 lf_entries; /* Number of dirents in leaf */
279 __be32 lf_dirent_format; /* Format of the dirents */
280 __be64 lf_next; /* Next leaf, if overflow */
281
Steven Whitehousefc69d0d2006-02-13 16:21:47 +0000282 __u8 lf_reserved[64];
David Teiglandb3b94fa2006-01-16 16:50:04 +0000283};
284
285/*
286 * Extended attribute header format
287 */
288
289#define GFS2_EA_MAX_NAME_LEN 255
290#define GFS2_EA_MAX_DATA_LEN 65536
291
292#define GFS2_EATYPE_UNUSED 0
293#define GFS2_EATYPE_USR 1
294#define GFS2_EATYPE_SYS 2
295
296#define GFS2_EATYPE_LAST 2
297#define GFS2_EATYPE_VALID(x) ((x) <= GFS2_EATYPE_LAST)
298
299#define GFS2_EAFLAG_LAST 0x01 /* last ea in block */
300
301struct gfs2_ea_header {
302 __be32 ea_rec_len;
303 __be32 ea_data_len;
304 __u8 ea_name_len; /* no NULL pointer after the string */
305 __u8 ea_type; /* GFS2_EATYPE_... */
306 __u8 ea_flags; /* GFS2_EAFLAG_... */
307 __u8 ea_num_ptrs;
308 __u32 __pad;
309};
310
311/*
312 * Log header structure
313 */
314
315#define GFS2_LOG_HEAD_UNMOUNT 0x00000001 /* log is clean */
316
317struct gfs2_log_header {
318 struct gfs2_meta_header lh_header;
319
320 __be64 lh_sequence; /* Sequence number of this transaction */
321 __be32 lh_flags; /* GFS2_LOG_HEAD_... */
322 __be32 lh_tail; /* Block number of log tail */
323 __be32 lh_blkno;
324 __be32 lh_hash;
325};
326
327/*
328 * Log type descriptor
329 */
330
331#define GFS2_LOG_DESC_METADATA 300
332/* ld_data1 is the number of metadata blocks in the descriptor.
333 ld_data2 is unused. */
334
335#define GFS2_LOG_DESC_REVOKE 301
336/* ld_data1 is the number of revoke blocks in the descriptor.
337 ld_data2 is unused. */
338
Steven Whitehouse18ec7d52006-02-08 11:50:51 +0000339#define GFS2_LOG_DESC_JDATA 302
340/* ld_data1 is the number of data blocks in the descriptor.
341 ld_data2 is unused. */
342
David Teiglandb3b94fa2006-01-16 16:50:04 +0000343struct gfs2_log_descriptor {
344 struct gfs2_meta_header ld_header;
345
346 __be32 ld_type; /* GFS2_LOG_DESC_... */
347 __be32 ld_length; /* Number of buffers in this chunk */
348 __be32 ld_data1; /* descriptor-specific field */
349 __be32 ld_data2; /* descriptor-specific field */
350
351 __u8 ld_reserved[32];
352};
353
354/*
355 * Inum Range
356 * Describe a range of formal inode numbers allocated to
357 * one machine to assign to inodes.
358 */
359
360#define GFS2_INUM_QUANTUM 1048576
361
362struct gfs2_inum_range {
363 __be64 ir_start;
364 __be64 ir_length;
365};
366
367/*
368 * Statfs change
369 * Describes an change to the pool of free and allocated
370 * blocks.
371 */
372
373struct gfs2_statfs_change {
374 __be64 sc_total;
375 __be64 sc_free;
376 __be64 sc_dinodes;
377};
378
379/*
380 * Unlinked Tag
381 * Describes an allocated inode that isn't linked into
382 * the directory tree and might need to be deallocated.
383 */
384
385#define GFS2_UTF_UNINIT 0x00000001
386
387struct gfs2_unlinked_tag {
388 struct gfs2_inum ut_inum;
389 __be32 ut_flags; /* GFS2_UTF_... */
390 __u32 __pad;
391};
392
393/*
394 * Quota change
395 * Describes an allocation change for a particular
396 * user or group.
397 */
398
399#define GFS2_QCF_USER 0x00000001
400
401struct gfs2_quota_change {
402 __be64 qc_change;
403 __be32 qc_flags; /* GFS2_QCF_... */
404 __be32 qc_id;
405};
406
Steven Whitehouse18ec7d52006-02-08 11:50:51 +0000407#ifdef __KERNEL__
David Teiglandb3b94fa2006-01-16 16:50:04 +0000408/* Translation functions */
409
410extern void gfs2_inum_in(struct gfs2_inum *no, char *buf);
411extern void gfs2_inum_out(struct gfs2_inum *no, char *buf);
David Teiglandb3b94fa2006-01-16 16:50:04 +0000412extern void gfs2_sb_in(struct gfs2_sb *sb, char *buf);
David Teiglandb3b94fa2006-01-16 16:50:04 +0000413extern void gfs2_rindex_in(struct gfs2_rindex *ri, char *buf);
414extern void gfs2_rindex_out(struct gfs2_rindex *ri, char *buf);
415extern void gfs2_rgrp_in(struct gfs2_rgrp *rg, char *buf);
416extern void gfs2_rgrp_out(struct gfs2_rgrp *rg, char *buf);
417extern void gfs2_quota_in(struct gfs2_quota *qu, char *buf);
418extern void gfs2_quota_out(struct gfs2_quota *qu, char *buf);
419extern void gfs2_dinode_in(struct gfs2_dinode *di, char *buf);
420extern void gfs2_dinode_out(struct gfs2_dinode *di, char *buf);
David Teiglandb3b94fa2006-01-16 16:50:04 +0000421extern void gfs2_leaf_in(struct gfs2_leaf *lf, char *buf);
David Teiglandb3b94fa2006-01-16 16:50:04 +0000422extern void gfs2_ea_header_in(struct gfs2_ea_header *ea, char *buf);
423extern void gfs2_ea_header_out(struct gfs2_ea_header *ea, char *buf);
424extern void gfs2_log_header_in(struct gfs2_log_header *lh, char *buf);
425extern void gfs2_inum_range_in(struct gfs2_inum_range *ir, char *buf);
426extern void gfs2_inum_range_out(struct gfs2_inum_range *ir, char *buf);
427extern void gfs2_statfs_change_in(struct gfs2_statfs_change *sc, char *buf);
428extern void gfs2_statfs_change_out(struct gfs2_statfs_change *sc, char *buf);
429extern void gfs2_unlinked_tag_in(struct gfs2_unlinked_tag *ut, char *buf);
430extern void gfs2_unlinked_tag_out(struct gfs2_unlinked_tag *ut, char *buf);
431extern void gfs2_quota_change_in(struct gfs2_quota_change *qc, char *buf);
David Teiglandb3b94fa2006-01-16 16:50:04 +0000432
433/* Printing functions */
434
435extern void gfs2_inum_print(struct gfs2_inum *no);
436extern void gfs2_meta_header_print(struct gfs2_meta_header *mh);
437extern void gfs2_sb_print(struct gfs2_sb *sb);
438extern void gfs2_rindex_print(struct gfs2_rindex *ri);
439extern void gfs2_rgrp_print(struct gfs2_rgrp *rg);
440extern void gfs2_quota_print(struct gfs2_quota *qu);
441extern void gfs2_dinode_print(struct gfs2_dinode *di);
442extern void gfs2_dirent_print(struct gfs2_dirent *de, char *name);
443extern void gfs2_leaf_print(struct gfs2_leaf *lf);
444extern void gfs2_ea_header_print(struct gfs2_ea_header *ea, char *name);
445extern void gfs2_log_header_print(struct gfs2_log_header *lh);
446extern void gfs2_log_descriptor_print(struct gfs2_log_descriptor *ld);
447extern void gfs2_inum_range_print(struct gfs2_inum_range *ir);
448extern void gfs2_statfs_change_print(struct gfs2_statfs_change *sc);
449extern void gfs2_unlinked_tag_print(struct gfs2_unlinked_tag *ut);
450extern void gfs2_quota_change_print(struct gfs2_quota_change *qc);
451
Steven Whitehouse18ec7d52006-02-08 11:50:51 +0000452#endif /* __KERNEL__ */
453
David Teiglandb3b94fa2006-01-16 16:50:04 +0000454#endif /* __GFS2_ONDISK_DOT_H__ */