1MODULE(1) Modules MODULE(1)
2
3
4
6 module - command interface to the Modules package
7
9 module [switches] [sub-command [sub-command-args]]
10
12 module is a user interface to the Modules package. The Modules package
13 provides for the dynamic modification of the user's environment via
14 modulefiles.
15
16 Each modulefile contains the information needed to configure the shell
17 for an application. Once the Modules package is initialized, the envi‐
18 ronment can be modified on a per-module basis using the module command
19 which interprets modulefiles. Typically modulefiles instruct the module
20 command to alter or set shell environment variables such as PATH, MAN‐
21 PATH, etc. Modulefiles may be shared by many users on a system and
22 users may have their own set to supplement or replace the shared mod‐
23 ulefiles.
24
25 The modulefiles are added to and removed from the current environment
26 by the user. The environment changes contained in a modulefile can be
27 summarized through the module command as well. If no arguments are
28 given, a summary of the module usage and sub-commands are shown.
29
30 The action for the module command to take is described by the sub-com‐
31 mand and its associated arguments.
32
33 Package Initialization
34 The Modules package and the module command are initialized when a
35 shell-specific initialization script is sourced into the shell. The
36 script creates the module command as either an alias or function and
37 creates Modules environment variables.
38
39 The module alias or function executes the modulecmd.tcl program located
40 in /usr/share/Modules/libexec and has the shell evaluate the command's
41 output. The first argument to modulecmd.tcl specifies the type of
42 shell.
43
44 The initialization scripts are kept in /usr/share/Modules/init/<shell>
45 where <shell> is the name of the sourcing shell. For example, a C Shell
46 user sources the /usr/share/Modules/init/csh script. The sh, csh, tcsh,
47 bash, ksh, zsh and fish shells are supported by modulecmd.tcl. In addi‐
48 tion, python, perl, ruby, tcl, cmake, r and lisp "shells" are supported
49 which writes the environment changes to stdout as python, perl, ruby,
50 tcl, lisp, r or cmake code.
51
52 Initialization may also be performed by calling the autoinit sub-com‐
53 mand of the modulecmd.tcl program. Evaluation into the shell of the
54 result of this command defines the module alias or function.
55
56 Examples of initialization
57 C Shell initialization (and derivatives):
58
59 source /usr/share/Modules/init/csh
60 module load modulefile modulefile ...
61
62 Bourne Shell (sh) (and derivatives):
63
64 . /usr/share/Modules/init/sh
65 module load modulefile modulefile ...
66
67 Perl:
68
69 require "/usr/share/Modules/init/perl.pm";
70 &module('load', 'modulefile', 'modulefile', '...');
71
72 Python:
73
74 import os
75 exec(open('/usr/share/Modules/init/python.py').read())
76 module('load', 'modulefile', 'modulefile', '...')
77
78 Bourne Shell (sh) (and derivatives) with autoinit sub-command:
79
80 eval "`/usr/share/Modules/libexec/modulecmd.tcl sh autoinit`"
81
82 Modulecmd startup
83 Upon invocation modulecmd.tcl sources if it exists a site-specific con‐
84 figuration script located in /usr/share/Modules/etc/siteconfig.tcl.
85 This Tcl script enables to supersede any global variable or procedure
86 definition of modulecmd.tcl.
87
88 Afterward, modulecmd.tcl sources rc files which contain global, user
89 and modulefile specific setups. These files are interpreted as module‐
90 files. See modulefile(4) for detailed information.
91
92 Upon invocation of modulecmd.tcl module run-command files are sourced
93 in the following order:
94
95 1. Global RC file as specified by $MODULERCFILE or /usr/share/Mod‐
96 ules/etc/rc. If $MODULERCFILE points to a directory, the modulerc
97 file in this directory is used as global RC file.
98
99 2. User specific module RC file $HOME/.modulerc
100
101 3. All .modulerc and .version files found during modulefile seeking.
102
103 Command line switches
104 The module command accepts command line switches as its first parame‐
105 ter. These may be used to control output format of all information
106 displayed and the module behavior in case of locating and interpreting
107 modulefiles.
108
109 All switches may be entered either in short or long notation. The fol‐
110 lowing switches are accepted:
111
112 --help, -h
113 Give some helpful usage information, and terminates the command.
114
115 --version, -V
116 Lists the current version of the module command. The command then
117 terminates without further processing.
118
119 --debug, -D
120 Debug mode. Causes module to print debugging messages about its
121 progress.
122
123 --paginate
124 Pipe all message output into less (or if set, $MODULES_PAGER) if
125 error output stream is a terminal. See also MODULES_PAGER section.
126
127 --no-pager
128 Do not pipe message output into a pager.
129
130 --auto
131 On load, unload and switch sub-commands, enable automated module
132 handling mode. See also MODULES_AUTO_HANDLING section.
133
134 --no-auto
135 On load, unload and switch sub-commands, disable automated module
136 handling mode. See also MODULES_AUTO_HANDLING section.
137
138 --force, -f
139 On load, unload and switch sub-commands, by-pass any unsatisfied
140 modulefile constraint corresponding to the declared prereq and con‐
141 flict. Which means for instance that a modulefile will be loaded
142 even if it comes in conflict with another loaded modulefile or that
143 a modulefile will be unloaded even if it is required as a prereq by
144 another modulefile.
145
146 --terse, -t
147 Display avail, list and savelist output in short format.
148
149 --long, -l
150 Display avail, list and savelist output in long format.
151
152 --default, -d
153 On avail sub-command, display only the default version of each mod‐
154 ule name. Default version is either the explicitly set default ver‐
155 sion or the highest numerically sorted modulefile if no default ver‐
156 sion set (see Locating Modulefiles section in the modulefile(4) man
157 page).
158
159 --latest, -L
160 On avail sub-command, display only the highest numerically sorted
161 version of each module name (see Locating Modulefiles section in the
162 modulefile(4) man page).
163
164 Module Sub-Commands
165 help [modulefile...]
166 Print the usage of each sub-command. If an argument is given, print
167 the Module-specific help information for the modulefile.
168
169 add modulefile...
170 See load.
171
172 load [--auto|--no-auto] [-f] modulefile...
173 Load modulefile into the shell environment.
174
175 rm modulefile...
176 See unload.
177
178 unload [--auto|--no-auto] [-f] modulefile...
179 Remove modulefile from the shell environment.
180
181 swap [modulefile1] modulefile2
182 See switch.
183
184 switch [--auto|--no-auto] [-f] [modulefile1] modulefile2
185 Switch loaded modulefile1 with modulefile2. If modulefile1 is not
186 specified, then it is assumed to be the currently loaded module with
187 the same root name as modulefile2.
188
189 show modulefile...
190 See display.
191
192 display modulefile...
193 Display information about one or more modulefiles. The display
194 sub-command will list the full path of the modulefile and the envi‐
195 ronment changes the modulefile will make if loaded. (Note: It will
196 not display any environment changes found within conditional state‐
197 ments.)
198
199 list [-t|-l]
200 List loaded modules.
201
202 avail [-d|-L] [-t|-l] [path...]
203 List all available modulefiles in the current MODULEPATH. All direc‐
204 tories in the MODULEPATH are recursively searched for files contain‐
205 ing the modulefile magic cookie. If an argument is given, then each
206 directory in the MODULEPATH is searched for modulefiles whose path‐
207 name, symbolic version-name or alias match the argument. Argument
208 may contain wildcard characters. Multiple versions of an application
209 can be supported by creating a subdirectory for the application con‐
210 taining modulefiles for each version.
211
212 Symbolic version-names and aliases found in the search are displayed
213 in the result of this sub-command. Symbolic version-names are dis‐
214 played next to the modulefile they are assigned to within parenthe‐
215 sis. Aliases are listed in the MODULEPATH section where they have
216 been defined. To distinguish aliases from modulefiles a @ symbol is
217 added within parenthesis next to their name. Aliases defined through
218 a global or user specific module RC file are listed under the
219 global/user modulerc section.
220
221 aliases
222 List all available symbolic version-names and aliases in the current
223 MODULEPATH. All directories in the MODULEPATH are recursively
224 searched in the same manner than for the avail sub-command. Only the
225 symbolic version-names and aliases found in the search are dis‐
226 played.
227
228 use [-a|--append] directory...
229 Prepend one or more directories to the MODULEPATH environment vari‐
230 able. The --append flag will append the directory to MODULEPATH.
231
232 Reference counter environment variable MODULEPATH_modshare is also
233 set to increase the number of times directory has been added to MOD‐
234 ULEPATH.
235
236 unuse directory...
237 Remove one or more directories from the MODULEPATH environment vari‐
238 able if reference counter of these directories is equal to 1 or
239 unknown.
240
241 Reference counter of directory in MODULEPATH denotes the number of
242 times directory has been enabled. When attempting to remove direc‐
243 tory from MODULEPATH, reference counter variable MODULEPATH_modshare
244 is checked and directory is removed only if its relative counter is
245 equal to 1 or not defined. Elsewhere directory is kept and reference
246 counter is decreased by 1.
247
248 refresh
249 See reload.
250
251 reload
252 Unload then load all loaded modulefiles.
253
254 No unload then load is performed and an error is returned if the
255 loaded modulefiles have unsatisfied constraint corresponding to the
256 prereq and conflict they declare.
257
258 purge
259 Unload all loaded modulefiles.
260
261 source modulefile...
262 Execute modulefile into the shell environment. modulefile must be
263 specified with a fully qualified path. Once executed modulefile is
264 not marked loaded in shell environment which differ from load
265 sub-command.
266
267 whatis [modulefile...]
268 Display the information set up by the module-whatis commands inside
269 the specified modulefiles. These specified modulefiles may be
270 expressed using wildcard characters. If no modulefile is specified,
271 all module-whatis lines will be shown.
272
273 apropos string
274 See search.
275
276 keyword string
277 See search.
278
279 search string
280 Seeks through the module-whatis informations of all modulefiles for
281 the specified string. All module-whatis informations matching the
282 string will be displayed. string may contain wildcard characters.
283
284 test modulefile...
285 Execute and display results of the Module-specific tests for the
286 modulefile.
287
288 save [collection]
289 Record the currently set MODULEPATH directory list and the currently
290 loaded modulefiles in a collection file under the user's collection
291 directory $HOME/.module. If collection name is not specified, then
292 it is assumed to be the default collection. If collection is a fully
293 qualified path, it is saved at this location rather than under the
294 user's collection directory.
295
296 If MODULES_COLLECTION_TARGET is set, a suffix equivalent to the
297 value of this variable will be appended to the collection file name.
298
299 By default, if loaded modulefile corresponds to the default module
300 version, the bare module name is recorded. If MODULES_COLLEC‐
301 TION_PIN_VERSION is set to 1, module version is always recorded even
302 if it is the default version.
303
304 No collection is recorded and an error is returned if the loaded
305 modulefiles have unsatisfied constraint corresponding to the prereq
306 and conflict they declare.
307
308 restore [collection]
309 Restore the environment state as defined in collection. If collec‐
310 tion name is not specified, then it is assumed to be the default
311 collection. If collection is a fully qualified path, it is restored
312 from this location rather than from a file under the user's collec‐
313 tion directory. If MODULES_COLLECTION_TARGET is set, a suffix equiv‐
314 alent to the value of this variable is appended to the collection
315 file name to restore.
316
317 When restoring a collection, the currently set MODULEPATH directory
318 list and the currently loaded modulefiles are unused and unloaded
319 then used and loaded to exactly match the MODULEPATH and loaded mod‐
320 ulefiles lists saved in this collection file. The order of the paths
321 and modulefiles set in collection is preserved when restoring. It
322 means that currently loaded modules are unloaded to get the same
323 LOADEDMODULES root than collection and currently used module paths
324 are unused to get the same MODULEPATH root. Then missing module
325 paths are used and missing modulefiles are loaded.
326
327 saverm [collection]
328 Delete the collection file under the user's collection directory. If
329 collection name is not specified, then it is assumed to be the
330 default collection. If MODULES_COLLECTION_TARGET is set, a suffix
331 equivalent to the value of this variable will be appended to the
332 collection file name.
333
334 saveshow [collection]
335 Display the content of collection. If collection name is not speci‐
336 fied, then it is assumed to be the default collection. If collection
337 is a fully qualified path, this location is displayed rather than a
338 collection file under the user's collection directory. If MOD‐
339 ULES_COLLECTION_TARGET is set, a suffix equivalent to the value of
340 this variable will be appended to the collection file name.
341
342 savelist [-t|-l]
343 List collections that are currently saved under the user's collec‐
344 tion directory. If MODULES_COLLECTION_TARGET is set, only collec‐
345 tions matching the target suffix will be displayed.
346
347 initadd modulefile...
348 Add modulefile to the shell's initialization file in the user's home
349 directory. The startup files checked (in order) are:
350
351 C Shell
352 .modules, .cshrc, .csh_variables and .login
353
354 TENEX C Shell
355 .modules, .tcshrc, .cshrc, .csh_variables and .login
356
357 Bourne and Korn Shells
358 .modules, .profile
359
360 GNU Bourne Again Shell
361 .modules, .bash_profile, .bash_login, .profile and .bashrc
362
363 Z Shell
364 .modules, .zshrc, .zshenv and .zlogin
365
366 Friendly Interactive Shell
367 .modules, .config/fish/config.fish
368
369 If a module load line is found in any of these files, the module‐
370 files are appended to any existing list of modulefiles. The module
371 load line must be located in at least one of the files listed above
372 for any of the init sub-commands to work properly. If the module
373 load line is found in multiple shell initialization files, all of
374 the lines are changed.
375
376 initprepend modulefile...
377 Does the same as initadd but prepends the given modules to the
378 beginning of the list.
379
380 initrm modulefile...
381 Remove modulefile from the shell's initialization files.
382
383 initswitch modulefile1 modulefile2
384 Switch modulefile1 with modulefile2 in the shell's initialization
385 files.
386
387 initlist
388 List all of the modulefiles loaded from the shell's initialization
389 file.
390
391 initclear
392 Clear all of the modulefiles from the shell's initialization files.
393
394 path modulefile
395 Print path to modulefile.
396
397 paths modulefile
398 Print path of available modulefiles matching argument.
399
400 append-path [-d C|--delim C|--delim=C] [--duplicates] variable value...
401 Append value to environment variable. The variable is a colon, or
402 delimiter, separated list. See append-path in the modulefile(4) man
403 page for further explanation.
404
405 prepend-path [-d C|--delim C|--delim=C] [--duplicates] variable
406 value...
407 Prepend value to environment variable. The variable is a colon, or
408 delimiter, separated list. See prepend-path in the modulefile(4) man
409 page for further explanation.
410
411 remove-path [-d C|--delim C|--delim=C] [--index] variable value...
412 Remove value from the colon, or delimiter, separated list in envi‐
413 ronment variable. See remove-path in the modulefile(4) man page for
414 further explanation.
415
416 is-loaded [modulefile...]
417 Returns a true value if any of the listed modulefiles has been
418 loaded or if any modulefile is loaded in case no argument is pro‐
419 vided. Returns a false value elsewhere. See is-loaded in the module‐
420 file(4) man page for further explanation.
421
422 is-saved [collection...]
423 Returns a true value if any of the listed collections exists or if
424 any collection exists in case no argument is provided. Returns a
425 false value elsewhere. See is-saved in the modulefile(4) man page
426 for further explanation.
427
428 is-used [directory...]
429 Returns a true value if any of the listed directories has been
430 enabled in MODULEPATH or if any directory is enabled in case no
431 argument is provided. Returns a false value elsewhere. See is-used
432 in the modulefile(4) man page for further explanation.
433
434 is-avail modulefile...
435 Returns a true value if any of the listed modulefiles exists in
436 enabled MODULEPATH. Returns a false value elsewhere. See is-avail in
437 the modulefile(4) man page for further explanation.
438
439 info-loaded modulefile
440 Returns the names of currently loaded modules matching passed mod‐
441 ulefile. Returns an empty string if passed modulefile does not
442 match any loaded modules. See module-info loaded in the module‐
443 file(4) man page for further explanation.
444
445 Modulefiles
446 modulefiles are written in the Tool Command Language (Tcl) and are
447 interpreted by modulecmd.tcl. modulefiles can use conditional state‐
448 ments. Thus the effect a modulefile will have on the environment may
449 change depending upon the current state of the environment.
450
451 Environment variables are unset when unloading a modulefile. Thus, it
452 is possible to load a modulefile and then unload it without having the
453 environment variables return to their prior state.
454
455 Collections
456 Collections describe a sequence of module use then module load commands
457 that are interpreted by modulecmd.tcl to set the user environment as
458 described by this sequence. When a collection is activated, with the
459 restore sub-command, module paths and loaded modules are unused or
460 unloaded if they are not part or if they are not ordered the same way
461 as in the collection.
462
463 Collections are generated by the save sub-command that dumps the cur‐
464 rent user environment state in terms of module paths and loaded mod‐
465 ules. By default collections are saved under the $HOME/.module direc‐
466 tory.
467
468 Collections may be valid for a given target if they are suffixed. In
469 this case these collections can only be restored if their suffix corre‐
470 spond to the current value of the MODULES_COLLECTION_TARGET environment
471 variable (see the dedicated section of this topic below).
472
474 The module command exits with 0 if its execution succeed. Elsewhere 1
475 is returned.
476
478 LOADEDMODULES
479 A colon separated list of all loaded modulefiles.
480
481 MODULEPATH
482 The path that the module command searches when looking for module‐
483 files. Typically, it is set to the master modulefiles directory,
484 /usr/share/Modules/modulefiles, by the initialization script. MOD‐
485 ULEPATH can be set using module use or by the module initialization
486 script to search group or personal modulefile directories before or
487 after the master modulefile directory.
488
489 Path elements registered in the MODULEPATH environment variable may
490 contain reference to environment variables which are converted to
491 their corresponding value by module command each time it looks at
492 the MODULEPATH value. If an environment variable referred in a path
493 element is not defined, its reference is converted to an empty
494 string.
495
496 MODULESHOME
497 The location of the master Modules package file directory containing
498 module command initialization scripts, the executable program mod‐
499 ulecmd.tcl, and a directory containing a collection of master mod‐
500 ulefiles.
501
502 MODULES_AUTO_HANDLING
503 If set to 1, enable automated module handling mode. If set to 0 dis‐
504 able automated module handling mode. Other values are ignored.
505
506 Automated module handling mode consists in additional actions trig‐
507 gered when loading or unloading a modulefile to satisfy the con‐
508 straints it declares. When loading a modulefile, following actions
509 are triggered:
510
511 · Requirement Load: load of the modulefiles declared as a prereq of
512 the loading modulefile.
513
514 · Dependent Reload: reload of the modulefiles declaring a prereq
515 onto loaded modulefile or declaring a prereq onto a modulefile
516 part of this reloading batch.
517
518 When unloading a modulefile, following actions are triggered:
519
520 · Dependent Unload: unload of the modulefiles declaring a
521 non-optional prereq onto unloaded modulefile or declaring a
522 non-optional prereq onto a modulefile part of this unloading
523 batch. A prereq modulefile is considered optional if the prereq
524 definition order is made of multiple modulefiles and at least one
525 alternative modulefile is loaded.
526
527 · Useless Requirement Unload: unload of the prereq modulefiles that
528 have been automatically loaded for either the unloaded modulefile,
529 an unloaded dependent modulefile or a modulefile part of this use‐
530 less requirement unloading batch. Modulefiles are added to this
531 unloading batch only if they are not required by any other loaded
532 modulefiles.
533
534 · Dependent Reload: reload of the modulefiles declaring a conflict
535 or an optional prereq onto either the unloaded modulefile, an
536 unloaded dependent or an unloaded useless requirement or declaring
537 a prereq onto a modulefile part of this reloading batch.
538
539 In case a loaded modulefile has some of its declared constraints
540 unsatisfied (pre-required modulefile not loaded or conflicting mod‐
541 ulefile loaded for instance), this loaded modulefile is excluded
542 from the automatic reload actions described above.
543
544 For the specific case of the switch sub-command, where a modulefile
545 is unloaded to then load another modulefile. Dependent modulefiles
546 to Unload are merged into the Dependent modulefiles to Reload that
547 are reloaded after the load of the switched-to modulefile.
548
549 Automated module handling mode enablement is defined in the follow‐
550 ing order of preference: --auto/--no-auto command line switches,
551 then MODULES_AUTO_HANDLING environment variable, then the default
552 set in modulecmd.tcl script configuration. Which means MOD‐
553 ULES_AUTO_HANDLING overrides default configuration and
554 --auto/--no-auto command line switches override every other ways to
555 enable or disable this mode.
556
557 MODULES_CMD
558 The location of the active module command script.
559
560 MODULES_COLLECTION_PIN_VERSION
561 If set to 1, register exact version number of modulefiles when sav‐
562 ing a collection. Elsewhere modulefile version number is omitted if
563 it corresponds to the implicit or explicitly set default version.
564
565 MODULES_COLLECTION_TARGET
566 The collection target that determines what collections are valid
567 thus reachable on the current system.
568
569 Collection directory may sometimes be shared on multiple machines
570 which may use different modules setup. For instance modules users
571 may access with the same HOME directory multiple systems using dif‐
572 ferent OS versions. When it happens a collection made on machine 1
573 may be erroneous on machine 2.
574
575 When a target is set, only the collections made for that target are
576 available to the restore, savelist, saveshow and saverm sub-com‐
577 mands. Saving collection registers the target footprint by suffixing
578 the collection filename with .$MODULES_COLLECTION_TARGET. Collection
579 target is not involved when collection is specified as file path on
580 the saveshow, restore and save sub-commands.
581
582 For example, the MODULES_COLLECTION_TARGET variable may be set with
583 results from commands like lsb_release, hostname, dnsdomainname,
584 etc.
585
586 MODULES_LMALTNAME
587 A colon separated list of the alternative names set through mod‐
588 ule-version and module-alias statements corresponding to all loaded
589 modulefiles. Each element in this list starts by the name of the
590 loaded modulefile followed by all alternative names resolving to it.
591 The loaded modulefile and its alternative names are separated by the
592 ampersand character.
593
594 This environment variable is intended for module command internal
595 use to get knowledge of the alternative names matching loaded mod‐
596 ulefiles in order to keep environment consistent when conflicts or
597 pre-requirements are set over these alternative designations. It
598 also helps to find a match after modulefiles being loaded when
599 unload, is-loaded or info-loaded actions are run over these names.
600
601 MODULES_LMCONFLICT
602 A colon separated list of the conflict statements defined by all
603 loaded modulefiles. Each element in this list starts by the name of
604 the loaded modulefile declaring the conflict followed by the name of
605 all modulefiles it declares a conflict with. These loaded module‐
606 files and conflicting modulefile names are separated by the amper‐
607 sand character.
608
609 This environment variable is intended for module command internal
610 use to get knowledge of the conflicts declared by the loaded module‐
611 files in order to keep environment consistent when a conflicting
612 module is asked for load afterward.
613
614 MODULES_LMNOTUASKED
615 A colon separated list of all loaded modulefiles that were not
616 explicitly asked for load from the command-line.
617
618 This environment variable is intended for module command internal
619 use to distinguish the modulefiles that have been loaded automati‐
620 cally from modulefiles that have been asked by users.
621
622 MODULES_LMPREREQ
623 A colon separated list of the prereq statements defined by all
624 loaded modulefiles. Each element in this list starts by the name of
625 the loaded modulefile declaring the pre-requirement followed by the
626 name of all modulefiles it declares a prereq with. These loaded mod‐
627 ulefiles and pre-required modulefile names are separated by the
628 ampersand character. When a prereq statement is composed of multiple
629 modulefiles, these modulefile names are separated by the pipe char‐
630 acter.
631
632 This environment variable is intended for module command internal
633 use to get knowledge of the pre-requirement declared by the loaded
634 modulefiles in order to keep environment consistent when a
635 pre-required module is asked for unload afterward.
636
637 MODULES_PAGER
638 Text viewer for use to paginate message output if error output
639 stream is attached to a terminal. The value of this variable is com‐
640 posed of a pager command name or path eventually followed by com‐
641 mand-line options.
642
643 Paging command and options are defined for Modules in the following
644 order of preference: MODULES_PAGER environment variable, then the
645 default set in modulecmd.tcl script configuration. Which means MOD‐
646 ULES_PAGER overrides default configuration.
647
648 If MODULES_PAGER variable is set to an empty string or to the value
649 cat, pager will not be launched.
650
651 MODULES_RUNENV_<VAR>
652 Value to set to environment variable <VAR> for modulecmd.tcl
653 run-time execution if <VAR> is referred in MODULES_RUN_QUARANTINE.
654
655 MODULES_RUN_QUARANTINE
656 A space separated list of environment variable names that should be
657 passed indirectly to modulecmd.tcl to protect its run-time environ‐
658 ment from side-effect coming from their current definition.
659
660 Each variable found in MODULES_RUN_QUARANTINE will have its value
661 emptied or set to the value of the corresponding MOD‐
662 ULES_RUNENV_<VAR> variable when defining modulecmd.tcl run-time
663 environment.
664
665 Original values of these environment variables set in quarantine are
666 passed to modulecmd.tcl via <VAR>_modquar variables.
667
668 MODULES_SILENT_SHELL_DEBUG
669 If set to 1, disable any xtrace or verbose debugging property set on
670 current shell session for the duration of either the module command
671 or the module shell initialization script. Only applies to Bourne
672 Shell (sh) and its derivatives.
673
674 MODULES_USE_COMPAT_VERSION
675 If set to 1 prior to Modules package initialization, enable Modules
676 compatibility version (3.2 release branch) rather main version at
677 initialization scripts running time. Modules package compatibility
678 version should be installed along with main version for this envi‐
679 ronment variable to have any effect.
680
681 _LMFILES_
682 A colon separated list of the full pathname for all loaded module‐
683 files.
684
685 <VAR>_modquar
686 Value of environment variable <VAR> passed to modulecmd.tcl in order
687 to restore <VAR> to this value once started.
688
689 <VAR>_modshare
690 Reference counter variable for path-like variable <VAR>. A colon
691 separated list containing pairs of elements. A pair is formed by a
692 path element followed its usage counter which represents the number
693 of times this path has been enabled in variable <VAR>. A colon sepa‐
694 rates the two parts of the pair.
695
697 /usr/share/Modules
698 The MODULESHOME directory.
699
700 /usr/share/Modules/etc/rc
701 The system-wide modules rc file. The location of this file can be
702 changed using the MODULERCFILE environment variable as described
703 above.
704
705 $HOME/.modulerc
706 The user specific modules rc file.
707
708 $HOME/.module
709 The user specific collection directory.
710
711 /usr/share/Modules/modulefiles
712 The directory for system-wide modulefiles. The location of the
713 directory can be changed using the MODULEPATH environment variable
714 as described above.
715
716 /usr/share/Modules/libexec/modulecmd.tcl
717 The modulefile interpreter that gets executed upon each invocation
718 of module.
719
720 /usr/share/Modules/init/<shell>
721 The Modules package initialization file sourced into the user's
722 environment.
723
725 modulefile(4)
726
728 1996-1999 John L. Furlani & Peter W. Osel, 1998-2017 R.K.Owen,
729 2002-2004 Mark Lakata, 2004-2017 Kent Mein, 2016-2019 Xavier Delaruelle
730
731
732
733
7344.2.4 2019-04-26 MODULE(1)