1Xhomer README 2------------- 3 4License 5------- 6Please read the file LICENSE, in this directory, for details. 7 8 9Using Xhomer 10------------ 11These are very basic instructions, for building, running and 12exiting the Xhomer DEC Pro 350 emulator. For more detailed 13documentation, please see DOC/index.html. Also, up-to-date 14documentation and source code can be obtained from: 15 16 http://xhomer.isani.org/ 17 18 19Building Xhomer 20--------------- 21Xhomer has been developed and tested on a Linux x86/GNU/X-windows 22system. It is written in C, and will likely build on other 23Unix systems, but the Makefile might require some tweaks. It 24is assumed that the version of make in use is Gnu make (gmake) 25and that gcc will be used for compilation. 26 27From the directory in which this README resides: 28 291. Run "make clean" 30 312. Run "make" 32 33 This should produce a dynamically-linked executable named 34 "xhomer," in the current directory. 35 363. (OPTIONAL) If you would like a statically-linked executable, 37 38 run "make xhomer.static" 39 40 This will produce a binary named xhomer.static 41 42 43Running Xhomer 44-------------- 451. Obtain a Pro hard disk image file (pos32.rd or venix2.rd, for 46 example). 47 482. Modify the Xhomer configuration file (xhomer.cfg), if necessary, 49 to point to the hard disk image (using the "rd_dir" and "rd0" 50 variables). xhomer.cfg must exist in the directory Xhomer is 51 run from. Alternatively, the file can be copied to ~/.xhomerrc. 52 If ~/.xhomerrc exists, it will be used instead of xhomer.cfg. 53 The provided configuration file contains documentation for all 54 of its options. Make sure they are set appropriately. 55 563. Run "xhomer" 57 58 The operating system present on the disk image file should now 59 boot. 60 61 62Exiting Xhomer 63-------------- 641. While the Xhomer window has focus, press ctrl-F1. 65 662. The emulator control menu should now be visible. Select 67 the "Shutdown emulator" option with the up/down arrow keys, and 68 press enter. 69