                    PROTOS Test-Suite: c04-wap-wsp-request

$RCSfile: README.TXT,v $ $Revision: 1.11 $ $Date: 2000/10/11 05:59:23 $

Copyright (C) 2000 PROTOS Project Consortium
[http://www.ee.oulu.fi/research/ouspg/protos]

Description

  The "WAP-WSP-Request" test-suite is meant for testing the WSP protocol
  requests (GET/POST). This means:

  - Initial communication with the servers, gateways and proxies 
  - No dynamic behaviour nor state requirements 

  The target for testing is any WAP gateway software. Test-cases
  (packets) are transfered (injected) to target on top of UDP protocol.

Test-material package

  Package information
  
   Test-material is distributed as a JAR-package. This package comprises
   of the following elements:
     * Total of 4236 test-cases (PDUs), located in testcases/ directory
     * Java code (source and compiled) for feeding the test-cases against
       the system under test.
     * LICENSE.TXT - GNU General Public License (GPL) version 2
     * README.TXT - Instructions
       
  License and copyright
  
   The test-material is licensed under GNU General Public License (GPL)
   version 2, at no charge. This is done in order to ensure that vendors
   and their customers may freely utilize the test-material. Standard GPL
   terms for no warranty and no liability apply.
   
   We recommend some additional guidelines, although these do not
   restrict the test-material license. These guidelines can be found from
   the "PROTOS - Test-suites development" document.
   
  Usage
  
   The test-material can be used either with the bundled injection code
   [Using with Java] or with an external injector [Using single
   test-cases].
   
    Using with Java
    
   Java Runtime is a prerequisite for running the bundled Java code.
   [http://java.sun.com] This package has been tested on Java 2 SDK
   1.2.2. [ http://java.sun.com/products/jdk/1.2/].
   
   Usage examples for the injection code bundled in the JAR-package:
   
   java -jar c04-wap-r1.jar -help
          This command displays the built-in help for the available
          command line options. Options such as selecting a specific
          range of test-cases or non-standard destination port are
          high-lighted therein.
          
   java -jar c04-wap-r1.jar -host 10.10.10.10
          This command activates the bundled injection code and
          test-cases are delivered to the system under test one by one.
          Target system is identified either by host name or ip-address.
          
    Using single test-cases
    
   The test-cases (PDUs) are in raw binary format and can be used by any
   suitable delivery software, such as netcat. The individual test-cases
   can be extracted from the JAR-package with tools such as unzip, winzip
   or jar. Refer to the manual pages and product documentation of the
   respective tools for additional information.
   
   An example delivery with netcat:
   
   netcat -u 10.10.10.10 9200 < testcases/00000999
   
  Download
  
     * c04-wap-r1.jar - Test-material Release v1
     * c04-wap-r1.jar.asc - Detached PGP signature
       
  Notes
  
   Presence of a web server on the target machine may affect the test
   reproducibility. This is due to an embedded http://127.0.0.1 URL in
   the test material. Results presented herein were obtained without a
   web server running on the system under test.
