doc/html/ref/fis-lock-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 lock</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 delete"
  26 HREF="fis-delete-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="fis unlock"
  29 HREF="fis-unlock-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-delete-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-unlock-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-LOCK-COMMAND">fis lock</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN4208"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >fis lock&nbsp;--&nbsp;Lock flash area</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN4211"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >fis lock</B
 100 >  {-f <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 >flash_address</I
 104 ></TT
 105 >} {-l <TT
 106 CLASS="REPLACEABLE"
 107 ><I
 108 >length</I
 109 ></TT
 110 >}</P
 111 ></DIV
 112 ><DIV
 113 CLASS="REFSECT1"
 114 ><A
 115 NAME="AEN4218"
 116 ></A
 117 ><H2
 118 >Arguments</H2
 119 ><DIV
 120 CLASS="INFORMALTABLE"
 121 ><A
 122 NAME="AEN4220"><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 ><TT
 158 CLASS="REPLACEABLE"
 159 ><I
 160 >flash_address</I
 161 ></TT
 162 ></TD
 163 ><TD
 164 WIDTH="25%"
 165 ALIGN="LEFT"
 166 VALIGN="TOP"
 167 >Number</TD
 168 ><TD
 169 WIDTH="25%"
 170 ALIGN="LEFT"
 171 VALIGN="TOP"
 172 >Address of area to be locked.</TD
 173 ><TD
 174 WIDTH="25%"
 175 ALIGN="LEFT"
 176 VALIGN="TOP"
 177 >&nbsp;</TD
 178 ></TR
 179 ><TR
 180 ><TD
 181 WIDTH="25%"
 182 ALIGN="LEFT"
 183 VALIGN="TOP"
 184 ><TT
 185 CLASS="REPLACEABLE"
 186 ><I
 187 >length</I
 188 ></TT
 189 ></TD
 190 ><TD
 191 WIDTH="25%"
 192 ALIGN="LEFT"
 193 VALIGN="TOP"
 194 >Number</TD
 195 ><TD
 196 WIDTH="25%"
 197 ALIGN="LEFT"
 198 VALIGN="TOP"
 199 >Length of area to be locked.</TD
 200 ><TD
 201 WIDTH="25%"
 202 ALIGN="LEFT"
 203 VALIGN="TOP"
 204 >&nbsp;</TD
 205 ></TR
 206 ></TBODY
 207 ></TABLE
 208 ><P
 209 ></P
 210 ></DIV
 211 ></DIV
 212 ><DIV
 213 CLASS="REFSECT1"
 214 ><A
 215 NAME="AEN4245"
 216 ></A
 217 ><H2
 218 >Description</H2
 219 ><P
 220 >This command is used to write-protect (lock) a portion of flash memory,
 221 to prevent accidental overwriting of images. In order to make make any modifications
 222 to the flash, a matching <B
 223 CLASS="COMMAND"
 224 >fis unlock</B
 225 > command must be
 226 issued. This command is optional and will only be provided on hardware
 227 which can support write-protection of the flash space.</P
 228 ><DIV
 229 CLASS="NOTE"
 230 ><BLOCKQUOTE
 231 CLASS="NOTE"
 232 ><P
 233 ><B
 234 >Note: </B
 235 >Depending on the system, attempting to write to write-protected flash
 236 may generate errors or warnings, or be benignly quiet.  </P
 237 ></BLOCKQUOTE
 238 ></DIV
 239 ></DIV
 240 ><DIV
 241 CLASS="REFSECT1"
 242 ><A
 243 NAME="AEN4251"
 244 ></A
 245 ><H2
 246 >Examples</H2
 247 ><P
 248 >Lock an area of the flash
 249 <TABLE
 250 BORDER="5"
 251 BGCOLOR="#E0E0F0"
 252 WIDTH="70%"
 253 ><TR
 254 ><TD
 255 ><PRE
 256 CLASS="SCREEN"
 257 >RedBoot&#62; <TT
 258 CLASS="USERINPUT"
 259 ><B
 260 >fis lock -f 0xa0040000 -l 0x20000</B
 261 ></TT
 262 >
 263 ... Lock from 0xa0040000-0xa0060000: .</PRE
 264 ></TD
 265 ></TR
 266 ></TABLE
 267 ></P
 268 ></DIV
 269 ><DIV
 270 CLASS="NAVFOOTER"
 271 ><HR
 272 ALIGN="LEFT"
 273 WIDTH="100%"><TABLE
 274 SUMMARY="Footer navigation table"
 275 WIDTH="100%"
 276 BORDER="0"
 277 CELLPADDING="0"
 278 CELLSPACING="0"
 279 ><TR
 280 ><TD
 281 WIDTH="33%"
 282 ALIGN="left"
 283 VALIGN="top"
 284 ><A
 285 HREF="fis-delete-command.html"
 286 ACCESSKEY="P"
 287 >Prev</A
 288 ></TD
 289 ><TD
 290 WIDTH="34%"
 291 ALIGN="center"
 292 VALIGN="top"
 293 ><A
 294 HREF="ecos-ref.html"
 295 ACCESSKEY="H"
 296 >Home</A
 297 ></TD
 298 ><TD
 299 WIDTH="33%"
 300 ALIGN="right"
 301 VALIGN="top"
 302 ><A
 303 HREF="fis-unlock-command.html"
 304 ACCESSKEY="N"
 305 >Next</A
 306 ></TD
 307 ></TR
 308 ><TR
 309 ><TD
 310 WIDTH="33%"
 311 ALIGN="left"
 312 VALIGN="top"
 313 >fis delete</TD
 314 ><TD
 315 WIDTH="34%"
 316 ALIGN="center"
 317 VALIGN="top"
 318 ><A
 319 HREF="flash-image-system.html"
 320 ACCESSKEY="U"
 321 >Up</A
 322 ></TD
 323 ><TD
 324 WIDTH="33%"
 325 ALIGN="right"
 326 VALIGN="top"
 327 >fis unlock</TD
 328 ></TR
 329 ></TABLE
 330 ></DIV
 331 ></BODY
 332 ></HTML
 333 >