diff options
| author | Rob Savoye <rob@welcomehome.org> | 2002-08-31 05:44:56 +0000 |
|---|---|---|
| committer | Rob Savoye <rob@welcomehome.org> | 2002-08-31 05:44:56 +0000 |
| commit | 6b54d2897af5c41ae2292862e98916e62bc93e3f (patch) | |
| tree | ef4016f223f88363e8685d68e46cfdfb98f2b691 | |
| parent | c9f826a839d7209ca8378f60ebbcbf657e08d066 (diff) | |
| download | dejagnu-6b54d2897af5c41ae2292862e98916e62bc93e3f.zip dejagnu-6b54d2897af5c41ae2292862e98916e62bc93e3f.tar.gz dejagnu-6b54d2897af5c41ae2292862e98916e62bc93e3f.tar.bz2 | |
Update with new files, and upgraded version of Doctools.
36 files changed, 6625 insertions, 1888 deletions
diff --git a/doc/overview/addboard.html b/doc/overview/addboard.html index 786bcdf..abb532f 100644 --- a/doc/overview/addboard.html +++ b/doc/overview/addboard.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Adding A New Board</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Board Config File Values" HREF="boarddefs.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="addtarget.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="boarddefs.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -108,9 +116,12 @@ CLASS="FUNCTION" processors.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN1224" +></A ><P ><B ->Example 4-6. Testing a New Board Config File</B +>Example 6. Testing a New Board Config File</B ></P ><TABLE BORDER="0" @@ -146,9 +157,12 @@ CLASS="EMPHASIS" >, which is the Tcl execution characters.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN1231" +></A ><P ><B ->Example 4-7. Example Board Config File</B +>Example 7. Example Board Config File</B ></P ><TABLE BORDER="0" @@ -211,7 +225,7 @@ ALIGN="left" VALIGN="top" ><A HREF="addtarget.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -227,7 +241,7 @@ ALIGN="right" VALIGN="top" ><A HREF="boarddefs.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/adding.html b/doc/overview/adding.html index fb6ff34..99a3387 100644 --- a/doc/overview/adding.html +++ b/doc/overview/adding.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Adding A Test Case To A Test Suite.</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Hints On Writing A Test Case" HREF="hints.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="debugging.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="hints.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -198,7 +206,7 @@ ALIGN="left" VALIGN="top" ><A HREF="debugging.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -214,7 +222,7 @@ ALIGN="right" VALIGN="top" ><A HREF="hints.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/addtarget.html b/doc/overview/addtarget.html index 9de60c4..539ce69 100644 --- a/doc/overview/addtarget.html +++ b/doc/overview/addtarget.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Adding A New Target</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Adding A New Board" HREF="addboard.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="addtool.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="addboard.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -158,7 +166,7 @@ ALIGN="left" VALIGN="top" ><A HREF="addtool.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -174,7 +182,7 @@ ALIGN="right" VALIGN="top" ><A HREF="addboard.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/addtool.html b/doc/overview/addtool.html index 4f2b8a6..b12ced4 100644 --- a/doc/overview/addtool.html +++ b/doc/overview/addtool.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Adding A New Tool</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Adding A New Target" HREF="addtarget.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="extending.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="addtarget.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -175,9 +183,7 @@ CLASS="FILENAME" > file. This will add all the Makefile support needed to run DejaGnu, and support the <A HREF="runningtests.html#MAKECHECK" -><I ->Make Check</I -></A +>Make Check</A > target.</P ><P @@ -192,9 +198,7 @@ CLASS="EMPHASIS" >, to set up the Tcl copies of configuration-dependent values. This is called the <A HREF="customizing.html#LOCAL" -><I ->Local Config File</I -></A +>Local Config File</A > The check target must run the <B CLASS="COMMAND" @@ -215,9 +219,12 @@ CLASS="COMMAND" line.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN1145" +></A ><P ><B ->Example 4-1. Sample Makefile.in Fragment</B +>Example 1. Sample Makefile.in Fragment</B ></P ><TABLE BORDER="0" @@ -333,9 +340,12 @@ CLASS="FILENAME" with:</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN1162" +></A ><P ><B ->Example 4-2. Simple Batch Program Tool Init File</B +>Example 2. Simple Batch Program Tool Init File</B ></P ><TABLE BORDER="0" @@ -363,9 +373,12 @@ CLASS="EMPHASIS" using an init file like this:</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN1167" +></A ><P ><B ->Example 4-3. Simple Interactive Program Tool Init File</B +>Example 3. Simple Interactive Program Tool Init File</B ></P ><TABLE BORDER="0" @@ -425,9 +438,12 @@ CLASS="FILENAME" line of Tcl code to issue a message.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN1178" +></A ><P ><B ->Example 4-4. Testing A New Tool Config</B +>Example 4. Testing A New Tool Config</B ></P ><TABLE BORDER="0" @@ -474,9 +490,12 @@ CLASS="COMMAND" something like this:</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN1189" +></A ><P ><B ->Example 4-5. Example Test Case Run</B +>Example 5. Example Test Case Run</B ></P ><TABLE BORDER="0" @@ -531,7 +550,7 @@ ALIGN="left" VALIGN="top" ><A HREF="extending.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -547,7 +566,7 @@ ALIGN="right" VALIGN="top" ><A HREF="addtarget.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/boardconfig.html b/doc/overview/boardconfig.html index 234e20d..b850130 100644 --- a/doc/overview/boardconfig.html +++ b/doc/overview/boardconfig.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Board Config File</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Remote Host Testing" HREF="releng.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="global.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 3. Customizing DejaGnu</TD +>Customizing DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="releng.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -74,9 +82,7 @@ NAME="BOARDCONFIG" are also collections of custom procedures for common environments. For more information on adding a new board config file, go to the <A HREF="addboard.html" -><I ->Adding A New Board</I -></A +>Adding A New Board</A > chapter. </P ><P >An example board config file for a GNU simulator is as @@ -98,9 +104,12 @@ CLASS="EMPHASIS" is part of your build tree.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN943" +></A ><P ><B ->Example 3-5. Board Config File</B +>Example 5. Board Config File</B ></P ><TABLE BORDER="0" @@ -165,9 +174,7 @@ CLASS="FUNCTION" >. These return the proper flags to compiler and link an executable image using <A HREF="builtins.html#LIBGLOSS" -><I ->Libgloss</I -></A +>Libgloss</A >, the GNU BSP (Board Support Package). The final procedures are <TT CLASS="FUNCTION" @@ -196,7 +203,7 @@ ALIGN="left" VALIGN="top" ><A HREF="global.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -212,7 +219,7 @@ ALIGN="right" VALIGN="top" ><A HREF="releng.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/boarddefs.html b/doc/overview/boarddefs.html index 08ccbc5..76c3d18 100644 --- a/doc/overview/boarddefs.html +++ b/doc/overview/boarddefs.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Board Config File Values</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Writing A Test Case" HREF="writing.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="addboard.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="writing.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -80,13 +88,20 @@ CLASS="FUNCTION" ><P ><DIV CLASS="TABLE" +><A +NAME="AEN1240" +></A ><P ><B ->Table 4-1. Common Board Info Fields</B +>Table 1. Common Board Info Fields</B ></P ><TABLE BORDER="1" +BGCOLOR="#E0E0E0" +CELLSPACING="0" +CELLPADDING="4" CLASS="CALSTABLE" +><THEAD ><TR ><TH ALIGN="LEFT" @@ -101,6 +116,8 @@ ALIGN="LEFT" VALIGN="TOP" >Description</TH ></TR +></THEAD +><TBODY ><TR ><TD ALIGN="LEFT" @@ -328,6 +345,7 @@ ALIGN="LEFT" VALIGN="TOP" >Additional link flags, rarely used.</TD ></TR +></TBODY ></TABLE ></DIV > @@ -341,13 +359,20 @@ VALIGN="TOP" ><P ><DIV CLASS="TABLE" +><A +NAME="AEN1316" +></A ><P ><B ->Table 4-2. Board Info Fields For GCC & GDB</B +>Table 2. Board Info Fields For GCC & GDB</B ></P ><TABLE BORDER="1" +BGCOLOR="#E0E0E0" +CELLSPACING="0" +CELLPADDING="4" CLASS="CALSTABLE" +><THEAD ><TR ><TH ALIGN="LEFT" @@ -362,6 +387,8 @@ ALIGN="LEFT" VALIGN="TOP" >Description</TH ></TR +></THEAD +><TBODY ><TR ><TD ALIGN="LEFT" @@ -818,6 +845,7 @@ VALIGN="TOP" ><TD > </TD ></TR +></TBODY ></TABLE ></DIV > @@ -839,7 +867,7 @@ ALIGN="left" VALIGN="top" ><A HREF="addboard.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -855,7 +883,7 @@ ALIGN="right" VALIGN="top" ><A HREF="writing.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/book1.html b/doc/overview/book1.html index 9fa0814..e4a9d01 100644 --- a/doc/overview/book1.html +++ b/doc/overview/book1.html @@ -1,14 +1,22 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >DejaGnu</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="NEXT" TITLE="Abstract" HREF="preface.html"></HEAD ><BODY +CLASS="BOOK" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="BOOK" ><A @@ -27,7 +35,10 @@ CLASS="SUBTITLE" >The GNU Testing Framework</H2 ><H3 CLASS="AUTHOR" ->Rob Savoye</H3 +><A +NAME="AEN9" +>Rob Savoye</A +></H3 ><DIV CLASS="AFFILIATION" ><SPAN @@ -36,10 +47,10 @@ CLASS="ORGNAME" ></DIV ><P CLASS="COPYRIGHT" ->Copyright © 2001 by <SPAN -CLASS="HOLDER" ->Free Software Foundation, Inc.</SPAN -></P +>Copyright © 2002 by Free Software Foundation, Inc.</P +><SPAN +CLASS="RELEASEINFO" +> New release<BR></SPAN ><HR></DIV ><DIV CLASS="TOC" @@ -54,7 +65,7 @@ HREF="preface.html" >Abstract</A ></DT ><DT ->1. <A +><A HREF="overview.html" >Overview</A ></DT @@ -92,7 +103,127 @@ HREF="posix.html" ></DL ></DD ><DT ->2. <A +><A +HREF="gettingup.html" +>Getting DejaGnu up and running</A +></DT +><DD +><DL +><DT +><A +HREF="gettingup.html#AEN210" +>Test your installation</A +></DT +><DD +><DL +><DT +><A +HREF="gettingup.html#AEN220" +>Windows</A +></DT +><DT +><A +HREF="gettingup.html#AEN224" +>Getting the source code for the calc example</A +></DT +></DL +></DD +><DT +><A +HREF="x227.html" +>Create a minimal project, e.g. calc</A +></DT +><DD +><DL +><DT +><A +HREF="x227.html#AEN230" +>A simple project without the GNU autotools</A +></DT +><DT +><A +HREF="x227.html#AEN235" +>Using autoconf/autoheader/automake</A +></DT +></DL +></DD +><DT +><A +HREF="x276.html" +>Our first automated tests</A +></DT +><DD +><DL +><DT +><A +HREF="x276.html#AEN278" +>Running the test for the calc example</A +></DT +><DT +><A +HREF="x276.html#AEN286" +>The various config files or how to avoid warnings</A +></DT +><DT +><A +HREF="x276.html#AEN303" +>When trouble strikes</A +></DT +><DT +><A +HREF="x276.html#AEN312" +>Testing “Hello world” locally</A +></DT +></DL +></DD +><DT +><A +HREF="x319.html" +>A first remote test</A +></DT +><DD +><DL +><DT +><A +HREF="x319.html#AEN322" +>Setup telnet to your own host</A +></DT +><DT +><A +HREF="x319.html#AEN331" +>A test case for login via telnet</A +></DT +><DT +><A +HREF="x319.html#AEN357" +>Remote testing “Hello world”</A +></DT +><DT +><A +HREF="x319.html#AEN372" +>Transferring files from/to the target</A +></DT +><DT +><A +HREF="x319.html#AEN382" +>Preparing for crosscompilation</A +></DT +><DT +><A +HREF="x319.html#AEN393" +>Remote testing of calc</A +></DT +><DT +><A +HREF="x319.html#AEN396" +>Using WindowsNT as host and vxWorks as target</A +></DT +></DL +></DD +></DL +></DD +><DT +><A HREF="runningtests.html" >Running Tests</A ></DT @@ -154,7 +285,7 @@ HREF="outputfiles.html#DEBUGFILE" ></DL ></DD ><DT ->3. <A +><A HREF="customizing.html" >Customizing DejaGnu</A ></DT @@ -202,7 +333,7 @@ HREF="configfile.html#PERSONAL" ></DL ></DD ><DT ->4. <A +><A HREF="extending.html" >Extending DejaGnu</A ></DT @@ -261,7 +392,26 @@ HREF="tvariables.html" ></DL ></DD ><DT ->5. <A +><A +HREF="unit.html" +>Unit Testing</A +></DT +><DD +><DL +><DT +><A +HREF="unit.html#UNITTEST" +>What Is Unit Testing ?</A +></DT +><DT +><A +HREF="djh.html" +>The dejagnu.h Header File</A +></DT +></DL +></DD +><DT +><A HREF="reference.html" >Reference</A ></DT @@ -352,6 +502,83 @@ HREF="filemap.html" ></DT ></DL ></DD +><DT +><A +HREF="unittestapi.html" +>Unit Testing API</A +></DT +><DD +><DL +><DT +><A +HREF="unittestapi.html#CUNIT" +>C Unit Testing API</A +></DT +><DD +><DL +><DT +><A +HREF="unittestapi.html#PASSFUNC" +>Pass Function</A +></DT +><DT +><A +HREF="unittestapi.html#FAILFUNC" +>Fail Function</A +></DT +><DT +><A +HREF="unittestapi.html#UNTESTEDFUNC" +>Untested Function</A +></DT +><DT +><A +HREF="unittestapi.html#UNRESOLVEDFUNC" +>Unresolved Function</A +></DT +><DT +><A +HREF="unittestapi.html#TOTALSFUNC" +>Totals Function</A +></DT +></DL +></DD +><DT +><A +HREF="cppunit.html" +>C++ Unit Testing API</A +></DT +><DD +><DL +><DT +><A +HREF="cppunit.html#PASSMETH" +>Pass Method</A +></DT +><DT +><A +HREF="cppunit.html#FAILMETH" +>Fail Method</A +></DT +><DT +><A +HREF="cppunit.html#UNTESTEDMETH" +>Untested Method</A +></DT +><DT +><A +HREF="cppunit.html#UNRESOLVEDMETH" +>Unresolved Method</A +></DT +><DT +><A +HREF="cppunit.html#TOTALSMETH" +>Totals Method</A +></DT +></DL +></DD +></DL +></DD ></DL ></DIV ></DIV @@ -381,7 +608,7 @@ ALIGN="right" VALIGN="top" ><A HREF="preface.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/builtins.html b/doc/overview/builtins.html index dce635a..bb8b668 100644 --- a/doc/overview/builtins.html +++ b/doc/overview/builtins.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Builtin Procedures</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="File Map" HREF="filemap.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="installation.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 5. Reference</TD +>Reference</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="filemap.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -86,22 +94,29 @@ NAME="MAILFILE" ></H3 ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1662" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->mail_file</B +><TT +CLASS="FUNCTION" +>mail_file</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->file to subject</VAR +>(<TT +CLASS="PARAMETER" +><I +>file to subject</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -116,6 +131,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -128,17 +144,22 @@ NAME="OPENLOGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1676" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->open_logs</B +><TT +CLASS="FUNCTION" +>open_logs</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -155,17 +176,22 @@ NAME="CLOSELOGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1684" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->close_logs</B +><TT +CLASS="FUNCTION" +>close_logs</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -199,22 +225,29 @@ CLASS="EMPHASIS" configuration.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1695" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->isbuild</B +><TT +CLASS="FUNCTION" +>isbuild</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->pattern</VAR +>(<TT +CLASS="PARAMETER" +><I +>pattern</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -229,6 +262,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -241,22 +275,29 @@ NAME="ISREMOTE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1709" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->is_remote</B +><TT +CLASS="FUNCTION" +>is_remote</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->board</VAR +>(<TT +CLASS="PARAMETER" +><I +>board</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -271,6 +312,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -292,17 +334,22 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1725" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->is3way</B +><TT +CLASS="FUNCTION" +>is3way</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -334,22 +381,29 @@ CLASS="EMPHASIS" characters, using shell syntax, to specify sets of names).</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1736" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->ishost</B +><TT +CLASS="FUNCTION" +>ishost</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->pattern</VAR +>(<TT +CLASS="PARAMETER" +><I +>pattern</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -364,6 +418,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -393,22 +448,29 @@ CLASS="EMPHASIS" build canonical configuration.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1753" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->istarget</B +><TT +CLASS="FUNCTION" +>istarget</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -423,6 +485,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -444,17 +507,22 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1769" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->isnative</B +><TT +CLASS="FUNCTION" +>isnative</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -471,22 +539,29 @@ NAME="UNKNOWN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1777" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->unknown</B +><TT +CLASS="FUNCTION" +>unknown</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -501,6 +576,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -513,22 +589,29 @@ NAME="CLONEOUTPUT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1791" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->clone_output</B +><TT +CLASS="FUNCTION" +>clone_output</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->message</VAR +>(<TT +CLASS="PARAMETER" +><I +>message</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -543,6 +626,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -555,17 +639,22 @@ NAME="RESETVARS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1805" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->reset_vars</B +><TT +CLASS="FUNCTION" +>reset_vars</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -582,17 +671,22 @@ NAME="LOGANDEXIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1813" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->log_and_exit</B +><TT +CLASS="FUNCTION" +>log_and_exit</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -609,22 +703,29 @@ NAME="LOGSUMMARY" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1821" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->log_summary</B +><TT +CLASS="FUNCTION" +>log_summary</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -639,6 +740,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -651,17 +753,22 @@ NAME="CLEANUP" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1835" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->cleanup</B +><TT +CLASS="FUNCTION" +>cleanup</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -717,18 +824,20 @@ CLASS="WARNING" ></P ><TABLE CLASS="WARNING" -BORDER="1" WIDTH="100%" +BORDER="0" ><TR ><TD +WIDTH="25" ALIGN="CENTER" -><B ->Warning</B -></TD -></TR -><TR +VALIGN="TOP" +><IMG +SRC="./stylesheet-images/warning.gif" +HSPACE="5" +ALT="Warning"></TD ><TD ALIGN="LEFT" +VALIGN="TOP" ><P >Warning you must clear the expected failure after using setup_xfail in a test case. Any call to <TT @@ -753,26 +862,35 @@ CLASS="FUNCTION" ></DIV ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1856" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->setup_xfail</B +><TT +CLASS="FUNCTION" +>setup_xfail</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->config</VAR +>(<TT +CLASS="PARAMETER" +><I +>config</I +></TT > - <VAR -CLASS="PDPARAM" ->bugid</VAR + <TT +CLASS="PARAMETER" +><I +>bugid</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -800,6 +918,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -812,30 +931,41 @@ NAME="RECORDTEST" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1876" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->record_test</B +><TT +CLASS="FUNCTION" +>record_test</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->type</VAR +>(<TT +CLASS="PARAMETER" +><I +>type</I +></TT > - <VAR -CLASS="PDPARAM" ->message</VAR + <TT +CLASS="PARAMETER" +><I +>message</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -872,6 +1002,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -902,22 +1033,29 @@ CLASS="PARAMETER" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1906" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->pass</B +><TT +CLASS="FUNCTION" +>pass</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -933,6 +1071,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -963,22 +1102,29 @@ CLASS="PARAMETER" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1924" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->fail</B +><TT +CLASS="FUNCTION" +>fail</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -994,6 +1140,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1025,22 +1172,29 @@ CLASS="PARAMETER" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1942" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->xpass</B +><TT +CLASS="FUNCTION" +>xpass</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1056,6 +1210,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1087,22 +1242,29 @@ CLASS="PARAMETER" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1960" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->xpass</B +><TT +CLASS="FUNCTION" +>xpass</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1118,6 +1280,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1152,22 +1315,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1980" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->set_warning_threshold</B +><TT +CLASS="FUNCTION" +>set_warning_threshold</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->threshold</VAR +>(<TT +CLASS="PARAMETER" +><I +>threshold</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1183,6 +1353,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1207,17 +1378,22 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN1997" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->get_warning_threshold</B +><TT +CLASS="FUNCTION" +>get_warning_threshold</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -1299,27 +1475,36 @@ CLASS="EMPHASIS" known side effects.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2020" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->warning</B +><TT +CLASS="FUNCTION" +>warning</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT > - <VAR -CLASS="PDPARAM" ->number</VAR + <TT +CLASS="PARAMETER" +><I +>number</I +></TT > );<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1355,6 +1540,7 @@ CLASS="EMPHASIS" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1412,27 +1598,36 @@ CLASS="EMPHASIS" errors with no known side effects.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2053" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->perror</B +><TT +CLASS="FUNCTION" +>perror</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT > - <VAR -CLASS="PDPARAM" ->number</VAR + <TT +CLASS="PARAMETER" +><I +>number</I +></TT > );<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1468,6 +1663,7 @@ CLASS="EMPHASIS" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1506,22 +1702,29 @@ CLASS="FUNCTION" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2081" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->note</B +><TT +CLASS="FUNCTION" +>note</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1536,6 +1739,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1561,22 +1765,29 @@ CLASS="EMPHASIS" does not yet exist for some feature.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2098" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->untested</B +><TT +CLASS="FUNCTION" +>untested</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1592,6 +1803,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1618,22 +1830,29 @@ CLASS="EMPHASIS" determine if it passed or failed (and to improve the test case).</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2115" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->unresolved</B +><TT +CLASS="FUNCTION" +>unresolved</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1649,6 +1868,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1670,22 +1890,29 @@ CLASS="EMPHASIS" >, appending the argument string.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2131" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->unsupported</B +><TT +CLASS="FUNCTION" +>unsupported</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->string</VAR +>(<TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1701,6 +1928,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1713,17 +1941,22 @@ NAME="INITTESTCOUNTS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2145" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->init_testcounts</B +><TT +CLASS="FUNCTION" +>init_testcounts</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -1740,26 +1973,35 @@ NAME="INCRCOUNT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2153" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->incr_count</B +><TT +CLASS="FUNCTION" +>incr_count</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->name</VAR +>(<TT +CLASS="PARAMETER" +><I +>name</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1785,6 +2027,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1817,22 +2060,29 @@ CLASS="COMMAND" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2177" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->transform</B +><TT +CLASS="FUNCTION" +>transform</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->toolname</VAR +>(<TT +CLASS="PARAMETER" +><I +>toolname</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1848,6 +2098,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -1905,34 +2156,47 @@ CLASS="EMPHASIS" false.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2198" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->check_conditional_xfail</B +><TT +CLASS="FUNCTION" +>check_conditional_xfail</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->message</VAR +>(<TT +CLASS="PARAMETER" +><I +>message</I +></TT > - <VAR -CLASS="PDPARAM" ->targets</VAR + <TT +CLASS="PARAMETER" +><I +>targets</I +></TT > - <VAR -CLASS="PDPARAM" ->includes</VAR + <TT +CLASS="PARAMETER" +><I +>includes</I +></TT > - <VAR -CLASS="PDPARAM" ->excludes</VAR + <TT +CLASS="PARAMETER" +><I +>excludes</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -1987,11 +2251,15 @@ CLASS="PARAMETER" match) then this conditional is de-activated.</P ></DD ></DL +></DIV ><DIV CLASS="EXAMPLE" +><A +NAME="AEN2227" +></A ><P ><B ->Example 5-1. Specifying the conditional xfail data</B +>Example 1. Specifying the conditional xfail data</B ></P ><TABLE BORDER="0" @@ -2058,22 +2326,29 @@ CLASS="COMMAND" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2240" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->clear_xfail</B +><TT +CLASS="FUNCTION" +>clear_xfail</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->config</VAR +>(<TT +CLASS="PARAMETER" +><I +>config</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2089,6 +2364,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2116,55 +2392,91 @@ CLASS="EMPHASIS" CLASS="OPTION" >-log</TT > argument to cause string to always - be added to the log file, even if it won't be printed. Use the - optional <TT + be added to the log file, even if it won't be printed. Use the + optional <TT +CLASS="OPTION" +>-x</TT +> argument to log the test results into + a parsable XML file. Use the optional <TT CLASS="OPTION" >-n</TT -> argument to print string without a - trailing newline. Use the optional <TT +> argument + to print string without a trailing newline. Use the optional + <TT CLASS="OPTION" >--</TT -> argument if - string begins with "-".</P +> argument if string begins with "-".</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2261" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->verbose</B +><TT +CLASS="FUNCTION" +>verbose</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->-log</VAR +>(<TT +CLASS="PARAMETER" +><I +>-log</I +></TT +> + <TT +CLASS="PARAMETER" +><I +>-x</I +></TT > - <VAR -CLASS="PDPARAM" ->-n</VAR + <TT +CLASS="PARAMETER" +><I +>-n</I +></TT > - <VAR -CLASS="PDPARAM" ->-r</VAR + <TT +CLASS="PARAMETER" +><I +>-r</I +></TT > - <VAR -CLASS="PDPARAM" ->string</VAR + <TT +CLASS="PARAMETER" +><I +>string</I +></TT > - <VAR -CLASS="PDPARAM" ->number</VAR + <TT +CLASS="PARAMETER" +><I +>number</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT CLASS="PARAMETER" ><I +>-x</I +></TT +></DT +><DD +><P +></P +></DD +><DT +><TT +CLASS="PARAMETER" +><I >-log</I ></TT ></DT @@ -2218,6 +2530,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2244,22 +2557,29 @@ CLASS="FILENAME" earlier ones.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2307" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->load_lib</B +><TT +CLASS="FUNCTION" +>load_lib</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->filespec</VAR +>(<TT +CLASS="PARAMETER" +><I +>filespec</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2276,6 +2596,7 @@ CLASS="PARAMETER" ></DL ></DIV ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -2339,34 +2660,47 @@ NAME="CALLREMOTE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2333" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->call_remote</B +><TT +CLASS="FUNCTION" +>call_remote</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->type</VAR +>(<TT +CLASS="PARAMETER" +><I +>type</I +></TT > - <VAR -CLASS="PDPARAM" ->proc</VAR + <TT +CLASS="PARAMETER" +><I +>proc</I +></TT > - <VAR -CLASS="PDPARAM" ->dest</VAR + <TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2403,6 +2737,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2415,22 +2750,29 @@ NAME="CHECKFORBOARDSTATUS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2360" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->check_for_board_status</B +><TT +CLASS="FUNCTION" +>check_for_board_status</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->variable</VAR +>(<TT +CLASS="PARAMETER" +><I +>variable</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2445,6 +2787,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2457,30 +2800,41 @@ NAME="FILEONBUILD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2374" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->file_on_build</B +><TT +CLASS="FUNCTION" +>file_on_build</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->op</VAR +>(<TT +CLASS="PARAMETER" +><I +>op</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2517,6 +2871,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2529,30 +2884,41 @@ NAME="FILEONHOST" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2400" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->file_on_host</B +><TT +CLASS="FUNCTION" +>file_on_host</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->op</VAR +>(<TT +CLASS="PARAMETER" +><I +>op</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2589,6 +2955,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2601,34 +2968,47 @@ NAME="LOCALEXEC" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2426" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->local_exec</B +><TT +CLASS="FUNCTION" +>local_exec</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->commandline</VAR +>(<TT +CLASS="PARAMETER" +><I +>commandline</I +></TT > - <VAR -CLASS="PDPARAM" ->inp</VAR + <TT +CLASS="PARAMETER" +><I +>inp</I +></TT > - <VAR -CLASS="PDPARAM" ->outp</VAR + <TT +CLASS="PARAMETER" +><I +>outp</I +></TT > - <VAR -CLASS="PDPARAM" ->timeout</VAR + <TT +CLASS="PARAMETER" +><I +>timeout</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2665,6 +3045,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2677,22 +3058,29 @@ NAME="REMOTEBINARY" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2453" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_binary</B +><TT +CLASS="FUNCTION" +>remote_binary</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2707,6 +3095,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2719,22 +3108,29 @@ NAME="REMOTECLOSE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2467" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_close</B +><TT +CLASS="FUNCTION" +>remote_close</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->shellid</VAR +>(<TT +CLASS="PARAMETER" +><I +>shellid</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2763,6 +3159,7 @@ CLASS="SYMBOL" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2775,30 +3172,41 @@ NAME="REMOTEDOWNLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2484" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_download</B +><TT +CLASS="FUNCTION" +>remote_download</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2835,6 +3243,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2847,30 +3256,41 @@ NAME="REMOTEEXEC" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2510" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_exec</B +><TT +CLASS="FUNCTION" +>remote_exec</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT > - <VAR -CLASS="PDPARAM" ->program</VAR + <TT +CLASS="PARAMETER" +><I +>program</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2907,6 +3327,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2919,30 +3340,41 @@ NAME="REMOTEEXPECT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2536" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_expect</B +><TT +CLASS="FUNCTION" +>remote_expect</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->board</VAR +>(<TT +CLASS="PARAMETER" +><I +>board</I +></TT > - <VAR -CLASS="PDPARAM" ->timeout</VAR + <TT +CLASS="PARAMETER" +><I +>timeout</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -2979,6 +3411,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -2991,26 +3424,35 @@ NAME="REMOTEFILE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2562" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_file</B +><TT +CLASS="FUNCTION" +>remote_file</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3036,6 +3478,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3048,26 +3491,35 @@ NAME="REMOTELD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2582" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_ld</B +><TT +CLASS="FUNCTION" +>remote_ld</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->prog</VAR + <TT +CLASS="PARAMETER" +><I +>prog</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3093,6 +3545,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3105,30 +3558,41 @@ NAME="REMOTELOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2602" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_load</B +><TT +CLASS="FUNCTION" +>remote_load</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->prog</VAR + <TT +CLASS="PARAMETER" +><I +>prog</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3165,6 +3629,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3177,22 +3642,29 @@ NAME="REMOTEOPEN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2628" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_open</B +><TT +CLASS="FUNCTION" +>remote_open</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->type</VAR +>(<TT +CLASS="PARAMETER" +><I +>type</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3240,6 +3712,7 @@ CLASS="SYMBOL" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3252,22 +3725,29 @@ NAME="REMOTEPOPCONN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2649" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_pop_conn</B +><TT +CLASS="FUNCTION" +>remote_pop_conn</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3282,6 +3762,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3294,22 +3775,29 @@ NAME="REMOTEPUSHCONN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2663" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_push_conn</B +><TT +CLASS="FUNCTION" +>remote_push_conn</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3324,6 +3812,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3336,22 +3825,29 @@ NAME="REMOTERAWBINARY" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2677" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_binary</B +><TT +CLASS="FUNCTION" +>remote_raw_binary</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3366,6 +3862,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3378,22 +3875,29 @@ NAME="REMOTERAWCLOSE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2691" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_close</B +><TT +CLASS="FUNCTION" +>remote_raw_close</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3408,6 +3912,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3420,26 +3925,35 @@ NAME="REMOTERAWFILE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2705" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_file</B +><TT +CLASS="FUNCTION" +>remote_raw_file</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3465,6 +3979,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3477,26 +3992,35 @@ NAME="REMOTERAWLD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2725" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_ld</B +><TT +CLASS="FUNCTION" +>remote_raw_ld</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->prog</VAR + <TT +CLASS="PARAMETER" +><I +>prog</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3522,6 +4046,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3534,30 +4059,41 @@ NAME="REMOTERAWLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2745" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_load</B +><TT +CLASS="FUNCTION" +>remote_raw_load</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->prog</VAR + <TT +CLASS="PARAMETER" +><I +>prog</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3594,6 +4130,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3606,22 +4143,29 @@ NAME="REMOTERAWOPEN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2771" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_open</B +><TT +CLASS="FUNCTION" +>remote_raw_open</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3636,6 +4180,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3648,26 +4193,35 @@ NAME="REMOTERAWSEND" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2785" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_send</B +><TT +CLASS="FUNCTION" +>remote_raw_send</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->string</VAR + <TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3693,6 +4247,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3705,26 +4260,35 @@ NAME="REMOTERAWSPAWN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2805" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_spawn</B +><TT +CLASS="FUNCTION" +>remote_raw_spawn</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->commandline</VAR + <TT +CLASS="PARAMETER" +><I +>commandline</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3750,6 +4314,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3762,26 +4327,35 @@ NAME="REMOTERAWTRANSMIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2825" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_transmit</B +><TT +CLASS="FUNCTION" +>remote_raw_transmit</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3807,6 +4381,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3819,26 +4394,35 @@ NAME="REMOTERAWWAIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2845" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_raw_wait</B +><TT +CLASS="FUNCTION" +>remote_raw_wait</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->timeout</VAR + <TT +CLASS="PARAMETER" +><I +>timeout</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3864,6 +4448,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3876,22 +4461,29 @@ NAME="REMOTEREBOOT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2865" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_reboot</B +><TT +CLASS="FUNCTION" +>remote_reboot</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3906,6 +4498,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3918,26 +4511,35 @@ NAME="REMOTESEND" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2879" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_send</B +><TT +CLASS="FUNCTION" +>remote_send</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->string</VAR + <TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -3963,6 +4565,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -3975,30 +4578,41 @@ NAME="REMOTESPAWN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2899" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_spawn</B +><TT +CLASS="FUNCTION" +>remote_spawn</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->commandline</VAR + <TT +CLASS="PARAMETER" +><I +>commandline</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4035,6 +4649,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4047,22 +4662,29 @@ NAME="REMOTESWAPCONN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2925" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_swap_conn</B +><TT +CLASS="FUNCTION" +>remote_swap_conn</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4077,6 +4699,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4089,26 +4712,35 @@ NAME="REMOTETRANSMIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2939" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_transmit</B +><TT +CLASS="FUNCTION" +>remote_transmit</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4134,6 +4766,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4146,30 +4779,41 @@ NAME="REMOTEUPLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2959" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_upload</B +><TT +CLASS="FUNCTION" +>remote_upload</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->srcfile</VAR + <TT +CLASS="PARAMETER" +><I +>srcfile</I +></TT > - <VAR -CLASS="PDPARAM" ->arg</VAR + <TT +CLASS="PARAMETER" +><I +>arg</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4206,6 +4850,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4218,26 +4863,35 @@ NAME="REMOTEWAIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN2985" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->remote_wait</B +><TT +CLASS="FUNCTION" +>remote_wait</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->timeout</VAR + <TT +CLASS="PARAMETER" +><I +>timeout</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4263,6 +4917,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4275,22 +4930,29 @@ NAME="STANDARDCLOSE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3005" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_close</B +><TT +CLASS="FUNCTION" +>standard_close</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4305,6 +4967,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4317,30 +4980,41 @@ NAME="STANDARDDOWNLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3019" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_download</B +><TT +CLASS="FUNCTION" +>standard_download</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT > - <VAR -CLASS="PDPARAM" ->destfile</VAR + <TT +CLASS="PARAMETER" +><I +>destfile</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4377,6 +5051,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4389,26 +5064,35 @@ NAME="STANDARDEXEC" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3045" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_exec</B +><TT +CLASS="FUNCTION" +>standard_exec</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4434,6 +5118,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4446,28 +5131,39 @@ NAME="STANDARDFILE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3065" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_file</B +><TT +CLASS="FUNCTION" +>standard_file</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR ->, <VAR -CLASS="PDPARAM" ->op</VAR ->, <VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT +><TT +CLASS="PARAMETER" +><I +>op</I +></TT +><TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4482,6 +5178,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4494,30 +5191,41 @@ NAME="STANDARDLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3081" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_load</B +><TT +CLASS="FUNCTION" +>standard_load</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->prog</VAR + <TT +CLASS="PARAMETER" +><I +>prog</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4554,6 +5262,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4566,22 +5275,29 @@ NAME="STANDARDREBOOT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3107" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_reboot</B +><TT +CLASS="FUNCTION" +>standard_reboot</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4596,6 +5312,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4608,26 +5325,35 @@ NAME="STANDARDSEND" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3121" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_send</B +><TT +CLASS="FUNCTION" +>standard_send</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->string</VAR + <TT +CLASS="PARAMETER" +><I +>string</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4653,6 +5379,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4665,26 +5392,35 @@ NAME="STANDARDSPAWN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3141" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_spawn</B +><TT +CLASS="FUNCTION" +>standard_spawn</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->commandline</VAR + <TT +CLASS="PARAMETER" +><I +>commandline</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4710,6 +5446,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4722,26 +5459,35 @@ NAME="STANDARDTRANSMIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3161" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_transmit</B +><TT +CLASS="FUNCTION" +>standard_transmit</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4767,6 +5513,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4779,22 +5526,29 @@ NAME="STANDARDUPLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3181" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_upload</B +><TT +CLASS="FUNCTION" +>standard_upload</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest srcfile destfile</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest srcfile destfile</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4831,6 +5585,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4843,26 +5598,35 @@ NAME="STANDARDWAIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3205" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->standard_wait</B +><TT +CLASS="FUNCTION" +>standard_wait</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->timeout</VAR + <TT +CLASS="PARAMETER" +><I +>timeout</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4888,6 +5652,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -4900,26 +5665,35 @@ NAME="UNIXCLEANFILENAME" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3225" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->unix_clean_filename</B +><TT +CLASS="FUNCTION" +>unix_clean_filename</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -4946,6 +5720,7 @@ CLASS="PARAMETER" ></DL ></DIV ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -4968,37 +5743,49 @@ NAME="TELNET" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3248" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->telnet</B +><TT +CLASS="FUNCTION" +>telnet</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT > - <VAR -CLASS="PDPARAM" ->port</VAR + <TT +CLASS="PARAMETER" +><I +>port</I +></TT >);<P ></P ></DIV ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3254" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->rlogin</B +><TT +CLASS="FUNCTION" +>rlogin</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT >);<P ></P ></DIV @@ -5015,22 +5802,29 @@ NAME="RSH" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3262" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->rsh</B +><TT +CLASS="FUNCTION" +>rsh</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5083,6 +5877,7 @@ CLASS="SYMBOL" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5095,22 +5890,29 @@ NAME="TIP" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3283" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->tip</B +><TT +CLASS="FUNCTION" +>tip</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->port</VAR +>(<TT +CLASS="PARAMETER" +><I +>port</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5179,6 +5981,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5191,26 +5994,35 @@ NAME="KERMIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3309" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->kermit</B +><TT +CLASS="FUNCTION" +>kermit</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->port</VAR +>(<TT +CLASS="PARAMETER" +><I +>port</I +></TT > - <VAR -CLASS="PDPARAM" ->bps</VAR + <TT +CLASS="PARAMETER" +><I +>bps</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5284,6 +6096,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5296,26 +6109,35 @@ NAME="KERMITOPEN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3339" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->kermit_open</B +><TT +CLASS="FUNCTION" +>kermit_open</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5341,6 +6163,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5353,26 +6176,35 @@ NAME="KERMITCOMMAND" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3359" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->kermit_command</B +><TT +CLASS="FUNCTION" +>kermit_command</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5398,6 +6230,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5410,22 +6243,29 @@ NAME="KERMITSEND" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3379" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->kermit_send</B +><TT +CLASS="FUNCTION" +>kermit_send</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest string args</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest string args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5462,6 +6302,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5474,30 +6315,41 @@ NAME="KERMITTRANSMIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3403" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->kermit_transmit</B +><TT +CLASS="FUNCTION" +>kermit_transmit</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5534,6 +6386,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5546,26 +6399,35 @@ NAME="TELNETOPEN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3429" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->telnet_open</B +><TT +CLASS="FUNCTION" +>telnet_open</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5591,6 +6453,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5603,22 +6466,29 @@ NAME="TELNETBINARY" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3449" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->telnet_binary</B +><TT +CLASS="FUNCTION" +>telnet_binary</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5633,6 +6503,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5645,30 +6516,41 @@ NAME="TELNETTRANSMIT" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3463" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->telnet_transmit</B +><TT +CLASS="FUNCTION" +>telnet_transmit</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5705,6 +6587,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5717,22 +6600,29 @@ NAME="TIPOPEN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3489" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->tip_open</B +><TT +CLASS="FUNCTION" +>tip_open</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5747,6 +6637,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5759,22 +6650,29 @@ NAME="RLOGINOPEN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3503" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->rlogin_open</B +><TT +CLASS="FUNCTION" +>rlogin_open</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->arg</VAR +>(<TT +CLASS="PARAMETER" +><I +>arg</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5789,6 +6687,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5801,26 +6700,35 @@ NAME="RLOGINSPAWN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3517" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->rlogin_spawn</B +><TT +CLASS="FUNCTION" +>rlogin_spawn</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->dest</VAR +>(<TT +CLASS="PARAMETER" +><I +>dest</I +></TT > - <VAR -CLASS="PDPARAM" ->cmdline</VAR + <TT +CLASS="PARAMETER" +><I +>cmdline</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5846,6 +6754,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5858,22 +6767,29 @@ NAME="RSHOPEN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3537" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->rsh_open</B +><TT +CLASS="FUNCTION" +>rsh_open</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->hostname</VAR +>(<TT +CLASS="PARAMETER" +><I +>hostname</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5888,6 +6804,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5900,30 +6817,41 @@ NAME="RSHDOWNLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3551" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->rsh_download</B +><TT +CLASS="FUNCTION" +>rsh_download</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->desthost</VAR +>(<TT +CLASS="PARAMETER" +><I +>desthost</I +></TT > - <VAR -CLASS="PDPARAM" ->srcfile</VAR + <TT +CLASS="PARAMETER" +><I +>srcfile</I +></TT > - <VAR -CLASS="PDPARAM" ->destfile</VAR + <TT +CLASS="PARAMETER" +><I +>destfile</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -5960,6 +6888,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -5972,30 +6901,41 @@ NAME="RSHUPLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3577" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->rsh_upload</B +><TT +CLASS="FUNCTION" +>rsh_upload</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->desthost</VAR +>(<TT +CLASS="PARAMETER" +><I +>desthost</I +></TT > - <VAR -CLASS="PDPARAM" ->srcfile</VAR + <TT +CLASS="PARAMETER" +><I +>srcfile</I +></TT > - <VAR -CLASS="PDPARAM" ->destfile</VAR + <TT +CLASS="PARAMETER" +><I +>destfile</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6032,6 +6972,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6044,30 +6985,41 @@ NAME="RSHEXEC" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3603" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->rsh_exec</B +><TT +CLASS="FUNCTION" +>rsh_exec</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->boardname</VAR +>(<TT +CLASS="PARAMETER" +><I +>boardname</I +></TT > - <VAR -CLASS="PDPARAM" ->cmd</VAR + <TT +CLASS="PARAMETER" +><I +>cmd</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6104,6 +7056,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6116,22 +7069,29 @@ NAME="FTPOPEN" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3629" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->ftp_open</B +><TT +CLASS="FUNCTION" +>ftp_open</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6146,6 +7106,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6158,30 +7119,41 @@ NAME="FTPUPLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3643" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->ftp_upload</B +><TT +CLASS="FUNCTION" +>ftp_upload</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT > - <VAR -CLASS="PDPARAM" ->remotefile</VAR + <TT +CLASS="PARAMETER" +><I +>remotefile</I +></TT > - <VAR -CLASS="PDPARAM" ->localfile</VAR + <TT +CLASS="PARAMETER" +><I +>localfile</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6218,6 +7190,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6230,30 +7203,41 @@ NAME="FTPDOWNLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3669" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->ftp_download</B +><TT +CLASS="FUNCTION" +>ftp_download</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT > - <VAR -CLASS="PDPARAM" ->localfile</VAR + <TT +CLASS="PARAMETER" +><I +>localfile</I +></TT > - <VAR -CLASS="PDPARAM" ->remotefile</VAR + <TT +CLASS="PARAMETER" +><I +>remotefile</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6290,6 +7274,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6302,22 +7287,29 @@ NAME="FTPCLOSE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3695" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->ftp_close</B +><TT +CLASS="FUNCTION" +>ftp_close</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->host</VAR +>(<TT +CLASS="PARAMETER" +><I +>host</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6332,6 +7324,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6344,26 +7337,35 @@ NAME="TIPDOWNLOAD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3709" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->tip_download</B +><TT +CLASS="FUNCTION" +>tip_download</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->spawnid</VAR +>(<TT +CLASS="PARAMETER" +><I +>spawnid</I +></TT > - <VAR -CLASS="PDPARAM" ->file</VAR + <TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6417,6 +7419,7 @@ CLASS="PARAMETER" ></DL ></DIV ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -6439,34 +7442,47 @@ NAME="DEFAULTLINK" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3738" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->default_link</B +><TT +CLASS="FUNCTION" +>default_link</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->board</VAR +>(<TT +CLASS="PARAMETER" +><I +>board</I +></TT > - <VAR -CLASS="PDPARAM" ->objects</VAR + <TT +CLASS="PARAMETER" +><I +>objects</I +></TT > - <VAR -CLASS="PDPARAM" ->destfile</VAR + <TT +CLASS="PARAMETER" +><I +>destfile</I +></TT > - <VAR -CLASS="PDPARAM" ->flags</VAR + <TT +CLASS="PARAMETER" +><I +>flags</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6514,6 +7530,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6526,30 +7543,41 @@ NAME="DEFAULTTARGETASSEMBLE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3770" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->default_target_assemble</B +><TT +CLASS="FUNCTION" +>default_target_assemble</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->source</VAR +>(<TT +CLASS="PARAMETER" +><I +>source</I +></TT > - <VAR -CLASS="PDPARAM" ->destfile</VAR + <TT +CLASS="PARAMETER" +><I +>destfile</I +></TT > - <VAR -CLASS="PDPARAM" ->flags</VAR + <TT +CLASS="PARAMETER" +><I +>flags</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6586,6 +7614,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6598,34 +7627,47 @@ NAME="DEFAULTTARGETCOMPILE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3796" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->default_target_compile</B +><TT +CLASS="FUNCTION" +>default_target_compile</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->source</VAR +>(<TT +CLASS="PARAMETER" +><I +>source</I +></TT > - <VAR -CLASS="PDPARAM" ->destfile</VAR + <TT +CLASS="PARAMETER" +><I +>destfile</I +></TT > - <VAR -CLASS="PDPARAM" ->type</VAR + <TT +CLASS="PARAMETER" +><I +>type</I +></TT > - <VAR -CLASS="PDPARAM" ->options</VAR + <TT +CLASS="PARAMETER" +><I +>options</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6673,6 +7715,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6685,22 +7728,29 @@ NAME="POPCONFIG" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3828" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->pop_config</B +><TT +CLASS="FUNCTION" +>pop_config</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->type</VAR +>(<TT +CLASS="PARAMETER" +><I +>type</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6715,6 +7765,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6727,22 +7778,29 @@ NAME="PRUNEWARNINGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3842" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->prune_warnings</B +><TT +CLASS="FUNCTION" +>prune_warnings</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->text</VAR +>(<TT +CLASS="PARAMETER" +><I +>text</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6757,6 +7815,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6769,22 +7828,29 @@ NAME="PUSHBUILD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3856" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->push_build</B +><TT +CLASS="FUNCTION" +>push_build</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->name</VAR +>(<TT +CLASS="PARAMETER" +><I +>name</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6799,6 +7865,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6811,26 +7878,35 @@ NAME="PUSHCONFIG" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3870" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->push_config</B +><TT +CLASS="FUNCTION" +>push_config</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->type</VAR +>(<TT +CLASS="PARAMETER" +><I +>type</I +></TT > - <VAR -CLASS="PDPARAM" ->name</VAR + <TT +CLASS="PARAMETER" +><I +>name</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6856,6 +7932,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6868,17 +7945,22 @@ NAME="REBOOTTARGET" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3890" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->reboot_target</B +><TT +CLASS="FUNCTION" +>reboot_target</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -6895,22 +7977,29 @@ NAME="TARGETASSEMBLE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3898" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->target_assemble</B +><TT +CLASS="FUNCTION" +>target_assemble</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->source destfile flags</VAR +>(<TT +CLASS="PARAMETER" +><I +>source destfile flags</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -6947,6 +8036,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -6959,34 +8049,47 @@ NAME="TARGETCOMPILE" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3922" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->target_compile</B +><TT +CLASS="FUNCTION" +>target_compile</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->source</VAR +>(<TT +CLASS="PARAMETER" +><I +>source</I +></TT > - <VAR -CLASS="PDPARAM" ->destfile</VAR + <TT +CLASS="PARAMETER" +><I +>destfile</I +></TT > - <VAR -CLASS="PDPARAM" ->type</VAR + <TT +CLASS="PARAMETER" +><I +>type</I +></TT > - <VAR -CLASS="PDPARAM" ->options</VAR + <TT +CLASS="PARAMETER" +><I +>options</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7035,6 +8138,7 @@ CLASS="PARAMETER" ></DL ></DIV ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -7055,30 +8159,41 @@ NAME="BOARDINFO" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3956" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->board_info</B +><TT +CLASS="FUNCTION" +>board_info</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->machine</VAR +>(<TT +CLASS="PARAMETER" +><I +>machine</I +></TT > - <VAR -CLASS="PDPARAM" ->op</VAR + <TT +CLASS="PARAMETER" +><I +>op</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7115,6 +8230,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7127,26 +8243,35 @@ NAME="HOSTINFO" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN3982" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->host_info</B +><TT +CLASS="FUNCTION" +>host_info</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->op</VAR +>(<TT +CLASS="PARAMETER" +><I +>op</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7172,6 +8297,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7184,26 +8310,35 @@ NAME="SETBOARDINFO" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4002" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->set_board_info</B +><TT +CLASS="FUNCTION" +>set_board_info</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->entry</VAR +>(<TT +CLASS="PARAMETER" +><I +>entry</I +></TT > - <VAR -CLASS="PDPARAM" ->value</VAR + <TT +CLASS="PARAMETER" +><I +>value</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7229,6 +8364,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7241,26 +8377,35 @@ NAME="SETCURRTARGETINFO" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4022" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->set_currtarget_info</B +><TT +CLASS="FUNCTION" +>set_currtarget_info</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->entry</VAR +>(<TT +CLASS="PARAMETER" +><I +>entry</I +></TT > - <VAR -CLASS="PDPARAM" ->value</VAR + <TT +CLASS="PARAMETER" +><I +>value</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7286,6 +8431,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7298,26 +8444,35 @@ NAME="TARGETINFO" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4042" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->target_info</B +><TT +CLASS="FUNCTION" +>target_info</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->op</VAR +>(<TT +CLASS="PARAMETER" +><I +>op</I +></TT > - <VAR -CLASS="PDPARAM" ->args</VAR + <TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7343,6 +8498,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7355,22 +8511,29 @@ NAME="UNSETBOARDINFO" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4062" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->unset_board_info</B +><TT +CLASS="FUNCTION" +>unset_board_info</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->entry</VAR +>(<TT +CLASS="PARAMETER" +><I +>entry</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7385,6 +8548,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7397,22 +8561,29 @@ NAME="UNSETCURRTARGETINFO" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4076" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->unset_currtarget_info</B +><TT +CLASS="FUNCTION" +>unset_currtarget_info</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->entry</VAR +>(<TT +CLASS="PARAMETER" +><I +>entry</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7427,6 +8598,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7451,22 +8623,29 @@ CLASS="SYMBOL" the global config file.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4093" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->push_target</B +><TT +CLASS="FUNCTION" +>push_target</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->name</VAR +>(<TT +CLASS="PARAMETER" +><I +>name</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7482,6 +8661,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7494,17 +8674,22 @@ NAME="POPTARGET" >This unsets the current target connection.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4107" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->pop_target</B +><TT +CLASS="FUNCTION" +>pop_target</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -7522,17 +8707,22 @@ NAME="LISTTARGETS" architecture.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4115" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->list_targets</B +><TT +CLASS="FUNCTION" +>list_targets</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -7562,22 +8752,29 @@ CLASS="SYMBOL" file.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4126" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->push_host</B +><TT +CLASS="FUNCTION" +>push_host</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->name</VAR +>(<TT +CLASS="PARAMETER" +><I +>name</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7592,6 +8789,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7604,17 +8802,22 @@ NAME="POPHOST" >This unsets the current host connection.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4140" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->pop_host</B +><TT +CLASS="FUNCTION" +>pop_host</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -7654,22 +8857,29 @@ CLASS="COMMAND" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4153" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->compile</B +><TT +CLASS="FUNCTION" +>compile</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->file</VAR +>(<TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7684,6 +8894,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7710,22 +8921,29 @@ CLASS="COMMAND" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4170" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->archive</B +><TT +CLASS="FUNCTION" +>archive</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->file</VAR +>(<TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7740,6 +8958,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7757,22 +8976,29 @@ CLASS="COMMAND" are used in for the flags.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4185" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->ranlib</B +><TT +CLASS="FUNCTION" +>ranlib</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->file</VAR +>(<TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7787,6 +9013,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -7815,22 +9042,29 @@ CLASS="COMMAND" running the tool to be tested, not a test case.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4201" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->execute_anywhere</B +><TT +CLASS="FUNCTION" +>execute_anywhere</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->cmdline</VAR +>(<TT +CLASS="PARAMETER" +><I +>cmdline</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -7846,6 +9080,7 @@ CLASS="PARAMETER" ></DL ></DIV ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -7979,17 +9214,22 @@ CLASS="FUNCTION" arrangements to run the tool).</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4245" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->${tool}_start</B +><TT +CLASS="FUNCTION" +>${tool}_start</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -8042,17 +9282,22 @@ CLASS="FUNCTION" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4260" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->${tool}_load</B +><TT +CLASS="FUNCTION" +>${tool}_load</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -8083,17 +9328,22 @@ CLASS="FUNCTION" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4271" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->${tool}_exit</B +><TT +CLASS="FUNCTION" +>${tool}_exit</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -8117,17 +9367,22 @@ CLASS="SYMBOL" tool, and its version number.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4280" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->${tool}_version</B +><TT +CLASS="FUNCTION" +>${tool}_version</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -8155,26 +9410,35 @@ NAME="GETDIRS" pattern. </P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4290" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->getdirs</B +><TT +CLASS="FUNCTION" +>getdirs</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->rootdir</VAR +>(<TT +CLASS="PARAMETER" +><I +>rootdir</I +></TT > - <VAR -CLASS="PDPARAM" ->pattern</VAR + <TT +CLASS="PARAMETER" +><I +>pattern</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8217,6 +9481,7 @@ CLASS="EMPHASIS" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8241,26 +9506,35 @@ CLASS="EMPHASIS" the pattern, then a NULL string is returned.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4315" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->find</B +><TT +CLASS="FUNCTION" +>find</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->rootdir</VAR +>(<TT +CLASS="PARAMETER" +><I +>rootdir</I +></TT > - <VAR -CLASS="PDPARAM" ->pattern</VAR + <TT +CLASS="PARAMETER" +><I +>pattern</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8288,6 +9562,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8327,22 +9602,29 @@ CLASS="COMMAND" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4342" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->which</B +><TT +CLASS="FUNCTION" +>which</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->file</VAR +>(<TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8358,6 +9640,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8398,30 +9681,41 @@ CLASS="OPTION" >.)</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4363" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->grep</B +><TT +CLASS="FUNCTION" +>grep</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->filename</VAR +>(<TT +CLASS="PARAMETER" +><I +>filename</I +></TT > - <VAR -CLASS="PDPARAM" ->regexp</VAR + <TT +CLASS="PARAMETER" +><I +>regexp</I +></TT > - <VAR -CLASS="PDPARAM" ->--line</VAR + <TT +CLASS="PARAMETER" +><I +>--line</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8464,6 +9758,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8486,26 +9781,35 @@ CLASS="EMPHASIS" pattern.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4392" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->prune</B +><TT +CLASS="FUNCTION" +>prune</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->list</VAR +>(<TT +CLASS="PARAMETER" +><I +>list</I +></TT > - <VAR -CLASS="PDPARAM" ->pattern</VAR + <TT +CLASS="PARAMETER" +><I +>pattern</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8534,6 +9838,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8552,22 +9857,29 @@ CLASS="EMPHASIS" installed.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4413" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->slay</B +><TT +CLASS="FUNCTION" +>slay</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->name</VAR +>(<TT +CLASS="PARAMETER" +><I +>name</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8582,6 +9894,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8598,22 +9911,29 @@ CLASS="EMPHASIS" and converts it to an absolute path.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4428" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->absolute</B +><TT +CLASS="FUNCTION" +>absolute</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->path</VAR +>(<TT +CLASS="PARAMETER" +><I +>path</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8628,6 +9948,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8652,22 +9973,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4445" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->psource</B +><TT +CLASS="FUNCTION" +>psource</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->file</VAR +>(<TT +CLASS="PARAMETER" +><I +>file</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8683,6 +10011,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8710,12 +10039,11 @@ CLASS="EMPHASIS" CLASS="EMPHASIS" >runtests</I > - is a list of two elements. The first is the pathname of the - testsuite expect script running. The second is a copy of what was on + is a list of two elements. The first is a copy of what was on the right side of the <I CLASS="EMPHASIS" >=</I -> if +> if <TABLE BORDER="0" BGCOLOR="#E0E0E0" @@ -8729,30 +10057,40 @@ CLASS="PROGRAMLISTING" ></TR ></TABLE >" was specified, or - an empty string if no such argument is present. This is used by tools - like compilers where each testcase is a file.</P + an empty string if no such argument is present. The second is the + pathname of the current testcase under consideration. This is used + by tools like compilers where each testcase is a file.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4466" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->runtest_file_p</B +><TT +CLASS="FUNCTION" +>runtest_file_p</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->runtests</VAR +>(<TT +CLASS="PARAMETER" +><I +>runtests</I +></TT > - <VAR -CLASS="PDPARAM" ->testcase</VAR + <TT +CLASS="PARAMETER" +><I +>testcase</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8763,8 +10101,8 @@ CLASS="PARAMETER" ></DT ><DD ><P ->The pathname of the testsuite expect script - running</P +>The list of patterns to compare against. + </P ></DD ><DT ><TT @@ -8779,6 +10117,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8803,26 +10142,35 @@ CLASS="SYMBOL" the screen.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4489" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->diff</B +><TT +CLASS="FUNCTION" +>diff</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->file_1</VAR +>(<TT +CLASS="PARAMETER" +><I +>file_1</I +></TT > - <VAR -CLASS="PDPARAM" ->file_2</VAR + <TT +CLASS="PARAMETER" +><I +>file_2</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8848,6 +10196,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8867,26 +10216,35 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4511" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->setenv</B +><TT +CLASS="FUNCTION" +>setenv</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->var</VAR +>(<TT +CLASS="PARAMETER" +><I +>var</I +></TT > - <VAR -CLASS="PDPARAM" ->val</VAR + <TT +CLASS="PARAMETER" +><I +>val</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8912,6 +10270,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8928,22 +10287,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4532" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->unsetenv</B +><TT +CLASS="FUNCTION" +>unsetenv</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->var</VAR +>(<TT +CLASS="PARAMETER" +><I +>var</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -8959,6 +10325,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -8975,22 +10342,29 @@ CLASS="EMPHASIS" environment if it exists, otherwise it returns NULL.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4547" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->getenv</B +><TT +CLASS="FUNCTION" +>getenv</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->var</VAR +>(<TT +CLASS="PARAMETER" +><I +>var</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9006,6 +10380,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9028,26 +10403,35 @@ CLASS="EMPHASIS" date.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4563" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->prune_system_crud</B +><TT +CLASS="FUNCTION" +>prune_system_crud</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->system</VAR +>(<TT +CLASS="PARAMETER" +><I +>system</I +></TT > - <VAR -CLASS="PDPARAM" ->test</VAR + <TT +CLASS="PARAMETER" +><I +>test</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9076,6 +10460,7 @@ CLASS="PARAMETER" ></DL ></DIV ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -9103,22 +10488,29 @@ NAME="LIBGLOSSLINKFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4587" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->libgloss_link_flags</B +><TT +CLASS="FUNCTION" +>libgloss_link_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9133,6 +10525,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9145,22 +10538,29 @@ NAME="LIBGLOSSINCLUDEFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4601" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->libgloss_include_flags</B +><TT +CLASS="FUNCTION" +>libgloss_include_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9175,6 +10575,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9187,22 +10588,29 @@ NAME="NEWLIBLINKFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4615" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->newlib_link_flags</B +><TT +CLASS="FUNCTION" +>newlib_link_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9217,6 +10625,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9229,22 +10638,29 @@ NAME="NEWLIBINCLUDEFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4629" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->newlib_include_flags</B +><TT +CLASS="FUNCTION" +>newlib_include_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9259,6 +10675,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9271,22 +10688,29 @@ NAME="LIBIOINCLUDEFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4643" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->libio_include_flags</B +><TT +CLASS="FUNCTION" +>libio_include_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9301,6 +10725,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9313,22 +10738,29 @@ NAME="LIBIOLINKFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4657" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->libio_link_flags</B +><TT +CLASS="FUNCTION" +>libio_link_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9343,6 +10775,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9355,22 +10788,29 @@ NAME="GXXINCLUDEFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4671" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->g++_include_flags</B +><TT +CLASS="FUNCTION" +>g++_include_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9385,6 +10825,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9397,22 +10838,29 @@ NAME="GXXLINKFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4685" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->g++_link_flags</B +><TT +CLASS="FUNCTION" +>g++_link_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9427,6 +10875,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9439,22 +10888,29 @@ NAME="LIBSTDCXXINCLUDEFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4699" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->libstdc++_include_flags</B +><TT +CLASS="FUNCTION" +>libstdc++_include_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9469,6 +10925,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9481,22 +10938,29 @@ NAME="LIBSTDCXXLINKFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4713" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->libstdc++_link_flags</B +><TT +CLASS="FUNCTION" +>libstdc++_link_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9511,6 +10975,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9523,22 +10988,29 @@ NAME="GETMULTILIBS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4727" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->get_multilibs</B +><TT +CLASS="FUNCTION" +>get_multilibs</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9553,6 +11025,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9565,22 +11038,29 @@ NAME="FINDBINUTILSPROG" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4741" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->find_binutils_prog</B +><TT +CLASS="FUNCTION" +>find_binutils_prog</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->name</VAR +>(<TT +CLASS="PARAMETER" +><I +>name</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9595,6 +11075,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9607,17 +11088,22 @@ NAME="FINDGCC" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4755" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->find_gcc</B +><TT +CLASS="FUNCTION" +>find_gcc</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -9634,17 +11120,22 @@ NAME="FINDGCJ" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4763" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->find_gcj</B +><TT +CLASS="FUNCTION" +>find_gcj</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -9661,17 +11152,22 @@ NAME="FINDGXX" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4771" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->find_g++</B +><TT +CLASS="FUNCTION" +>find_g++</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -9688,17 +11184,22 @@ NAME="FINDG77" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4779" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->find_g77</B +><TT +CLASS="FUNCTION" +>find_g77</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -9715,22 +11216,29 @@ NAME="PROCESSMULTILIBOPTIONS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4787" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->process_multilib_options</B +><TT +CLASS="FUNCTION" +>process_multilib_options</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9745,6 +11253,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9757,22 +11266,29 @@ NAME="ADDMULTILIBOPTION" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4801" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->add_multilib_option</B +><TT +CLASS="FUNCTION" +>add_multilib_option</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9787,6 +11303,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9799,17 +11316,22 @@ NAME="FINDGAS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4815" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->find_gas</B +><TT +CLASS="FUNCTION" +>find_gas</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -9826,17 +11348,22 @@ NAME="FINDLD" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4823" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->find_ld</B +><TT +CLASS="FUNCTION" +>find_ld</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV @@ -9853,22 +11380,29 @@ NAME="BUILDWRAPPER" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4831" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->build_wrapper</B +><TT +CLASS="FUNCTION" +>build_wrapper</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->gluefile</VAR +>(<TT +CLASS="PARAMETER" +><I +>gluefile</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9883,6 +11417,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9895,22 +11430,29 @@ NAME="WINSUPINCLUDEFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4845" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->winsup_include_flags</B +><TT +CLASS="FUNCTION" +>winsup_include_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9925,6 +11467,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -9937,22 +11480,29 @@ NAME="WINSUPLINKFLAGS" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4859" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->winsup_link_flags</B +><TT +CLASS="FUNCTION" +>winsup_link_flags</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -9968,6 +11518,7 @@ CLASS="PARAMETER" ></DL ></DIV ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -9999,22 +11550,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4878" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->dumpvars</B +><TT +CLASS="FUNCTION" +>dumpvars</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->vars</VAR +>(<TT +CLASS="PARAMETER" +><I +>vars</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10029,6 +11587,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10046,22 +11605,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4893" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->dumplocals</B +><TT +CLASS="FUNCTION" +>dumplocals</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10076,6 +11642,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10093,22 +11660,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4908" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->dumprocs</B +><TT +CLASS="FUNCTION" +>dumprocs</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->pattern</VAR +>(<TT +CLASS="PARAMETER" +><I +>pattern</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10124,6 +11698,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10141,22 +11716,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4923" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->dumpwatch</B +><TT +CLASS="FUNCTION" +>dumpwatch</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->pattern</VAR +>(<TT +CLASS="PARAMETER" +><I +>pattern</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10172,6 +11754,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10184,26 +11767,35 @@ NAME="WATCHARRAY" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4937" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->watcharray</B +><TT +CLASS="FUNCTION" +>watcharray</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->element</VAR +>(<TT +CLASS="PARAMETER" +><I +>element</I +></TT > - <VAR -CLASS="PDPARAM" ->type</VAR + <TT +CLASS="PARAMETER" +><I +>type</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10219,6 +11811,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10231,26 +11824,35 @@ NAME="WATCHVAR" ></P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4952" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->watchvar</B +><TT +CLASS="FUNCTION" +>watchvar</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->var</VAR +>(<TT +CLASS="PARAMETER" +><I +>var</I +></TT > - <VAR -CLASS="PDPARAM" ->type</VAR + <TT +CLASS="PARAMETER" +><I +>type</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10265,6 +11867,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10285,22 +11888,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4969" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->watchunset</B +><TT +CLASS="FUNCTION" +>watchunset</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->arg</VAR +>(<TT +CLASS="PARAMETER" +><I +>arg</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10315,6 +11925,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10335,22 +11946,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN4985" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->watchwrite</B +><TT +CLASS="FUNCTION" +>watchwrite</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->var</VAR +>(<TT +CLASS="PARAMETER" +><I +>var</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10365,6 +11983,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10385,22 +12004,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5001" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->watchread</B +><TT +CLASS="FUNCTION" +>watchread</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->var</VAR +>(<TT +CLASS="PARAMETER" +><I +>var</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10415,6 +12041,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10431,22 +12058,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5016" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->watchdel</B +><TT +CLASS="FUNCTION" +>watchdel</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->args</VAR +>(<TT +CLASS="PARAMETER" +><I +>args</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10461,6 +12095,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10483,22 +12118,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5032" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->print</B +><TT +CLASS="FUNCTION" +>print</TT ></CODE ->(<VAR -CLASS="PDPARAM" ->var</VAR +>(<TT +CLASS="PARAMETER" +><I +>var</I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10513,6 +12155,7 @@ CLASS="PARAMETER" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT3" ><H3 @@ -10529,22 +12172,29 @@ CLASS="EMPHASIS" >.</P ><DIV CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5047" +></A ><P ></P ><CODE CLASS="FUNCDEF" -><B -CLASS="FSFUNC" ->quit</B +><TT +CLASS="FUNCTION" +>quit</TT ></CODE ->(<VAR -CLASS="PDPARAM" -></VAR +>(<TT +CLASS="PARAMETER" +><I +></I +></TT >);<P ></P ></DIV ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -10561,6 +12211,7 @@ CLASS="PARAMETER" ></DIV ></DIV ></DIV +></DIV ><DIV CLASS="NAVFOOTER" ><HR @@ -10577,7 +12228,7 @@ ALIGN="left" VALIGN="top" ><A HREF="installation.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -10593,7 +12244,7 @@ ALIGN="right" VALIGN="top" ><A HREF="filemap.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/configfile.html b/doc/overview/configfile.html index 9d75311..75db2d9 100644 --- a/doc/overview/configfile.html +++ b/doc/overview/configfile.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Config File Values</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Extending DejaGnu" HREF="extending.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="releng.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 3. Customizing DejaGnu</TD +>Customizing DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="extending.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -86,9 +94,7 @@ NAME="OPTIONDEFS" ><P >In the user editable second section of the <A HREF="configfile.html#PERSONAL" -><I ->Personal Config File</I -></A +>Personal Config File</A > you can not only override the configuration variables captured in the first section, but also specify default values for all on the <B @@ -119,21 +125,26 @@ CLASS="FILENAME" >site.exp</TT >. <A HREF="runtest.html#INVOKING" -><I ->Invoking Runtest</I -></A +>Invoking Runtest</A >, for explanations of the command-line options.</P ><P ><DIV CLASS="TABLE" +><A +NAME="AEN1008" +></A ><P ><B ->Table 3-1. Tcl Variables For Command Line Options</B +>Table 1. Tcl Variables For Command Line Options</B ></P ><TABLE BORDER="1" +BGCOLOR="#E0E0E0" +CELLSPACING="0" +CELLPADDING="4" CLASS="CALSTABLE" +><THEAD ><TR ><TH ALIGN="LEFT" @@ -156,6 +167,8 @@ ALIGN="LEFT" VALIGN="TOP" >description</TH ></TR +></THEAD +><TBODY ><TR ><TD ALIGN="LEFT" @@ -391,6 +404,7 @@ ALIGN="LEFT" VALIGN="TOP" >Email the output log to the specified address.</TD ></TR +></TBODY ></TABLE ></DIV > @@ -418,9 +432,12 @@ CLASS="FILENAME" > file looks like:</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN1090" +></A ><P ><B ->Example 3-12. Personal Config File</B +>Example 12. Personal Config File</B ></P ><TABLE BORDER="0" @@ -481,7 +498,7 @@ ALIGN="left" VALIGN="top" ><A HREF="releng.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -497,7 +514,7 @@ ALIGN="right" VALIGN="top" ><A HREF="extending.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/cppunit.html b/doc/overview/cppunit.html new file mode 100644 index 0000000..13ae6e6 --- /dev/null +++ b/doc/overview/cppunit.html @@ -0,0 +1,306 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<HTML +><HEAD +><TITLE +>C++ Unit Testing API</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK +REL="HOME" +TITLE="DejaGnu" +HREF="book1.html"><LINK +REL="UP" +TITLE="Unit Testing API" +HREF="unittestapi.html"><LINK +REL="PREVIOUS" +TITLE="Unit Testing API" +HREF="unittestapi.html"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>DejaGnu: The GNU Testing Framework</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="unittestapi.html" +><<< Previous</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +>Unit Testing API</TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +> </TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CPPUNIT" +>C++ Unit Testing API</A +></H1 +><P +>All of the methods that take a + <TT +CLASS="PARAMETER" +><I +>msg</I +></TT +> parameter use a C char * + or STL string, that is the message to be + dislayed. There currently is no support for variable + length arguments.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="PASSMETH" +>Pass Method</A +></H2 +><P +>This prints a message for a successful test + completion.</P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5165" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>TestState::pass</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +>msg</I +></TT +>);<P +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="FAILMETH" +>Fail Method</A +></H2 +><P +>This prints a message for an unsuccessful test + completion.</P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5173" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>TestState::fail</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +>msg</I +></TT +>);<P +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="UNTESTEDMETH" +>Untested Method</A +></H2 +><P +>This prints a message for an test case that isn't run + for some technical reason.</P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5181" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>TestState::untested</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +>msg</I +></TT +>);<P +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="UNRESOLVEDMETH" +>Unresolved Method</A +></H2 +><P +>This prints a message for an test case that is run, + but there is no clear result. These output states require a + human to look over the results to determine what happened. + </P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5189" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>TestState::unresolved</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +>msg</I +></TT +>);<P +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="TOTALSMETH" +>Totals Method</A +></H2 +><P +>This prints out the total numbers of all the test + state outputs.</P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5197" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>TestState::totals</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +></I +></TT +>);<P +></P +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="unittestapi.html" +><<< Previous</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="book1.html" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +> </TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Unit Testing API</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="unittestapi.html" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +> </TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/doc/overview/customizing.html b/doc/overview/customizing.html index 2ae04c4..b756ab0 100644 --- a/doc/overview/customizing.html +++ b/doc/overview/customizing.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Customizing DejaGnu</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -15,6 +17,12 @@ REL="NEXT" TITLE="Global Config File" HREF="global.html"></HEAD ><BODY +CLASS="CHAPTER" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -35,7 +43,7 @@ ALIGN="left" VALIGN="bottom" ><A HREF="outputfiles.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" @@ -48,7 +56,7 @@ ALIGN="right" VALIGN="bottom" ><A HREF="global.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -60,42 +68,8 @@ CLASS="CHAPTER" ><H1 ><A NAME="CUSTOMIZING" ->Chapter 3. Customizing DejaGnu</A +>Customizing DejaGnu</A ></H1 -><DIV -CLASS="TOC" -><DL -><DT -><B ->Table of Contents</B -></DT -><DT -><A -HREF="customizing.html#LOCAL" ->Local Config File</A -></DT -><DT -><A -HREF="global.html" ->Global Config File</A -></DT -><DT -><A -HREF="boardconfig.html" ->Board Config File</A -></DT -><DT -><A -HREF="releng.html" ->Remote Host Testing</A -></DT -><DT -><A -HREF="configfile.html" ->Config File Values</A -></DT -></DL -></DIV ><P >The site configuration file, <TT CLASS="FILENAME" @@ -283,9 +257,12 @@ CLASS="COMMAND" >.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN896" +></A ><P ><B ->Example 3-1. The first section starts with</B +>Example 1. The first section starts with</B ></P ><TABLE BORDER="0" @@ -320,9 +297,12 @@ CLASS="COMMAND" also be empty, if you do not wish to override any defaults.)</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN902" +></A ><P ><B ->Example 3-2. The first section ends with this line</B +>Example 2. The first section ends with this line</B ></P ><TABLE BORDER="0" @@ -355,7 +335,7 @@ CLASS="SYMBOL" CLASS="SYMBOL" >target_triplet</SPAN >. All other variables are tool - dependant. ie for testing a compiler, the value for + dependant, i.e., for testing a compiler, the value for <SPAN CLASS="SYMBOL" >CC</SPAN @@ -369,9 +349,12 @@ CLASS="PRODUCTNAME" > testing.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN912" +></A ><P ><B ->Example 3-3. Local Config File</B +>Example 3. Local Config File</B ></P ><TABLE BORDER="0" @@ -427,7 +410,7 @@ ALIGN="left" VALIGN="top" ><A HREF="outputfiles.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -443,7 +426,7 @@ ALIGN="right" VALIGN="top" ><A HREF="global.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/debugging.html b/doc/overview/debugging.html index 2c1f33b..7f857c8 100644 --- a/doc/overview/debugging.html +++ b/doc/overview/debugging.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Debugging A Test Case</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Adding A Test Case To A Test Suite." HREF="adding.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="writing.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="adding.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -202,7 +210,7 @@ ALIGN="left" VALIGN="top" ><A HREF="writing.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -218,7 +226,7 @@ ALIGN="right" VALIGN="top" ><A HREF="adding.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/designgoals.html b/doc/overview/designgoals.html index eea7d1a..c5024c5 100644 --- a/doc/overview/designgoals.html +++ b/doc/overview/designgoals.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Design Goals</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="A POSIX conforming test framework" HREF="posix.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="new.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 1. Overview</TD +>Overview</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="posix.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -101,7 +109,7 @@ STYLE="list-style-type: disc" ><LI STYLE="list-style-type: disc" ><P ->permited testing interactive programs, like +>permitted testing interactive programs, like <B CLASS="COMMAND" >GDB</B @@ -110,7 +118,7 @@ CLASS="COMMAND" ><LI STYLE="list-style-type: disc" ><P ->permited testing batch oriented programs, like +>permitted testing batch oriented programs, like <B CLASS="COMMAND" >GCC</B @@ -174,7 +182,7 @@ ALIGN="left" VALIGN="top" ><A HREF="new.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -190,7 +198,7 @@ ALIGN="right" VALIGN="top" ><A HREF="posix.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/djh.html b/doc/overview/djh.html new file mode 100644 index 0000000..601833e --- /dev/null +++ b/doc/overview/djh.html @@ -0,0 +1,147 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<HTML +><HEAD +><TITLE +>The dejagnu.h Header File</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK +REL="HOME" +TITLE="DejaGnu" +HREF="book1.html"><LINK +REL="UP" +TITLE="Unit Testing" +HREF="unit.html"><LINK +REL="PREVIOUS" +TITLE="Unit Testing" +HREF="unit.html"><LINK +REL="NEXT" +TITLE="Reference" +HREF="reference.html"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>DejaGnu: The GNU Testing Framework</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="unit.html" +><<< Previous</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +>Unit Testing</TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="reference.html" +>Next >>></A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="DJH" +>The dejagnu.h Header File</A +></H1 +><P +>DejaGnu uses a single header file to assist in unit + testing. As this file also produces it's one test state output, + it can be run standalone, which is very useful for testing on + embedded systems. This header file has a C and C++ API for the + test states, with simple totals, and standardized + output. Because the output has been standardized, DejaGnu can be + made to work with this test case, without writing almost any + Tcl. The library module, dejagnu.exp, will look for the output + messages, and then merge them into DejaGnu's.</P +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="unit.html" +><<< Previous</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="book1.html" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="reference.html" +>Next >>></A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Unit Testing</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="unit.html" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Reference</TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/doc/overview/extending.html b/doc/overview/extending.html index 904f6af..c6ce943 100644 --- a/doc/overview/extending.html +++ b/doc/overview/extending.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Extending DejaGnu</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -15,6 +17,12 @@ REL="NEXT" TITLE="Adding A New Tool" HREF="addtool.html"></HEAD ><BODY +CLASS="CHAPTER" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -35,7 +43,7 @@ ALIGN="left" VALIGN="bottom" ><A HREF="configfile.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" @@ -48,7 +56,7 @@ ALIGN="right" VALIGN="bottom" ><A HREF="addtool.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -60,68 +68,9 @@ CLASS="CHAPTER" ><H1 ><A NAME="EXTENDING" ->Chapter 4. Extending DejaGnu</A +>Extending DejaGnu</A ></H1 ><DIV -CLASS="TOC" -><DL -><DT -><B ->Table of Contents</B -></DT -><DT -><A -HREF="extending.html#ADDSUITE" ->Adding A New Test Suite</A -></DT -><DT -><A -HREF="addtool.html" ->Adding A New Tool</A -></DT -><DT -><A -HREF="addtarget.html" ->Adding A New Target</A -></DT -><DT -><A -HREF="addboard.html" ->Adding A New Board</A -></DT -><DT -><A -HREF="boarddefs.html" ->Board Config File Values</A -></DT -><DT -><A -HREF="writing.html" ->Writing A Test Case</A -></DT -><DT -><A -HREF="debugging.html" ->Debugging A Test Case</A -></DT -><DT -><A -HREF="adding.html" ->Adding A Test Case To A Test Suite.</A -></DT -><DT -><A -HREF="hints.html" ->Hints On Writing A Test Case</A -></DT -><DT -><A -HREF="tvariables.html" ->Special variables used by test cases.</A -></DT -></DL -></DIV -><DIV CLASS="SECT1" ><H1 CLASS="SECT1" @@ -163,7 +112,7 @@ ALIGN="left" VALIGN="top" ><A HREF="configfile.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -179,7 +128,7 @@ ALIGN="right" VALIGN="top" ><A HREF="addtool.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/filemap.html b/doc/overview/filemap.html index 6ea4a31..edde972 100644 --- a/doc/overview/filemap.html +++ b/doc/overview/filemap.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >File Map</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -13,8 +15,17 @@ TITLE="Reference" HREF="reference.html"><LINK REL="PREVIOUS" TITLE="Builtin Procedures" -HREF="builtins.html"></HEAD +HREF="builtins.html"><LINK +REL="NEXT" +TITLE="Unit Testing API" +HREF="unittestapi.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -35,18 +46,21 @@ ALIGN="left" VALIGN="bottom" ><A HREF="builtins.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 5. Reference</TD +>Reference</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" -> </TD +><A +HREF="unittestapi.html" +>Next >>></A +></TD ></TR ></TABLE ><HR @@ -161,6 +175,10 @@ NAME="FILEMAP" ><P >lib/xsh.exp</P ></LI +><LI +><P +>lib/dejagnu.exp</P +></LI ></UL ></DIV ><DIV @@ -179,7 +197,7 @@ ALIGN="left" VALIGN="top" ><A HREF="builtins.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -193,7 +211,10 @@ HREF="book1.html" WIDTH="33%" ALIGN="right" VALIGN="top" -> </TD +><A +HREF="unittestapi.html" +>Next >>></A +></TD ></TR ><TR ><TD @@ -213,7 +234,7 @@ HREF="reference.html" WIDTH="33%" ALIGN="right" VALIGN="top" -> </TD +>Unit Testing API</TD ></TR ></TABLE ></DIV diff --git a/doc/overview/gettingup.html b/doc/overview/gettingup.html new file mode 100644 index 0000000..bc3ec37 --- /dev/null +++ b/doc/overview/gettingup.html @@ -0,0 +1,247 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<HTML +><HEAD +><TITLE +>Getting DejaGnu up and running</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK +REL="HOME" +TITLE="DejaGnu" +HREF="book1.html"><LINK +REL="PREVIOUS" +TITLE="A POSIX conforming test framework" +HREF="posix.html"><LINK +REL="NEXT" +TITLE="Create a minimal project, e.g. calc" +HREF="x227.html"></HEAD +><BODY +CLASS="CHAPTER" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>DejaGnu: The GNU Testing Framework</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="posix.html" +><<< Previous</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="x227.html" +>Next >>></A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="CHAPTER" +><H1 +><A +NAME="GETTINGUP" +>Getting DejaGnu up and running</A +></H1 +><P +>This chapter was originally written by Niklaus Giger (ngiger@mus.ch) because he lost a week to figure out how DejaGnu works and how to write a first test.</P +><P +>Follow these instructions as closely a possible in order get a good insight into how DejaGnu works, else you might run into a lot of subtle problems. You have been warned.</P +><P +>It should be no big problems installing DejaGnu using your package manager or from the source code. Under a Debian/GNU/Linux systems just type (as root) <TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>apt-get dejagnu</PRE +></TD +></TR +></TABLE +>. These examples were run on a primary machine with a AMD K6 and a Mac Powerbook G3 serving as a remote target.</P +><P +> The tests for Windows were run under Windows NT using the actual cygwin version (1.3.x as of October 2001). It's target system was a PPC embedded system running vxWorks. </P +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN210" +>Test your installation</A +></H1 +><P +>Create a new user called "dgt" (DejaGnuTest), which uses bash as it login shell. PS1 must be set to '\u:\w\$ ' in its ~/.bashrc. Login as this user, create an empty directory and change the working directory to it. e.g</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~$ mkdir ~/dejagnu.test +dgt:~$ cd ~/dejagnu.test</PRE +></TD +></TR +></TABLE +><P +>Now you are ready to test DejaGnu's main program called ruuntest. The expecteted output is shown</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN215" +></A +><P +><B +>Example 1. Runtest output in a empty directory</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ runtest +WARNING: Couldn't find the global config file. +WARNING: No tool specified Test +Run By dgt on Sun Nov 25 17:07:03 2001 Native configuration is i586-pc-linux-gnu +=== tests === +Schedule of variations: unix +Running target unix Using /usr/share/dejagnu/baseboards/unix.exp as board description file for target. +Using /usr/share/dejagnu/config/unix.exp as generic interface file for target. +ERROR: Couldn't find tool config file for unix. +=== Summary ===</PRE +></TD +></TR +></TABLE +><P +>We will show you later how to get rid of all the WARNING- and ERROR-messages. The files testrun.sum and testrun.log have been created, which do not interest us at this point. Let's remove them.</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>:~/dejagnu.test$ rm testrun.sum testrun.log </PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN220" +>Windows</A +></H2 +><P +>On Windows systems DejaGnu is part of a port of a lot of Unix tools to the Windows OS, called cygwin. Cygwin may be downloaded and installed from a mirror of http://sources.redhat.com/cygwin/. All examples were also run on Windows NT. If nothing is said, you can assume that you should get the same output as on a Unix system.</P +><P +>You will need a telnet daemon if you want to use a WindowsNT box as a remote target. There seems to be a freeware telnet daemon at http://www.fictional.net/.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN224" +>Getting the source code for the calc example</A +></H2 +><P +>If you are running a Debian distribution you can find the examples under /usr/share/doc/dejagnu/examples. +These examples seem to be missing in RedHat's RPM. +In this case download the sources of DejaGnu and adjust the pathes to the DejaGnu examples accordingly.</P +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="posix.html" +><<< Previous</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="book1.html" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="x227.html" +>Next >>></A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>A POSIX conforming test framework</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Create a minimal project, e.g. calc</TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/doc/overview/global.html b/doc/overview/global.html index e3a988c..ce1f4cc 100644 --- a/doc/overview/global.html +++ b/doc/overview/global.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Global Config File</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Board Config File" HREF="boardconfig.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="customizing.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 3. Customizing DejaGnu</TD +>Customizing DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="boardconfig.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -87,9 +95,12 @@ CLASS="EMPHASIS" debugging protocol, we test on both of them in sequence.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN921" +></A ><P ><B ->Example 3-4. Global Config file</B +>Example 4. Global Config file</B ></P ><TABLE BORDER="0" @@ -164,9 +175,7 @@ CLASS="EMPHASIS" symbolic names for other mips boards. Symbolic names are covered in the <A HREF="addboard.html" -><I ->Adding A New Board</I -></A +>Adding A New Board</A > chapter. The more complicated example is the one for <I CLASS="EMPHASIS" @@ -199,7 +208,7 @@ ALIGN="left" VALIGN="top" ><A HREF="customizing.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -215,7 +224,7 @@ ALIGN="right" VALIGN="top" ><A HREF="boardconfig.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/hints.html b/doc/overview/hints.html index cac3d76..5dce09d 100644 --- a/doc/overview/hints.html +++ b/doc/overview/hints.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Hints On Writing A Test Case</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Special variables used by test cases." HREF="tvariables.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="adding.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="tvariables.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -212,7 +220,7 @@ ALIGN="left" VALIGN="top" ><A HREF="adding.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -228,7 +236,7 @@ ALIGN="right" VALIGN="top" ><A HREF="tvariables.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/installation.html b/doc/overview/installation.html index 0720d39..19c5c08 100644 --- a/doc/overview/installation.html +++ b/doc/overview/installation.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Installation</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Builtin Procedures" HREF="builtins.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="reference.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 5. Reference</TD +>Reference</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="builtins.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -108,7 +116,7 @@ WIDTH="100%" ><TD ><PRE CLASS="SCREEN" -> ../dejagnu-1.4/configure +> ../dejagnu-1.4.3/configure </PRE ></TD ></TR @@ -301,7 +309,7 @@ ALIGN="left" VALIGN="top" ><A HREF="reference.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -317,7 +325,7 @@ ALIGN="right" VALIGN="top" ><A HREF="builtins.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/new.html b/doc/overview/new.html index 87e17b5..8f19cac 100644 --- a/doc/overview/new.html +++ b/doc/overview/new.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >What's New In This Release</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Design Goals" HREF="designgoals.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="overview.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 1. Overview</TD +>Overview</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="designgoals.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -93,9 +101,7 @@ CLASS="PRODUCTNAME" preferably with a target supported by <A HREF="builtins.html#LIBGLOSS" -><I ->Libgloss</I -></A +>Libgloss</A >.</P ></LI ><LI @@ -182,7 +188,7 @@ ALIGN="left" VALIGN="top" ><A HREF="overview.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -198,7 +204,7 @@ ALIGN="right" VALIGN="top" ><A HREF="designgoals.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/outputfiles.html b/doc/overview/outputfiles.html index ff8e8bf..97980f4 100644 --- a/doc/overview/outputfiles.html +++ b/doc/overview/outputfiles.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >The files DejaGnu produces.</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Customizing DejaGnu" HREF="customizing.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="runtest.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 2. Running Tests</TD +>Running Tests</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="customizing.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -159,9 +167,12 @@ CLASS="OPTION" directory.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN780" +></A ><P ><B ->Example 2-1. Here is a short sample summary log</B +>Example 1. Here is a short sample summary log</B ></P ><TABLE BORDER="0" @@ -225,9 +236,12 @@ CLASS="OPTION" directory.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN790" +></A ><P ><B ->Example 2-2. Here is a brief example showing a detailed log for +>Example 2. Here is a brief example showing a detailed log for <SPAN CLASS="PRODUCTNAME" >G++</SPAN @@ -323,9 +337,12 @@ CLASS="PRODUCTNAME" pattern it compares with the tool output.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN805" +></A ><P ><B ->Example 2-3. The log messages begin with a message of the form</B +>Example 3. The log messages begin with a message of the form</B ></P ><TABLE BORDER="0" @@ -387,9 +404,12 @@ CLASS="PRODUCTNAME" variables set to describe a successful match.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN820" +></A ><P ><B ->Example 2-4. Here is an excerpt from the debugging log for a +>Example 4. Here is an excerpt from the debugging log for a <SPAN CLASS="PRODUCTNAME" >GDB</SPAN @@ -550,7 +570,7 @@ ALIGN="left" VALIGN="top" ><A HREF="runtest.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -566,7 +586,7 @@ ALIGN="right" VALIGN="top" ><A HREF="customizing.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/overview.html b/doc/overview/overview.html index 1972cb9..e04da13 100644 --- a/doc/overview/overview.html +++ b/doc/overview/overview.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Overview</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -15,6 +17,12 @@ REL="NEXT" TITLE="What's New In This Release" HREF="new.html"></HEAD ><BODY +CLASS="CHAPTER" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -35,7 +43,7 @@ ALIGN="left" VALIGN="bottom" ><A HREF="preface.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" @@ -48,7 +56,7 @@ ALIGN="right" VALIGN="bottom" ><A HREF="new.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -60,38 +68,9 @@ CLASS="CHAPTER" ><H1 ><A NAME="OVERVIEW" ->Chapter 1. Overview</A +>Overview</A ></H1 ><DIV -CLASS="TOC" -><DL -><DT -><B ->Table of Contents</B -></DT -><DT -><A -HREF="overview.html#WHATIS" ->What is DejaGnu ?</A -></DT -><DT -><A -HREF="new.html" ->What's New In This Release</A -></DT -><DT -><A -HREF="designgoals.html" ->Design Goals</A -></DT -><DT -><A -HREF="posix.html" ->A POSIX conforming test framework</A -></DT -></DL -></DIV -><DIV CLASS="SECT1" ><H1 CLASS="SECT1" @@ -236,7 +215,7 @@ ALIGN="left" VALIGN="top" ><A HREF="preface.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -252,7 +231,7 @@ ALIGN="right" VALIGN="top" ><A HREF="new.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/posix.html b/doc/overview/posix.html index 3f96d05..68895f7 100644 --- a/doc/overview/posix.html +++ b/doc/overview/posix.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >A POSIX conforming test framework</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -15,9 +17,15 @@ REL="PREVIOUS" TITLE="Design Goals" HREF="designgoals.html"><LINK REL="NEXT" -TITLE="Running Tests" -HREF="runningtests.html"></HEAD +TITLE="Getting DejaGnu up and running" +HREF="gettingup.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="designgoals.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 1. Overview</TD +>Overview</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A -HREF="runningtests.html" ->Next</A +HREF="gettingup.html" +>Next >>></A ></TD ></TR ></TABLE @@ -102,6 +110,8 @@ CLASS="FIRSTTERM" case:</P ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT >PASS</DT @@ -198,6 +208,7 @@ CLASS="EMPHASIS" >:</P ></DD ></DL +></DIV ><P ></P ><UL @@ -248,6 +259,8 @@ STYLE="list-style-type: disc" ></UL ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT >UNTESTED</DT @@ -257,12 +270,15 @@ STYLE="list-style-type: disc" when there is no real test case yet.</P ></DD ></DL +></DIV ><P >The only remaining output message left is intended to test features that are specified by the applicable POSIX standard as conditional:</P ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT >UNSUPPORTED</DT @@ -281,6 +297,7 @@ CLASS="EMPHASIS" monitor.</P ></DD ></DL +></DIV ><P >DejaGnu uses the same output procedures to produce these messages for all test suites, and these procedures are already known to conform @@ -319,7 +336,7 @@ ALIGN="left" VALIGN="top" ><A HREF="designgoals.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -334,8 +351,8 @@ WIDTH="33%" ALIGN="right" VALIGN="top" ><A -HREF="runningtests.html" ->Next</A +HREF="gettingup.html" +>Next >>></A ></TD ></TR ><TR @@ -356,7 +373,7 @@ HREF="overview.html" WIDTH="33%" ALIGN="right" VALIGN="top" ->Running Tests</TD +>Getting DejaGnu up and running</TD ></TR ></TABLE ></DIV diff --git a/doc/overview/preface.html b/doc/overview/preface.html index 7ffa9cc..2dd245f 100644 --- a/doc/overview/preface.html +++ b/doc/overview/preface.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Abstract</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -15,6 +17,12 @@ REL="NEXT" TITLE="Overview" HREF="overview.html"></HEAD ><BODY +CLASS="PREFACE" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -35,7 +43,7 @@ ALIGN="left" VALIGN="bottom" ><A HREF="book1.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" @@ -48,7 +56,7 @@ ALIGN="right" VALIGN="bottom" ><A HREF="overview.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -114,7 +122,7 @@ ALIGN="left" VALIGN="top" ><A HREF="book1.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -130,7 +138,7 @@ ALIGN="right" VALIGN="top" ><A HREF="overview.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/reference.html b/doc/overview/reference.html index 9e4b9ca..d878d06 100644 --- a/doc/overview/reference.html +++ b/doc/overview/reference.html @@ -1,20 +1,28 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Reference</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK REL="PREVIOUS" -TITLE="Special variables used by test cases." -HREF="tvariables.html"><LINK +TITLE="The dejagnu.h Header File" +HREF="djh.html"><LINK REL="NEXT" TITLE="Installation" HREF="installation.html"></HEAD ><BODY +CLASS="CHAPTER" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -34,8 +42,8 @@ WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A -HREF="tvariables.html" ->Prev</A +HREF="djh.html" +><<< Previous</A ></TD ><TD WIDTH="80%" @@ -48,7 +56,7 @@ ALIGN="right" VALIGN="bottom" ><A HREF="installation.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -60,38 +68,9 @@ CLASS="CHAPTER" ><H1 ><A NAME="REFERENCE" ->Chapter 5. Reference</A +>Reference</A ></H1 ><DIV -CLASS="TOC" -><DL -><DT -><B ->Table of Contents</B -></DT -><DT -><A -HREF="reference.html#OBTAINING" ->Obtaining DejaGnu</A -></DT -><DT -><A -HREF="installation.html" ->Installation</A -></DT -><DT -><A -HREF="builtins.html" ->Builtin Procedures</A -></DT -><DT -><A -HREF="filemap.html" ->File Map</A -></DT -></DL -></DIV -><DIV CLASS="SECT1" ><H1 CLASS="SECT1" @@ -129,8 +108,8 @@ WIDTH="33%" ALIGN="left" VALIGN="top" ><A -HREF="tvariables.html" ->Prev</A +HREF="djh.html" +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -146,7 +125,7 @@ ALIGN="right" VALIGN="top" ><A HREF="installation.html" ->Next</A +>Next >>></A ></TD ></TR ><TR @@ -154,7 +133,7 @@ HREF="installation.html" WIDTH="33%" ALIGN="left" VALIGN="top" ->Special variables used by test cases.</TD +>The dejagnu.h Header File</TD ><TD WIDTH="34%" ALIGN="center" diff --git a/doc/overview/releng.html b/doc/overview/releng.html index d1e2edd..e8531c4 100644 --- a/doc/overview/releng.html +++ b/doc/overview/releng.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Remote Host Testing</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Config File Values" HREF="configfile.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="boardconfig.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 3. Customizing DejaGnu</TD +>Customizing DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="configfile.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -68,14 +76,30 @@ NAME="RELENG" ></H1 ><DIV CLASS="NOTE" -><BLOCKQUOTE +><P +></P +><TABLE CLASS="NOTE" +WIDTH="100%" +BORDER="0" +><TR +><TD +WIDTH="25" +ALIGN="CENTER" +VALIGN="TOP" +><IMG +SRC="./stylesheet-images/note.gif" +HSPACE="5" +ALT="Note"></TD +><TD +ALIGN="LEFT" +VALIGN="TOP" ><P -><B ->Note: </B >Thanks to Dj Delorie for the original paper that this section is based on.</P -></BLOCKQUOTE +></TD +></TR +></TABLE ></DIV ><P >DejaGnu also supports running the tests on a remote @@ -126,9 +150,12 @@ TARGET="_top" releng's area in SV to your machine:</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN965" +></A ><P ><B ->Example 3-6. Remote host setup</B +>Example 6. Remote host setup</B ></P ><TABLE BORDER="0" @@ -163,9 +190,12 @@ CLASS="FILENAME" boards directory:</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN971" +></A ><P ><B ->Example 3-7. Add The Board Directory</B +>Example 7. Add The Board Directory</B ></P ><TABLE BORDER="0" @@ -189,9 +219,12 @@ CLASS="PROGRAMLISTING" the PC), do something like this:</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN975" +></A ><P ><B ->Example 3-8. Setup Cross Remote Testing</B +>Example 8. Setup Cross Remote Testing</B ></P ><TABLE BORDER="0" @@ -212,9 +245,12 @@ CLASS="PROGRAMLISTING" gcc.exe in your PATH on the PC), do this:</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN979" +></A ><P ><B ->Example 3-9. Setup Native Remote Testing</B +>Example 9. Setup Native Remote Testing</B ></P ><TABLE BORDER="0" @@ -243,9 +279,12 @@ CLASS="COMMAND" the installation you want to test.</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN984" +></A ><P ><B ->Example 3-10. Run Test Remotely</B +>Example 10. Run Test Remotely</B ></P ><TABLE BORDER="0" @@ -268,9 +307,12 @@ CLASS="PROGRAMLISTING" MkTestDir created):</P ><DIV CLASS="EXAMPLE" +><A +NAME="AEN988" +></A ><P ><B ->Example 3-11. Run a Test Remotely</B +>Example 11. Run a Test Remotely</B ></P ><TABLE BORDER="0" @@ -308,7 +350,7 @@ ALIGN="left" VALIGN="top" ><A HREF="boardconfig.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -324,7 +366,7 @@ ALIGN="right" VALIGN="top" ><A HREF="configfile.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/runningtests.html b/doc/overview/runningtests.html index a78cf8c..3bd812f 100644 --- a/doc/overview/runningtests.html +++ b/doc/overview/runningtests.html @@ -1,20 +1,28 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Running Tests</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK REL="PREVIOUS" -TITLE="A POSIX conforming test framework" -HREF="posix.html"><LINK +TITLE="A first remote test" +HREF="x319.html"><LINK REL="NEXT" TITLE="Runtest" HREF="runtest.html"></HEAD ><BODY +CLASS="CHAPTER" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -34,8 +42,8 @@ WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A -HREF="posix.html" ->Prev</A +HREF="x319.html" +><<< Previous</A ></TD ><TD WIDTH="80%" @@ -48,7 +56,7 @@ ALIGN="right" VALIGN="bottom" ><A HREF="runtest.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -60,32 +68,8 @@ CLASS="CHAPTER" ><H1 ><A NAME="RUNNINGTESTS" ->Chapter 2. Running Tests</A +>Running Tests</A ></H1 -><DIV -CLASS="TOC" -><DL -><DT -><B ->Table of Contents</B -></DT -><DT -><A -HREF="runningtests.html#MAKECHECK" ->Make check</A -></DT -><DT -><A -HREF="runtest.html" ->Runtest</A -></DT -><DT -><A -HREF="outputfiles.html" ->The files DejaGnu produces.</A -></DT -></DL -></DIV ><P >There are two ways to execute a test suite. The most common way is when there is existing support in the @@ -107,9 +91,7 @@ CLASS="COMMAND" > directcly from the command line requires either all the correct options, or the <A HREF="customizing.html#LOCAL" -><I ->Local Config File</I -></A +>Local Config File</A > must be setup correctly.</P ><DIV @@ -213,8 +195,8 @@ WIDTH="33%" ALIGN="left" VALIGN="top" ><A -HREF="posix.html" ->Prev</A +HREF="x319.html" +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -230,7 +212,7 @@ ALIGN="right" VALIGN="top" ><A HREF="runtest.html" ->Next</A +>Next >>></A ></TD ></TR ><TR @@ -238,7 +220,7 @@ HREF="runtest.html" WIDTH="33%" ALIGN="left" VALIGN="top" ->A POSIX conforming test framework</TD +>A first remote test</TD ><TD WIDTH="34%" ALIGN="center" diff --git a/doc/overview/runtest.html b/doc/overview/runtest.html index 73fbb57..b3a8a00 100644 --- a/doc/overview/runtest.html +++ b/doc/overview/runtest.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Runtest</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="The files DejaGnu produces." HREF="outputfiles.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="runningtests.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 2. Running Tests</TD +>Running Tests</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="outputfiles.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -107,14 +115,14 @@ CLASS="FILENAME" > flags the outcome of each test as one of these cases. <A HREF="posix.html" -><I ->A POSIX Conforming Test Framework</I -></A +>A POSIX Conforming Test Framework</A > for a discussion of how POSIX specifies the meanings of these cases.</P ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT >PASS</DT @@ -189,10 +197,13 @@ CLASS="EMPHASIS" does not include a required subroutine.</P ></DD ></DL +></DIV ><P >runtest may also display the following messages:</P ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT >ERROR</DT @@ -232,6 +243,7 @@ CLASS="EMPHASIS" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -249,6 +261,8 @@ CLASS="FILENAME" abbreviated to the shortest unique string.</P ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT ><TT @@ -952,6 +966,7 @@ CLASS="FILENAME" ></DD ></DL ></DIV +></DIV ><DIV CLASS="SECT2" ><H2 @@ -1096,7 +1111,7 @@ ALIGN="left" VALIGN="top" ><A HREF="runningtests.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -1112,7 +1127,7 @@ ALIGN="right" VALIGN="top" ><A HREF="outputfiles.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/tvariables.html b/doc/overview/tvariables.html index ee28884..6b19f90 100644 --- a/doc/overview/tvariables.html +++ b/doc/overview/tvariables.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Special variables used by test cases.</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -15,9 +17,15 @@ REL="PREVIOUS" TITLE="Hints On Writing A Test Case" HREF="hints.html"><LINK REL="NEXT" -TITLE="Reference" -HREF="reference.html"></HEAD +TITLE="Unit Testing" +HREF="unit.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="hints.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A -HREF="reference.html" ->Next</A +HREF="unit.html" +>Next >>></A ></TD ></TR ></TABLE @@ -77,6 +85,8 @@ CLASS="FILENAME" but they should never be changed.</P ><P ></P +><DIV +CLASS="VARIABLELIST" ><DL ><DT >$prms_id</DT @@ -142,6 +152,7 @@ CLASS="FUNCTION" ></DD ></DL ></DIV +></DIV ><DIV CLASS="NAVFOOTER" ><HR @@ -158,7 +169,7 @@ ALIGN="left" VALIGN="top" ><A HREF="hints.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -173,8 +184,8 @@ WIDTH="33%" ALIGN="right" VALIGN="top" ><A -HREF="reference.html" ->Next</A +HREF="unit.html" +>Next >>></A ></TD ></TR ><TR @@ -195,7 +206,7 @@ HREF="extending.html" WIDTH="33%" ALIGN="right" VALIGN="top" ->Reference</TD +>Unit Testing</TD ></TR ></TABLE ></DIV diff --git a/doc/overview/unit.html b/doc/overview/unit.html new file mode 100644 index 0000000..55864cd --- /dev/null +++ b/doc/overview/unit.html @@ -0,0 +1,153 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<HTML +><HEAD +><TITLE +>Unit Testing</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK +REL="HOME" +TITLE="DejaGnu" +HREF="book1.html"><LINK +REL="PREVIOUS" +TITLE="Special variables used by test cases." +HREF="tvariables.html"><LINK +REL="NEXT" +TITLE="The dejagnu.h Header File" +HREF="djh.html"></HEAD +><BODY +CLASS="CHAPTER" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>DejaGnu: The GNU Testing Framework</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="tvariables.html" +><<< Previous</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="djh.html" +>Next >>></A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="CHAPTER" +><H1 +><A +NAME="UNIT" +>Unit Testing</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="UNITTEST" +>What Is Unit Testing ?</A +></H1 +><P +>Most regression testing as done by DejaGnu is system + testing. This is the complete application is tested all at + once. Unit testing is for testing single files, or small + libraries. In this case, each file is linked with a test case in + C or C++, and each function or class and method is tested in + series, with the test case having to check private data or + global variables to see if the function or method worked.</P +><P +>This works particularly well for testing APIs and at level + where it is easier to debug them, than by needing to trace through + the entire appication. Also if there is a specification for the + API to be tested, the testcase can also function as a compliance + test.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="tvariables.html" +><<< Previous</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="book1.html" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="djh.html" +>Next >>></A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Special variables used by test cases.</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>The dejagnu.h Header File</TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/doc/overview/unittestapi.html b/doc/overview/unittestapi.html new file mode 100644 index 0000000..f81a32e --- /dev/null +++ b/doc/overview/unittestapi.html @@ -0,0 +1,316 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<HTML +><HEAD +><TITLE +>Unit Testing API</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK +REL="HOME" +TITLE="DejaGnu" +HREF="book1.html"><LINK +REL="PREVIOUS" +TITLE="File Map" +HREF="filemap.html"><LINK +REL="NEXT" +TITLE="C++ Unit Testing API" +HREF="cppunit.html"></HEAD +><BODY +CLASS="CHAPTER" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>DejaGnu: The GNU Testing Framework</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="filemap.html" +><<< Previous</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +></TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="cppunit.html" +>Next >>></A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="CHAPTER" +><H1 +><A +NAME="UNITTESTAPI" +>Unit Testing API</A +></H1 +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="CUNIT" +>C Unit Testing API</A +></H1 +><P +>All of the functions that take a + <TT +CLASS="PARAMETER" +><I +>msg</I +></TT +> parameter use a C char * that is + the message to be dislayed. There currently is no support for + variable length arguments.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="PASSFUNC" +>Pass Function</A +></H2 +><P +>This prints a message for a successful test + completion.</P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5121" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>pass</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +>msg</I +></TT +>);<P +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="FAILFUNC" +>Fail Function</A +></H2 +><P +>This prints a message for an unsuccessful test + completion.</P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5129" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>fail</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +>msg</I +></TT +>);<P +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="UNTESTEDFUNC" +>Untested Function</A +></H2 +><P +>This prints a message for an test case that isn't run + for some technical reason.</P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5137" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>untested</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +>msg</I +></TT +>);<P +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="UNRESOLVEDFUNC" +>Unresolved Function</A +></H2 +><P +>This prints a message for an test case that is run, + but there is no clear result. These output states require a + human to look over the results to determine what happened. + </P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5145" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>unresolved</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +>msg</I +></TT +>);<P +></P +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="TOTALSFUNC" +>Totals Function</A +></H2 +><P +>This prints out the total numbers of all the test + state outputs.</P +><DIV +CLASS="FUNCSYNOPSIS" +><A +NAME="AEN5153" +></A +><P +></P +><CODE +CLASS="FUNCDEF" +><TT +CLASS="FUNCTION" +>totals</TT +></CODE +>(<TT +CLASS="PARAMETER" +><I +></I +></TT +>);<P +></P +></DIV +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="filemap.html" +><<< Previous</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="book1.html" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="cppunit.html" +>Next >>></A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>File Map</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +> </TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>C++ Unit Testing API</TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/doc/overview/writing.html b/doc/overview/writing.html index 17e09ed..30c464a 100644 --- a/doc/overview/writing.html +++ b/doc/overview/writing.html @@ -1,10 +1,12 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> <HTML ><HEAD ><TITLE >Writing A Test Case</TITLE ><META NAME="GENERATOR" -CONTENT="Modular DocBook HTML Stylesheet Version 1.44"><LINK +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK REL="HOME" TITLE="DejaGnu" HREF="book1.html"><LINK @@ -18,6 +20,12 @@ REL="NEXT" TITLE="Debugging A Test Case" HREF="debugging.html"></HEAD ><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE @@ -38,20 +46,20 @@ ALIGN="left" VALIGN="bottom" ><A HREF="boarddefs.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ->Chapter 4. Extending DejaGnu</TD +>Extending DejaGnu</TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="debugging.html" ->Next</A +>Next >>></A ></TD ></TR ></TABLE @@ -156,7 +164,7 @@ ALIGN="left" VALIGN="top" ><A HREF="boarddefs.html" ->Prev</A +><<< Previous</A ></TD ><TD WIDTH="34%" @@ -172,7 +180,7 @@ ALIGN="right" VALIGN="top" ><A HREF="debugging.html" ->Next</A +>Next >>></A ></TD ></TR ><TR diff --git a/doc/overview/x227.html b/doc/overview/x227.html new file mode 100644 index 0000000..014b820 --- /dev/null +++ b/doc/overview/x227.html @@ -0,0 +1,456 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<HTML +><HEAD +><TITLE +>Create a minimal project, e.g. calc</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK +REL="HOME" +TITLE="DejaGnu" +HREF="book1.html"><LINK +REL="UP" +TITLE="Getting DejaGnu up and running" +HREF="gettingup.html"><LINK +REL="PREVIOUS" +TITLE="Getting DejaGnu up and running" +HREF="gettingup.html"><LINK +REL="NEXT" +TITLE="Our first automated tests" +HREF="x276.html"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>DejaGnu: The GNU Testing Framework</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="gettingup.html" +><<< Previous</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +>Getting DejaGnu up and running</TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="x276.html" +>Next >>></A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN227" +>Create a minimal project, e.g. calc</A +></H1 +><P +>In this section you will to start a small project, +using the sample application calc, which is part of your DejaGnu distribution</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN230" +>A simple project without the GNU autotools</A +></H2 +><P +>The runtest program can be run standalone. All the autoconf/automake support is just cause those programs are commonly used for other GNU applications. The key to running runtest standalone is having the local site.exp file setup correctly, which automake does.</P +><P +>The generated site.exp should like like:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>set tool calc +set srcdir . +set objdir /home/dgt/dejagnu.test</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN235" +>Using autoconf/autoheader/automake</A +></H2 +><P +>We have to prepare some input file in order to run autocon and automake. There is book “GNU autoconf, automake and libtool” by Garry V. Vaughan, et al. NewRider, ISBN 1-57870-190-2 which describes this process thoroughly.</P +><P +>From the calc example distributed with the DejaGnu documentation you should copy the program file itself (calc.c) and some additional files, which you might examine a little bit close to derive their meanings.</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ cp -r /usr/share/doc/dejagnu/examples/calc/\ +{configure.in,Makefile.am,calc.c,testsuite} .</PRE +></TD +></TR +></TABLE +><P +>In Makemake.am note the presence of the AUTOMAKE_OPTIONS = dejagnu. This option is needed.</P +><P +>Run aclocal to generate aclocal.m4, which is a collection of macros needed by configure.in</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ aclocal</PRE +></TD +></TR +></TABLE +><P +>autoconf is another part of the auto-tools. +Run it to generate configure based on information contained in configure.in.</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ autoconf</PRE +></TD +></TR +></TABLE +><P +>autoheader is another part of the auto-tools. +Run it to generate calc.h.in. </P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ autoheader</PRE +></TD +></TR +></TABLE +><P +>The Makefile.am of this example was developed as port of the DejaGnu +distribution. +Adapt Makefile.am for this test. Replace the line +“#noinst_PROGRAMS = calc” to +“bin_PROGRAMS = calc”. +Change the RUNTESTDEFAULTFLAGS from +“$$srcdir/testsuite” to +“./testsuite”.</P +><P +>Running automake at this point contains a series of warning in its output as shown in the following example:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN249" +></A +><P +><B +>Example 2. Sample output of automake with missing files</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ automake --add-missing +automake: configure.in: installing `./install-sh' +automake: configure.in: installing `./mkinstalldirs' +automake: configure.in: installing `./missing' +automake: Makefile.am: installing `./INSTALL' +automake: Makefile.am: required file `./NEWS' not found +automake: Makefile.am: required file `./README' not found +automake: Makefile.am: installing `./COPYING' +automake: Makefile.am: required file `./AUTHORS' not found +automake: Makefile.am: required file `./ChangeLog' not found +configure.in: 4: required file `./calc.h.in' not found +Makefile.am:6: required directory ./doc does not exist</PRE +></TD +></TR +></TABLE +></DIV +><P +>Create a empty directory doc and empty files +INSTALL, NEWS, README, AUTHORS, ChangeLog and COPYING. +The default COPYING will point to the GNU Public License (GPL). +In a real project it would be time to add some meaningfull text in each file.</P +><P +>Adapt calc to your environment by calling configure.</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN254" +></A +><P +><B +>Example 3. Sample output of configure</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ ./configure +creating cache ./config.cache +checking whether to enable maintainer-specific portions of Makefiles... no +checking for a BSD compatible install... /usr/bin/install -c +checking whether build environment is sane... yes +checking whether make sets ${MAKE}... yes +checking for working aclocal... found +checking for working autoconf... found +checking for working automake... found +checking for working autoheader... found +checking for working makeinfo... found +checking for gcc... gcc checking whether the C compiler (gcc ) works... yes +checking whether the C compiler (gcc ) is a cross-compiler... no +checking whether we are using GNU C... yes +checking whether gcc accepts -g... yes +checking for a BSD compatible install... /usr/bin/install -c +checking how to run the C preprocessor... gcc -E +checking for stdlib.h... yes +checking for strcmp... yes +updating cache ./config.cache +creating ./config.status +creating Makefile creating calc.h</PRE +></TD +></TR +></TABLE +></DIV +><P +>If you are familiar with GNU software, +this output should not contain any surprise to you. +Any errors should be easy to fix for such a simple program.</P +><P +>Build the calc executable:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN259" +></A +><P +><B +>Example 4. Sample output building calc</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ make +gcc -DHAVE_CONFIG_H -I. -I. -I. -g -O2 -c calc.c +gcc -g -O2 -o calc calc.o</PRE +></TD +></TR +></TABLE +></DIV +><P +>You prepared a few files and then called some commands. +Respecting the right order assures a automatic and correctly compiled calc program. The following example resumes the correct order.</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN263" +></A +><P +><B +>Example 5. Creating the calc program using the GNU autotools</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ aclocal +dgt:~/dejagnu.test$ autoconf +dgt:~/dejagnu.test$ autoheader +dgt:~/dejagnu.test$ automake --add-missing +dgt:~/dejagnu.test$ ./configure +dgt:~/dejagnu.test$ make </PRE +></TD +></TR +></TABLE +></DIV +><P +>Play with calc and verify whether it works correctly. +A sample session might look like this:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ ./calc +calc: version +Version: 1.1 +calc:<I +CLASS="EMPHASIS" +> </I +>add 3 4 +7 +calc: multiply 3 4<I +CLASS="EMPHASIS" +> </I +> +12 +calc: multiply 2 4<I +CLASS="EMPHASIS" +> </I +> +12 +calc: quit </PRE +></TD +></TR +></TABLE +><P +>Look at the intentional bug that 2 times 4 equals 12.</P +><P +>The tests run by DejaGnu need a file called site.exp, +which is automatically generated if we call “make site.exp”. +This was the purpose of the “AUTOMAKE_OPTIONS = dejagnu” in Makefile.am.</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN273" +></A +><P +><B +>Example 6. Sample output generating a site.exp</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt: make site.exp +dgt:~/dejagnu.test$ make site.exp +Making a new site.exp file...</PRE +></TD +></TR +></TABLE +></DIV +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="gettingup.html" +><<< Previous</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="book1.html" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="x276.html" +>Next >>></A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Getting DejaGnu up and running</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="gettingup.html" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Our first automated tests</TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/doc/overview/x276.html b/doc/overview/x276.html new file mode 100644 index 0000000..ca3a1d3 --- /dev/null +++ b/doc/overview/x276.html @@ -0,0 +1,440 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<HTML +><HEAD +><TITLE +>Our first automated tests</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK +REL="HOME" +TITLE="DejaGnu" +HREF="book1.html"><LINK +REL="UP" +TITLE="Getting DejaGnu up and running" +HREF="gettingup.html"><LINK +REL="PREVIOUS" +TITLE="Create a minimal project, e.g. calc" +HREF="x227.html"><LINK +REL="NEXT" +TITLE="A first remote test" +HREF="x319.html"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>DejaGnu: The GNU Testing Framework</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="x227.html" +><<< Previous</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +>Getting DejaGnu up and running</TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="x319.html" +>Next >>></A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN276" +>Our first automated tests</A +></H1 +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN278" +>Running the test for the calc example</A +></H2 +><P +>Now we are ready to call the automated tests </P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN281" +></A +><P +><B +>Example 7. Sample output of runtest in a configured directory</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ make check +make check-DEJAGNU +make[1]: Entering directory `/home/dgt/dejagnu.test' srcdir=`cd . && pwd`; export srcdir; \ +EXPECT=expect; export EXPECT; \ runtest=runtest; \ +if /bin/sh -c "$runtest --version" > /dev/null 2>&1; then \ +$runtest --tool calc CALC=`pwd`/calc --srcdir ./testsuite ; \ +else echo "WARNING: could not find \`runtest'" 1>&2; :;\ +fi +WARNING: Couldn't find the global config file. +WARNING: Couldn't find tool init file +Test Run By dgt on Sun Nov 25 21:42:21 2001 +Native configuration is i586-pc-linux-gnu + + === calc tests === + +Schedule of variations: + unix + +Running target unix +Using /usr/share/dejagnu/baseboards/unix.exp as board description file for target. +Using /usr/share/dejagnu/config/unix.exp as generic interface file for target. +Using ./testsuite/config/unix.exp as tool-and-target-specific interface file. +Running ./testsuite/calc.test/calc.exp ... +FAIL: multiply2 (bad match) + +=== calc Summary === + +# of expected passes 5 +# of unexpected failures 1 +/home/Dgt/dejagnu.test/calc version Version: 1.1 +make[1]: *** [check-DEJAGNU] Fehler 1 +make[1]: Leaving directory `/home/Dgt/dejagnu.test' make: *** [check-am] Fehler 2</PRE +></TD +></TR +></TABLE +></DIV +><P +>Did you see the line “FAIL:“? The test cases for calc catch the bug in the calc.c file. Fix the error in calc.c later as the following examples assume a unchanged calc.c.</P +><P +>Examine the output files calc.sum and calc.log. +Try to understand the testcases written in ~/dejagnu.test/testsuite/calc.test/calc.exp. +To understand Expect you might take a look at the book "Exploring Expect", +which is an excellent resource for learning and using Expect. (Pub: O'Reilly, ISBN 1-56592-090-2) +The book contains hundreds of examples and also includes a tutorial on Tcl. +Exploring Expect is 602 pages long. </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN286" +>The various config files or how to avoid warnings</A +></H2 +><P +>DejaGnu may be customized by each user. It first searches for a file called ~/.dejagnurc. Create the file ~/.dejagnurc and insert the following line:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>puts "I am ~/.dejagnurc"</PRE +></TD +></TR +></TABLE +><P +>Rerun make check. Test whether the output contains "I am ~/.dejagnurc". +Create ~/my_dejagnu.exp and insert the following line:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>puts "I am ~/my_dejagnu.exp"</PRE +></TD +></TR +></TABLE +><P +>In a Bash-Shell enter</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ export DEJAGNU=~/my_dejagnu.exp</PRE +></TD +></TR +></TABLE +><P +>Run “make check” again. The output should not contain +“WARNING: Couldn't find the global config file.”. +Create the sub-directory lib. Create the file “calc.exp” in it and insert the following line:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>puts "I am lib/calc.exp"</PRE +></TD +></TR +></TABLE +><P +>The last warning “WARNING: Couldn't find tool init file” +should not be part of the output of make check. +Create the directory ˜/boards. Create the file ˜/boards/standard.exp and insert the following line:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>puts "I am boards/standard.exp"</PRE +></TD +></TR +></TABLE +><P +>If the variable DEJAGNU is still not empty then the (abbreviated) output of “make check” should look like this:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN299" +></A +><P +><B +>Example 8. Sample output of runtest with the usual configuration files</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ make check +<...> +fi +I am ~/.dejagnurc +I am ~/my_dejagnu.exp +I am lib/calc.exp +Test Run By dgt on Sun Nov 25 22:19:14 2001 +Native configuration is i586-pc-linux-gnu + + === calc tests === +Using /home/Dgt/boards/standard.exp as standard board description\ +file for build. +I am ~/boards/standard.exp +Using /home/Dgt/boards/standard.exp as standard board description\ + file for host. +I am ~/boards/standard.exp + +Schedule of variations: + unix + +Running target unix +Using /home/Dgt/boards/standard.exp as standard board description\ + file for target. +I am ~/boards/standard.exp +Using /usr/share/dejagnu/baseboards/unix.exp as board description file\ +for target. +<...></PRE +></TD +></TR +></TABLE +></DIV +><P +>It is up to you to decide when and where to use any of the above +mentioned config files for customizing. +This chapters showed you where and in which order the different config +files are run.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN303" +>When trouble strikes</A +></H2 +><P +>Calling runtest with the '-v'-flag shows you in even more details which files are searched in which order. Passing it several times gives more and more details. </P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN306" +></A +><P +><B +>Example 9. Displaying details about runtest execution</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>runtest -v -v -v --tool calc CALC=`pwd`/calc --srcdir ./testsuite</PRE +></TD +></TR +></TABLE +></DIV +><P +>Calling runtest with the '--debug'-flag logs a lot of details to dbg.log where you can analyse it afterwards. </P +><P +>In all test cases you can temporary adjust the verbosity of information by adding the following Tcl-command:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>set verbose 9</PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN312" +>Testing “Hello world” locally</A +></H2 +><P +>This test checks, whether the built-in shell command “echo Hello world” + will really write “Hello world” on the console. +Create the file ~/dejagnu.test/testsuite/calc.test/local_echo.exp. +It should contain the following lines</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN315" +></A +><P +><B +>Example 10. A first (local) test case</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>set test "Local Hello World" +send "echo Hello World" +expect { + -re "Hello World" { pass "$test" } +}</PRE +></TD +></TR +></TABLE +></DIV +><P +>Run runtest again and verify the output “calc.log”</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="x227.html" +><<< Previous</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="book1.html" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="x319.html" +>Next >>></A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Create a minimal project, e.g. calc</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="gettingup.html" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>A first remote test</TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file diff --git a/doc/overview/x319.html b/doc/overview/x319.html new file mode 100644 index 0000000..9958b9a --- /dev/null +++ b/doc/overview/x319.html @@ -0,0 +1,632 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"> +<HTML +><HEAD +><TITLE +>A first remote test</TITLE +><META +NAME="GENERATOR" +CONTENT="Modular DocBook HTML Stylesheet Version 1.64 +"><LINK +REL="HOME" +TITLE="DejaGnu" +HREF="book1.html"><LINK +REL="UP" +TITLE="Getting DejaGnu up and running" +HREF="gettingup.html"><LINK +REL="PREVIOUS" +TITLE="Our first automated tests" +HREF="x276.html"><LINK +REL="NEXT" +TITLE="Running Tests" +HREF="runningtests.html"></HEAD +><BODY +CLASS="SECT1" +BGCOLOR="#FFFFFF" +TEXT="#000000" +LINK="#0000FF" +VLINK="#840084" +ALINK="#0000FF" +><DIV +CLASS="NAVHEADER" +><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TH +COLSPAN="3" +ALIGN="center" +>DejaGnu: The GNU Testing Framework</TH +></TR +><TR +><TD +WIDTH="10%" +ALIGN="left" +VALIGN="bottom" +><A +HREF="x276.html" +><<< Previous</A +></TD +><TD +WIDTH="80%" +ALIGN="center" +VALIGN="bottom" +>Getting DejaGnu up and running</TD +><TD +WIDTH="10%" +ALIGN="right" +VALIGN="bottom" +><A +HREF="runningtests.html" +>Next >>></A +></TD +></TR +></TABLE +><HR +ALIGN="LEFT" +WIDTH="100%"></DIV +><DIV +CLASS="SECT1" +><H1 +CLASS="SECT1" +><A +NAME="AEN319" +>A first remote test</A +></H1 +><P +>Testing remote targets is a lot trickier especially if you are using an + embedded target +which has no built in support for things like a compiler, ftp server or a Bash-shell. +Before you can test calc on a remote target you have to acquire a few basics skills.</P +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN322" +>Setup telnet to your own host</A +></H2 +><P +>The easiest remote host is usually the host you are working on. +In this example we will use telnet to login in your own workstation. +For security reason you should never have a telnet deamon running on +machine connected on the internet, as password and usernames are transmitted + in clear text. +We assume you know how to setup your machine for a telnet daemon.</P +><P +>Next try whether you may login in your own host by issuing the +command “telnet localhost.1”. In order to be able to +distinguish between a normal session an a telnet login add the following lines to /home/dgt/.bashrc.</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>if [ "$REMOTEHOST" ] +then + PS1='remote:\w\$ ' +fi</PRE +></TD +></TR +></TABLE +><P +>Now on the machine a “remote” login looks like this:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN328" +></A +><P +><B +>Example 11. Sample log of a telnet login to localhost</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>dgt:~/dejagnu.test$ telnet localhost +Trying 127.0.0.1... +Connected to 127.0.0.1. +Escape character is '^]'. +Debian GNU/Linux testing/unstable Linux +K6Linux login: dgt +Password: +Last login: Sun Nov 25 22:46:34 2001 from localhost on pts/4 +Linux K6Linux 2.4.14 #1 Fre Nov 16 19:28:25 CET 2001 i586 unknown +No mail. +remote:~$ exit +logout +Connection closed by foreign host.</PRE +></TD +></TR +></TABLE +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN331" +>A test case for login via telnet</A +></H2 +><P +>In order to define a correct setup we have add a line containing +“set target unix” either to ~/.dejagnurc or to ~/my_dejagnu.exp. +In ~/boards/standard.exp add the following four lines to define a few patterns for the DejaGnu telnet login procedure.</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN334" +></A +><P +><B +>Example 12. Defining a remote target board</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>set_board_info shell_prompt "remote:" +set_board_info telnet_username "dgt" +set_board_info telnet_password "top_secret" +set_board_info hostname "localhost" </PRE +></TD +></TR +></TABLE +></DIV +><P +>As DejaGnu will be parsing the telnet session output for some well +known pattern the output there are a lot of things that can go wrong. +If you have any problems verify your setup:</P +><P +></P +><UL +><LI +><P +>Is <TT +CLASS="FILENAME" +>/etc/motd</TT +> empty?</P +></LI +><LI +><P +>Is <TT +CLASS="FILENAME" +>/etc/issue.net</TT +> empty?</P +></LI +><LI +><P +>Exists a empty <TT +CLASS="FILENAME" +>~/.hushlogin</TT +>?</P +></LI +><LI +><P +>The LANG environment variable must be either empty or set to “C”. </P +></LI +></UL +><P +>To test the login via telnet write a sample test case. +Create the file ~/dejagnu.test/testsuite/calc.test/remote_echo.exp and +add the following few lines:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN351" +></A +><P +><B +>Example 13. DejaGnu script for logging in into a remote target</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>puts "this is remote_echo.exp target for $target " +target_info $target +#set verbose 9 +set shell_id [remote_open $target] +set test "Remote login to $target" +#set verbose 0 +puts "Spawn id for remote shell is $shell_id" +if { $shell_id > 0 } { + pass "$test" +} else { + fail "Remote open to $target" +}</PRE +></TD +></TR +></TABLE +></DIV +><P +>In the runtest output you should find something like:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>Running ./testsuite/calc.test/local_echo.exp ... +Running ./testsuite/calc.test/remote_echoo.exp ... +this is remote_echo.exp target is unix +Spawn id for remote shell is exp7</PRE +></TD +></TR +></TABLE +><P +>Have again a look at calc.log to get a feeling how DejaGnu and expect +parse the input. </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN357" +>Remote testing “Hello world”</A +></H2 +><P +>Next you will transform the above “hello world” example to +its remote equivalent. +This can be done by adding the following lines to our file remote_echo.exp.</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN360" +></A +><P +><B +>Example 14. A first (local) remote "Hello world" test</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>set test "Remote_send Hello World" +set status [remote_send $target "echo \"Hello World\"\n" ] +pass "$test" +set test "Remote_expect Hello World" +remote_expect $target 5 { + -re "Hello World" { pass "$test" } +}</PRE +></TD +></TR +></TABLE +></DIV +><P +>Call make check. The output should contain +“# of expected passes 9” and “# of unexcpected failures 1”.</P +><P +>Have a look at the procedures in /usr/share/dejagnu/remote.exp to have an overview of the offered procedures and their features. </P +><P +>Now setup a real target. +In the following example we assume as target a PowerBook running Debian. +As above add a test user "dgt", install telnet and FTP servers. +In order to distinguish it from the host add the line +<TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>PS1='test:>'</PRE +></TD +></TR +></TABLE +> to /home/dgt/.bash_profile. +Also add a corresponding entry "powerbook" to /etc/hosts and verify that you +are able to ping, telnet and ftp to the target "powerbook".</P +><P +>In order to let runtest run its test on the "powerbook" target change the following lines in ~/boards/standard.exp:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN368" +></A +><P +><B +>Example 15. Board definition for a remote target</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>set_board_info protocol "telnet" +set_board_info telnet_username "dgt" +set_board_info telnet_password "top_secret" +set_board_info shell_prompt "test:> " +set_board_info hostname "powerbook"</PRE +></TD +></TR +></TABLE +></DIV +><P +>Now call runtest again with the same arguments and verify whether all went okay by taking a close look at calc.log.</P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN372" +>Transferring files from/to the target</A +></H2 +><P +>A simple procedure like this will do the job for you:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN375" +></A +><P +><B +>Example 16. Test script to transfer a file to a remote target</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>set test "Remote_download" +puts "Running Remote_download" +# set verbose 9 +set remfile /home/dgt/dejagnu2 + +set status [remote_download $target /home/dgt/.dejagnurc $remfile] +if { "$status" == "" } { + fail "Remote download to $remfile on $target" +} else { + pass "$test" +} + +puts "status of remote_download ist $status" +# set verbose 0</PRE +></TD +></TR +></TABLE +></DIV +><P +>After running runtest again, check whether the file dejagnu2 exists on the target. + +This example will only work if the rcp command works with your target. + +If you have a working FTP-server on the target you can use it by adding the +following lines to ~/boards/standard.exp:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN379" +></A +><P +><B +>Example 17. Defining a board to use FTP as file transport</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>set_board_info file_transfer "ftp" +set_board_info ftp_username "dgt" +set_board_info ftp_password "1234"</PRE +></TD +></TR +></TABLE +></DIV +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN382" +>Preparing for crosscompilation</A +></H2 +><P +>For crosscompiling you need working binutils, gcc and a base library like +libc or glib for your target. +It is beyond the scope of this document to describe how to get it working. +The following examples assume a cross compiler for PowerPC which is called linux-powerpc-gcc.</P +><P +>Add AC_CANONICAL_TARGET in dejagnu.test/configure.in at the following location. Copy config.guess from /usr/share/automake to dejagnu.test.</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>AM_CONFIG_HEADER(calc.h) +AC_CANONICAL_TARGET([]) +AM_INIT_AUTOMAKE(calc, 1.1)</PRE +></TD +></TR +></TABLE +><P +>You need to run automake 2.5 or later. +Depending on your installation calling autoconf2.5 instead of autoconf is not needed. +The sequence to regenerate all files is:</P +><DIV +CLASS="EXAMPLE" +><A +NAME="AEN388" +></A +><P +><B +>Example 18. Using autotools for cross development</B +></P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>$ autoconf2.5 +$ autoheader +$ automake +$ ./configure --host=powerpc-linux --target=powerpc-linux +configure: WARNING: If you wanted to set the --build type, don't use --host. + If a cross compiler is detected then cross compile mode will be used. +checking build system type... ./config.guess: ./config.guess: No such file or directory +configure: error: cannot guess build type; you must specify one +$ cp /usr/share/automake/config.guess . +$ ./configure --host=powerpc-linux --target=powerpc-linux +configure: WARNING: If you wanted to set the --build type, don't use --host. +If a cross compiler is detected then cross compile mode will be used. \ +checking build system type... i586-pc-linux-gnu +checking host system type... powerpc-unknown-linux-gnu +<...> +checking whether we are cross compiling... yes +<...> +Configuration: +Source code location: . +C Compiler: powerpc-linux-gcc +C Compiler flags: -g -O2 </PRE +></TD +></TR +></TABLE +></DIV +><P +>Everything should be ready to recompile for the target:</P +><TABLE +BORDER="0" +BGCOLOR="#E0E0E0" +WIDTH="100%" +><TR +><TD +><PRE +CLASS="PROGRAMLISTING" +>$ make +powerpc-linux-gcc -DHAVE_CONFIG_H -I. -I. -I. -g -O2 -c calc.c +powerpc-linux-gcc -g -O2 -o calc calc.o </PRE +></TD +></TR +></TABLE +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN393" +>Remote testing of calc</A +></H2 +><P +>Not yet written, as I have problem getting libc6-dev-powerpc to work. Probably I first have to build my cross compiler. </P +></DIV +><DIV +CLASS="SECT2" +><H2 +CLASS="SECT2" +><A +NAME="AEN396" +>Using WindowsNT as host and vxWorks as target</A +></H2 +><P +>A more thorough walk-through will be written in a few weeks.</P +><P +>In order to test the vxWorks as a target I changed boards/standards.exp to reflect my settings (IP, username, password). Then I reconfigured vxWorks to include a FTP and telnet server (using the same username/password combination ad in boards/standard.exp).</P +><P +>With this setup and some minor modification (e.g. replacing echo by printf) in my test cases I could test my vxWorks system. It sure does not seem to be a correct setup by DejaGnu standard. For instance, it still loading /usr/share/dejagnu/baseboards/unix.exp instead of vxWorks. In any case I found that (at least under WindowsNT) I did not find out how the command line would let me override settings in my personal config files.</P +></DIV +></DIV +><DIV +CLASS="NAVFOOTER" +><HR +ALIGN="LEFT" +WIDTH="100%"><TABLE +WIDTH="100%" +BORDER="0" +CELLPADDING="0" +CELLSPACING="0" +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +><A +HREF="x276.html" +><<< Previous</A +></TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="book1.html" +>Home</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +><A +HREF="runningtests.html" +>Next >>></A +></TD +></TR +><TR +><TD +WIDTH="33%" +ALIGN="left" +VALIGN="top" +>Our first automated tests</TD +><TD +WIDTH="34%" +ALIGN="center" +VALIGN="top" +><A +HREF="gettingup.html" +>Up</A +></TD +><TD +WIDTH="33%" +ALIGN="right" +VALIGN="top" +>Running Tests</TD +></TR +></TABLE +></DIV +></BODY +></HTML +>
\ No newline at end of file |