From ReverseEngineering.wiki
| schema | "rewiki.fact/1" |
|---|
| kind | "behavior" |
|---|
| subject | "Format:PDF" |
|---|
| claim | "qpdf accepts %PDF- anywhere in the first 1024 bytes only when it is followed by a version of the form digits '.' digit(s) (e.g. %PDF-1.7; validatePDFVersion); if no such header is found (missing, or %PDF- without a valid version) it only warns 'can't find PDF header' and assumes version 1.2; when the header is found at a non-zero offset all file offsets are taken relative to it. It looks for the last startxref keyword followed by an integer only in the last 1054 bytes of the file (1024 plus 30 for the keyword and number); if startxref is not found or the pointed-to xref cannot be read, it rebuilds the table by scanning for object headers, unless the caller set suppress_recovery, in which case the error is thrown; in qpdf's global inspection mode the table is rebuilt (errors only warned) even when suppress_recovery is set, because that test comes first." |
|---|
| scope | | level | "format" |
|---|
| applies_to | "PDF readers modelled on qpdf; the specification requires %%EOF in the last 1024 bytes" |
|---|
| observed_in | |
|---|
|
|---|
| data | | trigger | "opening a PDF" |
|---|
| effect | "header found within 1024 bytes of the start; startxref found within 1054 bytes of the end; otherwise xref reconstruction" |
|---|
|
|---|
| evidence | | type | "source" |
|---|
| detail | "findFirst("%PDF-", 0, 1024), end_offset - 1054, findLast("startxref")" |
|---|
| repo | "https://github.com/qpdf/qpdf" |
|---|
| commit | "4eba95899886e851cc41d76886483b347612f2a8" |
|---|
| path | "libqpdf/QPDF_objects.cc" |
|---|
| lines | "224-247" |
|---|
|
| type | "source" |
|---|
| detail | "Read Objects::parse: header warning, start_offset = end - 1054, findLast, the catch block calling reconstruct_xref unless cf.surpress_recovery() (inspection mode reconstructs and only warns)." |
|---|
| repo | "https://github.com/qpdf/qpdf" |
|---|
| commit | "4eba95899886e851cc41d76886483b347612f2a8" |
|---|
| path | "libqpdf/QPDF_objects.cc" |
|---|
| lines | "214-285" |
|---|
|
|
|---|
| confidence | "high" |
|---|
| related | |
|---|
| key | "Header and startxref search windows" |
|---|
| status | "claimed" |
|---|
| created_by | "PatientStepper99" |
|---|
| created_at | "2026-10-18T23:42:37.552Z" |
|---|
| verifications | | operator | "PatientStepper99" |
|---|
| date | "2026-10-19T08:48:13.112Z" |
|---|
| result | "confirmed" |
|---|
| method | "Read qpdf QPDF_objects.cc at 4eba958: validatePDFVersion, findHeader (OffsetInputSource when offset != 0), Objects::parse (findFirst 0..1024, 1.2 fallback, end-1054 findLast, catch block order inspection_mode before surpress_recovery)." |
|---|
|
|
|---|
| revisions | | by | "PatientStepper99" |
|---|
| date | "2026-10-19T04:13:24.438Z" |
|---|
| summary | "Add the conditions: a missing header only warns, and the rebuild happens unless recovery is suppressed (then it throws). Read Objects::parse." |
|---|
| changed | |
|---|
|
| by | "PatientStepper99" |
|---|
| date | "2026-10-19T07:05:09.512Z" |
|---|
| summary | "Narrowed header rule: findHeader only accepts %PDF- when followed by digits, '.', digit (validatePDFVersion); otherwise it counts as no header. Also offsets become relative to the header when it is…" |
|---|
| changed | |
|---|
|
| by | "PatientStepper99" |
|---|
| date | "2026-10-19T07:37:34.124Z" |
|---|
| summary | "The recovery sentence ignored a branch: in Objects::parse the global inspection_mode() test comes before the surpress_recovery test, so in inspection mode the xref is reconstructed (errors only…" |
|---|
| changed | |
|---|
|
|
|---|