Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ecl(1)			     General Commands Manual			  ecl(1)

NAME
     ecl -- Embeddable Common Lisp

SYNOPSIS
     ecl [-? | --help]	[-v | --version] [--debug | --nodebug]
     [--dir dir] [--load file] [--shell file] [--eval expr] [--rc | --norc]
     [--c-stack size] [--lisp-stack size] [--heap-size size]
     [--frame-stack size]
     [[-o ofile] [-c [cfile]] [-h [hfile]] [--data [datafile]] [-s] [-q]
      --compile file]
     [[-o ofile] --link file+]
     [--input-encoding external-format] [--output-encoding external-format]
     [--error-encoding external-format] [--encoding external-format]
     [--trap-fpe | --no-trap-fpe]

DESCRIPTION
     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:

     *	    A bytecode compiler and interpreter.

     *	    Compiles Lisp also with any C/C++ compiler

     *	    Can build standalone executables and libraries

     *	    ASDF, Sockets, Gray streams, MOP, and other useful components

     *	    Extremely portable

     *	    A reasonable license

     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 ex-
	ecuted, 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 kilobytes for C compiler.

     --lisp-stack size
	Set stack size in kilobytes for bytecodes interpreter.

     --heap-stack size
	Set heap size in kilobytes.

     --frame-stack size
	Set frame size in kilobytes 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 na-
	tive 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 er-
	ror.

     --trap-fpe
	Make ECL debugger catch floating point exception.

     --no-trap-fpe
	Disable ECL debugger floating point exception catching.

AUTHORS
     The original version was developed by Giuseppe Attardi  starting  from  the
     Kyoto  Common  Lisp implementation by Taiichi Yuasa, Masami Hagiya. Further
     development was lead by Juan Jose Garcia Ripoll.  The  current  maintainers
     of ECL are Daniel KochmaAski and Marius Gerbershagen, who can be reached at
     the ECL mailing list.

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

SEE ALSO
	    ANSI Common Lisp standard X3.226-1994

	    The Common Lisp HyperSpec

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

LICENSE
     This library is free software; you can redistribute it and/or modify it un-
     der the terms of the GNU Lesser General Public License as published by  the
     Free  Software  Foundation;  either version 2.1 of the License, or (at your
     option) any later version.

     This library is distributed in the hope that it will be useful, but WITHOUT
     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or  FIT-
     NESS  FOR	A PARTICULAR PURPOSE.  See the GNU Lesser General Public License
     for more details.

     You should have received a copy of the GNU Lesser	General  Public  License
     along  with  this	library;  if not, write to the Free Software Foundation,
     Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA

     Please  report  bugs,  comments,  suggestions  to	the  ecl  mailing  list:
     ecl-devel@common-lisp.net (or use gitlab).

				   2021-02-01				  ecl(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ecl&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help