wscc
WSTP template file compiler.
Details
- is a C and C++ compiling command for creating a program for installation into the Wolfram Language with the Wolfram Language command Install. The installed program communicates with the Wolfram Language by using the WSTP protocol. The command should have a WSTP template file as one of its file arguments along with ordinary C and C++ source files and object files, which encode the functions that are to be installed into the Wolfram Language. The WSTP template filename should bear a .tm suffix.
- The script first passes the template file to the Wolfram System utility wsprep, which preprocesses it into a C file that uses WSTP library functions. It then invokes the compiler identified by the environment variable to compile and link this C file along with the other files, arguments, and the WSTP library. The script checks the environment variable CXX for compiling C++ files.
- On operating systems that support multiple binary formats, automatically links with the appropriate library.
- passes all defined options through to the C compiler, but it also treats the following options specially:
-
-g keep the C file generated by wsprep and pass the -g option to the C compiler to generate a symbol table for debugging -E pass the .tm files through wsprep, then run the C source files through the C compiler only, sending output to stdout -P pass the .tm files through wsprep, then run the C source files through the C compiler only, writing the output to a file with a .i suffix -xo name write the output file in name/$SystemID/name, to be located by Install["name"] -st link with the static WSTP library; on Mac OS X only links with the static library -b32 override automatic binary format selection to generate a 32-bit binary -b64 override automatic binary format selection to generate a 64-bit binary -b32_64 override automatic binary format selection to generate a binary with both 32-bit and 64-bit architectures on Mac OS X -n direct to generate a binary on Mac OS X that contains only the default binary type; compilers on Mac OS X currently generate 32-bit ppc or i386 architectures by default --version print the version of to stdout --help print a help message for to stdout