All Manuals > LispWorks User Guide and Reference Manual > 1 Starting LispWorks > 1.2 Passing arguments to LispWorks


1.2.1 Saving a new image

Note: If you use the LispWorks IDE, you may a saved session more convenient than saving an image as described in this section. See Saved sessions for more information.

To save a new image "by hand", create a suitable file save-config.lisp as described in the section "Saving and testing the configured image" in the LispWorks Release Notes and Installation Guide . Such a file should load any desired configuration, modules and application code, and lastly call save-image.

Then you run LispWorks with a command line which passes your file as an build script.

On Mac OS X, run to get a shell, and enter a line like this at the prompt:

% lispworks-6-1-0-macos-universal -build /tmp/save-config.lisp

On Windows, run Command Prompt to get a DOS shell, and enter a line like this:

C:\Program Files\LispWorks>lispworks-6-1-0-x86-win32.exe -build C:\temp\save-config.lisp

On Linux, get a shell and enter a line like this:

% lispworks-6-1-0-x86-linux -build /tmp/save-config.lisp

On UNIX, get a shell and enter a line like this:

% lispworks-6-1-0-sparc-solaris -build /tmp/save-config.lisp

When the command exits, a new image has been saved. You can run this new image directly from the command line, or create a shortcut or symbolic link to make it convenient to run.

With all the command lines above, if you perform the task frequently, make a script or a shortcut containing the command line, and run that.

Note that save-config.lisp no longer needs to do (load-all-patches) because -build calls load-all-patches automatically in LispWorks 6.1. However, it does no harm if save-config.lisp does call load-all-patches.

LispWorks User Guide and Reference Manual - 21 Dec 2011