doc/html/ref/go-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 >go</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="Executing Programs from RedBoot"
  23 HREF="executing-programs.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Executing Programs from RedBoot"
  26 HREF="executing-programs.html"><LINK
  27 REL="NEXT"
  28 TITLE="exec"
  29 HREF="exec-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="executing-programs.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="exec-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="GO-COMMAND">go</H1
  83 ><DIV
  84 CLASS="REFNAMEDIV"
  85 ><A
  86 NAME="AEN4515"
  87 ></A
  88 ><H2
  89 >Name</H2
  90 >go&nbsp;--&nbsp;Execute a program</DIV
  91 ><DIV
  92 CLASS="REFSYNOPSISDIV"
  93 ><A
  94 NAME="AEN4518"><H2
  95 >Synopsis</H2
  96 ><P
  97 ><B
  98 CLASS="COMMAND"
  99 >go</B
 100 >  [-w <TT
 101 CLASS="REPLACEABLE"
 102 ><I
 103 > timeout</I
 104 ></TT
 105 >] [<TT
 106 CLASS="REPLACEABLE"
 107 ><I
 108 > start_address</I
 109 ></TT
 110 >]</P
 111 ></DIV
 112 ><DIV
 113 CLASS="REFSECT1"
 114 ><A
 115 NAME="AEN4525"
 116 ></A
 117 ><H2
 118 >Arguments</H2
 119 ><DIV
 120 CLASS="INFORMALTABLE"
 121 ><A
 122 NAME="AEN4527"><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 >-w <TT
 158 CLASS="REPLACEABLE"
 159 ><I
 160 >timeout</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 >How long to wait before starting execution.</TD
 173 ><TD
 174 WIDTH="25%"
 175 ALIGN="LEFT"
 176 VALIGN="TOP"
 177 >0</TD
 178 ></TR
 179 ><TR
 180 ><TD
 181 WIDTH="25%"
 182 ALIGN="LEFT"
 183 VALIGN="TOP"
 184 ><TT
 185 CLASS="REPLACEABLE"
 186 ><I
 187 >start_address</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 >Address in memory to begin execution.</TD
 200 ><TD
 201 WIDTH="25%"
 202 ALIGN="LEFT"
 203 VALIGN="TOP"
 204 >Value set by last <B
 205 CLASS="COMMAND"
 206 >load</B
 207 > or <B
 208 CLASS="COMMAND"
 209 >fis load</B
 210 > command.</TD
 211 ></TR
 212 ></TBODY
 213 ></TABLE
 214 ><P
 215 ></P
 216 ></DIV
 217 ></DIV
 218 ><DIV
 219 CLASS="REFSECT1"
 220 ><A
 221 NAME="AEN4554"
 222 ></A
 223 ><H2
 224 >Description</H2
 225 ><P
 226 >The <B
 227 CLASS="COMMAND"
 228 >go</B
 229 > command causes RedBoot to give control of the target platform to
 230 another program.  This program must execute stand alone, e.g. an eCos
 231 application or a Linux kernel.
 232       </P
 233 ><P
 234 >If the -w option is used, RedBoot will print a message and then
 235 wait for a period of time before starting the execution.  This is
 236 most useful in a script, giving the user a chance to abort executing
 237 a program and move on in the script.
 238       </P
 239 ></DIV
 240 ><DIV
 241 CLASS="REFSECT1"
 242 ><A
 243 NAME="AEN4559"
 244 ></A
 245 ><H2
 246 >Examples</H2
 247 ><P
 248 >Execute a program - <SPAN
 249 CLASS="emphasis"
 250 ><I
 251 CLASS="EMPHASIS"
 252 >no explicit output from RedBoot</I
 253 ></SPAN
 254 >.
 255 <TABLE
 256 BORDER="5"
 257 BGCOLOR="#E0E0F0"
 258 WIDTH="70%"
 259 ><TR
 260 ><TD
 261 ><PRE
 262 CLASS="SCREEN"
 263 >RedBoot&#62; <TT
 264 CLASS="USERINPUT"
 265 ><B
 266 >go 0x40040</B
 267 ></TT
 268 ></PRE
 269 ></TD
 270 ></TR
 271 ></TABLE
 272 >
 273       </P
 274 ><P
 275 >Execute a program with a timeout.
 276 <TABLE
 277 BORDER="5"
 278 BGCOLOR="#E0E0F0"
 279 WIDTH="70%"
 280 ><TR
 281 ><TD
 282 ><PRE
 283 CLASS="SCREEN"
 284 >RedBoot&#62; <TT
 285 CLASS="USERINPUT"
 286 ><B
 287 >go -w 10</B
 288 ></TT
 289 >
 290 About to start execution at 0x00000000 - abort with ^C within 10 seconds
 291 ^C
 292 RedBoot&#62;</PRE
 293 ></TD
 294 ></TR
 295 ></TABLE
 296 >
 297 Note that the starting address was implied (0x00000000 in this example).
 298 The user is prompted that execution will commence in 10 seconds.  At
 299 anytime within that 10 seconds the user may type  <SPAN
 300 CLASS="GUIBUTTON"
 301 >Ctrl+C</SPAN
 302 >
 303 on the console and RedBoot will abort execution and return for the next
 304 command, either from a script or the console.
 305       </P
 306 ></DIV
 307 ><DIV
 308 CLASS="NAVFOOTER"
 309 ><HR
 310 ALIGN="LEFT"
 311 WIDTH="100%"><TABLE
 312 SUMMARY="Footer navigation table"
 313 WIDTH="100%"
 314 BORDER="0"
 315 CELLPADDING="0"
 316 CELLSPACING="0"
 317 ><TR
 318 ><TD
 319 WIDTH="33%"
 320 ALIGN="left"
 321 VALIGN="top"
 322 ><A
 323 HREF="executing-programs.html"
 324 ACCESSKEY="P"
 325 >Prev</A
 326 ></TD
 327 ><TD
 328 WIDTH="34%"
 329 ALIGN="center"
 330 VALIGN="top"
 331 ><A
 332 HREF="ecos-ref.html"
 333 ACCESSKEY="H"
 334 >Home</A
 335 ></TD
 336 ><TD
 337 WIDTH="33%"
 338 ALIGN="right"
 339 VALIGN="top"
 340 ><A
 341 HREF="exec-command.html"
 342 ACCESSKEY="N"
 343 >Next</A
 344 ></TD
 345 ></TR
 346 ><TR
 347 ><TD
 348 WIDTH="33%"
 349 ALIGN="left"
 350 VALIGN="top"
 351 >Executing Programs from RedBoot</TD
 352 ><TD
 353 WIDTH="34%"
 354 ALIGN="center"
 355 VALIGN="top"
 356 ><A
 357 HREF="executing-programs.html"
 358 ACCESSKEY="U"
 359 >Up</A
 360 ></TD
 361 ><TD
 362 WIDTH="33%"
 363 ALIGN="right"
 364 VALIGN="top"
 365 >exec</TD
 366 ></TR
 367 ></TABLE
 368 ></DIV
 369 ></BODY
 370 ></HTML
 371 >