A.3   Target Directories and Files

Table A-3 is a summary and description of the Tornado directories and files below the top-level target directory.

Table A-3:  $WIND_BASE/target


Directory
 
File
 
Description
 

config
   
Directory containing files used to configure and build particular VxWorks systems. It includes system-dependent modules and some user-alterable modules. These files are organized into several subdirectories: the subdirectory all, which contains modules common to all implementations of VxWorks (system-independent modules), and a subdirectory for each port of VxWorks to specific target hardware (system-dependent modules).
 
config/all
   
Subdirectory containing system configuration modules. Note that this method of configuration has been replaced by the project facility (see 4. Projects). The directory includes the following files:
 
 
bootInit.c
 
System-independent boot ROM facilities.
 
 
configAll.h
 
Generic header file used to define configuration parameters common to all targets.
 
 
usrConfig.c, bootConfig.c
 
Source of the configuration module for a VxWorks development system (usrConfig.c), and a configuration module for the VxWorks boot ROM (bootConfig.c).
 
config/bspname
   
The other subdirectories of config contain system-dependent modules for each port of VxWorks to a particular target CPU. Each of these directories includes the following files:
 
 
Makefile
 
Makefile for creating boot ROMs and the VxWorks system image for a particular target.
 
 
sysLib.c, sysALib.s
 
Two source modules of system-dependent routines.
 
 
tyCoDrv.c
 
A driver for on-board serial ports.
 
 
config.h
 
Header file of hardware configuration parameters.
 
 
bspname.h
 
Header file for the target board.
 
 
romInit.s
 
Assembly language source for initialization code that is the entry point for the VxWorks boot ROMs and ROM-based versions of VxWorks.
 
 
vxWorks, vxWorks.sym
 
Complete, linked VxWorks system binary (vxWorks), and its symbol table (vxWorks.sym) created with the supplied configuration files.
 
 
bootrom, bootrom.hex
 
VxWorks boot ROM code, as object module (bootrom) and as an ASCII file (bootrom.hex) in Motorola S-record format or Intel hex format (i960 targets), suitable for downloading over a serial connection to a PROM programmer.
 
h
   
Directory containing all the header (include) files supplied by VxWorks. Your application modules must include several of them in order to access VxWorks facilities.
 
h/arch
   
Directory containing architecture-dependent header files.
 
h/arpa
   
Directory containing a header file for use with inetLib.
 
h/drv
   
Directory containing hardware-specific headers (primarily for drivers). Not all of the subdirectories shown are present for all BSPs.
 
h/make
   
Directory containing files that describe the rules for the makefiles for each CPU and toolset.
 
h/net
   
Directory containing all the internal header (include) files used by the VxWorks network. Network drivers will need to include several of these headers, but no application modules should need them.
 
h/netinet
   
Directory containing Internet-specific header files.
 
h/private
   
Directory containing header files for code private to VxWorks.
 
h/rpc
   
Directory containing header files that must be included by applications using the Remote Procedure Call library (RPC).
 
h/sys
   
Directory containing header files specified by POSIX.
 
h/types
   
Directory containing header files used for defining types.
 
lib
   
Directory containing the machine-independent object libraries and modules provided by VxWorks.
 
lib/objcputoolvx
   
A directory containing VxWorks object modules as individual files (suitable for loading dynamically to the target).
 
lib/libcputoolvx.a
   
An archive (ar) format library containing the object modules that make up VxWorks.
 
src
   
Directory containing all source files for VxWorks.
 
src/config
   
Directory containing files used to force inclusion of specific VxWorks modules.
 
 
ansi_5_0.c
 
Used to include all 5.0 ANSI C library routines.
 
 
assertInit.c
 
Used to include the assert ANSI C library routine.
 
 
ctypeInit.c
 
Used to include the ctype ANSI C library routines.
 
 
localeInit.c
 
Used to include the locale ANSI C library routines.
 
 
mathInit.c
 
Used to include the math ANSI C library routines.
 
 
stdioInit.c
 
Used to include the stdio ANSI C library routines.
 
 
stdlibInit.c
 
Used to include the stdlib ANSI C library routines.
 
 
stringInit.c
 
Used to include the string ANSI C library routines.
 
 
timeInit.c
 
Used to include the time ANSI C library routines.
 
 
usrDepend.c
 
Used to check module dependences for constants defined in configAll.h and config.h.
 
 
usrExtra.c
 
Used to include extra modules that are needed by VxWorks but not referenced in the VxWorks code.
 
 
usrFd.c
 
Used to mount a dosFs file system on a boot diskette (i386/i486 targets only).
 
 
usrKernel.c
 
Used to configure and initialize the wind kernel.
 
 
usrIde.c
 
Used to mount a dosFs file system on a boot IDE hard disk drive (i386/i486 targets only).
 
 
usrLoadSym.c
 
Used to load the VxWorks symbol table.
 
 
usrMmuInit.c
 
Used to initialize the memory management unit.
 
 
usrNetwork.c
 
Used to configure and initialize networking support.
 
 
usrScript.c
 
Used to execute a startup script when VxWorks first boots.
 
 
usrScsi.c
 
Used to configure and initialize SCSI support.
 
 
usrSmObj.c
 
Used to configure and initialize shared memory object support.
 
 
usrWdb.c
 
Used to configure and initialize the Tornado target agent.
 
 
cplusHeap.c, cplusIos.c, cplusTools.c
 
Used to configure Rogue Wave C++ utility classes (from optional product: Wind Foundation Classes).
 
 
cplusVxw.c
 
Used to configure VxWorks wrapper classes (from optional product: Wind Foundation Classes).
 
 
usrCplusTools.c
 
Used to initialize Rogue Wave C++ utility classes (from optional product: Wind Foundation Classes).
 
 
usrCplusVxw.c
 
Used to initialize VxWorks wrapper classes (from optional product: Wind Foundation Classes).
 
src/demo
   
Directory containing sample application modules for demonstration purposes, including both the source and the compiled object modules ready to be loaded into VxWorks.
 
src/demo/1
   
Directory containing a simple introductory demo program as well as a server/client socket demonstration.
 
src/demo/dg
   
Directory containing a simple datagram facility, useful for demonstrating and testing datagrams on VxWorks and/or other TCP/IP systems.
 
src/demo/color
   
Directory containing the VxColor example application used in 2. A Whirlwind Tour.
 
src/demo/start
   
Directory containing the program used with the Tornado Getting Started Guide tutorial.
 
src/drv
   
Directory containing source code for supported board device drivers. Not all of the subdirectories shown are present for all BSPs.
 
src/usr
   
Directory containing user-modifiable code.
 
usrLib.c
   
Library of routines designed for interactive invocation, which can be modified or extended if desired.
 
statTbl.c
   
Source of the error status table. It contains a symbol table of the names and values of all error status codes in VxWorks. This table is used by the routine printErrno( ) for translating error status codes into meaningful messages.
 
memDrv.c
   
Pseudo-device driver that allows memory to be accessed as a VxWorks character (non-block) device.
 
ramDrv.c
   
Block device driver that allows memory to be used as a device with VxWorks local file systems.
 
The following directories are included only with a VxWorks source license.
 
src/arch
   
Directory containing VxWorks source code for architecture-specific modules.
 
src/cplus
   
Directory containing source code for the Wind C++ Foundation Classes.
 
src/libc
   
Directory containing the source files for the ANSI C library.
 
src/math
   
Directory containing the source files for various math routines (non-ANSI).
 
src/netwrs
   
Directory containing the source files for the VxWorks network subsystem modules.
 
src/netinet
   
Directory containing the source files for Internet network protocols.
 
src/os
   
Directory containing the source code for VxWorks kernel extensions (for example: I/O, file systems).
 
src/ostool
   
Directory containing the source code for VxWorks tools.
 
src/rpc
   
Directory containing the source code for RPC that has been modified to run under VxWorks.
 
src/util
   
Directory containing source code for the VxWorks utilities.
 
src/wdb
   
Directory containing source code for the Tornado target agent.
 
src/wind
   
Directory containing source code for the VxWorks kernel.
 
unsupported
   
Directory containing miscellaneous unsupported code such as public domain software, examples, host tools, obsolete BSPs, and BOOTP server.