All Manuals > LispWorks Release Notes and Installation Guide > 11 Configuration on UNIX


11.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 - 23 Dec 2011