## `UNIX` -- MuPAD command line options and initialization files for UNIX

#### Introduction

This help page describes all command line options and initialization files for MuPAD on UNIX platforms.

#### Call(s)

mupad [-g] [-n] [-S] [-v] [-h helppath] [-l libpath] [-L primelimit]
[-m modpath] [-p stacksize] [-P [pPeEsSwW]] [-u userpath]
[-U opts] [-w sec] [file...]
xmupad [-n] [-S] [-v] [-h helppath] [-l libpath] [-L primelimit]
[-m modpath] [-p stacksize] [-P [pPeEsSwW]] [-u userpath]
[-U opts] [-w sec] [file...]

#### Related Functions

`LIBPATH`, `NOTEBOOKFILE`, `NOTEBOOKPATH`, `READPATH`, `TESTPATH`, `UNIX`, `WRITEPATH`

#### Details

- The following table lists all command line options of the terminal version `mupad` and the graphical user interface `xmupad`.

  The option `-g` cannot be set for the X11 front-end, where it is reserved for specifying the window geometry. However, the debug mode can be switched on in the ``Options'' menu of the graphical user interface.

  option | description |
  `-g` | debug mode |
  `-h` | path name for the help index | (default: `$R/share/doc/ascii`)
  `-l` | default library path; can be changed interactively via `LIBPATH` | (default: `$R/share/lib`)
  `-L` | pre-compute a list of all primes up to `primelimit` | (default: 1 000 000)
  `-m` | path name for dynamic modules | (default: `$R/$A/modules`)
  `-n` | do not read the user's initialization file
  `-p` | size of the `PARI` stack in bytes | (default: 250 000)
  `-P` | suppress (`p`) or print (`P`) prompt; can be changed interactively via `Pref::prompt` | (default: `p`)
  | suppress (`e`) or echo (`E`) input; can be changed interactively via `Pref::echo` | (default: `e`)
  | suppress (`w`) or print (`W`) warnings about changes in the new version of MuPAD; can be changed interactively via `Pref::warnChanges` | (default: `w`)
  | start kernel in a more secure mode (`S`) or not (`s`); secure mode restricts file access and forbids the use of the MuPAD command `system` | (default: `s`)
  `-S` | start without printing the MuPAD logo |
  `-u` | path name of the user initialization file | (default: `~/.mupad/`)
  `-U` | pass arbitrary options to the MuPAD session, which can be queried interactively via `Pref::userOptions` | (default: '''')
  `-v` | verbose debug mode |
  `-w` | terminate MuPAD process after at most `sec` seconds |

  `$R` denotes the MuPAD installation directory. `$A` denotes the architecture name returned by the shell script `$R/share/bin/sysinfo`.

  The locations of MuPAD's initialization files are:

  `~/.mupad/userinit.mu` | user initialization file
  `~/.mupad/mxdviRecentFiles` | list of recent documents (help tool)
  `~/.mupad/mxmupadrc` | preferences of the X11 front-end
  `~/.mupad/vcam_defaults` | defaults of the graphics renderer
  `$R/share/lib/sysinit.mu` | system initialization file
  `$R/share/lib/.MMMinit` | MAMMUT initialization file (memory management)

  In addition to the options one or more MuPAD source files `file...` can be given on the command line. They are read in and executed in the given order.

#### Example 1

The following command starts the terminal version of MuPAD, which does not read the user's initialization file (`-n`) and does not display a banner (`-S`), pre-computes and stores all primes up to 2 000 000 (`-L`), and expects to find dynamic modules in the directory `myModules` (`-m`):

    # mupad -n -S -L 2000000 -m myModules
    >>

#### Changes

- The MAMMUT initialization file path, which used to be specified via `-m`, is now the same as the library path.
- The system initialization file path, which used to be specified via `-s`, is now the same as the library path.
- The module path is set with the option `-m` instead of `-d`.
- The kernel trace mode no longer exists, and the option `-t` is obsolete.
- The new warning switch `-P W` was introduced.
- The user's initialization file `~/.mupadinit` was moved to `~/.mupad/userinit.mu`.
- The system initialization file `$R/share/lib/.mupadsysinit` was renamed
  to `$R/share/lib/sysinit.mu`.

Do you have questions or comments?
Copyright © SciFace Software GmbH & Co. KG 2000