22.4.1 Command Line Arguments

The following command line options are supported by the system.

-siteinit siteinit-file

siteinit-file names a file to be loaded on startup. The file is the LispWorks site initialization file, containing code that by default is loaded when LispWorks is started by any user in that installation. The default is to load the file that is the result of evaluating (sys:lispworks-file "config/siteinit.lisp") .

If siteinit-file is not found, an error is signalled. To suppress loading of a site initialization file, pass -siteinit - .

-init init-file

init-file names a file to be loaded on startup after siteinit-file . The file is user's own LispWorks initialization file, containing code that by default is loaded when LispWorks is started. It is useful for loading initializations that should not be done for all users.

Initially the default is to load the file "~/.lispworks" where ~ expands to the user's home directory as described in Configuration and initialization files.

Your default initialization file can be set in the Common LispWorks IDE. See "Setting global preferences" in the Common LispWorks User Guide for details.

If init-file is not found, an error is signalled. To suppress loading of a user initialization file, pass -init - .

-build build-script

build-script names a file to be loaded on startup, typically for the purpose of building another image. LispWorks quits after loading the script. If an error is signalled while loading the script, a backtrace is displayed and LispWorks quits.

Note: The init-file and siteinit-file are not loaded when uding -build , so you should remember to call (load-all-patches) in the build script.

-environment

Start the Common LispWorks development environment automatically, even in an image saved with (save-image ... :environment nil)

-env

A synonym for -environment .

-display display

Sets the X display to use when starting a LispWorks GUI on X Windows.

-multiprocessing

Initializes multiprocessing on startup. See Multiprocessing.

-no-restart-function

Suppresses the execution of a restart function on startup. Restart functions can be supplied when saving an image to automatically invoke application code. This argument suppresses that behavior. See save-image in the LispWorks Reference Manual .

-ORBport orbport

orbport specifies a port number for the LispWorks ORB. The special value 0 allows the system to pick a port.

-IIOPhost host

Controls the host name in placed in IORs. See Developing Component Software with CORBA for details.

-IIOPnumeric

IORs contain a host name which is the numeric IP address obtained by reverse lookup of the machine name. See Developing Component Software with CORBA for details.

--relocate-image address

This special argument is supported in LispWorks for Linux, LispWorks for FreeBSD and LispWorks for Macintosh (Intel) only. It causes the image to relocate at the address address . This is useful on a system where libraries are mapped in address space between 0x20000000 and 0x80000000 where LispWorks wants to grow. LispWorks will attempt to 'skip' over these libraries, but it is better to relocate the LispWorks image above the libraries, avoiding the need to skip, if you can.

If the image is saved, then on restart without --relocate-image , it will locate itself automatically at address .

Note: to be effective, --relocate-image must be the first argument on the LispWorks command line.

For example:

lispworks --relocate-image 0x44000000