SNOBOL4CMD(1) CSNOBOL4 Manual SNOBOL4CMD(1)NAME
snobol4 - SNOBOL4 interpreter command line syntax
SYNOPSIS
snobol4 [ options ... ] [ file ... ] [ param ... ]
OPTIONS-b Disable start up banner and termination output (only displayed when
no source files are given on the command line). In earlier
releases of CSNOBOL4 -b toggled banner output, and banners were
enabled by default.
-d ndesc
Allocate a “dynamic storage” region of ndesc descriptors for
program code and data. A suffix of k multiplies the number by 1024,
a suffix of m multiplies the number by 1048576. A larger dynamic
region may result in fewer garbage collections (storage
regenerations), however large values may cause execution to slow
down when large amounts of garbage collect. Most programs do not
need an increased dynamic region to run. If your program
terminates with an “Insufficient storage to continue” message you
need to increase the dynamic storage region size. The -h option
displays the default dynamic region size.
-f Toggle folding of identifiers to upper case (see -CASE and &CASE).
-g Enable garbage collection tracing (sets >RACE to -1).
-h Give help. Shows usage message, includes default sizes for “dynamic
region” and pattern match stack.
-k Toggle running programs with compilation errors (see -ERROR and
-NOERRORS extensions). By default programs with compilation errors
will not be run.
-l LISTINGFILE
Enable listing output to the named file. The default listing side
is LEFT.
-n Toggle running programs after compilation (see -EXECUTE and
-NOEXECUTE extensions). By default programs are run after
compilation.
-p Toggle SPITBOL extensions (also controlled by -PLUSOPS).
-r Toggle reading INPUT from command line / source file(s) after the
END label. Otherwise INPUT defaults (back) to standard input after
program compilation is complete.
-s Toggle termination statistics (off by default).
-u param
Specify a parameter string available via HOST(0).
-v Show version and exit.
-x Force banner and termination output.
-z Show directory search path in use (including -I options) and exit.
-I directory
Appends directory argument to include search path (before elements
from the SNOLIB or SNOPATH environment variables).
-L file
Load source file before others on command line. May be used
multiple times. Used to preload the sdb(1) source code debugger.
-M Specifies that all items left on the command line after option
processing is complete are to be treated as filenames. The files
are read in turn until an END statement is found (Any remaining
data is available via the INPUT variable if the -r option is also
given).
-N Disable standard search path “no standard include.”
-P ndesc
Allocate ndesc descriptors for the pattern match stack. A suffix
of k multiplies the number by 1024, a suffix of m multiplies the
number by 1048576. The pattern match stack is used to save
backtracking and conditional assignment information during pattern
matching. If your program terminates with an “Overflow during
pattern matching” message (Error 16) you need to increase the
pattern match stack size. The -h option displays the default
pattern match stack size.
-S ndesc
Allocate ndesc descriptors for the interpreter stack. A suffix of
k multiplies the number by 1024, a suffix of m multiplies the
number by 1048576. The interpreter stack is used for saving data,
and passing parameters to internal procedures. If your program
terminates with an “Stack overflow” message (Error 21) you need to
increase the interpreter stack size. A common reason for needing
additional stack space is for tracing deeply nested DATA()
structures during garbage collection. The -h option displays the
default interpreter stack size.
-- Terminates processing items as options. Any remaining strings are
treated as files or user parameters (see the HOST() function).
SEE ALSOsnobol4(1).
CSNOBOL4B 2.0 January 1, 2015 SNOBOL4CMD(1)
