doc/html/ref/fis-list-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 list</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 init"
  26 HREF="fis-init-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="fis free"
  29 HREF="fis-free-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-init-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-free-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-LIST-COMMAND">fis list</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN3936"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >fis list&nbsp;--&nbsp;List Flash Image System directory</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN3939"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >fis list</B
 100 >  [<TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 >-f</I
 104 ></TT
 105 >]</P
 106 ></DIV
 107 ><DIV
 108 CLASS="REFSECT1"
 109 ><A
 110 NAME="AEN3944"
 111 ></A
 112 ><H2
 113 >Arguments</H2
 114 ><DIV
 115 CLASS="INFORMALTABLE"
 116 ><A
 117 NAME="AEN3946"><P
 118 ></P
 119 ><TABLE
 120 BORDER="1"
 121 CLASS="CALSTABLE"
 122 ><THEAD
 123 ><TR
 124 ><TH
 125 WIDTH="25%"
 126 ALIGN="LEFT"
 127 VALIGN="TOP"
 128 >Name</TH
 129 ><TH
 130 WIDTH="25%"
 131 ALIGN="LEFT"
 132 VALIGN="TOP"
 133 >Type</TH
 134 ><TH
 135 WIDTH="25%"
 136 ALIGN="LEFT"
 137 VALIGN="TOP"
 138 >Description</TH
 139 ><TH
 140 WIDTH="25%"
 141 ALIGN="LEFT"
 142 VALIGN="TOP"
 143 >Default</TH
 144 ></TR
 145 ></THEAD
 146 ><TBODY
 147 ><TR
 148 ><TD
 149 WIDTH="25%"
 150 ALIGN="LEFT"
 151 VALIGN="TOP"
 152 >-c</TD
 153 ><TD
 154 WIDTH="25%"
 155 ALIGN="LEFT"
 156 VALIGN="TOP"
 157 >&nbsp;</TD
 158 ><TD
 159 WIDTH="25%"
 160 ALIGN="LEFT"
 161 VALIGN="TOP"
 162 >Show image checksum instead of memory address
 163               (column <TT
 164 CLASS="COMPUTEROUTPUT"
 165 >Mem addr</TT
 166 > is
 167               replaced by
 168               <TT
 169 CLASS="COMPUTEROUTPUT"
 170 >Checksum</TT
 171 >).</TD
 172 ><TD
 173 WIDTH="25%"
 174 ALIGN="LEFT"
 175 VALIGN="TOP"
 176 >&nbsp;</TD
 177 ></TR
 178 ><TR
 179 ><TD
 180 WIDTH="25%"
 181 ALIGN="LEFT"
 182 VALIGN="TOP"
 183 >-d</TD
 184 ><TD
 185 WIDTH="25%"
 186 ALIGN="LEFT"
 187 VALIGN="TOP"
 188 >&nbsp;</TD
 189 ><TD
 190 WIDTH="25%"
 191 ALIGN="LEFT"
 192 VALIGN="TOP"
 193 >Show image data length instead of amount of flash
 194               occupied by image (column
 195               <TT
 196 CLASS="COMPUTEROUTPUT"
 197 >Length</TT
 198 > is replaced by
 199               <TT
 200 CLASS="COMPUTEROUTPUT"
 201 >Datalen</TT
 202 >).</TD
 203 ><TD
 204 WIDTH="25%"
 205 ALIGN="LEFT"
 206 VALIGN="TOP"
 207 >&nbsp;</TD
 208 ></TR
 209 ></TBODY
 210 ></TABLE
 211 ><P
 212 ></P
 213 ></DIV
 214 ></DIV
 215 ><DIV
 216 CLASS="REFSECT1"
 217 ><A
 218 NAME="AEN3973"
 219 ></A
 220 ><H2
 221 >Description</H2
 222 ><P
 223 >This command lists the images currently available in the FIS. Certain
 224 images used by RedBoot have fixed names and have reserved slots in the
 225 FIS (these can be seen after using the <B
 226 CLASS="COMMAND"
 227 >fis init</B
 228 >
 229 command). Other images can be manipulated by the user.</P
 230 ><DIV
 231 CLASS="NOTE"
 232 ><BLOCKQUOTE
 233 CLASS="NOTE"
 234 ><P
 235 ><B
 236 >Note: </B
 237 >The images are listed in the order they appear in the FIS
 238 directory, not by name or creation time.</P
 239 ></BLOCKQUOTE
 240 ></DIV
 241 ></DIV
 242 ><DIV
 243 CLASS="REFSECT1"
 244 ><A
 245 NAME="AEN3979"
 246 ></A
 247 ><H2
 248 >Examples</H2
 249 ><P
 250 >List the FIS directory.
 251 <TABLE
 252 BORDER="5"
 253 BGCOLOR="#E0E0F0"
 254 WIDTH="70%"
 255 ><TR
 256 ><TD
 257 ><PRE
 258 CLASS="SCREEN"
 259 >
 260 RedBoot&#62; <TT
 261 CLASS="USERINPUT"
 262 ><B
 263 >fis list</B
 264 ></TT
 265 >
 266 Name              FLASH addr  Mem addr    Length      Entry point
 267 RedBoot           0x00000000  0x00000000  0x00020000  0x00000000
 268 RedBoot config    0x0007F000  0x0007F000  0x00001000  0x00000000
 269 FIS directory     0x00070000  0x00070000  0x0000F000  0x00000000                </PRE
 270 ></TD
 271 ></TR
 272 ></TABLE
 273 > </P
 274 ><P
 275 >List the FIS directory, with image checksums substituted for
 276 memory addresses.
 277 <TABLE
 278 BORDER="5"
 279 BGCOLOR="#E0E0F0"
 280 WIDTH="70%"
 281 ><TR
 282 ><TD
 283 ><PRE
 284 CLASS="SCREEN"
 285 >
 286 RedBoot&#62; <TT
 287 CLASS="USERINPUT"
 288 ><B
 289 >fis list -c</B
 290 ></TT
 291 >
 292 Name              FLASH addr  Checksum    Length      Entry point
 293 RedBoot           0x00000000  0x00000000  0x00020000  0x00000000
 294 RedBoot config    0x0007F000  0x00000000  0x00001000  0x00000000
 295 FIS directory     0x00070000  0x00000000  0x0000F000  0x00000000                </PRE
 296 ></TD
 297 ></TR
 298 ></TABLE
 299 > </P
 300 ><P
 301 >List the FIS directory with image data lengths substituted for flash
 302 block reservation lengths.
 303 <TABLE
 304 BORDER="5"
 305 BGCOLOR="#E0E0F0"
 306 WIDTH="70%"
 307 ><TR
 308 ><TD
 309 ><PRE
 310 CLASS="SCREEN"
 311 >
 312 RedBoot&#62; <TT
 313 CLASS="USERINPUT"
 314 ><B
 315 >fis list</B
 316 ></TT
 317 >
 318 Name              FLASH addr  Mem addr    Datalen     Entry point
 319 RedBoot           0x00000000  0x00000000  0x00000000  0x00000000
 320 RedBoot config    0x0007F000  0x0007F000  0x00000000  0x00000000
 321 FIS directory     0x00070000  0x00070000  0x00000000  0x00000000                </PRE
 322 ></TD
 323 ></TR
 324 ></TABLE
 325 > </P
 326 ></DIV
 327 ><DIV
 328 CLASS="NAVFOOTER"
 329 ><HR
 330 ALIGN="LEFT"
 331 WIDTH="100%"><TABLE
 332 SUMMARY="Footer navigation table"
 333 WIDTH="100%"
 334 BORDER="0"
 335 CELLPADDING="0"
 336 CELLSPACING="0"
 337 ><TR
 338 ><TD
 339 WIDTH="33%"
 340 ALIGN="left"
 341 VALIGN="top"
 342 ><A
 343 HREF="fis-init-command.html"
 344 ACCESSKEY="P"
 345 >Prev</A
 346 ></TD
 347 ><TD
 348 WIDTH="34%"
 349 ALIGN="center"
 350 VALIGN="top"
 351 ><A
 352 HREF="ecos-ref.html"
 353 ACCESSKEY="H"
 354 >Home</A
 355 ></TD
 356 ><TD
 357 WIDTH="33%"
 358 ALIGN="right"
 359 VALIGN="top"
 360 ><A
 361 HREF="fis-free-command.html"
 362 ACCESSKEY="N"
 363 >Next</A
 364 ></TD
 365 ></TR
 366 ><TR
 367 ><TD
 368 WIDTH="33%"
 369 ALIGN="left"
 370 VALIGN="top"
 371 >fis init</TD
 372 ><TD
 373 WIDTH="34%"
 374 ALIGN="center"
 375 VALIGN="top"
 376 ><A
 377 HREF="flash-image-system.html"
 378 ACCESSKEY="U"
 379 >Up</A
 380 ></TD
 381 ><TD
 382 WIDTH="33%"
 383 ALIGN="right"
 384 VALIGN="top"
 385 >fis free</TD
 386 ></TR
 387 ></TABLE
 388 ></DIV
 389 ></BODY
 390 ></HTML
 391 >