2 * main() entry point for a stand-alone SBCL image
6 * This software is part of the SBCL system. See the README file for
9 * This software is derived from the CMU CL system, which was
10 * written at Carnegie Mellon University and released into the
11 * public domain. The software is in the public domain and is
12 * provided with absolutely no warranty. See the COPYING and CREDITS
13 * files for more information.
20 #ifndef LISP_FEATURE_WIN32
23 #include <sys/types.h>
24 #ifndef LISP_FEATURE_WIN32
30 #include <sys/param.h>
33 #ifndef LISP_FEATURE_WIN32
39 #if defined(SVR4) || defined(__linux__)
50 #include "interrupt.h"
60 #include "genesis/static-symbols.h"
61 #include "genesis/symbol.h"
70 #define SBCL_HOME "/usr/local/lib/sbcl/"
73 #ifdef LISP_FEATURE_HPUX
74 extern void *return_from_lisp_stub
;
75 #include "genesis/closure.h"
76 #include "genesis/simple-fun.h"
80 /* SIGINT handler that invokes the monitor (for when Lisp isn't up to it) */
82 sigint_handler(int signal
, siginfo_t
*info
, os_context_t
*context
)
84 lose("\nSIGINT hit at 0x%08lX\n",
85 (unsigned long) *os_context_pc_addr(context
));
88 /* (This is not static, because we want to be able to call it from
93 SHOW("entering sigint_init()");
94 install_handler(SIGINT
, sigint_handler
);
95 SHOW("leaving sigint_init()");
99 * helper functions for dealing with command line args
103 successful_malloc(size_t size
)
105 void* result
= malloc(size
);
107 lose("malloc failure\n");
111 return (void *) NULL
; /* dummy value: return something ... */
115 copied_string(char *string
)
117 return strcpy(successful_malloc(1+strlen(string
)), string
);
121 copied_existing_filename_or_null(char *filename
)
123 struct stat filename_stat
;
124 if (stat(filename
, &filename_stat
)) { /* if failure */
127 return copied_string(filename
);
131 /* miscellaneous chattiness */
137 "Usage: sbcl [runtime-options] [toplevel-options] [user-options]\n\
138 Common runtime options:\n\
139 --help Print this message and exit.\n\
140 --version Print version information and exit.\n\
141 --core <filename> Use the specified core file instead of the default.\n\
142 --dynamic-space-size <MiB> Size of reserved dynamic space in megabytes.\n\
143 --control-stack-size <MiB> Size of reserved control stack in megabytes.\n\
145 Common toplevel options:\n\
146 --sysinit <filename> System-wide init-file to use instead of default.\n\
147 --userinit <filename> Per-user init-file to use instead of default.\n\
148 --no-sysinit Inhibit processing of any system-wide init-file.\n\
149 --no-userinit Inhibit processing of any per-user init-file.\n\
151 User options are not processed by SBCL. All runtime options must\n\
152 appear before toplevel options, and all toplevel options must\n\
153 appear before user options.\n\
155 For more information please refer to the SBCL User Manual, which\n\
156 should be installed along with SBCL, and is also available from the\n\
157 website <http://www.sbcl.org/>.\n");
163 printf("SBCL %s\n", SBCL_VERSION_STRING
);
170 "This is SBCL %s, an implementation of ANSI Common Lisp.\n\
171 More information about SBCL is available at <http://www.sbcl.org/>.\n\
173 SBCL is free software, provided as is, with absolutely no warranty.\n\
174 It is mostly in the public domain; some portions are provided under\n\
175 BSD-style licenses. See the CREDITS and COPYING files in the\n\
176 distribution for more information.\n\
177 ", SBCL_VERSION_STRING
);
180 /* Look for a core file to load, first in the directory named by the
181 * SBCL_HOME environment variable, then in a hardcoded default
182 * location. Returns a malloced copy of the core filename. */
186 char *sbcl_home
= getenv("SBCL_HOME");
188 char *stem
= "/sbcl.core";
191 if (!(sbcl_home
&& *sbcl_home
)) sbcl_home
= SBCL_HOME
;
192 lookhere
= (char *) calloc(strlen(sbcl_home
) +
196 sprintf(lookhere
, "%s%s", sbcl_home
, stem
);
197 core
= copied_existing_filename_or_null(lookhere
);
200 lose("can't find core file at %s\n", lookhere
);
211 struct runtime_options
*runtime_options
;
215 main(int argc
, char *argv
[], char *envp
[])
217 #ifdef LISP_FEATURE_WIN32
218 /* Exception handling support structure. Evil Win32 hack. */
219 struct lisp_exception_frame exception_frame
;
222 /* the name of the core file we're to execute. Note that this is
223 * a malloc'ed string which should be freed eventually. */
225 char **sbcl_argv
= 0;
226 os_vm_offset_t embedded_core_offset
= 0;
227 char *runtime_path
= 0;
229 /* other command line options */
230 boolean noinform
= 0;
231 boolean end_runtime_options
= 0;
232 boolean disable_lossage_handler_p
= 0;
234 lispobj initial_function
;
235 const char *sbcl_home
= getenv("SBCL_HOME");
238 block_blockable_signals(0, 0);
240 setlocale(LC_ALL
, "");
242 runtime_options
= NULL
;
244 /* Check early to see if this executable has an embedded core,
245 * which also populates runtime_options if the core has runtime
247 runtime_path
= os_get_runtime_executable_path();
249 os_vm_offset_t offset
= search_for_embedded_core(runtime_path
);
251 embedded_core_offset
= offset
;
259 /* Parse our part of the command line (aka "runtime options"),
260 * stripping out those options that we handle. */
261 if (runtime_options
!= NULL
) {
262 dynamic_space_size
= runtime_options
->dynamic_space_size
;
263 thread_control_stack_size
= runtime_options
->thread_control_stack_size
;
268 runtime_options
= successful_malloc(sizeof(struct runtime_options
));
270 while (argi
< argc
) {
271 char *arg
= argv
[argi
];
272 if (0 == strcmp(arg
, "--script")) {
273 /* This is both a runtime and a toplevel option. As a
274 * runtime option, it is equivalent to --noinform.
275 * This exits, and does not increment argi, so that
276 * TOPLEVEL-INIT sees the option. */
278 end_runtime_options
= 1;
279 disable_lossage_handler_p
= 1;
280 lose_on_corruption_p
= 1;
282 } else if (0 == strcmp(arg
, "--noinform")) {
285 } else if (0 == strcmp(arg
, "--core")) {
287 lose("more than one core file specified\n");
291 lose("missing filename for --core argument\n");
293 core
= copied_string(argv
[argi
]);
296 } else if (0 == strcmp(arg
, "--help")) {
297 /* I think this is the (or a) usual convention: upon
298 * seeing "--help" we immediately print our help
299 * string and exit, ignoring everything else. */
302 } else if (0 == strcmp(arg
, "--version")) {
303 /* As in "--help" case, I think this is expected. */
306 } else if (0 == strcmp(arg
, "--dynamic-space-size")) {
309 lose("missing argument for --dynamic-space-size");
311 dynamic_space_size
= strtol(argv
[argi
++], 0, 0) << 20;
313 lose("argument to --dynamic-space-size is not a number");
314 # ifdef MAX_DYNAMIC_SPACE_END
315 if (!((DYNAMIC_SPACE_START
<
316 DYNAMIC_SPACE_START
+dynamic_space_size
) &&
317 (DYNAMIC_SPACE_START
+dynamic_space_size
<=
318 MAX_DYNAMIC_SPACE_END
)))
319 lose("specified --dynamic-space-size too large");
321 } else if (0 == strcmp(arg
, "--control-stack-size")) {
324 lose("missing argument for --control-stack-size");
326 thread_control_stack_size
= strtol(argv
[argi
++], 0, 0) << 20;
328 lose("argument to --control-stack-size is not a number");
329 } else if (0 == strcmp(arg
, "--debug-environment")) {
331 printf("; Commandline arguments:\n");
333 printf("; %2d: \"%s\"\n", n
, argv
[n
]);
337 printf(";\n; Environment:\n");
339 printf("; %2d: \"%s\"\n", n
, ENVIRON
[n
]);
343 } else if (0 == strcmp(arg
, "--disable-ldb")) {
344 disable_lossage_handler_p
= 1;
346 } else if (0 == strcmp(arg
, "--lose-on-corruption")) {
347 lose_on_corruption_p
= 1;
349 } else if (0 == strcmp(arg
, "--end-runtime-options")) {
350 end_runtime_options
= 1;
354 /* This option was unrecognized as a runtime option,
355 * so it must be a toplevel option or a user option,
356 * so we must be past the end of the runtime option
361 /* This is where we strip out those options that we handle. We
362 * also take this opportunity to make sure that we don't find
363 * an out-of-place "--end-runtime-options" option. */
365 char *argi0
= argv
[argi
];
367 /* (argc - argi) for the arguments, one for the binary,
368 and one for the terminating NULL. */
369 sbcl_argv
= successful_malloc((2 + argc
- argi
) * sizeof(char *));
370 sbcl_argv
[0] = argv
[0];
371 while (argi
< argc
) {
372 char *arg
= argv
[argi
++];
373 /* If we encounter --end-runtime-options for the first
374 * time after the point where we had to give up on
375 * runtime options, then the point where we had to
376 * give up on runtime options must've been a user
378 if (!end_runtime_options
&&
379 0 == strcmp(arg
, "--end-runtime-options")) {
380 lose("bad runtime option \"%s\"\n", argi0
);
382 sbcl_argv
[argj
++] = arg
;
388 /* Align down to multiple of page_table page size, and to the appropriate
389 * stack alignment. */
390 dynamic_space_size
&= ~(PAGE_BYTES
-1);
391 thread_control_stack_size
&= ~(CONTROL_STACK_ALIGNMENT_BYTES
-1);
393 /* Preserve the runtime options for possible future core saving */
394 runtime_options
->dynamic_space_size
= dynamic_space_size
;
395 runtime_options
->thread_control_stack_size
= thread_control_stack_size
;
397 /* KLUDGE: os_vm_page_size is set by os_init(), and on some
398 * systems (e.g. Alpha) arch_init() needs need os_vm_page_size, so
399 * it must follow os_init(). -- WHN 2000-01-26 */
405 /* If no core file was specified, look for one. */
407 core
= search_for_core();
410 /* Make sure that SBCL_HOME is set and not the empty string,
411 unless loading an embedded core. */
412 if (!(sbcl_home
&& *sbcl_home
) && embedded_core_offset
== 0) {
413 char *envstring
, *copied_core
, *dir
;
414 char *stem
= "SBCL_HOME=";
415 copied_core
= copied_string(core
);
416 dir
= dirname(copied_core
);
417 envstring
= (char *) calloc(strlen(stem
) +
421 sprintf(envstring
, "%s%s", stem
, dir
);
426 if (!noinform
&& embedded_core_offset
== 0) {
431 #if defined(SVR4) || defined(__linux__)
435 define_var("nil", NIL
, 1);
436 define_var("t", T
, 1);
438 if (!disable_lossage_handler_p
)
439 enable_lossage_handler();
443 initial_function
= load_core_file(core
, embedded_core_offset
);
444 if (initial_function
== NIL
) {
445 lose("couldn't find initial function\n");
447 #ifdef LISP_FEATURE_HPUX
448 /* -1 = CLOSURE_FUN_OFFSET, 23 = SIMPLE_FUN_CODE_OFFSET, we are
449 * not in LANGUAGE_ASSEMBLY so we cant reach them. */
450 return_from_lisp_stub
= (void *) ((char *)*((unsigned long *)
451 ((char *)initial_function
+ -1)) + 23);
454 gc_initialize_pointers();
456 arch_install_interrupt_handlers();
457 #ifndef LISP_FEATURE_WIN32
458 os_install_interrupt_handlers();
460 /* wos_install_interrupt_handlers(handler); */
461 wos_install_interrupt_handlers(&exception_frame
);
464 /* Pass core filename and the processed argv into Lisp. They'll
465 * need to be processed further there, to do locale conversion.
468 posix_argv
= sbcl_argv
;
470 FSHOW((stderr
, "/funcalling initial_function=0x%lx\n",
471 (unsigned long)initial_function
));
472 #ifdef LISP_FEATURE_WIN32
474 This is experimental prerelease support for the Windows platform: use\n\
475 at your own risk. \"Your Kitten of Death awaits!\"\n");
479 create_initial_thread(initial_function
);
480 lose("CATS. CATS ARE NICE.\n");