gosh (1) - Linux Manuals

gosh: a Scheme script interpreter


gosh - a Scheme script interpreter


gosh [-biqV] [-I path ] [-A path ] [-u module ] [-l file ] [-e expr ] [-E expr ] [-f flag ] [--] [ script argument ... ]


Gosh is a stand-alone Scheme interpreter built on top of the Gauche Scheme implementation.

When script is given, gosh loads the script, evaluating Scheme code in it. Then, if the script defines a procedure named main, gosh calls it with a single argument which is a list of the script name and subsequent arguments. When main returns an integer value, gosh exits with it as an exit code. If main returns non-integer value, or an error is signaled during evaluation, gosh exits with exit code 70 (EX_SOFTWARE). See SRFI-22 (http://srfi.schemers.org/srfi-22/srfi-22.html) for details. If there's no main procedure defined in the script, gosh exits with code 0 after loading the script file.

If no script file is given, gosh goes into an interactive mode. By default, gosh prompts the user to enter a Scheme expression, read and evaluates it, then prints the result, until EOF is read. If the standard input is not a terminal, however, gosh doesn't print a prompt; it allows a user to use gosh as a filter program. This behavior can be controlled by -i or -b option; see below.


Command line options are processed before loading the script file or entering the interactive mode.

The options -I, -A, -u, -l, -e and -E are processed in the order of appearance. For example, adding a load path by -I option affects the -l options after it, but not the ones before it.

Prints gosh version and exits.
Batch mode. Doesn't print prompt even the standard input is a terminal. Supersedes -i.
Interactive mode. Forces to print prompt, even the standard input is not a terminal.
Prevents reading the default initialization file.
Adds path in front of the load path list.
Appends path to the tail of the load path list.
Loads and imports module, as if "(use module )" is specified in the code.
Loads a Scheme file file.
Evaluates a Scheme expression expr.
Same as -e, except that the expr is read as if it is surrounded by parenthesis.
Sets various flags.
  no-inline       don't inline primitive procedures
  no-source-info  don't preserve source information for debug
  load-verbose    report while loading files
  case-fold       uses case-insensitive reader (as in R5RS)
Specifies that there are no more options. If there are more arguments after this, they are taken as script file name and its arguments.


A colon separated list of the load paths. The paths are appended before the system default load paths.
A colon separated list of the load paths for dynamically loaded objects. The paths are appended before the system default load paths.


Shiro Kawai (shiro @ acm . org)



Gauche Scheme interpreter:

For the information about Scheme language, see