dumplisp

This function saves an image of the currently executing Common Lisp as
an image file. This file (which usually has extension .dxl) is not
executable, but is suitable as the image argument to the executable
files such as mlisp or mlisp8 on Unix machines or
mlisp.exe or mlisp8.exe on Windows (and
alisp[.exe] or alisp8[.exe]). You can specify the
name of the image file created with the name
keyword argument. The name defaults to savedcl.dxl. Thus,
calling in Lisp

(dumplisp)

will produce an image file savedcl.dxl.This image can be
started with the command line (use whichever of
m/alisp or m/alisp8 was used
to start the image that was dumped):

On Windows, .dxl is usually registered as an Allegro CL image
file extension, so double-clicking on it in the File Explorer should
also start Allegro CL with that image. Note too on Windows that if the
image contains the IDE, then adding -f cg:start-ide
to the command line will cause the IDE to be started automatically
when the image starts.

The following table gives brief descriptions of the arguments. See
the notes for more information on specific arguments and the warning
that follow the notes. See dumplisp.htm for more
information on dumplisp.

Argument

Value should be:

Effect

See

name

A string naming a file (default
"savedcl.dxl"). Image files must have an extension. The usual
extension is dxl but any non-null extension will do.

The dumped image will have this name. If
no directory is specified, the file will be written to the current
working directory.

Warning

ignore-command-line-arguments

t or nil (default nil)

If true, command-line-arguments prefaced
with a - (a dash) are ignored during startup and
all such arguments are considered application arguments (to command-line-arguments and
friends). Arguments prefaced with a + (which are
applicable to Windows only) are never ignored. See Command line
arguments in startup.htm for details of
command-line arguments.

When the suppress-allegro-cl-banner
keyword argument is true, then the following
warning is issued:

You are allowed to suppress (i.e., not display) the Franz
Inc. supplied copyright banner in your application, if and only if you
agree to display Franz Inc. copyright and proprietary notices wherever
you display your own copyright or other proprietary notices.

Warning: This function depends on the current
running Lisp image file to be present and readable (i.e. it cannot be
read-protected) and not stripped. Therefore you cannot delete that
file before running dumplisp
and you cannot specify that file as the value of the
name argument.