1 /* SPDX-License-Identifier: GPL-2.0-or-later */ 2 #ifndef SQUASHFS_FS 3 #define SQUASHFS_FS 4 /* 5 * Squashfs 6 * 7 * Copyright (c) 2002, 2003, 2004, 2005, 2006, 2007, 2008 8 * Phillip Lougher <phillip@squashfs.org.uk> 9 * 10 * squashfs_fs.h 11 */ 12 13 #define SQUASHFS_CACHED_FRAGMENTS CONFIG_SQUASHFS_FRAGMENT_CACHE_SIZE 14 #define SQUASHFS_MAJOR 4 15 #define SQUASHFS_MINOR 0 16 #define SQUASHFS_START 0 17 18 /* size of metadata (inode and directory) blocks */ 19 #define SQUASHFS_METADATA_SIZE 8192 20 #define SQUASHFS_BLOCK_OFFSET 2 21 22 /* default size of block device I/O */ 23 #ifdef CONFIG_SQUASHFS_4K_DEVBLK_SIZE 24 #define SQUASHFS_DEVBLK_SIZE 4096 25 #else 26 #define SQUASHFS_DEVBLK_SIZE 1024 27 #endif 28 29 #define SQUASHFS_FILE_MAX_SIZE 1048576 30 #define SQUASHFS_FILE_MAX_LOG 20 31 32 /* Max length of filename (not 255) */ 33 #define SQUASHFS_NAME_LEN 256 34 35 /* Max value for directory header count*/ 36 #define SQUASHFS_DIR_COUNT 256 37 38 #define SQUASHFS_INVALID_FRAG (0xffffffffU) 39 #define SQUASHFS_INVALID_XATTR (0xffffffffU) 40 #define SQUASHFS_INVALID_BLK (-1LL) 41 42 /* Filesystem flags */ 43 #define SQUASHFS_NOI 0 44 #define SQUASHFS_NOD 1 45 #define SQUASHFS_NOF 3 46 #define SQUASHFS_NO_FRAG 4 47 #define SQUASHFS_ALWAYS_FRAG 5 48 #define SQUASHFS_DUPLICATE 6 49 #define SQUASHFS_EXPORT 7 50 #define SQUASHFS_COMP_OPT 10 51 52 #define SQUASHFS_BIT(flag, bit) ((flag >> bit) & 1) 53 54 #define SQUASHFS_UNCOMPRESSED_INODES(flags) SQUASHFS_BIT(flags, \ 55 SQUASHFS_NOI) 56 57 #define SQUASHFS_UNCOMPRESSED_DATA(flags) SQUASHFS_BIT(flags, \ 58 SQUASHFS_NOD) 59 60 #define SQUASHFS_UNCOMPRESSED_FRAGMENTS(flags) SQUASHFS_BIT(flags, \ 61 SQUASHFS_NOF) 62 63 #define SQUASHFS_NO_FRAGMENTS(flags) SQUASHFS_BIT(flags, \ 64 SQUASHFS_NO_FRAG) 65 66 #define SQUASHFS_ALWAYS_FRAGMENTS(flags) SQUASHFS_BIT(flags, \ 67 SQUASHFS_ALWAYS_FRAG) 68 69 #define SQUASHFS_DUPLICATES(flags) SQUASHFS_BIT(flags, \ 70 SQUASHFS_DUPLICATE) 71 72 #define SQUASHFS_EXPORTABLE(flags) SQUASHFS_BIT(flags, \ 73 SQUASHFS_EXPORT) 74 75 #define SQUASHFS_COMP_OPTS(flags) SQUASHFS_BIT(flags, \ 76 SQUASHFS_COMP_OPT) 77 78 /* Inode types including extended types */ 79 #define SQUASHFS_DIR_TYPE 1 80 #define SQUASHFS_REG_TYPE 2 81 #define SQUASHFS_SYMLINK_TYPE 3 82 #define SQUASHFS_BLKDEV_TYPE 4 83 #define SQUASHFS_CHRDEV_TYPE 5 84 #define SQUASHFS_FIFO_TYPE 6 85 #define SQUASHFS_SOCKET_TYPE 7 86 #define SQUASHFS_LDIR_TYPE 8 87 #define SQUASHFS_LREG_TYPE 9 88 #define SQUASHFS_LSYMLINK_TYPE 10 89 #define SQUASHFS_LBLKDEV_TYPE 11 90 #define SQUASHFS_LCHRDEV_TYPE 12 91 #define SQUASHFS_LFIFO_TYPE 13 92 #define SQUASHFS_LSOCKET_TYPE 14 93 94 /* Max type value stored in directory entry */ 95 #define SQUASHFS_MAX_DIR_TYPE 7 96 97 /* Xattr types */ 98 #define SQUASHFS_XATTR_USER 0 99 #define SQUASHFS_XATTR_TRUSTED 1 100 #define SQUASHFS_XATTR_SECURITY 2 101 #define SQUASHFS_XATTR_VALUE_OOL 256 102 #define SQUASHFS_XATTR_PREFIX_MASK 0xff 103 104 /* Flag whether block is compressed or uncompressed, bit is set if block is 105 * uncompressed */ 106 #define SQUASHFS_COMPRESSED_BIT (1 << 15) 107 108 #define SQUASHFS_COMPRESSED_SIZE(B) (((B) & ~SQUASHFS_COMPRESSED_BIT) ? \ 109 (B) & ~SQUASHFS_COMPRESSED_BIT : SQUASHFS_COMPRESSED_BIT) 110 111 #define SQUASHFS_COMPRESSED(B) (!((B) & SQUASHFS_COMPRESSED_BIT)) 112 113 #define SQUASHFS_COMPRESSED_BIT_BLOCK (1 << 24) 114 115 #define SQUASHFS_COMPRESSED_SIZE_BLOCK(B) ((B) & \ 116 ~SQUASHFS_COMPRESSED_BIT_BLOCK) 117 118 #define SQUASHFS_COMPRESSED_BLOCK(B) (!((B) & SQUASHFS_COMPRESSED_BIT_BLOCK)) 119 120 static inline int squashfs_block_size(__le32 raw) 121 { 122 u32 size = le32_to_cpu(raw); 123 return (size >> 25) ? -EIO : size; 124 } 125 126 /* 127 * Inode number ops. Inodes consist of a compressed block number, and an 128 * uncompressed offset within that block 129 */ 130 #define SQUASHFS_INODE_BLK(A) ((unsigned int) ((A) >> 16)) 131 132 #define SQUASHFS_INODE_OFFSET(A) ((unsigned int) ((A) & 0xffff)) 133 134 #define SQUASHFS_MKINODE(A, B) ((long long)(((long long) (A)\ 135 << 16) + (B))) 136 137 /* fragment and fragment table defines */ 138 #define SQUASHFS_FRAGMENT_BYTES(A) \ 139 ((A) * sizeof(struct squashfs_fragment_entry)) 140 141 #define SQUASHFS_FRAGMENT_INDEX(A) (SQUASHFS_FRAGMENT_BYTES(A) / \ 142 SQUASHFS_METADATA_SIZE) 143 144 #define SQUASHFS_FRAGMENT_INDEX_OFFSET(A) (SQUASHFS_FRAGMENT_BYTES(A) % \ 145 SQUASHFS_METADATA_SIZE) 146 147 #define SQUASHFS_FRAGMENT_INDEXES(A) ((SQUASHFS_FRAGMENT_BYTES(A) + \ 148 SQUASHFS_METADATA_SIZE - 1) / \ 149 SQUASHFS_METADATA_SIZE) 150 151 #define SQUASHFS_FRAGMENT_INDEX_BYTES(A) (SQUASHFS_FRAGMENT_INDEXES(A) *\ 152 sizeof(u64)) 153 154 /* inode lookup table defines */ 155 #define SQUASHFS_LOOKUP_BYTES(A) ((A) * sizeof(u64)) 156 157 #define SQUASHFS_LOOKUP_BLOCK(A) (SQUASHFS_LOOKUP_BYTES(A) / \ 158 SQUASHFS_METADATA_SIZE) 159 160 #define SQUASHFS_LOOKUP_BLOCK_OFFSET(A) (SQUASHFS_LOOKUP_BYTES(A) % \ 161 SQUASHFS_METADATA_SIZE) 162 163 #define SQUASHFS_LOOKUP_BLOCKS(A) ((SQUASHFS_LOOKUP_BYTES(A) + \ 164 SQUASHFS_METADATA_SIZE - 1) / \ 165 SQUASHFS_METADATA_SIZE) 166 167 #define SQUASHFS_LOOKUP_BLOCK_BYTES(A) (SQUASHFS_LOOKUP_BLOCKS(A) *\ 168 sizeof(u64)) 169 170 /* uid/gid lookup table defines */ 171 #define SQUASHFS_ID_BYTES(A) ((A) * sizeof(unsigned int)) 172 173 #define SQUASHFS_ID_BLOCK(A) (SQUASHFS_ID_BYTES(A) / \ 174 SQUASHFS_METADATA_SIZE) 175 176 #define SQUASHFS_ID_BLOCK_OFFSET(A) (SQUASHFS_ID_BYTES(A) % \ 177 SQUASHFS_METADATA_SIZE) 178 179 #define SQUASHFS_ID_BLOCKS(A) ((SQUASHFS_ID_BYTES(A) + \ 180 SQUASHFS_METADATA_SIZE - 1) / \ 181 SQUASHFS_METADATA_SIZE) 182 183 #define SQUASHFS_ID_BLOCK_BYTES(A) (SQUASHFS_ID_BLOCKS(A) *\ 184 sizeof(u64)) 185 /* xattr id lookup table defines */ 186 #define SQUASHFS_XATTR_BYTES(A) (((u64) (A)) * sizeof(struct squashfs_xattr_id)) 187 188 #define SQUASHFS_XATTR_BLOCK(A) (SQUASHFS_XATTR_BYTES(A) / \ 189 SQUASHFS_METADATA_SIZE) 190 191 #define SQUASHFS_XATTR_BLOCK_OFFSET(A) (SQUASHFS_XATTR_BYTES(A) % \ 192 SQUASHFS_METADATA_SIZE) 193 194 #define SQUASHFS_XATTR_BLOCKS(A) ((SQUASHFS_XATTR_BYTES(A) + \ 195 SQUASHFS_METADATA_SIZE - 1) / \ 196 SQUASHFS_METADATA_SIZE) 197 198 #define SQUASHFS_XATTR_BLOCK_BYTES(A) (SQUASHFS_XATTR_BLOCKS(A) *\ 199 sizeof(u64)) 200 #define SQUASHFS_XATTR_BLK(A) ((unsigned int) ((A) >> 16)) 201 202 #define SQUASHFS_XATTR_OFFSET(A) ((unsigned int) ((A) & 0xffff)) 203 204 /* cached data constants for filesystem */ 205 #define SQUASHFS_CACHED_BLKS 8 206 207 /* meta index cache */ 208 #define SQUASHFS_META_INDEXES (SQUASHFS_METADATA_SIZE / sizeof(unsigned int)) 209 #define SQUASHFS_META_ENTRIES 127 210 #define SQUASHFS_META_SLOTS 8 211 #define SQUASHFS_SCAN_INDEXES 1024 212 213 struct meta_entry { 214 u64 data_block; 215 unsigned int index_block; 216 unsigned short offset; 217 unsigned short pad; 218 }; 219 220 struct meta_index { 221 unsigned int inode_number; 222 unsigned int offset; 223 unsigned short entries; 224 unsigned short skip; 225 unsigned short locked; 226 unsigned short pad; 227 struct meta_entry meta_entry[SQUASHFS_META_ENTRIES]; 228 }; 229 230 231 /* 232 * definitions for structures on disk 233 */ 234 #define ZLIB_COMPRESSION 1 235 #define LZMA_COMPRESSION 2 236 #define LZO_COMPRESSION 3 237 #define XZ_COMPRESSION 4 238 #define LZ4_COMPRESSION 5 239 #define ZSTD_COMPRESSION 6 240 241 struct squashfs_super_block { 242 __le32 s_magic; 243 __le32 inodes; 244 __le32 mkfs_time; 245 __le32 block_size; 246 __le32 fragments; 247 __le16 compression; 248 __le16 block_log; 249 __le16 flags; 250 __le16 no_ids; 251 __le16 s_major; 252 __le16 s_minor; 253 __le64 root_inode; 254 __le64 bytes_used; 255 __le64 id_table_start; 256 __le64 xattr_id_table_start; 257 __le64 inode_table_start; 258 __le64 directory_table_start; 259 __le64 fragment_table_start; 260 __le64 lookup_table_start; 261 }; 262 263 struct squashfs_dir_index { 264 __le32 index; 265 __le32 start_block; 266 __le32 size; 267 unsigned char name[]; 268 }; 269 270 struct squashfs_base_inode { 271 __le16 inode_type; 272 __le16 mode; 273 __le16 uid; 274 __le16 guid; 275 __le32 mtime; 276 __le32 inode_number; 277 }; 278 279 struct squashfs_ipc_inode { 280 __le16 inode_type; 281 __le16 mode; 282 __le16 uid; 283 __le16 guid; 284 __le32 mtime; 285 __le32 inode_number; 286 __le32 nlink; 287 }; 288 289 struct squashfs_lipc_inode { 290 __le16 inode_type; 291 __le16 mode; 292 __le16 uid; 293 __le16 guid; 294 __le32 mtime; 295 __le32 inode_number; 296 __le32 nlink; 297 __le32 xattr; 298 }; 299 300 struct squashfs_dev_inode { 301 __le16 inode_type; 302 __le16 mode; 303 __le16 uid; 304 __le16 guid; 305 __le32 mtime; 306 __le32 inode_number; 307 __le32 nlink; 308 __le32 rdev; 309 }; 310 311 struct squashfs_ldev_inode { 312 __le16 inode_type; 313 __le16 mode; 314 __le16 uid; 315 __le16 guid; 316 __le32 mtime; 317 __le32 inode_number; 318 __le32 nlink; 319 __le32 rdev; 320 __le32 xattr; 321 }; 322 323 struct squashfs_symlink_inode { 324 __le16 inode_type; 325 __le16 mode; 326 __le16 uid; 327 __le16 guid; 328 __le32 mtime; 329 __le32 inode_number; 330 __le32 nlink; 331 __le32 symlink_size; 332 char symlink[]; 333 }; 334 335 struct squashfs_reg_inode { 336 __le16 inode_type; 337 __le16 mode; 338 __le16 uid; 339 __le16 guid; 340 __le32 mtime; 341 __le32 inode_number; 342 __le32 start_block; 343 __le32 fragment; 344 __le32 offset; 345 __le32 file_size; 346 __le16 block_list[]; 347 }; 348 349 struct squashfs_lreg_inode { 350 __le16 inode_type; 351 __le16 mode; 352 __le16 uid; 353 __le16 guid; 354 __le32 mtime; 355 __le32 inode_number; 356 __le64 start_block; 357 __le64 file_size; 358 __le64 sparse; 359 __le32 nlink; 360 __le32 fragment; 361 __le32 offset; 362 __le32 xattr; 363 __le16 block_list[]; 364 }; 365 366 struct squashfs_dir_inode { 367 __le16 inode_type; 368 __le16 mode; 369 __le16 uid; 370 __le16 guid; 371 __le32 mtime; 372 __le32 inode_number; 373 __le32 start_block; 374 __le32 nlink; 375 __le16 file_size; 376 __le16 offset; 377 __le32 parent_inode; 378 }; 379 380 struct squashfs_ldir_inode { 381 __le16 inode_type; 382 __le16 mode; 383 __le16 uid; 384 __le16 guid; 385 __le32 mtime; 386 __le32 inode_number; 387 __le32 nlink; 388 __le32 file_size; 389 __le32 start_block; 390 __le32 parent_inode; 391 __le16 i_count; 392 __le16 offset; 393 __le32 xattr; 394 struct squashfs_dir_index index[]; 395 }; 396 397 union squashfs_inode { 398 struct squashfs_base_inode base; 399 struct squashfs_dev_inode dev; 400 struct squashfs_ldev_inode ldev; 401 struct squashfs_symlink_inode symlink; 402 struct squashfs_reg_inode reg; 403 struct squashfs_lreg_inode lreg; 404 struct squashfs_dir_inode dir; 405 struct squashfs_ldir_inode ldir; 406 struct squashfs_ipc_inode ipc; 407 struct squashfs_lipc_inode lipc; 408 }; 409 410 struct squashfs_dir_entry { 411 __le16 offset; 412 __le16 inode_number; 413 __le16 type; 414 __le16 size; 415 char name[]; 416 }; 417 418 struct squashfs_dir_header { 419 __le32 count; 420 __le32 start_block; 421 __le32 inode_number; 422 }; 423 424 struct squashfs_fragment_entry { 425 __le64 start_block; 426 __le32 size; 427 unsigned int unused; 428 }; 429 430 struct squashfs_xattr_entry { 431 __le16 type; 432 __le16 size; 433 char data[]; 434 }; 435 436 struct squashfs_xattr_val { 437 __le32 vsize; 438 char value[]; 439 }; 440 441 struct squashfs_xattr_id { 442 __le64 xattr; 443 __le32 count; 444 __le32 size; 445 }; 446 447 struct squashfs_xattr_id_table { 448 __le64 xattr_table_start; 449 __le32 xattr_ids; 450 __le32 unused; 451 }; 452 453 #endif 454