doc/html/ref/dump-command.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >dump</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="Common Commands"
  23 HREF="common-commands.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="disks"
  26 HREF="disks-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="help"
  29 HREF="help-command.html"></HEAD
  30 ><BODY
  31 CLASS="REFENTRY"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="disks-command.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 ></TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="help-command.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><H1
  81 ><A
  82 NAME="DUMP-COMMAND">dump</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN3226"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >dump&nbsp;--&nbsp;Display memory.</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN3229"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >dump</B
 100 >  {-b <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 >location</I
 104 ></TT
 105 >} [-l <TT
 106 CLASS="REPLACEABLE"
 107 ><I
 108 >length</I
 109 ></TT
 110 >] [-s] [-1 | -2 | -4]</P
 111 ></DIV
 112 ><DIV
 113 CLASS="REFSECT1"
 114 ><A
 115 NAME="AEN3241"
 116 ></A
 117 ><H2
 118 >Arguments</H2
 119 ><DIV
 120 CLASS="INFORMALTABLE"
 121 ><A
 122 NAME="AEN3243"><P
 123 ></P
 124 ><TABLE
 125 BORDER="1"
 126 CLASS="CALSTABLE"
 127 ><THEAD
 128 ><TR
 129 ><TH
 130 WIDTH="25%"
 131 ALIGN="LEFT"
 132 VALIGN="TOP"
 133 >Name</TH
 134 ><TH
 135 WIDTH="25%"
 136 ALIGN="LEFT"
 137 VALIGN="TOP"
 138 >Type</TH
 139 ><TH
 140 WIDTH="25%"
 141 ALIGN="LEFT"
 142 VALIGN="TOP"
 143 >Description</TH
 144 ><TH
 145 WIDTH="25%"
 146 ALIGN="LEFT"
 147 VALIGN="TOP"
 148 >Default</TH
 149 ></TR
 150 ></THEAD
 151 ><TBODY
 152 ><TR
 153 ><TD
 154 WIDTH="25%"
 155 ALIGN="LEFT"
 156 VALIGN="TOP"
 157 >-b <TT
 158 CLASS="REPLACEABLE"
 159 ><I
 160 >location</I
 161 ></TT
 162 ></TD
 163 ><TD
 164 WIDTH="25%"
 165 ALIGN="LEFT"
 166 VALIGN="TOP"
 167 >Memory address</TD
 168 ><TD
 169 WIDTH="25%"
 170 ALIGN="LEFT"
 171 VALIGN="TOP"
 172 >Location in memory for start of data.</TD
 173 ><TD
 174 WIDTH="25%"
 175 ALIGN="LEFT"
 176 VALIGN="TOP"
 177 ><SPAN
 178 CLASS="emphasis"
 179 ><I
 180 CLASS="EMPHASIS"
 181 >none</I
 182 ></SPAN
 183 ></TD
 184 ></TR
 185 ><TR
 186 ><TD
 187 WIDTH="25%"
 188 ALIGN="LEFT"
 189 VALIGN="TOP"
 190 >-l <TT
 191 CLASS="REPLACEABLE"
 192 ><I
 193 >length</I
 194 ></TT
 195 ></TD
 196 ><TD
 197 WIDTH="25%"
 198 ALIGN="LEFT"
 199 VALIGN="TOP"
 200 >Number</TD
 201 ><TD
 202 WIDTH="25%"
 203 ALIGN="LEFT"
 204 VALIGN="TOP"
 205 >Length of data</TD
 206 ><TD
 207 WIDTH="25%"
 208 ALIGN="LEFT"
 209 VALIGN="TOP"
 210 >32</TD
 211 ></TR
 212 ><TR
 213 ><TD
 214 WIDTH="25%"
 215 ALIGN="LEFT"
 216 VALIGN="TOP"
 217 >-s</TD
 218 ><TD
 219 WIDTH="25%"
 220 ALIGN="LEFT"
 221 VALIGN="TOP"
 222 >Boolean</TD
 223 ><TD
 224 WIDTH="25%"
 225 ALIGN="LEFT"
 226 VALIGN="TOP"
 227 >Format data using Motorola S-records.</TD
 228 ><TD
 229 WIDTH="25%"
 230 ALIGN="LEFT"
 231 VALIGN="TOP"
 232 >&nbsp;</TD
 233 ></TR
 234 ><TR
 235 ><TD
 236 WIDTH="25%"
 237 ALIGN="LEFT"
 238 VALIGN="TOP"
 239 >-1</TD
 240 ><TD
 241 WIDTH="25%"
 242 ALIGN="LEFT"
 243 VALIGN="TOP"
 244 >&nbsp;</TD
 245 ><TD
 246 WIDTH="25%"
 247 ALIGN="LEFT"
 248 VALIGN="TOP"
 249 >Access one byte (8 bits) at a time.
 250 Only the least significant 8 bits of the pattern will be used.</TD
 251 ><TD
 252 WIDTH="25%"
 253 ALIGN="LEFT"
 254 VALIGN="TOP"
 255 >-1</TD
 256 ></TR
 257 ><TR
 258 ><TD
 259 WIDTH="25%"
 260 ALIGN="LEFT"
 261 VALIGN="TOP"
 262 >-2</TD
 263 ><TD
 264 WIDTH="25%"
 265 ALIGN="LEFT"
 266 VALIGN="TOP"
 267 >&nbsp;</TD
 268 ><TD
 269 WIDTH="25%"
 270 ALIGN="LEFT"
 271 VALIGN="TOP"
 272 >Access two bytes (16 bits) at a time.
 273 Only the least significant 16 bits of the pattern will be used.</TD
 274 ><TD
 275 WIDTH="25%"
 276 ALIGN="LEFT"
 277 VALIGN="TOP"
 278 >-1</TD
 279 ></TR
 280 ><TR
 281 ><TD
 282 WIDTH="25%"
 283 ALIGN="LEFT"
 284 VALIGN="TOP"
 285 >-4</TD
 286 ><TD
 287 WIDTH="25%"
 288 ALIGN="LEFT"
 289 VALIGN="TOP"
 290 >&nbsp;</TD
 291 ><TD
 292 WIDTH="25%"
 293 ALIGN="LEFT"
 294 VALIGN="TOP"
 295 >Access one word (32 bits) at a time.</TD
 296 ><TD
 297 WIDTH="25%"
 298 ALIGN="LEFT"
 299 VALIGN="TOP"
 300 >-1</TD
 301 ></TR
 302 ></TBODY
 303 ></TABLE
 304 ><P
 305 ></P
 306 ></DIV
 307 ></DIV
 308 ><DIV
 309 CLASS="REFSECT1"
 310 ><A
 311 NAME="AEN3289"
 312 ></A
 313 ><H2
 314 >Description</H2
 315 ><P
 316 >Display a range of memory on the system console.</P
 317 ><P
 318 >The <B
 319 CLASS="COMMAND"
 320 >x</B
 321 > is a synonym for <B
 322 CLASS="COMMAND"
 323 >dump</B
 324 >.</P
 325 ><P
 326 >Note that this command could
 327 be detrimental if used on memory mapped hardware registers. </P
 328 ><P
 329 >The memory is displayed at most sixteen bytes per line, first as the
 330 raw hex value, followed by an ASCII interpretation of the data. </P
 331 ></DIV
 332 ><DIV
 333 CLASS="REFSECT1"
 334 ><A
 335 NAME="AEN3297"
 336 ></A
 337 ><H2
 338 >Examples</H2
 339 ><P
 340 >Display a buffer, one byte at a time.
 341 <TABLE
 342 BORDER="5"
 343 BGCOLOR="#E0E0F0"
 344 WIDTH="70%"
 345 ><TR
 346 ><TD
 347 ><PRE
 348 CLASS="SCREEN"
 349 >
 350 RedBoot&#62; <TT
 351 CLASS="USERINPUT"
 352 ><B
 353 >mfill -b 0x100000 -l 0x20 -p 0xDEADFACE</B
 354 ></TT
 355 >
 356 RedBoot&#62; <TT
 357 CLASS="USERINPUT"
 358 ><B
 359 >x -b 0x100000</B
 360 ></TT
 361 >
 362 00100000: CE FA AD DE CE FA AD DE  CE FA AD DE CE FA AD DE  |................|
 363 00100010: CE FA AD DE CE FA AD DE  CE FA AD DE CE FA AD DE  |................|</PRE
 364 ></TD
 365 ></TR
 366 ></TABLE
 367 > </P
 368 ><P
 369 >Display a buffer, one short (16 bit) word at a time.  Note in this case that
 370 the ASCII interpretation is suppressed.
 371 <TABLE
 372 BORDER="5"
 373 BGCOLOR="#E0E0F0"
 374 WIDTH="70%"
 375 ><TR
 376 ><TD
 377 ><PRE
 378 CLASS="SCREEN"
 379 >
 380 RedBoot&#62; <TT
 381 CLASS="USERINPUT"
 382 ><B
 383 >dump -b 0x100000 -2</B
 384 ></TT
 385 >
 386 00100000: FACE DEAD FACE DEAD  FACE DEAD FACE DEAD
 387 00100010: FACE DEAD FACE DEAD  FACE DEAD FACE DEAD </PRE
 388 ></TD
 389 ></TR
 390 ></TABLE
 391 > </P
 392 ><P
 393 >Display a buffer, one word (32 bit) word at a time.  Note in this case that
 394 the ASCII interpretation is suppressed.
 395 <TABLE
 396 BORDER="5"
 397 BGCOLOR="#E0E0F0"
 398 WIDTH="70%"
 399 ><TR
 400 ><TD
 401 ><PRE
 402 CLASS="SCREEN"
 403 >
 404 RedBoot&#62; <TT
 405 CLASS="USERINPUT"
 406 ><B
 407 >dump -b 0x100000 -4</B
 408 ></TT
 409 >
 410 00100000: DEADFACE DEADFACE DEADFACE DEADFACE
 411 00100010: DEADFACE DEADFACE DEADFACE DEADFACE </PRE
 412 ></TD
 413 ></TR
 414 ></TABLE
 415 > </P
 416 ><P
 417 >Display the same buffer, using Motorola S-record format.
 418 <TABLE
 419 BORDER="5"
 420 BGCOLOR="#E0E0F0"
 421 WIDTH="70%"
 422 ><TR
 423 ><TD
 424 ><PRE
 425 CLASS="SCREEN"
 426 >
 427 RedBoot&#62; <TT
 428 CLASS="USERINPUT"
 429 ><B
 430 >dump -b 0x100000 -s</B
 431 ></TT
 432 >
 433 S31500100000CEFAADDECEFAADDECEFAADDECEFAADDE8E
 434 S31500100010CEFAADDECEFAADDECEFAADDECEFAADDE7E</PRE
 435 ></TD
 436 ></TR
 437 ></TABLE
 438 > </P
 439 ><P
 440 >Display a buffer, with visible ASCII strings.
 441 <TABLE
 442 BORDER="5"
 443 BGCOLOR="#E0E0F0"
 444 WIDTH="70%"
 445 ><TR
 446 ><TD
 447 ><PRE
 448 CLASS="SCREEN"
 449 >
 450 RedBoot&#62; <TT
 451 CLASS="USERINPUT"
 452 ><B
 453 >d -b 0xfe00b000 -l 0x80</B
 454 ></TT
 455 >
 456 0xFE00B000: 20 25 70 0A 00 00 00 00  41 74 74 65 6D 70 74 20 | %p.....Attempt |
 457 0xFE00B010: 74 6F 20 6C 6F 61 64 20  53 2D 72 65 63 6F 72 64 |to load S-record|
 458 0xFE00B020: 20 64 61 74 61 20 74 6F  20 61 64 64 72 65 73 73 | data to address|
 459 0xFE00B030: 3A 20 25 70 20 5B 6E 6F  74 20 69 6E 20 52 41 4D |: %p [not in RAM|
 460 0xFE00B040: 5D 0A 00 00 2A 2A 2A 20  57 61 72 6E 69 6E 67 21 |]...*** Warning!|
 461 0xFE00B050: 20 43 68 65 63 6B 73 75  6D 20 66 61 69 6C 75 72 | Checksum failur|
 462 0xFE00B060: 65 20 2D 20 41 64 64 72  3A 20 25 6C 78 2C 20 25 |e - Addr: %lx, %|
 463 0xFE00B070: 30 32 6C 58 20 3C 3E 20  25 30 32 6C 58 0A 00 00 |02lX &lt;&#62; %02lX...|
 464 0xFE00B080: 45 6E 74 72 79 20 70 6F  69 6E 74 3A 20 25 70 2C |Entry point: %p,|</PRE
 465 ></TD
 466 ></TR
 467 ></TABLE
 468 >
 469       </P
 470 ></DIV
 471 ><DIV
 472 CLASS="NAVFOOTER"
 473 ><HR
 474 ALIGN="LEFT"
 475 WIDTH="100%"><TABLE
 476 SUMMARY="Footer navigation table"
 477 WIDTH="100%"
 478 BORDER="0"
 479 CELLPADDING="0"
 480 CELLSPACING="0"
 481 ><TR
 482 ><TD
 483 WIDTH="33%"
 484 ALIGN="left"
 485 VALIGN="top"
 486 ><A
 487 HREF="disks-command.html"
 488 ACCESSKEY="P"
 489 >Prev</A
 490 ></TD
 491 ><TD
 492 WIDTH="34%"
 493 ALIGN="center"
 494 VALIGN="top"
 495 ><A
 496 HREF="ecos-ref.html"
 497 ACCESSKEY="H"
 498 >Home</A
 499 ></TD
 500 ><TD
 501 WIDTH="33%"
 502 ALIGN="right"
 503 VALIGN="top"
 504 ><A
 505 HREF="help-command.html"
 506 ACCESSKEY="N"
 507 >Next</A
 508 ></TD
 509 ></TR
 510 ><TR
 511 ><TD
 512 WIDTH="33%"
 513 ALIGN="left"
 514 VALIGN="top"
 515 >disks</TD
 516 ><TD
 517 WIDTH="34%"
 518 ALIGN="center"
 519 VALIGN="top"
 520 ><A
 521 HREF="common-commands.html"
 522 ACCESSKEY="U"
 523 >Up</A
 524 ></TD
 525 ><TD
 526 WIDTH="33%"
 527 ALIGN="right"
 528 VALIGN="top"
 529 >help</TD
 530 ></TR
 531 ></TABLE
 532 ></DIV
 533 ></BODY
 534 ></HTML
 535 >