diff options
author | Richard W.M. Jones <rjones@redhat.com> | 2012-08-03 11:53:44 +0100 |
---|---|---|
committer | Richard W.M. Jones <rjones@redhat.com> | 2012-08-03 11:53:44 +0100 |
commit | 7fa67427c6b2725bdcce52c08511f8813b7bd42e (patch) | |
tree | 75e89787e64c775fa2c0eedddc8f16972d8c5c68 /src/guestfs.pod | |
parent | 1394d4a69be2ec65ed0b34e34f7a2aee816070fc (diff) | |
download | libguestfs-7fa67427c6b2725bdcce52c08511f8813b7bd42e.tar.gz libguestfs-7fa67427c6b2725bdcce52c08511f8813b7bd42e.tar.xz libguestfs-7fa67427c6b2725bdcce52c08511f8813b7bd42e.zip |
Document problems copying long filenames from NTFS to Linux filesystems (RHBZ#845488).
Diffstat (limited to 'src/guestfs.pod')
-rw-r--r-- | src/guestfs.pod | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/src/guestfs.pod b/src/guestfs.pod index 0e258ab9..1b4f99ba 100644 --- a/src/guestfs.pod +++ b/src/guestfs.pod @@ -699,6 +699,28 @@ replacement will work. To resolve the case insensitivity of paths, call L</guestfs_case_sensitive_path>. +=head3 LONG FILENAMES ON NTFS + +NTFS supports filenames up to 255 characters long. "Character" means +a 2 byte UTF-16 codepoint which can encode the most common Unicode +codepoints. + +Most Linux filesystems support filenames up to 255 I<bytes>. +This means you may get an error: + + File name too long + +when you copy a file from NTFS to a Linux filesystem if the name, when +reencoded as UTF-8, would exceed 255 bytes in length. + +This will most often happen when using non-ASCII names that are longer +than ~127 characters (eg. Greek, Cyrillic) or longer than ~85 +characters (Asian languages). + +A workaround is not to try to store such long filenames on Linux +native filesystems. Since the L<tar(1)> format can store unlimited +length filenames, keep the files in a tarball. + =head3 ACCESSING THE WINDOWS REGISTRY Libguestfs also provides some help for decoding Windows Registry |