doc/html/ref/cksum-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 >cksum</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="channel"
  26 HREF="channel-command.html"><LINK
  27 REL="NEXT"
  28 TITLE="disks"
  29 HREF="disks-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="channel-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="disks-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="CKSUM-COMMAND">cksum</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN3155"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >cksum&nbsp;--&nbsp;Compute POSIX checksums</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN3158"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >cksum</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
 111 ></DIV
 112 ><DIV
 113 CLASS="REFSECT1"
 114 ><A
 115 NAME="AEN3165"
 116 ></A
 117 ><H2
 118 >Arguments</H2
 119 ><DIV
 120 CLASS="INFORMALTABLE"
 121 ><A
 122 NAME="AEN3167"><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 <TT
 158 CLASS="REPLACEABLE"
 159 ><I
 160 >location</I
 161 ></TT
 162 ></TD
 163 ><TD
 164 WIDTH="25%"
 165 ALIGN="LEFT"
 166 VALIGN="TOP"
 167 >Memory address</TD
 168 ><TD
 169 WIDTH="25%"
 170 ALIGN="LEFT"
 171 VALIGN="TOP"
 172 >Location in memory for stat of data.</TD
 173 ><TD
 174 WIDTH="25%"
 175 ALIGN="LEFT"
 176 VALIGN="TOP"
 177 ><SPAN
 178 CLASS="emphasis"
 179 ><I
 180 CLASS="EMPHASIS"
 181 >none</I
 182 ></SPAN
 183 ></TD
 184 ></TR
 185 ><TR
 186 ><TD
 187 WIDTH="25%"
 188 ALIGN="LEFT"
 189 VALIGN="TOP"
 190 >-l <TT
 191 CLASS="REPLACEABLE"
 192 ><I
 193 >length</I
 194 ></TT
 195 ></TD
 196 ><TD
 197 WIDTH="25%"
 198 ALIGN="LEFT"
 199 VALIGN="TOP"
 200 >Number</TD
 201 ><TD
 202 WIDTH="25%"
 203 ALIGN="LEFT"
 204 VALIGN="TOP"
 205 >Length of data</TD
 206 ><TD
 207 WIDTH="25%"
 208 ALIGN="LEFT"
 209 VALIGN="TOP"
 210 ><SPAN
 211 CLASS="emphasis"
 212 ><I
 213 CLASS="EMPHASIS"
 214 >none</I
 215 ></SPAN
 216 ></TD
 217 ></TR
 218 ></TBODY
 219 ></TABLE
 220 ><P
 221 ></P
 222 ></DIV
 223 ></DIV
 224 ><DIV
 225 CLASS="REFSECT1"
 226 ><A
 227 NAME="AEN3194"
 228 ></A
 229 ><H2
 230 >Description</H2
 231 ><P
 232 >Computes the POSIX checksum on a range of memory (either RAM or FLASH).
 233 The values printed (decimal cksum, decimal length, hexadecimal cksum,
 234           hexadecimal length) can be compared with the output from the Linux program 'cksum'.</P
 235 ></DIV
 236 ><DIV
 237 CLASS="REFSECT1"
 238 ><A
 239 NAME="AEN3197"
 240 ></A
 241 ><H2
 242 >Examples</H2
 243 ><P
 244 >Checksum a buffer.
 245 <TABLE
 246 BORDER="5"
 247 BGCOLOR="#E0E0F0"
 248 WIDTH="70%"
 249 ><TR
 250 ><TD
 251 ><PRE
 252 CLASS="SCREEN"
 253 >
 254 RedBoot&#62; <TT
 255 CLASS="USERINPUT"
 256 ><B
 257 >cksum -b 0x100000 -l 0x100</B
 258 ></TT
 259 >
 260 POSIX cksum = 3286483632 256 (0xc3e3c2b0 0x00000100)</PRE
 261 ></TD
 262 ></TR
 263 ></TABLE
 264 >
 265       </P
 266 ><P
 267 >Checksum an area of memory after loading a file. Note that the base
 268 address and length parameters are provided by the preceding
 269 load command.
 270 <TABLE
 271 BORDER="5"
 272 BGCOLOR="#E0E0F0"
 273 WIDTH="70%"
 274 ><TR
 275 ><TD
 276 ><PRE
 277 CLASS="SCREEN"
 278 >
 279 RedBoot&#62; <TT
 280 CLASS="USERINPUT"
 281 ><B
 282 >load -r -b %{FREEMEMLO} redboot.bin</B
 283 ></TT
 284 >
 285 Raw file loaded 0x06012800-0x0602f0a8
 286 RedBoot&#62; <TT
 287 CLASS="USERINPUT"
 288 ><B
 289 >cksum</B
 290 ></TT
 291 >
 292 Computing cksum for area 0x06012800-0x0602f0a8
 293 POSIX cksum = 2092197813 116904 (0x7cb467b5 0x0001c8a8)</PRE
 294 ></TD
 295 ></TR
 296 ></TABLE
 297 >
 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="channel-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="disks-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 >channel</TD
 345 ><TD
 346 WIDTH="34%"
 347 ALIGN="center"
 348 VALIGN="top"
 349 ><A
 350 HREF="common-commands.html"
 351 ACCESSKEY="U"
 352 >Up</A
 353 ></TD
 354 ><TD
 355 WIDTH="33%"
 356 ALIGN="right"
 357 VALIGN="top"
 358 >disks</TD
 359 ></TR
 360 ></TABLE
 361 ></DIV
 362 ></BODY
 363 ></HTML
 364 >