Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Documentation, filename max length #506

Merged
merged 3 commits into from
Apr 7, 2018
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 7 additions & 2 deletions encfs/encfs.pod
Original file line number Diff line number Diff line change
Expand Up @@ -373,8 +373,8 @@ inherited by B<EncFS> (or possibly be further limited).

One such limitation is filename length. If your underlying filesystem limits
you to N characters in a filename, then B<EncFS> will limit you to approximately
3*(N-2)/4. For example if the host filesystem limits to 256 characters, then
B<EncFS> will be limited to 190 character filenames. This is because encrypted
3*(N-2)/4. For example if the host filesystem limits to 255 characters, then
B<EncFS> will be limited to 189 character filenames. This is because encrypted
filenames are always longer than plaintext filenames.

=head1 FILESYSTEM OPTIONS
Expand Down Expand Up @@ -488,6 +488,11 @@ on by default, as it takes a similar amount of time to using the stream cipher.
However stream cipher mode may be useful if you want shorter encrypted
filenames for some reason.

Based on an underlying filesystem supporting a maximum of 255 characters in
filenames, here is the maximum possible filename length depending on the choosen
encoding scheme : stream (189), block (176), block32 (143). Note that we should
rather talk about bytes, when filenames contain special (multi-bytes) characters.

Prior to version 1.1, only stream encoding was supported.

=item I<Filename Initialization Vector Chaining>
Expand Down