NAME

       newlisp - lisp like programming language

SYNOPSIS

       newlisp  [-n]  [-x source target] [-h | -v] [-c | -C | -http] [-t microseconds] [-s stack]
       [-m max-mem-megabyte] [[-l path-file | -L path-file] [-p port-number  |  -d  port-number]]
       [-w directory] [lisp-files ...] [-e programtext]

DESCRIPTION

       Invokes newLISP which first loads init.lsp if present. Then one or more options and one or
       more newLISP source files can be specified. The options and source files are  executed  in
       the  sequence  they  appear.  For  some options is makes sense to have source files loaded
       first like for the -p and -d options. For other options like -s and -m it  is  logical  to
       specify these before the source files to be loaded. If a -e switch is used the programtext
       is evaluated and then newlisp exits otherwise evaluation continues  interactively  (unless
       an exit occurs during lisp-file interpretation).

OPTIONS

       -n     Suppress loading of any init.lsp or .init.lsp initialization file.

       -x source target
              Link the newLISP executable with a source file to built a new target executable.

       -h     Display a short help text.

       -v     Display a version string.

       -c     Suppress the commandline prompt.

       -C     Force prompt when running newLISP in pipe I/O mode for Emacs.

       -http  only accept HTTP commands

       -s stacksize
              Stack  size to use when starting newLISP. When no stack size is specified the stack
              defaults to 1024.

       -m max-mem-megabyte
              Limits memory to max-cell-mem-megabyte megabytes for Lisp cell memory.

       lisp-files
              Load and evaluate the specified lisp source files in sequence. Source files can  be
              specified  using  URLs.  If  an  (exit) is executed by one of the source files then
              newlisp exits and all processing ceases.

       -e programtext
              Programtext is an expression enclosed in quotation marks which is evaluated and the
              result  printed  to  standard  out  device  (STDOUT).  In  most  UNIX system shells
              apostrophes can also be  used  to  delimit  the  expression.  newLISP  exits  after
              evaluation of programtext is complete.

       -w directory
              Directory  is  the  start up directory for newLISP. Any file reference in a program
              will refer to this directory by default as the current directory. This can be  used
              to define a web root directory when in server mode.

       -l -L path-file
              Log  network connections and newLISP I/O to the file in path-file. -l will only log
              network connections or commandline input or net-eval requests. -L will additionally
              log HTTP requests and newLISP output from commandline and net-eval input.

       -p port-number
              Listen  for  commands  on  a TCP/IP socket connection. In this case standard I/O is
              redirected to the port specified in the -p option. Any specified lisp-files will be
              loaded  the  first time a connection is made, that is, before text is accepted from
              the port connection.

       -d port-number
              Run in demon mode. As for the -p option, but newLISP does not exit after  a  closed
              connection and stays in memory listening for a new connection.

       -t microseconds-connection-timeout
              Specifies  a  connection  timeout  when running in -p or -d demon mode. Server will
              disconnect when no further input is read after accepting a client connection.

       -6     Starts newLISP in IPv6 'Internet Protocol version  6'  mode.  Without  this  switch
              newLISP  will  start  in IPv4 mode. The protocol mode can also be switched with the
              built-in 'net-ipv' function during runtime.

EXAMPLES

       Start interactive session
              newlisp

       Execute a program
              newlisp myprog.lsp

       Execute a remote program
              newlisp http://newlisp.org/example.lsp

       Add 3 and 4, 7 prints on standard output
              newlisp -e "(+ 3 4)"

       newLISP is started as a server (the & indicates  to  LINUX  to  run  the  process  in  the
       background) and can be connected to with telnet by issuing telnet localhost 1234
              newlisp -p 1234 &

       newLISP  is  started  as a server for another newlisp process connecting with the net-eval
       function or HTTP requests. Connection timeout is 3 seconds.
              newlisp -c -t 3000000 -d 4711 &

       newLISP is started as a server handling HTTP requests only. Connections are logged to  the
       file /usr/home/www/log.txt
              newlisp -l /usr/home/www/log.txt -http -d 8080 &

       newLISP  is  started  as a server handling HTTP requests and defining the startup/web root
       directory
              newlisp -http -d 8080 -w /usr/home/www/httpdocs &

       When accepting HTTP commands a file httpd.conf can be loaded, which  will  preprocess  the
       path-name in the HTTP request
              newlisp httpd.conf -http -d 8080 -w /usr/home/www/httpdocs &

       If the file httpd.conf contains:

       (command-event (fn (s)
           (local (request)
               (if (find "?" s) ; is this a query
                   (begin
                       (set 'request (first (parse s "?")))
                       ; discover illegal extension in queries
                       (if (ends-with request ".exe")
                           (set 'request "GET /errorpage.html")
                           (set 'request s)))
                   (set 'request s))
               request) ))

       then  all  files  ending  in  .exe will translate the request in to a request for an error
       page, else the original request string is returned.

EXIT STATUS

       newLISP returns a zero exit status for normal termination unless an exit command specifies
       a code to be returned. Non zero is returned in case of abnormal exit.

AUTHOR

       Lutz Mueller <lutz@nuevatec.com>

       http://www.newlisp.org/ - the newLISP home page