<?xml version="1.0" encoding="utf-8" ?> <!-- for emacs: -*- coding: utf-8 -*- -->
<!-- Apache may like this line in the file .htaccess: AddCharset utf-8 .html -->
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN" "http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg-flat.dtd" >
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
<head><title>Invoking the program</title>
<link rel="stylesheet" type="text/css" href="../../../../Macaulay2/Style/doc.css"/>
</head>
<body>
<table class="buttons">
<tr>
<td><div><a href="_irreducible__Characteristic__Series.html">next</a> | <a href="___Inverses.html">previous</a> | <a href="_irreducible__Characteristic__Series.html">forward</a> | <a href="___Inverses.html">backward</a> | up | <a href="index.html">top</a> | <a href="master.html">index</a> | <a href="toc.html">toc</a> | <a href="http://www.math.uiuc.edu/Macaulay2/">Macaulay2 web site</a></div>
</td>
</tr>
</table>
<hr/>
<div><h1>Invoking the program</h1>
<div>On systems with a command line interface, the following commands can be used to start the program. When the program starts up, the <a href="_initialization_spfile.html" title="">initialization file</a>, <tt>init.m2</tt>, will be loaded.<p/>
<tt>M2</tt> -- starts the program.<p/>
<tt>M2 file1 file2 ... </tt> -- starts the program, reading and executing the specified files.<p/>
The options that can be provided on the command line may be displayed by running <tt>M2 --help</tt>, as follows.<table class="examples"><tr><td><pre>i1 : run "M2 --help";
usage:
M2 [option ...] [file ...]
options:
--help print this brief help message and exit
--no-backtrace print no backtrace after error
--copyright display full copyright messasge
--no-debug do not enter debugger upon error
--dumpdata read source code, dump data if so configured, exit (no init.m2)
--no-loaddata don't try to load the dumpdata file
--int don't handle interrupts
--notify notify when loading files during initialization
and when evaluating command line arguments
--no-prompts print no input prompts
--no-readline don't use readline
--no-setup don't try to load setup.m2 or to loaddata
--no-personality don't set the personality and re-exec M2 (linux only)
--prefix DIR set prefixDirectory
--print-width n set printWidth=n (the default is the window width)
--restarted used internally to indicate this is a restart
--script as first argument, interpret second argument as name of a script
implies --stop, --no-debug, --silent and -q
see scriptCommandLine
--silent no startup banner
--stop exit on error
--texmacs TeXmacs session mode
--version print version number and exit
-q don't load user's init.m2 file or use packages in home directory
-E '...' evaluate expression '...' before initialization
-e '...' evaluate expression '...' after initialization
--top-srcdir '...' add top source or build tree '...' to initial path
environment:
M2ARCH a hint to find the dumpdata file as
bin/../cache/Macaulay2-$M2ARCH-data, where bin is the
directory containing the Macaulay2 executable
EDITOR default text editor
LOADDATA_IGNORE_CHECKSUMS (loaddata: disable verification of memory map checksums)
COMPAREVDSO (loaddata: enable verification for the vdso segment)
LOADDATA_DEBUG (loaddata: verbose debugging messages)</pre>
</td></tr>
</table>
<p/>
To terminate the program, one may type <a href="_exit.html" title="exit the program">exit</a>, <a href="_quit.html" title="quit the program">quit</a>, <a href="_end.html" title="stop loading a file">end</a>, or the end of file character.</div>
<div class="single"><h2>See also</h2>
<ul><li><span><a href="_prefix__Directory.html" title="the prefix directory">prefixDirectory</a> -- the prefix directory</span></li>
<li><span><a href="_prefix__Path.html" title="absolute locations of Macaulay2 files">prefixPath</a> -- absolute locations of Macaulay2 files</span></li>
</ul>
</div>
</div>
</body>
</html>
