diff options
Diffstat (limited to 'src/slalib/mk')
| -rwxr-xr-x | src/slalib/mk | 437 |
1 files changed, 437 insertions, 0 deletions
diff --git a/src/slalib/mk b/src/slalib/mk new file mode 100755 index 0000000..5a186c3 --- /dev/null +++ b/src/slalib/mk @@ -0,0 +1,437 @@ + +# This is a Bourne shell script. In order to be POSIX-compliant, the +# first line must be blank. + +#+ +# Name: +# mk +# +# Version: +# Version for Mk V library makefile. +# +# Purpose: +# Invoke make to build and install the SLALIB package. +# +# Type of Module: +# Shell script. +# +# Description: +# This script should normally be used to invoke the make utility +# to build and install the SLALIB package and to perform other +# housekeeping tasks. It invokes the make utility after first +# defining appropriate environment variables and macros for the +# computer system in use. This file also serves to document the +# systems on which SLALIB is implemented. +# +# Invocation: +# The user of this script should normally first define the SYSTEM +# environment variable to identify the host computer system (see +# the "Supported Systems" section). This script should then be used +# in the same way as the make utility would be used. For instance, +# to build, install and test SLALIB, you might use the following +# commands: +# +# ./mk build +# ./mk install +# ./mk test +# ./mk clean +# +# Supported Systems: +# The following systems are currently supported and may be +# identified by defining the SYSTEM environment variable +# appropriately before invoking this script: +# +# alpha_OSF1 +# DEC Alpha machines running OSF1 +# +# ix86_Linux +# Intel PC machines running Linux +# +# sun4_Solaris +# SUN Sparcstations running SunOS 5.x (Solaris) +# +# In addition, the following systems have been supported at some +# time in the past. This script contains the macro definitions +# needed for these systems, but it is not known whether {PACKAGE} +# will still build or run on these systems: +# +# convex +# Convex running ConvexOS +# +# mips +# DECstations running Ultrix +# +# sun4 +# SUN Sparcstations running SunOS 4.x +# +# This script will exit without action if the SYSTEM environment +# variable is not defined. A warning will be issued if it is +# defined but is not set to one of the values above. In this case, +# the only environment variable that will be defined by this script +# is SOURCE_VARIANT, which is set to unknown (any that are +# pre-defined will be passed on to make unaltered). +# +# Targets: +# For details of what targets are provided, see the associated +# makefile. The latter will normally provide a default target +# called "help", which outputs a message describing this script +# and lists the targets provided. +# +# Notes on Porting: +# If your machine or system setup does not appear in this script, +# then it should be possible to build and install SLALIB by +# adding a new case to this script with appropriate definitions +# (probably based on one of the existing implementations). +# +# make Macros: +# The following "global" make macros are used in the associated +# makefile and may be changed by means of appropriate environment +# variable definitions (in each case the default is shown in +# parentheses). Note that these macros are provided to allow +# external control over the directories in which software is +# installed, etc., so they should not normally be re-defined within +# this script. +# +# STARLINK (/star) +# Pathname of the root directory beneath which Starlink +# software is currently installed. This indicates to +# SLALIB where to find other Starlink software (include +# files, libraries, etc.) which it uses. +# +# INSTALL ($HOME) +# Pathname of the root directory beneath which SLALIB will +# be installed for use. Your home directory will be used by +# default. This macro is provided to allow SLALIB to be +# installed locally for personal use (e.g. during development +# or testing). It should be set to the $STARLINK directory if +# you want to add SLALIB into an already installed set of +# Starlink software. You should ensure that the appropriate +# sub-directories appear on any relevant search paths which +# your system uses for locating software (e.g. binaries and +# libraries). +# +# EXPORT (.) +# Pathname of the directory into which compressed tar files +# will be written if the "export" or "export_source" make +# targets are used to produce an exportable copy of SLALIB +# or its source files. The current working directory (i.e. +# the SLALIB source directory) will be used by default. +# +# The following "local" make macros are used in the associated +# makefile and should normally be overridden by environment variable +# definitions within this script. All the local macros that are +# used in building a package should overridden even when the value +# is the same as the default. This documents which macros are used +# and ensures that the package will continue to build correctly even +# if the default values are changed. Macros that are not used on a +# particular machine (e.g. BLD_SHR on DECstations) should not be +# overridden. In each case the default is shown in parentheses. +# +# AR_IN (ar -r) +# The command to use to insert an object (.o) file into an +# archive (.a) library. On some systems the variation 'ar r' +# may be required instead. +# +# BLD_SHR (:) +# Command to build a shareable library when given three +# arguments specifying (1) the name of the library file to be +# built (2) a list of the object files to be used in the +# library and (3) a list of any additional libraries against +# which to link. By default, it is assumed that shareable +# libraries are not available, and the default acts as a null +# command. +# +# CC (c89) +# The C compiler command to use. +# +# CFLAGS (-O) +# The C compiler options to use. +# +# C_ROUTINES () +# Names of the C routines needed to build the library. Some +# systems (ix86_Linux) require extra C routines to provide +# missing system functions. +# +# FC (fort77) +# The Fortran compiler command to use. SLALIB requires a Fortran +# 77 compiler that supports the common "permitted" Starlink +# extensions, as documented in Starlink General Paper SGP/16. +# (These include only the most common extensions, such as +# long names, end of line comments, include files, etc.) +# +# FFLAGS (-O) +# The Fortran compiler options to be used. +# +# HLINK (:) +# The command required to perform the linking of the package +# hypertext documentation into a cohesive whole with the rest +# (if any) Starlink documentation at the installation site, and +# with the Hypertext document server at RAL. This service is not +# available on Sparc SunOS4, Dec MIPS Ultrix or Convex. This +# macro is not a standard Starlink macro. +# +# LINK (ln) +# The command required to establish a link to a file. The +# default assumes POSIX.2 behavior, which only provides a +# "hard" link operating within a single file system. If the +# host operating system allows "symbolic" links, then this +# macro might be re-defined as 'ln -s'. Alternatively, if the +# use of multiple file systems is essential but not supported +# by any form of link, then a copy command could be +# substituted (e.g. 'cp -p'), at some cost in file space. +# +# SOURCE_VARIANT ($SYSTEM) +# The name used to distinguish between platform-specific +# files. Using the default ($SYSTEM) implies that multiple +# copies of the same source may exist under different names. +# For example, the files sub1.f_sun4 and sun1.f_sun4_Solaris +# may contain identical source code. If this is to be +# avoided (to save space), edit this script to set +# SOURCE_VARIANT to a suitable string - for example setting it +# to "sun" would allow one copy of the source called +# sub1.f_sun to be used. To do this, add to each of the +# per-system sections a statement of the form: +# +# SOURCE_VARIANT='string' +# +# RANLIB (:) +# The command required to "randomise" an object library. By +# default, this operation is not performed (the default acts +# as a null command). On systems which require it, this +# should typically be set to 'ranlib'. +# +# SHARE (.so) +# The file type suffix to be applied to produce the name of a +# shareable library file. By default, the ".so" suffix is +# applied without a library version number. For systems which +# support version numbers on shareable libraries, the macro +# LIB_VERS is defined within the associated makefile and may +# be used as part of a definition such as '.so.$(LIB_VERS)'. +# +# TAR_IN (pax -w -v -x ustar -f) +# Command to use to insert a file into a .tar archive file. +# The default uses the POSIX.2 pax command, which is not +# available on traditional UNIX systems. These typically use +# a tar command such as 'tar -cvhf' instead (if symbolic +# links are supported, then an option to follow these must be +# included in this command). +# +# TAR_OUT (pax -r -f) +# Command to use to extract a file from a .tar archive file. +# The default uses the POSIX.2 pax command, which is not +# available on traditional UNIX systems. These typically use +# a tar command such as 'tar -xf' instead. +# +# Implementation Deficiencies: +# - The implementation of shareable libraries on the alpha_OSF1 +# system is still preliminary. +# +# Copyright: +# Copyright (C) 1995 Rutherford Appleton Laboratory +# +# Authors: +# RFWS: R.F.Warren-Smith (Starlink, RAL) +# PMA: P.M.Allan (Starlink, RAL) +# PTW: P.T.Wallace (Starlink, RAL) +# AJC: A.J.Chipperfield (Starlink, RAL) +# BLY: M.J.Bly (Starlink, RAL) +# BKM: B.K.McIlwrath (Starlink, RAL) +# {enter_new_authors_here} +# +# History: +# 26-NOV-1993 (RFWS/PMA): +# Starlink template. +# 26-NOV-1993 (PTW): +# Version for SLALIB. +# 28-JUN-1993 (PTW): +# Convex added. +# 06-JUN-1995 (BLY): +# Updated to Mk IVa standard. +# 04-MAR-1996 (BLY): +# Updated to Mk V specification. +# Added HLINK macro and definitions. +# 24-APR-1996 (BLY): +# Integrated Linux support from BKM version. +# 22-JAN-1998 (BLY): +# Removed rtl_sleep.c from C_ROUTINES for Linux case. +# {enter_further_changes_here} +# +# Bugs: +# {note_any_bugs_here} +# +#- + +# Export "local" definitions to the environment for use by make. + export AR_IN + export BLD_SHR + export CC + export CFLAGS + export C_ROUTINES + export FC + export FFLAGS + export HLINK + export LINK + export SOURCE_VARIANT + export RANLIB + export SHARE + export TAR_IN + export TAR_OUT + +# Check that the SYSTEM environment variable is defined. + if test "$SYSTEM" = ""; then + echo "mk: Please define the environment variable SYSTEM to identify" + echo " your computer system (the prologue in the mk script file" + echo " contains more information if you require it)." + +# If OK, test for each recognised system. + else + case "$SYSTEM" in + +# DEC Alpha: +# ========= +# DEC Alpha machines running OSF1. +# ------------------------------- + alpha_OSF1) + AR_IN='ar -r' +# BLD_SHR=\ +#'f() ld -shared -update_registry $(INSTALL)/share/so_locations -o $$1 $$2 $$3 \ +#-lfor -lFutil -lUfor -lm -lots -lc; f' + CC='cc' + CFLAGS='-I$(STAR_INC) -O -std1' + FC='f77' + FFLAGS='-O' + HLINK='$(STAR_BIN)/hlink' + LINK='ln -s' + RANLIB='ranlib' +# SHARE='.so' + TAR_IN='tar -cvhf' + TAR_OUT='tar -xf' + echo "mk: Environment variables defined for $SYSTEM system" + ;; + +# DECstations: +# =========== +# DECstations running Ultrix. +# -------------------------- + mips) + AR_IN='ar -r' + CC='c89' + CFLAGS='-I$(STAR_INC) -O' + FC='f77' + FFLAGS='-O' + LINK='ln -s' + RANLIB='ranlib' + TAR_IN='tar -cvhf' + TAR_OUT='tar -xf' + echo "mk: Environment variables defined for $SYSTEM system" + ;; + +# SUN4 systems: +# ============ +# SUN Sparcstations running SunOS 4.x. +# ----------------------------------- + sun4) + AR_IN='ar r' + BLD_SHR='f() ld -assert pure-text -o $$1 $$2; f' + CC='gcc' + CFLAGS='-I$(STAR_INC) -O -fPIC' + FC='f77' + FFLAGS='-O -PIC' + LINK='ln -s' + RANLIB='ranlib' + SHARE='.so.$(LIB_VERS)' + TAR_IN='tar -cvhf' + TAR_OUT='tar -xf' + echo "mk: Environment variables defined for $SYSTEM system" + ;; + +# SUN Sparcstations running SunOS 5.x (Solaris). +# --------------------------------------------- + sun4_Solaris) + AR_IN='ar -r' + BLD_SHR='f() ld -G -z text -o $$1 $$2; f' + CC='cc' + CFLAGS='-I$(STAR_INC) -O -K PIC' + FC='f77' + FFLAGS='-O -PIC' + HLINK='$(STAR_BIN)/hlink' + LINK='ln -s' + SHARE='.so' + TAR_IN='tar -cvhf' + TAR_OUT='tar -xf' + echo "mk: Environment variables defined for $SYSTEM system" + ;; + +# PC systems: +# ========== +# Intel PC running Linux. +# ---------------------- + ix86_Linux) + AR_IN='ar r' + CC='gcc' + CFLAGS='-O' + C_ROUTINES='rtl_random.c' + FC='gfortran' + FFLAGS='-fno-second-underscore -O' + HLINK='$(STAR_BIN)/hlink' + LINK='ln -s' + RANLIB='ranlib' + TAR_IN='tar -cvhf' + TAR_OUT='tar -xf' + echo "mk: Environment variables defined for $SYSTEM system" + ;; + +# Intel PC running Linux on 64 architecture. +# ----------------------------------------- + x86_64) + AR_IN='ar r' + CC='gcc' + CFLAGS='-O -fPIC' + C_ROUTINES='rtl_random.c' + FC='gfortran' + FFLAGS='-fno-second-underscore -O -fPIC' + HLINK='$(STAR_BIN)/hlink' + LINK='ln -s' + RANLIB='ranlib' + TAR_IN='tar -cvhf' + TAR_OUT='tar -xf' + echo "mk: Environment variables defined for $SYSTEM system" + ;; + +# Convex running ConvexOS. +# ------------------------ + convex) + AR_IN='ar r' + FC='fc' + FFLAGS='-O3' + CC='gcc' + CFLAGS='-I$(STAR_INC) -O -fPIC' + LINK='ln -s' + RANLIB='ranlib' + TAR_IN='tar -cvhf' + TAR_OUT='tar -xf' + echo "mk: Environment variables defined for $SYSTEM system" + ;; + +# IMPORTANT NOTE - Because Convex make doesn't support the -e +# qualifier (as stipulated by the POSIX standard) it will be +# necessary to use another version of make, for example the +# GNU one. This can be accomplished either by editing this script, +# or by setting up a link. + +# Issue a warning if SYSTEM is not recognised. + *) + SOURCE_VARIANT='unknown' + echo "mk: WARNING: value of SYSTEM = $SYSTEM not recognised..." + echo " ...assuming default system characteristics" + echo ' ...setting SOURCE_VARIANT to "unknown"' + ;; + esac + +# Invoke make with the appropriate environment variables set to override +# default macros defined in the makefile. + echo make -e $* + make -e $* + fi + +# End of script. |