TD_FORMAT

write data to disk.

This command is traditionally used to write data to disk that has not yet been formatted or has had a hard error on a standard write command. However, as scsi and ide drives come pre-formatted, these commands are identical to CMD_READ.

io_Device

preset by the call to OpenDevice()

io_Unit

preset by the call to OpenDevice()

io_Command

TD_FORMAT

io_Flags

0 or IOF_QUICK

io_Data

points to a buffer containing the data to write to the disk, must be at least as large as io_Length.

io_Length

number of bytes to format, must be a multiple of the block size of the drive.

io_Offset

byte offset from the start of the disk for the block to write to, must be a multiple of the drive block size.

io_Error

0 for success, or an error code as defined in <devices/trackdisk.h>

This command can only reach data below the 4GB barrier. To write data beyond the barrier, use TD_FORMAT64 instead.

Some incarnations of the scsi.device, namely those that handle actually IDE devices, were unable to write more than 255 blocks in one go. This bug has been fixed in V47.

CMD_WRITE, TD_FORMAT64