1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "ML" "1" "2025-11-25" "5.6.1" "Modules"
.SH NAME
ml \- handy command interface to the Modules package
.SH SYNOPSIS
.sp
\fBml\fP [\fIswitches\fP] [\fIsub\-command\fP [\fIsub\-command\-args\fP]]
.sp
\fBml\fP [\fIswitches\fP] [[\-]\fImodulefile\fP\&...]
.SH DESCRIPTION
.sp
\fBml\fP is a user interface to the Modules package. The Modules package
provides for the dynamic modification of the user\(aqs environment via
\fImodulefiles\fP\&.
.sp
\fBml\fP acts as a shortcut command to the \fBmodule\fP command thus
it supports all the command line switches and module sub\-commands that are
supported by \fBmodule\fP\&.
.sp
\fBml\fP also provides handy shortcuts to list currently loaded
modulefiles, when no argument is provided to \fBml\fP; to load
modulefiles, when modulefile names are passed right after \fBml\fP
command name; to unload modulefiles, when modulefile names prefixed by a minus
sign (\fB\-\fP) are passed right after \fBml\fP command name.
.sp
Multiple modulefiles to load and to unload can be specified on a single
\fBml\fP command line. In this situation unloads are treated first in
specified order, then loads are processed also in specified order (see
\fI\%EXAMPLES\fP section below).
.sp
If an error occurs among either modulefile loads or unloads, command line
processing is stopped and every unloads and loads performed are rolled back.
Conversely, if \fBml\fP is removed from \fI\%abort_on_error\fP
configuration option list or if \fI\%\-\-force\fP option is set, unload and
load sequence continues: already achieved module evaluations are kept and
unload then load sequence is resumed with the remaining modulefiles.
.sp
\fBml\fP command line is parsed first to match every known command line
switches or module sub\-commands. So to load a modulefile via the \fBml\fP
shortcut syntax, modulefile name should not equal a module sub\-command name.
Moreover to unload a modulefile via the \fBml\fP shortcut syntax,
modulefile name should not equal a command line switch short name.
.sp
See the \fI\%DESCRIPTION\fP section in \fI\%module\fP for
the list of supported command line switches and module sub\-commands.
.SH EXAMPLES
.sp
Loading modulefile \fBfoo\fP then look at currently loaded modulefiles:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ml foo
$ ml
Currently Loaded Modulefiles:
1) foo
.EE
.UNINDENT
.UNINDENT
.sp
Unloading modulefile \fBfoo\fP then list modulefiles still loaded:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ml \-foo
$ ml
No Modulefiles Currently Loaded.
.EE
.UNINDENT
.UNINDENT
.sp
Mixing load and unload of modulefiles in a single command. All specified
unloads are processed first then loads are performed:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ ml \-v \-foo bar \-baz qux
Unloading foo
Unloading baz
Loading bar
Loading qux
.EE
.UNINDENT
.UNINDENT
.SH EXIT STATUS
.sp
The \fBml\fP command exits with \fB0\fP if its execution succeed. Elsewhere
\fB1\fP is returned.
.SH ENVIRONMENT
.sp
See the \fI\%ENVIRONMENT\fP section in \fI\%module\fP for
the list of supported environment variables.
.SH SEE ALSO
.sp
\fI\%module\fP, \fI\%modulefile\fP, \fI\%envml\fP
.SH COPYRIGHT
1996-2025, Modules Contributors
.\" Generated by docutils manpage writer.
.
|
