LISP(1) Domain/OS BSD LISP(1)
usage: LISP [-NO_INIT_FILE] [-INIT_FILE name] [-BASE_ADDRESS addr]
[-RESERVED_SEGMENTS res] [-DYNAMIC_SEGMENTS dyn]
[-STACK_SEGMENTS stk] [-PAGING_VOLUME vol]
[-DYNAMIC_LIMIT lim] [-WRITABLE_PURE] [-VERBOSE]
SYNOPSIS
lisp [options]
wedlisp [options]
clxwedlisp [options]
applisp [options]
wapplisp [options]
clxwapplisp [options]
DESCRIPTION
The LISP command invokes the Domain/CommonLISP Development Environment
without the Editor and Window Tool Kit.
The WEDLISP command invokes the Domain/CommonLISP Development Environment
with the Editor and DM Window Tool Kit.
The CLXWEDLISP command invokes the Domain/CommonLISP Development Environment
with the Editor and CLX Window Tool Kit.
The APPLISP command invokes the Domain/CommonLISP Application Environment
without the Window Tool Kit.
The WAPPLISP command invokes the Domain/CommonLISP Application Environment
with the Window Tool Kit for the Display Manager.
The CLXWAPPLISP command invokes the Domain/CommonLISP Development Environment
with the Window Tool Kit for X windows.
For information on programming in Domain/CommonLISP, see the following
manuals:
o Domain/CommonLISP User's Guide
o Domain/CommonLISP Advanced User's Guide
o Domain/CommonLISP Tool Reference, Volume I
- The Window Tool Kit
- The Editor
o Domain/CommonLISP Tool Reference, Volume II
- The Flavor System
- The Loop Facility
- The Delivery Tool Kit
- The Common Lisp Object System
OPTIONS
-no_init_file
The -NO_INIT_FILE option lets you specify that LISP should not load
an initialization file when it begins execution.
-init_file name
The -INIT_FILE options lets you specify that LISP should load "name"
as its initialization file when it begins execution.
-base_address addr
The -BASE_ADDRESS option lets you specify where in memory the LISP image
is located, and hence how much foreign data can be allocated. "addr"
must be a multiple of 64K and is always specified in hexadecimal. The
-BASE_ADDRESS option defaults to 100000, allowing for about one megabyte
of foreign code and data.
-reserved_segments res
The -RESERVED_SEGMENTS option lets you specify an initial allocation of
"res" free segments of reserved memory when starting up a fresh LISP or
saved LISP image. "res" must be a positive integer and is always
specified in decimal. The -RESERVED_SEGMENTS option defaults to 96.
One segment equals 64 kilobytes.
-dynamic_segments dyn
The -DYNAMIC_SEGMENTS option lets you specify an initial allocation of
"dyn" free segments of dynamic memory when starting up a fresh LISP or
saved LISP image. "dyn" must be a positive integer and is always
specified in decimal. The -DYNAMIC_SEGMENTS parameter defaults to 64.
One segment equals 64 kilobytes.
-stack_segments stk
The -STACK_SEGMENTS option lets you specify an allocation of "stk"
segments for the stack when starting up a fresh LISP or saved LISP
image. "stk" must be a positive integer and is always specified in
decimal. The -STACK_SEGMENTS parameter defaults to 8. One segment
equals 64 kilobytes.
-paging_volume vol
The -PAGING_VOLUME option lets you specify the network disk volume on
which LISP should allocate its paging space. The -PAGING_VOLUME option
defaults to the node's paging volume.
-dynamic_limit lim
The -DYNAMIC_LIMIT option lets you specify the maximum percentage of
space on the paging volume that LISP will allocate for its use. The
-DYNAMIC_LIMIT option defaults to 95.
-writable_pure
The -WRITABLE_PURE option lets you specify that LISP should load the
pure portions of the image into writable storage rather than mapping
them read-only as is normally done. This option is used during
application building and with the Delivery Tool Kit.
-verbose
The -VERBOSE option lets you see a description of the operations LISP is
performing during startup, including the base address value and whether
LISP is relocating or copying regions of memory.
For further information on options to Domain/CommonLISP, including the use of
environment variables to specify the -no_init_file, -init_file, -base_address,
-reserved_segments, -dynamic_segments, -stack_segments, -paging_volume, and
-dynamic_limit options, please consult "Altering Initial Memory Allocation" in
Chapter 5 ("Storage Management in Common Lisp") of the Domain/CommonLISP
User's Guide and "Saving a Lisp Image" in Chapter 2 ("Customizing the Lisp
Environment") of the Domain/CommonLISP Advanced User's Guide.
The following options are also accepted by Domain/CommonLISP, unless the
variable *ENTER-TOP-LEVEL-HOOK* has been rebound:
-load "file"
-l "file"
The -LOAD or -L option indicates that LISP should load the specified
file by using the function LOAD; the "file" argument is passed to LOAD
as a string.
-eval "form"
-e "form"
The -EVAL or -E option passes the specified "form" to LISP for
evaluation. Any return value is lost; thus, the "form" argument
can only produce side effects.
-quit
-q
The -QUIT or -Q option calls the function QUIT, which terminates the
LISP environment.
Note that multiple uses of the -LOAD and -EVAL options are permitted. For
further information on these options, please consult "The Default Startup
Function" in Chapter 2 ("Customizing the Lisp Environment") of the
Domain/CommonLISP Advanced User's Guide.
EXAMPLES
1. % lisp Invoke Domain/CommonLISP.
2. % lisp -reserved_segments 64 -dynamic_segments 128
Invoke Domain/CommonLISP with an initial
allocation of 64 segments of reserved
memory and 128 segments of dynamic memory.
3. % lisp -base_address 200000 -paging_volume //big_disk -dynamic_limit 80
Invoke Domain/CommonLISP at a base address of
200000 and allocate paging space using at most 80%
of the space on network disk volume //big_disk.
4. % lisp -load "demo" -eval "(demo)" -quit
Invoke Domain/CommonLISP, load the file "demo",
call the function DEMO, and then exit.