Skip to content

Commit d18bb0a

Browse files
committed
update info about underlying filesystems and path length limits
1 parent b9e459f commit d18bb0a

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

README.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -432,19 +432,19 @@ rsync .....
432432
File name and path length limits
433433
------
434434

435-
If "Long file names" (the default) is specfied when creating the fileystem, or if plain text file names are used, and if the filesystem is located on NTFS, then a file or directory name can be up to 255 characters long, and a full path can be up to 32,000 characters long.
435+
If "Long file names" (the default) is specfied when creating the fileystem, or if plain text file names are used, and if the underlying filesystem is reasonably modern (e.g. NTFS/exFAT/FAT32), then a file or directory name can be up to 255 characters long, and a full path can be approximately 32,000 characters long.
436436

437-
If "Long file names" is not specified and plain text file names aren't used, then the maximum length of a file or directory name is 160 characters. But the full path limit is still 32,000 characters (assuming NTFS).
437+
If "Long file names" is not specified and plain text file names aren't used, then the maximum length of a file or directory name is 160 characters. But the full path limit is still approximately 32,000 characters (assuming NTFS/exFAT/FAT32).
438438

439439
When a file name is encrypted, it is converted from UNICODE-16 to UTF-8 which, depending the language, might cause the number of characters to increase. Then it is encrypted, which causes it to be padded by up to 16 bytes. Then it is base64 encoded, which typically results in a 33% increase in length. The encrypted file names can therefore be signifcantly longer than the unencrypted names.
440440

441441
Also, the path to the directory in which the encrypted fileystem resides must be pre-pended to the path of the encrypted file names.
442442

443-
Older filesystems, such as FAT32, will limit the total path length to 259 characters.
443+
Older filesystems, such as FAT16, will limit the total path length to 259 characters.
444444

445-
It is therefore strongly recommended to use NTFS whenever possible.
445+
It is therefore strongly recommended to use a modern file system like NTFS, exFAT, or FAT32 whenever possible.
446446

447-
A lot of Windows progams, including File Explorer that comes with Windows, have problems with long paths. If you use encrypted file names, then you might need to use a third-party file manager that handles long file paths if you want to move the root of your encrypted filesystem. It's a good idea to copy it and then delete the old one instead of moving it in case your file manager has problems.
447+
A lot of Windows progams, including File Explorer that comes with Windows, have problems with paths longer than the old 259 character limit, regardless of which underlying filesystem is used. If you use encrypted file names, then you might need to use a third-party file manager that handles long file paths if you want to move the root of your encrypted filesystem. It's a good idea to copy it and then delete the old one instead of moving it in case your file manager has problems.
448448

449449

450450
Case Sensitivity

0 commit comments

Comments
 (0)