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 bytecodes interpreter.
90
91       --frame-stack size
92                 Specify frame stack size in  kilobytes  for  runtime  control
93                 structures.
94
95       --c-stack size
96                 Specify stack size in kilobytes for C compiler.
97
98       --trap-fpe
99                 Make ECL debugger catch floating point exception.
100
101       --no-trap-fpe
102                 Make ECL debugger not catch floating point exception.
103
104       --encoding encoding
105                 Specify  the  external  encoding  for standard input, output,
106                 trace and error.
107
108       --input-encoding encoding
109                 Specify the external encoding for standard input.
110
111       --output-encoding encoding
112                 Specify the external encoding for standard output.
113
114       --error-encoding encoding
115                 Specify the external encoding for standard error.
116
117
118       -o file   Provide the output target file for compilation.
119
120       -c cfile  When compiling name the intermediary C file cfile and do  not
121                 delete it afterwards.
122
123       -h cfile  When  compiling name the intermediary C file cfile and do not
124                 delete it afterwards.
125
126       --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
131       --compile file
132                 Translates file to C and invokes the local C compiler to pro‐
133                 duce a native code program.
134
135       -q        Short for quiet - produce less notes.
136
137       --hp      This option is deprecated and doesn't do anything.
138
139       --nodp    This option is deprecated and doesn't do anything.
140
141       -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
145
146
147       AUTHORS
148
149              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
155

FILES

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

SEE ALSO

163       ANSI
164
165       The
166
167

BUGS

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
174

LICENSE

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
185       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
189       Please report bugs, comments, suggestions to the ecl mailing list: ecl-
190       devel@common-lisp.net (or use gitlab).
191
192
193
1944th Berkeley Distribution         2016-09-17                            ECL(1)
Impressum