NTVCM(1)

NAME
ntcvm - Run i8080/Z80 .COM executables in CP/M 2.2 emulation

SYNOPSIS
ntcvm [-bcCdiklnptV8] [-f keystrokes] [-s clockspeed] [-v 5|k] [-z mask] [file ...]

DESCRIPTION
ntcvm emulates CP/M 2.2 and the i8080/Z80 on Linux, MacOS, Windows, and real-mode DOS to run .COM files.

Console input/output works for both BIOS and BDOS APIs.

Disk input/output works via the BDOS API. There is no attempt at emulating physical disks. Applications that use BDOS for disk I/O will work, while applications that use the BIOS, or assume things about disk layout, will not.

The following options are available:

-b  backspace/BS/0x08 key sends delete/DEL/0x7f, for use with Turbo Pascal.

-c  never auto-detect ESC characters and change to 80x24 mode

-C  always switch to 80x24 mode

-d  do not clear the display on exit when in 80x24 mode

-f:<file>
    specify an input file containing keystrokes

-i  trace 8080/Z80 instructions when tracing with -t

-k  translate Kaypro II extended characters into ASCII equivalents

-l  force CP/M filenames to be lowercase

-n  do not sleep for applications in tight BDOS 6 loops, for use with applications like nvbasic

-p  show performance information at app exit

-s:X
    specify clock speed in X Hz, defaults to 0 which is as fast as possible

-t  enable debug tracing to ntvcm.log

-V  display version and exit

-v:X
    translate escape sequences to VT-100 where X can be one of

    5   for vt-52 escape sequences, use e.g. with CalcStar
    k   for Kaypro II/Lear-Siegler ADM-3A escape sequences, use with strtrk
    z:X applies X as a hex mask to SetProcessAffinityMask, e.g.:

        11  2 performance cores on an i7-1280P, or random good cores on a 5950x

        3000
            2 efficiency cores on an i7-1280P

-8  use only i8080 instruction set, not the Z80 extensions

EXAMPLES
To assemble, load, and run test.asm:

ntcvm asm.com test

ntcvm load.com test

ntcvm test.com

To run test.com at 4MHz:

ntcvm -s:4000000 test

To run Star Trek in mbasic in 80x24 mode using i8080 emulation:

ntcvm -8 -C mbasic startrek.bas

AUTHORS
David Lee <davidly_lee@hotmail.com>

Man page by Hauke Fath <hauke@NetBSD.org>