ecl1

Usage

Overview

ECL (Embeddable Common-Lisp) is an interpreter of the Common-Lisp language as described in the X3J13 ANSI specification, featuring CLOS (Common-Lisp Object System), conditions, loops, etc. plus a translator to C, which can produce standalone executables.

ECL supports the operating systems Linux, FreeBSD, NetBSD, OpenBSD, OS X, Solaris and Windows, running on top of the Intel, Sparc, Alpha, PowerPC and ARM processors.

The current ECL implementation features:

ecl without any argument starts the interactive lisp session.

Options

-?, --help

Shows the help prompt without running the ECL.

-v, --version,

Prints the current version of ECL, without running the ECL.

--debug

Turned on by default, this enables the debugging in the setup phase, so that you can debug your files.

--nodebug

Run without debugging setup phase, meaning that errors prevent ECL from starting up.

--dir directory

Use directory as a system directory.

--load file

Load source file before loading the .rc file and starting the toplevel.

--shell file

Executes the given file and exits, without providing a read-eval-print loop. If you want to use lisp as a scripting language, you can write #!${exec_prefix}/bin/ecl --shell on the first line of the file to be executed, and then ECL will be automatically invoked.

--eval file

Evaluate the file before loading the .rc file and starting the Top Level.

--rc

Load configuration files at startup (default).

--norc

Do not load configuration files at startup.

--c-stack size

Set C stack size in bytes for C compiler.

--lisp-stack size

Set stack size in bytes for bytecodes interpreter.

--heap-stack size

Set heap size in bytes.

--frame-stack size

Set frame stack size in bytes for runtime control structures.

-o file

Provide the output target file for compilation.

-c cfile

When compiling name the intermediary *.c file cfile and do not delete it afterwards.

-h hfile

When compiling name the intermediary *.h file hfile and do not delete it afterwards.

--data [datafile]

Dumps compiler data into datafile or, if not supplied, into a file named after the source file, but with .data as extension.

-s

Produce a linkable object file. It cannot be loaded with (load), but it can be used to build libraries or standalone executable programs.

-q

Short for quiet -- produce less notes.

--compile file

Translates file to C and invokes the local C compiler to produce a native code program.

--link file+

Create standalone executable from Lisp files file+.

--input-encoding encoding

Specify the external encoding for standard input.

--output-encoding encoding

Specify the external encoding for standard output.

--error-encoding encoding

Specify the external encoding for standard error.

--encoding encoding

Specify the external encoding for standard input, output, trace and error.

--trap-fpe

Make ECL debugger catch floating point exception.

--no-trap-fpe

Disable ECL debugger floating point exception catching.

Files

~/.ecl, ~/.eclrc

Default initialization files loaded at startup unless the option --norc is provided (if they exist).