| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: &key name ignore-command-line-arguments suppress-allegro-cl-banner
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.
dumplisp will fail if there
are too many oldspaces. The limit depends on a complex formula, but is
around 2000. You can see how many oldspaces there are by
calling (room t)
. You can consolidate oldspaces
with sys:resize-areas. The
error message when there are too many is Error: Too many
regions. Consolidate oldspace with sys:resize-areas and retry if you get this
error.
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):
UNIX 16-bit: mlisp -I <directory containing savedcl.dxl>/savedcl.dxl UNIX 8-bit: mlisp8 -I <directory containing savedcl.dxl>/savedcl.dxl
WINDOWS 16-bit: mlisp.exe -I <directory containing savedcl.dxl>/savedcl.dxl WINDOWS 8bit: mlisp8.exe -I <directory containing savedcl.dxl>/savedcl.dxl
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.
|
Note 2 |
suppress-allegro-cl-banner | t or
nil (default nil ) |
The Allegro CL copyright banner will not be printed on startup. | Note 3 |
Notes:
t
, tried to restart actual computational state,
no longer possible); standalone (the separate
executable/image model means an image cannot be standalone).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.
See also dumplisp.htm, building-images.htm, and delivery.htm.
Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |