- Saved searches
- Use saved searches to filter your results more quickly
- License
- Aquarius223/exfat-Android
- Name already in use
- Sign In Required
- Launching GitHub Desktop
- Launching GitHub Desktop
- Launching Xcode
- Launching Visual Studio Code
- Latest commit
- Git stats
- Files
- README.md
- exFAT
- Installation
- Kernel
- Kernel 5.7 and above
- FUSE system for earlier kernels
- Emerge
- Kernel 5.7 and above
- FUSE system for earlier kernels
- Usage
- Formatting
- Kernel 5.7 and above
- FUSE system for earlier kernels
- Mounting
- Kernel 5.7 and above
- FUSE system for earlier kernels
- Integrity checking
- Troubleshooting
- Compatibility with macOS
- See also
- References
- ExFAT
- Installation
- Kernel
- Kernel 5.7 and above
- FUSE system for earlier kernels
- Emerge
- Kernel 5.7 and above
- FUSE system for earlier kernels
- Usage
- Formatting
- Kernel 5.7 and above
- FUSE system for earlier kernels
- Mounting
- Kernel 5.7 and above
- FUSE system for earlier kernels
- Integrity checking
- Troubleshooting
- Compatibility with macOS
- See also
- References
Saved searches
Use saved searches to filter your results more quickly
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
exFAT filesystem module for Linux kernel
License
Aquarius223/exfat-Android
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
Git stats
Files
Failed to load latest commit information.
README.md
This exFAT filesystem module for Linux kernel is a backport of the latest Linux mainline’s exFAT drivers by Samsung.
This project can be used for everyday Linux users by simply doing make && make install . Ubuntu users can simply add a PPA and start using it, without even downloading the code. This can also be directly dropped-in to an existing Linux kernel source for building the filesystem drivers inline, which should be useful for Android kernel developers.
exfat-linux has been tested with all major LTS kernels ranging from v4.9 to v5.4 and the ones Canonical uses for Ubuntu: v4.9 , v4.14 , v4.19 , v5.4 and v4.15 , v5.3 , and v5.6 .
It’s also been tested with x86(i386) , x86_64(amd64) , arm32(AArch32) and arm64(AArch64) .
Linux kernels since v5.4 includes an exFAT driver, but it is an extremely outdated version from 2016. This was later revised by Samsung directly with v5.7 .
People on v5.7 kernel or higher can just use the bundled exFAT drivers.
People on v5.4+ are highly recommended to use this drivers.
Support for kernel versions lower than v4.9 were dropped for easier maintenance. For people interested in exFAT support for said kernels, please use the old branch. It still works nicely and it’s actively being shipped to production smartphones.
exfat-linux is planned to be maintained until Android devices with v5.7+ LTS kernel become more common.
● Original authorship and copyright: Samsung
● Maintainer of exfat-linux: Park Ju Hyung(arter97)
If you’re an Ubuntu user, you can simply add a PPA repository and start using the exFAT module.
Ubuntu will handle upgrades automatically as well.
- Add the exfat-linux repository
sudo add-apt-repository ppa:arter97/exfat-linux sudo apt update
This will use DKMS(Dynamic Kernel Module Support) and automatically build exFAT module for your current Ubuntu installation.
● Manually installing the module
git clone https://github.com/arter97/exfat-linux cd exfat-linux
This will install the module to your currently running kernel.
If you’re running a v5.4+ kernel, it is highly recommended to reboot at this point to prevent the existing staging exFAT drivers to load.
If you upgrade the kernel, you’ll have to repeat this process.
If you want to update exfat-linux to the latest version, you’ll have to repeat this process.
● Merging the drivers to existing Linux kernel source
If you’re using git , using git subtree or git submodule is highly recommended.
menu "DOS/FAT/NT Filesystems" source "fs/fat/Kconfig" +source "fs/exfat/Kconfig" source "fs/ntfs/Kconfig" endmenu
obj-$(CONFIG_FAT_FS) += fat/ +obj-$(CONFIG_EXFAT_FS) += exfat/ obj-$(CONFIG_BFS_FS) += bfs/
For reference, existing exFAT implementations were tested and compared on a server running Ubuntu 16.04 with Linux kernel 4.14 under a contained virtual machine.
Linux 4.14 was used as higher LTS kernels don’t work with [exfat-nofuse] at the time of testing.
The new base backported from mainline is not benchmarked yet.
Implementation | Base | Read | Write |
---|---|---|---|
exfat-linux | 2.2.0 | 7042 MB/s | 2173 MB/s |
[exfat-nofuse] | 1.2.9 | 6849 MB/s | 1961 MB/s |
exfat-fuse | N/A | 3097 MB/s | 1710 MB/s |
ext4 | N/A | 7352 MB/s | 3333 MB/s |
Implementation | Base | Read | Write |
---|---|---|---|
exfat-linux | 2.2.0 | 760 MB/s | 2222 MB/s |
[exfat-nofuse] | 1.2.9 | 760 MB/s | 2160 MB/s |
exfat-fuse | N/A | 1.7 MB/s | 1.6 MB/s |
ext4 | N/A | 747 MB/s | 2816 MB/s |
Implementation | Base | Read | Write |
---|---|---|---|
exfat-linux | 2.2.0 | 1283 MB/s | 1832 MB/s |
[exfat-nofuse] | 1.2.9 | 1285 MB/s | 1678 MB/s |
exfat-fuse | N/A | 751 MB/s | 1464 MB/s |
ext4 | N/A | 1283 MB/s | 3356 MB/s |
Implementation | Base | Read | Write |
---|---|---|---|
exfat-linux | 2.2.0 | 26 MB/s | 1885 MB/s |
[exfat-nofuse] | 1.2.9 | 24 MB/s | 1827 MB/s |
exfat-fuse | N/A | 1.6 MB/s | 1.6 MB/s |
ext4 | N/A | 29 MB/s | 2821 MB/s |
- uid
- gid
- umask
- dmask
- fmask
- allow_utime
- iocharset
- quiet
- time_offset
- Please refer to the vfat’s documentation.
- Keep going on a filesystem error.
- Panic and halt the machine if an error occurs.
- Remount the filesystem read-only on an error.
- Enable the use of discard/TRIM commands to ensure flash storage doesn’t run out of free blocks. This option may introduce latency penalty on file removal operations.
exFAT
exFAT (Extended File Allocation Table), a Microsoft file system optimized for flash memory storage such as USB sticks, is available to Gentoo Linux systems through a FUSE module.
The availability of the exFAT filesystem had long been poor, because of its proprietary, unpublished specification. The situation, however, was improved after release of Linux kernel 5.7 with native exFAT driver implementation. [1]
- 1 Installation
- 1.1 Kernel
- 1.1.1 Kernel 5.7 and above
- 1.1.2 FUSE system for earlier kernels
- 1.2.1 Kernel 5.7 and above
- 1.2.2 FUSE system for earlier kernels
- 2.1 Formatting
- 2.1.1 Kernel 5.7 and above
- 2.1.2 FUSE system for earlier kernels
- 2.2.1 Kernel 5.7 and above
- 2.2.2 FUSE system for earlier kernels
- 3.1 Compatibility with macOS
Installation
Kernel
Kernel 5.7 and above
Enable exFAT support in the kernel:
File systems ---> DOS/FAT/EXFAT/NT Filesystems ---> exFAT filesystem support
FUSE system for earlier kernels
Make sure support for Filesystem in Userspace (FUSE) is enabled in the kernel:
File systems ---> FUSE (Filesystem in Userspace) support
Emerge
Kernel 5.7 and above
FUSE system for earlier kernels
Install the FUSE exfat package:
For filesystem creation and manipulation beyond that of the mount command it is necessary to install the sys-fs/exfat-utils package:
Usage
Formatting
Kernel 5.7 and above
To create an exFAT file system, use mkfs.exfat :
exfatprogs 1.0.4 Usage: mkfs.exfat -L | --volume-label=label Set volume label -c | --cluster-size=size(or suffixed by 'K' or 'M') Specify cluster size -b | --boundary-align=size(or suffixed by 'K' or 'M') Specify boundary alignment -f | --full-format Full format -V | --version Show version -v | --verbose Print debug -h | --help Show help
For instance, to create it on a removable device present at /dev/sde1 while assigning «Flash» as the file system label:
FUSE system for earlier kernels
To create an exFAT file system, use mkfs.exfat (or the mkexfatfs command, which is synonymous):
mkexfatfs 1.2.1 Usage: mkfs.exfat [-i volume-id] [-n label] [-p partition-first-sector] [-s sectors-per-cluster] [-V]
For instance, to create it on a removable device present at /dev/sde1 while assigning «Flash» as the file system label:
Mounting
Kernel 5.7 and above
With native support, standard mount commands work perfectly:
FUSE system for earlier kernels
The file system can then be mounted using the mount.exfat-fuse command:
FUSE exfat 1.0.1 Usage: mount.exfat-fuse [-d] [-o options] [-v]
For instance, to mount the file system created in the above example:
To unmount, simply use the umount command:
Integrity checking
To check the integrity of an exFAT filesystem, use fsck.exfat :
Troubleshooting
Compatibility with macOS
To allow ExFAT formatted disks to be read by macOS, the disk must use a GUID partition table, and have the Microsoft basic data flag set.
See also
- FAT — filesystem originally created for use with MS-DOS (and later pre-NT Microsoft Windows).
- NTFS — a proprietary disk filesystem by Microsoft for Windows and Windows-based operating systems.
- Ext4 — an open source disk filesystem and most recent version of the extended series of filesystems.
References
ExFAT
exFAT (Extended File Allocation Table), a Microsoft file system optimized for flash memory storage such as USB sticks, is available to Gentoo Linux systems through a FUSE module.
The availability of the exFAT filesystem had long been poor, because of its proprietary, unpublished specification. The situation, however, was improved after release of Linux kernel 5.7 with native exFAT driver implementation. [1]
- 1 Installation
- 1.1 Kernel
- 1.1.1 Kernel 5.7 and above
- 1.1.2 FUSE system for earlier kernels
- 1.2.1 Kernel 5.7 and above
- 1.2.2 FUSE system for earlier kernels
- 2.1 Formatting
- 2.1.1 Kernel 5.7 and above
- 2.1.2 FUSE system for earlier kernels
- 2.2.1 Kernel 5.7 and above
- 2.2.2 FUSE system for earlier kernels
- 3.1 Compatibility with macOS
Installation
Kernel
Kernel 5.7 and above
Enable exFAT support in the kernel:
File systems ---> DOS/FAT/EXFAT/NT Filesystems ---> exFAT filesystem support
FUSE system for earlier kernels
Make sure support for Filesystem in Userspace (FUSE) is enabled in the kernel:
File systems ---> FUSE (Filesystem in Userspace) support
Emerge
Kernel 5.7 and above
FUSE system for earlier kernels
Install the FUSE exfat package:
For filesystem creation and manipulation beyond that of the mount command it is necessary to install the sys-fs/exfat-utils package:
Usage
Formatting
Kernel 5.7 and above
To create an exFAT file system, use mkfs.exfat :
exfatprogs 1.0.4 Usage: mkfs.exfat -L | --volume-label=label Set volume label -c | --cluster-size=size(or suffixed by 'K' or 'M') Specify cluster size -b | --boundary-align=size(or suffixed by 'K' or 'M') Specify boundary alignment -f | --full-format Full format -V | --version Show version -v | --verbose Print debug -h | --help Show help
For instance, to create it on a removable device present at /dev/sde1 while assigning «Flash» as the file system label:
FUSE system for earlier kernels
To create an exFAT file system, use mkfs.exfat (or the mkexfatfs command, which is synonymous):
mkexfatfs 1.2.1 Usage: mkfs.exfat [-i volume-id] [-n label] [-p partition-first-sector] [-s sectors-per-cluster] [-V]
For instance, to create it on a removable device present at /dev/sde1 while assigning «Flash» as the file system label:
Mounting
Kernel 5.7 and above
With native support, standard mount commands work perfectly:
FUSE system for earlier kernels
The file system can then be mounted using the mount.exfat-fuse command:
FUSE exfat 1.0.1 Usage: mount.exfat-fuse [-d] [-o options] [-v]
For instance, to mount the file system created in the above example:
To unmount, simply use the umount command:
Integrity checking
To check the integrity of an exFAT filesystem, use fsck.exfat :
Troubleshooting
Compatibility with macOS
To allow ExFAT formatted disks to be read by macOS, the disk must use a GUID partition table, and have the Microsoft basic data flag set.
See also
- FAT — filesystem originally created for use with MS-DOS (and later pre-NT Microsoft Windows).
- NTFS — a proprietary disk filesystem by Microsoft for Windows and Windows-based operating systems.
- Ext4 — an open source disk filesystem and most recent version of the extended series of filesystems.
References
- 1.1 Kernel
- 1.1 Kernel