Skip to contents

Write VTK linker flags to a response file

Source: R/vtk.R
LdFlagsFile.Rd

On Windows the full set of VTK linker flags can exceed the 8 191-character Windows command-line limit, causing the linker to drop flags at the end of the list. This function writes the flags to a plain-text response file that the linker reads via the @file syntax, keeping the command line short.

Usage

LdFlagsFile(path, os_type = .Platform$OS.type)

Arguments

path

Path (relative to the package source root, i.e. where configure runs) to the response file to write on Windows, e.g. "src/vtk_libs.rsp". Ignored on non-Windows platforms.

os_type

A string identifying the operating-system type, defaulting to .Platform$OS.type. Override to "windows" or "unix" in tests to exercise the Windows response-file branch without needing a Windows environment.

Value

Invisibly, the string to embed in configure (either @basename(path) on Windows or the raw flags on other platforms). The string is also written to stdout so that shell command substitution captures it.

Details

Intended to be called from a downstream package's configure or configure.win script:

VTK_LIBS="$("${R_HOME}/bin/Rscript" --vanilla -e \
  "rvtk::LdFlagsFile('src/vtk_libs.rsp')")"
# VTK_LIBS is now the short string "@src/vtk_libs.rsp" on Windows,
# or the raw flags on macOS/Linux.

On Windows the flags are written to path and the function returns the @basename(path) token for the linker. On macOS and Linux, ld does not reliably support @file response files at the compiler-driver level, so no file is written and the raw flags are returned directly.

Examples

rsp <- file.path(tempdir(), "vtk_libs.rsp")
ref <- LdFlagsFile(rsp)
#> -Wl,--start-group /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkChartsCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonColor-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonComputationalGeometry-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonDataModel-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonExecutionModel-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonMath-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonMisc-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonSystem-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkCommonTransforms-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkDICOMParser-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkDomainsChemistry-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkDomainsChemistryOpenGL2-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersAMR-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersCellGrid-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersExtraction-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersFlowPaths-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersGeneral-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersGeneric-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersGeometry-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersGeometryPreview-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersHybrid-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersHyperTree-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersImaging-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersModeling-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersParallel-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersParallelImaging-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersPoints-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersProgrammable-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersReduction-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersSMP-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersSelection-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersSources-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersStatistics-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersTemporal-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersTensor-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersTexture-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersTopology-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkFiltersVerdict-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkGeovisCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOAMR-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOAsynchronous-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOCGNSReader-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOCONVERGECFD-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOCellGrid-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOCesium3DTiles-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOChemistry-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOCityGML-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOERF-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOEnSight-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOEngys-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOExodus-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOExport-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOExportGL2PS-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOExportPDF-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOFDS-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOFLUENTCFF-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOGeometry-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOHDF-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOIOSS-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOImage-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOImport-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOInfovis-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOLANLX3D-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOLSDyna-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOLegacy-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOMINC-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOMotionFX-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOMovie-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIONetCDF-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOOggTheora-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOPLY-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOParallel-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOParallelXML-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOSQL-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOSegY-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOTecplotTable-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOVeraOut-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOVideo-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOXML-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkIOXMLParser-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingColor-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingFourier-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingGeneral-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingHybrid-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingMath-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingMorphological-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingSources-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingStatistics-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkImagingStencil-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkInfovisCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkInfovisLayout-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkInteractionImage-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkInteractionStyle-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkInteractionWidgets-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkParallelCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkParallelDIY-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingAnnotation-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingCellGrid-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingContext2D-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingContextOpenGL2-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingFreeType-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingGL2PSOpenGL2-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingGridAxes-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingHyperTreeGrid-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingImage-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingLICOpenGL2-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingLOD-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingLabel-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingOpenGL2-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingSceneGraph-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingUI-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingVolume-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingVolumeOpenGL2-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkRenderingVtkJS-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkTestingCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkTestingRendering-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkViewsContext2D-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkViewsCore-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkViewsInfovis-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkWrappingTools-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkcgns-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkdoubleconversion-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkexodusII-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkexpat-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkfmt-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkfreetype-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkgl2ps-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkglad-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkhdf5-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkhdf5_hl-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkioss-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkjpeg-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkjsoncpp-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkkissfft-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtklibharu-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtklibproj-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtklibxml2-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkloguru-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtklz4-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtklzma-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkmetaio-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtknetcdf-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkogg-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkpng-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkpugixml-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtksqlite-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtksys-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtktheora-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtktiff-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtktoken-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkverdict-9.5.a /home/runner/work/_temp/Library/rvtk/prebuilt/lib/libvtkzlib-9.5.a -Wl,--end-group