dejagnu/doc/overview.rtf

10 …qj \b0\fs20\lang1033\f1 This document describes the functionality of DejaGnu, the testing framewor…
11 …qj \fs20\lang1033\f1 Now you are ready to test DejaGnu's main program called runtest. The expectet…
20 …qj \fs20\lang1033\f1 We will show you later how to get rid of all the WARNING- and ERROR-messages.…
22 …qj \b0\fs20\lang1033\f1 We have to prepare some input file in order to run autocon and automake. T…
23 …qj \fs20\lang1033\f1 In Makemake.am note the presence of the AUTOMAKE_OPTIONS = dejagnu. This opti…
34 …qj \fs20\lang1033\f1 Create a empty directory doc and empty files INSTALL, NEWS, README, AUTHORS, …
55 …qj \fs20\lang1033\f1 If you are familiar with GNU software, this output should not contain any sur…
57 …qj \fs20\lang1033\f1 You prepared a few files and then called some commands. Respecting the right …
63 …qj \fs20\lang1033\f1 Play with calc and verify whether it works correctly. A sample session might …
73 …qj \fs20\lang1033\f1 Look at the intentional bug that 2 times 4 equals 12.\hyphpar0\par\pard\sb100…
75 …qj \b0\fs20\lang1033\f1 Now we are ready to call the automated tests \hyphpar0\par\pard\sb200\li96…
106 …qj \fs20\lang1033\f1 Did you see the line \'93FAIL:\'93? The test cases for calc catch the bug in …
132 …qj \fs20\lang1033\f1 It is up to you to decide when and where to use any of the above mentioned co…
136 …qj \fs20\lang1033\f1 Run runtest again and verify the output \'93calc.log\'94\hyphpar0\par\pard\sb…
139 …qj \fs20\lang1033\f1 Now on the machine a \'93remote\'94 login looks like this:\hyphpar0\par\pard\…
151 …qj \b0\fs20\lang1033\f1 In order to define a correct setup we have add a line containing \'93set t…
155 …qj \fs20\lang1033\f1 As DejaGnu will be parsing the telnet session output for some well known patt…
166 …d\sb200\li960\sl220\qj \fs20\lang1033\f1 In the runtest output you should find something like:\hyp…
169 …qj \fs20\lang1033\f1 Have again a look at calc.log to get a feeling how DejaGnu and expect parse t…
175 …qj \fs20\lang1033\f1 Call make check. The output should contain \'93# of expected passes 9\'94 and…
179 …qj \fs20\lang1033\f1 Now call runtest again with the same arguments and verify whether all went ok…
192 …qj \fs20\lang1033\f1 After running runtest again, check whether the file dejagnu2 exists on the ta…
194 …qj \b0\fs20\lang1033\f1 For crosscompiling you need working binutils, gcc and a base library like …
196 …qj \fs20\lang1033\f1 You need to run automake 2.5 or later. Depending on your installation calling…
217 …\sb200\li960\sl220\qj \fs20\lang1033\f1 Everything should be ready to recompile for the target:\hy…
220 …qj \b0\fs20\lang1033\f1 Not yet written, as I have problem getting libc6-dev-powerpc to work. Prob…
221 …qj \fs20\lang1033\f1 If the \i check\i0  target exists, it usually saves you some trouble. For ins…
223 …r0\par\pard\sb200\li960\sl220\qj \fs20\lang1033\f1 Test output follows, ending with:\hyphpar0\par\…
228 …qj \fs20\lang1033\f1 You can use the option \i --srcdir\i0  to point to some other directory conta…
229 …qj \fs20\lang1033\f1 By default, \b runtest\b0  prints only the names of the tests it runs, output…
246 …qj \b0\fs20\lang1033\f1 DejaGnu also saves a detailed log file \fs18\f3 tool.log\fs20\f1 , showing…
278 …qj \b0\fs20\lang1033\f1 With the \fs18\f3 --debug\fs20\f1  option, you can request a log file show…
282 …qj \fs20\lang1033\f1 For every unsuccessful match, Expect issues a \i no\i0  after this message; i…
307 …qj \fs20\lang1033\f1 This example exhibits three properties of Expect and DejaGnu that might be su…
310 …qj \fs20\lang1033\f1 In the second section, you can override any default values (locally to DejaGn…
311 …qj \fs20\lang1033\f1 You can make any changes under this line. If you wish to redefine a variable …
326 …qj \fs20\lang1033\f1 This file defines the required fields for a local config file, namely the thr…
353 …qj \fs20\lang1033\f1 In this case, we have support for several cross compilers, that all run on th…
384 …qj \fs20\lang1033\f1 There are five helper procedures used in this example. The first one, \fs18\f…
391 …qj \fs20\lang1033\f1 You must edit the boards/foobar.exp file to reflect your machine; change the …
392 …qj \fs20\lang1033\f1 Now run MkTestDir, which is in the contrib directory. The first parameter is …
393 …qj \fs20\lang1033\f1 If you are testing a native PC compiler (ex: you have gcc.exe in your PATH on…
394 …qj \fs20\lang1033\f1 To test the setup, \b ftp\b0  to your PC using the username (iusr_foobar) and…
396 …qj \fs20\lang1033\f1 To run a specific test, use a command like this (for this example, you'd run …
397 …qj \fs20\lang1033\f1 Note: if you are testing a cross-compiler, put in the correct target board. Y…
400 …qj \fs20\lang1033\f1 Here I set all_flag so I see all the test cases that PASS along with the ones…
449 …qj \tx1160 \fs16\f1 \'95\tab \fs20 Create a directory (in \fs18\f3 testsuite\fs20\f1 ) called \fs1…
453 …qj \fs20\lang1033\f1 If the program being tested is interactive, however, you might as well define…
468 …qj \tx1160 \fs16\f1 \'95\tab \fs20 Create a directory whose name begins with your tool's name, to …
471 …qj \tx1160 \fs16\f1 \'95\tab \fs20 Back in the \fs18\f3 testsuite\fs20\f1  (top level) directory, …
480 …qj \fs20\lang1033\f1 There is no output in the summary, because so far the example does not call a…
481 …qj \fs20\lang1033\f1 Here's an example of a board config file. There are several \i helper procedu…
513 …qj \b0\fs20\lang1033\f1 These fields are all in the board_info These are all set by using the \fs1…
514 …qj \fs20\f1 .\hyphpar0\par\pard\sb100\li960\sl220\qj To add a test to GDB, first add any source co…
515 …qj \fs20\f1 If you have trouble understanding why a pattern does not match the program output, try…
516 …qj \fs20\lang1033\f1 DejaGnu doesn't care at config time if it's for testing a native system or a …
517 …qj \i\fs20\lang1033\f1 make install\i0 does thes things for DejaGnu:\hyphpar0\par\pard\sb100\li116…
518 …qj \fs20\f1  (descriptions below). This is the checked at pass/fail decision time, so there is no …
524 …qj \fs20\lang1033\f1 What this does is it matches only for these two targets if "-Wall -v" or "-O3…