gap1
Groups, algorithms and programming
Usage
gap [OPTIONS]
[FILES]
Overview
GAP is a system for computational discrete algebra, with particular emphasis on Computational Group Theory. GAP provides a programming language, a library of thousands of functions implementing algebraic algorithms written in the GAP language as well as large data libraries of algebraic objects. GAP is used in research and teaching for studying groups and their representations, rings, vector spaces, algebras, combinatorial structures, and more.
Startup:
-
-h, --help -
print this help and exit
-
--version -
print the GAP version and exit
-
--print-gaproot -
print the primary GAP root and exit
-
-b, --banner -
disable/enable the banner
-
-c -
<expr> execute the expression <expr>
-
--systemfile -
<file> read this file after 'lib/system.g'
Input/output:
-
-q, --quiet -
enable/disable quiet mode
-
-e -
disable/enable quitting on <ctrl>-D
-
-f -
force line editing
-
-n -
prevent line editing
-
-E, --readline -
disable/enable use of readline library (if possible)
-
-x, --width -
<num> set line width
-
-y, --lines -
<num> set number of lines
-
-p -
enable/disable package output mode (for use by XGAP and similar interfaces)
Memory:
|
(may use postfix 'k' = *1024, 'm' = *1024*1024, |
|
|
'g' = *1024*1024*1024): |
-
-g, --gasinfo -
show GASMAN messages (full/all/no garbage collections) (only available if GAP uses GASMAN)
-
-m, --minworkspace -
<mem> set the initial workspace size
-
-o, --maxworkspace -
<mem> set workspace size where GAP will warn about excessive memory usage (GAP may allocate more) (only available if GAP uses GASMAN)
-
-K, --limitworkspace <mem> -
set maximal workspace size (GAP never allocates more)
-
-s -
<mem> set the initially mapped virtual memory (only available if GAP uses GASMAN)
Roots:
-
-l, --roots -
<paths> set or modify 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
-
-r -
disable/enable user GAP root dir GAPInfo.UserGapRoot
Loading:
-
-A -
disable/enable autoloading of suggested GAP packages
-
-D -
enable/disable debugging the loading of files
-
-M -
disable/enable loading of compiled modules
Error handling, REPL:
-
-T, --nobreakloop -
disable/enable break loop and error traceback
-
--alwaystrace -
always print error traceback (overrides behaviour of
-T)
-
--quitonbreak -
quit GAP with non-zero return value instead of entering break loop
-
--norepl -
Disable the GAP read-evaluate-print loop (REPL)
-
--nointeract -
Start GAP in non-interactive mode (disable REPL and break loop)
Workspaces:
-
(only available if GAP uses GASMAN):
-
-L -
<file> restore a saved workspace
-
-R -
prevent restoring of workspace (ignoring
-L)
Profiling:
-
--prof -
<file> Run ProfileLineByLine(<file>) on GAP start
-
--memprof -
<file> Run ProfileLineByLine(<file>) on GAP start with recordMem := true
-
--cover -
<file> Run CoverageLineByLine(<file>) on GAP start
Internal developer tools
-
-N -
do not use hidden implications
-
-O -
disable/enable loading of obsolete files
-
--bare -
Attempt to start GAP without even needed packages
-
Short boolean options toggle the current value each time they are called. Default actions are indicated first.
Releases
12 releases since Debian 2.0 (Hamm); the text changed 8 times.
--alwaystrace since Debian 10 (Buster);
--banner since Debian 9 (Stretch);
--bare since Debian 11 (Bullseye);
--cover since Debian 9 (Stretch);
--gasinfo since Debian 9 (Stretch);
--help since Debian 9 (Stretch);
--limitworkspace since Debian 9 (Stretch);
--lines since Debian 9 (Stretch);
--maxworkspace since Debian 9 (Stretch);
--memprof since Debian 10 (Buster);
--minworkspace since Debian 9 (Stretch);
--nobreakloop since Debian 10 (Buster);
--nointeract since Debian 10 (Buster);
--norepl since Debian 10 (Buster);
--print-gaproot since Debian 12 (Bookworm);
--prof since Debian 9 (Stretch);
--quiet since Debian 9 (Stretch);
--quitonbreak since Debian 10 (Buster);
--readline since Debian 9 (Stretch);
--roots since Debian 9 (Stretch);
--systemfile since Debian 12 (Bookworm);
--version since Debian 12 (Bookworm);
--width since Debian 9 (Stretch);
-A since Debian 3.1 (Sarge);
-D since Debian 3.1 (Sarge);
-E since Debian 9 (Stretch);
-K since Debian 3.1 (Sarge);
-L since Debian 13 (Trixie);
-M since Debian 3.1 (Sarge);
-N since Debian 3.1 (Sarge);
-O since Debian 9 (Stretch);
-R since Debian 13 (Trixie);
-T since Debian 3.1 (Sarge);
-b since Debian 3.1 (Sarge);
-c since Debian 11 (Bullseye);
-e since Debian 3.1 (Sarge);
-f since Debian 3.1 (Sarge);
-g since Debian 3.1 (Sarge);
-h since Debian 4.0 (Etch);
-l since Debian 3.1 (Sarge);
-m since Debian 3.1 (Sarge);
-n since Debian 3.1 (Sarge);
-o since Debian 3.1 (Sarge);
-p since Debian 9 (Stretch);
-q since Debian 3.1 (Sarge);
-r since Debian 3.1 (Sarge);
-s since Debian 9 (Stretch);
-x since Debian 3.1 (Sarge);
-y since Debian 3.1 (Sarge).
-B until Debian 11 (Bullseye);
-X until Debian 9 (Stretch);
-Y until Debian 8 (Jessie);
-a until Debian 11 (Bullseye);
-i until Debian 9 (Stretch).