10.4 Saving and testing the configured image
It is not usually necessary to save an image merely to preload patches and your configuration, because these load very quickly on modern machines.
However, if you want to save an image to reduce startup time for a complex configuration (such as large application code) or to save a non-windowing image, then proceed as described in this section.
10.4.1 Create a configuration file
Make a copy of
/tmp/my-configuration.lisp. When you have made the desired changes in
my-configuration.lisp you can save a new LispWorks image as described in Create and use a save-image script.
10.4.2 Create and use a save-image script
Create a configuration and saving script
(save-image-with-bundle "/Applications/My LispWorks/LW")
Change directory to the directory containing the LispWorks image to configure. For the native Mac OS X/Cocoa LispWorks image:
% cd "/Applications/LispWorks 7.0 (32-bit)/LispWorks (32-bit).app/Contents/MacOS"
or for the X11/GTK+ LispWorks image:
% cd "/Applications/LispWorks 7.0 (32-bit)"
Start the supplied image passing the configuration script the build file. For example enter one of the following commands (on one line of input):
% ./lispworks-7-0-0-x86-darwin -build /tmp/save-config.lisp
% ./lispworks-7-0-0-x86-darwin-gtk -build
If the image will not run at this stage, it is probably not finding a valid key.
Saving the image takes some time.
You can now use the new
My LispWorks/LW.app application bundle or the
my-lispworks-gtk image by starting it just as you did the supplied LispWorks. The supplied LispWorks is not required after the configuration process has been successfully completed.
Do not try to save a new image over an image that is currently running. Instead, save an image under a unique name, and then, if necessary, replace the new image with the old one after the call to
save-image has returned.
10.4.3 What to do if no image is saved
If no new image is saved, then there is some error while loading the build script. To see the error message, run the command with output redirected to a file, for example:
% ./lispworks-7-0-0-x86-darwin -build /tmp/save-config.lisp >
Look in the file
10.4.4 Testing the newly saved image
You should now test the new LispWorks image. To test a configured LispWorks, do the following:
If you are using an X11/GTK+ image, change directory to
When using X11, verify that your
DISPLAY environment variable is correctly set and that your machine has permission to connect to the display.
Start up the new image, by entering the path of the X11/GTK+ executable or by double-clicking on the LispWorks icon in the Mac OS X Finder.
The window-based environment should now initialize--during initialization a window displaying a copyright notice will appear on the screen.
You may wish to work through some of the examples in the
LispWorks User Guide and Reference Manual
, to further check that the configured image has been successfully built.
Test the load-on-demand system. In the Listener, type:
CL-USER 1 > (inspect 1)
Before information about the fixnum 1 is printed, the system should load the inspector from the
load-on-demand Library directory.
10.4.5 Saving a non-windowing image
For some purposes such as scripting it is convenient to have a LispWorks image that does not start the graphical programming environment.
To save an image which does not automatically start the GUI, use a script as described in Create and use a save-image script but pass the
:environment argument to
save-image. For example:
(save-image "my-tty-lispworks" :environment nil)
LispWorks Release Notes and Installation Guide - 2 Mar 2015