src/runtime/runtime.c

   1 /*
   2  * main() entry point for a stand-alone SBCL image
   3  */
   4
   5 /*
   6  * This software is part of the SBCL system. See the README file for
   7  * more information.
   8  *
   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.
  14  */
  15
  16 #include "sbcl.h"
  17
  18 #include <stdio.h>
  19 #include <string.h>
  20 #ifndef LISP_FEATURE_WIN32
  21 #include <libgen.h>
  22 #endif
  23 #include <sys/types.h>
  24 #ifndef LISP_FEATURE_WIN32
  25 #include <sys/wait.h>
  26 #endif
  27 #include <stdlib.h>
  28 #include <unistd.h>
  29 #include <sys/file.h>
  30 #include <sys/param.h>
  31 #include <sys/stat.h>
  32 #include <signal.h>
  33 #ifndef LISP_FEATURE_WIN32
  34 #include <sched.h>
  35 #endif
  36 #include <errno.h>
  37 #include <locale.h>
  38
  39 #if defined(SVR4) || defined(__linux__)
  40 #include <time.h>
  41 #endif
  42
  43 #include "signal.h"
  44
  45 #include "runtime.h"
  46 #include "alloc.h"
  47 #include "vars.h"
  48 #include "globals.h"
  49 #include "os.h"
  50 #include "interrupt.h"
  51 #include "arch.h"
  52 #include "gc.h"
  53 #include "interr.h"
  54 #include "validate.h"
  55 #include "core.h"
  56 #include "save.h"
  57 #include "lispregs.h"
  58 #include "thread.h"
  59
  60 #include "genesis/static-symbols.h"
  61 #include "genesis/symbol.h"
  62
  63
  64 #ifdef irix
  65 #include <string.h>
  66 #include "interr.h"
  67 #endif
  68
  69 #ifndef SBCL_HOME
  70 #define SBCL_HOME "/usr/local/lib/sbcl/"
  71 #endif
  72
  73 \f
  74 /* SIGINT handler that invokes the monitor (for when Lisp isn't up to it) */
  75 static void
  76 sigint_handler(int signal, siginfo_t *info, void *void_context)
  77 {
  78     lose("\nSIGINT hit at 0x%08lX\n",
  79          (unsigned long) *os_context_pc_addr(void_context));
  80 }
  81
  82 /* (This is not static, because we want to be able to call it from
  83  * Lisp land.) */
  84 void
  85 sigint_init(void)
  86 {
  87     SHOW("entering sigint_init()");
  88     install_handler(SIGINT, sigint_handler);
  89     SHOW("leaving sigint_init()");
  90 }
  91 \f
  92 /*
  93  * helper functions for dealing with command line args
  94  */
  95
  96 void *
  97 successful_malloc(size_t size)
  98 {
  99     void* result = malloc(size);
 100     if (0 == result) {
 101         lose("malloc failure\n");
 102     } else {
 103         return result;
 104     }
 105     return (void *) NULL; /* dummy value: return something ... */
 106 }
 107
 108 char *
 109 copied_string(char *string)
 110 {
 111     return strcpy(successful_malloc(1+strlen(string)), string);
 112 }
 113
 114 char *
 115 copied_existing_filename_or_null(char *filename)
 116 {
 117     struct stat filename_stat;
 118     if (stat(filename, &filename_stat)) { /* if failure */
 119         return 0;
 120     } else {
 121         return copied_string(filename);
 122     }
 123 }
 124 \f
 125 /* miscellaneous chattiness */
 126
 127 void
 128 print_help()
 129 {
 130     puts(
 131 "Usage: sbcl [runtime-options] [toplevel-options] [user-options]\n\
 132 Common runtime options:\n\
 133   --help                     Print this message and exit.\n\
 134   --version                  Print version information and exit.\n\
 135   --core <filename>          Use the specified core file instead of the default.\n\
 136   --dynamic-space-size <MiB> Size of reserved dynamic space in megabytes.\n\
 137   --control-stack-size <MiB> Size of reserved control stack in megabytes.\n\
 138 \n\
 139 Common toplevel options:\n\
 140   --sysinit <filename>       System-wide init-file to use instead of default.\n\
 141   --userinit <filename>      Per-user init-file to use instead of default.\n\
 142   --no-sysinit               Inhibit processing of any system-wide init-file.\n\
 143   --no-userinit              Inhibit processing of any per-user init-file.\n\
 144 \n\
 145 User options are not processed by SBCL. All runtime options must\n\
 146 appear before toplevel options, and all toplevel options must\n\
 147 appear before user options.\n\
 148 \n\
 149 For more information please refer to the SBCL User Manual, which\n\
 150 should be installed along with SBCL, and is also available from the\n\
 151 website <http://www.sbcl.org/>.\n");
 152 }
 153
 154 void
 155 print_version()
 156 {
 157     printf("SBCL %s\n", SBCL_VERSION_STRING);
 158 }
 159
 160 void
 161 print_banner()
 162 {
 163     printf(
 164 "This is SBCL %s, an implementation of ANSI Common Lisp.\n\
 165 More information about SBCL is available at <http://www.sbcl.org/>.\n\
 166 \n\
 167 SBCL is free software, provided as is, with absolutely no warranty.\n\
 168 It is mostly in the public domain; some portions are provided under\n\
 169 BSD-style licenses.  See the CREDITS and COPYING files in the\n\
 170 distribution for more information.\n\
 171 ", SBCL_VERSION_STRING);
 172 }
 173
 174 /* Look for a core file to load, first in the directory named by the
 175  * SBCL_HOME environment variable, then in a hardcoded default
 176  * location.  Returns a malloced copy of the core filename. */
 177 char *
 178 search_for_core ()
 179 {
 180     char *sbcl_home = getenv("SBCL_HOME");
 181     char *lookhere;
 182     char *stem = "/sbcl.core";
 183     char *core;
 184
 185     if (!(sbcl_home && *sbcl_home)) sbcl_home = SBCL_HOME;
 186     lookhere = (char *) calloc(strlen(sbcl_home) +
 187                                strlen(stem) +
 188                                1,
 189                                sizeof(char));
 190     sprintf(lookhere, "%s%s", sbcl_home, stem);
 191     core = copied_existing_filename_or_null(lookhere);
 192
 193     if (!core) {
 194         lose("can't find core file at %s\n", lookhere);
 195     }
 196
 197     free(lookhere);
 198
 199     return core;
 200 }
 201
 202 char **posix_argv;
 203 char *core_string;
 204
 205 struct runtime_options *runtime_options;
 206
 207 \f
 208 int
 209 main(int argc, char *argv[], char *envp[])
 210 {
 211 #ifdef LISP_FEATURE_WIN32
 212     /* Exception handling support structure. Evil Win32 hack. */
 213     struct lisp_exception_frame exception_frame;
 214 #endif
 215
 216     /* the name of the core file we're to execute. Note that this is
 217      * a malloc'ed string which should be freed eventually. */
 218     char *core = 0;
 219     char **sbcl_argv = 0;
 220     os_vm_offset_t embedded_core_offset = 0;
 221     char *runtime_path = 0;
 222
 223     /* other command line options */
 224     boolean noinform = 0;
 225     boolean end_runtime_options = 0;
 226
 227     lispobj initial_function;
 228     const char *sbcl_home = getenv("SBCL_HOME");
 229
 230     interrupt_init();
 231     block_blockable_signals();
 232
 233     setlocale(LC_ALL, "");
 234
 235     runtime_options = NULL;
 236
 237     /* Check early to see if this executable has an embedded core,
 238      * which also populates runtime_options if the core has runtime
 239      * options */
 240     runtime_path = os_get_runtime_executable_path();
 241     if (runtime_path) {
 242         os_vm_offset_t offset = search_for_embedded_core(runtime_path);
 243         if (offset != -1) {
 244             embedded_core_offset = offset;
 245             core = runtime_path;
 246         } else {
 247             free(runtime_path);
 248         }
 249     }
 250
 251
 252     /* Parse our part of the command line (aka "runtime options"),
 253      * stripping out those options that we handle. */
 254     if (runtime_options != NULL) {
 255         dynamic_space_size = runtime_options->dynamic_space_size;
 256         thread_control_stack_size = runtime_options->thread_control_stack_size;
 257         sbcl_argv = argv;
 258     } else {
 259         int argi = 1;
 260
 261         runtime_options = successful_malloc(sizeof(struct runtime_options));
 262
 263         while (argi < argc) {
 264             char *arg = argv[argi];
 265             if (0 == strcmp(arg, "--script")) {
 266                 /* This is both a runtime and a toplevel option. As a
 267                  * runtime option, it is equivalent to --noinform.
 268                  * This exits, and does not increment argi, so that
 269                  * TOPLEVEL-INIT sees the option. */
 270                 noinform = 1;
 271                 end_runtime_options = 1;
 272                 break;
 273             } else if (0 == strcmp(arg, "--noinform")) {
 274                 noinform = 1;
 275                 ++argi;
 276             } else if (0 == strcmp(arg, "--core")) {
 277                 if (core) {
 278                     lose("more than one core file specified\n");
 279                 } else {
 280                     ++argi;
 281                     if (argi >= argc) {
 282                         lose("missing filename for --core argument\n");
 283                     }
 284                     core = copied_string(argv[argi]);
 285                     ++argi;
 286                 }
 287             } else if (0 == strcmp(arg, "--help")) {
 288                 /* I think this is the (or a) usual convention: upon
 289                  * seeing "--help" we immediately print our help
 290                  * string and exit, ignoring everything else. */
 291                 print_help();
 292                 exit(0);
 293             } else if (0 == strcmp(arg, "--version")) {
 294                 /* As in "--help" case, I think this is expected. */
 295                 print_version();
 296                 exit(0);
 297             } else if (0 == strcmp(arg, "--dynamic-space-size")) {
 298                 ++argi;
 299                 if (argi >= argc)
 300                     lose("missing argument for --dynamic-space-size");
 301                 errno = 0;
 302                 dynamic_space_size = strtol(argv[argi++], 0, 0) << 20;
 303                 if (errno)
 304                     lose("argument to --dynamic-space-size is not a number");
 305 #               ifdef MAX_DYNAMIC_SPACE_END
 306                 if (!((DYNAMIC_SPACE_START < DYNAMIC_SPACE_START+dynamic_space_size) &&
 307                       (DYNAMIC_SPACE_START+dynamic_space_size <= MAX_DYNAMIC_SPACE_END)))
 308                     lose("specified --dynamic-space-size too large");
 309 #               endif
 310             } else if (0 == strcmp(arg, "--control-stack-size")) {
 311                 ++argi;
 312                 if (argi >= argc)
 313                     lose("missing argument for --control-stack-size");
 314                 errno = 0;
 315                 thread_control_stack_size = strtol(argv[argi++], 0, 0) << 20;
 316                 if (errno)
 317                     lose("argument to --control-stack-size is not a number");
 318             } else if (0 == strcmp(arg, "--debug-environment")) {
 319                 int n = 0;
 320                 printf("; Commandline arguments:\n");
 321                 while (n < argc) {
 322                     printf(";  %2d: \"%s\"\n", n, argv[n]);
 323                     ++n;
 324                 }
 325                 n = 0;
 326                 printf(";\n; Environment:\n");
 327                 while (ENVIRON[n]) {
 328                     printf(";  %2d: \"%s\"\n", n, ENVIRON[n]);
 329                     ++n;
 330                 }
 331                 ++argi;
 332             } else if (0 == strcmp(arg, "--end-runtime-options")) {
 333                 end_runtime_options = 1;
 334                 ++argi;
 335                 break;
 336             } else {
 337                 /* This option was unrecognized as a runtime option,
 338                  * so it must be a toplevel option or a user option,
 339                  * so we must be past the end of the runtime option
 340                  * section. */
 341                 break;
 342             }
 343         }
 344         /* This is where we strip out those options that we handle. We
 345          * also take this opportunity to make sure that we don't find
 346          * an out-of-place "--end-runtime-options" option. */
 347         {
 348             char *argi0 = argv[argi];
 349             int argj = 1;
 350             /* (argc - argi) for the arguments, one for the binary,
 351                and one for the terminating NULL. */
 352             sbcl_argv = successful_malloc((2 + argc - argi) * sizeof(char *));
 353             sbcl_argv[0] = argv[0];
 354             while (argi < argc) {
 355                 char *arg = argv[argi++];
 356                 /* If we encounter --end-runtime-options for the first
 357                  * time after the point where we had to give up on
 358                  * runtime options, then the point where we had to
 359                  * give up on runtime options must've been a user
 360                  * error. */
 361                 if (!end_runtime_options &&
 362                     0 == strcmp(arg, "--end-runtime-options")) {
 363                     lose("bad runtime option \"%s\"\n", argi0);
 364                 }
 365                 sbcl_argv[argj++] = arg;
 366             }
 367             sbcl_argv[argj] = 0;
 368         }
 369     }
 370
 371     /* Align down to multiple of page_table page size, and to the appropriate
 372      * stack alignment. */
 373     dynamic_space_size &= ~(PAGE_BYTES-1);
 374     thread_control_stack_size &= ~(CONTROL_STACK_ALIGNMENT_BYTES-1);
 375
 376     /* Preserve the runtime options for possible future core saving */
 377     runtime_options->dynamic_space_size = dynamic_space_size;
 378     runtime_options->thread_control_stack_size = thread_control_stack_size;
 379
 380     /* KLUDGE: os_vm_page_size is set by os_init(), and on some
 381      * systems (e.g. Alpha) arch_init() needs need os_vm_page_size, so
 382      * it must follow os_init(). -- WHN 2000-01-26 */
 383     os_init(argv, envp);
 384     arch_init();
 385     gc_init();
 386     validate();
 387
 388     /* If no core file was specified, look for one. */
 389     if (!core) {
 390         core = search_for_core();
 391     }
 392
 393     /* Make sure that SBCL_HOME is set and not the empty string,
 394        unless loading an embedded core. */
 395     if (!(sbcl_home && *sbcl_home) && embedded_core_offset == 0) {
 396         char *envstring, *copied_core, *dir;
 397         char *stem = "SBCL_HOME=";
 398         copied_core = copied_string(core);
 399         dir = dirname(copied_core);
 400         envstring = (char *) calloc(strlen(stem) +
 401                                     strlen(dir) +
 402                                     1,
 403                                     sizeof(char));
 404         sprintf(envstring, "%s%s", stem, dir);
 405         putenv(envstring);
 406         free(copied_core);
 407     }
 408
 409     if (!noinform && embedded_core_offset == 0) {
 410         print_banner();
 411         fflush(stdout);
 412     }
 413
 414 #if defined(SVR4) || defined(__linux__)
 415     tzset();
 416 #endif
 417
 418     define_var("nil", NIL, 1);
 419     define_var("t", T, 1);
 420
 421     enable_lossage_handler();
 422
 423     globals_init();
 424
 425     initial_function = load_core_file(core, embedded_core_offset);
 426     if (initial_function == NIL) {
 427         lose("couldn't find initial function\n");
 428     }
 429
 430     gc_initialize_pointers();
 431
 432     arch_install_interrupt_handlers();
 433 #ifndef LISP_FEATURE_WIN32
 434     os_install_interrupt_handlers();
 435 #else
 436 /*     wos_install_interrupt_handlers(handler); */
 437     wos_install_interrupt_handlers(&exception_frame);
 438 #endif
 439
 440     /* Pass core filename and the processed argv into Lisp. They'll
 441      * need to be processed further there, to do locale conversion.
 442      */
 443     core_string = core;
 444     posix_argv = sbcl_argv;
 445
 446     FSHOW((stderr, "/funcalling initial_function=0x%lx\n",
 447           (unsigned long)initial_function));
 448 #ifdef LISP_FEATURE_WIN32
 449     fprintf(stderr, "\n\
 450 This is experimental prerelease support for the Windows platform: use\n\
 451 at your own risk.  \"Your Kitten of Death awaits!\"\n");
 452     fflush(stdout);
 453     fflush(stderr);
 454 #endif
 455     create_initial_thread(initial_function);
 456     lose("CATS.  CATS ARE NICE.\n");
 457     return 0;
 458 }