Commit graph

60 commits

Author SHA1 Message Date
Mark Pizzolato
af4f37efac doc: Revise the SIMH User's guide to describe startup config files executed
The key change is the addition of:

When a simulator starts execution, the following sequence of simh command
files are executed if they are found:
    1. If a file named simh.ini is located in your HOME directory, it is
        executed.
    2. If the simh.ini file in your HOME directory isn’t found, a file named
        simh.ini in your current working directory is executed if it exists.
    3. If the simulator is invoked with any arguments, then the arguments are
        presumed to be a command file and possible arguments to that command
        file which is executed.
    4. If the simulator is invoked without any arguments, then a command file
        with the same name as the simulator binary with .ini appended that is
        located in the current working directory is executed.

Note, that up to 2 separate command files may be executed on simulator
startup.  The simh.ini file allows the user to define local user
preferences that align with their personal goals for simulator execution
across all simulators that may be used on their system.

Steps 3 and 4 were inherited from simh v3.x.  Steps 1 and 2 was inspired
by conversations with J. David Bryan in April of 2012.  Some how it
never got documented.
2022-02-14 12:43:52 -08:00
Mark Pizzolato
92b1efe50f DISK: Clarify minor changes to sim_disk API in the documentation 2022-02-10 07:10:08 -08:00
Mark Pizzolato
a444923256 doc: Update info about pcap support for Ethernet simulation on Windows. 2022-02-04 20:56:45 -08:00
Mark Pizzolato
35503f4765 TMXR: Add Access Control List (ACL) support for incoming network connections 2022-02-04 07:59:08 -08:00
Mark Pizzolato
f9ce5ae8ff SCP: Add whitespace ignore option to file and string content comparisons 2020-11-01 16:27:47 -08:00
Mark Pizzolato
dceadb393e SCP: Add internal & cross platform support for tar and curl commands 2020-10-20 02:50:34 -07:00
Mark Pizzolato
918f7704da DOC: Update sim_doc.doc to start with how to run a simulator 2020-05-07 12:44:08 -07:00
Mark Pizzolato
01f93e9507 SCP: Add SHOW RUNLIMIT to examine the state/condition of any execution limit 2020-01-09 23:53:41 -08:00
Mark Pizzolato
7581b92f9d SCP: Add a RUNLIMIT command to bound simulator execution time 2020-01-08 11:49:22 -08:00
Mark Pizzolato
db26349bd7 TAPE: Add system specific ANSI tape formats VMS, RSX, RSTS and RT11
These formats are named ANSI-VMS, ANSI-RSX11, ANSI-RSTS and ANSI-RT11
2019-05-14 01:04:18 -07:00
Mark Pizzolato
52a31597ec TAPE: Add ANSIFILES tape format 2019-05-07 05:26:20 -07:00
Mark Pizzolato
287655da92 SCP: Document the -A switch for the ATTACH command.
As mentioned in #668
2019-05-04 14:12:42 -07:00
Mark Pizzolato
f12bc70470 TAPE: Add support for TAR tape format 2019-04-06 02:00:53 -07:00
Mark Pizzolato
9c75a7bfaa SCP: Correct help and doc to properly describe file compare IF command 2019-03-26 01:38:01 -07:00
Mark Pizzolato
928193d463 SCP: Fix EXPECT regular expression match environment variable names
- Use sim_messagef for consistency
2018-09-27 06:24:31 -07:00
Mark Pizzolato
3c7f79f251 SCP: Fix and document optional [count] parameter for EXPECT commands
- Avoid "Goodbye" message when optional status is specified on EXIT command.
- Properly range check [count] specified on EXPECT commands
2018-09-19 14:46:40 -07:00
Mark Pizzolato
d35b8725a3 SCP: Add optional status value to EXIT command 2018-09-18 14:24:14 -07:00
Mark Pizzolato
482b6f1be4 SCP: Add ELSE command extension to the IF command processing. 2018-08-06 18:22:46 -07:00
Mark Pizzolato
58ccb38d7b SCP: Add ability to ECHOF output to TMXR lines 2018-07-06 17:57:05 -07:00
Mark Pizzolato
6b361a9faf PDP11, PDP15, UC15: Merge simh v3.10 functionality from Supnik-Current branch 2018-06-04 10:43:00 -07:00
Mark Pizzolato
0daff9026d SCP: Add TIME_MSEC predefined variable to provide time to milliseconds
- Assure that Internal variables are referencable during expression evaluation
- Add DEVNAME.REGNAME format for referencing non unique registers in
  expression evaluation.
- Extend global register search to also search known internal device list
  registers
- Allow expression variable names to have _ as a character within in the name
2018-05-24 01:46:24 -07:00
Mark Pizzolato
4e508cfc29 SCP: Add C style expression support for IF conditions and SET ENV -A
Expression evaluation code provided by Gabriel Pizzolato.
2018-05-01 22:08:06 -07:00
Mark Pizzolato
8fe02ad6d1 SCP: Updaeted HELP EVAL to provide meaningful examples. 2018-05-01 13:43:22 -07:00
Mark Pizzolato
3a81f63ec1 SCP: Add support to handle CTRL+C while executing command files 2018-01-30 03:36:15 -08:00
Mark Pizzolato
fbcf72abfc SCP: Allow commands to be enclosed in quotes.
This is useful when commands containing semi-colons are used in the
action steps of BREAK, EXPECT, UNTIL, IF commands.
2018-01-04 07:12:43 -08:00
Mark Pizzolato
72d4622ddf SCP: Add ECHOF command which takes a quoted string as an argument 2018-01-04 07:06:51 -08:00
Mark Pizzolato
0293d7f4af SCP: Enrich EXPECT and SEND help and document information 2017-11-29 16:49:20 -08:00
Mark Pizzolato
733ac0d982 SCP: Make SLEEP command interruptable with SIGINT 2017-11-07 13:34:53 -08:00
Mark Pizzolato
097172f8a3 doc: Add missing commands descriptions 2017-11-03 09:36:11 -07:00
Mark Pizzolato
60ff3d53d9 doc: Add description of additional built-in environment variables
SIM_NAME, SIM_BIN_NAME and SIM_BIN_PATH
2017-10-24 16:20:46 -07:00
Mark Pizzolato
c8a420ad48 SCP: Change command argument processing of %% and \% to be consistent.
%% now inserts a bare % and \\ only means something when parsing a quoted
string argument (used by EXPECT and SEND commands).

Additionally, EXPECT and BREAK commands have action steps which will now
expand arguments as each of the actions are executed rather than when the
EXPECT or BREAK command is defined.
2017-09-16 17:05:26 -07:00
Mark Pizzolato
245818d348 SCP: Added extended radix options (-2, -8, -10 and -16) for EXAMINE and DEPOSIT 2017-08-25 15:48:11 -07:00
Mark Pizzolato
8fcddf9261 DOC: Describe warning added to the RUN command vs GO or CONTINUE (Dave Bryan) 2017-08-24 10:23:44 -07:00
Mark Pizzolato
1e8af71081 TIMER: Clarify throttling behavior displayed in SHOW for I/T mode 2017-05-11 08:33:39 -07:00
Mark Pizzolato
7ae5015610 SCP: Provide a way to gather input from a user into an environment variable
SET ENV -P "Prompt String" EnvVar=Default
2017-04-30 09:44:37 -07:00
Mark Pizzolato
7ac92a0e84 HP3000: Fourth HP 3000 release, update 1
See HP3000/hp3000_release.txt for details of the release
2017-01-25 11:50:49 -08:00
Mark Pizzolato
fb8a01dad9 DOC: Correct SET LOG and SET DEBUG command descriptions 2017-01-04 20:04:06 -08:00
Mark Pizzolato
76d5c34d85 DOC: Add argument substitution and %DATE_MONTH% 2016-12-12 14:12:41 -08:00
Mark Pizzolato
c393675b5b REMOTE_CONSOLE: Allow user selectable command output buffer size
The output of remote console commands gets truncated at the configured
buffer size.  The default has been raised from 1400 to 8192.
Common remote console usage is from the same host as the simulator and
as such localhost TCP traffic is delivered in chunks at least 8192 so no extra
packets will be involved in transporting the potential extra data and no
transmission delays on the send() call.
The minumum size is now 1400 (which was the prior default).
2016-12-08 11:27:07 -08:00
Mark Pizzolato
c420925a75 DOC: Corrected description of log behavior and made help and doc consistent 2016-12-07 05:46:29 -08:00
Mark Pizzolato
0ef87fac53 DOC: Clarified SET DEBUG, SET LOG and SET CONSOLE LOG documentation and help 2016-12-05 06:03:41 -08:00
Mark Pizzolato
ff95fb8ec2 SCP: Add warning about reset when RUN command is used multiple times.
The RUN command implicitly resets all devices which may have unexpected
consequences for a novice user.

The logic now produces a warning about this side effect when more than one
RUN command is executed in the same simulator session.

An explicit RESET command suppresses this warning for a subsequent RUN
command.

A RUN command with the -Q switch also suppresses this warning.
2016-11-18 05:20:06 -08:00
Mark Pizzolato
b1950e1fe2 DOC: Clarified wording for LOAD and DUMP commands in sim_doc.doc 2016-11-16 17:45:07 -08:00
Mark Pizzolato
9122a9f196 SCP: Add . pseudo symbol to reference the most recent address
Useful in EXAMINE and DEPOSIT.
2016-09-26 18:23:55 -07:00
Mark Pizzolato
73a9475c9d DOC: Correct descriptions of when large file and Ethernet support is available 2016-06-29 20:51:01 -07:00
Mark Pizzolato
c55b6a8a8b makefile: Document supported build requirements and allow unsupported builds
Users wanting to build simulators with locally build dependent packages or
packages provided by an unsupported package management system can
override where this procedure looks for include files and/or libraries.

Overrides can be specified by define exported environment variables or
GNU make command line arguments which specify INCLUDES and/or LIBRARIES.
Each of these, if specified, must be the complete list include directories
or library directories that should be used with each element separated by
colons. (i.e. INCLUDES=/usr/include/:/usr/local/include/:...)

Binaries built with unsupported library components will have a 'unsupported' tag
in the output of the SHOW VERSION command.
2016-04-26 20:24:01 -07:00
Mark Pizzolato
e162eb9418 DOC: Clarifications about behavior and requirements for EXAMINE -a and -c switches. From Dave Bryan 2015-11-19 09:06:19 -08:00
Mark Pizzolato
e27e396c30 TAPES: Attempt to validate the record structure of TPC formatted tapes when they are attached.
Stubs to validate SIMH and E11 format tapes as well.
Once all validation routines are available, logic to auto detect tape format will be implemented.
2015-05-17 18:50:51 -07:00
Mark Pizzolato
04142da99c SCP: Added simulator version checking while performing a RESTORE operation.
Added -Q switch to suppress version check messages
Added -D switch to disable the detach_all at the beginning of a restore and any actual attach operations during the restore
2015-04-17 14:43:52 -07:00
Mark Pizzolato
94486c1286 SCP: Updated documentation and help text 2014-10-31 05:13:55 -07:00