pq/libfreemkv
1
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

docs: correct info invocation and read timeouts

Browse Source 
TROUBLESHOOTING step 2 said `freemkv info`, which needs a source URL;
the drive route is `freemkv info disc://`.

architecture.md quoted 1.5 s / 30 s for the read timeouts. The
constants are READ_TIMEOUT_MS = 10_000 and READ_RECOVERY_TIMEOUT_MS =
60_000 (src/scsi/mod.rs:72,94).
This commit is contained in:
Matthew Jackson
2026-07-30 13:21:04 -07:00
parent 8d4a6d54a4
commit e4b1e5b19e
2 changed files with 2 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
TROUBLESHOOTING.md
+1 -1
View File
@@ -302,7 +302,7 @@ Many external drive enclosures (Vantec NexStar, Sabrent, OWC, etc.) do not adver
When something goes wrong during a rip, gather this information before filing an issue: When something goes wrong during a rip, gather this information before filing an issue:
1. **freemkv version:** `freemkv --version` or the crate version in `Cargo.toml`. 1. **freemkv version:** `freemkv --version` or the crate version in `Cargo.toml`.
2. **Drive model:** from the drive label, or from `freemkv info`. 2. **Drive model:** from the drive label, or from `freemkv info disc://`.
3. **Connection type:** USB (with bridge chipset if known) or direct SATA. 3. **Connection type:** USB (with bridge chipset if known) or direct SATA.
4. **Operating system and kernel:** `uname -a`. 4. **Operating system and kernel:** `uname -a`.
5. **Kernel messages during the failure:** `dmesg | tail -50` immediately after the crash. 5. **Kernel messages during the failure:** `dmesg | tail -50` immediately after the crash.
docs/architecture.md
+1 -1
View File
@@ -96,7 +96,7 @@ After open:
- `init()` -- routes to the matching registered unlocker (if any); otherwise - `init()` -- routes to the matching registered unlocker (if any); otherwise
a no-op and the cert handshake carries the disc a no-op and the cert handshake carries the disc
- `probe_disc()` -- probe disc surface for optimal speeds - `probe_disc()` -- probe disc surface for optimal speeds
- `read(lba, count, buf, recovery)` -- single-shot read; `recovery` only selects the per-CDB timeout (1.5 s vs. 30 s) - `read(lba, count, buf, recovery)` -- single-shot read; `recovery` only selects the per-CDB timeout (`READ_TIMEOUT_MS` 10 s vs. `READ_RECOVERY_TIMEOUT_MS` 60 s)
- `wait_ready()` -- wait for disc insertion - `wait_ready()` -- wait for disc insertion
- `eject()` -- eject tray - `eject()` -- eject tray