doc/html/ref/fis-load-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 >fis load</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="Flash Image System (FIS)"
  23 HREF="flash-image-system.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="fis create"
  26 HREF="fis-create-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="fis delete"
  29 HREF="fis-delete-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="fis-create-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="fis-delete-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="FIS-LOAD-COMMAND">fis load</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN4109"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >fis load&nbsp;--&nbsp;Load flash image</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN4112"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >fis load</B
 100 >  [-b <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 > load address</I
 104 ></TT
 105 >] [-c ] [-d ] [<TT
 106 CLASS="REPLACEABLE"
 107 ><I
 108 >name</I
 109 ></TT
 110 >]</P
 111 ></DIV
 112 ><DIV
 113 CLASS="REFSECT1"
 114 ><A
 115 NAME="AEN4121"
 116 ></A
 117 ><H2
 118 >Arguments</H2
 119 ><DIV
 120 CLASS="INFORMALTABLE"
 121 ><A
 122 NAME="AEN4123"><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</TD
 158 ><TD
 159 WIDTH="25%"
 160 ALIGN="LEFT"
 161 VALIGN="TOP"
 162 >Number</TD
 163 ><TD
 164 WIDTH="25%"
 165 ALIGN="LEFT"
 166 VALIGN="TOP"
 167 >Address the image should be loaded to. Executable
 168               images normally load at the location to which the file
 169               was linked. This option allows the image to be loaded to
 170               a specific memory location, possibly overriding any
 171               assumed location.</TD
 172 ><TD
 173 WIDTH="25%"
 174 ALIGN="LEFT"
 175 VALIGN="TOP"
 176 >If not specified, the address associated with the
 177               image in the FIS directory will be used.</TD
 178 ></TR
 179 ><TR
 180 ><TD
 181 WIDTH="25%"
 182 ALIGN="LEFT"
 183 VALIGN="TOP"
 184 >-c</TD
 185 ><TD
 186 WIDTH="25%"
 187 ALIGN="LEFT"
 188 VALIGN="TOP"
 189 >&nbsp;</TD
 190 ><TD
 191 WIDTH="25%"
 192 ALIGN="LEFT"
 193 VALIGN="TOP"
 194 >Compute and print the checksum of the image data
 195               after it has been loaded into memory.</TD
 196 ><TD
 197 >&nbsp;</TD
 198 ></TR
 199 ><TR
 200 ><TD
 201 WIDTH="25%"
 202 ALIGN="LEFT"
 203 VALIGN="TOP"
 204 >-d</TD
 205 ><TD
 206 WIDTH="25%"
 207 ALIGN="LEFT"
 208 VALIGN="TOP"
 209 >&nbsp;</TD
 210 ><TD
 211 WIDTH="25%"
 212 ALIGN="LEFT"
 213 VALIGN="TOP"
 214 >Decompress gzipped image while copying it from
 215               flash to RAM.</TD
 216 ><TD
 217 >&nbsp;</TD
 218 ></TR
 219 ><TR
 220 ><TD
 221 WIDTH="25%"
 222 ALIGN="LEFT"
 223 VALIGN="TOP"
 224 ><TT
 225 CLASS="REPLACEABLE"
 226 ><I
 227 >name</I
 228 ></TT
 229 ></TD
 230 ><TD
 231 WIDTH="25%"
 232 ALIGN="LEFT"
 233 VALIGN="TOP"
 234 >String</TD
 235 ><TD
 236 WIDTH="25%"
 237 ALIGN="LEFT"
 238 VALIGN="TOP"
 239 >The name of the file, as shown in the FIS
 240               directory.</TD
 241 ><TD
 242 >&nbsp;</TD
 243 ></TR
 244 ></TBODY
 245 ></TABLE
 246 ><P
 247 ></P
 248 ></DIV
 249 ></DIV
 250 ><DIV
 251 CLASS="REFSECT1"
 252 ><A
 253 NAME="AEN4154"
 254 ></A
 255 ><H2
 256 >Description</H2
 257 ><P
 258 >This command is used to transfer an image from flash memory to RAM.</P
 259 ><P
 260 >Once the image has been loaded, it may be executed using the
 261 <B
 262 CLASS="COMMAND"
 263 >go</B
 264 > command.</P
 265 ></DIV
 266 ><DIV
 267 CLASS="REFSECT1"
 268 ><A
 269 NAME="AEN4159"
 270 ></A
 271 ><H2
 272 >Examples</H2
 273 ><P
 274 >Load and run RedBoot[RAM] image.
 275 <TABLE
 276 BORDER="5"
 277 BGCOLOR="#E0E0F0"
 278 WIDTH="70%"
 279 ><TR
 280 ><TD
 281 ><PRE
 282 CLASS="SCREEN"
 283 >RedBoot&#62; <TT
 284 CLASS="USERINPUT"
 285 ><B
 286 >fis load RedBoot[RAM]</B
 287 ></TT
 288 >
 289 RedBoot&#62; <TT
 290 CLASS="USERINPUT"
 291 ><B
 292 >go</B
 293 ></TT
 294 ></PRE
 295 ></TD
 296 ></TR
 297 ></TABLE
 298 ></P
 299 ></DIV
 300 ><DIV
 301 CLASS="NAVFOOTER"
 302 ><HR
 303 ALIGN="LEFT"
 304 WIDTH="100%"><TABLE
 305 SUMMARY="Footer navigation table"
 306 WIDTH="100%"
 307 BORDER="0"
 308 CELLPADDING="0"
 309 CELLSPACING="0"
 310 ><TR
 311 ><TD
 312 WIDTH="33%"
 313 ALIGN="left"
 314 VALIGN="top"
 315 ><A
 316 HREF="fis-create-command.html"
 317 ACCESSKEY="P"
 318 >Prev</A
 319 ></TD
 320 ><TD
 321 WIDTH="34%"
 322 ALIGN="center"
 323 VALIGN="top"
 324 ><A
 325 HREF="ecos-ref.html"
 326 ACCESSKEY="H"
 327 >Home</A
 328 ></TD
 329 ><TD
 330 WIDTH="33%"
 331 ALIGN="right"
 332 VALIGN="top"
 333 ><A
 334 HREF="fis-delete-command.html"
 335 ACCESSKEY="N"
 336 >Next</A
 337 ></TD
 338 ></TR
 339 ><TR
 340 ><TD
 341 WIDTH="33%"
 342 ALIGN="left"
 343 VALIGN="top"
 344 >fis create</TD
 345 ><TD
 346 WIDTH="34%"
 347 ALIGN="center"
 348 VALIGN="top"
 349 ><A
 350 HREF="flash-image-system.html"
 351 ACCESSKEY="U"
 352 >Up</A
 353 ></TD
 354 ><TD
 355 WIDTH="33%"
 356 ALIGN="right"
 357 VALIGN="top"
 358 >fis delete</TD
 359 ></TR
 360 ></TABLE
 361 ></DIV
 362 ></BODY
 363 ></HTML
 364 >