OpenCores
URL https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk

Subversion Repositories openrisc_2011-10-31

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [dump-command.html] - Blame information for rev 314

Go to most recent revision | Details | Compare with Previous | View Log

Line No. Rev Author Line
1 28 unneback 
<!-- 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 
>

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.