Ticket #2012: memory.diff
File memory.diff, 6.3 KB (added by Ric Claus, on 02/02/12 at 19:03:38) |
---|
-
.t
old new 16 16 17 17 @item @code{mdump} - Display contents of memory 18 18 @item @code{wdump} - Display contents of memory (word) 19 @item @code{ldump} - Display contents of memory (longword) 19 20 @item @code{medit} - Modify contents of memory 20 21 @item @code{mfill} - File memory with pattern 21 22 @item @code{mmove} - Move contents of memory … … 41 42 @subheading SYNOPSYS: 42 43 43 44 @example 44 mdump [address [length ]]45 mdump [address [length [size]]] 45 46 @end example 46 47 47 48 @subheading DESCRIPTION: 48 49 49 50 This command displays the contents of memory at the @code{address} 50 and @code{length} in bytes specified on the command line. 51 and @code{length} in @code{size} byte units specified on the command line. 52 53 When @code{size} is not provided, it defaults to @code{1} byte units. 54 Values of @code{1}, @code{2}, and @code{4} are valid; all others will 55 cause an error to be reported. 51 56 52 57 When @code{length} is not provided, it defaults to @code{320} which 53 58 is twenty lines of output with sixteen bytes of output per line. … … 84 89 @findex CONFIGURE_SHELL_NO_COMMAND_MDUMP 85 90 @findex CONFIGURE_SHELL_COMMAND_MDUMP 86 91 87 This command is included in the default shell command set. 92 This command is included in the default shell command set. 88 93 When building a custom command set, define 89 94 @code{CONFIGURE_SHELL_COMMAND_MDUMP} to have this 90 95 command included. … … 131 136 @subheading DESCRIPTION: 132 137 133 138 This command displays the contents of memory at the @code{address} 134 and @code{length} in bytes specified on the command line. 139 and @code{length} in bytes specified on the command line. 140 141 This command is equivalent to @code{mdump address length 2}. 135 142 136 143 When @code{length} is not provided, it defaults to @code{320} which 137 is twenty lines of output with sixteen bytes of output per line.144 is twenty lines of output with eight words of output per line. 138 145 139 146 When @code{address} is not provided, it defaults to @code{0x00000000}. 140 147 … … 162 169 @findex CONFIGURE_SHELL_NO_COMMAND_WDUMP 163 170 @findex CONFIGURE_SHELL_COMMAND_WDUMP 164 171 165 This command is included in the default shell command set. 172 This command is included in the default shell command set. 166 173 When building a custom command set, define 167 174 @code{CONFIGURE_SHELL_COMMAND_WDUMP} to have this 168 175 command included. … … 196 203 @c 197 204 @c 198 205 @page 206 @subsection ldump - display contents of memory (longword) 207 208 @pgindex ldump 209 210 @subheading SYNOPSYS: 211 212 @example 213 ldump [address [length]] 214 @end example 215 216 @subheading DESCRIPTION: 217 218 This command displays the contents of memory at the @code{address} 219 and @code{length} in bytes specified on the command line. 220 221 This command is equivalent to @code{mdump address length 4}. 222 223 When @code{length} is not provided, it defaults to @code{320} which 224 is twenty lines of output with four longwords of output per line. 225 226 When @code{address} is not provided, it defaults to @code{0x00000000}. 227 228 @subheading EXIT STATUS: 229 230 This command always returns 0 to indicate success. 231 232 @subheading NOTES: 233 234 Dumping memory from a non-existent address may result in an unrecoverable 235 program fault. 236 237 @subheading EXAMPLES: 238 239 The following is an example of how to use @code{ldump}: 240 241 @smallexample 242 SHLL [/] $ ldump 0x02010000 32 243 0x02010000 020108D8 020108C0-020108AC 02010874 ...............t 244 0x02010010 020 0894 02010718-02010640 02010798 ...........@.... 245 @end smallexample 246 247 @subheading CONFIGURATION: 248 249 @findex CONFIGURE_SHELL_NO_COMMAND_LDUMP 250 @findex CONFIGURE_SHELL_COMMAND_LDUMP 251 252 This command is included in the default shell command set. 253 When building a custom command set, define 254 @code{CONFIGURE_SHELL_COMMAND_LDUMP} to have this 255 command included. 256 257 This command can be excluded from the shell command set by 258 defining @code{CONFIGURE_SHELL_NO_COMMAND_LDUMP} when all 259 shell commands have been configured. 260 261 @subheading PROGRAMMING INFORMATION: 262 263 @findex rtems_shell_rtems_main_ldump 264 265 The @code{ldump} is implemented by a C language function 266 which has the following prototype: 267 268 @example 269 int rtems_shell_rtems_main_ldump( 270 int argc, 271 char **argv 272 ); 273 @end example 274 275 The configuration structure for the @code{ldump} has the 276 following prototype: 277 278 @example 279 extern rtems_shell_cmd_t rtems_shell_LDUMP_Command; 280 @end example 281 282 @c 283 @c 284 @c 285 @page 199 286 @subsection medit - modify contents of memory 200 287 201 288 @pgindex medit … … 240 327 @findex CONFIGURE_SHELL_NO_COMMAND_MEDIT 241 328 @findex CONFIGURE_SHELL_COMMAND_MEDIT 242 329 243 This command is included in the default shell command set. 330 This command is included in the default shell command set. 244 331 When building a custom command set, define 245 332 @code{CONFIGURE_SHELL_COMMAND_MEDIT} to have this 246 333 command included. … … 303 390 @subheading EXAMPLES: 304 391 305 392 In this example, the address used (@code{0x23d89a0}) as the base 306 address of the filled area is the end of the stack for the 393 address of the filled area is the end of the stack for the 307 394 Idle thread. This address was determined manually using gdb and 308 395 is very specific to this application and BSP. The first command 309 396 in this example is an @code{mdump} to display the initial contents … … 327 414 @findex CONFIGURE_SHELL_NO_COMMAND_MFILL 328 415 @findex CONFIGURE_SHELL_COMMAND_MFILL 329 416 330 This command is included in the default shell command set. 417 This command is included in the default shell command set. 331 418 When building a custom command set, define 332 419 @code{CONFIGURE_SHELL_COMMAND_MFILL} to have this 333 420 command included. … … 404 491 @findex CONFIGURE_SHELL_NO_COMMAND_MMOVE 405 492 @findex CONFIGURE_SHELL_COMMAND_MMOVE 406 493 407 This command is included in the default shell command set. 494 This command is included in the default shell command set. 408 495 When building a custom command set, define 409 496 @code{CONFIGURE_SHELL_COMMAND_MMOVE} to have this 410 497 command included. … … 473 560 available includes the following information: 474 561 475 562 @itemize @bullet 476 @item 563 @item 477 564 @item Currently available memory (in kilobytes) 478 565 @item Currently allocated memory (in kilobytes) 479 566 @item Maximum amount of memory ever allocated (in kilobytes) … … 537 624 @findex CONFIGURE_SHELL_NO_COMMAND_MALLOC 538 625 @findex CONFIGURE_SHELL_COMMAND_MALLOC 539 626 540 This command is included in the default shell command set. 627 This command is included in the default shell command set. 541 628 When building a custom command set, define 542 629 @code{CONFIGURE_SHELL_COMMAND_MALLOC} to have this 543 630 command included.