xfs_log_format.h 30 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856
  1. /*
  2. * Copyright (c) 2000-2003,2005 Silicon Graphics, Inc.
  3. * All Rights Reserved.
  4. *
  5. * This program is free software; you can redistribute it and/or
  6. * modify it under the terms of the GNU General Public License as
  7. * published by the Free Software Foundation.
  8. *
  9. * This program is distributed in the hope that it would be useful,
  10. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  12. * GNU General Public License for more details.
  13. *
  14. * You should have received a copy of the GNU General Public License
  15. * along with this program; if not, write the Free Software Foundation,
  16. * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
  17. */
  18. #ifndef __XFS_LOG_FORMAT_H__
  19. #define __XFS_LOG_FORMAT_H__
  20. struct xfs_mount;
  21. struct xfs_trans_res;
  22. /*
  23. * On-disk Log Format definitions.
  24. *
  25. * This file contains all the on-disk format definitions used within the log. It
  26. * includes the physical log structure itself, as well as all the log item
  27. * format structures that are written into the log and intepreted by log
  28. * recovery. We start with the physical log format definitions, and then work
  29. * through all the log items definitions and everything they encode into the
  30. * log.
  31. */
  32. typedef __uint32_t xlog_tid_t;
  33. #define XLOG_MIN_ICLOGS 2
  34. #define XLOG_MAX_ICLOGS 8
  35. #define XLOG_HEADER_MAGIC_NUM 0xFEEDbabe /* Invalid cycle number */
  36. #define XLOG_VERSION_1 1
  37. #define XLOG_VERSION_2 2 /* Large IClogs, Log sunit */
  38. #define XLOG_VERSION_OKBITS (XLOG_VERSION_1 | XLOG_VERSION_2)
  39. #define XLOG_MIN_RECORD_BSIZE (16*1024) /* eventually 32k */
  40. #define XLOG_BIG_RECORD_BSIZE (32*1024) /* 32k buffers */
  41. #define XLOG_MAX_RECORD_BSIZE (256*1024)
  42. #define XLOG_HEADER_CYCLE_SIZE (32*1024) /* cycle data in header */
  43. #define XLOG_MIN_RECORD_BSHIFT 14 /* 16384 == 1 << 14 */
  44. #define XLOG_BIG_RECORD_BSHIFT 15 /* 32k == 1 << 15 */
  45. #define XLOG_MAX_RECORD_BSHIFT 18 /* 256k == 1 << 18 */
  46. #define XLOG_BTOLSUNIT(log, b) (((b)+(log)->l_mp->m_sb.sb_logsunit-1) / \
  47. (log)->l_mp->m_sb.sb_logsunit)
  48. #define XLOG_LSUNITTOB(log, su) ((su) * (log)->l_mp->m_sb.sb_logsunit)
  49. #define XLOG_HEADER_SIZE 512
  50. /* Minimum number of transactions that must fit in the log (defined by mkfs) */
  51. #define XFS_MIN_LOG_FACTOR 3
  52. #define XLOG_REC_SHIFT(log) \
  53. BTOBB(1 << (xfs_sb_version_haslogv2(&log->l_mp->m_sb) ? \
  54. XLOG_MAX_RECORD_BSHIFT : XLOG_BIG_RECORD_BSHIFT))
  55. #define XLOG_TOTAL_REC_SHIFT(log) \
  56. BTOBB(XLOG_MAX_ICLOGS << (xfs_sb_version_haslogv2(&log->l_mp->m_sb) ? \
  57. XLOG_MAX_RECORD_BSHIFT : XLOG_BIG_RECORD_BSHIFT))
  58. /* get lsn fields */
  59. #define CYCLE_LSN(lsn) ((uint)((lsn)>>32))
  60. #define BLOCK_LSN(lsn) ((uint)(lsn))
  61. /* this is used in a spot where we might otherwise double-endian-flip */
  62. #define CYCLE_LSN_DISK(lsn) (((__be32 *)&(lsn))[0])
  63. static inline xfs_lsn_t xlog_assign_lsn(uint cycle, uint block)
  64. {
  65. return ((xfs_lsn_t)cycle << 32) | block;
  66. }
  67. static inline uint xlog_get_cycle(char *ptr)
  68. {
  69. if (be32_to_cpu(*(__be32 *)ptr) == XLOG_HEADER_MAGIC_NUM)
  70. return be32_to_cpu(*((__be32 *)ptr + 1));
  71. else
  72. return be32_to_cpu(*(__be32 *)ptr);
  73. }
  74. /* Log Clients */
  75. #define XFS_TRANSACTION 0x69
  76. #define XFS_VOLUME 0x2
  77. #define XFS_LOG 0xaa
  78. #define XLOG_UNMOUNT_TYPE 0x556e /* Un for Unmount */
  79. /* Region types for iovec's i_type */
  80. #define XLOG_REG_TYPE_BFORMAT 1
  81. #define XLOG_REG_TYPE_BCHUNK 2
  82. #define XLOG_REG_TYPE_EFI_FORMAT 3
  83. #define XLOG_REG_TYPE_EFD_FORMAT 4
  84. #define XLOG_REG_TYPE_IFORMAT 5
  85. #define XLOG_REG_TYPE_ICORE 6
  86. #define XLOG_REG_TYPE_IEXT 7
  87. #define XLOG_REG_TYPE_IBROOT 8
  88. #define XLOG_REG_TYPE_ILOCAL 9
  89. #define XLOG_REG_TYPE_IATTR_EXT 10
  90. #define XLOG_REG_TYPE_IATTR_BROOT 11
  91. #define XLOG_REG_TYPE_IATTR_LOCAL 12
  92. #define XLOG_REG_TYPE_QFORMAT 13
  93. #define XLOG_REG_TYPE_DQUOT 14
  94. #define XLOG_REG_TYPE_QUOTAOFF 15
  95. #define XLOG_REG_TYPE_LRHEADER 16
  96. #define XLOG_REG_TYPE_UNMOUNT 17
  97. #define XLOG_REG_TYPE_COMMIT 18
  98. #define XLOG_REG_TYPE_TRANSHDR 19
  99. #define XLOG_REG_TYPE_ICREATE 20
  100. #define XLOG_REG_TYPE_MAX 20
  101. /*
  102. * Flags to log operation header
  103. *
  104. * The first write of a new transaction will be preceded with a start
  105. * record, XLOG_START_TRANS. Once a transaction is committed, a commit
  106. * record is written, XLOG_COMMIT_TRANS. If a single region can not fit into
  107. * the remainder of the current active in-core log, it is split up into
  108. * multiple regions. Each partial region will be marked with a
  109. * XLOG_CONTINUE_TRANS until the last one, which gets marked with XLOG_END_TRANS.
  110. *
  111. */
  112. #define XLOG_START_TRANS 0x01 /* Start a new transaction */
  113. #define XLOG_COMMIT_TRANS 0x02 /* Commit this transaction */
  114. #define XLOG_CONTINUE_TRANS 0x04 /* Cont this trans into new region */
  115. #define XLOG_WAS_CONT_TRANS 0x08 /* Cont this trans into new region */
  116. #define XLOG_END_TRANS 0x10 /* End a continued transaction */
  117. #define XLOG_UNMOUNT_TRANS 0x20 /* Unmount a filesystem transaction */
  118. typedef struct xlog_op_header {
  119. __be32 oh_tid; /* transaction id of operation : 4 b */
  120. __be32 oh_len; /* bytes in data region : 4 b */
  121. __u8 oh_clientid; /* who sent me this : 1 b */
  122. __u8 oh_flags; /* : 1 b */
  123. __u16 oh_res2; /* 32 bit align : 2 b */
  124. } xlog_op_header_t;
  125. /* valid values for h_fmt */
  126. #define XLOG_FMT_UNKNOWN 0
  127. #define XLOG_FMT_LINUX_LE 1
  128. #define XLOG_FMT_LINUX_BE 2
  129. #define XLOG_FMT_IRIX_BE 3
  130. /* our fmt */
  131. #ifdef XFS_NATIVE_HOST
  132. #define XLOG_FMT XLOG_FMT_LINUX_BE
  133. #else
  134. #define XLOG_FMT XLOG_FMT_LINUX_LE
  135. #endif
  136. typedef struct xlog_rec_header {
  137. __be32 h_magicno; /* log record (LR) identifier : 4 */
  138. __be32 h_cycle; /* write cycle of log : 4 */
  139. __be32 h_version; /* LR version : 4 */
  140. __be32 h_len; /* len in bytes; should be 64-bit aligned: 4 */
  141. __be64 h_lsn; /* lsn of this LR : 8 */
  142. __be64 h_tail_lsn; /* lsn of 1st LR w/ buffers not committed: 8 */
  143. __le32 h_crc; /* crc of log record : 4 */
  144. __be32 h_prev_block; /* block number to previous LR : 4 */
  145. __be32 h_num_logops; /* number of log operations in this LR : 4 */
  146. __be32 h_cycle_data[XLOG_HEADER_CYCLE_SIZE / BBSIZE];
  147. /* new fields */
  148. __be32 h_fmt; /* format of log record : 4 */
  149. uuid_t h_fs_uuid; /* uuid of FS : 16 */
  150. __be32 h_size; /* iclog size : 4 */
  151. } xlog_rec_header_t;
  152. typedef struct xlog_rec_ext_header {
  153. __be32 xh_cycle; /* write cycle of log : 4 */
  154. __be32 xh_cycle_data[XLOG_HEADER_CYCLE_SIZE / BBSIZE]; /* : 256 */
  155. } xlog_rec_ext_header_t;
  156. /*
  157. * Quite misnamed, because this union lays out the actual on-disk log buffer.
  158. */
  159. typedef union xlog_in_core2 {
  160. xlog_rec_header_t hic_header;
  161. xlog_rec_ext_header_t hic_xheader;
  162. char hic_sector[XLOG_HEADER_SIZE];
  163. } xlog_in_core_2_t;
  164. /* not an on-disk structure, but needed by log recovery in userspace */
  165. typedef struct xfs_log_iovec {
  166. void *i_addr; /* beginning address of region */
  167. int i_len; /* length in bytes of region */
  168. uint i_type; /* type of region */
  169. } xfs_log_iovec_t;
  170. /*
  171. * Transaction Header definitions.
  172. *
  173. * This is the structure written in the log at the head of every transaction. It
  174. * identifies the type and id of the transaction, and contains the number of
  175. * items logged by the transaction so we know how many to expect during
  176. * recovery.
  177. *
  178. * Do not change the below structure without redoing the code in
  179. * xlog_recover_add_to_trans() and xlog_recover_add_to_cont_trans().
  180. */
  181. typedef struct xfs_trans_header {
  182. uint th_magic; /* magic number */
  183. uint th_type; /* transaction type */
  184. __int32_t th_tid; /* transaction id (unused) */
  185. uint th_num_items; /* num items logged by trans */
  186. } xfs_trans_header_t;
  187. #define XFS_TRANS_HEADER_MAGIC 0x5452414e /* TRAN */
  188. /*
  189. * Log item types.
  190. */
  191. #define XFS_LI_EFI 0x1236
  192. #define XFS_LI_EFD 0x1237
  193. #define XFS_LI_IUNLINK 0x1238
  194. #define XFS_LI_INODE 0x123b /* aligned ino chunks, var-size ibufs */
  195. #define XFS_LI_BUF 0x123c /* v2 bufs, variable sized inode bufs */
  196. #define XFS_LI_DQUOT 0x123d
  197. #define XFS_LI_QUOTAOFF 0x123e
  198. #define XFS_LI_ICREATE 0x123f
  199. #define XFS_LI_TYPE_DESC \
  200. { XFS_LI_EFI, "XFS_LI_EFI" }, \
  201. { XFS_LI_EFD, "XFS_LI_EFD" }, \
  202. { XFS_LI_IUNLINK, "XFS_LI_IUNLINK" }, \
  203. { XFS_LI_INODE, "XFS_LI_INODE" }, \
  204. { XFS_LI_BUF, "XFS_LI_BUF" }, \
  205. { XFS_LI_DQUOT, "XFS_LI_DQUOT" }, \
  206. { XFS_LI_QUOTAOFF, "XFS_LI_QUOTAOFF" }, \
  207. { XFS_LI_ICREATE, "XFS_LI_ICREATE" }
  208. /*
  209. * Transaction types. Used to distinguish types of buffers.
  210. */
  211. #define XFS_TRANS_SETATTR_NOT_SIZE 1
  212. #define XFS_TRANS_SETATTR_SIZE 2
  213. #define XFS_TRANS_INACTIVE 3
  214. #define XFS_TRANS_CREATE 4
  215. #define XFS_TRANS_CREATE_TRUNC 5
  216. #define XFS_TRANS_TRUNCATE_FILE 6
  217. #define XFS_TRANS_REMOVE 7
  218. #define XFS_TRANS_LINK 8
  219. #define XFS_TRANS_RENAME 9
  220. #define XFS_TRANS_MKDIR 10
  221. #define XFS_TRANS_RMDIR 11
  222. #define XFS_TRANS_SYMLINK 12
  223. #define XFS_TRANS_SET_DMATTRS 13
  224. #define XFS_TRANS_GROWFS 14
  225. #define XFS_TRANS_STRAT_WRITE 15
  226. #define XFS_TRANS_DIOSTRAT 16
  227. /* 17 was XFS_TRANS_WRITE_SYNC */
  228. #define XFS_TRANS_WRITEID 18
  229. #define XFS_TRANS_ADDAFORK 19
  230. #define XFS_TRANS_ATTRINVAL 20
  231. #define XFS_TRANS_ATRUNCATE 21
  232. #define XFS_TRANS_ATTR_SET 22
  233. #define XFS_TRANS_ATTR_RM 23
  234. #define XFS_TRANS_ATTR_FLAG 24
  235. #define XFS_TRANS_CLEAR_AGI_BUCKET 25
  236. #define XFS_TRANS_QM_SBCHANGE 26
  237. /*
  238. * Dummy entries since we use the transaction type to index into the
  239. * trans_type[] in xlog_recover_print_trans_head()
  240. */
  241. #define XFS_TRANS_DUMMY1 27
  242. #define XFS_TRANS_DUMMY2 28
  243. #define XFS_TRANS_QM_QUOTAOFF 29
  244. #define XFS_TRANS_QM_DQALLOC 30
  245. #define XFS_TRANS_QM_SETQLIM 31
  246. #define XFS_TRANS_QM_DQCLUSTER 32
  247. #define XFS_TRANS_QM_QINOCREATE 33
  248. #define XFS_TRANS_QM_QUOTAOFF_END 34
  249. #define XFS_TRANS_SB_UNIT 35
  250. #define XFS_TRANS_FSYNC_TS 36
  251. #define XFS_TRANS_GROWFSRT_ALLOC 37
  252. #define XFS_TRANS_GROWFSRT_ZERO 38
  253. #define XFS_TRANS_GROWFSRT_FREE 39
  254. #define XFS_TRANS_SWAPEXT 40
  255. #define XFS_TRANS_SB_COUNT 41
  256. #define XFS_TRANS_CHECKPOINT 42
  257. #define XFS_TRANS_ICREATE 43
  258. #define XFS_TRANS_TYPE_MAX 43
  259. /* new transaction types need to be reflected in xfs_logprint(8) */
  260. #define XFS_TRANS_TYPES \
  261. { XFS_TRANS_SETATTR_NOT_SIZE, "SETATTR_NOT_SIZE" }, \
  262. { XFS_TRANS_SETATTR_SIZE, "SETATTR_SIZE" }, \
  263. { XFS_TRANS_INACTIVE, "INACTIVE" }, \
  264. { XFS_TRANS_CREATE, "CREATE" }, \
  265. { XFS_TRANS_CREATE_TRUNC, "CREATE_TRUNC" }, \
  266. { XFS_TRANS_TRUNCATE_FILE, "TRUNCATE_FILE" }, \
  267. { XFS_TRANS_REMOVE, "REMOVE" }, \
  268. { XFS_TRANS_LINK, "LINK" }, \
  269. { XFS_TRANS_RENAME, "RENAME" }, \
  270. { XFS_TRANS_MKDIR, "MKDIR" }, \
  271. { XFS_TRANS_RMDIR, "RMDIR" }, \
  272. { XFS_TRANS_SYMLINK, "SYMLINK" }, \
  273. { XFS_TRANS_SET_DMATTRS, "SET_DMATTRS" }, \
  274. { XFS_TRANS_GROWFS, "GROWFS" }, \
  275. { XFS_TRANS_STRAT_WRITE, "STRAT_WRITE" }, \
  276. { XFS_TRANS_DIOSTRAT, "DIOSTRAT" }, \
  277. { XFS_TRANS_WRITEID, "WRITEID" }, \
  278. { XFS_TRANS_ADDAFORK, "ADDAFORK" }, \
  279. { XFS_TRANS_ATTRINVAL, "ATTRINVAL" }, \
  280. { XFS_TRANS_ATRUNCATE, "ATRUNCATE" }, \
  281. { XFS_TRANS_ATTR_SET, "ATTR_SET" }, \
  282. { XFS_TRANS_ATTR_RM, "ATTR_RM" }, \
  283. { XFS_TRANS_ATTR_FLAG, "ATTR_FLAG" }, \
  284. { XFS_TRANS_CLEAR_AGI_BUCKET, "CLEAR_AGI_BUCKET" }, \
  285. { XFS_TRANS_QM_SBCHANGE, "QM_SBCHANGE" }, \
  286. { XFS_TRANS_QM_QUOTAOFF, "QM_QUOTAOFF" }, \
  287. { XFS_TRANS_QM_DQALLOC, "QM_DQALLOC" }, \
  288. { XFS_TRANS_QM_SETQLIM, "QM_SETQLIM" }, \
  289. { XFS_TRANS_QM_DQCLUSTER, "QM_DQCLUSTER" }, \
  290. { XFS_TRANS_QM_QINOCREATE, "QM_QINOCREATE" }, \
  291. { XFS_TRANS_QM_QUOTAOFF_END, "QM_QOFF_END" }, \
  292. { XFS_TRANS_SB_UNIT, "SB_UNIT" }, \
  293. { XFS_TRANS_FSYNC_TS, "FSYNC_TS" }, \
  294. { XFS_TRANS_GROWFSRT_ALLOC, "GROWFSRT_ALLOC" }, \
  295. { XFS_TRANS_GROWFSRT_ZERO, "GROWFSRT_ZERO" }, \
  296. { XFS_TRANS_GROWFSRT_FREE, "GROWFSRT_FREE" }, \
  297. { XFS_TRANS_SWAPEXT, "SWAPEXT" }, \
  298. { XFS_TRANS_SB_COUNT, "SB_COUNT" }, \
  299. { XFS_TRANS_CHECKPOINT, "CHECKPOINT" }, \
  300. { XFS_TRANS_DUMMY1, "DUMMY1" }, \
  301. { XFS_TRANS_DUMMY2, "DUMMY2" }, \
  302. { XLOG_UNMOUNT_REC_TYPE, "UNMOUNT" }
  303. /*
  304. * This structure is used to track log items associated with
  305. * a transaction. It points to the log item and keeps some
  306. * flags to track the state of the log item. It also tracks
  307. * the amount of space needed to log the item it describes
  308. * once we get to commit processing (see xfs_trans_commit()).
  309. */
  310. struct xfs_log_item_desc {
  311. struct xfs_log_item *lid_item;
  312. struct list_head lid_trans;
  313. unsigned char lid_flags;
  314. };
  315. #define XFS_LID_DIRTY 0x1
  316. /*
  317. * Values for t_flags.
  318. */
  319. #define XFS_TRANS_DIRTY 0x01 /* something needs to be logged */
  320. #define XFS_TRANS_SB_DIRTY 0x02 /* superblock is modified */
  321. #define XFS_TRANS_PERM_LOG_RES 0x04 /* xact took a permanent log res */
  322. #define XFS_TRANS_SYNC 0x08 /* make commit synchronous */
  323. #define XFS_TRANS_DQ_DIRTY 0x10 /* at least one dquot in trx dirty */
  324. #define XFS_TRANS_RESERVE 0x20 /* OK to use reserved data blocks */
  325. #define XFS_TRANS_FREEZE_PROT 0x40 /* Transaction has elevated writer
  326. count in superblock */
  327. /*
  328. * Values for call flags parameter.
  329. */
  330. #define XFS_TRANS_RELEASE_LOG_RES 0x4
  331. #define XFS_TRANS_ABORT 0x8
  332. /*
  333. * Field values for xfs_trans_mod_sb.
  334. */
  335. #define XFS_TRANS_SB_ICOUNT 0x00000001
  336. #define XFS_TRANS_SB_IFREE 0x00000002
  337. #define XFS_TRANS_SB_FDBLOCKS 0x00000004
  338. #define XFS_TRANS_SB_RES_FDBLOCKS 0x00000008
  339. #define XFS_TRANS_SB_FREXTENTS 0x00000010
  340. #define XFS_TRANS_SB_RES_FREXTENTS 0x00000020
  341. #define XFS_TRANS_SB_DBLOCKS 0x00000040
  342. #define XFS_TRANS_SB_AGCOUNT 0x00000080
  343. #define XFS_TRANS_SB_IMAXPCT 0x00000100
  344. #define XFS_TRANS_SB_REXTSIZE 0x00000200
  345. #define XFS_TRANS_SB_RBMBLOCKS 0x00000400
  346. #define XFS_TRANS_SB_RBLOCKS 0x00000800
  347. #define XFS_TRANS_SB_REXTENTS 0x00001000
  348. #define XFS_TRANS_SB_REXTSLOG 0x00002000
  349. /*
  350. * Here we centralize the specification of XFS meta-data buffer
  351. * reference count values. This determine how hard the buffer
  352. * cache tries to hold onto the buffer.
  353. */
  354. #define XFS_AGF_REF 4
  355. #define XFS_AGI_REF 4
  356. #define XFS_AGFL_REF 3
  357. #define XFS_INO_BTREE_REF 3
  358. #define XFS_ALLOC_BTREE_REF 2
  359. #define XFS_BMAP_BTREE_REF 2
  360. #define XFS_DIR_BTREE_REF 2
  361. #define XFS_INO_REF 2
  362. #define XFS_ATTR_BTREE_REF 1
  363. #define XFS_DQUOT_REF 1
  364. /*
  365. * Flags for xfs_trans_ichgtime().
  366. */
  367. #define XFS_ICHGTIME_MOD 0x1 /* data fork modification timestamp */
  368. #define XFS_ICHGTIME_CHG 0x2 /* inode field change timestamp */
  369. #define XFS_ICHGTIME_CREATE 0x4 /* inode create timestamp */
  370. /*
  371. * Inode Log Item Format definitions.
  372. *
  373. * This is the structure used to lay out an inode log item in the
  374. * log. The size of the inline data/extents/b-tree root to be logged
  375. * (if any) is indicated in the ilf_dsize field. Changes to this structure
  376. * must be added on to the end.
  377. */
  378. typedef struct xfs_inode_log_format {
  379. __uint16_t ilf_type; /* inode log item type */
  380. __uint16_t ilf_size; /* size of this item */
  381. __uint32_t ilf_fields; /* flags for fields logged */
  382. __uint16_t ilf_asize; /* size of attr d/ext/root */
  383. __uint16_t ilf_dsize; /* size of data/ext/root */
  384. __uint64_t ilf_ino; /* inode number */
  385. union {
  386. __uint32_t ilfu_rdev; /* rdev value for dev inode*/
  387. uuid_t ilfu_uuid; /* mount point value */
  388. } ilf_u;
  389. __int64_t ilf_blkno; /* blkno of inode buffer */
  390. __int32_t ilf_len; /* len of inode buffer */
  391. __int32_t ilf_boffset; /* off of inode in buffer */
  392. } xfs_inode_log_format_t;
  393. typedef struct xfs_inode_log_format_32 {
  394. __uint16_t ilf_type; /* inode log item type */
  395. __uint16_t ilf_size; /* size of this item */
  396. __uint32_t ilf_fields; /* flags for fields logged */
  397. __uint16_t ilf_asize; /* size of attr d/ext/root */
  398. __uint16_t ilf_dsize; /* size of data/ext/root */
  399. __uint64_t ilf_ino; /* inode number */
  400. union {
  401. __uint32_t ilfu_rdev; /* rdev value for dev inode*/
  402. uuid_t ilfu_uuid; /* mount point value */
  403. } ilf_u;
  404. __int64_t ilf_blkno; /* blkno of inode buffer */
  405. __int32_t ilf_len; /* len of inode buffer */
  406. __int32_t ilf_boffset; /* off of inode in buffer */
  407. } __attribute__((packed)) xfs_inode_log_format_32_t;
  408. typedef struct xfs_inode_log_format_64 {
  409. __uint16_t ilf_type; /* inode log item type */
  410. __uint16_t ilf_size; /* size of this item */
  411. __uint32_t ilf_fields; /* flags for fields logged */
  412. __uint16_t ilf_asize; /* size of attr d/ext/root */
  413. __uint16_t ilf_dsize; /* size of data/ext/root */
  414. __uint32_t ilf_pad; /* pad for 64 bit boundary */
  415. __uint64_t ilf_ino; /* inode number */
  416. union {
  417. __uint32_t ilfu_rdev; /* rdev value for dev inode*/
  418. uuid_t ilfu_uuid; /* mount point value */
  419. } ilf_u;
  420. __int64_t ilf_blkno; /* blkno of inode buffer */
  421. __int32_t ilf_len; /* len of inode buffer */
  422. __int32_t ilf_boffset; /* off of inode in buffer */
  423. } xfs_inode_log_format_64_t;
  424. /*
  425. * Flags for xfs_trans_log_inode flags field.
  426. */
  427. #define XFS_ILOG_CORE 0x001 /* log standard inode fields */
  428. #define XFS_ILOG_DDATA 0x002 /* log i_df.if_data */
  429. #define XFS_ILOG_DEXT 0x004 /* log i_df.if_extents */
  430. #define XFS_ILOG_DBROOT 0x008 /* log i_df.i_broot */
  431. #define XFS_ILOG_DEV 0x010 /* log the dev field */
  432. #define XFS_ILOG_UUID 0x020 /* log the uuid field */
  433. #define XFS_ILOG_ADATA 0x040 /* log i_af.if_data */
  434. #define XFS_ILOG_AEXT 0x080 /* log i_af.if_extents */
  435. #define XFS_ILOG_ABROOT 0x100 /* log i_af.i_broot */
  436. #define XFS_ILOG_DOWNER 0x200 /* change the data fork owner on replay */
  437. #define XFS_ILOG_AOWNER 0x400 /* change the attr fork owner on replay */
  438. /*
  439. * The timestamps are dirty, but not necessarily anything else in the inode
  440. * core. Unlike the other fields above this one must never make it to disk
  441. * in the ilf_fields of the inode_log_format, but is purely store in-memory in
  442. * ili_fields in the inode_log_item.
  443. */
  444. #define XFS_ILOG_TIMESTAMP 0x4000
  445. #define XFS_ILOG_NONCORE (XFS_ILOG_DDATA | XFS_ILOG_DEXT | \
  446. XFS_ILOG_DBROOT | XFS_ILOG_DEV | \
  447. XFS_ILOG_UUID | XFS_ILOG_ADATA | \
  448. XFS_ILOG_AEXT | XFS_ILOG_ABROOT | \
  449. XFS_ILOG_DOWNER | XFS_ILOG_AOWNER)
  450. #define XFS_ILOG_DFORK (XFS_ILOG_DDATA | XFS_ILOG_DEXT | \
  451. XFS_ILOG_DBROOT)
  452. #define XFS_ILOG_AFORK (XFS_ILOG_ADATA | XFS_ILOG_AEXT | \
  453. XFS_ILOG_ABROOT)
  454. #define XFS_ILOG_ALL (XFS_ILOG_CORE | XFS_ILOG_DDATA | \
  455. XFS_ILOG_DEXT | XFS_ILOG_DBROOT | \
  456. XFS_ILOG_DEV | XFS_ILOG_UUID | \
  457. XFS_ILOG_ADATA | XFS_ILOG_AEXT | \
  458. XFS_ILOG_ABROOT | XFS_ILOG_TIMESTAMP | \
  459. XFS_ILOG_DOWNER | XFS_ILOG_AOWNER)
  460. static inline int xfs_ilog_fbroot(int w)
  461. {
  462. return (w == XFS_DATA_FORK ? XFS_ILOG_DBROOT : XFS_ILOG_ABROOT);
  463. }
  464. static inline int xfs_ilog_fext(int w)
  465. {
  466. return (w == XFS_DATA_FORK ? XFS_ILOG_DEXT : XFS_ILOG_AEXT);
  467. }
  468. static inline int xfs_ilog_fdata(int w)
  469. {
  470. return (w == XFS_DATA_FORK ? XFS_ILOG_DDATA : XFS_ILOG_ADATA);
  471. }
  472. /*
  473. * Incore version of the on-disk inode core structures. We log this directly
  474. * into the journal in host CPU format (for better or worse) and as such
  475. * directly mirrors the xfs_dinode structure as it must contain all the same
  476. * information.
  477. */
  478. typedef struct xfs_ictimestamp {
  479. __int32_t t_sec; /* timestamp seconds */
  480. __int32_t t_nsec; /* timestamp nanoseconds */
  481. } xfs_ictimestamp_t;
  482. /*
  483. * NOTE: This structure must be kept identical to struct xfs_dinode
  484. * in xfs_dinode.h except for the endianness annotations.
  485. */
  486. typedef struct xfs_icdinode {
  487. __uint16_t di_magic; /* inode magic # = XFS_DINODE_MAGIC */
  488. __uint16_t di_mode; /* mode and type of file */
  489. __int8_t di_version; /* inode version */
  490. __int8_t di_format; /* format of di_c data */
  491. __uint16_t di_onlink; /* old number of links to file */
  492. __uint32_t di_uid; /* owner's user id */
  493. __uint32_t di_gid; /* owner's group id */
  494. __uint32_t di_nlink; /* number of links to file */
  495. __uint16_t di_projid_lo; /* lower part of owner's project id */
  496. __uint16_t di_projid_hi; /* higher part of owner's project id */
  497. __uint8_t di_pad[6]; /* unused, zeroed space */
  498. __uint16_t di_flushiter; /* incremented on flush */
  499. xfs_ictimestamp_t di_atime; /* time last accessed */
  500. xfs_ictimestamp_t di_mtime; /* time last modified */
  501. xfs_ictimestamp_t di_ctime; /* time created/inode modified */
  502. xfs_fsize_t di_size; /* number of bytes in file */
  503. xfs_drfsbno_t di_nblocks; /* # of direct & btree blocks used */
  504. xfs_extlen_t di_extsize; /* basic/minimum extent size for file */
  505. xfs_extnum_t di_nextents; /* number of extents in data fork */
  506. xfs_aextnum_t di_anextents; /* number of extents in attribute fork*/
  507. __uint8_t di_forkoff; /* attr fork offs, <<3 for 64b align */
  508. __int8_t di_aformat; /* format of attr fork's data */
  509. __uint32_t di_dmevmask; /* DMIG event mask */
  510. __uint16_t di_dmstate; /* DMIG state info */
  511. __uint16_t di_flags; /* random flags, XFS_DIFLAG_... */
  512. __uint32_t di_gen; /* generation number */
  513. /* di_next_unlinked is the only non-core field in the old dinode */
  514. xfs_agino_t di_next_unlinked;/* agi unlinked list ptr */
  515. /* start of the extended dinode, writable fields */
  516. __uint32_t di_crc; /* CRC of the inode */
  517. __uint64_t di_changecount; /* number of attribute changes */
  518. xfs_lsn_t di_lsn; /* flush sequence */
  519. __uint64_t di_flags2; /* more random flags */
  520. __uint8_t di_pad2[16]; /* more padding for future expansion */
  521. /* fields only written to during inode creation */
  522. xfs_ictimestamp_t di_crtime; /* time created */
  523. xfs_ino_t di_ino; /* inode number */
  524. uuid_t di_uuid; /* UUID of the filesystem */
  525. /* structure must be padded to 64 bit alignment */
  526. } xfs_icdinode_t;
  527. static inline uint xfs_icdinode_size(int version)
  528. {
  529. if (version == 3)
  530. return sizeof(struct xfs_icdinode);
  531. return offsetof(struct xfs_icdinode, di_next_unlinked);
  532. }
  533. /*
  534. * Buffer Log Format defintions
  535. *
  536. * These are the physical dirty bitmap defintions for the log format structure.
  537. */
  538. #define XFS_BLF_CHUNK 128
  539. #define XFS_BLF_SHIFT 7
  540. #define BIT_TO_WORD_SHIFT 5
  541. #define NBWORD (NBBY * sizeof(unsigned int))
  542. /*
  543. * This flag indicates that the buffer contains on disk inodes
  544. * and requires special recovery handling.
  545. */
  546. #define XFS_BLF_INODE_BUF (1<<0)
  547. /*
  548. * This flag indicates that the buffer should not be replayed
  549. * during recovery because its blocks are being freed.
  550. */
  551. #define XFS_BLF_CANCEL (1<<1)
  552. /*
  553. * This flag indicates that the buffer contains on disk
  554. * user or group dquots and may require special recovery handling.
  555. */
  556. #define XFS_BLF_UDQUOT_BUF (1<<2)
  557. #define XFS_BLF_PDQUOT_BUF (1<<3)
  558. #define XFS_BLF_GDQUOT_BUF (1<<4)
  559. /*
  560. * This is the structure used to lay out a buf log item in the
  561. * log. The data map describes which 128 byte chunks of the buffer
  562. * have been logged.
  563. */
  564. #define XFS_BLF_DATAMAP_SIZE ((XFS_MAX_BLOCKSIZE / XFS_BLF_CHUNK) / NBWORD)
  565. typedef struct xfs_buf_log_format {
  566. unsigned short blf_type; /* buf log item type indicator */
  567. unsigned short blf_size; /* size of this item */
  568. ushort blf_flags; /* misc state */
  569. ushort blf_len; /* number of blocks in this buf */
  570. __int64_t blf_blkno; /* starting blkno of this buf */
  571. unsigned int blf_map_size; /* used size of data bitmap in words */
  572. unsigned int blf_data_map[XFS_BLF_DATAMAP_SIZE]; /* dirty bitmap */
  573. } xfs_buf_log_format_t;
  574. /*
  575. * All buffers now need to tell recovery where the magic number
  576. * is so that it can verify and calculate the CRCs on the buffer correctly
  577. * once the changes have been replayed into the buffer.
  578. *
  579. * The type value is held in the upper 5 bits of the blf_flags field, which is
  580. * an unsigned 16 bit field. Hence we need to shift it 11 bits up and down.
  581. */
  582. #define XFS_BLFT_BITS 5
  583. #define XFS_BLFT_SHIFT 11
  584. #define XFS_BLFT_MASK (((1 << XFS_BLFT_BITS) - 1) << XFS_BLFT_SHIFT)
  585. enum xfs_blft {
  586. XFS_BLFT_UNKNOWN_BUF = 0,
  587. XFS_BLFT_UDQUOT_BUF,
  588. XFS_BLFT_PDQUOT_BUF,
  589. XFS_BLFT_GDQUOT_BUF,
  590. XFS_BLFT_BTREE_BUF,
  591. XFS_BLFT_AGF_BUF,
  592. XFS_BLFT_AGFL_BUF,
  593. XFS_BLFT_AGI_BUF,
  594. XFS_BLFT_DINO_BUF,
  595. XFS_BLFT_SYMLINK_BUF,
  596. XFS_BLFT_DIR_BLOCK_BUF,
  597. XFS_BLFT_DIR_DATA_BUF,
  598. XFS_BLFT_DIR_FREE_BUF,
  599. XFS_BLFT_DIR_LEAF1_BUF,
  600. XFS_BLFT_DIR_LEAFN_BUF,
  601. XFS_BLFT_DA_NODE_BUF,
  602. XFS_BLFT_ATTR_LEAF_BUF,
  603. XFS_BLFT_ATTR_RMT_BUF,
  604. XFS_BLFT_SB_BUF,
  605. XFS_BLFT_MAX_BUF = (1 << XFS_BLFT_BITS),
  606. };
  607. static inline void
  608. xfs_blft_to_flags(struct xfs_buf_log_format *blf, enum xfs_blft type)
  609. {
  610. ASSERT(type > XFS_BLFT_UNKNOWN_BUF && type < XFS_BLFT_MAX_BUF);
  611. blf->blf_flags &= ~XFS_BLFT_MASK;
  612. blf->blf_flags |= ((type << XFS_BLFT_SHIFT) & XFS_BLFT_MASK);
  613. }
  614. static inline __uint16_t
  615. xfs_blft_from_flags(struct xfs_buf_log_format *blf)
  616. {
  617. return (blf->blf_flags & XFS_BLFT_MASK) >> XFS_BLFT_SHIFT;
  618. }
  619. /*
  620. * EFI/EFD log format definitions
  621. */
  622. typedef struct xfs_extent {
  623. xfs_dfsbno_t ext_start;
  624. xfs_extlen_t ext_len;
  625. } xfs_extent_t;
  626. /*
  627. * Since an xfs_extent_t has types (start:64, len: 32)
  628. * there are different alignments on 32 bit and 64 bit kernels.
  629. * So we provide the different variants for use by a
  630. * conversion routine.
  631. */
  632. typedef struct xfs_extent_32 {
  633. __uint64_t ext_start;
  634. __uint32_t ext_len;
  635. } __attribute__((packed)) xfs_extent_32_t;
  636. typedef struct xfs_extent_64 {
  637. __uint64_t ext_start;
  638. __uint32_t ext_len;
  639. __uint32_t ext_pad;
  640. } xfs_extent_64_t;
  641. /*
  642. * This is the structure used to lay out an efi log item in the
  643. * log. The efi_extents field is a variable size array whose
  644. * size is given by efi_nextents.
  645. */
  646. typedef struct xfs_efi_log_format {
  647. __uint16_t efi_type; /* efi log item type */
  648. __uint16_t efi_size; /* size of this item */
  649. __uint32_t efi_nextents; /* # extents to free */
  650. __uint64_t efi_id; /* efi identifier */
  651. xfs_extent_t efi_extents[1]; /* array of extents to free */
  652. } xfs_efi_log_format_t;
  653. typedef struct xfs_efi_log_format_32 {
  654. __uint16_t efi_type; /* efi log item type */
  655. __uint16_t efi_size; /* size of this item */
  656. __uint32_t efi_nextents; /* # extents to free */
  657. __uint64_t efi_id; /* efi identifier */
  658. xfs_extent_32_t efi_extents[1]; /* array of extents to free */
  659. } __attribute__((packed)) xfs_efi_log_format_32_t;
  660. typedef struct xfs_efi_log_format_64 {
  661. __uint16_t efi_type; /* efi log item type */
  662. __uint16_t efi_size; /* size of this item */
  663. __uint32_t efi_nextents; /* # extents to free */
  664. __uint64_t efi_id; /* efi identifier */
  665. xfs_extent_64_t efi_extents[1]; /* array of extents to free */
  666. } xfs_efi_log_format_64_t;
  667. /*
  668. * This is the structure used to lay out an efd log item in the
  669. * log. The efd_extents array is a variable size array whose
  670. * size is given by efd_nextents;
  671. */
  672. typedef struct xfs_efd_log_format {
  673. __uint16_t efd_type; /* efd log item type */
  674. __uint16_t efd_size; /* size of this item */
  675. __uint32_t efd_nextents; /* # of extents freed */
  676. __uint64_t efd_efi_id; /* id of corresponding efi */
  677. xfs_extent_t efd_extents[1]; /* array of extents freed */
  678. } xfs_efd_log_format_t;
  679. typedef struct xfs_efd_log_format_32 {
  680. __uint16_t efd_type; /* efd log item type */
  681. __uint16_t efd_size; /* size of this item */
  682. __uint32_t efd_nextents; /* # of extents freed */
  683. __uint64_t efd_efi_id; /* id of corresponding efi */
  684. xfs_extent_32_t efd_extents[1]; /* array of extents freed */
  685. } __attribute__((packed)) xfs_efd_log_format_32_t;
  686. typedef struct xfs_efd_log_format_64 {
  687. __uint16_t efd_type; /* efd log item type */
  688. __uint16_t efd_size; /* size of this item */
  689. __uint32_t efd_nextents; /* # of extents freed */
  690. __uint64_t efd_efi_id; /* id of corresponding efi */
  691. xfs_extent_64_t efd_extents[1]; /* array of extents freed */
  692. } xfs_efd_log_format_64_t;
  693. /*
  694. * Dquot Log format definitions.
  695. *
  696. * The first two fields must be the type and size fitting into
  697. * 32 bits : log_recovery code assumes that.
  698. */
  699. typedef struct xfs_dq_logformat {
  700. __uint16_t qlf_type; /* dquot log item type */
  701. __uint16_t qlf_size; /* size of this item */
  702. xfs_dqid_t qlf_id; /* usr/grp/proj id : 32 bits */
  703. __int64_t qlf_blkno; /* blkno of dquot buffer */
  704. __int32_t qlf_len; /* len of dquot buffer */
  705. __uint32_t qlf_boffset; /* off of dquot in buffer */
  706. } xfs_dq_logformat_t;
  707. /*
  708. * log format struct for QUOTAOFF records.
  709. * The first two fields must be the type and size fitting into
  710. * 32 bits : log_recovery code assumes that.
  711. * We write two LI_QUOTAOFF logitems per quotaoff, the last one keeps a pointer
  712. * to the first and ensures that the first logitem is taken out of the AIL
  713. * only when the last one is securely committed.
  714. */
  715. typedef struct xfs_qoff_logformat {
  716. unsigned short qf_type; /* quotaoff log item type */
  717. unsigned short qf_size; /* size of this item */
  718. unsigned int qf_flags; /* USR and/or GRP */
  719. char qf_pad[12]; /* padding for future */
  720. } xfs_qoff_logformat_t;
  721. /*
  722. * Disk quotas status in m_qflags, and also sb_qflags. 16 bits.
  723. */
  724. #define XFS_UQUOTA_ACCT 0x0001 /* user quota accounting ON */
  725. #define XFS_UQUOTA_ENFD 0x0002 /* user quota limits enforced */
  726. #define XFS_UQUOTA_CHKD 0x0004 /* quotacheck run on usr quotas */
  727. #define XFS_PQUOTA_ACCT 0x0008 /* project quota accounting ON */
  728. #define XFS_OQUOTA_ENFD 0x0010 /* other (grp/prj) quota limits enforced */
  729. #define XFS_OQUOTA_CHKD 0x0020 /* quotacheck run on other (grp/prj) quotas */
  730. #define XFS_GQUOTA_ACCT 0x0040 /* group quota accounting ON */
  731. /*
  732. * Conversion to and from the combined OQUOTA flag (if necessary)
  733. * is done only in xfs_sb_qflags_to_disk() and xfs_sb_qflags_from_disk()
  734. */
  735. #define XFS_GQUOTA_ENFD 0x0080 /* group quota limits enforced */
  736. #define XFS_GQUOTA_CHKD 0x0100 /* quotacheck run on group quotas */
  737. #define XFS_PQUOTA_ENFD 0x0200 /* project quota limits enforced */
  738. #define XFS_PQUOTA_CHKD 0x0400 /* quotacheck run on project quotas */
  739. #define XFS_ALL_QUOTA_ACCT \
  740. (XFS_UQUOTA_ACCT | XFS_GQUOTA_ACCT | XFS_PQUOTA_ACCT)
  741. #define XFS_ALL_QUOTA_ENFD \
  742. (XFS_UQUOTA_ENFD | XFS_GQUOTA_ENFD | XFS_PQUOTA_ENFD)
  743. #define XFS_ALL_QUOTA_CHKD \
  744. (XFS_UQUOTA_CHKD | XFS_GQUOTA_CHKD | XFS_PQUOTA_CHKD)
  745. #define XFS_MOUNT_QUOTA_ALL (XFS_UQUOTA_ACCT|XFS_UQUOTA_ENFD|\
  746. XFS_UQUOTA_CHKD|XFS_GQUOTA_ACCT|\
  747. XFS_GQUOTA_ENFD|XFS_GQUOTA_CHKD|\
  748. XFS_PQUOTA_ACCT|XFS_PQUOTA_ENFD|\
  749. XFS_PQUOTA_CHKD)
  750. /*
  751. * Inode create log item structure
  752. *
  753. * Log recovery assumes the first two entries are the type and size and they fit
  754. * in 32 bits. Also in host order (ugh) so they have to be 32 bit aligned so
  755. * decoding can be done correctly.
  756. */
  757. struct xfs_icreate_log {
  758. __uint16_t icl_type; /* type of log format structure */
  759. __uint16_t icl_size; /* size of log format structure */
  760. __be32 icl_ag; /* ag being allocated in */
  761. __be32 icl_agbno; /* start block of inode range */
  762. __be32 icl_count; /* number of inodes to initialise */
  763. __be32 icl_isize; /* size of inodes */
  764. __be32 icl_length; /* length of extent to initialise */
  765. __be32 icl_gen; /* inode generation number to use */
  766. };
  767. int xfs_log_calc_unit_res(struct xfs_mount *mp, int unit_bytes);
  768. int xfs_log_calc_minimum_size(struct xfs_mount *);
  769. #endif /* __XFS_LOG_FORMAT_H__ */