Debug: E (Enter)
Page updated January 21, 2005
Enters data into memory at the address you specify.
Syntax
Parameters
Remarks
- Windows XP and the Windows Server 2003 family of products do not use this command. It is included only to preserve compatibility with existing MS-DOS files, but it has no effect at the command line because the functionality is automatic.
-
Specifying valid Address entries
Address is a two-part designation, containing either an alphabetic segment register or a four-digit segment address with an offset value. You can omit the segment register or segment address. CS is the default segment for the following debug subcommands: a, g, l, t, u, and w. DS is the default segment for all other subcommands. All numeric values are in hexadecimal format. You must include a colon between the segment name and the offset value. The following are valid addresses:
CS:0100
04BA:0100
-
Using the Address parameter
If you specify a value for Address without specifying a value for the optional List parameter, Debug.exe displays the address and its contents, repeats the address on the next line, and waits for your input. At this point, you can do one of the following:
- Replace the byte value. To do this, type a new value after the current value. If the value you type is not a valid hexadecimal value or if it contains more than two digits, Debug.exe does not echo the invalid or extra character.
- Advance to the next byte. To do this, press the SPACEBAR. To change the value in that byte, type a new value after the current value. If you move beyond an 8-byte boundary when you press the SPACEBAR, Debug.exe starts a new display line and displays the new address at the beginning of the line.
- Return to the preceding byte. To do this, press the HYPHEN key. You can press the HYPHEN key repeatedly to move back more than 1 byte. When you press HYPHEN, Debug.exe starts a new line and displays the current address and byte value.
- Stop the e subcommand. To do this, press the ENTER key. You can press ENTER at any byte position.
-
Using the List parameter
If you specify values for the List parameter, the e subcommand sequentially replaces the existing byte values with the values from the list. If an error occurs, no byte values are changed.
List values can be either hexadecimal byte values or strings. You separate values by using a space, a comma, or a tab character. You must enclose strings within single quotation marks (that is, 'String') or double quotation marks (that is, "String").
- Assembling mnemonics
For information about assembling mnemonics by using the a (assemble) subcommand, see Related Topics.
- Displaying the contents of a portion of memory
For information about displaying the contents of a portion of memory by using the d (dump) subcommand, see Related Topics.
Examples
ecs:100
Debug.exe displays the contents of the first byte in the following format:
04BA:0100 EB._
To change this value to 41, type 41 at the insertion point, as follows:
04BA:0100 EB.41_
You can type consecutive byte values with one e subcommand. Instead of pressing ENTER after typing the new value, press the SPACEBAR. Debug.exe displays the next value. In this example, if you press the SPACEBAR three times, Debug.exe displays the following values:
04BA:0100 EB.41 10. 00. BC._
To change the hexadecimal value BC to 42, type 42 at the insertion point, as follows:
04BA:0100 EB.41 10. 00. BC.42_
To change the value 10 to 6F, press the HYPHEN key twice to return to address 0101 (value 10). Debug.exe displays the following:
04BA:0100 EB.41 10. 00. BC.42-
04BA:0102 00.-
04BA:0101 10._
Type 6F at the insertion point to change the value, as follows:
04BA:0101 10.6F_
Press ENTER to stop the e subcommand and return to the debug prompt.
The following is an example of a string entry:
eds:100 "This is the text example"
This string fills 24 bytes, starting at DS:100.
Formatting legend
Format | Meaning |
Italic | Information that the user must supply |
Bold | Elements that the user must type exactly as shown |
Ellipsis (...) | Parameter that can be repeated several times in a command line |
Between brackets ([]) | Optional items |
Between braces ({}); choices separated by pipe (|). Example: {even|odd} | Set of choices from which the user must choose only one |
Courier font | Code or program output |
Some of these terms may be the same or similar to DOS commands. For information on DOS Commands, click here