# device-streams
Amiga tool for copying between block devices and streams/files, similar to UNIX `dd`.
Originally released by Christian E. Hopps in 1993, updated to be useful today.

Requires AmigaOS 2.04+.

## Usage
Run the command with `-h` parameter to display usage information.

### Examples
#### Print RDB device and partition information.
```
5.Ram Disk:> devstreams/rdbinfo
Device: "scsi.device"  Unit: 0  Capacity: 114473.4 Megs
DiskVendor: FUJITSU  DiskProduct MHV2120AH        DiskRevision: 0000
Cylinders: 232581  Heads: 16  Blks-p-Trk: 63 [Blks-p-Cyl: 1008]
Total Blocks: 234441648  Block Size 512
64bit

--| Partition: "DH0" Capacity: 1023.7 Megs
--| Start Block: 3024  End Block: 2099663 Total Blocks: 2096640
--| Block Size: 512

--| Partition: "DH1" Capacity: 10239.4 Megs
--| Start Block: 2099664  End Block: 23070095 Total Blocks: 20970432
--| Block Size: 512
--| 64bit
###
```
#### Dump a partition into a file.
```
5.Ram Disk:> devstreams/devtostream --output=DH1:dump.dd --rdb-name=DH0 --verbose
found new device "scsi.device"
found drive FUJITSU  MHV2120AH        0000 [capacity:114473M]
 at unit 0 on device "scsi.device"
| partition: "DH0" sb: 3024 eb: 2099663 totb: 2096640
|            Block Size: 512 Capacity: 1023.7
| partition: "DH1" sb: 2099664 eb: 23070095 totb: 20970432
|            Block Size: 512 Capacity: 10239.4
found partition: "DH0" capacity: 1023.7 Megs
start block: 3024  end block: 2099663 total blocks: 2096640
block Size: 512
dumping: start block: 3024 to end block: 2099663 [size: 1048319K]

write from partition "DH0" to file "DH1:dump.dd"? [Ny]:y
writing: 0x00200950 -> 0x002009cf  [100%]
```
## Improvements
* Cleaned up code.
* Removed SAS/C-isms and updated to build in modern toolchains.
* Use of 64bit offsets throughout.
* Safeguards added against 32bit overflow wraparound.
* (soon) Trackdisk 64 support.

## Building
The new build process uses GNU Make. Simply review the Makefile and run `make`.

Alternatively,
* `make clean` will delete all artifacts.
* `make lint` will format the code to standards.
* `make dist` will prepare a lha archive with the binaries.

Development is done using the `bebbo/amiga-gcc` crossdev toolchain.
https://github.com/bebbo/amiga-gcc

## Authors
* Roc Vallès Domènech (2022)
* Christian E. Hopps (1993)

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                    0       0 ****** -lhd- 0000 Sep 30 02:13 device-streams-master
[unknown]                   63      91  69.2% -lh5- 2b25 Sep 30 02:13 device-streams-master.gitignore
[unknown]                 6993   17982  38.9% -lh5- dc3e Sep 30 02:13 device-streams-masterCOPYING
[unknown]                  767    1786  42.9% -lh5- 97af Sep 30 02:13 device-streams-masterMakefile
[unknown]                  870    2306  37.7% -lh5- 600c Sep 30 02:13 device-streams-masterMakefile.chopps
[unknown]                 1272    2497  50.9% -lh5- b42a Sep 30 02:13 device-streams-masterREADME
[unknown]                 1152    2297  50.2% -lh5- f918 Sep 30 02:13 device-streams-masterREADME.md
[unknown]                  578    1427  40.5% -lh5- 6e14 Sep 30 02:13 device-streams-mastercommon.c
[unknown]                 1524    4333  35.2% -lh5- 50dd Sep 30 02:13 device-streams-masterdevices.c
[unknown]                  870    1834  47.4% -lh5- 3f24 Sep 30 02:13 device-streams-masterdevices.h
[unknown]                 3275   11542  28.4% -lh5- 96b3 Sep 30 02:13 device-streams-masterdevtostream.c
[unknown]                 3783   12904  29.3% -lh5- 063d Sep 30 02:13 device-streams-mastergetdevices.c
[unknown]                  663    1338  49.6% -lh5- b300 Sep 30 02:13 device-streams-mastergetdevices.h
[unknown]                 1136    3540  32.1% -lh5- 2534 Sep 30 02:13 device-streams-masterprotos.h
[unknown]                 2683    9237  29.0% -lh5- bfbb Sep 30 02:13 device-streams-masterrdbinfo.c
[unknown]                 3464   12196  28.4% -lh5- 15a4 Sep 30 02:13 device-streams-masterstreamtodev.c
[unknown]                 2885    9151  31.5% -lh5- 084b Sep 30 02:13 device-streams-masterutil.c
[unknown]                  845    1752  48.2% -lh5- 218f Sep 30 02:13 device-streams-masterutil.h
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        18 files   32823   96213  34.1%            Oct  1 18:36