URL
https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk
Subversion Repositories openrisc_2011-10-31
[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [go-command.html] - Rev 174
Compare with Previous | Blame | View Log
<!-- Copyright (C) 2003 Red Hat, Inc. -->
<!-- This material may be distributed only subject to the terms -->
<!-- and conditions set forth in the Open Publication License, v1.0 -->
<!-- or later (the latest version is presently available at -->
<!-- http://www.opencontent.org/openpub/). -->
<!-- Distribution of the work or derivative of the work in any -->
<!-- standard (paper) book form is prohibited unless prior -->
<!-- permission is obtained from the copyright holder. -->
<HTML
><HEAD
><TITLE
>go</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos Reference Manual"
HREF="ecos-ref.html"><LINK
REL="UP"
TITLE="Executing Programs from RedBoot"
HREF="executing-programs.html"><LINK
REL="PREVIOUS"
TITLE="Executing Programs from RedBoot"
HREF="executing-programs.html"><LINK
REL="NEXT"
TITLE="exec"
HREF="exec-command.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>eCos Reference Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="executing-programs.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="exec-command.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><H1
><A
NAME="GO-COMMAND">go</H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN4515"
></A
><H2
>Name</H2
>go -- Execute a program</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN4518"><H2
>Synopsis</H2
><P
><B
CLASS="COMMAND"
>go</B
> [-w <TT
CLASS="REPLACEABLE"
><I
> timeout</I
></TT
>] [<TT
CLASS="REPLACEABLE"
><I
> start_address</I
></TT
>]</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4525"
></A
><H2
>Arguments</H2
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN4527"><P
></P
><TABLE
BORDER="1"
CLASS="CALSTABLE"
><THEAD
><TR
><TH
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Name</TH
><TH
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Type</TH
><TH
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Description</TH
><TH
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Default</TH
></TR
></THEAD
><TBODY
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>-w <TT
CLASS="REPLACEABLE"
><I
>timeout</I
></TT
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Number</TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>How long to wait before starting execution.</TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>0</TD
></TR
><TR
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
><TT
CLASS="REPLACEABLE"
><I
>start_address</I
></TT
></TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Number</TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Address in memory to begin execution.</TD
><TD
WIDTH="25%"
ALIGN="LEFT"
VALIGN="TOP"
>Value set by last <B
CLASS="COMMAND"
>load</B
> or <B
CLASS="COMMAND"
>fis load</B
> command.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4554"
></A
><H2
>Description</H2
><P
>The <B
CLASS="COMMAND"
>go</B
> command causes RedBoot to give control of the target platform to
another program. This program must execute stand alone, e.g. an eCos
application or a Linux kernel.
</P
><P
>If the -w option is used, RedBoot will print a message and then
wait for a period of time before starting the execution. This is
most useful in a script, giving the user a chance to abort executing
a program and move on in the script.
</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN4559"
></A
><H2
>Examples</H2
><P
>Execute a program - <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>no explicit output from RedBoot</I
></SPAN
>.
<TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SCREEN"
>RedBoot> <TT
CLASS="USERINPUT"
><B
>go 0x40040</B
></TT
></PRE
></TD
></TR
></TABLE
>
</P
><P
>Execute a program with a timeout.
<TABLE
BORDER="5"
BGCOLOR="#E0E0F0"
WIDTH="70%"
><TR
><TD
><PRE
CLASS="SCREEN"
>RedBoot> <TT
CLASS="USERINPUT"
><B
>go -w 10</B
></TT
>
About to start execution at 0x00000000 - abort with ^C within 10 seconds
^C
RedBoot></PRE
></TD
></TR
></TABLE
>
Note that the starting address was implied (0x00000000 in this example).
The user is prompted that execution will commence in 10 seconds. At
anytime within that 10 seconds the user may type <SPAN
CLASS="GUIBUTTON"
>Ctrl+C</SPAN
>
on the console and RedBoot will abort execution and return for the next
command, either from a script or the console.
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="executing-programs.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-ref.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="exec-command.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Executing Programs from RedBoot</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="executing-programs.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>exec</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>