Jump to content

cmd.exe

From Wikipedia, the free encyclopedia
(Redirected from Endlocal)

Command Prompt (cmd.exe)
Other namesWindows Command Processor
Developer(s)Microsoft, IBM, ReactOS contributors
Initial releaseDecember 1987; 37 years ago (1987-12)
Operating system
PlatformIA-32, x86-64, ARM (and historically DEC Alpha, MIPS, PowerPC, and Itanium)
PredecessorCOMMAND.COM
TypeCommand-line interpreter

cmd.exe, a.k.a. Command Prompt, is a computer program that acts as an operating system shell for later versions of Windows (NT and CE families), OS/2,[1], eComStation, ArcaOS, and ReactOS[2]. In some versions of Windows (CE .NET 4.2,[3] CE 5.0[4] and Embedded CE 6.0[5]) it is referred to as the Command Processor Shell. Implementation differs between operating systems, but with significant consistency of behavior and available commands.

Older, related operating systems, DOS and Windows 9x, provided COMMAND.COM as the shell. cmd.exe replaced COMMAND.COM in the Windows product line with the introduction of NT. Current versions of Windows include PowerShell as an alternative shell that runs side-by-side with cmd.exe.

The initial version of cmd.exe for Windows NT was developed by Therese Stowell.[6] Windows CE 2.11 was the first embedded Windows release to support a console and a Windows CE version of cmd.exe.[7] The ReactOS implementation of cmd.exe is derived from FreeCOM, the FreeDOS command line interpreter.[2]

Use

[edit]

Desktop integration

[edit]

In Windows, the shell command-line interface is presented in the desktop via Windows Terminal or on older versions via Windows Console.

Pipes

[edit]

In OS/2 and Windows, the shell supports pipes to allow both sides of a pipeline to run concurrently. As a result, it is possible to redirect the standard error stream. In contrast, COMMAND.COM uses temporary files, and runs the two sides serially, one after the other.

Command separator

[edit]

Multiple commands can be included in a single line using the command separator & or &&.[8]

With the & separator, a subsequent command is executed even if the previous command indicates an error.[9] In the following example, each of the three commands is executed, one after the other, and regardless of their result code.

C:\>CommandA & CommandB & CommandC

With the && separator, a command must complete successfully for the subsequent command to execute. In the following example, CommandB only executes if CommandA completes successfully, and CommandC only executes if CommandB also completes successfully.

C:\>CommandA && CommandB && CommandC

Command line limit

[edit]

The shell limits the length of a command line which includes entered text, individual environment variables that are inherited by other processes, and all environment variable expansions[10] On Windows XP and later, the maximum length is 8191 (213-1) characters. On earlier versions, such as Windows 2000 or Windows NT 4.0, the maximum length is 2047 (211-1) characters.

Escaping special characters

[edit]

Quotation marks are required around white space and special characters:[8] &<>[]{}^=;!'+,`~.

Internal commands

[edit]

The following sections list internal commands for implementations of the shell on various operating systems.

OS/2

[edit]
OS/2 Window (cmd.exe) on OS/2 version 1.3

Internal commands in OS/2:[11]

Windows NT family

[edit]
cmd.exe on Windows 11

Internal commands in Windows NT and later:[12]

Windows CE

[edit]
Pocket CMD v 3.0 (cmd.exe) on Windows CE 3.0

Internal commands in Windows CE .NET 4.2,[13] Windows CE 5.0[14] and Windows Embedded CE 6.0:[15]

  • attrib
  • call
  • cd
  • chdir
  • cls
  • copy
  • date
  • del
  • dir
  • echo
  • erase
  • exit
  • goto
  • help
  • if
  • md
  • mkdir
  • move
  • path
  • pause
  • prompt
  • pwd
  • rd
  • rem
  • ren
  • rename
  • rmdir
  • set
  • shift
  • start
  • time
  • title
  • type

The net command is available as an external command.

ReactOS

[edit]
Command Prompt (cmd.exe) on ReactOS

Internal commands in ReactOS:[2]

  • ?
  • alias
  • assoc
  • beep
  • call
  • cd
  • chdir
  • choice
  • cls
  • color
  • copy
  • ctty
  • date
  • del
  • delete
  • delay
  • dir
  • dirs
  • echo
  • echos
  • echoerr
  • echoserr
  • endlocal
  • erase
  • exit
  • for
  • free
  • goto
  • history
  • if
  • memory
  • md
  • mkdir
  • mklink
  • move
  • path
  • pause
  • popd
  • prompt
  • pushd
  • rd
  • rmdir
  • rem
  • ren
  • rename
  • replace
  • screen
  • set
  • setlocal
  • shift
  • start
  • time
  • timer
  • title
  • type
  • ver
  • verify
  • vol

Comparison with COMMAND.COM

[edit]

On Windows, cmd.exe is mostly compatible with COMMAND.COM but provides the following extensions over it:

  • More detailed error messages than the blanket "Bad command or file name" (in the case of malformed commands) of COMMAND.COM. In OS/2, errors are reported in the chosen language of the system, their text being taken from the system message files. The HELP command can then be issued with the error message number to obtain further information.
  • Supports using of arrow keys to scroll through command history. (Under DOS this function was only available under DR DOS (through HISTORY) and later via an external component called DOSKEY.)
  • Adds rotating command-line completion for file and folder paths, where the user can cycle through results for the prefix using the Tab, and Shift+Tab ↹ for reverse direction.
  • Treats the caret character (^) as the escape character; the character following it is to be taken literally. There are special characters in cmd.exe and COMMAND.COM that are meant to alter the behavior of the command line processor. The caret character forces the command line processor to interpret them literally.
  • Supports delayed variable expansion with SETLOCAL EnableDelayedExpansion, allowing values of variables to be calculated at runtime instead of during parsing of script before execution (Windows 2000 and later), fixing DOS idioms that made using control structures hard and complex.[16] The extensions can be disabled, providing a stricter compatibility mode.

Internal commands have also been improved:

  • The DELTREE command was merged into the RD command, as part of its /S switch.
  • SetLocal and EndLocal commands limit the scope of changes to the environment. Changes made to the command line environment after SetLocal commands are local to the batch file. EndLocal command restores the previous settings.[17]
  • The Call command allows subroutines within batch file. The Call command in COMMAND.COM only supports calling external batch files.
  • File name parser extensions to the Set command are comparable with C shell.[further explanation needed]
  • The Set command can perform expression evaluation.
  • An expansion of the For command supports parsing files and arbitrary sets in addition to file names.
  • The new PushD and PopD commands provide access past navigated paths similar to "forward" and "back" buttons in a web browser or File Explorer.
  • The conditional IF command can perform case-insensitive comparisons and numeric equality and inequality comparisons in addition to case-sensitive string comparisons. (This was available in DR-DOS, but not in PC DOS or MS-DOS.)

See also

[edit]

References

[edit]
  1. ^ "Notes on using the default OS/2 command processor (CMD.EXE)". www.tavi.co.uk.
  2. ^ a b c "reactos/reactos". GitHub. December 4, 2021.
  3. ^ "Command Processor Shell (Windows CE .NET 4.2)". Microsoft Docs. June 30, 2006. Archived from the original on August 31, 2022.
  4. ^ "Command Processor Shell (Windows CE 5.0)". Microsoft Docs. September 14, 2012. Archived from the original on August 28, 2022.
  5. ^ "Command Processor Shell (Windows Embedded CE 6.0)". Microsoft Docs. 2012. Archived from the original on September 5, 2022.
  6. ^ Zachary, G. Pascal (1994). Showstopper! The Breakneck Race to Create Windows NT and the Next Generation at Microsoft. The Free Press. ISBN 0-02-935671-7.
  7. ^ Douglas McConnaughey Boling (2001). Programming Microsoft Windows CE (2nd ed.). Microsoft Press. ISBN 978-0735614437.
  8. ^ a b "cmd". Microsoft Learn. September 12, 2023. Archived from the original on November 21, 2023.
  9. ^ "Command Redirection, Pipes - Windows CMD - SS64.com". ss64.com. Retrieved September 23, 2021.
  10. ^ Command prompt (Cmd.exe) command-line string limitation
  11. ^ Microsoft Operating System/2 User's Reference (PDF). Microsoft. 1987.
  12. ^ Hill, Tim (1998). Windows NT Shell Scripting. Macmillan Technical Publishing. ISBN 978-1578700479.
  13. ^ "Command Processor Commands (Windows CE .NET 4.2)". Microsoft Docs. June 30, 2006. Archived from the original on August 31, 2022.
  14. ^ "Command Processor Commands (Windows CE 5.0)". Microsoft Docs. September 14, 2012. Archived from the original on August 31, 2022.
  15. ^ "Command Processor Commands (Windows Embedded CE 6.0)". Microsoft Docs. January 5, 2012. Archived from the original on September 6, 2022.
  16. ^ "Windows 2000 delayed environment variable expansion". Windows IT Pro. Archived from the original on July 13, 2015. Retrieved July 13, 2015.
  17. ^ "Setlocal". TechNet. Microsoft. September 11, 2009. Retrieved January 13, 2015.

Further reading

[edit]
[edit]