From 66759e0f1b45633233d254466a68fe7698cd8bb3 Mon Sep 17 00:00:00 2001 From: Bo Branten Date: Sat, 7 Sep 2024 19:20:50 +0200 Subject: [PATCH] updated the readme file --- README.md | 113 +++++++++++++++++++++++++++++++++++++++++++++--------- 1 file changed, 95 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index c48b485..253d8d1 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ -New ---- +Latest release +-------------- Signed driver for Windows 10 and Windows 11: https://www.accum.se/~bosse/ext2fsd/0.71/Ext2Fsd-0.71-setup.exe @@ -13,6 +13,60 @@ New together with an already installed driver. +Changes to the source code in git after latest release +------------------------------------------------------ + + Most users can continue to use the latest release, it contains + an install program and a signed driver. Below is a list of + what has been implemented in the source code in git since then. + If you need any of these features you can compile the driver + or application yourself. + + Driver: + + - Corrected an error that made the debug version of the driver + crash. A number of calls to Ext2FreePool where misstakenly + replaced with direct calls to ExFreePool. This error can + not happen in the release version of the driver. + + - The existing time fields in the superblock and the inodes + is using 32-bit values for time in seconds since 1970. They + will overflow in 2038. The ext4 filesystem has therefore + been extended with new time fields. In the superblock they + have names ending in "_hi" containing the high 8-bit of the + the seconds while the existing time fields contain the lower + 32-bit. In the inodes the new fileds has names ending in + "_extra". They contain both the high 2-bit of the seconds, + that is bit 33 and 34 and also the nano seconds encoded as + (nsec << 2 | epoch) The existing fields contain the low 32-bit + of the seconds. + + - The call "query volume information" will read the fields + s_mkfs_time and s_mkfs_time_hi from the superblock. + + - The fields s_mtime and s_mtime_hi in the superblock will be + updated with the current time at mount time. + + - The fields s_wtime and s_wtime_hi in the superblock will be + updated with the current time at shutdown. + + Application: + + - If an on disk filesystem contains new ext4 features that is + not supported by the Windows driver a '+' sign will be shown + after the filesystem name, e.g "EXT4+". + + - More filesystems are recognized. The main window with + a list of disks and partitions will now tell the type of + filesystem for BTRFS, XFS, BSD, LVM and RAID (MD) in + adidition to EXT + + - The used size of swap partitions is listed as zero. + + - The donate dialog box is disabled because the information in + it is outdated. + + About ----- @@ -43,7 +97,6 @@ Test \windows\system32\drivers. Now you can read and write ext4 filesystems using the new features metadata checksums and 64-bit blocknumbers from Windows. - my site: http://www.accum.se/~bosse/ Introduction @@ -53,22 +106,10 @@ Introduction It's a free and open-source software, everyone can modify or distribute under GNU GPLv2. - -Old Development Website -------------------- - - Matt Wu - http://www.ext2fsd.com - Active Developers ----------------- - Matt Wu : http://github.com/matt-wu - http://blog.dynox.cn - - KaHo Ng : http://github.com/ngkaho1234 - Bo Branten : http://github.com/bobranten http://www.accum.se/~bosse @@ -76,6 +117,22 @@ Active Developers for important help to this project! +Previous Developers +------------------- + + Matt Wu : http://github.com/matt-wu + http://blog.dynox.cn + + KaHo Ng : http://github.com/ngkaho1234 + + +Old Development Website +----------------------- + + Matt Wu + http://www.ext2fsd.com + + Supported Features by Ext4Fsd ----------------------------- @@ -92,8 +149,28 @@ Supported Features by Ext4Fsd 11, mount-as-user: specifed uid/gid by user -Unsupported Ext3/4 Features +Read-only Ext4 Features +----------------------- + + If any of the ext4 features below is present on a filesystem + the Windows driver will automatically mount the fs read-only: + + 1, EXT4_FEATURE_RO_COMPAT_BIGALLOC + 2, EXT4_FEATURE_RO_COMPAT_QUOTA + 3, EXT4_FEATURE_RO_COMPAT_PROJECT + 4, EXT4_FEATURE_RO_COMPAT_VERITY + 5, EXT4_FEATURE_RO_COMPAT_ORPHAN_PRESENT + + +Unsupported Ext4 Features --------------------------- - 1, journal: log-based operations, external journal - 2, EA (extended attributes), ACL support + If any of the ext4 features below is present on a filesystem + the Windows driver can not mount the fs at all: + + 1, EXT4_FEATURE_INCOMPAT_EA_INODE (extended attributes) + 2, EXT4_FEATURE_INCOMPAT_MMP (multiple mount protection) + 3, EXT4_FEATURE_INCOMPAT_INLINE_DATA (storing small files in inode) + 4, EXT4_FEATURE_INCOMPAT_ENCRYPT + 5, EXT4_FEATURE_INCOMPAT_CASEFOLD (case insensitive file names (claimed to be used by SteamOS as default)) + 6, EXT4_FEATURE_INCOMPAT_LARGEDIR (3-level htree)