1ECL(1)                      General Commands Manual                     ECL(1)
2
3
4

NAME

6       ecl - Embeddable Common Lisp
7

SYNOPSIS

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
24
25

DESCRIPTION

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
32       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
36       The current ECL implementation features:
37
38       ·      A bytecode compiler and interpreter.
39
40       ·      Compiles Lisp also with any C/C++ compiler
41
42       ·      Can build standalone executables and libraries
43
44       ·      ASDF, Sockets, Gray streams, MOP, and other useful components
45
46       ·      Extremely portable
47
48       ·      A reasonable license
49
50       ecl without any argument starts the interactive lisp session.
51
52

OPTIONS

54       -?, --help
55                 Shows the help prompt without running the ECL.
56
57       --norc    Do not load configuration files at startup.
58
59       --version Prints the current version of ECL, without running the ECL.
60
61       -debug    Turned on by default, this enables the debugging in the setup
62                 phase, so that you can debug your files.
63
64       --nodebug Run  without  debugging setup phase, meaning that errors pre‐
65                 vent ECL from starting up.
66
67       --eval file
68                 Evaluate the file before loading the .rc  file  and  starting
69                 the Top Level.
70
71       --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
78       --load file
79                 Load source file before loading the .rc file and starting the
80                 Top Level.
81
82       --dir directory
83                 Use directory as a system directory.
84
85       --heap-size size
86                 Specify heap size in kilobytes.
87
88       --lisp-stack size
89                 Specify stack size in kilobytes for lisp system.
90
91       --frame-stack size
92                 Specify frame stack size in kilobytes.
93
94       --c-stack size
95                 Specify stack size in kilobytes for C compiler.
96
97       --trap-fpe
98                 Make ECL debugger catch floating point exception.
99
100       --no-trap-fpe
101                 Make ECL debugger not catch floating point exception.
102
103       --encoding encoding
104                 Specify the external encoding  for  standard  input,  output,
105                 trace and error.
106
107       --input-encoding encoding
108                 Specify the external encoding for standard input.
109
110       --output-encoding encoding
111                 Specify the external encoding for standard output.
112
113       --error-encoding encoding
114                 Specify the external encoding for standard error.
115
116
117       -o file   Provide the output target file for compilation.
118
119       -c cfile  When  compiling name the intermediary C file cfile and do not
120                 delete it afterwards.
121
122       -h cfile  When compiling name the intermediary C file cfile and do  not
123                 delete it afterwards.
124
125       --data [datafile]
126                 Dumps compiler data into datafile or, if not supplied, into a
127                 file named after the source file, but with  .data  as  exten‐
128                 sion.
129
130       --compile file
131                 Translates file to C and invokes the local C compiler to pro‐
132                 duce a native code program.
133
134       -q        Short for quiet - produce less notes.
135
136       --hp      This option is deprecated and doesn't do anything.
137
138       --nodp    This option is deprecated and doesn't do anything.
139
140       -s        Produce a linkable object file.  It  cannot  be  loaded  with
141                 load,  but  it  can  be used to build libraries or standalone
142                 executable programs.
143
144
145
146       AUTHORS
147
148              The original version was developed by Giuseppe Attardi  starting
149              from  the  Kyoto  Common  Lisp  implementation by Taiichi Yuasa,
150              Masami Hagiya. Further development was lead by Juan Jose  Garcia
151              Ripoll.  The current maintainer of ECL is Daniel Kochmański, who
152              can be reached at the ECL mailing list.
153
154

FILES

156       ~/.ecl, ~/.eclrc
157              Default initialization files loaded at startup unless the option
158              --norc is provided.  (if they exist).
159
160

SEE ALSO

162       ANSI
163
164       The
165
166

BUGS

168       Unfortunately  it  is possible that there are some bugs in the program.
169       In case you find any bug, please report it as an  issue  (after  making
170       sure  that it hasn't been reported or fixed) to official gitlab reposi‐
171       tory: https://gitlab.com/embeddable-common-lisp/ecl/issues .
172
173

LICENSE

175       ECL is free software; you can redistribute it and/or  modify  it  under
176       the terms of the GNU Library General Public License as published by the
177       Free Software Foundation; either version 2 of the License, or (at  your
178       option)  any  later  version; see file 'Copying'.  This program is dis‐
179       tributed in the hope that it will be useful, but WITHOUT ANY  WARRANTY;
180       without  even  the implied warranty of MERCHANTABILITY or FITNESS FOR A
181       PARTICULAR PURPOSE.  See the GNU Library  General  Public  License  for
182       more details.
183
184       You  should  have  received  a  copy  of the GNU Library General Public
185       License along with this program; if not, write  to  the  Free  Software
186       Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
187
188       Please report bugs, comments, suggestions to the ecl mailing list: ecl-
189       devel@common-lisp.net (or use gitlab).
190
191
192
1934th Berkeley Distribution         2016-09-17                            ECL(1)
Impressum