-
Notifications
You must be signed in to change notification settings - Fork 5
/
Copy pathreadme.txt
1282 lines (1090 loc) · 49.7 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
MS-DOS Player for Win32-x64 console
3/23/2025
----- What's This
This is MS-DOS emulator running on Win32-x64 command prompt.
16bit MS-DOS compatible commands can be executed on Win32-x64 envrionment.
This emulator inherits the environment variables from the host Windows,
and a target command can access the host's file path directly.
So you can execute 16bit MS-DOS compatible commands on your 64bit Windows
in the same sence as you did on 32bit Windows, and you do not need to copy
any files to/from a virtual machine (VMware, Virtual PC, XP mode, or others).
NOTE: This emulator DOES NOT support Win16 execution files.
This emulator aims to support character user interface utilities, for example
file converters, compilers, assemblers, debuggers, and text editors.
NOTE: This emulator DOES NOT support graphic/sound hardwares and DOES NOT
aim to support game software. I recommend DOSBOx for this purpose.
----- How To Use
Start a command prompt and run this emulator with a target command file
and any options.
For example, compile a sample.c with LSI C-86 and execute the compiled binary:
> msdos lcc sample.c
> msdos sample.exe
COMMAND.COM is needed to execute a batch file.
> msdos vz.bat readme.doc
In this case, "COMMAND.COM /C vz.bat readme.doc" will be executed.
----- Options
Usage:
MSDOS [-b] [-c[(new exec file)] [-p[P]]] [-d] [-e] [-fN] [-i] [-m] [-n[L[,C]]]
[-s[P1[,P2[,P3[,P4]]]]] [-sd] [-sc] [-vX.XX] [-wX.XX] [-x] [-a]
[-ld[(drivers)]] [-l] [-vt] [-g] [-h] (command) [options]
-b stay busy during keyboard polling
-c convert command file to 32bit or 64bit execution file
-p record current code page when convert command file
-d pretend running under straight DOS, not Windows
-e use a reduced environment block
-f set the limit on number of files process can open
-i ignore invalid instructions
-m restrict free memory to 0x7FFF paragraphs
-n create a new buffer (25 lines, 80 columns by default)
-s enable serial I/O and set host's COM port numbers
-sd enable DTR/DSR flow control
-sc enable RTS/CTS flow control
-v set the DOS version
-w set the Windows version
-x enable XMS and LIM EMS
-a disable ANSI.SYS
-ld load device drivers
-l draw box lines with ank characters
-vt toggle vt mode, default is on for win10 and above
-g use cp437 glyphs for code points 0-31, always enabled in cp437
-h allow making cursor invisible
ISH.COM contains any invalid instructions and it cause an error.
Please specify the option '-i' to ignore the invalid instructions.
> msdos -i ish.com
EDIT.COM does not work correctly when a free memory space is large.
Please specify the option '-m' to restrict free memory to 0x7FFF paragraphs.
> msdos -m edit.com
"Windows Enhanced Mode Installation Check" API (INT 2FH, AX=1600H) and
"Identify Windows Version and Type" API (INT 2FH, AX=160AH) return the Windows
version number 4.10.
If you want to change the version number, please specify the option '-wX.XX'.
> msdos -w3.10 command.com
Or if you want to pretend that Windows is not running, specify the option '-d'.
> msdos -d command.com
"Get Version Number" API (INT 21H, AH=30H) returns the version number 5.00.
If you want to change the version number, please specify the option '-vX.XX'.
> msdos -v3.30 command.com
If '-vX.XX' option is missing and you start COMMAND.COM, MS-DOS Player tries
to get DOS version from COMMAND.COM of MS-DOS, PC-DOS, or Windows 95/98/Me.
NOTE: "Get True Version Number" API (INT 21H, AX=3306H) always returns
the version number 5.50 and '-v' option is not affected.
NOTE: Windows version 4.10 is same as Windows 98.
NOTE: DOS version 5.00 and true DOS version 5.50 are same as NTVDM.
To set the limit on number of files process can open (this is same as FILES=
in COFIG.SYS), please specify the option '-f'. The limit must be 20 to 128.
> msdos -f30 command.com
To enable XMS (i286 or later) and LIM EMS, please specify the option '-x'.
In this time, the memory space 0C0000H-0CFFFFH are used for EMS page frame,
so the size of UMB is decreased from 224KB to 160KB.
To enable the serial I/O, please specify the option '-s[P1[,P2[,P3[,P4]]]]'.
If you specify '-s', the virtual COM1-COM4 are connected to the host's COM
ports found by SetupDiGetClassDevs() API.
You can specify the host's COM port numbers connected to the virtual COM ports
by adding numbers to '-s' option, for example '-s3,4,1,2'.
If you specify '-sd', DTR/DSR flow control is enabled.
In this time, MS-DOS Player sets/gets DTR and DSR pins of the host's COM port.
Otherwise, virtual DTR pin is internally connected to virtual DSR pin, and
DTR pin of the host's COM port is always active.
If you specify '-sc', RTS/CTS flow control is enabled.
In this time, MS-DOS Player sets/gets RTS and CTS pins of the host's COM port.
Otherwise, virtual RTS pin is internally connected to virtual CTS pin, and
RTS pin of the host's COM port is always active.
NOTE: The maximum baud rate is limited to 9600bps.
To load device drivers, please specify the option '-ld'.
This is intended for VDD drivers that use NTVDM.
Drivers made for real DOS may not all work as expected.
Only character devices from .sys files are supported at the moment.
You can load multiple drivers by using a ';' delimiter.
> msdos -ld"device1.sys;device2.sys" command.com
----- Environment Variable Table
Basically, the environment variable table on the host Windows is copied to
the table on the virtual machine (hereinafter, referred to as "virtual table"),
and in this time, APPEND/MSDOS_PATH/PATH/TEMP/TMP values are converted to
short path. The x64 version of MS-DOS Player also replaces "C:\Windows\System"
in these variables to "C:\WINDOWS\SYSWOW64" to prevent 64bit modules are
mistakenly loaded to the virtual MS-DOS machine.
Some software (for example DoDiary Version 1.55) expect that the environment
variable table is not greater than 1024 bytes.
On the Windows OS, there are too many variables and the environment variable
table size will be greater than 1024 bytes and it causes an error.
In this case, please specify the option '-e' and only the minimum environment
variables (APPEND/COMSPEC/COPYCMD/DIRCMD/NO_SEP/LASTDRIVE/MSDOS_PATH/PATH/
PROMPT/TEMP/TMP/TZ) are copied to the virtual table.
> msdos -e dd.com
If you see the message "not enough variable table size (size:%d written:%d)",
start COMMAND.COM with /E option and specify the size greater than the value
in written field.
> msdos -e COMMAND.COM /E:1024
The environment variable COMSPEC is not copied from the host Windows, and its
value on the virtual table is always "C:\COMMAND.COM".
If a program tries to open the "C:\COMMAND.COM" file, the file is redirected
to the path in the environment variable MSDOS_COMSPEC on the host Windows.
If MSDOS_COMSPEC is not defined, it is redirected to the COMMAND.COM file that
does exist:
- in the same directory as the target program file,
- in the same directory as the running msdos.exe,
- in the current directory,
- in the directory that is in MSDOS_PATH and PATH environment variables
You may have a directory that contains 16bit command files, and you may want
not to add this path to PATH on the host Windows but want to add it to PATH
on the virtual table.
In this case, please define MSDOS_PATH on the host Windows, and its value is
copied to the top of PATH on the virtual table.
In other words, the value of PATH on the virtual table is MSDOS_PATH;PATH
on the host Windows, so a program searches files in directories in MSDOS_PATH
before files in directories in PATH.
You can also define MSDOS_APPEND on the host Windows, and its value is copied
to the top of APPEND on the virtual table.
The environment variables TEMP and TMP on the host Windows may be very long,
in usually, it is "C:\User\(Your User Name)\AppData\Local\Temp".
DOSSHELL.EXE tries to create a batch file in the TEMP directry to start
the selected program, and it may not work correctly because of the too long
batch file path.
In this case, please define MSDOS_TEMP on the host Windows, for example
"C:\TEMP", and its value is copied to TEMP and TMP on the virtual table.
If the environment variable MSDOS_LASTDRIVE is defined on the host Windows,
its value is copied to LASTDRIVE on the virtual table.
If both MSDOS_LASTDRIVE and LASTDRIVE are not defined on the host Windows,
LASTDRIVE=Z is automatically defined on the virtual table.
If the environment variable PROMPT is not defined on the host Windows,
PROMPT=$P$G is automatically defined on the virtual table.
If the environment variable MSDOS_TZ is defined on the host Windows,
its value is copied to TZ on the virtual table.
If both MSDOS_TZ and TZ are not defined on the host Windows,
and if your timezone is in the following table, TZ is automatically defined
on the virtual table, for example TZ=JST-9 in Japan.
NOTE: This table is from:
https://science.ksc.nasa.gov/software/winvn/userguide/3_1_4.htm
------- Greenwich Mean Time ---------------------------------------------------
+00:00 GMT Standard Time GMT BST GB London
+00:00 GMT Standard Time GMT IST IE Dublin
+00:00 GMT Standard Time WET WES PT Lisbon
+00:00 Greenwich Standard Time GMT GST IS Reykjavik
------- Fernando De Noronha Std -----------------------------------------------
-02:00 Mid-Atlantic Standard Time FST FDT BR Noronha
-02:00 UTC-02 FST FDT BR Noronha
------- Brazil Standard Time --------------------------------------------------
-03:00 Bahia Standard Time BST BDT BR Bahia
-03:00 SA Eastern Standard Time BST BDT BR Fortaleza
-03:00 Tocantins Standard Time BST BDT BR Palmas
------- Eastern Standard (Brazil) ---------------------------------------------
-03:00 E. South America Standard Time EST EDT BR Sao Paulo
------- Greenland Standard Time -----------------------------------------------
-03:00 Greenland Standard Time GST GDT GL Godthab
------- Newfoundland Standard Time --------------------------------------------
-03:30 Newfoundland Standard Time NST NDT CA St.Johns
------- Atlantic Standard Time ------------------------------------------------
-04:00 Atlantic Standard Time AST ADT CA Halifax
------- Western Standard (Brazil) ---------------------------------------------
-04:00 Central Brazilian Standard Time WST WDT BR Cuiaba
-04:00 SA Western Standard Time WST WDT BR Manaus
------- Chile Standard Time ---------------------------------------------------
-04:00 Pacific SA Standard Time CST CDT CL Santiago
------- Eastern Standard Time -------------------------------------------------
-05:00 Eastern Standard Time EST EDT US New York
-05:00 Eastern Standard Time (Mexico) EST EDT MX Cancun
-05:00 US Eastern Standard Time EST EDT US Indianapolis
------- Acre Standard Time ----------------------------------------------------
-05:00 SA Pacific Standard Time AST ADT BR Rio Branco
------- Cuba Standard Time ----------------------------------------------------
-05:00 Cuba Standard Time CST CDT CU Havana
------- Central Standard Time -------------------------------------------------
-06:00 Canada Central Standard Time CST CDT CA Regina
-06:00 Central Standard Time CST CDT US Chicago
-06:00 Central Standard Time (Mexico) CST CDT MX Mexico City
------- Easter Island Standard ------------------------------------------------
-06:00 Easter Island Standard Time EST EDT CL Easter
------- Mountain Standard Time ------------------------------------------------
-07:00 Mountain Standard Time MST MDT US Denver
-07:00 Mountain Standard Time (Mexico) MST MDT MX Chihuahua
-07:00 US Mountain Standard Time MST MDT US Phoenix
------- Pacific Standard Time -------------------------------------------------
-08:00 Pacific Standard Time PST PDT US Los Angeles
-08:00 Pacific Standard Time (Mexico) PST PDT MX Tijuana
------- Alaska Standard Time --------------------------------------------------
-09:00 Alaskan Standard Time AKS AKD US Anchorage
------- Hawaii Standard Time --------------------------------------------------
-10:00 Aleutian Standard Time HST HDT US Aleutian
-10:00 Hawaiian Standard Time HST HDT US Honolulu
------- Samoa Standard Time ---------------------------------------------------
+13:00 Samoa Standard Time SST SDT US Samoa
------- New Zealand Standard Time ---------------------------------------------
+12:00 New Zealand Standard Time NZS NZD NZ Auckland
------- Guam Standard Time ----------------------------------------------------
+10:00 West Pacific Standard Time GST GDT GU Guam
------- Eastern Australian Standard -------------------------------------------
+10:00 AUS Eastern Standard Time EAS EAD AU Sydney
+10:00 E. Australia Standard Time EAS EAD AU Brisbane
+10:00 Tasmania Standard Time EAS EAD AU Hobart
------- Central Australian Standard -------------------------------------------
+09:30 AUS Central Standard Time CAS CAD AU Darwin
+09:30 Cen. Australia Standard Time CAS CAD AU Adelaide
------- Japan Standard Time ---------------------------------------------------
+09:00 Tokyo Standard Time JST JDT JP Tokyo
------- Korean Standard Time --------------------------------------------------
+09:00 Korea Standard Time KST KDT KR Seoul
+09:00 North Korea Standard Time KST KDT KP Pyongyang
------- China Coast Time ------------------------------------------------------
+08:00 China Standard Time CCT CDT CN Shanghai
+08:00 Taipei Standard Time CCT CDT TW Taipei
------- Hong Kong Time --------------------------------------------------------
+08:00 China Standard Time HKT HKS HK Hong Kong
------- Singapore Standard Time -----------------------------------------------
+08:00 Singapore Standard Time SST SDT SG Singapore
------- Western Australian Standard -------------------------------------------
+08:45 Aus Central W. Standard Time WAS WAD AU Eucla
+08:00 W. Australia Standard Time WAS WAD AU Perth
------- North Sumatra Time ----------------------------------------------------
+07:00 SE Asia Standard Time NST NDT ID Jakarta
------- Indian Standard Time --------------------------------------------------
+05:30 India Standard Time IST IDT IN Calcutta
------- Iran Standard Time ----------------------------------------------------
+03:30 Iran Standard Time IST IDT IR Tehran
------- Moscow Winter Time ----------------------------------------------------
+03:00 Belarus Standard Time MSK MSD BY Minsk
+03:00 Russian Standard Time MSK MSD RU Moscow
------- Eastern Europe Time ---------------------------------------------------
+02:00 E. Europe Standard Time EET EES MD Chisinau
+02:00 FLE Standard Time EET EES UA Kiev
+02:00 GTB Standard Time EET EES RO Bucharest
+02:00 Kaliningrad Standard Time EET EES RU Kaliningrad
------- Israel Standard Time --------------------------------------------------
+02:00 Israel Standard Time IST IDT IL Jerusalem
------- Central European Time -------------------------------------------------
+01:00 Central Europe Standard Time CET CES HU Budapest
+01:00 Central European Standard Time CET CES PL Warsaw
+01:00 Romance Standard Time CET CES FR Paris
+01:00 W. Europe Standard Time CET CES DE Berlin
------- West African Time -----------------------------------------------------
+01:00 Namibia Standard Time WAT WAS NA Windhoek
+01:00 W. Central Africa Standard Time WAT WAS NG Lagos
NOTE: MSDOS_(APPEND/COMSPEC/LASTDRIVE/TEMP/TZ) are not copied to the virtual
table, but MSDOS_PATH is copied to, because some software may refer it.
----- Recommended Configurations
Create C:\DOS and C:\TEMP folders.
Copy COMMAND.COM (I recommend the Windows 98's COMMAND.COM Version 7.10) and
other DOS command files (ex. MORE.COM) into C:\DOS folder.
Set the environment variables listed below on the host Windows:
MSDOS_COMSPEC = C:\DOS\COMMAND.COM
MSDOS_PATH = C:\DOS
MSDOS_TEMP = C:\TEMP
----- Convert Command File To 32bit Or 64bit Execution File
You can convert a 16bit command file to a single 32bit or 64bit execution file
by embeding a command file to the msdos.exe.
For exmaple, you can convert LIST.COM by this command:
> msdos -cLIST32.EXE LIST.COM
and you can simply run LIST32.EXE without msdos.exe.
NOTE: Please specify a target command file with its extension, and specify
a new execution file name other than "msdos.exe". If a new execution file name
is not specified (only "-c" is specified), it is "new_exec_file.exe".
Other options' value are also stored to a new execution file, for example:
> msdos -cCOMMAND32.EXE -v6.22 -x COMMAND.COM
When you run COMMAND32.EXE, it starts COMMAND.COM with the version 6.22 and
XMS/EMS option enabled.
The active code page can be also stored with '-p' option, for example:
> msdos -cSW1US32.EXE -p437 -s SW1US.EXE
> chcp 437
> msdos -cSW1US32.EXE -p -s SW1US.EXE
When you run SW1US32.EXE, it starts SW1US.EXE with the code page 437 and
serial I/O option enabled.
At the execution time, an embedded command file will be extracted with
the original command file name in the current directory.
But if the original command file exists, it will be extracted with
the temporary command file name not to overwrite the original command file.
The extracted command file will be removed when the execution is finished.
----- Binaries
This archive contains 12 executable binaries:
i86_x86 Emulates 8086 and supports both 32bit/64bit Windows
i86_x64 Emulates 8086 and supports only 64bit Windows
i286_x86 Emulates 80286 and supports both 32bit/64bit Windows
i286_x64 Emulates 80286 and supports only 64bit Windows
i386_x86 Emulates 80386 and supports both 32bit/64bit Windows
i386_x64 Emulates 80386 and supports only 64bit Windows
i486_x86 Emulates 80486 and supports both 32bit/64bit Windows
i486_x64 Emulates 80486 and supports only 64bit Window
pentium4_x86 Emulates Pentium4 and supports both 32bit/64bit Windows
pentium4_x64 Emulates Pentium4 and supports only 64bit Window
v30_x86 Emulates NEC V30 and supports both 32bit/64bit Windows
v30_x64 Emulates NEC V30 and supports only 64bit Windows
ia32_x86 Emulates IA32 and supports both 32bit/64bit Windows
ia32_x64 Emulates IA32 and supports only 64bit Windows
8086 binaries are much faster than 80286/80386/80486/Pentium4/IA32 binaries.
If you don't need the protected mode or new mnemonics added after 80286,
I recommend i86_x86 or i86_x64 binary.
NEC V30 binaries support 8080 emulation mode.
If you try CP/M-80 emulator using 8080 emulation mode, use these binaries.
IA32 binaries include Neko Project 21/W i386c core and support FPU/MMX/SSE/2/3.
These binaries will emulate the protected mode more correctly.
i386_x86, i486_x86, pentium4_x86, and ia32_x86 folders contain ntvdm.exe.
This is required to support VDD (virtal device driver).
Please place msdos.exe and ntvdm.exe together.
VC++ project files msdos.dsp/vcproj/vcxproj also contains the configurations
for 80186, Pentium/PRO/MMX/2/3, and Cyrix MediaGX.
You can build all binaries for several cpu models by running build6/9/15.bat.
(VC++ 6.0 with SP6. VC++ 2008 with SP1, or VC++ 2017 are required)
----- Internal Debugger
MS-DOS Player contains the internal debugger for developers, but it is
disabled on the binaries in the archive.
To enable the internal debugger, please remove the comment out of definition
"//#define USE_DEBUGGER" in common.h and build the binary.
MS-DOS Player opens the telnet port.
The port number is 23 in default, but if it is already used, 9000 or later.
When you start your telnet client and connect to MS-DOS Player,
the virtual cpu is suspended and you can start the debugger.
If you see the messsage "waiting until cpu is suspended...",
the internal DOS service is running, for example waiting your key inputs.
The virtual cpu will be suspended when exit the internal DOS service,
and you can start the debugger.
If Tera Term PRO, PuTTY, or Windows telnet client (telnet.exe) is installed,
it is automatically started and connected to MS-DOS Player.
When you use Tera Term PRO or PuTTY, I recommend to disable "Line at Time"
and enable "Character at Time".
NOTE: When you run 32bit version of MS-DOS Player on Windows x64,
MS-DOS Player will try to start 32bit version of telnet.exe in SysWOW64,
but it is not usually installed.
Please enter ? command to show the debugger commands.
They are very similar to DEBUG command, and some break point functions
(break at memory access (*), I/O port access, and interrupt) are added.
(*) break does not occur when DOS service/BIOS emulation codes access.
----- Supported Hardwares
This emulator provides a very simple IBM PC-like hardware emulation:
CPU 8086/286/386/486/Pentium4, RAM 1MB/16MB/32MB, LIM EMS 32MB (Hardware EMS),
PC BIOS, DMA Controller (dummy), Interrupt Controller, System Timer,
Parallel I/O (LPT1-3), Serial I/O (COM1-4), Real Time Clock + CMOS Memory,
MDA/CGA CRTC + Status Register, EGA/VGA Registers (dummy),
Keyboard Controller (A20 Line Mask, CPU Reset), and 2-Button Mouse
NOTE:
- Graphic/Sound hardwares are NOT implemented.
- DMA Controller is implemented, but FDC and HDC are not connected.
- EGA/VGA Registers are implemented, but they affects nothing to text screen.
- Parallel I/O is implemented and the output data is written to the file
"Year-Month-Day_Hour-Minute-Second.PRN" created in the TEMP directory.
- Serial I/O is implemented and can be connected to the host's COM ports.
----- Memory Map
000000H - Conventional Memory (704KB)
0B0000H - MDA Text Video RAM (32KB)
0B8000H - CGA Text Video RAM (32KB)
----------
0C0000H - Upper Memory Block (224KB)
--- Or ---
0C0000H - EMS Page Frame (64K)
0D0000H - Upper Memory Block (160KB)
----------
0F8000H - V-TEXT Shadow Buffer (32KB-64B)
0FFFC0H - Dummy BIOS/DOS/Driver Service Routines
0FFFF0H - CPU Boot Address
100000H - Upper Memory (15MB/31MB)
----- Supported System Calls
INT 08H PC BIOS - System Timer
INT 10H PC BIOS - Video
00H Set Video Mode
01H Set Text-Mode Cursor Shape
02H Set Cursor Position
03H Get Cursor Position And Size
05H Select Active Display Page
06H Scroll Up Window
07H Scroll Down Window
08H Read Character And Attribute At Cursor Position
09H Write Character And Attribute At Cursor Position
0AH Write Character Only At Cursor Position
0CH Write Graphics Pixel
0DH Read Graphics Pixel
0EH Teletype Output
0FH Get Current Video Mode
1000H Set Single Palette Register
1001H Set Overscan Register
1002H Set All Palette Registers and Overscan Register
1003H Toggle Intensity/Blinking Bit
1007H Get Individual Palette Register
1008H Read Overscan Register
1009H Read All Palette Registers and Overscan Register
1010H Set Individual DAC Register
1012H Set Block of DAC Registers
1015H Read Individual DAC Register
1017H Read Block of DAC Registers
1018H Set Pel Mask
1019H Read Pel Mask
1100H Load User-Specified Patterns
1101H Load ROM 8x14 Monochrome Patterns
1102H Load ROM 8x8 Dbl-Dot Patterns
1104H Load ROM 8x16 Character Set
1110H Load User-Specified Patterns
1111H Load ROM 8x14 Monochrome Patterns
1112H Load ROM 8x8 Dbl-Dot Patterns
1114H Load ROM 8x16 Character Set
1118H Set V-TEXT Vertically Long Mode
1130H Get Font Information
12H Alternate Function Select - Get EGA Info (BL=10H)
12H Alternate Function Select - Select Vertical Resolution (BL=30H)
130*H Write String
1310H Read Characters And Standard Attributes
1311H Read Characters And Extended Attributes
1312H Write Characters And Standard Attributes (???)
1313H Write Characters And Extended Attributes (???)
1320H Write Characters And Standard Attributes
1321H Write Characters And Extended Attributes
1A00H Get Display Combination Code
1BH Perform Gray-Scale Summing
5000H AX (Japanese AT) Video - Set Screen Country Code
5001H AX (Japanese AT) Video - Get Screen Country Code
8200H Get/Set Scroll Mode
8204H J-3100 (Toshiba) Video - Get/Set Cursor Mode
8300H Get Video RAM Address
85H J-3100 (Toshiba) Video - Read Attribute At Cursor Position
90H Get Physical Workstation Display Mode
91H Get Physical Workstation Adapter Type
EFH Get Video Adapter Type And Mode (*1)
F0H EGA Register Interface Library - Read One Register
F1H EGA Register Interface Library - Write One Register
F2H EGA Register Interface Library - Read Register Range
F3H EGA Register Interface Library - Write Register Range
F4H EGA Register Interface Library - Read Register Set
F5H EGA Register Interface Library - Write Register Set
FAH EGA Register Interface Library - Interrogate Driver
FEH Get Shadow Buffer
FFH Update Screen From Shadow Buffer
INT 11H PC BIOS - Get Equipment List
INT 12H PC BIOS - Get Memory Size
INT 13H PC BIOS - Disk I/O
00H Reset Disk System
01H Get Status Of Last Operation
02H Read Sectors Into Memory
03H Write Disk Sectors (*2)
04H Verify Disk Sectors
08H Get Drive Parameters
0AH Read Long Sectors
0BH Write Long Sectors
0DH Reset Hard Disks
10H Check If Drive Ready
15H Get Disk Type
INT 14H PC BIOS - Serial I/O
00H Initialize Port
01H Write Character To Port
02H Read Character From Port
03H Get Port Status
04H Extended Initialize
0500H Read Modem Control Register
0501H Write Modem Control Register
INT 15H PC BIOS
2300H Get CMOS Data
2301H Set CMOS Data
2400H Disable A20 Gate
2401H Enable A20 Gate
2402H Get A20 Gate Status
2403H A20 Support
49H Get BIOS Type
5000H Get Address Of "Read Font" Function
5001H Get Address Of "Write Font" Function
84H Joystick Support (*3)
86H Wait
87H Copy Extended Memory
88H Get Extended Memory Size
89H Switch To Protected Mode
8AH Get Big Memory Size
C0H Get Configuration
C200H Pointing Device BIOS Interface (PS) - Enable/Disable
C201H Pointing Device BIOS Interface (PS) - Reset
C202H Pointing Device BIOS Interface (PS) - Set Sampling Rate
C203H Pointing Device BIOS Interface (PS) - Set Resolution
C204H Pointing Device BIOS Interface (PS) - Get Type
C205H Pointing Device BIOS Interface (PS) - Initialize
C206H Pointing Device BIOS Interface (PS) - Extended Commands
C207H Pointing Device BIOS Interface (PS) - Set Device Handler Addr
C208H Pointing Device BIOS Interface (PS) - Write To Pointer Port
C209H Pointing Device BIOS Interface (PS) - Read From Pointer Port
C9H Get CPU Type And Mask Revision
CA00H Read CMOS Memory
CA01H Write CMOS Memory
E801H Get Memory Size For >64M Configurations
E820H Get System Memory MAP
E881H Get Memory Size For >64M Configurations
INT 16H PC BIOS - Keyboard
00H Get Keystroke
01H Check For Keystroke
02H Get Shift Flags
05H Store Keystroke In Keyboard Buffer
09H Get Keyboard Functionality
0AH Get Keyboard ID
10H Get Enhanced Keystroke
11H Check For Enhanced Keystroke
12H Get Extended Shift States
1300H DOS/V Keyboard - Set Double-Byte Character Set Shift Control
1301H DOS/V Keyboard - Get Double-Byte Character Set Shift Control
5000H AX (Japanese AT) Keyboard - Set Keyboard Country Code
5001H AX (Japanese AT) Keyboard - Get Keyboard Country Code
51H AX (Japanese AT) Keyboard - Read Shift Key Status
F0H J-3100 (Toshiba) Keyboard - Beep
F1H J-3100 (Toshiba) Keyboard - Set Shift Key Status
F5H J-3100 (Toshiba) Keyboard - Store Keystroke In Keyboard Buffer
F6H J-3100 (Toshiba) Keyboard - Check Keyboard Buffer
INT 17H PC BIOS - Printer
00H Write Character
01H Initialize Port
02H Get Status
03H AX (Japanese AT) Printer - Output String Without Conversion
5000H AX (Japanese AT) Printer - Set Printer Country Code
5001H AX (Japanese AT) Printer - Get Printer Country Code
51H AX (Japanese AT) Printer - JIS To Shift-JIS Conversion
52H AX (Japanese AT) Printer - Shift-JIS To JIS Conversion
84H AX (Japanese AT) Printer - Output Character Without Conversion
85H AX (Japanese AT) Printer - Enable/Disable Character Conversion
INT 1AH PC BIOS - Timer
1A00H Get System Timer
1A02H Get Real Time Clock Time
1A04H Get Real Time Clock Date
1A0AH Read System-Timer Day Counter
INT 20H Program Terminate
INT 21H MS-DOS System Call
00H Program Terminate
01H Keyboard Input
02H Console Output
03H (Auxiliary Input)
04H (Auxiliary Output)
05H (Printer Output)
06H Direct Console I/O
07H Direct Console Input
08H Console Input Without Echo
09H Print String
0AH Buffered Keyboard Input
0BH Check Console Status
0CH Character Input With Buffer Flush
0DH Disk Reset
0EH Select Disk
0FH Open File With FCB
10H Close File With FCB
11H Search First Entry With FCB
12H Search Next Entry With FCB
13H Delete File With FCB
14H Sequential Read With FCB
15H Sequential Write With FCB
16H Create New File With FCB
17H Rename File With FCB
18H Null Function For CP/M Compatibility
19H Current Disk
1AH Set Disk Transfer Address
1BH Get Allocation Information For Default Drive
1CH Get Allocation Information For Specified Drive
1DH Null Function For CP/M Compatibility
1EH Null Function For CP/M Compatibility
1FH Get Drive Parameter Block For Default Drive
20H Null Function For CP/M Compatibility
21H Random Read With FCB
22H Randome Write With FCB
23H Get File Size With FCB
24H Set Relative Record Field With FCB
25H Set Vector
26H Create New Program Segment Prefix
27H Random Block Read With FCB
28H Random Block Write With FCB
29H Parse File Name
2AH Get Date
2BH Set Date
2CH Get Time
2DH Set Time
2EH Set/Reset Verify Switch
2FH Get Disk Transfer Address
30H Get Version Number (*4)
31H Keep Process
32H Get DOS Drive Parameter Block
3300H Get Ctrl-Break Checking State
3301H Set Ctrl-Break Checking State
3302H Get/Set Ctrl-Break Checking State
3305H Get Boot Drive
3306H Get True Version Number (*5)
3307H Windows95 - Set/Clear DOS_FLAG
33FAH FreeDOS - Get CPU Family
33FCH FreeDOS - Set DOS Version Number To Return
34H Get Address Of InDOS Flag
35H Get Vector
36H Get Disk Free Space
3700H Get Switch Character
3701H Set Switch Character
3702H Get AvailDev Flag
3703H Set AvailDev Flag
38H Get Country Specific Information
39H Create Subdirectory
3AH Remove Subdirectory
3BH Change Current Directory
3CH Create File
3DH Open File Handle
3EH Close File Handle
3FH Read From File Or Device
40H Write To File Or Device
41H Erase File From Directory
42H Move File Read/Write Pointer
4300H Get File Attribute
4301H Set File Attribute
4302H MS-DOS 7 - Get Compressed File Size
43FFH Windows98 - Extended-Length File Name Operations
4400H Get Device Information
4401H Set Device Information
4402H Read From Character Device Control Channel
4406H Get Input Status
4407H Get Output Status
4408H Device Removable Query
4409H Device Local Or Remote Query
440AH Handle Local Or Remote Query
440CH Generic Character Device Request
440DH Generic Block Device Request
4410H Query Generic IOCTRL Capability (Handle)
4411H Query Generic IOCTRL Capability (Drive)
45H Duplicate File Handle
46H Force Duplicate Of Handle
47H Get Current Directory
48H Allocate Memory
49H Free Allocated Memory
4AH Modify Allocated Memory Blocks
4B00H Load And Execute Program
4B01H Load Program
4B03H Load Overlay
4CH Terminate Process
4DH Get Subprocess Return Code
4EH Find First Matching File
4FH Find Next Matching File
50H Set Program Segment Prefix Address
51H Get Program Segment Prefix Address
52H Get DOS Info Table
53H Translate BIOS Parameter Block To Drive Param Bock
54H Get Verify State
55H Create Child Program Segment Prefix
56H Rename File
5700H Get Last Written Date And Time
5701H Set Last Written Date And Time
5704H Windows95 - Get Last Access Date And Time
5705H Windows95 - Set Last Access Date And Time
5706H Windows95 - Get Creation Date And Time
5707H Windows95 - Set Creation Date And Time
5800H Get Memory Allocation Strategy
5801H Set Memory Allocation Strategy
5802H Get UMB Link State
5803H Set UMB Link State
59H Get Extended Error Information
5AH Create Unique File
5BH Create New File
5CH Lock/Unlock File Access
5D00H Server Function Call
5D06H Get Address Of DOS Swappable Data Area
5D0AH Set Extended Error Information
5E00H Get Machine Name
5F02H Get Redirection List Entry
5F05H Get Extended Redirection List Entry
5F07H Enable Drive
5F08H Disable Drive
60H Canonicalize Filename Or Path
61H Reserved Fnction
62H Get Program Segment Prefix Address
6300H Get DBCS Vector
6301H Set Interim Console Flag
6302H Get Interim Console Flag
6500H Windows95 OSR2 - Set General Internationalization Info
6501H Get General Internationalization Info
6502H Get Upper Case Table
6503H Get Lower Case Table
6504H Get File Name Upper Case Table
6505H Get File Name Lower Case Table
6506H Get Collating Sequence Table
6507H Get DBCS Vector
6520H Character Capitalization
6521H String Capitalization
6522H ASCIIZ Capitalization
6523H Determine If Character Represents Yes/No Response
65A0H Character Capitalization
65A1H String Capitalization
65A2H ASCIIZ Capitalization
65A3H Determine If Character Represents Yes/No Response
6601H Get Global Code Page Table
6602H Set Global Code Page Table
67H Set Handle Count
68H Commit File
6900H Get Disk Serial Number
6AH Commit File
6BH Null Function
6CH Extended Open/Create
7002H Windows95 - Set General Internationalization Info
710DH Windows95 - Reset Drive
7139H Windows95 - LFN - Create Subdirectory
713AH Windows95 - LFN - Remove Subdirectory
713BH Windows95 - LFN - Change Current Directory
7141H Windows95 - LFN - Erase File From Directory
7143H Windows95 - LFN - Get/Set File Attribute
7147H Windows95 - LFN - Get Current Directory
714EH Windows95 - LFN - Find First Matching File
714FH Windows95 - LFN - Find Next Matching File
7156H Windows95 - LFN - Rename File
7160H Windows95 - LFN - Canonicalize Filename Or Path
716CH Windows95 - LFN - Extended Open/Create
71A0H Windows95 - LFN - Get Volume Information
71A1H Windows95 - LFN - Terminate Directory Search
71A6H Windows95 - LFN - Get File Information By Handle
71A7H Windows95 - LFN - Convert File Time/DOS Time
71A8H Windows95 - LFN - Generate Short File Name
71A9H Windows95 - LFN - Extended Server Open/Create
71AAH Windows95 - LFN - Create/Terminate/Query SUBST
7300H Windows95 - FAT32 - Get Drive Locking
7302H Windows95 - FAT32 - Get Extended DPB
7303H Windows95 - FAT32 - Get Extended Free Space On Drive
DBH Novell NetWare - Workstation - Get Number Of Local Drives
DCH Novell NetWare - Connection Services - Get Connection Number
INT 23H Ctrl-Break Address
INT 24H Critical Error Handler
INT 25H Absolute Disk Read
INT 26H Absolute Disk Write (*2)
INT 27H Terminate And Stay Resident
INT 28H DOS Idle
INT 29H DOS Fast Character I/O
INT 2EH Pass Command To Command Interpreter For Execution
INT 2FH Multiplex Interrupt
0500H DOS 3.0+ Critical Error Handler - Installation Check
05xxH DOS 3.0+ Critical Error Handler - Expand Error Into String
1200H DOS 3.0+ internal - Installation Check
1202H DOS 3.0+ internal - Get Interrupt Address
1203H DOS 3.0+ Internal - Get DOS Data Segment
1204H DOS 3.0+ internal - Normalize Path Separator
1205H DOS 3.0+ internal - Output Character To Standard Output
120DH DOS 3.0+ internal - Get Date And Time
1211H DOS 3.0+ internal - Normalize ASCIZ Filename
1212H DOS 3.0+ internal - Get Length Of ASCIZ String
1213H DOS 3.0+ internal - Uppercase Character
1214H DOS 3.0+ internal - Compare Far Pointers
1216H DOS 3.0+ internal - Get System File Table Entry
1217H DOS 3.0+ internal - Get Current Directory Structure For Drive
121AH DOS 3.0+ internal - Get File's Drive
121BH DOS 3.0+ internal - Set Year/Length Of February
121EH DOS 3.0+ internal - Compare Filenames
121FH DOS 3.0+ internal - Build Current Directory Structure
1220H DOS 3.0+ internal - Get Job File Table Entry
1221H DOS 3.0+ internal - Canonicalize File Name
1222H DOS 3.0+ internal - Set Extended Error Info
1225H DOS 3.0+ internal - Get Length Of ASCIZ String
1226H DOS 3.3+ internal - Open File
1227H DOS 3.3+ internal - Close File
1228H DOS 3.3+ internal - Move File Pointer
1229H DOS 3.3+ internal - Read From File
122BH DOS 3.3+ internal - IOCTL
122CH DOS 3.3+ internal - Get Device Chain
122DH DOS 3.3+ internal - Get Extended Error Code
122EH DOS 4.0+ internal - Get/Set Error Table Addresses
122FH DOS 4.0+ internal - Set DOS Version Number To Return
1400H NLSFUNC.COM - Installation Check
1401H NLSFUNC.COM - Change Code Page
1402H NLSFUNC.COM - Get Extended Country Info
1403H NLSFUNC.COM - Set Code Page
1404H NLSFUNC.COM - Get Country Info
150BH CD-ROM v2.00+ - Drive Check
150DH CD-ROM v2.00+ - Get CD-ROM Drive Letters
1600H Windows - Windows Enhanced Mode Installation Check (*6)
1605H Windows - Windows Enhanced Mode & 286 DOSX Init Broadcast
160AH Windows - Identify Windows Version And Type (*6)
1680H Windows, DPMI - Release Current Virtual Machine Time-Slice
1683H Windows 3+ - Get Current Virtual Machine ID
1689H Windows 3+ - Kernel Idle Call
1700H MS Windows "WINOLDAP" - Identify WinOldAp Version
1701H MS Windows "WINOLDAP" - Open Clipboard
1702H MS Windows "WINOLDAP" - Empty Clipboard
1703H MS Windows "WINOLDAP" - Set Clipboard Data
1704H MS Windows "WINOLDAP" - Get Clipboard Data Size
1705H MS Windows "WINOLDAP" - Get Clipboard Data
1708H MS Windows "WINOLDAP" - Close Clipboard
1709H MS Windows "WINOLDAP" - Compact Clipboard
1A00H ANSI.SYS - Installation Check
1A01H ANSI.SYS - Set/Get Display Information
4000H Windows 3+ - Get Virtual Device Driver (VDD) Capabilities
4300H XMS - Installation Check
4308H HIMEM.SYS - Get A20 Handler Number
4310H XMS - Get Driver Address
4A01H DOS 5.0+ - Query Free HMA Space
4A02H DOS 5.0+ - Allocate HMA Space
4A03H Windows95 - (De)Allocate HMA Memory Block
4A04H Windows95 - Get Start Of HMA Memory Chain
AD00H DISPLAY.SYS - Installation Check
AD01H DISPLAY.SYS - Set Active Code Page
AD02H DISPLAY.SYS - Get Active Code Page
AD03H DISPLAY.SYS - Get Code Page Information
4F00H BILING - Get Version
4F01H BILING - Get Code Page
AE00H Installable Command - Installation Check
AE01H Installable Command - Execute
INT 33H Mouse
0000H Reset Driver And Rest Status
0001H Show Mouse Cursor
0002H Hide Mouse Cursor
0003H Return Position And Button Status
0004H Position Mouse Cursor
0005H Return Button Press Data
0006H Return Button Release Data
0007H Define Horizontal Cursor Range
0008H Define Vertical Cursor Range
0009H Define Graphics Cursor
000AH Define Text Cursor
000BH Read Motion Counters
000CH Define Interrupt Sub Routine Parameters
000FH Define Mickey/Pixel Ratio
0011H Get Number Of Buttons
0014H Exchange Interrupt Sub Routines
0015H Return Driver Storage Requirements
0016H Save Driver State
0017H Restore Driver State
0018H Set Alternate Mouse User Handler
0019H Return User Alternate Interrupt Vector
001AH Set Mouse Sensitivity
001BH Return Mouse Sensitivity
001DH Define Display Page Number
001EH Return Display Page Number
001FH Disable Mouse Driver
0020H Enable Mouse Driver
0021H Software Reset
0022H Set Language For Messages
0023H Get Language For Messages
0024H Get Software Version, Moouse Type, And IRQ Number (*7)
0025H Get General Driver Information
0026H Get Maximum Virtual Coordinates
0027H Get Screen/Cursor Masks And Mickey Counts
0028H Set Video Mode
0029H Enumerate Video Modes
002AH Get Cursor Host Spot
0031H Get Current Minimum/Maximum Virtual Coordinates
0032H Get Active Advanced Functions
004DH Return Pointer To Copyright String
006DH Get Version String
INT 64H-66H (Used For Dummy LIM EMS/XMS Service Routines)
INT 67H LIM EMS
40H LIM EMS - Get Manager Status
41H LIM EMS - Get Page Frame Segment
42H LIM EMS - Get Number Of Pages
43H LIM EMS - Get Handle And Allocate Memory
44H LIM EMS - Map/Unmap Memory