diff options
author | Jay Berkenbilt <ejb@ql.org> | 2017-07-28 05:42:27 +0200 |
---|---|---|
committer | Jay Berkenbilt <ejb@ql.org> | 2017-07-28 05:42:27 +0200 |
commit | 7f8892525f897b17049f9e59bc4ce8ac28c9e082 (patch) | |
tree | 8f46d2ac355e8245cb2e0c764ebe0b34923e3494 /manual | |
parent | 428d96dfe19da96ac4759b190f5b25cf75ecdac6 (diff) | |
download | qpdf-7f8892525f897b17049f9e59bc4ce8ac28c9e082.tar.zst |
Add precheck streams capability
When requested, QPDFWriter will do more aggress prechecking of streams
to make sure it can actually succeed in decoding them before
attempting to do so. This will allow preservation of raw data even
when the raw data is corrupted relative to the specified filters.
Diffstat (limited to 'manual')
-rw-r--r-- | manual/qpdf-manual.xml | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/manual/qpdf-manual.xml b/manual/qpdf-manual.xml index a4c34e90..cd35718d 100644 --- a/manual/qpdf-manual.xml +++ b/manual/qpdf-manual.xml @@ -822,6 +822,23 @@ outfile.pdf</option> </listitem> </varlistentry> <varlistentry> + <term><option>--precheck-streams</option></term> + <listitem> + <para> + Tells qpdf to precheck each stream for the ability to decode + it. Ordinarily qpdf tries to decode streams that it thinks it + can decode based on the filters, and if there ends up being an + error when actually trying to do the decode, the stream data + is truncated. This flag causes qpdf to actually read the + stream fully before deciding whether to filter the stream. + This option will slow qpdf down since it will have to read the + stream twice, but it allows raw stream data to be preserved in + cases where the decoding of the stream would fail for some + reason. This may be useful in working with some damaged files. + </para> + </listitem> + </varlistentry> + <varlistentry> <term><option>--qdf</option></term> <listitem> <para> |