mst-ots-build.5

- NAME
- SYNTAX
- DESCRIPTION
  - What is changed
- COPYRIGHT AND LICENSE
- AUTHOR

# NAME

mst-ots-build - MST specific ots-build wrapper

# SYNTAX

    # load library
    if ots_build=$(pkg-config --libs mst-ots-build); then
      . $ots_build
    else
      echo >&2 "unable to load mst-ots-build library"
      exit 1
    fi

    # override some default variables
    otsb_set var1 val1
    otsb_set var2 val2

    # initialize the library
    otsb_init

    # parse the command line
    otsb_options "$@"

    # create default build variables
    otsb_set_build_variables

    otsb_run_req_cmds

# DESCRIPTION

This is a wrapper around ots-build to customize it for the MST environment. Instead of sourcing the ots-build script, source the mst-ots-build script. Then follow the instructions for ots-build.

## What is changed

The following changes are made to the standard ots-build functionality:

- All of the sysarch environment variables are available

- Additional options are available:

  `--ots-root`

    It defaults to `${MST_ROOT}/ots`. if `$MST_ROOT` is not set, it is set to `/proj/axaf`.

  `--ots-pkgs`

    It defaults to `${ots_root}/pkgs`

  `--sysplat`

    It defaults to the sysarch `platform_os_generic` variable. (Historically this was the `$platform` variable, but this clashes with the sysarch `$platform` variable.

  `--make`

    The name of the make command. On Solaris this defaults to gmake; everywhere else it's make. The result is also made available in the `MAKE` shell variable.

  `--tar`

    The name of the tar command. On Solaris this defaults to gtar; everywhere else it's tar. The result is also made available in the `TAR` shell variable.

  `--config-opts`

    This is an array which can be used to provide additional configuration options.

- The `prefix` option defaults to `$ots_root/$package`

- The `exec-prefix` option defaults to `$prefix/$sysplat`

- Additional build variables

  `ots_prefix`

    Defaults to `$ots_root`.

  `ots_exec_prefix`

    Defaults to `${ots_prefix}/${sysplat}`

  `pkg_config_dir`

    Where the pkg-config specification files are stored.

# COPYRIGHT AND LICENSE

# AUTHOR

Diab Jerius <djerius@cfa.harvard.edu>