ECLiPSe Command Line Options

The ECLiPSe system has several parameters which may be specified on the command line at invocation time. They are as follows:

-b bootfile

Compile the file bootfile before starting the session.

-e goal

Instead of starting an interactive toplevel-loop, the system will execute the goal goal. goal is given in normal Prolog syntax, and has to be quoted if it contains any characters that would normally be interpreted by the shell. The -e option can be used together with the -b option and is executed afterwards.

The exit status of the ECLiPSe process reflects success or failure of the executed Prolog goal (0 for success, 1 for failure).

-g size

This option specifies to which limit the memory consumption of the ECLiPSe global/trail stack can grow. The size is specified in kilobytes (followed by an optional K), in megabytes (followed by M) or in gigabytes (followed by G). The default is 128M, ie. 128 Megabytes. (On machines that do not support memory mapping, the stacks are pre-allocated and the default size is only 750K).

-l size

This option specifies to which limit the memory consumption of the ECLiPSe local/control stack can grow. The size is specified in kilobytes (followed by an optional K), in megabytes (followed by M) or in gigabytes (followed by G). The default is 128M, ie. 128 Megabytes. (On machines that do not support memory mapping, the stacks are pre-allocated and the default size is only 200K).

-h size

This option specifies to which limit the memory consumption of the ECLiPSe private heap can grow. The size is specified in kilobytes (followed by an optional K), in megabytes (followed by M) or in gigabytes (followed by G). The default is 32M, ie. 32 Megabytes.

-s size

This option specifies to which limit the memory consumption of the ECLiPSe shared heap can grow. The size is specified in kilobytes (followed by an optional K), in megabytes (followed by M) or in gigabytes (followed by G). The default is 64M, ie. 64 Megabytes.

-D directory

This options allows to explicitly specify the ECLiPSe installation directory, i.e. the directory under which the system tries to find the ECLiPSe runtime system and libraries. This option overrides (and renders unnecessary) any setting of the ECLIPSEDIR environment variable (Unix) or, respectively, an ECLIPSEDIR registry entry (Windows) that may be in effect.

- -

The ECLiPSe system will ignore this argument and everything that follows on the commmand line. The Prolog program will only see the part of the command line that follows this argument.