yaze(1) Local commands yaze(1) NAME yaze-ag - yet another z80 emulator by ag SYNOPSIS yaze [-1] [-v] [-bbootfile] [-lloadadr] [-pbasepage] [-sstartup] [-zZ3ENV] command... cpm ... z80 ... DESCRIPTION yaze-ag is designed to provide an exact simulation of the Z80 microprocessor on a Unix system. In addition to the instruction-set emulator, a CP/M basic i/o system is pro− vided that can reference Unix directories and Unix files containing images of CP/M disks. When a genuine CP/M operating system (ccp + bdos) or a clone system is loaded into the emulator, a complete CP/M system is available, running on a Unix host. yaze-ag-2.10 is a further development of yaze-1.10. New in yaze-ag is the emulated Memory Management Unit (MMU) and the BIOS which supports CP/M 3.1 or ZPM3 which is used in yaze-ag. You can still run CP/M 2.2 or SuperDos (a CP/M 2.2 replacement) in yaze-ag if you want. yaze is a shell script. It is used to start yaze-ag. It tests firstly if the startup file .yazerc is in the direc− tory of `pwd`. If there is one it starts at once yaze_bin the binary of the Z80 emulator. If no .yazerc exists it tests if the directory $HOME/cpm exists. If not it creates $HOME/cpm. Then it copies some yaze-disks into $HOME/cpm which are necessary for running yaze-ag with CP/M 3.1 respectively ZPM3. Then it creates $HOME/cpm/doc and sets links in that directory to the com− plete documentation. This will be done only if no $HOME/cpm directory exists. At last it changes to $HOME/cpm and starts yaze_bin. This will be done every time you starts the shell script yaze and if there is no .yazerc in the `pwd`. yaze-ag can also be started with z80 or cpm. They are links to the shell script yaze. The complete documentation is contained in the file yaze.doc and the new features of yaze-ag-2.01 describes the file yaze-ag.doc (see $HOME/cpm/doc). OPTIONS -1 set sector size to 128 bytes for all disks (only CP/M 3.1). If you create a disk file under the yaze-ag monitor or with the cdm(1) utility and you use the default sectors per track (see create) the sektor size is also set to 2048 bytes (only CP/M 3.1). If you use software like a disk edit utility under CP/M 3.1 it can be necessary to set the sektor size to 128 bytes. See also the monitor command 128 above in the sec− tion MONITOR COMMANDS. -v causes a summary of the system configuration to be displayed after loading. -b gives the name of a file to be loaded into the emu− lated processor's ram before the emulation is started. The file is loaded at the address given by the -l option, if one is present, or else at the basepage (see -p). If a bootfile is not specified with the -b option, yaze-ag looks for the file yaze-cpm3.boot in the current directory first, then in /usr/local/lib/yaze to boot CP/M 3.1. If yaze− ag is compiled without the flag -DBOOTSYS yaze-ag looks for the file yaze.boot (instead of yaze− cpm3.boot) to boot the CP/M 2.2 replacement Super− Dos. -l the hexadecimal address at which to load and start the bootstrap file, if a separate bootstrap is nec− essary. If you want to run CP/M 2.2 while yaze-ag is com− piled to load yaze-cpm3.boot (CP/M 3.1) you can start yaze-ag with the options yaze -l -1 -b yaze.boot -p the top 2 hex digits of the location of the CP/M console command processor (CP/M 2.2). Also the location to which bootfile is loaded if a -l option is not present. -s a file containing monitor commands that are to be executed before starting the emulator. If no -s option is present, .yazerc from the current direc− tory or from the user's home directory is taken. -z the hexadecimal address in the emulated processor's ram of a 1KByte area that should be reserved for use by an extended CP/M clone such as ZCPR3. MONITOR COMMANDS When the emulator is started it executes commands first from the startup file, then from the tail of the command line (any strings which follow the options) and then from the tty if neither the startup file nor the command line included a "go" command. Control can be returned to the monitor by executing the CP/M sys.com command or, if yaze was compiled with -DDEBUG, by sending it a SIGINT signal. Command names can be shortened to a unique abbreviation. If yaze-ag was compiled with GNU Readline, command-line editing, filename completion and history recall are avail− able - see the readline documentation. The monitor commands are described in more detail in the file yaze.doc. The command '128' is described in yaze-ag.doc. help Display a command list help cmd Give details about cmd attach Attach CP/M device to a Unix file detach Detach CP/M device from file setaccess Turns on/off access time stamps for mounted directories mount Mount a Unix file or directory as a CP/M disk remount Remount a CP/M disk umount Unmount a CP/M disk create Create a new disk 128 Set sektor size to 128 for all disks (only CP/M 3.1). To reverse this option you have to restart yaze-ag. interrupt Set user interrupt key go Start/Continue CP/M execution ! Execute a Unix command quit Terminate yaze time Display elapsed time since last `time' command SUPPORTED OPERATING SYSTEMS Yaze-ag-2.01 can be compiled under all unix or unix-like operating systems. yaze-ag-2.01 are tested with: Solaris gcc 3.3.x Linux gcc 3.3 FreeBSD gcc ? MacOS-X gcc ? Cygwin gcc 3.3.1 (have a look to www.cygwin.com) Cygwin is a unix-like environment for windows SOURCE AND BINARIES You find the source (for all systems) and the binaries for windows (if you don't want to install the cygwin environ ment) under http://www.mathematik.uni-ulm.de/users/ag/yaze-ag/ or ftp://ag-yaze:yaze@xylopia-upload.mathematik.uni-ulm.de/ SEE ALSO cdm(1) AUTHORS Andreas Gerlich Frank D. Cringle only text emails please:(SPAM-Account) AGL's & Frank's Hacks 14 April 2004 yaze(1)