The DejaGnu Testing Framework

for DejaGnu Version 1.1

Nov 1993

• What is DejaGnu?
  • Running existing tests
  • What does a DejaGnu test look like?
  • Design goals
  • A POSIX conforming test framework
  • Future directions
  • Tcl and Expect
• Using runtest
• Setting runtest defaults
  • Configuration dependent values
  • Defaults for runtest options
• The DejaGnu Implementation
  • Conventions for using tool names
  • Initialization module
  • DejaGnu procedures
  • Library procedures
  • Target dependent procedures
  • Remote targets supported
  • The files DejaGnu reads
  • The files DejaGnu writes
    • Summary log
    • Detailed log
    • Logging expect internal actions
• How To Write a Test Case
  • Writing a test case
  • Debugging a test case
  • Adding a test case to a test suite
  • Hints on writing a test case
  • Special variables used by test cases
• New Tools, Targets, or Hosts
  • Writing tests for a new tool
  • Adding a target
  • Porting to a new host
• Expect: Programmed Dialogue
  • Introduction
  • Usage
  • Commands
  • Pretty-Printing
  • Examples
  • Caveats
  • Bugs
  • Expect Hints
  • Expect Bibliography
  • Acknowledgements
• Tcl Overview
  • Summary of Tcl language syntax
  • Writing expressions in Tcl
    • Operands in Tcl expressions
    • Operators in Tcl expressions
    • Mathematical functions in Tcl
    • Types, overflow, and precision in Tcl
    • String operations in Tcl
  • Commands built into Tcl
    • Append to variable: append
    • Manipulate array variables: array
    • Abort looping: break
    • Obsolescent command: case
    • Trap exceptions: catch
    • Change working directory: cd
    • Close an open file: close
    • Join lists together: concat
    • Skip to the next iteration: continue
    • Check for end-of-file: eof
    • Generate an error message: error
    • Evaluate a Tcl script: eval
    • Invoke subprocesses: exec
    • End the application: exit
    • Evaluate an expression: expr
    • File names and attributes: file
    • Flush buffered output for a file: flush
    • "For" loop: for
    • Iterate over all elements in a list: foreach
    • Format in the style of sprintf: format
    • Read a line from a file: gets
    • Filename wildcard expansion: glob
    • Access global variables: global
    • Manipulate the history list: history
      • History operations
      • History revision
    • Execute scripts conditionally: if
    • Increment the value of a variable: incr
    • Report on state of Tcl interpreter: info
    • Join together list elements: join
    • Append list elements: lappend
    • Retrieve an element from a list: lindex
    • Insert elements into a list: linsert
    • Create a list: list
    • Number of elements in a list: llength
    • Adjacent elements from a list: lrange
    • Replace elements in a list: lreplace
    • Search for element in list: lsearch
    • Sort the elements of a list: lsort
    • Open a file: open
    • Retrieve process ids: pid
    • Create a Tcl procedure: proc
    • Write to a file: puts
    • Current working directory: pwd
    • Read from a file: read
    • Match a regular expression: regexp
      • Regular expressions
      • Choosing among matches
    • Regular expression substitutions: regsub
    • Rename or delete a command: rename
    • Return from a procedure: return
    • Parse string like sscanf: scan
    • Access position for an open file: seek
    • Read and write variables: set
    • Evaluate a file as a Tcl script: source
    • Split a string into a Tcl list: split
    • Manipulate strings: string
    • Choose a case to execute: switch
    • Access position for an open file: tell
    • Measure elapsed time: time
    • Monitor variable use: trace
    • Handle non-existent commands: unknown
    • Delete variables: unset
    • Execute in another stack frame: uplevel
    • Link to different stack frame: upvar
    • Execute script repeatedly: while
  • Variables built into Tcl
  • Tcl standard library
    • Procedures
    • Variables
• Installing DejaGnu
  • Configuring the DejaGnu test driver
  • Installing DejaGnu
• Index

This document was generated on 8 March 1996 using the texi2html translator version 1.45.