wok diff runcom/description.txt @ rev 11674

add runcom
author Pascal Bellard <pascal.bellard@slitaz.org>
date Sat Feb 18 09:00:05 2012 +0100 (2012-02-18)
parents
children 5d74983842db
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/runcom/description.txt	Sat Feb 18 09:00:05 2012 +0100
     1.3 @@ -0,0 +1,41 @@
     1.4 +Runcom support DOS .com binary files and boot sector files.
     1.5 +
     1.6 +1- The DOS .com support
     1.7 +
     1.8 +Runcom provides few BIOS and DOS (int 21H) interrupt handlers. Many .com files
     1.9 +may not work. DOS .exe are also supported.
    1.10 +You can test it with the file /usr/bin/debug.com, with the command line :
    1.11 +$ debug.com
    1.12 +
    1.13 +2- The boot sector image support
    1.14 +
    1.15 +A boot sector image is a 512 bytes file ending with the 0xAA and 0x55 bytes 
    1.16 +with the .bin extension.
    1.17 +Bios disk (int 13H) are amulated (CHS or LBA) with image file :
    1.18 +- hard disk are image ./hd0, ./hd1, ... for disk 0x80, 0x81...
    1.19 +- floppy disk are image ./fd0, ./fd1 ... or /dev/fd0, /dev/fd1 if not found.
    1.20 +You can test it with the file /usr/bin/debug.bin, with the command line :
    1.21 +$ debug.bin
    1.22 +
    1.23 +3- The boot sector debugger /usr/bin/debug.bin
    1.24 +
    1.25 +Usage:
    1.26 +
    1.27 + f DX:CX		load one CHS sector to 0000:7C00
    1.28 + t			trace one step
    1.29 + g <address>		go to adrs
    1.30 + d <address>		display 16 bytes, CR for next 16 bytes...
    1.31 + e <address> <words>...	enter memory byte/word/dword
    1.32 + m <segment>		self move
    1.33 + + <segment>		default segment offset
    1.34 +
    1.35 +seqment and offset are hexadecimal values in 0..FFFF range
    1.36 +address is linear hexadecimal value in 0..FFFFF range or seqment:offset
    1.37 +words are bytes in 00..FF range or words in 0000..FFFF range or double words
    1.38 +CX and DX are used by INT13H/AL=01 BIOS interrupt.
    1.39 +
    1.40 +Example:
    1.41 + m 0FC0			move debugger to 0FC0:0000 0FC0:01FF
    1.42 + f 1			read floppy boot sector to 0000:7C00
    1.43 + f 80 1			read hard disk master boot sector to 0000:7C00
    1.44 + g 7C0E			...