xref: /openbmc/u-boot/include/ext_common.h (revision 83d290c56fab2d38cd1ab4c4cc7099559c1d5046)
1*83d290c5STom Rini /* SPDX-License-Identifier: GPL-2.0+ */
2a1596438SUma Shankar /*
3a1596438SUma Shankar  * (C) Copyright 2011 - 2012 Samsung Electronics
4a1596438SUma Shankar  * EXT4 filesystem implementation in Uboot by
5a1596438SUma Shankar  * Uma Shankar <uma.shankar@samsung.com>
6a1596438SUma Shankar  * Manjunatha C Achar <a.manjunatha@samsung.com>
7a1596438SUma Shankar  *
8a1596438SUma Shankar  * Data structures and headers for ext4 support have been taken from
9a1596438SUma Shankar  * ext2 ls load support in Uboot
10a1596438SUma Shankar  *
11a1596438SUma Shankar  * (C) Copyright 2004
12a1596438SUma Shankar  * esd gmbh <www.esd-electronics.com>
13a1596438SUma Shankar  * Reinhard Arlt <reinhard.arlt@esd-electronics.com>
14a1596438SUma Shankar  *
15a1596438SUma Shankar  * based on code from grub2 fs/ext2.c and fs/fshelp.c by
16a1596438SUma Shankar  * GRUB  --  GRand Unified Bootloader
17a1596438SUma Shankar  * Copyright (C) 2003, 2004  Free Software Foundation, Inc.
18a1596438SUma Shankar  */
19a1596438SUma Shankar 
20a1596438SUma Shankar #ifndef __EXT_COMMON__
21a1596438SUma Shankar #define __EXT_COMMON__
22a1596438SUma Shankar #include <command.h>
23a1596438SUma Shankar #define SECTOR_SIZE		0x200
24a1596438SUma Shankar 
25a1596438SUma Shankar /* Magic value used to identify an ext2 filesystem.  */
26a1596438SUma Shankar #define	EXT2_MAGIC			0xEF53
27a1596438SUma Shankar /* Amount of indirect blocks in an inode.  */
28a1596438SUma Shankar #define INDIRECT_BLOCKS			12
29a1596438SUma Shankar /* Maximum lenght of a pathname.  */
30a1596438SUma Shankar #define EXT2_PATH_MAX				4096
31a1596438SUma Shankar /* Maximum nesting of symlinks, used to prevent a loop.  */
32a1596438SUma Shankar #define	EXT2_MAX_SYMLINKCNT		8
33a1596438SUma Shankar 
34a1596438SUma Shankar /* Filetype used in directory entry.  */
35a1596438SUma Shankar #define	FILETYPE_UNKNOWN		0
36a1596438SUma Shankar #define	FILETYPE_REG			1
37a1596438SUma Shankar #define	FILETYPE_DIRECTORY		2
38a1596438SUma Shankar #define	FILETYPE_SYMLINK		7
39a1596438SUma Shankar 
40a1596438SUma Shankar /* Filetype information as used in inodes.  */
41a1596438SUma Shankar #define FILETYPE_INO_MASK		0170000
42a1596438SUma Shankar #define FILETYPE_INO_REG		0100000
43a1596438SUma Shankar #define FILETYPE_INO_DIRECTORY		0040000
44a1596438SUma Shankar #define FILETYPE_INO_SYMLINK		0120000
45a1596438SUma Shankar #define EXT2_ROOT_INO			2 /* Root inode */
46a1596438SUma Shankar 
47a1596438SUma Shankar /* The size of an ext2 block in bytes.  */
48a1596438SUma Shankar #define EXT2_BLOCK_SIZE(data)	   (1 << LOG2_BLOCK_SIZE(data))
49a1596438SUma Shankar 
50a1596438SUma Shankar /* Log2 size of ext2 block in bytes.  */
517f101be3SMichael Walle #define LOG2_BLOCK_SIZE(data)	   (le32_to_cpu		   \
5250ce4c07SEgbert Eich 				    (data->sblock.log2_block_size) \
5350ce4c07SEgbert Eich 				    + EXT2_MIN_BLOCK_LOG_SIZE)
54a1596438SUma Shankar 
55a1596438SUma Shankar #define EXT2_FT_DIR	2
56a1596438SUma Shankar #define SUCCESS	1
57a1596438SUma Shankar 
58a1596438SUma Shankar /* Macro-instructions used to manage several block sizes  */
59a1596438SUma Shankar #define EXT2_MIN_BLOCK_LOG_SIZE	10 /* 1024 */
60a1596438SUma Shankar #define EXT2_MAX_BLOCK_LOG_SIZE	16 /* 65536 */
61a1596438SUma Shankar #define EXT2_MIN_BLOCK_SIZE		(1 << EXT2_MIN_BLOCK_LOG_SIZE)
62a1596438SUma Shankar #define EXT2_MAX_BLOCK_SIZE		(1 << EXT2_MAX_BLOCK_LOG_SIZE)
63a1596438SUma Shankar 
64a1596438SUma Shankar /* The ext2 superblock.  */
65a1596438SUma Shankar struct ext2_sblock {
662a0b7a97SMichael Walle 	__le32 total_inodes;
672a0b7a97SMichael Walle 	__le32 total_blocks;
682a0b7a97SMichael Walle 	__le32 reserved_blocks;
692a0b7a97SMichael Walle 	__le32 free_blocks;
702a0b7a97SMichael Walle 	__le32 free_inodes;
712a0b7a97SMichael Walle 	__le32 first_data_block;
722a0b7a97SMichael Walle 	__le32 log2_block_size;
732a0b7a97SMichael Walle 	__le32 log2_fragment_size;
742a0b7a97SMichael Walle 	__le32 blocks_per_group;
752a0b7a97SMichael Walle 	__le32 fragments_per_group;
762a0b7a97SMichael Walle 	__le32 inodes_per_group;
772a0b7a97SMichael Walle 	__le32 mtime;
782a0b7a97SMichael Walle 	__le32 utime;
792a0b7a97SMichael Walle 	__le16 mnt_count;
802a0b7a97SMichael Walle 	__le16 max_mnt_count;
812a0b7a97SMichael Walle 	__le16 magic;
822a0b7a97SMichael Walle 	__le16 fs_state;
832a0b7a97SMichael Walle 	__le16 error_handling;
842a0b7a97SMichael Walle 	__le16 minor_revision_level;
852a0b7a97SMichael Walle 	__le32 lastcheck;
862a0b7a97SMichael Walle 	__le32 checkinterval;
872a0b7a97SMichael Walle 	__le32 creator_os;
882a0b7a97SMichael Walle 	__le32 revision_level;
892a0b7a97SMichael Walle 	__le16 uid_reserved;
902a0b7a97SMichael Walle 	__le16 gid_reserved;
912a0b7a97SMichael Walle 	__le32 first_inode;
922a0b7a97SMichael Walle 	__le16 inode_size;
932a0b7a97SMichael Walle 	__le16 block_group_number;
942a0b7a97SMichael Walle 	__le32 feature_compatibility;
952a0b7a97SMichael Walle 	__le32 feature_incompat;
962a0b7a97SMichael Walle 	__le32 feature_ro_compat;
972a0b7a97SMichael Walle 	__le32 unique_id[4];
98a1596438SUma Shankar 	char volume_name[16];
99a1596438SUma Shankar 	char last_mounted_on[64];
1002a0b7a97SMichael Walle 	__le32 compression_info;
1013ee2f977SStefan Brüns 	uint8_t prealloc_blocks;
1023ee2f977SStefan Brüns 	uint8_t prealloc_dir_blocks;
1033ee2f977SStefan Brüns 	__le16 reserved_gdt_blocks;
1043ee2f977SStefan Brüns 	uint8_t journal_uuid[16];
1053ee2f977SStefan Brüns 	__le32 journal_inode;
1063ee2f977SStefan Brüns 	__le32 journal_dev;
1073ee2f977SStefan Brüns 	__le32 last_orphan;
1083ee2f977SStefan Brüns 	__le32 hash_seed[4];
1093ee2f977SStefan Brüns 	uint8_t default_hash_version;
1103ee2f977SStefan Brüns 	uint8_t journal_backup_type;
1113ee2f977SStefan Brüns 	__le16 descriptor_size;
1123ee2f977SStefan Brüns 	__le32 default_mount_options;
1133ee2f977SStefan Brüns 	__le32 first_meta_block_group;
1143ee2f977SStefan Brüns 	__le32 mkfs_time;
1153ee2f977SStefan Brüns 	__le32 journal_blocks[17];
1163ee2f977SStefan Brüns 	__le32 total_blocks_high;
1173ee2f977SStefan Brüns 	__le32 reserved_blocks_high;
1183ee2f977SStefan Brüns 	__le32 free_blocks_high;
1193ee2f977SStefan Brüns 	__le16 min_extra_inode_size;
1203ee2f977SStefan Brüns 	__le16 want_extra_inode_size;
1213ee2f977SStefan Brüns 	__le32 flags;
1223ee2f977SStefan Brüns 	__le16 raid_stride;
1233ee2f977SStefan Brüns 	__le16 mmp_interval;
1243ee2f977SStefan Brüns 	__le64 mmp_block;
1253ee2f977SStefan Brüns 	__le32 raid_stripe_width;
1263ee2f977SStefan Brüns 	uint8_t log2_groups_per_flex;
1273ee2f977SStefan Brüns 	uint8_t checksum_type;
128a1596438SUma Shankar };
129a1596438SUma Shankar 
130a1596438SUma Shankar struct ext2_block_group {
1312a0b7a97SMichael Walle 	__le32 block_id;	/* Blocks bitmap block */
1322a0b7a97SMichael Walle 	__le32 inode_id;	/* Inodes bitmap block */
1332a0b7a97SMichael Walle 	__le32 inode_table_id;	/* Inodes table block */
1342a0b7a97SMichael Walle 	__le16 free_blocks;	/* Free blocks count */
1352a0b7a97SMichael Walle 	__le16 free_inodes;	/* Free inodes count */
1362a0b7a97SMichael Walle 	__le16 used_dir_cnt;	/* Directories count */
1372a0b7a97SMichael Walle 	__le16 bg_flags;
1383ee2f977SStefan Brüns 	__le32 bg_exclude_bitmap;
1393ee2f977SStefan Brüns 	__le16 bg_block_id_csum;
1403ee2f977SStefan Brüns 	__le16 bg_inode_id_csum;
1412a0b7a97SMichael Walle 	__le16 bg_itable_unused; /* Unused inodes count */
1423ee2f977SStefan Brüns 	__le16 bg_checksum;	/* crc16(s_uuid+group_num+group_desc)*/
1433ee2f977SStefan Brüns 	/* following fields only exist if descriptor size is 64 */
1443ee2f977SStefan Brüns 	__le32 block_id_high;
1453ee2f977SStefan Brüns 	__le32 inode_id_high;
1463ee2f977SStefan Brüns 	__le32 inode_table_id_high;
1473ee2f977SStefan Brüns 	__le16 free_blocks_high;
1483ee2f977SStefan Brüns 	__le16 free_inodes_high;
1493ee2f977SStefan Brüns 	__le16 used_dir_cnt_high;
1503ee2f977SStefan Brüns 	__le16 bg_itable_unused_high;
1513ee2f977SStefan Brüns 	__le32 bg_exclude_bitmap_high;
1523ee2f977SStefan Brüns 	__le16 bg_block_id_csum_high;
1533ee2f977SStefan Brüns 	__le16 bg_inode_id_csum_high;
1543ee2f977SStefan Brüns 	__le32 bg_reserved;
155a1596438SUma Shankar };
156a1596438SUma Shankar 
157a1596438SUma Shankar /* The ext2 inode. */
158a1596438SUma Shankar struct ext2_inode {
1592a0b7a97SMichael Walle 	__le16 mode;
1602a0b7a97SMichael Walle 	__le16 uid;
1612a0b7a97SMichael Walle 	__le32 size;
1622a0b7a97SMichael Walle 	__le32 atime;
1632a0b7a97SMichael Walle 	__le32 ctime;
1642a0b7a97SMichael Walle 	__le32 mtime;
1652a0b7a97SMichael Walle 	__le32 dtime;
1662a0b7a97SMichael Walle 	__le16 gid;
1672a0b7a97SMichael Walle 	__le16 nlinks;
1683ee2f977SStefan Brüns 	__le32 blockcnt;	/* Blocks of either 512 or block_size bytes */
1692a0b7a97SMichael Walle 	__le32 flags;
1702a0b7a97SMichael Walle 	__le32 osd1;
171a1596438SUma Shankar 	union {
172a1596438SUma Shankar 		struct datablocks {
1732a0b7a97SMichael Walle 			__le32 dir_blocks[INDIRECT_BLOCKS];
1742a0b7a97SMichael Walle 			__le32 indir_block;
1752a0b7a97SMichael Walle 			__le32 double_indir_block;
1762a0b7a97SMichael Walle 			__le32 triple_indir_block;
177a1596438SUma Shankar 		} blocks;
178a1596438SUma Shankar 		char symlink[60];
1793ee2f977SStefan Brüns 		char inline_data[60];
180a1596438SUma Shankar 	} b;
1812a0b7a97SMichael Walle 	__le32 version;
1822a0b7a97SMichael Walle 	__le32 acl;
1833ee2f977SStefan Brüns 	__le32 size_high;	/* previously dir_acl, but never used */
1842a0b7a97SMichael Walle 	__le32 fragment_addr;
1852a0b7a97SMichael Walle 	__le32 osd2[3];
186a1596438SUma Shankar };
187a1596438SUma Shankar 
188a1596438SUma Shankar /* The header of an ext2 directory entry. */
189a1596438SUma Shankar struct ext2_dirent {
1902a0b7a97SMichael Walle 	__le32 inode;
1912a0b7a97SMichael Walle 	__le16 direntlen;
1922a0b7a97SMichael Walle 	__u8 namelen;
1932a0b7a97SMichael Walle 	__u8 filetype;
194a1596438SUma Shankar };
195a1596438SUma Shankar 
196a1596438SUma Shankar struct ext2fs_node {
197a1596438SUma Shankar 	struct ext2_data *data;
198a1596438SUma Shankar 	struct ext2_inode inode;
199a1596438SUma Shankar 	int ino;
200a1596438SUma Shankar 	int inode_read;
201a1596438SUma Shankar };
202a1596438SUma Shankar 
203a1596438SUma Shankar /* Information about a "mounted" ext2 filesystem. */
204a1596438SUma Shankar struct ext2_data {
205a1596438SUma Shankar 	struct ext2_sblock sblock;
206a1596438SUma Shankar 	struct ext2_inode *inode;
207a1596438SUma Shankar 	struct ext2fs_node diropen;
208a1596438SUma Shankar };
209a1596438SUma Shankar 
21004735e9cSFrederic Leroy extern lbaint_t part_offset;
21181180819SRob Herring 
212a1596438SUma Shankar int do_ext2ls(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
213a1596438SUma Shankar int do_ext2load(cmd_tbl_t *cmdtp, int flag, int argc, char * const argv[]);
214a1596438SUma Shankar int do_ext4_load(cmd_tbl_t *cmdtp, int flag, int argc,
215a1596438SUma Shankar 					char *const argv[]);
216a1596438SUma Shankar int do_ext4_ls(cmd_tbl_t *cmdtp, int flag, int argc, char *const argv[]);
217ed34f34dSUma Shankar int do_ext4_write(cmd_tbl_t *cmdtp, int flag, int argc,
218ed34f34dSUma Shankar 				char *const argv[]);
219a1596438SUma Shankar #endif
220