FriiDump 0.5.3.15: close XGD1 geometry and lead-in capture

[friidump.git] / docs / options

diff --git a/docs/options b/docs/options
index b39d26830932abc9ce1348c38c1068def8f78332..b106e85fc7c89a2687245561f25b9df98e8fb316 100644 (file)
--- a/docs/options
+++ b/docs/options
@@ -1,4 +1,4 @@
-FriiDump 0.5.3.2 - Copyright (C) 2007 Arep
+FriiDump 0.5.3.15 - Copyright (C) 2007 Arep

 This software comes with ABSOLUTELY NO WARRANTY.
 This is free software, and you are welcome to redistribute it
 under certain conditions; see COPYING for details.
 This software comes with ABSOLUTELY NO WARRANTY.
 This is free software, and you are welcome to redistribute it
 under certain conditions; see COPYING for details.


@@ -36,21 +36,24 @@ Available command line options:
                                3 - DVD
                                4 - Xbox/XGD 2048-byte-sector mode
                                    Native profiles: GDR-8050L and GDR-3120L.
                                3 - DVD
                                4 - Xbox/XGD 2048-byte-sector mode
                                    Native profiles: GDR-8050L and GDR-3120L.

-                                   Forced Xbox mode requires a supported Xbox
-                                   unlock profile; no GC/Wii fallback is used.
+                                   Other drives keep normal FriiDump behavior
+                                   unless Xbox mode is explicitly forced.

  -S, --size <sectors>          Force disc size
  -r, --raw <file>              Output to file <file> in raw format (2064-byte
                                sectors)
  -S, --size <sectors>          Force disc size
  -r, --raw <file>              Output to file <file> in raw format (2064-byte
                                sectors)

- -i, --iso <file>              Output to file <file> in ISO format (2048-byte
-                               sectors). For Xbox/XGD this reconstructs the
-                               redump-style XGD1 layout and writes .pfi.bin,
-                               .dmi.bin, and .redump.json metadata when possible
- -X, --xiso <file>             Output Xbox/XGD game partition as XISO (.xiso).
-                               Attempts to read the 32-sector game lead-in
-                               from drive-readable sectors and zero-fills only
-                               unreadable lead-in sectors. Use -i for
-                               redump-style ISO + PFI/DMI/JSON; use -X only
-                               for game-partition XISO.
+ -i, --iso[=<file>]            Output to file <file> in ISO format (2048-byte
+                               sectors). For Xbox/GDR-8050L, omitting <file>
+                               derives Title[MediaID].iso from the XBE/DMI;
+                               providing <file> is an explicit override. For
+                               Xbox/XGD this reconstructs the redump-style
+                               XGD1 layout and writes .pfi.bin, .dmi.bin, and
+                               .redump.json metadata when possible
+ -X, --xiso[=<file>]   Output Xbox/XGD game partition as XISO (.xiso).
+                               For Xbox/GDR-8050L, omitting <file> derives
+                               Title[MediaID].xiso from the XBE/DMI; providing
+                               <file> is an explicit override. Attempts to read
+                               the 32-sector game lead-in from drive-readable
+                               sectors and zero-fills only unreadable sectors.

  -u, --unscramble <file>       Convert (unscramble) raw image contained in
                                <file> to ISO format
  -H, --nohash                  Do not compute CRC32/MD5/SHA-1/SHA-256 hashes
  -u, --unscramble <file>       Convert (unscramble) raw image contained in
                                <file> to ISO format
  -H, --nohash                  Do not compute CRC32/MD5/SHA-1/SHA-256 hashes


@@ -77,14 +80,23 @@ Available command line options:
  -9, --method9                 Use dumping method 9 (Read and dump 5 blocks
                                at a time, using streaming read, using DMA and
                                some speed tricks)
  -9, --method9                 Use dumping method 9 (Read and dump 5 blocks
                                at a time, using streaming read, using DMA and
                                some speed tricks)

+     --hlds-e7-scan            Probe HLDS HIT 0xE7 cache/memdump bases only;
+                               writes JSON and does not crack seeds or dump data
+     --hlds-e7-subcmd-sweep    Probe HIT 0xE7 subcommands/address candidates only;
+                               writes JSON and does not crack seeds or dump data
+     --hlds-e7-memrange-sweep  Sweep wider HIT 0xE7 subcmd 0x01 address ranges;
+                               writes JSON and does not crack seeds or dump data
+     --scan-log <file>         JSON output path for --hlds-e7-scan
+     --scan-dump-prefix <prefix>       Optional raw 0xE7 window dump prefix for --hlds-e7-scan
+     --hlds-profile-report <file> Write selected HLDS profile/evidence JSON
+     --redump-dat-dir <dir> Directory containing canonical Redump DAT files
+                              (default: executable-relative redump_dat, then current directory)
+     --redump-report <file>   Write atomic Redump evidence JSON
+     --no-redump-verify       Disable automatic post-dump DAT verification
+     --xgd1-layout-probe <file> Read-only locked/unlocked XGD1 boundary probe;
+                              writes atomic JSON and does not create an ISO
+     --xgd1-raw-id-probe <file> Modified-firmware cache-flushed, block-aligned raw-ID probe;
+                              maps logical LBAs to decoded physical sector IDs

  -A, --allmethods              Try all known command/method combinations until
                                one works. Reopens the drive for each command so
                                command-specific vendor handlers are rebound.
  -A, --allmethods              Try all known command/method combinations until
                                one works. Reopens the drive for each command so
                                command-specific vendor handlers are rebound.

-
-Xbox dump notes:
- - GDR-8050L redump-style -i follows the original dumper order:
-   primary handshake, media-cycle, re-handshake, metadata/auth probe,
-   media-cycle back to visible DVD-video view, capture video L0/L1, final
-   handshake, zero-fill the 32-sector game lead-in, read game data, then write
-   .pfi.bin, .dmi.bin, and .redump.json.
- - FriiDump sends STOP UNIT / spin-down after dump attempts, success or failure.