From 212a499c000c58582d24698b4da2f934a92cc4ab Mon Sep 17 00:00:00 2001 From: Mark Pizzolato Date: Sun, 4 Jun 2017 09:39:19 -0700 Subject: [PATCH] Visual Studio Projects: Update project documentation. --- Visual Studio Projects/0ReadMe_Projects.txt | 42 +++++++++++++++++---- 1 file changed, 34 insertions(+), 8 deletions(-) diff --git a/Visual Studio Projects/0ReadMe_Projects.txt b/Visual Studio Projects/0ReadMe_Projects.txt index 34536e91..f349b7b6 100644 --- a/Visual Studio Projects/0ReadMe_Projects.txt +++ b/Visual Studio Projects/0ReadMe_Projects.txt @@ -11,20 +11,46 @@ to the simh directory. For Example, the directory structure should look like: - .../simh/simhv38-2-rc1/VAX/vax_cpu.c - .../simh/simhv38-2-rc1/scp.c - .../simh/simhv38-2-rc1/Visual Studio Projects/simh.sln - .../simh/simhv38-2-rc1/Visual Studio Projects/VAX.vcproj - .../simh/simhv38-2-rc1/BIN/Nt/Win32-Release/vax.exe + .../simh/sim-master/VAX/vax_cpu.c + .../simh/sim-master/scp.c + .../simh/sim-master/Visual Studio Projects/simh.sln + .../simh/sim-master/Visual Studio Projects/VAX.vcproj + .../simh/sim-master/BIN/Nt/Win32-Release/vax.exe .../simh/windows-build/pthreads/pthread.h .../simh/windows-build/winpcap/WpdPack/Include/pcap.h + .../simh/windows-build/libSDL/SDL2-2.0.3/include/SDL.h The contents of the windows-build directory can be downloaded from: - https://github.com/downloads/markpizz/simh/windows-build.zip + https://github.com/simh/windows-build/archive/windows-build.zip +Download and extract the contents of this zip file into the appropriate +place in your directory structure. You do not need to do anything else +but have this directory properly located. Network devices are capable of using pthreads to enhance their performance. -To realize these benefits, you must build the desired simulator with +To realize these benefits, you must build the desire simulator with USE_READER_THREAD defined. The relevant simulators which have network -support are VAX, VAX780 and PDP11. +support are all of the VAX simulators and the PDP11 simulator. + +Additionally, simulators which contain devices which use the asynchronous +APIs in sim_disk.c and sim_tape.c can also achieve greater performance by +leveraging pthreads to perform blocking I/O in separate threads. Currently +the simulators which have such devices are all of the VAX simulators and +the PDP11. To achieve these benefits the simulators must be built with +SIM_ASYNCH_IO defined. + +The project files in this directory build these simulators with support for +both network and asynchronous I/O. + +To build any of the supported simulators you should open the simh.sln file +in this directory. + +The installer for Visual Studio 2008 SP1 is available from: + +http://download.microsoft.com/download/E/8/E/E8EEB394-7F42-4963-A2D8-29559B738298/VS2008ExpressWithSP1ENUX1504728.iso + +If you are using a version of Visual Studio beyond Visual Studio 2008, then +your later version of Visual Studio will automatically convert the Visual +Studio 2008 project files. You should ignore any warnings produced by the +conversion process.