All Manuals > LispWorks Release Notes and Installation Guide > 13 Configuration on SPARC Solaris


13.8 LispWorks initialization arguments

When LispWorks starts up, it looks for an initialization file to load. The name of the file is held in *init-file-name*, and is "~/.lispworks" by default. The file may contain any valid Lisp code.

You can load a different initialization file using the option -init in the command line, for example:

unix% lispworks -init my-lisp-init

would make LispWorks load my-lisp-init.lisp as the initialization file instead of that named by *init-file-name*.

Alternatively, an initialization file may be specified by setting the UNIX environment variable LW_INIT. If set, the specified file will be used instead of that named by *init-file-name*.

The loading of the siteinit file (located by default at config/siteinit.lisp) may similarly be controlled either by the -siteinit command line argument, or the LW_SITE_INIT variable and *site-init-file-name*.

You can start an image without loading any personal or site initialization file by passing a hyphen to the -init and -siteinit arguments instead of a filename:

unix% lispworks -init - -siteinit -

This starts the LispWorks image without loading any initialization file. It is often useful to start the image in this way when trying to repeat a suspected bug. You should always start the image without initialization if you are intending to resave it.

In all cases, if the filename is non-nil, and is not a hyphen, LispWorks tries to load it as a normal file by calling load. If the load fails, LispWorks prints an error report.

LispWorks Release Notes and Installation Guide - 2 Mar 2015