X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=readme.html;h=d0fc77a17edea8d71805448872a7399b90ac2875;hb=HEAD;hp=5c409b5f5a0a55c59c9ff768dba4bfc9a839f2a4;hpb=c3bc906f7d60243f75827be30c0dbb5d2801a622;p=minsk.git diff --git a/readme.html b/readme.html index 5c409b5..d0fc77a 100644 --- a/readme.html +++ b/readme.html @@ -3,22 +3,24 @@
(see it in action)
This is an emulator of ÐинÑк-2 (Minsk-2) – a mainframe computer from -the Soviet era, produced around 1963 in the Byelorussian SSR. +
This is an emulator of the ÐинÑк-2 (Minsk-2) and ÐинÑк-22 (Minsk-22) – +mainframe computers from the Soviet era, produced around 1963 and 1965 respectively, +in the Byelorussian SSR. -
We have written the emulator for a task in the Po drátÄ -hacking contest (sorry, the page is in Czech only). The participants were to -find a password hidden in the machine's memory, which involved figuring out how -the machine works and reconstructing at least a part of its instruction set. +
The Minsk-2 emulator was originally written for a task in the +Po drátÄ hacking contest (sorry, the page is in +Czech only). The participants were to find a password hidden in the machine's memory, +which involved figuring out how the machine works and reconstructing at least a part +of its instruction set. You can try your luck, the password is still there. -
Online resources about this machine are rather scarce. English Wikipedia contains +
Online resources about these machines are rather scarce. English Wikipedia contains a fairly short article on the Minsk family of computers, Russian Wikipedia reveals a couple of technical details on Minsk-22, @@ -38,10 +40,10 @@ control panel instead.)
We have tried to get as close to the behavior of the real machine as we could, +
We have tried to get as close to the behavior of the real machines as we could, but the description in the Salikov's book is not as detailed as we would wish, so several things remained to be guessed. Here is a list of likely differences -against the real Minsk-2: +against the real Minsk-2/Minsk-22:
The emulator has been written by Martin Mareš +
The Minsk-2 emulator has been written by Martin Mareš in 2010 and it is copyrighted by its author. +
Minsk-22 emulation and some other changes were added by +Rutger van Bergen in +2021/2022. +
The program is free software. You can freely use it and distribute it under the terms of the GNU General Public License version 2. @@ -102,7 +108,29 @@ the real Minsk), please contact the author by e-mail at source code of the emulator. -
It has been developed on Linux with GCC and it should run on all POSIX systems, -possibly requiring trivial modifications. +
The emulator has been developed on Linux with GCC and it should build and run on all POSIX systems, +possibly requiring trivial modifications. + +
On a system with the GNU toolchain installed, the emulator can be built by running the following +command: +
+$ make ++ +
The emulator reads its input from stdin. Loading and executing the ex-hello example program +would therefore be done like this: +
+$ ./minsk < ex-hello ++ +
The list of supported options can be acquired by running the emulator with any +unsupported option: +
+$ ./minsk -h +