doc/html/ref/mcmp-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 >mcmp</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="load"
  26 HREF="download-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="mfill"
  29 HREF="mfill-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="download-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="mfill-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="MCMP-COMMAND">mcmp</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN3581"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >mcmp&nbsp;--&nbsp;Compare two segments of memory</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN3584"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >mcmp</B
 100 >  {-s <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 >location1</I
 104 ></TT
 105 >} {-d <TT
 106 CLASS="REPLACEABLE"
 107 ><I
 108 >location1</I
 109 ></TT
 110 >} {-l <TT
 111 CLASS="REPLACEABLE"
 112 ><I
 113 >length</I
 114 ></TT
 115 >} [-1 | -2 | -4]</P
 116 ></DIV
 117 ><DIV
 118 CLASS="REFSECT1"
 119 ><A
 120 NAME="AEN3597"
 121 ></A
 122 ><H2
 123 >Arguments</H2
 124 ><DIV
 125 CLASS="INFORMALTABLE"
 126 ><A
 127 NAME="AEN3599"><P
 128 ></P
 129 ><TABLE
 130 BORDER="1"
 131 CLASS="CALSTABLE"
 132 ><THEAD
 133 ><TR
 134 ><TH
 135 WIDTH="25%"
 136 ALIGN="LEFT"
 137 VALIGN="TOP"
 138 >Name</TH
 139 ><TH
 140 WIDTH="25%"
 141 ALIGN="LEFT"
 142 VALIGN="TOP"
 143 >Type</TH
 144 ><TH
 145 WIDTH="25%"
 146 ALIGN="LEFT"
 147 VALIGN="TOP"
 148 >Description</TH
 149 ><TH
 150 WIDTH="25%"
 151 ALIGN="LEFT"
 152 VALIGN="TOP"
 153 >Default</TH
 154 ></TR
 155 ></THEAD
 156 ><TBODY
 157 ><TR
 158 ><TD
 159 WIDTH="25%"
 160 ALIGN="LEFT"
 161 VALIGN="TOP"
 162 >-s <TT
 163 CLASS="REPLACEABLE"
 164 ><I
 165 >location1</I
 166 ></TT
 167 ></TD
 168 ><TD
 169 WIDTH="25%"
 170 ALIGN="LEFT"
 171 VALIGN="TOP"
 172 >Memory address</TD
 173 ><TD
 174 WIDTH="25%"
 175 ALIGN="LEFT"
 176 VALIGN="TOP"
 177 >Location for start of data.</TD
 178 ><TD
 179 WIDTH="25%"
 180 ALIGN="LEFT"
 181 VALIGN="TOP"
 182 ><SPAN
 183 CLASS="emphasis"
 184 ><I
 185 CLASS="EMPHASIS"
 186 >none</I
 187 ></SPAN
 188 ></TD
 189 ></TR
 190 ><TR
 191 ><TD
 192 WIDTH="25%"
 193 ALIGN="LEFT"
 194 VALIGN="TOP"
 195 >-d <TT
 196 CLASS="REPLACEABLE"
 197 ><I
 198 >location2</I
 199 ></TT
 200 ></TD
 201 ><TD
 202 WIDTH="25%"
 203 ALIGN="LEFT"
 204 VALIGN="TOP"
 205 >Memory address</TD
 206 ><TD
 207 WIDTH="25%"
 208 ALIGN="LEFT"
 209 VALIGN="TOP"
 210 >Location for start of data.</TD
 211 ><TD
 212 WIDTH="25%"
 213 ALIGN="LEFT"
 214 VALIGN="TOP"
 215 ><SPAN
 216 CLASS="emphasis"
 217 ><I
 218 CLASS="EMPHASIS"
 219 >none</I
 220 ></SPAN
 221 ></TD
 222 ></TR
 223 ><TR
 224 ><TD
 225 WIDTH="25%"
 226 ALIGN="LEFT"
 227 VALIGN="TOP"
 228 >-l <TT
 229 CLASS="REPLACEABLE"
 230 ><I
 231 >length</I
 232 ></TT
 233 ></TD
 234 ><TD
 235 WIDTH="25%"
 236 ALIGN="LEFT"
 237 VALIGN="TOP"
 238 >Number</TD
 239 ><TD
 240 WIDTH="25%"
 241 ALIGN="LEFT"
 242 VALIGN="TOP"
 243 >Length of data</TD
 244 ><TD
 245 WIDTH="25%"
 246 ALIGN="LEFT"
 247 VALIGN="TOP"
 248 ><SPAN
 249 CLASS="emphasis"
 250 ><I
 251 CLASS="EMPHASIS"
 252 >none</I
 253 ></SPAN
 254 ></TD
 255 ></TR
 256 ><TR
 257 ><TD
 258 WIDTH="25%"
 259 ALIGN="LEFT"
 260 VALIGN="TOP"
 261 >-1</TD
 262 ><TD
 263 WIDTH="25%"
 264 ALIGN="LEFT"
 265 VALIGN="TOP"
 266 >&nbsp;</TD
 267 ><TD
 268 WIDTH="25%"
 269 ALIGN="LEFT"
 270 VALIGN="TOP"
 271 >Access one byte (8 bits) at a time.
 272 Only the least significant 8 bits of the pattern will be used.</TD
 273 ><TD
 274 WIDTH="25%"
 275 ALIGN="LEFT"
 276 VALIGN="TOP"
 277 >-4</TD
 278 ></TR
 279 ><TR
 280 ><TD
 281 WIDTH="25%"
 282 ALIGN="LEFT"
 283 VALIGN="TOP"
 284 >-2</TD
 285 ><TD
 286 WIDTH="25%"
 287 ALIGN="LEFT"
 288 VALIGN="TOP"
 289 >&nbsp;</TD
 290 ><TD
 291 WIDTH="25%"
 292 ALIGN="LEFT"
 293 VALIGN="TOP"
 294 >Access two bytes (16 bits) at a time.
 295 Only the least significant 16 bits of the pattern will be used.</TD
 296 ><TD
 297 WIDTH="25%"
 298 ALIGN="LEFT"
 299 VALIGN="TOP"
 300 >-4</TD
 301 ></TR
 302 ><TR
 303 ><TD
 304 WIDTH="25%"
 305 ALIGN="LEFT"
 306 VALIGN="TOP"
 307 >-4</TD
 308 ><TD
 309 WIDTH="25%"
 310 ALIGN="LEFT"
 311 VALIGN="TOP"
 312 >&nbsp;</TD
 313 ><TD
 314 WIDTH="25%"
 315 ALIGN="LEFT"
 316 VALIGN="TOP"
 317 >Access one word (32 bits) at a time.</TD
 318 ><TD
 319 WIDTH="25%"
 320 ALIGN="LEFT"
 321 VALIGN="TOP"
 322 >-4</TD
 323 ></TR
 324 ></TBODY
 325 ></TABLE
 326 ><P
 327 ></P
 328 ></DIV
 329 ></DIV
 330 ><DIV
 331 CLASS="REFSECT1"
 332 ><A
 333 NAME="AEN3648"
 334 ></A
 335 ><H2
 336 >Description</H2
 337 ><P
 338 >Compares the contents of two ranges of memory (RAM, ROM, FLASH, etc).</P
 339 ></DIV
 340 ><DIV
 341 CLASS="REFSECT1"
 342 ><A
 343 NAME="AEN3651"
 344 ></A
 345 ><H2
 346 >Examples</H2
 347 ><P
 348 >Compare two buffers which match (result is <SPAN
 349 CLASS="emphasis"
 350 ><I
 351 CLASS="EMPHASIS"
 352 >quiet</I
 353 ></SPAN
 354 >).
 355 <TABLE
 356 BORDER="5"
 357 BGCOLOR="#E0E0F0"
 358 WIDTH="70%"
 359 ><TR
 360 ><TD
 361 ><PRE
 362 CLASS="SCREEN"
 363 >
 364 RedBoot&#62; <TT
 365 CLASS="USERINPUT"
 366 ><B
 367 >mfill -b 0x100000 -l 0x20 -p 0xDEADFACE</B
 368 ></TT
 369 >
 370 RedBoot&#62; <TT
 371 CLASS="USERINPUT"
 372 ><B
 373 >mfill -b 0x200000 -l 0x20 -p 0xDEADFACE</B
 374 ></TT
 375 >
 376 RedBoot&#62; <TT
 377 CLASS="USERINPUT"
 378 ><B
 379 >mcmp -s 0x100000 -d 0x200000 -l 0x20</B
 380 ></TT
 381 ></PRE
 382 ></TD
 383 ></TR
 384 ></TABLE
 385 > </P
 386 ><P
 387 >Compare two buffers which don't match.
 388 Only the first non-matching element is displayed.
 389 <TABLE
 390 BORDER="5"
 391 BGCOLOR="#E0E0F0"
 392 WIDTH="70%"
 393 ><TR
 394 ><TD
 395 ><PRE
 396 CLASS="SCREEN"
 397 >
 398 RedBoot&#62; <TT
 399 CLASS="USERINPUT"
 400 ><B
 401 >mcmp -s 0x100000 -d 0x200000 -l 0x30 -2</B
 402 ></TT
 403 >
 404 Buffers don't match - 0x00100020=0x6000, 0x00200020=0x0000</PRE
 405 ></TD
 406 ></TR
 407 ></TABLE
 408 >
 409       </P
 410 ></DIV
 411 ><DIV
 412 CLASS="NAVFOOTER"
 413 ><HR
 414 ALIGN="LEFT"
 415 WIDTH="100%"><TABLE
 416 SUMMARY="Footer navigation table"
 417 WIDTH="100%"
 418 BORDER="0"
 419 CELLPADDING="0"
 420 CELLSPACING="0"
 421 ><TR
 422 ><TD
 423 WIDTH="33%"
 424 ALIGN="left"
 425 VALIGN="top"
 426 ><A
 427 HREF="download-command.html"
 428 ACCESSKEY="P"
 429 >Prev</A
 430 ></TD
 431 ><TD
 432 WIDTH="34%"
 433 ALIGN="center"
 434 VALIGN="top"
 435 ><A
 436 HREF="ecos-ref.html"
 437 ACCESSKEY="H"
 438 >Home</A
 439 ></TD
 440 ><TD
 441 WIDTH="33%"
 442 ALIGN="right"
 443 VALIGN="top"
 444 ><A
 445 HREF="mfill-command.html"
 446 ACCESSKEY="N"
 447 >Next</A
 448 ></TD
 449 ></TR
 450 ><TR
 451 ><TD
 452 WIDTH="33%"
 453 ALIGN="left"
 454 VALIGN="top"
 455 >load</TD
 456 ><TD
 457 WIDTH="34%"
 458 ALIGN="center"
 459 VALIGN="top"
 460 ><A
 461 HREF="common-commands.html"
 462 ACCESSKEY="U"
 463 >Up</A
 464 ></TD
 465 ><TD
 466 WIDTH="33%"
 467 ALIGN="right"
 468 VALIGN="top"
 469 >mfill</TD
 470 ></TR
 471 ></TABLE
 472 ></DIV
 473 ></BODY
 474 ></HTML
 475 >