doc/html/ref/mfill-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 >mfill</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="mcmp"
  26 HREF="mcmp-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="ping"
  29 HREF="ping-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="mcmp-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="ping-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="MFILL-COMMAND">mfill</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN3663"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >mfill&nbsp;--&nbsp;Fill RAM with a specified pattern</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN3666"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >mfill</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 >} {-p <TT
 111 CLASS="REPLACEABLE"
 112 ><I
 113 >value</I
 114 ></TT
 115 >} [-1 | -2 | -4]</P
 116 ></DIV
 117 ><DIV
 118 CLASS="REFSECT1"
 119 ><A
 120 NAME="AEN3679"
 121 ></A
 122 ><H2
 123 >Arguments</H2
 124 ><DIV
 125 CLASS="INFORMALTABLE"
 126 ><A
 127 NAME="AEN3681"><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 >-b <TT
 163 CLASS="REPLACEABLE"
 164 ><I
 165 >location</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 in memory 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 >-l <TT
 196 CLASS="REPLACEABLE"
 197 ><I
 198 >length</I
 199 ></TT
 200 ></TD
 201 ><TD
 202 WIDTH="25%"
 203 ALIGN="LEFT"
 204 VALIGN="TOP"
 205 >Number</TD
 206 ><TD
 207 WIDTH="25%"
 208 ALIGN="LEFT"
 209 VALIGN="TOP"
 210 >Length 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 >-p <TT
 229 CLASS="REPLACEABLE"
 230 ><I
 231 >pattern</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 >Data value to fill with</TD
 244 ><TD
 245 WIDTH="25%"
 246 ALIGN="LEFT"
 247 VALIGN="TOP"
 248 >0</TD
 249 ></TR
 250 ><TR
 251 ><TD
 252 WIDTH="25%"
 253 ALIGN="LEFT"
 254 VALIGN="TOP"
 255 >-1</TD
 256 ><TD
 257 WIDTH="25%"
 258 ALIGN="LEFT"
 259 VALIGN="TOP"
 260 >&nbsp;</TD
 261 ><TD
 262 WIDTH="25%"
 263 ALIGN="LEFT"
 264 VALIGN="TOP"
 265 >Access one byte (8 bits) at a time.
 266 Only the least significant 8 bits of the pattern will be used.</TD
 267 ><TD
 268 WIDTH="25%"
 269 ALIGN="LEFT"
 270 VALIGN="TOP"
 271 >-4</TD
 272 ></TR
 273 ><TR
 274 ><TD
 275 WIDTH="25%"
 276 ALIGN="LEFT"
 277 VALIGN="TOP"
 278 >-2</TD
 279 ><TD
 280 WIDTH="25%"
 281 ALIGN="LEFT"
 282 VALIGN="TOP"
 283 >&nbsp;</TD
 284 ><TD
 285 WIDTH="25%"
 286 ALIGN="LEFT"
 287 VALIGN="TOP"
 288 >Access two bytes (16 bits) at a time.
 289 Only the least significant 16 bits of the pattern will be used.</TD
 290 ><TD
 291 WIDTH="25%"
 292 ALIGN="LEFT"
 293 VALIGN="TOP"
 294 >-4</TD
 295 ></TR
 296 ><TR
 297 ><TD
 298 WIDTH="25%"
 299 ALIGN="LEFT"
 300 VALIGN="TOP"
 301 >-4</TD
 302 ><TD
 303 WIDTH="25%"
 304 ALIGN="LEFT"
 305 VALIGN="TOP"
 306 >&nbsp;</TD
 307 ><TD
 308 WIDTH="25%"
 309 ALIGN="LEFT"
 310 VALIGN="TOP"
 311 >Access one word (32 bits) at a time.</TD
 312 ><TD
 313 WIDTH="25%"
 314 ALIGN="LEFT"
 315 VALIGN="TOP"
 316 >-4</TD
 317 ></TR
 318 ></TBODY
 319 ></TABLE
 320 ><P
 321 ></P
 322 ></DIV
 323 ></DIV
 324 ><DIV
 325 CLASS="REFSECT1"
 326 ><A
 327 NAME="AEN3729"
 328 ></A
 329 ><H2
 330 >Description</H2
 331 ><P
 332 >Fills a range of memory with the given pattern.</P
 333 ></DIV
 334 ><DIV
 335 CLASS="REFSECT1"
 336 ><A
 337 NAME="AEN3732"
 338 ></A
 339 ><H2
 340 >Examples</H2
 341 ><P
 342 >Fill a buffer with zeros.
 343 <TABLE
 344 BORDER="5"
 345 BGCOLOR="#E0E0F0"
 346 WIDTH="70%"
 347 ><TR
 348 ><TD
 349 ><PRE
 350 CLASS="SCREEN"
 351 >
 352 RedBoot&#62; <TT
 353 CLASS="USERINPUT"
 354 ><B
 355 >x -b 0x100000 -l 0x20</B
 356 ></TT
 357 >
 358 00100000: 00 3E 00 06 00 06 00 06  00 00 00 00 00 00 00 00  |.&#62;..............|
 359 00100010: 00 00 00 78 00 70 00 60  00 60 00 60 00 60 00 60  |...x.p.`.`.`.`.`|
 360 RedBoot&#62; <TT
 361 CLASS="USERINPUT"
 362 ><B
 363 >mfill -b 0x100000 -l 0x20</B
 364 ></TT
 365 >
 366 RedBoot&#62; <TT
 367 CLASS="USERINPUT"
 368 ><B
 369 >x -b 0x100000 -l 0x20</B
 370 ></TT
 371 >
 372 00100000: 00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|
 373 00100010: 00 00 00 00 00 00 00 00  00 00 00 00 00 00 00 00  |................|</PRE
 374 ></TD
 375 ></TR
 376 ></TABLE
 377 > </P
 378 ><P
 379 >Fill a buffer with a pattern.
 380 <TABLE
 381 BORDER="5"
 382 BGCOLOR="#E0E0F0"
 383 WIDTH="70%"
 384 ><TR
 385 ><TD
 386 ><PRE
 387 CLASS="SCREEN"
 388 >
 389 RedBoot&#62; <TT
 390 CLASS="USERINPUT"
 391 ><B
 392 >mfill -b 0x100000 -l 0x20 -p 0xDEADFACE</B
 393 ></TT
 394 >
 395 RedBoot&#62; <TT
 396 CLASS="USERINPUT"
 397 ><B
 398 >x -b 0x100000 -l 0x20</B
 399 ></TT
 400 >
 401 00100000: CE FA AD DE CE FA AD DE  CE FA AD DE CE FA AD DE  |................|
 402 00100010: CE FA AD DE CE FA AD DE  CE FA AD DE CE FA AD DE  |................|</PRE
 403 ></TD
 404 ></TR
 405 ></TABLE
 406 >
 407       </P
 408 ></DIV
 409 ><DIV
 410 CLASS="NAVFOOTER"
 411 ><HR
 412 ALIGN="LEFT"
 413 WIDTH="100%"><TABLE
 414 SUMMARY="Footer navigation table"
 415 WIDTH="100%"
 416 BORDER="0"
 417 CELLPADDING="0"
 418 CELLSPACING="0"
 419 ><TR
 420 ><TD
 421 WIDTH="33%"
 422 ALIGN="left"
 423 VALIGN="top"
 424 ><A
 425 HREF="mcmp-command.html"
 426 ACCESSKEY="P"
 427 >Prev</A
 428 ></TD
 429 ><TD
 430 WIDTH="34%"
 431 ALIGN="center"
 432 VALIGN="top"
 433 ><A
 434 HREF="ecos-ref.html"
 435 ACCESSKEY="H"
 436 >Home</A
 437 ></TD
 438 ><TD
 439 WIDTH="33%"
 440 ALIGN="right"
 441 VALIGN="top"
 442 ><A
 443 HREF="ping-command.html"
 444 ACCESSKEY="N"
 445 >Next</A
 446 ></TD
 447 ></TR
 448 ><TR
 449 ><TD
 450 WIDTH="33%"
 451 ALIGN="left"
 452 VALIGN="top"
 453 >mcmp</TD
 454 ><TD
 455 WIDTH="34%"
 456 ALIGN="center"
 457 VALIGN="top"
 458 ><A
 459 HREF="common-commands.html"
 460 ACCESSKEY="U"
 461 >Up</A
 462 ></TD
 463 ><TD
 464 WIDTH="33%"
 465 ALIGN="right"
 466 VALIGN="top"
 467 >ping</TD
 468 ></TR
 469 ></TABLE
 470 ></DIV
 471 ></BODY
 472 ></HTML
 473 >