Tornado Reference : Tornado Utilities

extractBsp

NAME

extractBsp - extract a BSP from a VxWorks installation

SYNOPSIS

extractBsp -b bspName -s vxworksDir [-d outfile]

DESCRIPTION

This tool extracts all files that make up a specified BSP from a given VxWorks installation and places them in a tar file. The tar file can then be installed into a VxWorks tree with installOption.

This tool provides a means of installing older BSPs in later releases of VxWorks that support them. It is useful as an installation alternative for those who need to install a previously released BSP into a new VxWorks release but cannot locate the original BSP distribution tape.

OPTIONS

-b bspName
the name of the BSP as it appears in the $WIND_BASE/target/config directory.

-s vxworksDir
the base directory of the VxWorks installation from which you want to extract the BSP.

-d outfile
By default, the resulting tar file is placed in the current directory with the name bspName_tar. If -d is used and outfile is a directory, then the resulting tar file is created there and given the name bspName_tar; otherwise the file is given the name outfile.

EXAMPLE

The following example extracts an MVME147 BSP. The script is run from the newly installed VxWorks tree, $WIND_BASE/target, and extracts the BSP from the VxWorks 5.1.x tree, /usr/vw.5.1. The installOption script is then run to install the BSP in the $WIND_BASE/target directory.

    % cd $WIND_BASE/target
    % extractBsp -b mv147 -s /usr/vw.5.1
    % installOption -f mv147_tar

NOTE

While extractBsp correctly collects all the files that comprise a given BSP, it may actually extract more than you need, depending on how many BSPs are in the vxworksDir installation. This is because the script extracts all files found in h/drv and src/drv. For this reason, the preferred alternative is to install BSPs from the original distribution tape.

SEE ALSO

extractBsp, installOption