SliTaz Repositories

     1.1 --- a/runcom/description.txt	Wed Jun 20 17:42:34 2012 +0200
     1.2 +++ b/runcom/description.txt	Sat Jan 19 14:59:09 2019 +0200
     1.3 @@ -1,41 +1,51 @@
     1.4 -Runcom support DOS .com binary files and boot sector files.
     1.5 +Runcom support DOS `.com` binary files and boot sector files.
     1.6  
     1.7 -1- The DOS .com support
     1.8 +### 1. The DOS `.com` support
     1.9  
    1.10 -Runcom provides few BIOS and DOS (int 21H) interrupt handlers. Many .com files
    1.11 -may not work. DOS .exe are also supported.
    1.12 -You can test it with the file /usr/bin/debug.com, with the command line :
    1.13 -$ debug.com
    1.14 +Runcom provides few BIOS and DOS (int 21H) interrupt handlers. Many `.com`
    1.15 +files may not work. DOS `.exe` are also supported.
    1.16  
    1.17 -2- The boot sector image support
    1.18 +You can test it with the file `/usr/bin/debug.com`, with the command line:
    1.19  
    1.20 -A boot sector image is a 512 bytes file ending with the 0xAA and 0x55 bytes 
    1.21 -with the .bin extension.
    1.22 -Bios disk (int 13H) are emulated (CHS or LBA) with an image file :
    1.23 -- hard disk are image ./hd0, ./hd1, ... for disk 0x80, 0x81...
    1.24 -- floppy disk are image ./fd0, ./fd1 ... or /dev/fd0, /dev/fd1 if not found.
    1.25 -You can test it with the file /usr/bin/debug.bin, with the command line :
    1.26 -$ debug.bin
    1.27 +    $ debug.com
    1.28  
    1.29 -3- The 512 bytes boot sector debugger /usr/bin/debug.bin
    1.30 +### 2. The boot sector image support
    1.31 +
    1.32 +A boot sector image is a 512 bytes file ending with the **0xAA** and **0x55**
    1.33 +bytes with the `.bin` extension.
    1.34 +
    1.35 +BIOS disk (int 13H) are emulated (CHS or LBA) with an image file:
    1.36 +
    1.37 +  - hard disk are image ./hd0, ./hd1, ... for disk 0x80, 0x81...
    1.38 +  - floppy disk are image ./fd0, ./fd1 ... or /dev/fd0, /dev/fd1 if not found.
    1.39 +
    1.40 +You can test it with the file `/usr/bin/debug.bin`, with the command line:
    1.41 +
    1.42 +    $ debug.bin
    1.43 +
    1.44 +### 3. The 512 bytes boot sector debugger `/usr/bin/debug.bin`
    1.45  
    1.46  Usage:
    1.47  
    1.48 - f DX:CX		load one CHS sector to 0000:7C00
    1.49 - t			trace one step
    1.50 - g <address>		go to adrs
    1.51 - d <address>		display 16 bytes, CR for next 16 bytes...
    1.52 - e <address> <words>...	enter memory byte/word/dword
    1.53 - m <segment>		self move
    1.54 - + <segment>		default segment offset
    1.55 +    f DX:CX                 load one CHS sector to 0000:7C00
    1.56 +    t                       trace one step
    1.57 +    g <address>             go to adrs
    1.58 +    d <address>             display 16 bytes, CR for next 16 bytes...
    1.59 +    e <address> <words>...  enter memory byte/word/dword
    1.60 +    m <segment>             self move
    1.61 +    + <segment>             default segment offset
    1.62  
    1.63 -seqment and offset are hexadecimal values in 0..FFFF range
    1.64 -address is linear hexadecimal value in 0..FFFFF range or seqment:offset
    1.65 -words are bytes in 0..FF range or words in 000..FFFF range or double words
    1.66 -CX and DX are used by INT13H/AL=01 BIOS interrupt.
    1.67 +`seqment` and `offset` are hexadecimal values in `0000..FFFF` range
    1.68 +
    1.69 +`address` is linear hexadecimal value in `00000..FFFFF` range or
    1.70 +`seqment:offset` words are bytes in `00..FF` range or words in `0000..FFFF`
    1.71 +range or double words
    1.72 +
    1.73 +`CX` and `DX` are used by `INT13H/AL=01` BIOS interrupt.
    1.74  
    1.75  Example:
    1.76 - m 0FC0			move debugger to 0FC0:0000 0FC0:01FF
    1.77 - f 1			read floppy boot sector to 0000:7C00
    1.78 - f 80:1			read hard disk master boot sector to 0000:7C00
    1.79 - g 7C0E			...
    1.80 +
    1.81 +    m 0FC0    move debugger to 0FC0:0000 0FC0:01FF
    1.82 +    f 1       read floppy boot sector to 0000:7C00
    1.83 +    f 80:1    read hard disk master boot sector to 0000:7C00
    1.84 +    g 7C0E    ...