xfs_format.h 62 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829
  1. /* SPDX-License-Identifier: GPL-2.0 */
  2. /*
  3. * Copyright (c) 2000-2005 Silicon Graphics, Inc.
  4. * All Rights Reserved.
  5. */
  6. #ifndef __XFS_FORMAT_H__
  7. #define __XFS_FORMAT_H__
  8. /*
  9. * XFS On Disk Format Definitions
  10. *
  11. * This header file defines all the on-disk format definitions for
  12. * general XFS objects. Directory and attribute related objects are defined in
  13. * xfs_da_format.h, which log and log item formats are defined in
  14. * xfs_log_format.h. Everything else goes here.
  15. */
  16. struct xfs_mount;
  17. struct xfs_trans;
  18. struct xfs_inode;
  19. struct xfs_buf;
  20. struct xfs_ifork;
  21. /*
  22. * Super block
  23. * Fits into a sector-sized buffer at address 0 of each allocation group.
  24. * Only the first of these is ever updated except during growfs.
  25. */
  26. #define XFS_SB_MAGIC 0x58465342 /* 'XFSB' */
  27. #define XFS_SB_VERSION_1 1 /* 5.3, 6.0.1, 6.1 */
  28. #define XFS_SB_VERSION_2 2 /* 6.2 - attributes */
  29. #define XFS_SB_VERSION_3 3 /* 6.2 - new inode version */
  30. #define XFS_SB_VERSION_4 4 /* 6.2+ - bitmask version */
  31. #define XFS_SB_VERSION_5 5 /* CRC enabled filesystem */
  32. #define XFS_SB_VERSION_NUMBITS 0x000f
  33. #define XFS_SB_VERSION_ALLFBITS 0xfff0
  34. #define XFS_SB_VERSION_ATTRBIT 0x0010
  35. #define XFS_SB_VERSION_NLINKBIT 0x0020
  36. #define XFS_SB_VERSION_QUOTABIT 0x0040
  37. #define XFS_SB_VERSION_ALIGNBIT 0x0080
  38. #define XFS_SB_VERSION_DALIGNBIT 0x0100
  39. #define XFS_SB_VERSION_SHAREDBIT 0x0200
  40. #define XFS_SB_VERSION_LOGV2BIT 0x0400
  41. #define XFS_SB_VERSION_SECTORBIT 0x0800
  42. #define XFS_SB_VERSION_EXTFLGBIT 0x1000
  43. #define XFS_SB_VERSION_DIRV2BIT 0x2000
  44. #define XFS_SB_VERSION_BORGBIT 0x4000 /* ASCII only case-insens. */
  45. #define XFS_SB_VERSION_MOREBITSBIT 0x8000
  46. /*
  47. * The size of a single extended attribute on disk is limited by
  48. * the size of index values within the attribute entries themselves.
  49. * These are be16 fields, so we can only support attribute data
  50. * sizes up to 2^16 bytes in length.
  51. */
  52. #define XFS_XATTR_SIZE_MAX (1 << 16)
  53. /*
  54. * Supported feature bit list is just all bits in the versionnum field because
  55. * we've used them all up and understand them all. Except, of course, for the
  56. * shared superblock bit, which nobody knows what it does and so is unsupported.
  57. */
  58. #define XFS_SB_VERSION_OKBITS \
  59. ((XFS_SB_VERSION_NUMBITS | XFS_SB_VERSION_ALLFBITS) & \
  60. ~XFS_SB_VERSION_SHAREDBIT)
  61. /*
  62. * There are two words to hold XFS "feature" bits: the original
  63. * word, sb_versionnum, and sb_features2. Whenever a bit is set in
  64. * sb_features2, the feature bit XFS_SB_VERSION_MOREBITSBIT must be set.
  65. *
  66. * These defines represent bits in sb_features2.
  67. */
  68. #define XFS_SB_VERSION2_RESERVED1BIT 0x00000001
  69. #define XFS_SB_VERSION2_LAZYSBCOUNTBIT 0x00000002 /* Superblk counters */
  70. #define XFS_SB_VERSION2_RESERVED4BIT 0x00000004
  71. #define XFS_SB_VERSION2_ATTR2BIT 0x00000008 /* Inline attr rework */
  72. #define XFS_SB_VERSION2_PARENTBIT 0x00000010 /* parent pointers */
  73. #define XFS_SB_VERSION2_PROJID32BIT 0x00000080 /* 32 bit project id */
  74. #define XFS_SB_VERSION2_CRCBIT 0x00000100 /* metadata CRCs */
  75. #define XFS_SB_VERSION2_FTYPE 0x00000200 /* inode type in dir */
  76. #define XFS_SB_VERSION2_OKBITS \
  77. (XFS_SB_VERSION2_LAZYSBCOUNTBIT | \
  78. XFS_SB_VERSION2_ATTR2BIT | \
  79. XFS_SB_VERSION2_PROJID32BIT | \
  80. XFS_SB_VERSION2_FTYPE)
  81. /* Maximum size of the xfs filesystem label, no terminating NULL */
  82. #define XFSLABEL_MAX 12
  83. /*
  84. * Superblock - in core version. Must match the ondisk version below.
  85. * Must be padded to 64 bit alignment.
  86. */
  87. typedef struct xfs_sb {
  88. uint32_t sb_magicnum; /* magic number == XFS_SB_MAGIC */
  89. uint32_t sb_blocksize; /* logical block size, bytes */
  90. xfs_rfsblock_t sb_dblocks; /* number of data blocks */
  91. xfs_rfsblock_t sb_rblocks; /* number of realtime blocks */
  92. xfs_rtblock_t sb_rextents; /* number of realtime extents */
  93. uuid_t sb_uuid; /* user-visible file system unique id */
  94. xfs_fsblock_t sb_logstart; /* starting block of log if internal */
  95. xfs_ino_t sb_rootino; /* root inode number */
  96. xfs_ino_t sb_rbmino; /* bitmap inode for realtime extents */
  97. xfs_ino_t sb_rsumino; /* summary inode for rt bitmap */
  98. xfs_agblock_t sb_rextsize; /* realtime extent size, blocks */
  99. xfs_agblock_t sb_agblocks; /* size of an allocation group */
  100. xfs_agnumber_t sb_agcount; /* number of allocation groups */
  101. xfs_extlen_t sb_rbmblocks; /* number of rt bitmap blocks */
  102. xfs_extlen_t sb_logblocks; /* number of log blocks */
  103. uint16_t sb_versionnum; /* header version == XFS_SB_VERSION */
  104. uint16_t sb_sectsize; /* volume sector size, bytes */
  105. uint16_t sb_inodesize; /* inode size, bytes */
  106. uint16_t sb_inopblock; /* inodes per block */
  107. char sb_fname[XFSLABEL_MAX]; /* file system name */
  108. uint8_t sb_blocklog; /* log2 of sb_blocksize */
  109. uint8_t sb_sectlog; /* log2 of sb_sectsize */
  110. uint8_t sb_inodelog; /* log2 of sb_inodesize */
  111. uint8_t sb_inopblog; /* log2 of sb_inopblock */
  112. uint8_t sb_agblklog; /* log2 of sb_agblocks (rounded up) */
  113. uint8_t sb_rextslog; /* log2 of sb_rextents */
  114. uint8_t sb_inprogress; /* mkfs is in progress, don't mount */
  115. uint8_t sb_imax_pct; /* max % of fs for inode space */
  116. /* statistics */
  117. /*
  118. * These fields must remain contiguous. If you really
  119. * want to change their layout, make sure you fix the
  120. * code in xfs_trans_apply_sb_deltas().
  121. */
  122. uint64_t sb_icount; /* allocated inodes */
  123. uint64_t sb_ifree; /* free inodes */
  124. uint64_t sb_fdblocks; /* free data blocks */
  125. uint64_t sb_frextents; /* free realtime extents */
  126. /*
  127. * End contiguous fields.
  128. */
  129. xfs_ino_t sb_uquotino; /* user quota inode */
  130. xfs_ino_t sb_gquotino; /* group quota inode */
  131. uint16_t sb_qflags; /* quota flags */
  132. uint8_t sb_flags; /* misc. flags */
  133. uint8_t sb_shared_vn; /* shared version number */
  134. xfs_extlen_t sb_inoalignmt; /* inode chunk alignment, fsblocks */
  135. uint32_t sb_unit; /* stripe or raid unit */
  136. uint32_t sb_width; /* stripe or raid width */
  137. uint8_t sb_dirblklog; /* log2 of dir block size (fsbs) */
  138. uint8_t sb_logsectlog; /* log2 of the log sector size */
  139. uint16_t sb_logsectsize; /* sector size for the log, bytes */
  140. uint32_t sb_logsunit; /* stripe unit size for the log */
  141. uint32_t sb_features2; /* additional feature bits */
  142. /*
  143. * bad features2 field as a result of failing to pad the sb structure to
  144. * 64 bits. Some machines will be using this field for features2 bits.
  145. * Easiest just to mark it bad and not use it for anything else.
  146. *
  147. * This is not kept up to date in memory; it is always overwritten by
  148. * the value in sb_features2 when formatting the incore superblock to
  149. * the disk buffer.
  150. */
  151. uint32_t sb_bad_features2;
  152. /* version 5 superblock fields start here */
  153. /* feature masks */
  154. uint32_t sb_features_compat;
  155. uint32_t sb_features_ro_compat;
  156. uint32_t sb_features_incompat;
  157. uint32_t sb_features_log_incompat;
  158. uint32_t sb_crc; /* superblock crc */
  159. xfs_extlen_t sb_spino_align; /* sparse inode chunk alignment */
  160. xfs_ino_t sb_pquotino; /* project quota inode */
  161. xfs_lsn_t sb_lsn; /* last write sequence */
  162. uuid_t sb_meta_uuid; /* metadata file system unique id */
  163. /* must be padded to 64 bit alignment */
  164. } xfs_sb_t;
  165. #define XFS_SB_CRC_OFF offsetof(struct xfs_sb, sb_crc)
  166. /*
  167. * Superblock - on disk version. Must match the in core version above.
  168. * Must be padded to 64 bit alignment.
  169. */
  170. struct xfs_dsb {
  171. __be32 sb_magicnum; /* magic number == XFS_SB_MAGIC */
  172. __be32 sb_blocksize; /* logical block size, bytes */
  173. __be64 sb_dblocks; /* number of data blocks */
  174. __be64 sb_rblocks; /* number of realtime blocks */
  175. __be64 sb_rextents; /* number of realtime extents */
  176. uuid_t sb_uuid; /* user-visible file system unique id */
  177. __be64 sb_logstart; /* starting block of log if internal */
  178. __be64 sb_rootino; /* root inode number */
  179. __be64 sb_rbmino; /* bitmap inode for realtime extents */
  180. __be64 sb_rsumino; /* summary inode for rt bitmap */
  181. __be32 sb_rextsize; /* realtime extent size, blocks */
  182. __be32 sb_agblocks; /* size of an allocation group */
  183. __be32 sb_agcount; /* number of allocation groups */
  184. __be32 sb_rbmblocks; /* number of rt bitmap blocks */
  185. __be32 sb_logblocks; /* number of log blocks */
  186. __be16 sb_versionnum; /* header version == XFS_SB_VERSION */
  187. __be16 sb_sectsize; /* volume sector size, bytes */
  188. __be16 sb_inodesize; /* inode size, bytes */
  189. __be16 sb_inopblock; /* inodes per block */
  190. char sb_fname[XFSLABEL_MAX]; /* file system name */
  191. __u8 sb_blocklog; /* log2 of sb_blocksize */
  192. __u8 sb_sectlog; /* log2 of sb_sectsize */
  193. __u8 sb_inodelog; /* log2 of sb_inodesize */
  194. __u8 sb_inopblog; /* log2 of sb_inopblock */
  195. __u8 sb_agblklog; /* log2 of sb_agblocks (rounded up) */
  196. __u8 sb_rextslog; /* log2 of sb_rextents */
  197. __u8 sb_inprogress; /* mkfs is in progress, don't mount */
  198. __u8 sb_imax_pct; /* max % of fs for inode space */
  199. /* statistics */
  200. /*
  201. * These fields must remain contiguous. If you really
  202. * want to change their layout, make sure you fix the
  203. * code in xfs_trans_apply_sb_deltas().
  204. */
  205. __be64 sb_icount; /* allocated inodes */
  206. __be64 sb_ifree; /* free inodes */
  207. __be64 sb_fdblocks; /* free data blocks */
  208. __be64 sb_frextents; /* free realtime extents */
  209. /*
  210. * End contiguous fields.
  211. */
  212. __be64 sb_uquotino; /* user quota inode */
  213. __be64 sb_gquotino; /* group quota inode */
  214. __be16 sb_qflags; /* quota flags */
  215. __u8 sb_flags; /* misc. flags */
  216. __u8 sb_shared_vn; /* shared version number */
  217. __be32 sb_inoalignmt; /* inode chunk alignment, fsblocks */
  218. __be32 sb_unit; /* stripe or raid unit */
  219. __be32 sb_width; /* stripe or raid width */
  220. __u8 sb_dirblklog; /* log2 of dir block size (fsbs) */
  221. __u8 sb_logsectlog; /* log2 of the log sector size */
  222. __be16 sb_logsectsize; /* sector size for the log, bytes */
  223. __be32 sb_logsunit; /* stripe unit size for the log */
  224. __be32 sb_features2; /* additional feature bits */
  225. /*
  226. * bad features2 field as a result of failing to pad the sb
  227. * structure to 64 bits. Some machines will be using this field
  228. * for features2 bits. Easiest just to mark it bad and not use
  229. * it for anything else.
  230. */
  231. __be32 sb_bad_features2;
  232. /* version 5 superblock fields start here */
  233. /* feature masks */
  234. __be32 sb_features_compat;
  235. __be32 sb_features_ro_compat;
  236. __be32 sb_features_incompat;
  237. __be32 sb_features_log_incompat;
  238. __le32 sb_crc; /* superblock crc */
  239. __be32 sb_spino_align; /* sparse inode chunk alignment */
  240. __be64 sb_pquotino; /* project quota inode */
  241. __be64 sb_lsn; /* last write sequence */
  242. uuid_t sb_meta_uuid; /* metadata file system unique id */
  243. /* must be padded to 64 bit alignment */
  244. };
  245. /*
  246. * Misc. Flags - warning - these will be cleared by xfs_repair unless
  247. * a feature bit is set when the flag is used.
  248. */
  249. #define XFS_SBF_NOFLAGS 0x00 /* no flags set */
  250. #define XFS_SBF_READONLY 0x01 /* only read-only mounts allowed */
  251. /*
  252. * define max. shared version we can interoperate with
  253. */
  254. #define XFS_SB_MAX_SHARED_VN 0
  255. #define XFS_SB_VERSION_NUM(sbp) ((sbp)->sb_versionnum & XFS_SB_VERSION_NUMBITS)
  256. static inline bool xfs_sb_is_v5(struct xfs_sb *sbp)
  257. {
  258. return XFS_SB_VERSION_NUM(sbp) == XFS_SB_VERSION_5;
  259. }
  260. /*
  261. * Detect a mismatched features2 field. Older kernels read/wrote
  262. * this into the wrong slot, so to be safe we keep them in sync.
  263. */
  264. static inline bool xfs_sb_has_mismatched_features2(struct xfs_sb *sbp)
  265. {
  266. return sbp->sb_bad_features2 != sbp->sb_features2;
  267. }
  268. static inline bool xfs_sb_version_hasmorebits(struct xfs_sb *sbp)
  269. {
  270. return xfs_sb_is_v5(sbp) ||
  271. (sbp->sb_versionnum & XFS_SB_VERSION_MOREBITSBIT);
  272. }
  273. static inline void xfs_sb_version_addattr(struct xfs_sb *sbp)
  274. {
  275. sbp->sb_versionnum |= XFS_SB_VERSION_ATTRBIT;
  276. }
  277. static inline void xfs_sb_version_addquota(struct xfs_sb *sbp)
  278. {
  279. sbp->sb_versionnum |= XFS_SB_VERSION_QUOTABIT;
  280. }
  281. static inline void xfs_sb_version_addattr2(struct xfs_sb *sbp)
  282. {
  283. sbp->sb_versionnum |= XFS_SB_VERSION_MOREBITSBIT;
  284. sbp->sb_features2 |= XFS_SB_VERSION2_ATTR2BIT;
  285. }
  286. static inline void xfs_sb_version_addprojid32(struct xfs_sb *sbp)
  287. {
  288. sbp->sb_versionnum |= XFS_SB_VERSION_MOREBITSBIT;
  289. sbp->sb_features2 |= XFS_SB_VERSION2_PROJID32BIT;
  290. }
  291. /*
  292. * Extended v5 superblock feature masks. These are to be used for new v5
  293. * superblock features only.
  294. *
  295. * Compat features are new features that old kernels will not notice or affect
  296. * and so can mount read-write without issues.
  297. *
  298. * RO-Compat (read only) are features that old kernels can read but will break
  299. * if they write. Hence only read-only mounts of such filesystems are allowed on
  300. * kernels that don't support the feature bit.
  301. *
  302. * InCompat features are features which old kernels will not understand and so
  303. * must not mount.
  304. *
  305. * Log-InCompat features are for changes to log formats or new transactions that
  306. * can't be replayed on older kernels. The fields are set when the filesystem is
  307. * mounted, and a clean unmount clears the fields.
  308. */
  309. #define XFS_SB_FEAT_COMPAT_ALL 0
  310. #define XFS_SB_FEAT_COMPAT_UNKNOWN ~XFS_SB_FEAT_COMPAT_ALL
  311. static inline bool
  312. xfs_sb_has_compat_feature(
  313. struct xfs_sb *sbp,
  314. uint32_t feature)
  315. {
  316. return (sbp->sb_features_compat & feature) != 0;
  317. }
  318. #define XFS_SB_FEAT_RO_COMPAT_FINOBT (1 << 0) /* free inode btree */
  319. #define XFS_SB_FEAT_RO_COMPAT_RMAPBT (1 << 1) /* reverse map btree */
  320. #define XFS_SB_FEAT_RO_COMPAT_REFLINK (1 << 2) /* reflinked files */
  321. #define XFS_SB_FEAT_RO_COMPAT_INOBTCNT (1 << 3) /* inobt block counts */
  322. #define XFS_SB_FEAT_RO_COMPAT_ALL \
  323. (XFS_SB_FEAT_RO_COMPAT_FINOBT | \
  324. XFS_SB_FEAT_RO_COMPAT_RMAPBT | \
  325. XFS_SB_FEAT_RO_COMPAT_REFLINK| \
  326. XFS_SB_FEAT_RO_COMPAT_INOBTCNT)
  327. #define XFS_SB_FEAT_RO_COMPAT_UNKNOWN ~XFS_SB_FEAT_RO_COMPAT_ALL
  328. static inline bool
  329. xfs_sb_has_ro_compat_feature(
  330. struct xfs_sb *sbp,
  331. uint32_t feature)
  332. {
  333. return (sbp->sb_features_ro_compat & feature) != 0;
  334. }
  335. #define XFS_SB_FEAT_INCOMPAT_FTYPE (1 << 0) /* filetype in dirent */
  336. #define XFS_SB_FEAT_INCOMPAT_SPINODES (1 << 1) /* sparse inode chunks */
  337. #define XFS_SB_FEAT_INCOMPAT_META_UUID (1 << 2) /* metadata UUID */
  338. #define XFS_SB_FEAT_INCOMPAT_BIGTIME (1 << 3) /* large timestamps */
  339. #define XFS_SB_FEAT_INCOMPAT_NEEDSREPAIR (1 << 4) /* needs xfs_repair */
  340. #define XFS_SB_FEAT_INCOMPAT_NREXT64 (1 << 5) /* large extent counters */
  341. #define XFS_SB_FEAT_INCOMPAT_ALL \
  342. (XFS_SB_FEAT_INCOMPAT_FTYPE| \
  343. XFS_SB_FEAT_INCOMPAT_SPINODES| \
  344. XFS_SB_FEAT_INCOMPAT_META_UUID| \
  345. XFS_SB_FEAT_INCOMPAT_BIGTIME| \
  346. XFS_SB_FEAT_INCOMPAT_NEEDSREPAIR| \
  347. XFS_SB_FEAT_INCOMPAT_NREXT64)
  348. #define XFS_SB_FEAT_INCOMPAT_UNKNOWN ~XFS_SB_FEAT_INCOMPAT_ALL
  349. static inline bool
  350. xfs_sb_has_incompat_feature(
  351. struct xfs_sb *sbp,
  352. uint32_t feature)
  353. {
  354. return (sbp->sb_features_incompat & feature) != 0;
  355. }
  356. #define XFS_SB_FEAT_INCOMPAT_LOG_XATTRS (1 << 0) /* Delayed Attributes */
  357. #define XFS_SB_FEAT_INCOMPAT_LOG_ALL \
  358. (XFS_SB_FEAT_INCOMPAT_LOG_XATTRS)
  359. #define XFS_SB_FEAT_INCOMPAT_LOG_UNKNOWN ~XFS_SB_FEAT_INCOMPAT_LOG_ALL
  360. static inline bool
  361. xfs_sb_has_incompat_log_feature(
  362. struct xfs_sb *sbp,
  363. uint32_t feature)
  364. {
  365. return (sbp->sb_features_log_incompat & feature) != 0;
  366. }
  367. static inline void
  368. xfs_sb_remove_incompat_log_features(
  369. struct xfs_sb *sbp)
  370. {
  371. sbp->sb_features_log_incompat &= ~XFS_SB_FEAT_INCOMPAT_LOG_ALL;
  372. }
  373. static inline void
  374. xfs_sb_add_incompat_log_features(
  375. struct xfs_sb *sbp,
  376. unsigned int features)
  377. {
  378. sbp->sb_features_log_incompat |= features;
  379. }
  380. static inline bool xfs_sb_version_haslogxattrs(struct xfs_sb *sbp)
  381. {
  382. return xfs_sb_is_v5(sbp) && (sbp->sb_features_log_incompat &
  383. XFS_SB_FEAT_INCOMPAT_LOG_XATTRS);
  384. }
  385. static inline bool
  386. xfs_is_quota_inode(struct xfs_sb *sbp, xfs_ino_t ino)
  387. {
  388. return (ino == sbp->sb_uquotino ||
  389. ino == sbp->sb_gquotino ||
  390. ino == sbp->sb_pquotino);
  391. }
  392. #define XFS_SB_DADDR ((xfs_daddr_t)0) /* daddr in filesystem/ag */
  393. #define XFS_SB_BLOCK(mp) XFS_HDR_BLOCK(mp, XFS_SB_DADDR)
  394. #define XFS_HDR_BLOCK(mp,d) ((xfs_agblock_t)XFS_BB_TO_FSBT(mp,d))
  395. #define XFS_DADDR_TO_FSB(mp,d) XFS_AGB_TO_FSB(mp, \
  396. xfs_daddr_to_agno(mp,d), xfs_daddr_to_agbno(mp,d))
  397. #define XFS_FSB_TO_DADDR(mp,fsbno) XFS_AGB_TO_DADDR(mp, \
  398. XFS_FSB_TO_AGNO(mp,fsbno), XFS_FSB_TO_AGBNO(mp,fsbno))
  399. /*
  400. * File system sector to basic block conversions.
  401. */
  402. #define XFS_FSS_TO_BB(mp,sec) ((sec) << (mp)->m_sectbb_log)
  403. /*
  404. * File system block to basic block conversions.
  405. */
  406. #define XFS_FSB_TO_BB(mp,fsbno) ((fsbno) << (mp)->m_blkbb_log)
  407. #define XFS_BB_TO_FSB(mp,bb) \
  408. (((bb) + (XFS_FSB_TO_BB(mp,1) - 1)) >> (mp)->m_blkbb_log)
  409. #define XFS_BB_TO_FSBT(mp,bb) ((bb) >> (mp)->m_blkbb_log)
  410. /*
  411. * File system block to byte conversions.
  412. */
  413. #define XFS_FSB_TO_B(mp,fsbno) ((xfs_fsize_t)(fsbno) << (mp)->m_sb.sb_blocklog)
  414. #define XFS_B_TO_FSB(mp,b) \
  415. ((((uint64_t)(b)) + (mp)->m_blockmask) >> (mp)->m_sb.sb_blocklog)
  416. #define XFS_B_TO_FSBT(mp,b) (((uint64_t)(b)) >> (mp)->m_sb.sb_blocklog)
  417. /*
  418. * Allocation group header
  419. *
  420. * This is divided into three structures, placed in sequential 512-byte
  421. * buffers after a copy of the superblock (also in a 512-byte buffer).
  422. */
  423. #define XFS_AGF_MAGIC 0x58414746 /* 'XAGF' */
  424. #define XFS_AGI_MAGIC 0x58414749 /* 'XAGI' */
  425. #define XFS_AGFL_MAGIC 0x5841464c /* 'XAFL' */
  426. #define XFS_AGF_VERSION 1
  427. #define XFS_AGI_VERSION 1
  428. #define XFS_AGF_GOOD_VERSION(v) ((v) == XFS_AGF_VERSION)
  429. #define XFS_AGI_GOOD_VERSION(v) ((v) == XFS_AGI_VERSION)
  430. /*
  431. * Btree number 0 is bno, 1 is cnt, 2 is rmap. This value gives the size of the
  432. * arrays below.
  433. */
  434. #define XFS_BTNUM_AGF ((int)XFS_BTNUM_RMAPi + 1)
  435. /*
  436. * The second word of agf_levels in the first a.g. overlaps the EFS
  437. * superblock's magic number. Since the magic numbers valid for EFS
  438. * are > 64k, our value cannot be confused for an EFS superblock's.
  439. */
  440. typedef struct xfs_agf {
  441. /*
  442. * Common allocation group header information
  443. */
  444. __be32 agf_magicnum; /* magic number == XFS_AGF_MAGIC */
  445. __be32 agf_versionnum; /* header version == XFS_AGF_VERSION */
  446. __be32 agf_seqno; /* sequence # starting from 0 */
  447. __be32 agf_length; /* size in blocks of a.g. */
  448. /*
  449. * Freespace and rmap information
  450. */
  451. __be32 agf_roots[XFS_BTNUM_AGF]; /* root blocks */
  452. __be32 agf_levels[XFS_BTNUM_AGF]; /* btree levels */
  453. __be32 agf_flfirst; /* first freelist block's index */
  454. __be32 agf_fllast; /* last freelist block's index */
  455. __be32 agf_flcount; /* count of blocks in freelist */
  456. __be32 agf_freeblks; /* total free blocks */
  457. __be32 agf_longest; /* longest free space */
  458. __be32 agf_btreeblks; /* # of blocks held in AGF btrees */
  459. uuid_t agf_uuid; /* uuid of filesystem */
  460. __be32 agf_rmap_blocks; /* rmapbt blocks used */
  461. __be32 agf_refcount_blocks; /* refcountbt blocks used */
  462. __be32 agf_refcount_root; /* refcount tree root block */
  463. __be32 agf_refcount_level; /* refcount btree levels */
  464. /*
  465. * reserve some contiguous space for future logged fields before we add
  466. * the unlogged fields. This makes the range logging via flags and
  467. * structure offsets much simpler.
  468. */
  469. __be64 agf_spare64[14];
  470. /* unlogged fields, written during buffer writeback. */
  471. __be64 agf_lsn; /* last write sequence */
  472. __be32 agf_crc; /* crc of agf sector */
  473. __be32 agf_spare2;
  474. /* structure must be padded to 64 bit alignment */
  475. } xfs_agf_t;
  476. #define XFS_AGF_CRC_OFF offsetof(struct xfs_agf, agf_crc)
  477. #define XFS_AGF_MAGICNUM (1u << 0)
  478. #define XFS_AGF_VERSIONNUM (1u << 1)
  479. #define XFS_AGF_SEQNO (1u << 2)
  480. #define XFS_AGF_LENGTH (1u << 3)
  481. #define XFS_AGF_ROOTS (1u << 4)
  482. #define XFS_AGF_LEVELS (1u << 5)
  483. #define XFS_AGF_FLFIRST (1u << 6)
  484. #define XFS_AGF_FLLAST (1u << 7)
  485. #define XFS_AGF_FLCOUNT (1u << 8)
  486. #define XFS_AGF_FREEBLKS (1u << 9)
  487. #define XFS_AGF_LONGEST (1u << 10)
  488. #define XFS_AGF_BTREEBLKS (1u << 11)
  489. #define XFS_AGF_UUID (1u << 12)
  490. #define XFS_AGF_RMAP_BLOCKS (1u << 13)
  491. #define XFS_AGF_REFCOUNT_BLOCKS (1u << 14)
  492. #define XFS_AGF_REFCOUNT_ROOT (1u << 15)
  493. #define XFS_AGF_REFCOUNT_LEVEL (1u << 16)
  494. #define XFS_AGF_SPARE64 (1u << 17)
  495. #define XFS_AGF_NUM_BITS 18
  496. #define XFS_AGF_ALL_BITS ((1u << XFS_AGF_NUM_BITS) - 1)
  497. #define XFS_AGF_FLAGS \
  498. { XFS_AGF_MAGICNUM, "MAGICNUM" }, \
  499. { XFS_AGF_VERSIONNUM, "VERSIONNUM" }, \
  500. { XFS_AGF_SEQNO, "SEQNO" }, \
  501. { XFS_AGF_LENGTH, "LENGTH" }, \
  502. { XFS_AGF_ROOTS, "ROOTS" }, \
  503. { XFS_AGF_LEVELS, "LEVELS" }, \
  504. { XFS_AGF_FLFIRST, "FLFIRST" }, \
  505. { XFS_AGF_FLLAST, "FLLAST" }, \
  506. { XFS_AGF_FLCOUNT, "FLCOUNT" }, \
  507. { XFS_AGF_FREEBLKS, "FREEBLKS" }, \
  508. { XFS_AGF_LONGEST, "LONGEST" }, \
  509. { XFS_AGF_BTREEBLKS, "BTREEBLKS" }, \
  510. { XFS_AGF_UUID, "UUID" }, \
  511. { XFS_AGF_RMAP_BLOCKS, "RMAP_BLOCKS" }, \
  512. { XFS_AGF_REFCOUNT_BLOCKS, "REFCOUNT_BLOCKS" }, \
  513. { XFS_AGF_REFCOUNT_ROOT, "REFCOUNT_ROOT" }, \
  514. { XFS_AGF_REFCOUNT_LEVEL, "REFCOUNT_LEVEL" }, \
  515. { XFS_AGF_SPARE64, "SPARE64" }
  516. /* disk block (xfs_daddr_t) in the AG */
  517. #define XFS_AGF_DADDR(mp) ((xfs_daddr_t)(1 << (mp)->m_sectbb_log))
  518. #define XFS_AGF_BLOCK(mp) XFS_HDR_BLOCK(mp, XFS_AGF_DADDR(mp))
  519. /*
  520. * Size of the unlinked inode hash table in the agi.
  521. */
  522. #define XFS_AGI_UNLINKED_BUCKETS 64
  523. typedef struct xfs_agi {
  524. /*
  525. * Common allocation group header information
  526. */
  527. __be32 agi_magicnum; /* magic number == XFS_AGI_MAGIC */
  528. __be32 agi_versionnum; /* header version == XFS_AGI_VERSION */
  529. __be32 agi_seqno; /* sequence # starting from 0 */
  530. __be32 agi_length; /* size in blocks of a.g. */
  531. /*
  532. * Inode information
  533. * Inodes are mapped by interpreting the inode number, so no
  534. * mapping data is needed here.
  535. */
  536. __be32 agi_count; /* count of allocated inodes */
  537. __be32 agi_root; /* root of inode btree */
  538. __be32 agi_level; /* levels in inode btree */
  539. __be32 agi_freecount; /* number of free inodes */
  540. __be32 agi_newino; /* new inode just allocated */
  541. __be32 agi_dirino; /* last directory inode chunk */
  542. /*
  543. * Hash table of inodes which have been unlinked but are
  544. * still being referenced.
  545. */
  546. __be32 agi_unlinked[XFS_AGI_UNLINKED_BUCKETS];
  547. /*
  548. * This marks the end of logging region 1 and start of logging region 2.
  549. */
  550. uuid_t agi_uuid; /* uuid of filesystem */
  551. __be32 agi_crc; /* crc of agi sector */
  552. __be32 agi_pad32;
  553. __be64 agi_lsn; /* last write sequence */
  554. __be32 agi_free_root; /* root of the free inode btree */
  555. __be32 agi_free_level;/* levels in free inode btree */
  556. __be32 agi_iblocks; /* inobt blocks used */
  557. __be32 agi_fblocks; /* finobt blocks used */
  558. /* structure must be padded to 64 bit alignment */
  559. } xfs_agi_t;
  560. #define XFS_AGI_CRC_OFF offsetof(struct xfs_agi, agi_crc)
  561. #define XFS_AGI_MAGICNUM (1u << 0)
  562. #define XFS_AGI_VERSIONNUM (1u << 1)
  563. #define XFS_AGI_SEQNO (1u << 2)
  564. #define XFS_AGI_LENGTH (1u << 3)
  565. #define XFS_AGI_COUNT (1u << 4)
  566. #define XFS_AGI_ROOT (1u << 5)
  567. #define XFS_AGI_LEVEL (1u << 6)
  568. #define XFS_AGI_FREECOUNT (1u << 7)
  569. #define XFS_AGI_NEWINO (1u << 8)
  570. #define XFS_AGI_DIRINO (1u << 9)
  571. #define XFS_AGI_UNLINKED (1u << 10)
  572. #define XFS_AGI_NUM_BITS_R1 11 /* end of the 1st agi logging region */
  573. #define XFS_AGI_ALL_BITS_R1 ((1u << XFS_AGI_NUM_BITS_R1) - 1)
  574. #define XFS_AGI_FREE_ROOT (1u << 11)
  575. #define XFS_AGI_FREE_LEVEL (1u << 12)
  576. #define XFS_AGI_IBLOCKS (1u << 13) /* both inobt/finobt block counters */
  577. #define XFS_AGI_NUM_BITS_R2 14
  578. /* disk block (xfs_daddr_t) in the AG */
  579. #define XFS_AGI_DADDR(mp) ((xfs_daddr_t)(2 << (mp)->m_sectbb_log))
  580. #define XFS_AGI_BLOCK(mp) XFS_HDR_BLOCK(mp, XFS_AGI_DADDR(mp))
  581. /*
  582. * The third a.g. block contains the a.g. freelist, an array
  583. * of block pointers to blocks owned by the allocation btree code.
  584. */
  585. #define XFS_AGFL_DADDR(mp) ((xfs_daddr_t)(3 << (mp)->m_sectbb_log))
  586. #define XFS_AGFL_BLOCK(mp) XFS_HDR_BLOCK(mp, XFS_AGFL_DADDR(mp))
  587. #define XFS_BUF_TO_AGFL(bp) ((struct xfs_agfl *)((bp)->b_addr))
  588. struct xfs_agfl {
  589. __be32 agfl_magicnum;
  590. __be32 agfl_seqno;
  591. uuid_t agfl_uuid;
  592. __be64 agfl_lsn;
  593. __be32 agfl_crc;
  594. } __attribute__((packed));
  595. #define XFS_AGFL_CRC_OFF offsetof(struct xfs_agfl, agfl_crc)
  596. #define XFS_AGB_TO_FSB(mp,agno,agbno) \
  597. (((xfs_fsblock_t)(agno) << (mp)->m_sb.sb_agblklog) | (agbno))
  598. #define XFS_FSB_TO_AGNO(mp,fsbno) \
  599. ((xfs_agnumber_t)((fsbno) >> (mp)->m_sb.sb_agblklog))
  600. #define XFS_FSB_TO_AGBNO(mp,fsbno) \
  601. ((xfs_agblock_t)((fsbno) & xfs_mask32lo((mp)->m_sb.sb_agblklog)))
  602. #define XFS_AGB_TO_DADDR(mp,agno,agbno) \
  603. ((xfs_daddr_t)XFS_FSB_TO_BB(mp, \
  604. (xfs_fsblock_t)(agno) * (mp)->m_sb.sb_agblocks + (agbno)))
  605. #define XFS_AG_DADDR(mp,agno,d) (XFS_AGB_TO_DADDR(mp, agno, 0) + (d))
  606. /*
  607. * For checking for bad ranges of xfs_daddr_t's, covering multiple
  608. * allocation groups or a single xfs_daddr_t that's a superblock copy.
  609. */
  610. #define XFS_AG_CHECK_DADDR(mp,d,len) \
  611. ((len) == 1 ? \
  612. ASSERT((d) == XFS_SB_DADDR || \
  613. xfs_daddr_to_agbno(mp, d) != XFS_SB_DADDR) : \
  614. ASSERT(xfs_daddr_to_agno(mp, d) == \
  615. xfs_daddr_to_agno(mp, (d) + (len) - 1)))
  616. /*
  617. * XFS Timestamps
  618. * ==============
  619. *
  620. * Traditional ondisk inode timestamps consist of signed 32-bit counters for
  621. * seconds and nanoseconds; time zero is the Unix epoch, Jan 1 00:00:00 UTC
  622. * 1970, which means that the timestamp epoch is the same as the Unix epoch.
  623. * Therefore, the ondisk min and max defined here can be used directly to
  624. * constrain the incore timestamps on a Unix system. Note that we actually
  625. * encode a __be64 value on disk.
  626. *
  627. * When the bigtime feature is enabled, ondisk inode timestamps become an
  628. * unsigned 64-bit nanoseconds counter. This means that the bigtime inode
  629. * timestamp epoch is the start of the classic timestamp range, which is
  630. * Dec 13 20:45:52 UTC 1901. Because the epochs are not the same, callers
  631. * /must/ use the bigtime conversion functions when encoding and decoding raw
  632. * timestamps.
  633. */
  634. typedef __be64 xfs_timestamp_t;
  635. /* Legacy timestamp encoding format. */
  636. struct xfs_legacy_timestamp {
  637. __be32 t_sec; /* timestamp seconds */
  638. __be32 t_nsec; /* timestamp nanoseconds */
  639. };
  640. /*
  641. * Smallest possible ondisk seconds value with traditional timestamps. This
  642. * corresponds exactly with the incore timestamp Dec 13 20:45:52 UTC 1901.
  643. */
  644. #define XFS_LEGACY_TIME_MIN ((int64_t)S32_MIN)
  645. /*
  646. * Largest possible ondisk seconds value with traditional timestamps. This
  647. * corresponds exactly with the incore timestamp Jan 19 03:14:07 UTC 2038.
  648. */
  649. #define XFS_LEGACY_TIME_MAX ((int64_t)S32_MAX)
  650. /*
  651. * Smallest possible ondisk seconds value with bigtime timestamps. This
  652. * corresponds (after conversion to a Unix timestamp) with the traditional
  653. * minimum timestamp of Dec 13 20:45:52 UTC 1901.
  654. */
  655. #define XFS_BIGTIME_TIME_MIN ((int64_t)0)
  656. /*
  657. * Largest supported ondisk seconds value with bigtime timestamps. This
  658. * corresponds (after conversion to a Unix timestamp) with an incore timestamp
  659. * of Jul 2 20:20:24 UTC 2486.
  660. *
  661. * We round down the ondisk limit so that the bigtime quota and inode max
  662. * timestamps will be the same.
  663. */
  664. #define XFS_BIGTIME_TIME_MAX ((int64_t)((-1ULL / NSEC_PER_SEC) & ~0x3ULL))
  665. /*
  666. * Bigtime epoch is set exactly to the minimum time value that a traditional
  667. * 32-bit timestamp can represent when using the Unix epoch as a reference.
  668. * Hence the Unix epoch is at a fixed offset into the supported bigtime
  669. * timestamp range.
  670. *
  671. * The bigtime epoch also matches the minimum value an on-disk 32-bit XFS
  672. * timestamp can represent so we will not lose any fidelity in converting
  673. * to/from unix and bigtime timestamps.
  674. *
  675. * The following conversion factor converts a seconds counter from the Unix
  676. * epoch to the bigtime epoch.
  677. */
  678. #define XFS_BIGTIME_EPOCH_OFFSET (-(int64_t)S32_MIN)
  679. /* Convert a timestamp from the Unix epoch to the bigtime epoch. */
  680. static inline uint64_t xfs_unix_to_bigtime(time64_t unix_seconds)
  681. {
  682. return (uint64_t)unix_seconds + XFS_BIGTIME_EPOCH_OFFSET;
  683. }
  684. /* Convert a timestamp from the bigtime epoch to the Unix epoch. */
  685. static inline time64_t xfs_bigtime_to_unix(uint64_t ondisk_seconds)
  686. {
  687. return (time64_t)ondisk_seconds - XFS_BIGTIME_EPOCH_OFFSET;
  688. }
  689. /*
  690. * On-disk inode structure.
  691. *
  692. * This is just the header or "dinode core", the inode is expanded to fill a
  693. * variable size the leftover area split into a data and an attribute fork.
  694. * The format of the data and attribute fork depends on the format of the
  695. * inode as indicated by di_format and di_aformat. To access the data and
  696. * attribute use the XFS_DFORK_DPTR, XFS_DFORK_APTR, and XFS_DFORK_PTR macros
  697. * below.
  698. *
  699. * There is a very similar struct xfs_log_dinode which matches the layout of
  700. * this structure, but is kept in native format instead of big endian.
  701. *
  702. * Note: di_flushiter is only used by v1/2 inodes - it's effectively a zeroed
  703. * padding field for v3 inodes.
  704. */
  705. #define XFS_DINODE_MAGIC 0x494e /* 'IN' */
  706. struct xfs_dinode {
  707. __be16 di_magic; /* inode magic # = XFS_DINODE_MAGIC */
  708. __be16 di_mode; /* mode and type of file */
  709. __u8 di_version; /* inode version */
  710. __u8 di_format; /* format of di_c data */
  711. __be16 di_onlink; /* old number of links to file */
  712. __be32 di_uid; /* owner's user id */
  713. __be32 di_gid; /* owner's group id */
  714. __be32 di_nlink; /* number of links to file */
  715. __be16 di_projid_lo; /* lower part of owner's project id */
  716. __be16 di_projid_hi; /* higher part owner's project id */
  717. union {
  718. /* Number of data fork extents if NREXT64 is set */
  719. __be64 di_big_nextents;
  720. /* Padding for V3 inodes without NREXT64 set. */
  721. __be64 di_v3_pad;
  722. /* Padding and inode flush counter for V2 inodes. */
  723. struct {
  724. __u8 di_v2_pad[6];
  725. __be16 di_flushiter;
  726. };
  727. };
  728. xfs_timestamp_t di_atime; /* time last accessed */
  729. xfs_timestamp_t di_mtime; /* time last modified */
  730. xfs_timestamp_t di_ctime; /* time created/inode modified */
  731. __be64 di_size; /* number of bytes in file */
  732. __be64 di_nblocks; /* # of direct & btree blocks used */
  733. __be32 di_extsize; /* basic/minimum extent size for file */
  734. union {
  735. /*
  736. * For V2 inodes and V3 inodes without NREXT64 set, this
  737. * is the number of data and attr fork extents.
  738. */
  739. struct {
  740. __be32 di_nextents;
  741. __be16 di_anextents;
  742. } __packed;
  743. /* Number of attr fork extents if NREXT64 is set. */
  744. struct {
  745. __be32 di_big_anextents;
  746. __be16 di_nrext64_pad;
  747. } __packed;
  748. } __packed;
  749. __u8 di_forkoff; /* attr fork offs, <<3 for 64b align */
  750. __s8 di_aformat; /* format of attr fork's data */
  751. __be32 di_dmevmask; /* DMIG event mask */
  752. __be16 di_dmstate; /* DMIG state info */
  753. __be16 di_flags; /* random flags, XFS_DIFLAG_... */
  754. __be32 di_gen; /* generation number */
  755. /* di_next_unlinked is the only non-core field in the old dinode */
  756. __be32 di_next_unlinked;/* agi unlinked list ptr */
  757. /* start of the extended dinode, writable fields */
  758. __le32 di_crc; /* CRC of the inode */
  759. __be64 di_changecount; /* number of attribute changes */
  760. __be64 di_lsn; /* flush sequence */
  761. __be64 di_flags2; /* more random flags */
  762. __be32 di_cowextsize; /* basic cow extent size for file */
  763. __u8 di_pad2[12]; /* more padding for future expansion */
  764. /* fields only written to during inode creation */
  765. xfs_timestamp_t di_crtime; /* time created */
  766. __be64 di_ino; /* inode number */
  767. uuid_t di_uuid; /* UUID of the filesystem */
  768. /* structure must be padded to 64 bit alignment */
  769. };
  770. #define XFS_DINODE_CRC_OFF offsetof(struct xfs_dinode, di_crc)
  771. #define DI_MAX_FLUSH 0xffff
  772. /*
  773. * Size of the core inode on disk. Version 1 and 2 inodes have
  774. * the same size, but version 3 has grown a few additional fields.
  775. */
  776. static inline uint xfs_dinode_size(int version)
  777. {
  778. if (version == 3)
  779. return sizeof(struct xfs_dinode);
  780. return offsetof(struct xfs_dinode, di_crc);
  781. }
  782. /*
  783. * The 32 bit link count in the inode theoretically maxes out at UINT_MAX.
  784. * Since the pathconf interface is signed, we use 2^31 - 1 instead.
  785. */
  786. #define XFS_MAXLINK ((1U << 31) - 1U)
  787. /*
  788. * Values for di_format
  789. *
  790. * This enum is used in string mapping in xfs_trace.h; please keep the
  791. * TRACE_DEFINE_ENUMs for it up to date.
  792. */
  793. enum xfs_dinode_fmt {
  794. XFS_DINODE_FMT_DEV, /* xfs_dev_t */
  795. XFS_DINODE_FMT_LOCAL, /* bulk data */
  796. XFS_DINODE_FMT_EXTENTS, /* struct xfs_bmbt_rec */
  797. XFS_DINODE_FMT_BTREE, /* struct xfs_bmdr_block */
  798. XFS_DINODE_FMT_UUID /* added long ago, but never used */
  799. };
  800. #define XFS_INODE_FORMAT_STR \
  801. { XFS_DINODE_FMT_DEV, "dev" }, \
  802. { XFS_DINODE_FMT_LOCAL, "local" }, \
  803. { XFS_DINODE_FMT_EXTENTS, "extent" }, \
  804. { XFS_DINODE_FMT_BTREE, "btree" }, \
  805. { XFS_DINODE_FMT_UUID, "uuid" }
  806. /*
  807. * Max values for extnum and aextnum.
  808. *
  809. * The original on-disk extent counts were held in signed fields, resulting in
  810. * maximum extent counts of 2^31 and 2^15 for the data and attr forks
  811. * respectively. Similarly the maximum extent length is limited to 2^21 blocks
  812. * by the 21-bit wide blockcount field of a BMBT extent record.
  813. *
  814. * The newly introduced data fork extent counter can hold a 64-bit value,
  815. * however the maximum number of extents in a file is also limited to 2^54
  816. * extents by the 54-bit wide startoff field of a BMBT extent record.
  817. *
  818. * It is further limited by the maximum supported file size of 2^63
  819. * *bytes*. This leads to a maximum extent count for maximally sized filesystem
  820. * blocks (64kB) of:
  821. *
  822. * 2^63 bytes / 2^16 bytes per block = 2^47 blocks
  823. *
  824. * Rounding up 47 to the nearest multiple of bits-per-byte results in 48. Hence
  825. * 2^48 was chosen as the maximum data fork extent count.
  826. *
  827. * The maximum file size that can be represented by the data fork extent counter
  828. * in the worst case occurs when all extents are 1 block in length and each
  829. * block is 1KB in size.
  830. *
  831. * With XFS_MAX_EXTCNT_DATA_FORK_SMALL representing maximum extent count and
  832. * with 1KB sized blocks, a file can reach upto,
  833. * 1KB * (2^31) = 2TB
  834. *
  835. * This is much larger than the theoretical maximum size of a directory
  836. * i.e. XFS_DIR2_SPACE_SIZE * XFS_DIR2_MAX_SPACES = ~96GB.
  837. *
  838. * Hence, a directory inode can never overflow its data fork extent counter.
  839. */
  840. #define XFS_MAX_EXTCNT_DATA_FORK_LARGE ((xfs_extnum_t)((1ULL << 48) - 1))
  841. #define XFS_MAX_EXTCNT_ATTR_FORK_LARGE ((xfs_extnum_t)((1ULL << 32) - 1))
  842. #define XFS_MAX_EXTCNT_DATA_FORK_SMALL ((xfs_extnum_t)((1ULL << 31) - 1))
  843. #define XFS_MAX_EXTCNT_ATTR_FORK_SMALL ((xfs_extnum_t)((1ULL << 15) - 1))
  844. /*
  845. * When we upgrade an inode to the large extent counts, the maximum value by
  846. * which the extent count can increase is bound by the change in size of the
  847. * on-disk field. No upgrade operation should ever be adding more than a few
  848. * tens of extents, so if we get a really large value it is a sign of a code bug
  849. * or corruption.
  850. */
  851. #define XFS_MAX_EXTCNT_UPGRADE_NR \
  852. min(XFS_MAX_EXTCNT_ATTR_FORK_LARGE - XFS_MAX_EXTCNT_ATTR_FORK_SMALL, \
  853. XFS_MAX_EXTCNT_DATA_FORK_LARGE - XFS_MAX_EXTCNT_DATA_FORK_SMALL)
  854. /*
  855. * Inode minimum and maximum sizes.
  856. */
  857. #define XFS_DINODE_MIN_LOG 8
  858. #define XFS_DINODE_MAX_LOG 11
  859. #define XFS_DINODE_MIN_SIZE (1 << XFS_DINODE_MIN_LOG)
  860. #define XFS_DINODE_MAX_SIZE (1 << XFS_DINODE_MAX_LOG)
  861. /*
  862. * Inode size for given fs.
  863. */
  864. #define XFS_DINODE_SIZE(mp) \
  865. (xfs_has_v3inodes(mp) ? \
  866. sizeof(struct xfs_dinode) : \
  867. offsetof(struct xfs_dinode, di_crc))
  868. #define XFS_LITINO(mp) \
  869. ((mp)->m_sb.sb_inodesize - XFS_DINODE_SIZE(mp))
  870. /*
  871. * Inode data & attribute fork sizes, per inode.
  872. */
  873. #define XFS_DFORK_BOFF(dip) ((int)((dip)->di_forkoff << 3))
  874. #define XFS_DFORK_DSIZE(dip,mp) \
  875. ((dip)->di_forkoff ? XFS_DFORK_BOFF(dip) : XFS_LITINO(mp))
  876. #define XFS_DFORK_ASIZE(dip,mp) \
  877. ((dip)->di_forkoff ? XFS_LITINO(mp) - XFS_DFORK_BOFF(dip) : 0)
  878. #define XFS_DFORK_SIZE(dip,mp,w) \
  879. ((w) == XFS_DATA_FORK ? \
  880. XFS_DFORK_DSIZE(dip, mp) : \
  881. XFS_DFORK_ASIZE(dip, mp))
  882. #define XFS_DFORK_MAXEXT(dip, mp, w) \
  883. (XFS_DFORK_SIZE(dip, mp, w) / sizeof(struct xfs_bmbt_rec))
  884. /*
  885. * Return pointers to the data or attribute forks.
  886. */
  887. #define XFS_DFORK_DPTR(dip) \
  888. ((char *)dip + xfs_dinode_size(dip->di_version))
  889. #define XFS_DFORK_APTR(dip) \
  890. (XFS_DFORK_DPTR(dip) + XFS_DFORK_BOFF(dip))
  891. #define XFS_DFORK_PTR(dip,w) \
  892. ((w) == XFS_DATA_FORK ? XFS_DFORK_DPTR(dip) : XFS_DFORK_APTR(dip))
  893. #define XFS_DFORK_FORMAT(dip,w) \
  894. ((w) == XFS_DATA_FORK ? \
  895. (dip)->di_format : \
  896. (dip)->di_aformat)
  897. /*
  898. * For block and character special files the 32bit dev_t is stored at the
  899. * beginning of the data fork.
  900. */
  901. static inline xfs_dev_t xfs_dinode_get_rdev(struct xfs_dinode *dip)
  902. {
  903. return be32_to_cpu(*(__be32 *)XFS_DFORK_DPTR(dip));
  904. }
  905. static inline void xfs_dinode_put_rdev(struct xfs_dinode *dip, xfs_dev_t rdev)
  906. {
  907. *(__be32 *)XFS_DFORK_DPTR(dip) = cpu_to_be32(rdev);
  908. }
  909. /*
  910. * Values for di_flags
  911. */
  912. #define XFS_DIFLAG_REALTIME_BIT 0 /* file's blocks come from rt area */
  913. #define XFS_DIFLAG_PREALLOC_BIT 1 /* file space has been preallocated */
  914. #define XFS_DIFLAG_NEWRTBM_BIT 2 /* for rtbitmap inode, new format */
  915. #define XFS_DIFLAG_IMMUTABLE_BIT 3 /* inode is immutable */
  916. #define XFS_DIFLAG_APPEND_BIT 4 /* inode is append-only */
  917. #define XFS_DIFLAG_SYNC_BIT 5 /* inode is written synchronously */
  918. #define XFS_DIFLAG_NOATIME_BIT 6 /* do not update atime */
  919. #define XFS_DIFLAG_NODUMP_BIT 7 /* do not dump */
  920. #define XFS_DIFLAG_RTINHERIT_BIT 8 /* create with realtime bit set */
  921. #define XFS_DIFLAG_PROJINHERIT_BIT 9 /* create with parents projid */
  922. #define XFS_DIFLAG_NOSYMLINKS_BIT 10 /* disallow symlink creation */
  923. #define XFS_DIFLAG_EXTSIZE_BIT 11 /* inode extent size allocator hint */
  924. #define XFS_DIFLAG_EXTSZINHERIT_BIT 12 /* inherit inode extent size */
  925. #define XFS_DIFLAG_NODEFRAG_BIT 13 /* do not reorganize/defragment */
  926. #define XFS_DIFLAG_FILESTREAM_BIT 14 /* use filestream allocator */
  927. /* Do not use bit 15, di_flags is legacy and unchanging now */
  928. #define XFS_DIFLAG_REALTIME (1 << XFS_DIFLAG_REALTIME_BIT)
  929. #define XFS_DIFLAG_PREALLOC (1 << XFS_DIFLAG_PREALLOC_BIT)
  930. #define XFS_DIFLAG_NEWRTBM (1 << XFS_DIFLAG_NEWRTBM_BIT)
  931. #define XFS_DIFLAG_IMMUTABLE (1 << XFS_DIFLAG_IMMUTABLE_BIT)
  932. #define XFS_DIFLAG_APPEND (1 << XFS_DIFLAG_APPEND_BIT)
  933. #define XFS_DIFLAG_SYNC (1 << XFS_DIFLAG_SYNC_BIT)
  934. #define XFS_DIFLAG_NOATIME (1 << XFS_DIFLAG_NOATIME_BIT)
  935. #define XFS_DIFLAG_NODUMP (1 << XFS_DIFLAG_NODUMP_BIT)
  936. #define XFS_DIFLAG_RTINHERIT (1 << XFS_DIFLAG_RTINHERIT_BIT)
  937. #define XFS_DIFLAG_PROJINHERIT (1 << XFS_DIFLAG_PROJINHERIT_BIT)
  938. #define XFS_DIFLAG_NOSYMLINKS (1 << XFS_DIFLAG_NOSYMLINKS_BIT)
  939. #define XFS_DIFLAG_EXTSIZE (1 << XFS_DIFLAG_EXTSIZE_BIT)
  940. #define XFS_DIFLAG_EXTSZINHERIT (1 << XFS_DIFLAG_EXTSZINHERIT_BIT)
  941. #define XFS_DIFLAG_NODEFRAG (1 << XFS_DIFLAG_NODEFRAG_BIT)
  942. #define XFS_DIFLAG_FILESTREAM (1 << XFS_DIFLAG_FILESTREAM_BIT)
  943. #define XFS_DIFLAG_ANY \
  944. (XFS_DIFLAG_REALTIME | XFS_DIFLAG_PREALLOC | XFS_DIFLAG_NEWRTBM | \
  945. XFS_DIFLAG_IMMUTABLE | XFS_DIFLAG_APPEND | XFS_DIFLAG_SYNC | \
  946. XFS_DIFLAG_NOATIME | XFS_DIFLAG_NODUMP | XFS_DIFLAG_RTINHERIT | \
  947. XFS_DIFLAG_PROJINHERIT | XFS_DIFLAG_NOSYMLINKS | XFS_DIFLAG_EXTSIZE | \
  948. XFS_DIFLAG_EXTSZINHERIT | XFS_DIFLAG_NODEFRAG | XFS_DIFLAG_FILESTREAM)
  949. /*
  950. * Values for di_flags2 These start by being exposed to userspace in the upper
  951. * 16 bits of the XFS_XFLAG_s range.
  952. */
  953. #define XFS_DIFLAG2_DAX_BIT 0 /* use DAX for this inode */
  954. #define XFS_DIFLAG2_REFLINK_BIT 1 /* file's blocks may be shared */
  955. #define XFS_DIFLAG2_COWEXTSIZE_BIT 2 /* copy on write extent size hint */
  956. #define XFS_DIFLAG2_BIGTIME_BIT 3 /* big timestamps */
  957. #define XFS_DIFLAG2_NREXT64_BIT 4 /* large extent counters */
  958. #define XFS_DIFLAG2_DAX (1 << XFS_DIFLAG2_DAX_BIT)
  959. #define XFS_DIFLAG2_REFLINK (1 << XFS_DIFLAG2_REFLINK_BIT)
  960. #define XFS_DIFLAG2_COWEXTSIZE (1 << XFS_DIFLAG2_COWEXTSIZE_BIT)
  961. #define XFS_DIFLAG2_BIGTIME (1 << XFS_DIFLAG2_BIGTIME_BIT)
  962. #define XFS_DIFLAG2_NREXT64 (1 << XFS_DIFLAG2_NREXT64_BIT)
  963. #define XFS_DIFLAG2_ANY \
  964. (XFS_DIFLAG2_DAX | XFS_DIFLAG2_REFLINK | XFS_DIFLAG2_COWEXTSIZE | \
  965. XFS_DIFLAG2_BIGTIME | XFS_DIFLAG2_NREXT64)
  966. static inline bool xfs_dinode_has_bigtime(const struct xfs_dinode *dip)
  967. {
  968. return dip->di_version >= 3 &&
  969. (dip->di_flags2 & cpu_to_be64(XFS_DIFLAG2_BIGTIME));
  970. }
  971. static inline bool xfs_dinode_has_large_extent_counts(
  972. const struct xfs_dinode *dip)
  973. {
  974. return dip->di_version >= 3 &&
  975. (dip->di_flags2 & cpu_to_be64(XFS_DIFLAG2_NREXT64));
  976. }
  977. /*
  978. * Inode number format:
  979. * low inopblog bits - offset in block
  980. * next agblklog bits - block number in ag
  981. * next agno_log bits - ag number
  982. * high agno_log-agblklog-inopblog bits - 0
  983. */
  984. #define XFS_INO_MASK(k) (uint32_t)((1ULL << (k)) - 1)
  985. #define XFS_INO_OFFSET_BITS(mp) (mp)->m_sb.sb_inopblog
  986. #define XFS_INO_AGBNO_BITS(mp) (mp)->m_sb.sb_agblklog
  987. #define XFS_INO_AGINO_BITS(mp) ((mp)->m_ino_geo.agino_log)
  988. #define XFS_INO_AGNO_BITS(mp) (mp)->m_agno_log
  989. #define XFS_INO_BITS(mp) \
  990. XFS_INO_AGNO_BITS(mp) + XFS_INO_AGINO_BITS(mp)
  991. #define XFS_INO_TO_AGNO(mp,i) \
  992. ((xfs_agnumber_t)((i) >> XFS_INO_AGINO_BITS(mp)))
  993. #define XFS_INO_TO_AGINO(mp,i) \
  994. ((xfs_agino_t)(i) & XFS_INO_MASK(XFS_INO_AGINO_BITS(mp)))
  995. #define XFS_INO_TO_AGBNO(mp,i) \
  996. (((xfs_agblock_t)(i) >> XFS_INO_OFFSET_BITS(mp)) & \
  997. XFS_INO_MASK(XFS_INO_AGBNO_BITS(mp)))
  998. #define XFS_INO_TO_OFFSET(mp,i) \
  999. ((int)(i) & XFS_INO_MASK(XFS_INO_OFFSET_BITS(mp)))
  1000. #define XFS_INO_TO_FSB(mp,i) \
  1001. XFS_AGB_TO_FSB(mp, XFS_INO_TO_AGNO(mp,i), XFS_INO_TO_AGBNO(mp,i))
  1002. #define XFS_AGINO_TO_INO(mp,a,i) \
  1003. (((xfs_ino_t)(a) << XFS_INO_AGINO_BITS(mp)) | (i))
  1004. #define XFS_AGINO_TO_AGBNO(mp,i) ((i) >> XFS_INO_OFFSET_BITS(mp))
  1005. #define XFS_AGINO_TO_OFFSET(mp,i) \
  1006. ((i) & XFS_INO_MASK(XFS_INO_OFFSET_BITS(mp)))
  1007. #define XFS_OFFBNO_TO_AGINO(mp,b,o) \
  1008. ((xfs_agino_t)(((b) << XFS_INO_OFFSET_BITS(mp)) | (o)))
  1009. #define XFS_FSB_TO_INO(mp, b) ((xfs_ino_t)((b) << XFS_INO_OFFSET_BITS(mp)))
  1010. #define XFS_AGB_TO_AGINO(mp, b) ((xfs_agino_t)((b) << XFS_INO_OFFSET_BITS(mp)))
  1011. #define XFS_MAXINUMBER ((xfs_ino_t)((1ULL << 56) - 1ULL))
  1012. #define XFS_MAXINUMBER_32 ((xfs_ino_t)((1ULL << 32) - 1ULL))
  1013. /*
  1014. * RealTime Device format definitions
  1015. */
  1016. /* Min and max rt extent sizes, specified in bytes */
  1017. #define XFS_MAX_RTEXTSIZE (1024 * 1024 * 1024) /* 1GB */
  1018. #define XFS_DFL_RTEXTSIZE (64 * 1024) /* 64kB */
  1019. #define XFS_MIN_RTEXTSIZE (4 * 1024) /* 4kB */
  1020. #define XFS_BLOCKSIZE(mp) ((mp)->m_sb.sb_blocksize)
  1021. #define XFS_BLOCKMASK(mp) ((mp)->m_blockmask)
  1022. #define XFS_BLOCKWSIZE(mp) ((mp)->m_blockwsize)
  1023. #define XFS_BLOCKWMASK(mp) ((mp)->m_blockwmask)
  1024. /*
  1025. * RT Summary and bit manipulation macros.
  1026. */
  1027. #define XFS_SUMOFFS(mp,ls,bb) ((int)((ls) * (mp)->m_sb.sb_rbmblocks + (bb)))
  1028. #define XFS_SUMOFFSTOBLOCK(mp,s) \
  1029. (((s) * (uint)sizeof(xfs_suminfo_t)) >> (mp)->m_sb.sb_blocklog)
  1030. #define XFS_SUMPTR(mp,bp,so) \
  1031. ((xfs_suminfo_t *)((bp)->b_addr + \
  1032. (((so) * (uint)sizeof(xfs_suminfo_t)) & XFS_BLOCKMASK(mp))))
  1033. #define XFS_BITTOBLOCK(mp,bi) ((bi) >> (mp)->m_blkbit_log)
  1034. #define XFS_BLOCKTOBIT(mp,bb) ((bb) << (mp)->m_blkbit_log)
  1035. #define XFS_BITTOWORD(mp,bi) \
  1036. ((int)(((bi) >> XFS_NBWORDLOG) & XFS_BLOCKWMASK(mp)))
  1037. #define XFS_RTMIN(a,b) ((a) < (b) ? (a) : (b))
  1038. #define XFS_RTMAX(a,b) ((a) > (b) ? (a) : (b))
  1039. #define XFS_RTLOBIT(w) xfs_lowbit32(w)
  1040. #define XFS_RTHIBIT(w) xfs_highbit32(w)
  1041. #define XFS_RTBLOCKLOG(b) xfs_highbit64(b)
  1042. /*
  1043. * Dquot and dquot block format definitions
  1044. */
  1045. #define XFS_DQUOT_MAGIC 0x4451 /* 'DQ' */
  1046. #define XFS_DQUOT_VERSION (uint8_t)0x01 /* latest version number */
  1047. #define XFS_DQTYPE_USER (1u << 0) /* user dquot record */
  1048. #define XFS_DQTYPE_PROJ (1u << 1) /* project dquot record */
  1049. #define XFS_DQTYPE_GROUP (1u << 2) /* group dquot record */
  1050. #define XFS_DQTYPE_BIGTIME (1u << 7) /* large expiry timestamps */
  1051. /* bitmask to determine if this is a user/group/project dquot */
  1052. #define XFS_DQTYPE_REC_MASK (XFS_DQTYPE_USER | \
  1053. XFS_DQTYPE_PROJ | \
  1054. XFS_DQTYPE_GROUP)
  1055. #define XFS_DQTYPE_ANY (XFS_DQTYPE_REC_MASK | \
  1056. XFS_DQTYPE_BIGTIME)
  1057. /*
  1058. * XFS Quota Timers
  1059. * ================
  1060. *
  1061. * Traditional quota grace period expiration timers are an unsigned 32-bit
  1062. * seconds counter; time zero is the Unix epoch, Jan 1 00:00:01 UTC 1970.
  1063. * Note that an expiration value of zero means that the quota limit has not
  1064. * been reached, and therefore no expiration has been set. Therefore, the
  1065. * ondisk min and max defined here can be used directly to constrain the incore
  1066. * quota expiration timestamps on a Unix system.
  1067. *
  1068. * When bigtime is enabled, we trade two bits of precision to expand the
  1069. * expiration timeout range to match that of big inode timestamps. The min and
  1070. * max recorded here are the on-disk limits, not a Unix timestamp.
  1071. *
  1072. * The grace period for each quota type is stored in the root dquot (id = 0)
  1073. * and is applied to a non-root dquot when it exceeds the soft or hard limits.
  1074. * The length of quota grace periods are unsigned 32-bit quantities measured in
  1075. * units of seconds. A value of zero means to use the default period.
  1076. */
  1077. /*
  1078. * Smallest possible ondisk quota expiration value with traditional timestamps.
  1079. * This corresponds exactly with the incore expiration Jan 1 00:00:01 UTC 1970.
  1080. */
  1081. #define XFS_DQ_LEGACY_EXPIRY_MIN ((int64_t)1)
  1082. /*
  1083. * Largest possible ondisk quota expiration value with traditional timestamps.
  1084. * This corresponds exactly with the incore expiration Feb 7 06:28:15 UTC 2106.
  1085. */
  1086. #define XFS_DQ_LEGACY_EXPIRY_MAX ((int64_t)U32_MAX)
  1087. /*
  1088. * Smallest possible ondisk quota expiration value with bigtime timestamps.
  1089. * This corresponds (after conversion to a Unix timestamp) with the incore
  1090. * expiration of Jan 1 00:00:04 UTC 1970.
  1091. */
  1092. #define XFS_DQ_BIGTIME_EXPIRY_MIN (XFS_DQ_LEGACY_EXPIRY_MIN)
  1093. /*
  1094. * Largest supported ondisk quota expiration value with bigtime timestamps.
  1095. * This corresponds (after conversion to a Unix timestamp) with an incore
  1096. * expiration of Jul 2 20:20:24 UTC 2486.
  1097. *
  1098. * The ondisk field supports values up to -1U, which corresponds to an incore
  1099. * expiration in 2514. This is beyond the maximum the bigtime inode timestamp,
  1100. * so we cap the maximum bigtime quota expiration to the max inode timestamp.
  1101. */
  1102. #define XFS_DQ_BIGTIME_EXPIRY_MAX ((int64_t)4074815106U)
  1103. /*
  1104. * The following conversion factors assist in converting a quota expiration
  1105. * timestamp between the incore and ondisk formats.
  1106. */
  1107. #define XFS_DQ_BIGTIME_SHIFT (2)
  1108. #define XFS_DQ_BIGTIME_SLACK ((int64_t)(1ULL << XFS_DQ_BIGTIME_SHIFT) - 1)
  1109. /* Convert an incore quota expiration timestamp to an ondisk bigtime value. */
  1110. static inline uint32_t xfs_dq_unix_to_bigtime(time64_t unix_seconds)
  1111. {
  1112. /*
  1113. * Round the expiration timestamp up to the nearest bigtime timestamp
  1114. * that we can store, to give users the most time to fix problems.
  1115. */
  1116. return ((uint64_t)unix_seconds + XFS_DQ_BIGTIME_SLACK) >>
  1117. XFS_DQ_BIGTIME_SHIFT;
  1118. }
  1119. /* Convert an ondisk bigtime quota expiration value to an incore timestamp. */
  1120. static inline time64_t xfs_dq_bigtime_to_unix(uint32_t ondisk_seconds)
  1121. {
  1122. return (time64_t)ondisk_seconds << XFS_DQ_BIGTIME_SHIFT;
  1123. }
  1124. /*
  1125. * Default quota grace periods, ranging from zero (use the compiled defaults)
  1126. * to ~136 years. These are applied to a non-root dquot that has exceeded
  1127. * either limit.
  1128. */
  1129. #define XFS_DQ_GRACE_MIN ((int64_t)0)
  1130. #define XFS_DQ_GRACE_MAX ((int64_t)U32_MAX)
  1131. /*
  1132. * This is the main portion of the on-disk representation of quota information
  1133. * for a user. We pad this with some more expansion room to construct the on
  1134. * disk structure.
  1135. */
  1136. struct xfs_disk_dquot {
  1137. __be16 d_magic; /* dquot magic = XFS_DQUOT_MAGIC */
  1138. __u8 d_version; /* dquot version */
  1139. __u8 d_type; /* XFS_DQTYPE_USER/PROJ/GROUP */
  1140. __be32 d_id; /* user,project,group id */
  1141. __be64 d_blk_hardlimit;/* absolute limit on disk blks */
  1142. __be64 d_blk_softlimit;/* preferred limit on disk blks */
  1143. __be64 d_ino_hardlimit;/* maximum # allocated inodes */
  1144. __be64 d_ino_softlimit;/* preferred inode limit */
  1145. __be64 d_bcount; /* disk blocks owned by the user */
  1146. __be64 d_icount; /* inodes owned by the user */
  1147. __be32 d_itimer; /* zero if within inode limits if not,
  1148. this is when we refuse service */
  1149. __be32 d_btimer; /* similar to above; for disk blocks */
  1150. __be16 d_iwarns; /* warnings issued wrt num inodes */
  1151. __be16 d_bwarns; /* warnings issued wrt disk blocks */
  1152. __be32 d_pad0; /* 64 bit align */
  1153. __be64 d_rtb_hardlimit;/* absolute limit on realtime blks */
  1154. __be64 d_rtb_softlimit;/* preferred limit on RT disk blks */
  1155. __be64 d_rtbcount; /* realtime blocks owned */
  1156. __be32 d_rtbtimer; /* similar to above; for RT disk blocks */
  1157. __be16 d_rtbwarns; /* warnings issued wrt RT disk blocks */
  1158. __be16 d_pad;
  1159. };
  1160. /*
  1161. * This is what goes on disk. This is separated from the xfs_disk_dquot because
  1162. * carrying the unnecessary padding would be a waste of memory.
  1163. */
  1164. struct xfs_dqblk {
  1165. struct xfs_disk_dquot dd_diskdq; /* portion living incore as well */
  1166. char dd_fill[4];/* filling for posterity */
  1167. /*
  1168. * These two are only present on filesystems with the CRC bits set.
  1169. */
  1170. __be32 dd_crc; /* checksum */
  1171. __be64 dd_lsn; /* last modification in log */
  1172. uuid_t dd_uuid; /* location information */
  1173. };
  1174. #define XFS_DQUOT_CRC_OFF offsetof(struct xfs_dqblk, dd_crc)
  1175. /*
  1176. * This defines the unit of allocation of dquots.
  1177. *
  1178. * Currently, it is just one file system block, and a 4K blk contains 30
  1179. * (136 * 30 = 4080) dquots. It's probably not worth trying to make
  1180. * this more dynamic.
  1181. *
  1182. * However, if this number is changed, we have to make sure that we don't
  1183. * implicitly assume that we do allocations in chunks of a single filesystem
  1184. * block in the dquot/xqm code.
  1185. *
  1186. * This is part of the ondisk format because the structure size is not a power
  1187. * of two, which leaves slack at the end of the disk block.
  1188. */
  1189. #define XFS_DQUOT_CLUSTER_SIZE_FSB (xfs_filblks_t)1
  1190. /*
  1191. * Remote symlink format and access functions.
  1192. */
  1193. #define XFS_SYMLINK_MAGIC 0x58534c4d /* XSLM */
  1194. struct xfs_dsymlink_hdr {
  1195. __be32 sl_magic;
  1196. __be32 sl_offset;
  1197. __be32 sl_bytes;
  1198. __be32 sl_crc;
  1199. uuid_t sl_uuid;
  1200. __be64 sl_owner;
  1201. __be64 sl_blkno;
  1202. __be64 sl_lsn;
  1203. };
  1204. #define XFS_SYMLINK_CRC_OFF offsetof(struct xfs_dsymlink_hdr, sl_crc)
  1205. #define XFS_SYMLINK_MAXLEN 1024
  1206. /*
  1207. * The maximum pathlen is 1024 bytes. Since the minimum file system
  1208. * blocksize is 512 bytes, we can get a max of 3 extents back from
  1209. * bmapi when crc headers are taken into account.
  1210. */
  1211. #define XFS_SYMLINK_MAPS 3
  1212. #define XFS_SYMLINK_BUF_SPACE(mp, bufsize) \
  1213. ((bufsize) - (xfs_has_crc((mp)) ? \
  1214. sizeof(struct xfs_dsymlink_hdr) : 0))
  1215. /*
  1216. * Allocation Btree format definitions
  1217. *
  1218. * There are two on-disk btrees, one sorted by blockno and one sorted
  1219. * by blockcount and blockno. All blocks look the same to make the code
  1220. * simpler; if we have time later, we'll make the optimizations.
  1221. */
  1222. #define XFS_ABTB_MAGIC 0x41425442 /* 'ABTB' for bno tree */
  1223. #define XFS_ABTB_CRC_MAGIC 0x41423342 /* 'AB3B' */
  1224. #define XFS_ABTC_MAGIC 0x41425443 /* 'ABTC' for cnt tree */
  1225. #define XFS_ABTC_CRC_MAGIC 0x41423343 /* 'AB3C' */
  1226. /*
  1227. * Data record/key structure
  1228. */
  1229. typedef struct xfs_alloc_rec {
  1230. __be32 ar_startblock; /* starting block number */
  1231. __be32 ar_blockcount; /* count of free blocks */
  1232. } xfs_alloc_rec_t, xfs_alloc_key_t;
  1233. typedef struct xfs_alloc_rec_incore {
  1234. xfs_agblock_t ar_startblock; /* starting block number */
  1235. xfs_extlen_t ar_blockcount; /* count of free blocks */
  1236. } xfs_alloc_rec_incore_t;
  1237. /* btree pointer type */
  1238. typedef __be32 xfs_alloc_ptr_t;
  1239. /*
  1240. * Block numbers in the AG:
  1241. * SB is sector 0, AGF is sector 1, AGI is sector 2, AGFL is sector 3.
  1242. */
  1243. #define XFS_BNO_BLOCK(mp) ((xfs_agblock_t)(XFS_AGFL_BLOCK(mp) + 1))
  1244. #define XFS_CNT_BLOCK(mp) ((xfs_agblock_t)(XFS_BNO_BLOCK(mp) + 1))
  1245. /*
  1246. * Inode Allocation Btree format definitions
  1247. *
  1248. * There is a btree for the inode map per allocation group.
  1249. */
  1250. #define XFS_IBT_MAGIC 0x49414254 /* 'IABT' */
  1251. #define XFS_IBT_CRC_MAGIC 0x49414233 /* 'IAB3' */
  1252. #define XFS_FIBT_MAGIC 0x46494254 /* 'FIBT' */
  1253. #define XFS_FIBT_CRC_MAGIC 0x46494233 /* 'FIB3' */
  1254. typedef uint64_t xfs_inofree_t;
  1255. #define XFS_INODES_PER_CHUNK (NBBY * sizeof(xfs_inofree_t))
  1256. #define XFS_INODES_PER_CHUNK_LOG (XFS_NBBYLOG + 3)
  1257. #define XFS_INOBT_ALL_FREE ((xfs_inofree_t)-1)
  1258. #define XFS_INOBT_MASK(i) ((xfs_inofree_t)1 << (i))
  1259. #define XFS_INOBT_HOLEMASK_FULL 0 /* holemask for full chunk */
  1260. #define XFS_INOBT_HOLEMASK_BITS (NBBY * sizeof(uint16_t))
  1261. #define XFS_INODES_PER_HOLEMASK_BIT \
  1262. (XFS_INODES_PER_CHUNK / (NBBY * sizeof(uint16_t)))
  1263. static inline xfs_inofree_t xfs_inobt_maskn(int i, int n)
  1264. {
  1265. return ((n >= XFS_INODES_PER_CHUNK ? 0 : XFS_INOBT_MASK(n)) - 1) << i;
  1266. }
  1267. /*
  1268. * The on-disk inode record structure has two formats. The original "full"
  1269. * format uses a 4-byte freecount. The "sparse" format uses a 1-byte freecount
  1270. * and replaces the 3 high-order freecount bytes wth the holemask and inode
  1271. * count.
  1272. *
  1273. * The holemask of the sparse record format allows an inode chunk to have holes
  1274. * that refer to blocks not owned by the inode record. This facilitates inode
  1275. * allocation in the event of severe free space fragmentation.
  1276. */
  1277. typedef struct xfs_inobt_rec {
  1278. __be32 ir_startino; /* starting inode number */
  1279. union {
  1280. struct {
  1281. __be32 ir_freecount; /* count of free inodes */
  1282. } f;
  1283. struct {
  1284. __be16 ir_holemask;/* hole mask for sparse chunks */
  1285. __u8 ir_count; /* total inode count */
  1286. __u8 ir_freecount; /* count of free inodes */
  1287. } sp;
  1288. } ir_u;
  1289. __be64 ir_free; /* free inode mask */
  1290. } xfs_inobt_rec_t;
  1291. typedef struct xfs_inobt_rec_incore {
  1292. xfs_agino_t ir_startino; /* starting inode number */
  1293. uint16_t ir_holemask; /* hole mask for sparse chunks */
  1294. uint8_t ir_count; /* total inode count */
  1295. uint8_t ir_freecount; /* count of free inodes (set bits) */
  1296. xfs_inofree_t ir_free; /* free inode mask */
  1297. } xfs_inobt_rec_incore_t;
  1298. static inline bool xfs_inobt_issparse(uint16_t holemask)
  1299. {
  1300. /* non-zero holemask represents a sparse rec. */
  1301. return holemask;
  1302. }
  1303. /*
  1304. * Key structure
  1305. */
  1306. typedef struct xfs_inobt_key {
  1307. __be32 ir_startino; /* starting inode number */
  1308. } xfs_inobt_key_t;
  1309. /* btree pointer type */
  1310. typedef __be32 xfs_inobt_ptr_t;
  1311. /*
  1312. * block numbers in the AG.
  1313. */
  1314. #define XFS_IBT_BLOCK(mp) ((xfs_agblock_t)(XFS_CNT_BLOCK(mp) + 1))
  1315. #define XFS_FIBT_BLOCK(mp) ((xfs_agblock_t)(XFS_IBT_BLOCK(mp) + 1))
  1316. /*
  1317. * Reverse mapping btree format definitions
  1318. *
  1319. * There is a btree for the reverse map per allocation group
  1320. */
  1321. #define XFS_RMAP_CRC_MAGIC 0x524d4233 /* 'RMB3' */
  1322. /*
  1323. * Ownership info for an extent. This is used to create reverse-mapping
  1324. * entries.
  1325. */
  1326. #define XFS_OWNER_INFO_ATTR_FORK (1 << 0)
  1327. #define XFS_OWNER_INFO_BMBT_BLOCK (1 << 1)
  1328. struct xfs_owner_info {
  1329. uint64_t oi_owner;
  1330. xfs_fileoff_t oi_offset;
  1331. unsigned int oi_flags;
  1332. };
  1333. /*
  1334. * Special owner types.
  1335. *
  1336. * Seeing as we only support up to 8EB, we have the upper bit of the owner field
  1337. * to tell us we have a special owner value. We use these for static metadata
  1338. * allocated at mkfs/growfs time, as well as for freespace management metadata.
  1339. */
  1340. #define XFS_RMAP_OWN_NULL (-1ULL) /* No owner, for growfs */
  1341. #define XFS_RMAP_OWN_UNKNOWN (-2ULL) /* Unknown owner, for EFI recovery */
  1342. #define XFS_RMAP_OWN_FS (-3ULL) /* static fs metadata */
  1343. #define XFS_RMAP_OWN_LOG (-4ULL) /* static fs metadata */
  1344. #define XFS_RMAP_OWN_AG (-5ULL) /* AG freespace btree blocks */
  1345. #define XFS_RMAP_OWN_INOBT (-6ULL) /* Inode btree blocks */
  1346. #define XFS_RMAP_OWN_INODES (-7ULL) /* Inode chunk */
  1347. #define XFS_RMAP_OWN_REFC (-8ULL) /* refcount tree */
  1348. #define XFS_RMAP_OWN_COW (-9ULL) /* cow allocations */
  1349. #define XFS_RMAP_OWN_MIN (-10ULL) /* guard */
  1350. #define XFS_RMAP_NON_INODE_OWNER(owner) (!!((owner) & (1ULL << 63)))
  1351. /*
  1352. * Data record structure
  1353. */
  1354. struct xfs_rmap_rec {
  1355. __be32 rm_startblock; /* extent start block */
  1356. __be32 rm_blockcount; /* extent length */
  1357. __be64 rm_owner; /* extent owner */
  1358. __be64 rm_offset; /* offset within the owner */
  1359. };
  1360. /*
  1361. * rmap btree record
  1362. * rm_offset:63 is the attribute fork flag
  1363. * rm_offset:62 is the bmbt block flag
  1364. * rm_offset:61 is the unwritten extent flag (same as l0:63 in bmbt)
  1365. * rm_offset:54-60 aren't used and should be zero
  1366. * rm_offset:0-53 is the block offset within the inode
  1367. */
  1368. #define XFS_RMAP_OFF_ATTR_FORK ((uint64_t)1ULL << 63)
  1369. #define XFS_RMAP_OFF_BMBT_BLOCK ((uint64_t)1ULL << 62)
  1370. #define XFS_RMAP_OFF_UNWRITTEN ((uint64_t)1ULL << 61)
  1371. #define XFS_RMAP_LEN_MAX ((uint32_t)~0U)
  1372. #define XFS_RMAP_OFF_FLAGS (XFS_RMAP_OFF_ATTR_FORK | \
  1373. XFS_RMAP_OFF_BMBT_BLOCK | \
  1374. XFS_RMAP_OFF_UNWRITTEN)
  1375. #define XFS_RMAP_OFF_MASK ((uint64_t)0x3FFFFFFFFFFFFFULL)
  1376. #define XFS_RMAP_OFF(off) ((off) & XFS_RMAP_OFF_MASK)
  1377. #define XFS_RMAP_IS_BMBT_BLOCK(off) (!!((off) & XFS_RMAP_OFF_BMBT_BLOCK))
  1378. #define XFS_RMAP_IS_ATTR_FORK(off) (!!((off) & XFS_RMAP_OFF_ATTR_FORK))
  1379. #define XFS_RMAP_IS_UNWRITTEN(len) (!!((off) & XFS_RMAP_OFF_UNWRITTEN))
  1380. #define RMAPBT_STARTBLOCK_BITLEN 32
  1381. #define RMAPBT_BLOCKCOUNT_BITLEN 32
  1382. #define RMAPBT_OWNER_BITLEN 64
  1383. #define RMAPBT_ATTRFLAG_BITLEN 1
  1384. #define RMAPBT_BMBTFLAG_BITLEN 1
  1385. #define RMAPBT_EXNTFLAG_BITLEN 1
  1386. #define RMAPBT_UNUSED_OFFSET_BITLEN 7
  1387. #define RMAPBT_OFFSET_BITLEN 54
  1388. /*
  1389. * Key structure
  1390. *
  1391. * We don't use the length for lookups
  1392. */
  1393. struct xfs_rmap_key {
  1394. __be32 rm_startblock; /* extent start block */
  1395. __be64 rm_owner; /* extent owner */
  1396. __be64 rm_offset; /* offset within the owner */
  1397. } __attribute__((packed));
  1398. /* btree pointer type */
  1399. typedef __be32 xfs_rmap_ptr_t;
  1400. #define XFS_RMAP_BLOCK(mp) \
  1401. (xfs_has_finobt(((mp))) ? \
  1402. XFS_FIBT_BLOCK(mp) + 1 : \
  1403. XFS_IBT_BLOCK(mp) + 1)
  1404. /*
  1405. * Reference Count Btree format definitions
  1406. *
  1407. */
  1408. #define XFS_REFC_CRC_MAGIC 0x52334643 /* 'R3FC' */
  1409. unsigned int xfs_refc_block(struct xfs_mount *mp);
  1410. /*
  1411. * Data record/key structure
  1412. *
  1413. * Each record associates a range of physical blocks (starting at
  1414. * rc_startblock and ending rc_blockcount blocks later) with a reference
  1415. * count (rc_refcount). Extents that are being used to stage a copy on
  1416. * write (CoW) operation are recorded in the refcount btree with a
  1417. * refcount of 1. All other records must have a refcount > 1 and must
  1418. * track an extent mapped only by file data forks.
  1419. *
  1420. * Extents with a single owner (attributes, metadata, non-shared file
  1421. * data) are not tracked here. Free space is also not tracked here.
  1422. * This is consistent with pre-reflink XFS.
  1423. */
  1424. /*
  1425. * Extents that are being used to stage a copy on write are stored
  1426. * in the refcount btree with a refcount of 1 and the upper bit set
  1427. * on the startblock. This speeds up mount time deletion of stale
  1428. * staging extents because they're all at the right side of the tree.
  1429. */
  1430. #define XFS_REFC_COWFLAG (1U << 31)
  1431. #define REFCNTBT_COWFLAG_BITLEN 1
  1432. #define REFCNTBT_AGBLOCK_BITLEN 31
  1433. struct xfs_refcount_rec {
  1434. __be32 rc_startblock; /* starting block number */
  1435. __be32 rc_blockcount; /* count of blocks */
  1436. __be32 rc_refcount; /* number of inodes linked here */
  1437. };
  1438. struct xfs_refcount_key {
  1439. __be32 rc_startblock; /* starting block number */
  1440. };
  1441. #define MAXREFCOUNT ((xfs_nlink_t)~0U)
  1442. #define MAXREFCEXTLEN ((xfs_extlen_t)~0U)
  1443. /* btree pointer type */
  1444. typedef __be32 xfs_refcount_ptr_t;
  1445. /*
  1446. * BMAP Btree format definitions
  1447. *
  1448. * This includes both the root block definition that sits inside an inode fork
  1449. * and the record/pointer formats for the leaf/node in the blocks.
  1450. */
  1451. #define XFS_BMAP_MAGIC 0x424d4150 /* 'BMAP' */
  1452. #define XFS_BMAP_CRC_MAGIC 0x424d4133 /* 'BMA3' */
  1453. /*
  1454. * Bmap root header, on-disk form only.
  1455. */
  1456. typedef struct xfs_bmdr_block {
  1457. __be16 bb_level; /* 0 is a leaf */
  1458. __be16 bb_numrecs; /* current # of data records */
  1459. } xfs_bmdr_block_t;
  1460. /*
  1461. * Bmap btree record and extent descriptor.
  1462. * l0:63 is an extent flag (value 1 indicates non-normal).
  1463. * l0:9-62 are startoff.
  1464. * l0:0-8 and l1:21-63 are startblock.
  1465. * l1:0-20 are blockcount.
  1466. */
  1467. #define BMBT_EXNTFLAG_BITLEN 1
  1468. #define BMBT_STARTOFF_BITLEN 54
  1469. #define BMBT_STARTBLOCK_BITLEN 52
  1470. #define BMBT_BLOCKCOUNT_BITLEN 21
  1471. #define BMBT_STARTOFF_MASK ((1ULL << BMBT_STARTOFF_BITLEN) - 1)
  1472. #define BMBT_BLOCKCOUNT_MASK ((1ULL << BMBT_BLOCKCOUNT_BITLEN) - 1)
  1473. #define XFS_MAX_BMBT_EXTLEN ((xfs_extlen_t)(BMBT_BLOCKCOUNT_MASK))
  1474. /*
  1475. * bmbt records have a file offset (block) field that is 54 bits wide, so this
  1476. * is the largest xfs_fileoff_t that we ever expect to see.
  1477. */
  1478. #define XFS_MAX_FILEOFF (BMBT_STARTOFF_MASK + BMBT_BLOCKCOUNT_MASK)
  1479. typedef struct xfs_bmbt_rec {
  1480. __be64 l0, l1;
  1481. } xfs_bmbt_rec_t;
  1482. typedef uint64_t xfs_bmbt_rec_base_t; /* use this for casts */
  1483. typedef xfs_bmbt_rec_t xfs_bmdr_rec_t;
  1484. /*
  1485. * Values and macros for delayed-allocation startblock fields.
  1486. */
  1487. #define STARTBLOCKVALBITS 17
  1488. #define STARTBLOCKMASKBITS (15 + 20)
  1489. #define STARTBLOCKMASK \
  1490. (((((xfs_fsblock_t)1) << STARTBLOCKMASKBITS) - 1) << STARTBLOCKVALBITS)
  1491. static inline int isnullstartblock(xfs_fsblock_t x)
  1492. {
  1493. return ((x) & STARTBLOCKMASK) == STARTBLOCKMASK;
  1494. }
  1495. static inline xfs_fsblock_t nullstartblock(int k)
  1496. {
  1497. ASSERT(k < (1 << STARTBLOCKVALBITS));
  1498. return STARTBLOCKMASK | (k);
  1499. }
  1500. static inline xfs_filblks_t startblockval(xfs_fsblock_t x)
  1501. {
  1502. return (xfs_filblks_t)((x) & ~STARTBLOCKMASK);
  1503. }
  1504. /*
  1505. * Key structure for non-leaf levels of the tree.
  1506. */
  1507. typedef struct xfs_bmbt_key {
  1508. __be64 br_startoff; /* starting file offset */
  1509. } xfs_bmbt_key_t, xfs_bmdr_key_t;
  1510. /* btree pointer type */
  1511. typedef __be64 xfs_bmbt_ptr_t, xfs_bmdr_ptr_t;
  1512. /*
  1513. * Generic Btree block format definitions
  1514. *
  1515. * This is a combination of the actual format used on disk for short and long
  1516. * format btrees. The first three fields are shared by both format, but the
  1517. * pointers are different and should be used with care.
  1518. *
  1519. * To get the size of the actual short or long form headers please use the size
  1520. * macros below. Never use sizeof(xfs_btree_block).
  1521. *
  1522. * The blkno, crc, lsn, owner and uuid fields are only available in filesystems
  1523. * with the crc feature bit, and all accesses to them must be conditional on
  1524. * that flag.
  1525. */
  1526. /* short form block header */
  1527. struct xfs_btree_block_shdr {
  1528. __be32 bb_leftsib;
  1529. __be32 bb_rightsib;
  1530. __be64 bb_blkno;
  1531. __be64 bb_lsn;
  1532. uuid_t bb_uuid;
  1533. __be32 bb_owner;
  1534. __le32 bb_crc;
  1535. };
  1536. /* long form block header */
  1537. struct xfs_btree_block_lhdr {
  1538. __be64 bb_leftsib;
  1539. __be64 bb_rightsib;
  1540. __be64 bb_blkno;
  1541. __be64 bb_lsn;
  1542. uuid_t bb_uuid;
  1543. __be64 bb_owner;
  1544. __le32 bb_crc;
  1545. __be32 bb_pad; /* padding for alignment */
  1546. };
  1547. struct xfs_btree_block {
  1548. __be32 bb_magic; /* magic number for block type */
  1549. __be16 bb_level; /* 0 is a leaf */
  1550. __be16 bb_numrecs; /* current # of data records */
  1551. union {
  1552. struct xfs_btree_block_shdr s;
  1553. struct xfs_btree_block_lhdr l;
  1554. } bb_u; /* rest */
  1555. };
  1556. /* size of a short form block */
  1557. #define XFS_BTREE_SBLOCK_LEN \
  1558. (offsetof(struct xfs_btree_block, bb_u) + \
  1559. offsetof(struct xfs_btree_block_shdr, bb_blkno))
  1560. /* size of a long form block */
  1561. #define XFS_BTREE_LBLOCK_LEN \
  1562. (offsetof(struct xfs_btree_block, bb_u) + \
  1563. offsetof(struct xfs_btree_block_lhdr, bb_blkno))
  1564. /* sizes of CRC enabled btree blocks */
  1565. #define XFS_BTREE_SBLOCK_CRC_LEN \
  1566. (offsetof(struct xfs_btree_block, bb_u) + \
  1567. sizeof(struct xfs_btree_block_shdr))
  1568. #define XFS_BTREE_LBLOCK_CRC_LEN \
  1569. (offsetof(struct xfs_btree_block, bb_u) + \
  1570. sizeof(struct xfs_btree_block_lhdr))
  1571. #define XFS_BTREE_SBLOCK_CRC_OFF \
  1572. offsetof(struct xfs_btree_block, bb_u.s.bb_crc)
  1573. #define XFS_BTREE_LBLOCK_CRC_OFF \
  1574. offsetof(struct xfs_btree_block, bb_u.l.bb_crc)
  1575. /*
  1576. * On-disk XFS access control list structure.
  1577. */
  1578. struct xfs_acl_entry {
  1579. __be32 ae_tag;
  1580. __be32 ae_id;
  1581. __be16 ae_perm;
  1582. __be16 ae_pad; /* fill the implicit hole in the structure */
  1583. };
  1584. struct xfs_acl {
  1585. __be32 acl_cnt;
  1586. struct xfs_acl_entry acl_entry[];
  1587. };
  1588. /*
  1589. * The number of ACL entries allowed is defined by the on-disk format.
  1590. * For v4 superblocks, that is limited to 25 entries. For v5 superblocks, it is
  1591. * limited only by the maximum size of the xattr that stores the information.
  1592. */
  1593. #define XFS_ACL_MAX_ENTRIES(mp) \
  1594. (xfs_has_crc(mp) \
  1595. ? (XFS_XATTR_SIZE_MAX - sizeof(struct xfs_acl)) / \
  1596. sizeof(struct xfs_acl_entry) \
  1597. : 25)
  1598. #define XFS_ACL_SIZE(cnt) \
  1599. (sizeof(struct xfs_acl) + \
  1600. sizeof(struct xfs_acl_entry) * cnt)
  1601. #define XFS_ACL_MAX_SIZE(mp) \
  1602. XFS_ACL_SIZE(XFS_ACL_MAX_ENTRIES((mp)))
  1603. /* On-disk XFS extended attribute names */
  1604. #define SGI_ACL_FILE "SGI_ACL_FILE"
  1605. #define SGI_ACL_DEFAULT "SGI_ACL_DEFAULT"
  1606. #define SGI_ACL_FILE_SIZE (sizeof(SGI_ACL_FILE)-1)
  1607. #define SGI_ACL_DEFAULT_SIZE (sizeof(SGI_ACL_DEFAULT)-1)
  1608. #endif /* __XFS_FORMAT_H__ */