Files
Aaru.Documentation/media/scan.md
2021-08-19 11:08:54 -07:00

56 lines
2.3 KiB
Markdown

# Table of Contents
- [Command Description](#command-description)
- [Command usage](#command-usage)
- [Example](#example)
- [Operating system support](#operating-system-support)
## Command Description
This operation will read the media inserted in the physical device and measure how fast it can be read sequentially.
It's not intended as a benchmark, but as a detector of damaged sectors, sectors that are losing readability, etc. When
finished it will check how fast can the device seek and report speed statistics.
## Command usage
```bash
Aaru -d [true/false] -v [true/false] media scan -h [true/false] -b [ibglog] -m [mhddlog] <device-path/aaru-remote-host>
```
`-d, --debug [true/false]` shows debug output *(default false)*
`-v, --verbose [true/false]` shows verbose output *(default false)*
`-h, --help [true/false]` shows help screen for the command instead of running it, ignores all other switches *(default
false)*
`-b, --ibg-log [ibglog]` writes a log in the format used by ImgBurn
`-m, --mhdd-log [mhddlog]` writes a log in the format used by MHDD
`<aaru-remote-host>` connects to an Aaru Remote Host with aaru:///
## Example
FreeBSD: `Aaru media scan /dev/cd0`
Linux: `Aaru media scan /dev/sdb`
Windows: `Aaru media scan \\.\PhysicalDrive3`
## Operating system support
| Device Type | FreeBSD | MacOS | Linux | Windows |
|--------------|----------|--------|--------|----------|
| SCSI Block device | Yes | No¹ | Yes | Yes |
| SCSI MultiMedia device | Yes | Not yet² | Yes | Yes |
| SCSI Streaming device | Yes | No¹ | Yes | Yes |
| Parallel ATA | No³ | No¹ | Yes | Yes |
| Serial ATA | Yes | No¹ | Yes | Yes |
| USB | Partial⁴ | Partial⁵ | Yes | Yes |
| FireWire | Partial⁶ | Partial⁵ | Yes | Partial⁶ |
| PCMCIA | Partial⁷ | Partial⁵ | Yes | Partial⁷ |
| SecureDigital / MultiMediaCard | Not yet⁸ | No¹ | Yes | Untested⁹ |
1. macOS only allows talking with MultiMedia devices.
2. Support for MultiMedia devices in macOS will be added if users require it
3. Not supported due to upstream bug
4. USB descriptors are not retrieved
5. Only MultiMedia devices can be supported and descriptors will not be retrieved
6. FireWire descriptors are not retrieved
7. PCMCIA CIS is not retrieved
8. Support will come with FreeBSD 12-RELEASE
9. Should work, untested due to no available hardware