Command Line Options

A list of GAP's command line options:

Broken

• -U Set compiler options (parsed but ignored)

• -i Set GAP base file (instead of lib/init.g) (GAP never loads if used)

• -N unused, for backward compatibility only

• -X enable/disable CRC checking for compiled modules (parsed but ignored)

• -p enable/disable package output mode -- leads to unreadable corrupted output.

Investigate if they work

• -f force line editing

• -n prevent line editing

• -B current architecture

• -E, --readline disable/enable use of readline library (if possible)

Undocumented, investigate:

• -C : processCompilerArgs

Investigate usefulness

• -x, --width set line width

• -y, --lines set number of lines

• -D enable/disable debugging the loading of files (prints every file GAP reads)

• -M disable/enable loading of compiled modules (disables loading compiled gap library files)

• -e disable/enable quitting on -D

• -g, --gasinfo show GASMAN messages (full/all/no garbage collections)

• -S ThreadUI

• -Z ThreadUI

• -P number of processors

• -G number of GC Threads

Do our memory-related flags need simplifying?

• -m, --minworkspace set the initial workspace size
• -o, --maxworkspace set hint for maximal workspace size (GAP may allocate more)
• -K, --limitworkspace set maximal workspace size (GAP never allocates more)
• -s <mem set the initially mapped virtual memory
• -a set amount to pre-malloc-ate postfix 'k' = 1024, 'm' = 10241024, 'g' = 102410241024

Should we add --addroot, to complement -l/--roots (instead of requiring using ;)

In common use ?

• -h, --help print this help and exit

• -b, --banner disable/enable the banner

• -q, --quiet enable/disable quiet mode

• -r disable/enable user GAP root dir GAPInfo.UserGapRoot

• -A disable/enable autoloading of suggested GAP packages

• -l, --roots set the GAP root paths Directories are separated using ';'. Putting ';' on the start/end of list appends directories to the end/start of existing list of root paths

• -O disable/enable loading of obsolete files

• -T disable/enable break loop

• --quitonbreak quit GAP with non-zero return value instead of entering break loop

• -L restore a saved workspace

• -R prevent restoring of workspace (ignoring -L)

• --prof Run ProfileLineByLine() on GAP start

• --cover Run CoverageLineByLine() on GAP start