NAME

CTest - Perl extension for testing local 'C' routines

SYNOPSIS

            

              
              
use CTest;
            
          

DESCRIPTION

This module consists of various test routines to exercise the subroutines in the the 'C' pieces for bdbaccess

• $rv=t_main(qw(program_name args, arg2,..., argN);

  
              
  
                
                
  input:  program name
  -d
  -f etc... see readme
  output: number of arguments passed
              
            

• t_setport(pnum);

  
              
  
                
                
  set the port value to pnum
  input:  integer port number
  output: none
              
            

• t_setsig();

  
              
  
                
                
  set the signal handler. 
  test routine should issue SIGINT 
  to child and catch resulting text
              
            

• t_set_parent(val);

  
              
  
                
                
  set the value of "parent"
  return the previous value
              
            

• $pid = t_pidrun()

  
              
  
                
                
  input:  none
  output: pid found in pid file
  see t_chk4pid below
              
            

• t_savpid(path2pidfile)

  
              
  
                
                
  input:  path to pid file
  output: none
  saves the pid of the current process
  in the pid file (path2pidfile)
              
            

• $pidpath = t_chk4pid(path)

  
              
  
                
                
  input:  path to pid file
  output: undef or path to pid file
  checks for a process running with the pid
  found in "path". If the process is running
  return undef, otherwise return the "path".
  Always places the "pid" found in pid file
  into the variable "pidrun".
              
            

• $pidpath = t_pidpath();

  
              
  
                
                
  input:  none
  output: current pidpath/file
              
            

• $err = t_init(home,...);

  
              
  
                
                
  input:  dbhome, arg1...argN
  output: 0 or error code
              
            

• $err = t_dump(which, name);

  
              
  
                
                
   input: 0  = primary db
    or    nz = secondary db,
          database name
  this only works for specific
  test sequence used in the 
  test suite.
   output:        0 or error code
   prints database to STDOUT in the format
  dot.quad.addr => timestamp
              
            

• t_close();

  
              
  
                
                
  input:  none
  output: none
  close the database files and environment
              
            

• $data = t_get(which,addr,name);

  
              
  
                
                
  input:  0  = primary db
   or     nz = secondary db
  database name
  output: data (long)
  or undef if not there
              
            

• ($key,$data)=t_getrecno(which,name,cursor);

  
              
  
                
                
  input:  0  = primary db
   or     nz = secondary db
  database name,
  cursor (starting at 1)
  output: key, data
              
            

• $string = t_bdberror(status);

  
              
  
                
                
  input:  BDB status code
  output: string representing the code
              
            

• $version_string=t_bdbversion();

  
              
  
                
                
  input:  none
  output: BDB version
              
            

• $nrecords = t_bdbcount(name);

  
              
  
                
                
  input:  name of database
  output: number of records in db
              
            

  NOTE: database must be open

EXPORT

None

AUTHOR

Michael Robinton <michael@bizsystems.com>

See also: files in subdirectory ./t