doc/newlisp.1

   1 .TH newlisp 1 "January 2008" "version 9.3" "Commandline Parameters"
   2 .SH NAME
   3 newlisp \- lisp like programming language
   4 .SH SYNOPSIS
   5 .B newlisp
   6 [\-h] [\-c | \-C | \-http] [\-s stacksize] [\-m max\-mem\-megabyte] [[\-l path\-file | \-L path\-file] [\-p port\-number | \-d port\-number]] [\-w diectory] [lisp\-files ...] [\-e programtext]
   7 .SH DESCRIPTION
   8 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).
   9 .SH OPTIONS
  10 .TP
  11 \-h
  12 Display a short help text.
  13 .TP
  14 \-c
  15 Suppress the commandline prompt.
  16 .TP
  17 \-C
  18 Force prompt when running newLISP in pipe I/O mode for Emacs.
  19 .TP
  20 \-http
  21 only accept HTTP commands
  22 .TP
  23 \-s stacksize
  24 Stack size to use when starting newLISP. When no stack size is specified the stack defaults to 1024.
  25 .TP
  26 \-m max\-mem\-megabyte
  27 Limits memory to max\-mem\-megabyte megabytes for LISP cell memory.
  28 .TP
  29 lisp\-files
  30 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.
  31 .TP
  32 \-e programtext
  33 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.
  34 .TP
  35 \-w directory
  36 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.
  37 .TP
  38 \-l \-L path\-file
  39 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.
  40 .TP
  41 \-p port\-number
  42 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.
  43 .TP
  44 \-d port\-number
  45 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.
  46
  47 .SH EXAMPLES
  48 .TP
  49 Start interactive session
  50 .B newlisp
  51 .PP
  52 .TP
  53 Excute a program
  54 .B newlisp myprog.lsp
  55 .PP
  56 .TP
  57 Excute a remote program
  58 .B newlisp http://newlisp.org/example.lsp
  59 .PP
  60 .TP
  61 Add 3 and 4, 7 prints on standard output
  62 .B newlisp
  63 \-e "(+ 3 4)"
  64 .PP
  65 .TP
  66 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
  67 .B newlisp
  68 \-p 1234 &
  69 .PP
  70 .TP
  71 newLISP is started as a server for another newlisp process connecting with the net\-eval function or HTTP requests
  72 .B newlisp
  73 \-c \-d 4711 &
  74 .PP
  75 .TP
  76 newLISP is started as a server handling HTTP requests only. Connections are logged to the file /usr/home/www/log.txt
  77 .B newlisp
  78 \-l /usr/home/www/log.txt \-http \-d 8080 &
  79 .PP
  80 .TP
  81 newLISP is started as a server handling HTTP requests and defining the startup/web root directory
  82 .B newlisp
  83 \-http \-d 8080 \-w /usr/home/www/httpdocs &
  84 .TP
  85 When accepting HTTP commands a file httpd.conf can be loaded, which will preprocess the path\-name in the HTTP request
  86 .B newlisp
  87 httpd.conf \-http \-d 8080 \-w /usr/home/www/httpdocs &
  88 .PP
  89 If the file httpd.conf contains:
  90
  91 (define (httpd\-conf path\-name)
  92     (if (ends\-with path\-name ".exe") "errorpage.html" path\-name))
  93
  94 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.
  95 .PP
  96 .SH EXIT STATUS
  97 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.
  98 .SH AUTHOR
  99 Lutz Mueller <lutz@nuevatec.com>
 100
 101 http://newlisp.org/ \- the newLISP home page
 102