Ext2emu converts an extracted data file to an emulator file.

--cylinders -c #

The number of cylinders.

--emulation_file -m filename

File name to write emulation bit data to.

--extracted_data_file -e filename

File name to read decoded data from.

--format -f WD_1006 | OMTI_5510 | DEC_RQDX3 | Xebec_104786 | Olivetti

The track format. Not all formats listed. Use --format help to list all currently supported formats.

--heads -h #

The number of heads.

--interleave -i #,#

The sector interleave and track interleave. Both parameters must be specified if interleave specified. The first parameter is the value to increment sector number by between sectors on the same track. The second parameter is the value to increment the first sector by for track on the same cylinder.

--mark_bad -M #,#,#:#,#,#...

The cylinder,head,sector to mark bad by complementing the CRC/Check code. Use to force sectors that are known to be bad to be seen as bad by the host system.

--note -n “string”

String is stored in header of emulation file for information about image. mfm_util will display.

--quiet -q #h

Bit mask to select which messages not to print. 0 is print all messages. Default is 1 (no debug messages). Higher bits are more important messages in general.

--version -v

Print program version number.

Long options can be abbreviated to the shortest unique name. Option values can't have spaces unless quoted as a string.

# is a number. #h is a number which may be decimal, octal if starts with a 0, or hex starting with 0x.

Cylinders, heads, format, emulation_file and extracted_data_file are required. The cylinders, format, and heads parameters can be determined by mfm_util if an emulator or transitions file is available.

NOTE: Some computers use different format on different tracks. This program can only handle one format.


ext2emu --extracted_data_file extracted_data --emulation_file emulation_file --cylinders 300 --heads 4 --format OMTI_5510 --interleave 3,1 –mark_bad 3,2,6:6,1,3:200,4,14 –note “Regenerated file”

This would generate sectors 0, 3, 6… for first track, 1, 4, 7... for second track, 2, 5, 8... for third. The start of the next cylinder will start back with sector 0.

If the extracted data file size calculated using the specified cylinders and tracks doesn't match the actual file size the warning message “Calculated extract file size # bytes, actual size #'” will be printed. Verify the parameters are correct for the file being converted.