## config -- Simple shell script to get the values of basic R configure
## variables, or the header and library flags necessary for linking
## against R.
##
## Usage:
## R CMD config [options] [VAR]
## Copyright (C) 2002-2022 The R Core Team
##
## This document is free software; you can redistribute it and/or modify
## it under the terms of the GNU General Public License as published by
## the Free Software Foundation; either version 2, or (at your option)
## any later version.
##
## This program is distributed in the hope that it will be useful, but
## WITHOUT ANY WARRANTY; without even the implied warranty of
## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
## General Public License for more details.
##
## A copy of the GNU General Public License is available at
## https://www.R-project.org/Licenses/
revision='$Revision$'
version=`set - ${revision}; echo ${2}`
version="R configuration information retrieval script: ${R_VERSION} (r${version})
Copyright (C) 2002-2022 The R Core Team.
This is free software; see the GNU General Public License version 2
or later for copying conditions. There is NO warranty."
usage="Usage: R CMD config [options] [VAR]
Get the value of a basic R configure variable VAR which must be among
those listed in the 'Variables' section below, or the header and
library flags necessary for linking a front-end against R.
Options:
-h, --help print short help message and exit
-v, --version print version info and exit
--cppflags print pre-processor flags required to compile a
C/C++ file as part of a front-end using R as a library
--ldflags print linker flags needed for linking a front-end
against the R library
--no-user-files ignore customization files under ~/.R
--no-site-files ignore site customization files under R_HOME/etc
--all print names and values of all variables below
Variables:
AR command to make static libraries
BLAS_LIBS flags needed for linking against external BLAS libraries
CC C compiler command
CFLAGS C compiler flags
CC17 Ditto for the C17 or earlier compiler
C17FLAGS
CC23 Ditto for the C23 or later compiler
C23FLAGS
CPICFLAGS special flags for compiling C code to be included in a
shared library
CPPFLAGS C/C++ preprocessor flags, e.g. -I
if you have
headers in a nonstandard directory
CXX default compiler command for C++ code
CXXFLAGS compiler flags for CXX
CXXPICFLAGS special flags for compiling C++ code to be included in a
shared library
CXX11 compiler command for C++11 code
CXX11STD flag used with CXX11 to enable C++11 support
CXX11FLAGS further compiler flags for CXX11
CXX11PICFLAGS
special flags for compiling C++11 code to be included in
a shared library
CXX14 compiler command for C++14 code
CXX14STD flag used with CXX14 to enable C++14 support
CXX14FLAGS further compiler flags for CXX14
CXX14PICFLAGS
special flags for compiling C++14 code to be included in
a shared library
CXX17 compiler command for C++17 code
CXX17STD flag used with CXX17 to enable C++17 support
CXX17FLAGS further compiler flags for CXX17
CXX17PICFLAGS
special flags for compiling C++17 code to be included in
a shared library
CXX20 compiler command for C++20 code
CXX20STD flag used with CXX20 to enable C++20 support
CXX20FLAGS further compiler flags for CXX20
CXX23 compiler command for C++23 code
CXX23STD flag used with CXX23 to enable C++23 support
CXX23FLAGS further compiler flags for CXX23
CXX23PICFLAGS
special flags for compiling C++23 code to be included in
a shared library
DYLIB_EXT file extension (including '.') for dynamic libraries
DYLIB_LD command for linking dynamic libraries which contain
object files from a C or Fortran compiler only
DYLIB_LDFLAGS
special flags used by DYLIB_LD
FC Fortran compiler command
FFLAGS fixed-form Fortran compiler flags
FCFLAGS free-form Fortran 9x compiler flags
FLIBS linker flags needed to link Fortran code
FPICFLAGS special flags for compiling Fortran code to be turned
into a shared library
JAR Java archive tool command
JAVA Java interpreter command
JAVAC Java compiler command
JAVAH Java header and stub generator command
JAVA_HOME path to the home of Java distribution
JAVA_LIBS flags needed for linking against Java libraries
JAVA_CPPFLAGS C preprocessor flags needed for compiling JNI programs
LAPACK_LIBS flags needed for linking against external LAPACK libraries
LIBnn location for libraries, e.g. 'lib' or 'lib64' on this platform
LDFLAGS linker flags, e.g. -L if you have libraries in a
nonstandard directory
LTO LTO_FC LTO_LD flags for Link-Time Optimization
MAKE Make command
NM comand to display symbol tables
OBJC Objective C compiler command
OBJCFLAGS Objective C compiler flags
RANLIB command to index static libraries
SAFE_FFLAGS Safe (as conformant as possible) Fortran compiler flags
SHLIB_CFLAGS additional CFLAGS used when building shared objects
SHLIB_CXXFLAGS
additional CXXFLAGS used when building shared objects
SHLIB_CXXLD command for linking shared objects which contain
object files from a C++ compiler (and CXX11 CXX14 CXX17 CXX20 CXX23)
SHLIB_CXXLDFLAGS
special flags used by SHLIB_CXXLD (and CXX11 CXX14 CXX17 CXX20 CXX23)
SHLIB_EXT file extension (including '.') for shared objects
SHLIB_FFLAGS additional FFLAGS used when building shared objects
SHLIB_LD command for linking shared objects which contain
object files from a C or Fortran compiler only
SHLIB_LDFLAGS
special flags used by SHLIB_LD
TCLTK_CPPFLAGS
flags needed for finding the tcl.h and tk.h headers
TCLTK_LIBS flags needed for linking against the Tcl and Tk libraries
"
if test "${R_OSTYPE}" = "windows"; then
usage="${usage}
Windows only:
COMPILED_BY name and version of compiler used to build R
LOCAL_SOFT absolute path to '/usr/local' software collection
R_TOOLS_SOFT absolute path to 'R tools' software collection
OBJDUMP command to dump objects"
fi
usage="${usage}
Report bugs at ."
##
## The variables are basically the precious configure variables (with
## the R_* and MAIN_* ones removed), plus FLIBS and BLAS_LIBS.
## One could use
## precious_configure_vars=`~/src/R/configure --help \
## | sed -n '/^Some influential/,/^[^ ]/p' \
## | sed '/^[^ ]/d' \
## | sed 's/^ //' \
## | cut -f1 -d ' ' \
## | grep -v '^MAIN_' \
## | grep -v '^R_' \
## | sort \
## | uniq`
## to obtain the configure vars and hence create most of the above usage
## info as well as the list of accepted variables below automatically.
##
if test $# = 0; then
echo "${usage}"
exit 1
fi
if test "${R_OSTYPE}" = "windows"; then
MAKE=make
R_DOC_DIR=${R_HOME}/doc
R_INCLUDE_DIR=${R_HOME}/include
R_SHARE_DIR=${R_HOME}/share
fi
makefiles="-f ${R_HOME}/etc${R_ARCH}/Makeconf -f ${R_SHARE_DIR}/make/config.mk"
## avoid passing down -jN
MAKEFLAGS=
export MAKEFLAGS
query="${MAKE} -s ${makefiles} print R_HOME=${R_HOME}"
LIBR=`eval $query VAR=LIBR`
STATIC_LIBR=`eval $query VAR=STATIC_LIBR`
MAIN_LDFLAGS=`eval $query VAR=MAIN_LDFLAGS`
LIBS=`eval $query VAR=LIBS`
LDFLAGS=`eval $query VAR=LDFLAGS`
if test -n "${R_ARCH}"; then
includes="-I${R_INCLUDE_DIR} -I${R_INCLUDE_DIR}${R_ARCH}"
else
includes="-I${R_INCLUDE_DIR}"
fi
var=
personal="yes"
site="yes"
all="no"
while test -n "${1}"; do
case "${1}" in
-h|--help)
echo "${usage}"; exit 0 ;;
-v|--version)
echo "${version}"; exit 0 ;;
--cppflags)
if test -z "${LIBR}"; then
if test -z "${STATIC_LIBR}"; then
echo "R was not built as a library" >&2
else
echo "${includes}"
fi
else
echo "${includes}"
fi
exit 0
;;
--ldflags)
## changed in R 3.1.0 to be those needed to link a front-end
if test -z "${LIBR}"; then
if test -z "${STATIC_LIBR}"; then
echo "R was not built as a library" >&2
else
echo "${MAIN_LDFLAGS} ${LDFLAGS} ${STATIC_LIBR}"
fi
else
echo "${MAIN_LDFLAGS} ${LDFLAGS} ${LIBR} ${LIBS}"
fi
exit 0
;;
--no-user-files)
personal="no"
;;
--no-site-files)
site="no"
;;
--all)
all="yes"
;;
*)
if test -z "${var}"; then
var="${1}"
else
echo "ERROR: cannot query more than one variable" >&2
exit 1
fi
;;
esac
shift
done
## quotes added in R 3.3.2
if test "${site}" = "yes"; then
: ${R_MAKEVARS_SITE="${R_HOME}/etc${R_ARCH}/Makevars.site"}
if test -f "${R_MAKEVARS_SITE}"; then
makefiles="${makefiles} -f \"${R_MAKEVARS_SITE}\""
fi
fi
if test "${personal}" = "yes"; then
if test "${R_OSTYPE}" = "windows"; then
if test -f "${R_MAKEVARS_USER}"; then
makefiles="${makefiles} -f \"${R_MAKEVARS_USER}\""
elif test -f "${HOME}/.R/Makevars.ucrt"; then
makefiles="${makefiles} -f \"${HOME}\"/.R/Makevars.ucrt"
elif test -f "${HOME}/.R/Makevars.win64"; then
makefiles="${makefiles} -f \"${HOME}\"/.R/Makevars.win64"
elif test -f "${HOME}/.R/Makevars.win"; then
makefiles="${makefiles} -f \"${HOME}\"/.R/Makevars.win"
elif test -f "${HOME}/.R/Makevars"; then
makefiles="${makefiles} -f \"${HOME}\"/.R/Makevars"
fi
else
. ${R_HOME}/etc${R_ARCH}/Renviron
if test -f "${R_MAKEVARS_USER}"; then
makefiles="${makefiles} -f \"${R_MAKEVARS_USER}\""
elif test -f "${HOME}/.R/Makevars-${R_PLATFORM}"; then
makefiles="${makefiles} -f \"${HOME}\"/.R/Makevars-${R_PLATFORM}"
elif test -f "${HOME}/.R/Makevars"; then
makefiles="${makefiles} -f \"${HOME}\"/.R/Makevars"
fi
fi
fi
query="${MAKE} -s ${makefiles} print R_HOME=${R_HOME}"
ok_c_vars="CC CFLAGS CPICFLAGS CPPFLAGS CC17 C17FLAGS CC23 C23FLAGS CC90 C90FLAGS CC99 C99FLAGS"
ok_cxx_vars="CXX CXXFLAGS CXXPICFLAGS CXX11 CXX11STD CXX11FLAGS CXX11PICFLAGS CXX14 CXX14STD CXX14FLAGS CXX14PICFLAGS CXX17 CXX17STD CXX17FLAGS CXX17PICFLAGS CXX20 CXX20STD CXX20FLAGS CXX20PICFLAG CXX23 CXX23STD CXX23FLAGS CXX23PICFLAGS"
ok_dylib_vars="DYLIB_EXT DYLIB_LD DYLIB_LDFLAGS"
ok_objc_vars="OBJC OBJCFLAGS"
ok_java_vars="JAVA JAVAC JAVAH JAR JAVA_HOME JAVA_LIBS JAVA_CPPFLAGS"
ok_ftn_vars="FC FFLAGS FPICFLAGS FLIBS FCFLAGS SAFE_FFLAGS"
ok_ld_vars="LDFLAGS"
ok_shlib_vars="SHLIB_CFLAGS SHLIB_CXXFLAGS SHLIB_CXXLD SHLIB_CXXLDFLAGS SHLIB_CXX11LD SHLIB_CXX11LDFLAGS SHLIB_CXX14LD SHLIB_CXX14LDFLAGS SHLIB_CXX17LD SHLIB_CXX17LDFLAGS SHLIB_CXX20LD SHLIB_CXX20LDFLAGS SHLIB_CXX23LD SHLIB_CXX23LDFLAGS SHLIB_EXT SHLIB_FFLAGS SHLIB_LD SHLIB_LDFLAGS"
ok_tcltk_vars="TCLTK_CPPFLAGS TCLTK_LIBS"
ok_other_vars="BLAS_LIBS LAPACK_LIBS MAKE LIBnn AR NM RANLIB LTO LTO_FC LTO_LD"
defunct_vars="CPP CXXCPP"
if test "${R_OSTYPE}" = "windows"; then
ok_win_vars="LOCAL_SOFT R_TOOLS_SOFT COMPILED_BY OBJDUMP"
fi
if test "${all}" = "yes"; then
query="${MAKE} -s ${makefiles} print-name-and-value R_HOME=${R_HOME}"
for v in ${ok_c_vars} ${ok_cxx_vars} ${ok_dylib_vars} ${ok_ftn_vars} \
${ok_objc_vars} ${ok_java_vars} \
${ok_ld_vars} ${ok_shlib_vars} ${ok_tcltk_vars} \
${ok_other_vars} ${ok_win_vars}; do
eval "${query} VAR=${v}"
done
echo
echo "## The following variables are defunct"
echo ${defunct_vars}
exit 0
fi
## Can we do this elegantly using case?
var_ok=no
for v in ${ok_c_vars} ${ok_cxx_vars} ${ok_dylib_vars} ${ok_ftn_vars} \
${ok_objc_vars} ${ok_java_vars} \
${ok_ld_vars} ${ok_shlib_vars} ${ok_tcltk_vars} \
${ok_other_vars} ${ok_win_vars}; do
if test "${var}" = "${v}"; then
var_ok=yes
break
fi
done
for v in ${defunct_vars}; do
if test "${var}" = "${v}"; then
var_ok=yes
1>&2 echo "'config' variable '${v}' is defunct"
exit 2
fi
done
if test "${var_ok}" = yes; then
eval "${query} VAR=${var}"
else
echo "ERROR: no information for variable '${var}'"
exit 1
fi
### Local Variables: ***
### mode: sh ***
### sh-indentation: 2 ***
### End: ***