mirror of
https://github.com/simh/simh.git
synced 2026-04-28 20:57:26 +00:00
Notes For V3.0-0
Because some key files have changed, V3.0 should be unzipped to a clean directory. 1. New Features in 3.0-0 1.1 SCP and Libraries - Added ASSIGN/DEASSIGN (logical name) commands. - Changed RESTORE to unconditionally detach files. - Added E11 and TPC format support to magtape library. - Fixed bug in SHOW CONNECTIONS. - Added USE_ADDR64 support 1.2 All magtapes - Magtapes support SIMH format, E11 format, and TPC format (read only). - SET <tape_unit> FORMAT=format sets the specified tape unit's format. - SHOW <tape_unit> FORMAT displays the specified tape unit's format. - Tape format can also be set as part of the ATTACH command, using the -F switch. 1.3 VAX - VAX can be compiled without USE_INT64. - If compiled with USE_INT64 and USE_ADDR64, RQ and TQ controllers support files > 2GB. - VAX ROM has speed control (SET ROM DELAY/NODELAY). 2. Bugs Fixed in 3.01-0 2.1 VAX - Fixed CVTfi bug: integer overflow not set if exponent out of range - Fixed EMODx bugs: o First and second operands reversed o Separated fraction received wrong exponent o Overflow calculation on separated integer incorrect o Fraction not set to zero if exponent out of range - Fixed interval timer and ROM access to pass power-up self-test even on very fast host processors (fixes from Mark Pizzolato). 2.2 1401 - Fixed mnemonic, instruction lengths, and reverse scan length check bug for MCS. - Fixed MCE bug, BS off by 1 if zero suppress. - Fixed chaining bug, D lost if return to SCP. - Fixed H branch, branch occurs after continue. - Added check for invalid 8 character MCW, LCA. - Fixed magtape load-mode end of record response. 2.3 Nova - Fixed DSK variable size interaction with restore. 2.4 PDP-1 - Fixed DT variable size interaction with restore. 2.5 PDP-11 - Fixed DT variable size interaction with restore. - Fixed bug in MMR1 update (found by Tim Stark). - Added XQ features and fixed bugs: o Corrected XQ interrupts on IE state transition (code by Tom Evans). o Added XQ interrupt clear on soft reset. o Removed XQ interrupt when setting XL or RL (multiple people). o Added SET/SHOW XQ STATS. o Added SHOW XQ FILTERS. o Added ability to split received packet into multiple buffers. o Added explicit runt and giant packet processing. 2.6 PDP-18B - Fixed DT, RF variable size interaction with restore. - Fixed MT bug in MTTR. 2.7 PDP-8 - Fixed DT, DF, RF, RX variable size interaction with restore. - Fixed MT bug in SKTR. 2.8 HP2100 - Fixed bug in DP (13210A controller only), DQ read status. - Fixed bug in DP, DQ seek complete. 2.9 GRI - Fixed bug in SC queue pointer management. 3. New Features in 3.0 vs prior releases N/A 4. Bugs Fixed in 3.0 vs prior releases N/A 5. General Notes WARNING: The RESTORE command has changed. RESTORE will now detach an attached file on a unit, if that unit did not have an attached file in the saved configuration. This is required to assure that the unit flags and the file state are consistent. WARNING: The compilation scheme for the PDP-10, PDP-11, and VAX has changed. Use one of the supplied build files, or read the documentation carefully, before compiling any of these simulators.
This commit is contained in:
Bob Supnik
committed by
Mark Pizzolato
Mark Pizzolato
parent
43385c9616
commit
4ffd3be790
@@ -2,6 +2,147 @@ This file contains information about the XQ/SIM_ETHER package.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
The XQ emulator is a host-independant software emulation of Digital's
|
||||
DELQA (M7516) and DEQNA (M7504) Q-bus ethernet cards for the SIMH emulator.
|
||||
|
||||
The XQ emulator uses the Sim_Ether module to execute host-specific ethernet
|
||||
packet reads and writes, since all operating systems talk to real ethernet
|
||||
cards/controllers differently. The host-dependant Sim_Ether module currently
|
||||
supports Windows, Linux, NetBSD, and OpenBSD.
|
||||
|
||||
Currently, the Sim_Ether module sets the selected ethernet card into
|
||||
promiscuous mode to gather all packets, then filters out the packets that it
|
||||
doesn't want. In Windows, packets having the same source MAC address as the
|
||||
controller are ignored for WinPCAP compatibility (see Windows notes below).
|
||||
|
||||
If your ethernet card is plugged into a switch, the promiscuous mode setting
|
||||
should not cause much of a problem, since the switch will still filter out
|
||||
most of the undesirable traffic. You will only see "excessive" traffic if you
|
||||
are on a direct or hub(repeater) segment.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Windows notes:
|
||||
1. The Windows-specific code uses the WinPCAP 3.0 package from
|
||||
http://winpcap.polito.it. This package for windows simulates the libpcap
|
||||
package that is freely available for unix systems.
|
||||
2. You must *install* the WinPCAP runtime package.
|
||||
3. The first time the WinPCAP driver is used, it will be dynamically loaded,
|
||||
and the user must be an Administrator on the machine to do so. If you need
|
||||
to run as an unprivileged user, you must set the service to autostart. See
|
||||
the WinPCAP documentation for details on the static load workaround.
|
||||
4. WinPCAP loops packet writes back into the read queue. This causes problems
|
||||
since the XQ controller is not expecting to read it's own packet. A fix
|
||||
to the packet read filter was added to reject packets from the current MAC,
|
||||
but this defeats DECNET's duplicate node number detection scheme. A more
|
||||
correct fix for WinPCAP will be explored as time allows.
|
||||
|
||||
Building on Windows:
|
||||
1. Install WinPCAP 3.0.
|
||||
2. Put the required .h files (bittypes,devioctl,ip6_misc,packet32,pcap,
|
||||
pcap-stdinc).h from the WinPCAP 3.0 developer's kit in the compiler's path
|
||||
3. Put the required .lib files (packet,wpcap).lib from the WinPCAP 3.0
|
||||
developer's kit in the linker's path
|
||||
4. If you're using Borland C++, use COFF2OMF to convert the .lib files into
|
||||
a format that can be used by the compiler.
|
||||
5. Define USE_NETWORK if you want the network functionality.
|
||||
6. Build it!
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Linux, NetBSD, and OpenBSD notes:
|
||||
1. You must run SIMH(scp) as root so that the ethernet card can be set into
|
||||
promiscuous mode by the driver. Alternative methods for avoiding the
|
||||
'run as root' requirement will be welcomed.
|
||||
|
||||
Building on Linux, NetBSD, and OpenBSD:
|
||||
1. Get/install the libpcap package for your unix version. http://rpmfind.net
|
||||
might be a useful site for finding the linux variants.
|
||||
2. Use Make USE_NETWORK=1 if you want the network functionality.
|
||||
3. Build it!
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
VAX simulator support:
|
||||
|
||||
An OpenVMS VAX v7.2 system with DECNET Phase IV, MultiNet 4.4a, and LAT 5.3 has
|
||||
been successfully run. Other testers have reported success booting NetBSD also.
|
||||
|
||||
|
||||
PDP11 simulator support:
|
||||
|
||||
An RT-11 v5.3 system with a freeware TCP/IP stack has been successfully run.
|
||||
Other testers have reported that RSX with DECNET and the NetBSD operating
|
||||
systems also work. RSTS/E v10.1 has preliminary support - RSTS/E boots and
|
||||
enables the XH (XQ) device - DECNET and LAT software have not been tested.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Things planned for future releases:
|
||||
1. PDP-11 bootstrap/bootrom
|
||||
2. Full MOP implementation
|
||||
3. DESQA support (if someone can get me the user manuals)
|
||||
4. DETQA support [DELQA-Turbo] (I have the manual)
|
||||
5. DEUNA/DELUA support
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Things which I need help with:
|
||||
1. Porting Sim_Ether packet driver to other host platforms, especially VMS.
|
||||
2. Information about Remote MOP processing
|
||||
3. VAX/PDP-11 hardware diagnotics image files and docs, to test XQ thoroughly.
|
||||
4. Feedback on operation with other VAX/PDP-11 OS's.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Please send all patches, questions, feedback, clarifications, and help to:
|
||||
dhittner AT northropgrumman DOT com
|
||||
|
||||
Thanks, and Enjoy!!
|
||||
Dave
|
||||
|
||||
|
||||
===============================================================================
|
||||
Change Log
|
||||
===============================================================================
|
||||
|
||||
05-Jun-03 Release:
|
||||
1. Added SET/SHOW XQ STATS
|
||||
2. Added SHOW XQ FILTERS
|
||||
3. Added ability to split received packet into multiple buffers
|
||||
4. Added explicit runt & giant packet processing
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
30-May-03 Release:
|
||||
1. Corrected bug in xq_setmac introduced in v3.0 (multiple people)
|
||||
2. Made XQ receive buffer allocation dynamic to reduce scp executable size
|
||||
3. Optimized some structs, removed legacy variables (Mark Pizzolato)
|
||||
4. Changed #ifdef WIN32 to _WIN32 for consistancy
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
06-May-03 Release:
|
||||
1. Added second XQ controller
|
||||
2. Added SIMH v3.0 compatibility
|
||||
3. Removed SET ADDRESS functionality
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
10-Apr-03 Release:
|
||||
1. Added preliminary support for RSTS/E
|
||||
2. Added PDP-11 bootrom load via CSR flags
|
||||
3. Support for SPARC linux (thanks to Mark Pizzolato)
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
11-Mar-03 Release:
|
||||
1. Added support for RT-11 TCP/IP
|
||||
2. Corrected interrupts (thanks to Tom Evans and Bob Supnik)
|
||||
3. Moved change log to the bottom of the readme file, cleaned up document
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
16-Jan-03 Release:
|
||||
1. Added VMScluster support (thanks to Mark Pizzolato)
|
||||
2. Verified VAX remote boot functionality (>>>B XQA0)
|
||||
@@ -12,176 +153,10 @@ This file contains information about the XQ/SIM_ETHER package.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
GOLD Changes: (08-Nov-02)
|
||||
08-Nov-02 Release:
|
||||
1. Added USE_NETWORK conditional to Sim_Ether
|
||||
2. Fixed behaviour of SHOW XQ ETH if no devices exist
|
||||
3. Added OpenBSD support to Sim_Ether (courtesy of Federico Schwindt)
|
||||
4. Added ethX detection simplification (from Megan Gentry)
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
BETA 5 Changes: (23-Oct-02)
|
||||
1. Added all_multicast and promiscuous mode support
|
||||
2. Finished DEQNA emulation
|
||||
3. Verified LAT functionality
|
||||
4. Added NXM (Non-eXistant Memory) protection (suggested by Robert Supnik)
|
||||
5. Added NetBSD support to Sim_Ether (courtesy of Jason Thorpe)
|
||||
6. Fixed write buffer overflow bug (discovered by Jason Thorpe)
|
||||
7. Fixed unattached device behavior (discovered by Patrick Caulfield)
|
||||
8. Extensive rewrite of this README
|
||||
9. Debugged sanity timer
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
BETA 4 Changes: (16-Oct-02)
|
||||
1. Added stub support for all_multicast and promiscuous modes
|
||||
2. Integrated with SIMH v2.10-0b1
|
||||
3. Added VAX network bootstrap support
|
||||
4. Added SET/SHOW XQ TYPE and SANITY commands
|
||||
5. Added stub support for DEQNA mode
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
BETA 3 Changes: (10-Oct-02)
|
||||
1. Fixed off-by-one bug in setup address processing
|
||||
2. Added rejection of multicast addresses to SET XQ MAC
|
||||
3. Added linux support to Sim_Ether (courtesy of Patrick Caulfield)
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
BETA 2 Changes: (08-Oct-02)
|
||||
1. Integrated with SIMH v2.10-0p4
|
||||
2. Added floating vectors; this also fixes pdp11 emulation problem
|
||||
3. Cleaned up codebase; 100% of packet driver code moved to Sim_Ether
|
||||
4. Verified TCP/IP functionality
|
||||
5. Added Copyrights
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
BETA 1 Changes: (03-Oct-02)
|
||||
1. Moved most of packet driver functionality from XQ to Sim_Ether
|
||||
2. Verified DECNET functionality
|
||||
3. Added SET/SHOW MAC command
|
||||
4. Added SHOW ETH command
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
The XQ emulator is a host-independant software emulation of Digital's
|
||||
DELQA (M7516) and DEQNA (M7504) Q-bus ethernet cards for the SIMH emulator.
|
||||
|
||||
See the last section of this document for XQ usage instructions.
|
||||
|
||||
The XQ emulator uses the Sim_Ether module to execute host-specific ethernet
|
||||
packet reads and writes, since all operating systems talk to real ethernet
|
||||
cards/controllers differently. The host-dependant Sim_Ether module currently
|
||||
supports Windows, Linux, and NetBSD.
|
||||
|
||||
Currently, the Sim_Ether module sets the selected ethernet card into
|
||||
promiscuous mode to gather all packets, then filters out the packets that it
|
||||
doesn't want. In Windows, Packets having the same source MAC address as the
|
||||
controller are ignored for WinPCAP compatibility (see Windows notes below).
|
||||
|
||||
If your ethernet card is plugged into a switch, the promiscuous mode setting
|
||||
should not cause much of a problem, since the switch will still filter out
|
||||
most of the undesirable traffic. You will only see "excessive" traffic if you
|
||||
are on a direct or hub(repeater) segment.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Windows notes:
|
||||
1. The Windows-specific code uses the WinPCAP 3.0 (or 2.3) package from
|
||||
http://winpcap.polito.it. This package for windows simulates the libpcap
|
||||
package that is freely available for unix systems.
|
||||
2. You must *install* WinPCAP.
|
||||
3. Note that WinPCAP DOES NOT support dual CPU environments.
|
||||
4. WinPCAP loops packet writes back into the read queue. This causes problems
|
||||
since the XQ controller is not expecting to read it's own packet. A fix
|
||||
to the packet read filter was added to reject packets from the current MAC,
|
||||
but this defeats DECNET's duplicate node number detection scheme. A more
|
||||
correct fix for WinPCAP will be explored as time allows.
|
||||
5. The first time the WinPCAP driver is used, it will be dynamically loaded,
|
||||
and the user must be an Administrator on the machine to do so. If you need
|
||||
to run as an unprivileged user, you must set the service to autostart. See
|
||||
the WinPCAP documentation for details on the static load workaround.
|
||||
|
||||
Building on Windows:
|
||||
1. Install WinPCAP 3.0.
|
||||
2. Get the required .h files (bittypes.h, devioctl.h, ip6_misc.h, packet32.h,
|
||||
pcap.h, pcap-stdinc.h) from the WinPCAP 3.0 developer's kit
|
||||
3. Get the required .lib files (packet.lib, wpcap.lib) from the WinPCAP 3.0
|
||||
developer's kit. If you're using Borland C++, use COFF2OMF to convert
|
||||
the .lib files into a format that can be used by the compiler.
|
||||
4. Define USE_NETWORK if you want the network functionality.
|
||||
5. Build it!
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Linux, NetBSD, and OpenBSD notes:
|
||||
|
||||
1. You must run SIMH(scp) as root so that the ethernet card can be set into
|
||||
promiscuous mode by the driver. Alternative suggestions will be welcomed.
|
||||
|
||||
Building on Linux, NetBSD, and OpenBSD:
|
||||
1. Define USE_NETWORK if you want the network functionality.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
THE XQ/SIM_ETHER modules have been successfully tested on a Windows 2000 host,
|
||||
emulating an OpenVMS 7.2 VAX system with DECNET Phase IV, MultiNet 4.4a, and
|
||||
LAT 5.3.
|
||||
|
||||
Regression test criteria:
|
||||
1. VAX shows device correctly (passed)
|
||||
2. VMS boots successfully with new device emulation (passed)
|
||||
3. VMS initializes device correctly (passed)
|
||||
4. DECNET loads successfully (passed)
|
||||
5. DECNET line stays up (passed)
|
||||
6. SET HOST x.y:: works from SIMH to real DECNET machine (passed)
|
||||
7. SET HOST x.y:: works from real DECNET machine to SIMH (passed)
|
||||
8. DECNET copy works from SIMH to real DECNET machine (passed)
|
||||
9. DECNET copy works from real DECNET machine to SIMH (passed)
|
||||
10. MultiNet TCP/IP loads successfully (passed)
|
||||
11. Multinet TCP/IP initializes device successfully (passed)
|
||||
12. SET HOST/TELNET x.y.z.w works from SIMH to real VAX IP machine (passed)
|
||||
13. SET HOST/TELNET x.y.z.w works from real VAX IP machine to SIMH (passed)
|
||||
14. FTP GET from a real VAX IP machine (passed)
|
||||
15. LAT loads sucessfully (passed)
|
||||
16. SET HOST/LAT <nodename> works from SIMH to real VAX LAT machine (passed)
|
||||
17. SET HOST/LAT <nodename> works from real VAX LAT machine to SIMH (passed)
|
||||
18. SIMH node joins VMSCluster (passed)
|
||||
19. SIMH node mounts other VMSCluster disks (passed)
|
||||
20. SIMH node MSCP serves disks to other nodes (passed)
|
||||
21. SIMH node remote boots into VMScluster (>>>B XQAO) (passed)
|
||||
|
||||
The following are known to NOT work:
|
||||
1. PDP-11 using RSTS/E v10.1 (fails to enable device - needs bootrom support)
|
||||
|
||||
I have reports that the following work:
|
||||
1. PDP-11 using RSX
|
||||
2. VAX remote booting of NetBSD (via >>> B XQA0)
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Things planned for future releases:
|
||||
1. Full MOP implementation
|
||||
2. PDP-11 bootstrap/bootrom
|
||||
3. DESQA support (if someone can get me the user manuals)
|
||||
4. DETQA support [DELQA-Turbo] (I have the manual)
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Things which I need help with:
|
||||
1. Porting Sim_Ether packet driver to other platforms, especially VMS.
|
||||
2. Information about Remote MOP processing
|
||||
3. PDP-11 bootstrap code.
|
||||
4. VAX hardware diagnotics image file and docs, to test XQ thoroughly.
|
||||
5. Feedback on operation with other VAX OS's.
|
||||
6. Feedback on operation with PDP-11 OS's.
|
||||
|
||||
-------------------------------------------------------------------------------
|
||||
|
||||
Please send all patches, questions, feedback, clarifications, and help to:
|
||||
dhittner AT northropgrumman DOT com
|
||||
|
||||
Thanks, and Enjoy!!
|
||||
Dave
|
||||
===============================================================================
|
||||
|
||||
Reference in New Issue
Block a user