read-failure

Reading stops, stalls, or repeatedly retries

Start with observable symptoms. Do not change firmware, buy software, or repeat a long job until the checks below narrow the cause.

Possible causes

Check in this order

  1. Try a known-good synthetic source to separate software from hardware.
  2. Check free space and destination filesystem errors.
  3. Record the timestamp and repeated error block.

Fix steps

  1. Move the destination to verified local storage with sufficient free space.
  2. If the synthetic source passes, stop repeating the long job until the physical source or connection is checked.

When to escalate

Escalate when the same offset or playlist fails repeatedly after storage and software-path checks pass.

If it is still unresolved, collect

Known log signatures

read error | i/o error | retry | failed to read | unrecoverable

Evidence

Return to the local log matcher