.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.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 "MODULECMD" "1" "2026-09-21" "5.7.0" "Modules"
.SH NAME
modulecmd \- generic wrapper pointing to Modules execution engine
.SH SYNOPSIS
.sp
\fBmodulecmd\fP \fIshell\fP [\fIswitches\fP] [\fIsub\-command\fP [\fIsub\-command\-args\fP]]
.SH DESCRIPTION
.sp
The \fBmodulecmd\fP command is a generic wrapper pointing to Modules
execution engine \fBmodulecmd.tcl\fP\&.
.sp
The \fBmodulecmd.tcl\fP command is the low\-level execution engine of the
Environment Modules system. It is responsible for evaluating modulefile
logic and emitting shell\-specific commands that modify the user\(aqs
environment.
.sp
Unlike the user\-facing \fBmodule\fP command, \fBmodulecmd.tcl\fP
does not directly alter the environment. Instead, it writes shell code to
standard output, which must be evaluated by the calling shell.
.sp
The \fBmodule\fP shell function or wrapper script invokes
\fBmodulecmd.tcl\fP internally and evaluates its output to apply
environment changes.
.sp
The following shells are supported: sh, csh, tcsh, bash, ksh, zsh, fish, cmd,
pwsh, python, perl, ruby, tcl, cmake, r and lisp.
.sp
See the Modulecmd startup \%<#\:modulecmd-startup>, Command line switches \%<#\:command-line-switches> and
Module Sub\-Commands \%<#\:module-sub-commands> sections in the module \%<#\:module-1> man page.
.sp
Direct invocation of \fBmodulecmd\fP is primarily intended for debugging
and advanced usage. End users should normally use the \fBmodule\fP
command instead.
.SH EXIT STATUS
.sp
\fBmodulecmd\fP exits with \fB0\fP on successful execution. Otherwise \fB1\fP
is returned.
.SH ENVIRONMENT
.sp
See the ENVIRONMENT \%<#\:module-environment> section in the module \%<#\:module-1>
man page.
.SH FILES
.sp
See the FILES \%<#\:module-files> section in the module \%<#\:module-1> man page.
.SH SEE ALSO
.sp
envml \%<#\:envml-1>, ml \%<#\:ml-1>, module \%<#\:module-1>, modulefile \%<#\:modulefile-5>
.SH Copyright
1996-2026, Modules Contributors
.\" End of generated man page.