Command-line options

[FRIIDUMP] Log file: friidump.log
FriiDump 0.5.3.16-pf1 - 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.

Official support forum: http://wii.console-tribe.com

Forum for this UNOFFICIAL VERSION: http://forum.redump.org


Available command line options:

 -h, --help			Show this help
 -a, --autodump			Dump the disc to an ISO file with an
				automatically-generated name, resuming the dump
				if possible
 -g, --gui			Use more verbose output that can be easily
				parsed by a GUI frontend
 -d, --device <device>		Dump disc from device <device>
 -p, --stop			Instruct device to stop disc rotation
 -D, --dvd			Force standard DVD-ROM mode for any drive
				(equivalent to -T 3; uses FriiDump original
				DVD/raw/ISO paths, not Xbox mode)
 -c, --command <nr>		Force memory dump command:
				0 - vanilla 2064
				1 - vanilla 2384
				2 - Hitachi
				3 - Lite-On
				4 - Renesas
 -x, --speed <x>		Set streaming speed (1, 24, 32, 64, etc.,
				where 1 = 150 KiB/s and so on)
 -T, --type <nr>		Force disc type:
				0 - GameCube
				1 - Wii
				2 - Wii_DL
				3 - DVD
				4 - Xbox/XGD 2048-byte-sector mode
				    Native profiles: GDR-8050L and GDR-3120L.
				    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)
 -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
				for generated files
 -s, --resume			Resume partial dump
				-  General  -----------------------------------
 -0, --method0[=<req>,<exp>]	Use dumping method 0 (Optional argument
				specifies how many sectors to request from disc
				and read from cache at a time. Values should be
				separated with a comma. Default 16,16)
				-  Non-Streaming  -----------------------------
 -1, --method1[=<req>,<exp>]	Use dumping method 1 (Default 16,16)
 -2, --method2[=<req>,<exp>]	Use dumping method 2 (Default 16,16)
 -3, --method3[=<req>,<exp>]	Use dumping method 3 (Default 16,16)
				-  Streaming  ---------------------------------
 -4, --method4[=<req>,<exp>]	Use dumping method 4 (Default 27,27)
 -5, --method5[=<req>,<exp>]	Use dumping method 5 (Default 27,27)
 -6, --method6[=<req>,<exp>]	Use dumping method 6 (Default 27,27)
				-  Hitachi  -----------------------------------
 -7, --method7			Use dumping method 7 (Read and dump 5 blocks
				at a time, using streaming read)
 -8, --method8			Use dumping method 8 (Read and dump 5 blocks
				at a time, using streaming read, using DMA)
 -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: bundled executable data, installed share data, then current directory)
                              Environment override: FRIIDUMP_REDUMP_DAT_DIR
     --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
                              Native .friidump.json reports are created by default
                              beside the final log using its filename
     --report-json <file>     Override the complete native report pathname
     --report-dir <directory> Override only the report destination directory
                              (may be combined with --report-json)
     --firmware-modified <note> Mark firmware modified; omission assumes stock
 -A, --allmethods		Try all known command/method combinations until
				one works. Reopens the drive for each command so
				command-specific vendor handlers are rebound.

Linux raw-I/O requirement:
  GC/Wii memory-dump methods and Xbox vendor-unlock paths require effective
  CAP_SYS_RAWIO. Apply cap_sys_rawio=ep to the exact validated executable;
  do not run FriiDump as root. Rebuilds and replacements clear capabilities.
  See docs/LINUX.md and validation/friidump-linux-rawio-capability.sh.