1SNOBOL4CMD(1)                   CSNOBOL4 Manual                  SNOBOL4CMD(1)
2
3
4

NAME

6       snobol4 - SNOBOL4 interpreter command line syntax
7

SYNOPSIS

9       snobol4 [ options ... ] [ file ... ] [ param ... ]
10

OPTIONS

12       -b  Disable start up banner and termination output (only displayed when
13           no source files are given on the command line).  In earlier
14           releases of CSNOBOL4 -b toggled banner output, and banners were
15           enabled by default.
16
17       -d ndesc
18           Allocate a “dynamic storage” region of ndesc descriptors for
19           program code and data. A suffix of k multiplies the number by 1024,
20           a suffix of m multiplies the number by 1048576.  A larger dynamic
21           region may result in fewer garbage collections (storage
22           regenerations), however large values may cause execution to slow
23           down when large amounts of garbage collect.  Most programs do not
24           need an increased dynamic region to run.  If your program
25           terminates with an “Insufficient storage to continue” message you
26           need to increase the dynamic storage region size.  The -h option
27           displays the default dynamic region size.
28
29       -f  Toggle folding of identifiers to upper case (see -CASE and &CASE).
30
31       -g  Enable garbage collection tracing (sets &GTRACE to -1).
32
33       -h  Give help. Shows usage message, includes default sizes for “dynamic
34           region” and pattern match stack.
35
36       -k  Toggle running programs with compilation errors (see -ERROR and
37           -NOERRORS extensions).  By default programs with compilation errors
38           will not be run.
39
40       -l LISTINGFILE
41           Enable listing output to the named file. The default listing side
42           is LEFT.
43
44       -n  Toggle running programs after compilation (see -EXECUTE and
45           -NOEXECUTE extensions).  By default programs are run after
46           compilation.
47
48       -p  Toggle SPITBOL extensions (also controlled by -PLUSOPS).
49
50       -r  Toggle reading INPUT from command line / source file(s) after the
51           END label.  Otherwise INPUT defaults (back) to standard input after
52           program compilation is complete.
53
54       -s  Toggle termination statistics (off by default).
55
56       -u param
57           Specify a parameter string available via HOST(0).
58
59       -v  Show version and exit.
60
61       -x  Force banner and termination output.
62
63       -z  Show directory search path in use (including all -I options on the
64           command line) and exit.
65
66       -B  Toggle SNOBOL4B operators (also controlled by -[NO]BLOCKS).
67
68       -I directory
69           Add directory to the directory search path before any other
70           directories (ie; from SNOPATH or default entries).  May be used
71           multiple times.
72
73       -L file
74           Preload SNOBOL4 source file. May be used multiple times.  Used to
75           preload the sdb(1) source code debugger.
76
77       -M  Specifies that all items left on the command line after option
78           processing is complete are to be treated as filenames.  The files
79           are read in turn until an END statement is found (Any remaining
80           data is available via the INPUT variable if the -r option is also
81           given).
82
83       -N  Disable standard search path, INCLUDING current working directory.
84           Only directories specified by -I options will be searched.
85           Mnemonic: “no standard include”.
86
87       -P ndesc
88           Allocate ndesc descriptors for the pattern match stack.  A suffix
89           of k multiplies the number by 1024, a suffix of m multiplies the
90           number by 1048576.  The pattern match stack is used to save
91           backtracking and conditional assignment information during pattern
92           matching.  If your program terminates with an “Overflow during
93           pattern matching” message (Error 16) you need to increase the
94           pattern match stack size.  The -h option displays the default
95           pattern match stack size.
96
97       -S ndesc
98           Allocate ndesc descriptors for the interpreter stack.  A suffix of
99           k multiplies the number by 1024, a suffix of m multiplies the
100           number by 1048576.  The interpreter stack is used for saving data,
101           and passing parameters to internal procedures. If your program
102           terminates with an “Stack overflow” message (Error 21) you need to
103           increase the interpreter stack size.  A common reason for needing
104           additional stack space is for tracing deeply nested DATA()
105           structures during garbage collection.  The -h option displays the
106           default interpreter stack size.
107
108       -U  Disable stdio buffering.  Also set if SNOBOL4UNBUFFERED environment
109           variable is set to a non-null value.  Will increase runtime, but
110           improve behavior when sucking on pipes (use ptys!).
111
112       --  Terminates processing items as options. Any remaining strings are
113           treated as files or user parameters (see the HOST() function).
114

SEE ALSO

116       snobol4(1).
117
118
119
120CSNOBOL4B 2.3.1                 March 31, 2022                   SNOBOL4CMD(1)
Impressum