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

NAME

6       snobol4host - SNOBOL4 host O/S functions
7

SYNOPSIS

9           -INCLUDE 'host.sno'
10

DESCRIPTION

12       HOST()
13           Macro SPITBOL: returns ARCHITECTURE:OPERATING_SYSTEM:SNOBOL_VERSION
14           The string contains three parts, separated by colons.  The first
15           part describes the physical architecture, the second describes the
16           operating system, and the third describes the language
17           implementation name and version.  NOTE! Architecture names come
18           from the uname(3) library call, and may be different for the same
19           hardware when running different operating systems. Examples:
20               amd64:FreeBSD 12.1-RELEASE-p1:CSNOBOL4B 2.2
21               x86_64:Linux 5.4.0-12-generic:CSNOBOL4B 2.2
22
23       HOST(0)
24           Macro SPITBOL: returns a string containing the command line
25           parameter supplied to the -u option, if any.  If no -u option was
26           given, HOST(0) returns the concatenation of all user parameters
27           following the input filename(s).
28
29       HOST(1, string)
30           Catspaw SPITBOL: passes the string to the system(3) C library
31           function, and returns the subprocess exit status.
32
33       HOST(2, n)
34           Catspaw SPITBOL: for integer n returns the n'th command line
35           argument (regardless of whether the argument was the command name,
36           an option, a filename or a user parameter) as a string, or failure
37           if n is out of range.
38
39       HOST(3)
40           Catspaw SPITBOL: returns an integer for use with HOST(2) indicating
41           the first command line argument available as a user parameter.
42
43       HOST(4, I<string)
44           Catspaw SPITBOL: returns the value of the environment variable
45           named by string.
46
47       HOST(HOST_CONFIG_HOST)
48           CSNOBOL4: returns host where configure script was run
49
50       HOST(HOST_CONFIG_DATE)
51           CSNOBOL4: returns date when configure script was run
52
53       HOST(HOST_CONFIG_OPTIONS)
54           CSNOBOL4: returns configure command line options (or fails)
55
56       HOST(HOST_VERSION_DATE)
57           CSNOBOL4: version date (from configure script)
58
59       HOST(HOST_CC_IS)
60           CSNOBOL4: C compiler name/id
61
62       HOST(HOST_BUILD_DATE)
63           CSNOBOL4: returns date when snobol4 built
64
65       HOST(HOST_BUILD_DIR)
66           CSNOBOL4: returns directory where snobol4 built
67
68       HOST(HOST_BUILD_FILES)
69           CSNOBOL4: returns named of files ued to build snobol4
70
71       HOST(HOST_SNOLIB_DIR)
72           CSNOBOL4: return default SNOLIB directory (for -INCLUDE, LOAD())
73
74       HOST(HOST_SNOLIB_FILE)
75           CSNOBOL4: return default file for LOAD()
76
77       HOST(HOST_CC)
78           CSNOBOL4: C Compiler used to build CSNOBOL4
79
80       HOST(HOST_COPT)
81           CSNOBOL4: C Compiler optimizer flags used to build CSNOBOL4
82
83       HOST(HOST_SO_EXT)
84           CSNOBOL4: Shared Object Library extension
85
86       HOST(HOST_SO_CFLAGS)
87           CSNOBOL4: C Compiler flags for Shared Objects
88
89       HOST(HOST_SO_LD)
90           CSNOBOL4: Shared Object file load command
91
92       HOST(HOST_SO_LDFLAGS)
93           CSNOBOL4: Shared Object file load switches
94
95       HOST(HOST_DL_EXT)
96           CSNOBOL4: Dynamic Loadable Library extension
97
98       HOST(HOST_DL_CFLAGS)
99           CSNOBOL4: C Compiler flags for Dynamic Loadables
100
101       HOST(HOST_DL_LD)
102           CSNOBOL4: Dynamic Loadable file load command
103
104       HOST(HOST_DL_LDFLAGS)
105           CSNOBOL4: Dynamic Loadable file load switches
106
107       HOST(HOST_DIR_SEP)
108           CSNOBOL4: return system directory seperator character (may be
109           empty)
110
111       HOST(HOST_PATH_SEP)
112           CSNOBOL4: return system PATH seperator character
113
114       HOST(HOST_DEF_SNOPATH)
115           CSNOBOL4: default library search path
116
117       HOST(HOST_INCLUDE_DIR)
118           CSNOBOL4: path for C headers
119
120       HOST(HOST_OBJ_EXT)
121           CSNOBOL4: object file extension
122
123       HOST(HOST_SETUP_SYS)
124           CSNOBOL4: setuputil system name
125
126       HOST(HOST_SHARED_OBJ_SUBDIR)
127           CSNOBOL4: shared object subdir
128
129       HOST(HOST_CONFIG_CFLAGS)
130           CSNOBOL4: CFLAGS from configure
131
132       HOST(HOST_CONFIG_CPPFLAGS)
133           CSNOBOL4: C preprocessor flags from configure
134
135       HOST(HOST_CONFIG_LDFLAGS)
136           CSNOBOL4: loader flags from configure
137
138       HOST(HOST_INTEGER_BITS)
139           CSNOBOL4: number of bits used to represent SNOBOL4 INTEGER type
140
141       HOST(HOST_REAL_BITS)
142           CSNOBOL4: number of bits used to represent SNOBOL4 REAL type
143
144       HOST(HOST_POINTER_BITS)
145           CSNOBOL4: number of bits used to represent C pointer type
146
147       HOST(HOST_LONG_BITS)
148           CSNOBOL4: number of bits used to represent C long type
149
150       HOST(HOST_DESCR_BITS)
151           CSNOBOL4: number of bits used to represent SIL "descriptor" type
152
153       HOST(HOST_SPEC_BITS)
154           CSNOBOL4: number of bits used to represent SIL "specifier" type
155
156       HOST(HOST_CHAR_BITS)
157           CSNOBOL4: number of bits used to represent C char type
158
159       HOST(HOST_DYNAMIC_SIZE)
160           CSNOBOL4: size of "dynamic" storage in descriptors
161
162       HOST(HOST_PMSTACK_SIZE)
163           CSNOBOL4: size of pattern match stack in descriptors
164
165       HOST(HOST_ISTACK_SIZE)
166           CSNOBOL4: size of interpreter stack in descriptors
167
168       HOST(HOST_SNOLIB_BASE)
169           CSNOBOL4: library base directory in use
170
171       HOST(HOST_SNOLIB_LOCAL)
172           CSNOBOL4: local, version-independant files
173
174       HOST(HOST_SNOLIB_VLIB)
175           CSNOBOL4: distribution files (version-specific)
176
177       HOST(HOST_SNOLIB_VLOCAL)
178           CSNOBOL4: local, version-specific files
179
180       HOST(HOST_SNOPATH_DIR)
181           CSNOBOL4: return n'th element in search directory list
182
183       HOST(HOST_SNOLIB_VERS)
184           CSNOBOL4: versioned base directory
185

SEE ALSO

187       snobol4(1), snobol4func(1).
188
189
190
191CSNOBOL4B 2.3.1                 March 31, 2022                  SNOBOL4HOST(3)
Impressum