diff options
Diffstat (limited to 'src/unalf.1')
| -rw-r--r-- | src/unalf.1 | 33 |
1 files changed, 27 insertions, 6 deletions
diff --git a/src/unalf.1 b/src/unalf.1 index f7d4ff3..2c8054f 100644 --- a/src/unalf.1 +++ b/src/unalf.1 @@ -27,7 +27,7 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. -.TH "UNALF" 1 "2025-12-02" "0.3.0" "Urchlay's Atari 8-bit Tools" +.TH "UNALF" 1 "2025-12-03" "0.3.0" "Urchlay's Atari 8-bit Tools" .SH NAME unalf \- extract Atari 8-bit ALF archives .\" RST source for unalf(1) man page. Convert with: @@ -111,6 +111,15 @@ backup is made. . .INDENT 0.0 .TP +.B \-F +Force \fBunalf\fP to continue after detecting an invalid compressed file +size in an \fIALF\fP header. This isn\(aqt the default because it can cause +\fBunalf\fP to get stuck in an infinite loop. +.UNINDENT +.\" force uncompressing in case of invalid compressed size. +. +.INDENT 0.0 +.TP .B \-h\fP,\fB \-\-help Show built\-in help message. .UNINDENT @@ -287,6 +296,20 @@ cause these errors. .TP .B \fBfatal: compressed data is truncated, EOF before end marker\fP Self\-explanatory. The ALF file ends before the compressed data does. +.TP +.B \fBheader #<n> (compressed|original) size is impossibly large (>16MB)\fP +\fBunalf\fP can\(aqt handle files of more than 16MB in size. This isn\(aqt a +bug, it\(aqs just the way it was designed (in 1988, remember). Neither +\fBLZ.COM\fP nor \fBalf\fP will create files like this, so you \fIprobably\fP +have a corrupt ALF archive. +.TP +.B \fBcompressed size for header #<n> is bigger than the rest of the file (truncated?)\fP +Normally this means a truncated \fIALF\fP file, or one with a corrupted header. +You can use the \fB\-F\fP option to turn this error into a non\-fatal warning. +.TP +.B \fBcompressed size for header #<n> is over twice the uncompressed size (corrupt?)\fP +This generally means you have a corrupted \fIALF\fP file. +You can use the \fB\-F\fP option to turn this error into a non\-fatal warning. .UNINDENT .SS Warnings .sp @@ -333,11 +356,9 @@ with A\-Z" or "invalid character". The filename will be printed with any unprintable characters as hex values (e.g. \fB$01\fP). .TP .B \fBheader #<n> (compressed|original) size is...\fP -Followed by "impossibly large", "suspiciously large", or "too large -to fit on a floppy disk". May indicate a corrupt archive, or someone -really might have created an ALF file with files this big... though -"impossibly large" means >=16MB. \fBunalf\fP can\(aqt extract a file -that big. +Followed by "suspiciously large" or "too large to fit on a floppy +disk". May indicate a corrupt archive, or someone really might have +created an ALF file with files this big. .TP .B \fBALF files don\(aqt normally contain other ALF files, are you trying to extract/list multiple ALF files at once?\fP You gave a \fIwildcard\fP argument that ends with \fI\&.alf\fP\&. This is OK if |