mirrors/libguestfs
1
0
Fork 0
mirror of https://github.com/libguestfs/libguestfs.git synced 2026-03-22 07:03:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: guestfs_case_sensitive_path returns error on non-existent path

Browse Source
This commit is contained in:
Matthew Booth
2013-10-29 13:27:30 +00:00
parent 2f85affefb
commit 12e0e3fb09
1 changed files with 25 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
generator/actions.ml
View File

@@ -7150,13 +7150,32 @@ a problem.
Bug or feature? You decide:
L<http://www.tuxera.com/community/ntfs-3g-faq/#posixfilenames1>
This function resolves the true case of each element in the
path and returns the case-sensitive path.
C<guestfs_case_sensitive_path> attempts to resolve the true case of
each element in the path. It will return a resolved path if either the
full path or its parent directory exists. If the parent directory
exists but the full path does not, the case of the parent directory
will be correctly resolved, and the remainder appended unmodified. For
example, if the file C<\"/Windows/System32/netkvm.sys\"> exists:
Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")
might return C<\"/WINDOWS/system32\"> (the exact return value
would depend on details of how the directories were originally
created under Windows).
=over 4
=item C<guestfs_case_sensitive_path> (\"/windows/system32/netkvm.sys\")
\"Windows/System32/netkvm.sys\"
=item C<guestfs_case_sensitive_path> (\"/windows/system32/NoSuchFile\")
\"Windows/System32/NoSuchFile\"
=item C<guestfs_case_sensitive_path> (\"/windows/system33/netkvm.sys\")
I<ERROR>
=back
I<Note>:
Because of the above behaviour, C<guestfs_case_sensitive_path> cannot
be used to check for the existence of a file.
I<Note>:
This function does not handle drive names, backslashes etc.