1ECL(1) General Commands Manual ECL(1)
2
6 ecl - Embeddable Common Lisp
7
9 ecl [-? | --help]
10 [--dir dir] [--load file] [--shell file] [--eval expr]
11 [--norc] [--hp | --nohp]
12 [--debug | --nodevbug]
13 [--c-stack size] [--lisp-stack size]
14 [--heap-size size] [--frame-stack size]
15 [[-o ofile] [-c [cfile]] [-h [hfile]] [--data [datafile]]
16 [-s] [-q] --compile file]
17 [[-o ofile] --link file+]
18 [--input-encoding external-format] [--output-encoding external-format]
19 [--error-encoding external-format] [--encoding external-format]
20 DEPRECATION NOTE: one-dash versions of long flags(e.g. -eval or -data)
21 are deprecated; you should use two-dash versions (e.g. --eval or
22 --data) now.
23
27 ECL (Embeddable Common-Lisp) is an interpreter of the Common-Lisp lan‐
28 guage as described in the X3J13 Ansi specification, featuring CLOS
29 (Common-Lisp Object System), conditions, loops, etc. plus a translator
30 to C, which can produce standalone executables.
31 ECL supports the operating systems Linux, FreeBSD, NetBSD, OpenBSD, OS
33 X, Solaris and Windows, running on top of the Intel, Sparc, Alpha, Pow‐
34 erPC and ARM processors.
35 The current ECL implementation features:
37 · A bytecode compiler and interpreter.
39 · Compiles Lisp also with any C/C++ compiler
41 · Can build standalone executables and libraries
43 · ASDF, Sockets, Gray streams, MOP, and other useful components
45 · Extremely portable
47 · A reasonable license
49 ecl without any argument starts the interactive lisp session.
51
54 -?, --help
55 Shows the help prompt without running the ECL.
56 --norc Do not load configuration files at startup.
58 --version Prints the current version of ECL, without running the ECL.
60 -debug Turned on by default, this enables the debugging in the setup
62 phase, so that you can debug your files.
63 --nodebug Run without debugging setup phase, meaning that errors pre‐
65 vent ECL from starting up.
66 --eval file
68 Evaluate the file before loading the .rc file and starting
69 the Top Level.
70 --shell file
72 Executes the given file and exits, without providing a read-
73 eval-print loop. If you want to use lisp as a scripting lan‐
74 guage, you can write #!/usr/bin/ecl --shell on the first line
75 of the file to be executed, and then ECL will be automati‐
76 cally invoked.
77 --load file
79 Load source file before loading the .rc file and starting the
80 Top Level.
81 --dir directory
83 Use directory as a system directory.
84 --heap-size size
86 Specify heap size in kilobytes.
87 --lisp-stack size
89 Specify stack size in kilobytes for bytecodes interpreter.
90 --frame-stack size
92 Specify frame stack size in kilobytes for runtime control
93 structures.
94 --c-stack size
96 Specify stack size in kilobytes for C compiler.
97 --trap-fpe
99 Make ECL debugger catch floating point exception.
100 --no-trap-fpe
102 Make ECL debugger not catch floating point exception.
103 --encoding encoding
105 Specify the external encoding for standard input, output,
106 trace and error.
107 --input-encoding encoding
109 Specify the external encoding for standard input.
110 --output-encoding encoding
112 Specify the external encoding for standard output.
113 --error-encoding encoding
115 Specify the external encoding for standard error.
116 -o file Provide the output target file for compilation.
119 -c cfile When compiling name the intermediary C file cfile and do not
121 delete it afterwards.
122 -h cfile When compiling name the intermediary C file cfile and do not
124 delete it afterwards.
125 --data [datafile]
127 Dumps compiler data into datafile or, if not supplied, into a
128 file named after the source file, but with .data as exten‐
129 sion.
130 --compile file
132 Translates file to C and invokes the local C compiler to pro‐
133 duce a native code program.
134 -q Short for quiet - produce less notes.
136 --hp This option is deprecated and doesn't do anything.
138 --nodp This option is deprecated and doesn't do anything.
140 -s Produce a linkable object file. It cannot be loaded with
142 load, but it can be used to build libraries or standalone
143 executable programs.
144 AUTHORS
148 The original version was developed by Giuseppe Attardi starting
150 from the Kyoto Common Lisp implementation by Taiichi Yuasa,
151 Masami Hagiya. Further development was lead by Juan Jose Garcia
152 Ripoll. The current maintainer of ECL is Daniel Kochmański, who
153 can be reached at the ECL mailing list.
154
157 ~/.ecl, ~/.eclrc
158 Default initialization files loaded at startup unless the option
159 --norc is provided. (if they exist).
160
163 ANSI
164 The
166
169 Unfortunately it is possible that there are some bugs in the program.
170 In case you find any bug, please report it as an issue (after making
171 sure that it hasn't been reported or fixed) to official gitlab reposi‐
172 tory: https://gitlab.com/embeddable-common-lisp/ecl/issues .
173
176 ECL is free software; you can redistribute it and/or modify it under
177 the terms of the GNU Library General Public License as published by the
178 Free Software Foundation; either version 2 of the License, or (at your
179 option) any later version; see file 'Copying'. This program is dis‐
180 tributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
181 without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
182 PARTICULAR PURPOSE. See the GNU Library General Public License for
183 more details.
184 You should have received a copy of the GNU Library General Public
186 License along with this program; if not, write to the Free Software
187 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
188 Please report bugs, comments, suggestions to the ecl mailing list: ecl-
190 devel@common-lisp.net (or use gitlab).
1914th Berkeley Distribution 2016-09-17 ECL(1)