Aaru.Documentation/5.3/Creating-a-dump-from-physical-media.md

==Command description== This operating will create a dump image from real media using a physical device. It will retry errors and when finished create an XML metadata sidecar and an Alcohol 120% media descriptor for optical media. The dumping operation can be interrupted and continued later, even with a different device.

==Command usage== Aaru dump-media -d [true/false] -e -f [true/false] -i -k --lead-in [true/false] -m [true/false] --no-metadata [true/false] --no-trim [true/false] -O -o --persistent [true/false] -p -s [true/false] -t -v [true/false] -x

-d, --debug=[true/false] shows debug output ''(default false)''
-e, --encoding= character encoding to use when creating dump sidecar
-f, --force=[true/false] continuing dumping whatever happens ''(default false)''
-i, --input= path to the physical device
-k, --skip= skip this many sectors when an unreadable sector is found ''(default 512)''
--lead-in=[true/false] try to dump Lead-in. Only applicable to CD, DDCD or GD media ''(default false)''
-m, --resume=[true/false] create and/or use resume mapfile ''(default true)''
--no-metadata=[true/false] disables creating CICM XML sidecar ''(default false)''
--no-trim=[true/false] disables trimming errores from skipped sectors ''(default false)''
-O, --options= comma separated name=value pairs of options to pass to output image plugin
-o, --output= output image filename
--persistent=[true/false] try to recover partial or incorrect data ''(default false)''
-p, --retry-passes= how many times to retry reading a sector ''(default 5)''
-s, --stop-on-error=[true/false] stops dumping on first error ''(default false)''
-t, --format= format for the output image, as plugin name or plugin id. If not present, will try to detect it from output image extension
-v, --verbose=[true/false] shows verbose output ''(default false)''
-x, --cicm-xml= take metadata from existing CICM XML sidecar

==Example== FreeBSD: Aaru dump-media -i /dev/cd0 -f --persistent=true --separate-subchannel -w mydisc
Linux: Aaru dump-media -i /dev/sdb -r -f -p 15 -w myusbfloppy
Windows: Aaru dump-media -i \.\PhysicalDrive3 -f -p 0 --resume=false mydisk

==Operating system support== {| ! Device type ! FreeBSD ! macOS ! Linux ! Windows |- | SCSI Block device | Yes | No macOS only allows talking with MultiMedia devices | Yes | Yes |- | SCSI MultiMedia device | Yes | Not yet Support for MultiMedia devices in macOS will be added if users require it | Yes | Yes |- | SCSI Streaming device | Yes | No | Yes | Yes |- | Parallel ATA | No Not supported due to upstream bug | No | Yes | Yes |- | Serial ATA | Yes | No | Yes | Yes |- | USB | Partial USB descriptors are not retrieved | Partial Only MultiMedia devices can be supported and descriptors will not be retrieved | Yes | Yes |- | FireWire | Partial FireWire descriptors are not retrieved | Partial | Yes | Partial FireWire descriptors are not retrieved |- | PCMCIA | Partial PCMCIA CIS is not retrieved | Partial | Yes | Partial PCMCIA CIS is not retrieved |- | SecureDigital / MultiMediaCard | Not yet Support will come with FreeBSD 12-RELEASE | No | Yes | Untested Should work, untested due to not available hardware |}