Skip to content

Commit 68795dd

Browse files
committed
Add note on os.unzip.stream not supporting perms and symlinks
1 parent a964875 commit 68795dd

File tree

1 file changed

+3
-0
lines changed

1 file changed

+3
-0
lines changed

Readme.adoc

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1435,6 +1435,9 @@ os.unzip.stream(
14351435
This can be useful if the zip file does not exist on disk, e.g. if it is received over the network
14361436
or produced in-memory by application logic.
14371437

1438+
File permissions and symbolic links are not supported since permissions and symlink mode are stored as external attributes which might reside in the central directory located at the end of the zip archive.
1439+
For more a more detailed explanation see the `ZipArchiveInputStream` vs `ZipFile` section at [[https://commons.apache.org/proper/commons-compress/zip.html]]
1440+
14381441
OS-Lib also provides the `os.unzip.streamRaw` API, which is a lower level API used internally
14391442
within `os.unzip.stream` but can also be used directly if lower-level control is necessary.
14401443

0 commit comments

Comments
 (0)