vxworks_CXML

Using CXML on VxWorks. This subroutine is for Tru64 UNIX only.

Description

  This file describes how to compile and link an application using CXML
  library on VxWorks system. Examples given below assume the host system is
  running Compaq Tru64 UNIX and the target is anvme system running VxWorks.
  For other host and/or target system, please refer to the operating system
  Manual and the VxWorks Reference Manual.

  The archived CXML library must be installed on the host system. Only
  routines from BLAS, Lapack and Signal Processing are available for the
  VxWorks environment.

To Compile (on Host)

          cc -c -I/[path-spec] -non_shared -std1 -DCPU=21064 f1.c

          where

          -I/[path-spec]
                    gives access to include files in specified directories;

          -DCPU=    assume a Alpha 21064 chip;

          f1.c      file name of the example.

          This creates the object file "f1.o".

To Create a VxWorks Loadable Image

          ld -non_shared -o output.o -r f1.o end.o -ldxml -lots
            ./lib/lib21064osfmath.a

          where

          -r        is used to retain relocation entries in the output file
                    "output.o" for the VxWorks loader;

          end.o     is a dummy object file provided in the CXML kit to let
                    the VxWorks loader bypass some symbols it cannot resolve;

          ./lib/lib21064osfmath.a
                    is the VxWorks version of "libm.a".

          The output file "output.o" is created.

To Load the Image (on Target)

          ld < output.o

          After the image is successfully loaded, it is ready to run.
          You can verify the newly loaded image "output.o" by typing
                  moduleShow

  For more details on building, loading and unloading application modules,
  please refer to the Cross Development Chapter of the VxWorks Programmer's
  Guide.

  If you have any comments or problems when using CXML on VxWorks, please
  send them to dxml@hpc.pko.dec.com.