Wolfram ResearchPRODUCTSPURCHASEFOR USERSCOMPANYOUR SITES
THIS IS DOCUMENTATION FOR AN OBSOLETE PRODUCT.
SEE THE DOCUMENTATION CENTER FOR THE LATEST INFORMATION.

6.3 Command-Line Options

math

The math command starts the kernel from within a shell. The kernel is the part of Mathematica that handles calculations. This commmand is also used by the front end.

Command-Line Options

-initfile file

Specifies the name of a file containing commands to be run on startup.

-lmverbose

Prints diagnostic information to stderr on connecting to the license manager. This is useful for debugging problems related to the license server.

-mathlink

Specifies that the kernel should be run in MathLink mode. See www.wolfram.com/solutions/mathlink for additional information about MathLink.

-noinit

Specifies that no initialization file should be read at startup.

-password str

Specifies a password to use instead of the password or passwords stored in the mathpass file. The password should have the form "!servername" or "machinename mathid licensenumber password".

-pwfile file

Specifies the name of a file that has a valid password.

-run

Takes a command to be run on startup as an argument.

mathematica

The mathematica command runs the X front end. In order for the front end to run, the DISPLAY environment variable must be set and the front end must be able to locate the fonts included with Mathematica.

Command-Line Options

-appHelper

Combines the options -querySingleLaunch and -forceSaveAs. This option is typically used when configuring Mathematica as a helper application for web browsers.

-backgroundTaskDelay

Specifies the time the front end delays background tasks like PostScript rendering when waiting for input. The delay is measured in milliseconds and the default setting is 100.

-best

Tells the front end to use an optimal visual, depth, and colormap combination.

-cleanStart

Tells the front end to ignore caches stored in the directory $UserBaseDirectory/FrontEnd/5.1_Caches, and rebuilds the front end preferences file, $UserBaseDirectory/FrontEnd/init.m. This option can also be abbreviated as -clean.

-copyright

Tells the front end to display copyright information from the command line.

-font f

Specifies the font the front end uses in menus, buttons, and so on. The X program xfontsel can be used to obtain a font name. The font name may be expressed either as an X Logical Font Description or as a valid font alias.

-forceSaveAs

Forces the front end to bring up the Save dialog box when closing a file passed to it on the command line. This option is typically used when configuring Mathematica as a helper application for web browsers.

-help

Prints a listing of all available command-line options.

-lmverbose

Prints diagnostic information to stderr on connecting to the license manager. This is useful for diagnosing problems related to the license server.

-mathlink

Causes the front end to run in MathLink mode. In MathLink mode, the front end runs as a child process that is capable of accepting MathLink packets. This option may be useful when the front end is used as a typesetting or graphics-rendering service.

-noSplashScreen

Prevents the splash screen from being displayed on startup.

-nostderrWindow

Tells the front end not to display stderr messages in a pop-up window.

-nowatchCLIPBOARD

If specified, the X front end does not watch the CLIPBOARD property for change in ownership. The CLIPBOARD property allows items to be shared between X applications via copy and paste commands. If this option is specified, you can only paste items within Mathematica; items pasted into the CLIPBOARD from other applications are ignored.

-preferencesDirectory dir

Specifies the location where preference settings are stored. The default location is ~/.Mathematica.

-primaryModifierMask mask

Specifies the modifier mask to use as the command key. The default is Mod1Mask.

-printCommand command

Specifies a command for sending a file to the printer, such as lpr or lp. This command appears in the Print dialog box.

-pureKeys

Disables key bindings involving modifier keys that are defined by the operating system. This option may need to be given in order for some front end keyboard commands to work correctly. For example, some systems may reserve ControlKeyLeftModified6RightModified for internal use and then the front end cannot use this to typeset superscripts. Key bindings involving the ShiftKey key are not disabled by this option.

-pwfile file

Specifies the name of a file containing a valid password.

-querySingleLaunch

Brings up a dialog box to ask the user if a file specified on the command line should be opened in the currently running front end. The dialog box appears only if the current front end was also launched with the -querySingleLaunch option.

-screenXResolution x

Specifies the horizontal screen resolution of the notebook display in dots per inch. For example, if the default screen resolution is 75 dpi, setting the option to 150 causes the contents of the notebook window to scale horizontally by a factor of two.

-screenYResolution y

Specifies the vertical screen resolution of the notebook display in dots per inch. For example, if the default screen resolution is 75 dpi, setting the option to 150 causes the contents of the notebook window to scale vertically by a factor of two.

-secondaryModifierMask mask

Specifies the modifier mask to use as the option key. The default is Mod2Mask.

-singleLaunch

Allows only one copy of the front end per display. Multiple launches are prevented only if the currently running front end was launched with the -singleLaunch or -querySingleLaunch option.

-topDirectory dir

Specifies the directory in which Mathematica is installed. The default location is /usr/local/Wolfram/Mathematica/5.1.

-version

Prints the current version of the front end from the command line.

-visualChooser

Starts the front end by first putting up the Visual Chooser. This is a dialog box that allows you to specify system parameters such as visual ID, depth, and colormap.

-watchCLIPBOARD

Tells the front end to watch the CLIPBOARD property for change in ownership. This is the default. The CLIPBOARD property allows items to be shared between X applications. If this option is set, then you can paste items into Mathematica from other applications.

-wwwBrowser command

Specifies the command to execute when opening URL links from the front end. The command can include a %s format argument that is replaced with the URL.


Any questions about topics on this page? Click here to get an individual response.Buy NowFree TrialMore Information



 © 2009 Wolfram Research, Inc.  Terms of Use  Privacy Policy |
Sign up for our newsletter: