I 12 September CDRL A001DTI I U SIMULATION INTERFACE LIBRARY. *!I~ll'IllI/I~ll/III~jIII1III!~lI07." * AD-A

Transcription

1 * AD-A ADSTWD~iTR--94-W003322B Advanced Distributed * Simulation Technology DSTRBUTED NTERACTVE U SMULATON NTERFACE LBRARY * (DL) VERSON DESCRPTON DOCUMENT FOR September 1994 Prepared for: STlUCOM US. Army Simulation Training and nstrumentation Command Research Parkway Orlando, FL Contract No. N D-0001 Architecture and Standards Phase 2 Delivery Order CDRL A001DT ECTE' ADST Program Office A Research Parkway 9( Orlando, FL *~ 4-325"c *!~ll'll/~ll/~j1!~l07."

2 REPORT DOCUMENTATON PAGE Form approved 1.RA EPSOY (2E TAT O P ER T No Public reporting burden for this collection of nformation is estimated to average hour per response, including the lime for reviewing inictlons, searching existing data sources, gathering and maintaining the data needed, and completing and reviewingr the collection of nrformalon. Send commntrs regarding this burden eslimatp, or any other aspect of this collection of information, including suggestions for reducing this burden, to Washington Headqua, ters Services, Directorate for nformation Operations and Rep;orts, 1215 Jefferson Davis Highway, Suite Arlington, VA , and to the Offk~e of Management and Budget Project ( ), Washington, DC AGENCY USE ONLY (Leave blank) 2REPORT DATE. 3. REPORT TYPE AND DATES COVERED 9/12/94 Version Description Document 9/12/94 4. TTLE AND SUBTrTLE S. FUNDNG NUMBERS Distributed nteractive Simulation nterface Library (DL) Version Description Document for Contract No. N D AUTHOR(S) Architecture & Standards BD.O PERFORMNG ORGANZATON NAME(S) AND ADDRESS(ES) S. PERFORMNG ORGANZATON Loral Systems Company REPORT NUMBER ADST Program Office A Research Parkway Orlando, FL, ADST/WDL/TR-W003322B 9. SPONSORNG/MONTORNG AGENCY NAME(S) AND ADDRESS(ES) 10. SPONSORNG ORGANZATON REPORT U.S. Army Simulation, Training and nstrumentation Command (STRCOM) Naval Air Warfare Center - Test Systems Division (NAWC-TSD) Research Parkway Orlando, FL, SUPPLEMENTARY NOTES A001 12a. DSTRBUTONAVALABLTY STATEMENT 12b. DSTRBUTON CODE Distribution authorized unlimited. A 13. ABSTRACT (Maximum 200 words) This document provides version descriptions for each component of the Distributed nteractive Simulation (DS) nterface Library (DEL) and instructions for installing the DL on a target system. 14. SUBJECT TERMS 15. NUMBER OF PAGES PRCE CODE 17. SECURTY CLASSFCATON 18. SECURTY CLASSFCATON 19. SECURTY CLASSFCATON 20. LMTATON OF ABSTRACT OF REPORT OF THS PAGE OF ABSTRACT UNCLASSFED UNCLASSFED UNCLASSFED UL NSN Standard Form 298 (Rev. 2-89) Prescribed by ANS Std Z

3 UADSTPWDL1TR--94-W003322B 12 September 1994 TABLE OF CONTENTS 1 iscope DL Overview Document Overview Applicable Documents Version Description DL Version Component Versions Component Enhancements Component Additions Resource Requirements Hardware Resources Software Resources Release Media nstallation nstructions Release Structure Directory Structure Executables SG RX 5.X Software SG RX 4.X Software SUNOS 4. LX Software LST OF LLUSTRATONS El DL Release Tape Label... 4 U~c 1.. s

4 ADSTWDL/TR--94-W0 12 September 1994 H 1 Scope. 1.1 DL Overview. The Distributed nteractive Simulation (DS) nterface Library (DL) provides source code libraries for use in developing DS simulation applications. These include: a. Simulation Network nterface Package (SNP). SNP provides a simulation networking protocol independent and network media independent interface to a simulation network. t currently supports the basic four Protocol Data Units (PDUs) in both DS and SMNET ncluded with SNP are several DS applications: 1) Cell Adapter Unit (CAU). The CAU provides a bi-directional interface between a non-ds simulation cell (SMNET 6.6.1) and a DS network. This allows interaction between the DS and non-ds entities during an exercise. i 2) Selective Cell Adapter Unit (SCAU). The SCAU provides a bi-directional interface with PDU filtering between a non-ds simulation cell (SMNET 6.6.1) and a DS network. This allows selective interaction between the DS and non- DS entities during an exercise. 3) Cell nterface Unit (CU). The CU provides a bi-directional interface with PDU filtering between a DS simulation cell and a low bandwidth (loi ' DS network. b. Lib Packet Valve (libpktvalve). Libpktvalve provides another simulation network interface that supports DS and SMNET t provides a "lower" level interface than SNP and supports more PDUs. t is the networking interface used by Modular Semi-Automated Forces (ModSAF). c. Protocol Translator Cell Adapter Unit (XCAU). The XCAU provides a bi-directional interface between a non-ds simulation cell (SMNET 6.6.1) and a DS network. This allows interaction between the DS and non-ds entities during an exercise. The XCAU is based upon the libpktvalve and currently supports 17 PDUs. 1.2 Document Overview. This document provides version descriptions for each component of the DL and instructions for installing the DL on a target system. 2 Applicable Documents. The documents referenced here are applicable to the program effort only to the extent defined, and are included for reference purposes. This document takes precedence in the event of conflict with any of the referenced documents. U...!1 a. Simulation Network nterface Package (SNP) Programmers Manual (Version 1.3.1)

5 ADST/WDL!TR--94-W003322B 12 September 1994 b. ADST Cold Start Procedures (CSP) for the BDS-D Translator Cell Adapter Unit (XCAU) Configuration in Support of MDT2 (TR B) c. ADST Version Description Document for the BDS-D Translator Cell Adapter Unit (XCAU) in Support of MDT2 (TR B) d. ADST nterface Requirements Specification (RS) for the Protocol Translator of ADS.iRE(TR ) e. ADST Software Maintenance Manual (SMM) for the Protocol Translator of ADST/CSRDF (TR ) f. ADST System/Se2ment Design Document (SSDD) for the Protocol Translator of ADSTCSRDF (D-CMAN-80534) g. ADST Software Requirements Specification (SRS) for the Protocol Translator of ADST/CSRDF (draft, May ) 3 Version Description. 3.1 DL Version. This version of the DL is numbered Version t is a minor modification to the release, in that the version does NOT include the executable (or the source code) for the Development Tools. To provide for comprehensive understanding, this VDD provides the same information as was covered in the VDD. This version of the DL encompasses several enhancements to components included in previous versions prior to t also includes several new components as part of the library. The component versions and descriptions of the enhancements and additions are included in the following paragraphs. 3.2 Component Versions The components included in this version of the DEL and their component versions are: a. Simulation Network nterface Package (SNP) library -- Version ) Cell Adapter Unit (cau) -- Version ) Selective Cell Adapter Unit (scau) -- Version ) Cell nterface Unit (ciu) -- Version

6 - ADST/WD'TR--94-W003322B 12 September 1994 b. Lib Packet Valve (libpktvalve) -- Version c. Protocol Translator Cell Adapter Unit (xcau) -- Version Component Enhancements The following components have been enhanced in this release. a. Simulation Network nterface Package (SNP) library: 1) Fixed "mystery 1" bug. 2) Fixed memory leaks. 3) Fixed SU timestamp error. b. Cell Adapter Unit (cau): SNP Bug Fixes. c. Selective Cell Adapter Unit (scau): SNP Bug Fixes. d. Cell nterface Unit (ciu): SNP Bug Fixes. 3.4 Component Additions. The following components have been added in this release. a. Protocol Translator CAU (xcau). b. Protocol Translator status (xcaustat). 4. Resource Requirements. 4.1 Hardware Resources. The DL components released with this version are supported on the following platforms: a. Silicon Graphics workstation, running RX 5.2, with 64+ MB memory and 500+ MB * disk. b. Silicon Graphics workstation, running RX 4.0.5, with 64+ MB memory and 500+ * MB disk. c. SUN Microsystems workstation, running SunOS 4..X, with 64+ MB memory and 500+ MB disk. 13

7 ADST/WD[JTR--94-W003322B 12 September Software Resources. The source code libraries are developed in the C language and are available as both K&R and ANS C. To re-compile the libraries andthe applications based upon those libraries, a C language compiler is required Release Media. The DL is rjeased as a "compressed tar" file. This tar file is available via a Sun format DC6150 QC tape or via FTP. f the release was obtained via QC tape, a QC 24 tape drive will be required to retrieve the file from the tape. The QC tape, if supplied, is labeled as shown in Figure 4.3-1: U.S. Army Simulation, Training and nstrumentation Command (STRCOM) Research Parkway Orlando, Florida (407) OtL_2.3.OtUar.Z V Feedback-form 12 Sept 1994 SUN- SG-ONYX-UNH 1002&M LMTED DSTRBUTON Produced UnderAOST Contract: [ Lor AlADST Program Office Prodn N D-O001 eadst Cont12151-A Orlando, Research FL Parkway Delivety Order 0035 (407) "tar" Format -160 Mbyte Data Tape Tape 1 of 1 Figure DL Release Tape Label 5 nstallation nstructions. This section describes the installation procedure for the DL version software. The DS nterface Library (DL) distributions are shipped as compressed tar archives. The archives must be loaded on the target machine, decompressed, and unarchived (un-tared). The following procedure illustrates this procedure. i [NOTE: A complete distribution may require u to 84 megabytes of storage. a. First, determine where the software should be installed. 4 4

8 ADST/WDLJTR--94-W00332ZB 12 September 1994 i NOTE: For these examples, the software is installed in "/usr/localu ddt". b. f needed, make a directory using the following command: mkdir /usr/local/ddt c. Change directories to the directory where the software should be installed using the following command: cd /usr/locallddt d. f you received the release via tape, insert the tape into the QC-150 drive and load the tape using the following command: tar xvof /dev/rmt/o (Sun Solaris 2.3) tar xvof /dev/rst8 (Sun SunOS 4.1.x) dd if=devltape conv=swab tar xvof - (SG) e. f you will be retrieving the release via FTP, retrieve it to this location. f. Following this, there shou!d be a compressed tar file in the current directory. Uncompress the file using the following command: uncompress *.Z g. Unarchive the file, using the following command: tar xvof *tar h. There should now be a directory named rel_ t contains the DL version release. 1 Under the rel_2.3.0 directory, there should be several subdirectories and files, including (at least) "bin", "libpktvalve", "snip", and "xcau". There are several README files present in various directories. These contain special notes and information. t is a good practice to examine these README files if you plan on using the applications in that directory tree. 6 Release Structure. The DL Version release has been arranged such that each tool within the library is contained within its own tree with all of the binaries contained (via symbolic links) in a single directory.

9 U ADST/WDL/TR--94-W003322B 12 September 1994 U 6.1 Directory Structure. This paragraph provides a short description of each directory within the first two levels. A complete listing for the directory tree is included as Appendix A. a. bin application executables onyx SG executables specific to RX 5.X sgi SG executables specific to RX 4.X sun SUN(SPARC) SunOS 4.1.X executables c- libpktvalue packet value development tree Components packet valve component library listing Makefile packet valve make script RCS RCS Configuration Management Directory Release release directory contents and information libpktvalve.h libpktvalve.texinfo libpv_local.h pkttee.c pv-assoc.c pvevent.c pv_aoit.c pvio.c pv_nu.c pvconvert.c pv-preempt.c pvrouter.c pv shm.c pvustats.c pv.udp.c rec preempt test. c ropter.rdr sndpreempttest.c test.c.testshm.c packet valve data file packet packet valve valve source source code code id. snip SNP libraries and applications design design files and documentation for DL doc SNP documentation man onyx this is a link to doc/man3 SNP R X version 5 source tree sgi SNP RX version 4 source tree l onyx..-- SNPaiRXiversion 5 source tre 6

10 ADST/WDLJTR--94-W003322B 12 September 1994 e. xcau Protocol Translator (XCAU) dvlpt. directory NSTALL installation script for the XCAU tree bin XCAU binaries config XCAU configuration files data XCAU data files doc XCAU documentation include XCAU include libraries and files info XCAU component documentation tiles lib XCAU libraries src XCAU development trees tools XCAU tools d. snip SNP libraries and applications design design files and documentation for DL doc SNP documentation man this is a link to doc/man3 onyx SNP RX version 5 source tree sgi SNP RX version 4 source tree sun SNP SunOS version 4..X source tree 6.2 Executables SG RX 5.X Software. The software targeted for the SG RX 5.X environment includes the following executables: a. cau b. ciu c. pkttap d. scau e. xcau f. xcaustat SG RX 4.X Software. The software targeted for the SG RX 4.X environment includes the following executables: a. cau b. ciu c. pkttap

11 ~ADST[WD[JTR--94-W003322B12Spebr99 d. scau e. xcau f. xcau-stat SUNOS 4.1.X Software. The software targeted for the SUNOS 4. AX environment includes the following executables: a. cau b. ciu c. pkttap d. scau e. xcau f. xcau-stat U8