.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. .TH CASTXML "1" "March 2024" "castxml version 0.6.3" "User Commands" .SH NAME castxml \- Create an XML representation of C++ declarations .SH SYNOPSIS .B castxml \fI\,( | | )\/\fR... .SH DESCRIPTION .IP Options interpreted by castxml are listed below. Remaining options are given to the internal Clang compiler. .SH OPTIONS .HP \fB\-\-castxml\-cc\-\fR .HP \fB\-\-castxml\-cc\-\fR "(" ... ")" .IP Configure the internal Clang preprocessor and target platform to match that of the given compiler command. The must be "gnu", "msvc", "gnu\-c", or "msvc\-c". names a compiler (e.g. "gcc") and ... specifies options that may affect its target (e.g. "\-m32"). .HP \fB\-\-castxml\-output=\fR .IP Write castxml\-format output to .xml or file named by '\-o' The specifies the "epic" format version number to generate, and must be '1'. .HP \fB\-\-castxml\-gccxml\fR .IP Write gccxml\-format output to .xml or file named by '\-o' Use this option if you need an output similar to the one generated by the legacy gccxml tool. .HP \fB\-\-castxml\-start\fR [,]... .IP Start AST traversal at declaration(s) with the given (qualified) name(s). Multiple names may be specified as a comma\-separated list or by repeating the option. .HP \fB\-help\fR, \fB\-\-help\fR .IP Print castxml and internal Clang compiler usage information .HP \fB\-o\fR .IP Write output to .HP \fB\-\-version\fR .IP Print castxml and internal Clang compiler version information .PP Help for the internal Clang compiler appears below. .PP \fB\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\fR .PP OVERVIEW: clang LLVM compiler .PP USAGE: clang [options] file... .SS "OPTIONS:" .TP \-### Print (but do not run) the commands to run for this compilation .TP \fB\-\-amdgpu\-arch\-tool=\fR Tool used for detecting AMD GPU arch in the system. .TP \fB\-\-analyzer\-output\fR Static analyzer report output format (html|plist|plist\-multi\-file|plist\-html|sarif|sarif\-html|text). .TP \fB\-\-analyze\fR Run the static analyzer .TP \fB\-arcmt\-migrate\-emit\-errors\fR Emit ARC errors even if the migrator can fix them .TP \fB\-arcmt\-migrate\-report\-output\fR Output path for the plist report .TP \fB\-B\fR Search $prefix$file for executables, libraries, and data files. If $prefix is a directory, search $prefix/$file .TP \fB\-b\fR Pass \fB\-b\fR to the linker on AIX .TP \fB\-CC\fR Include comments from within macros in preprocessed output .TP \fB\-cl\-denorms\-are\-zero\fR OpenCL only. Allow denormals to be flushed to zero. .TP \fB\-cl\-ext=\fR OpenCL only. Enable or disable OpenCL extensions/optional features. The argument is a comma\-separated sequence of one or more extension names, each prefixed by '+' or '\-'. .TP \fB\-cl\-fast\-relaxed\-math\fR OpenCL only. Sets \fB\-cl\-finite\-math\-only\fR and \fB\-cl\-unsafe\-math\-optimizations\fR, and defines __FAST_RELAXED_MATH__. .TP \fB\-cl\-finite\-math\-only\fR OpenCL only. Allow floating\-point optimizations that assume arguments and results are not NaNs or +\-Inf. .TP \fB\-cl\-fp32\-correctly\-rounded\-divide\-sqrt\fR OpenCL only. Specify that single precision floating\-point divide and sqrt used in the program source are correctly rounded. .TP \fB\-cl\-kernel\-arg\-info\fR OpenCL only. Generate kernel argument metadata. .TP \fB\-cl\-mad\-enable\fR OpenCL only. Allow use of less precise MAD computations in the generated binary. .TP \fB\-cl\-no\-signed\-zeros\fR OpenCL only. Allow use of less precise no signed zeros computations in the generated binary. .TP \fB\-cl\-no\-stdinc\fR OpenCL only. Disables all standard includes containing non\-native compiler types and functions. .TP \fB\-cl\-opt\-disable\fR OpenCL only. This option disables all optimizations. By default optimizations are enabled. .TP \fB\-cl\-single\-precision\-constant\fR OpenCL only. Treat double precision floating\-point constant as single precision constant. .TP \fB\-cl\-std=\fR OpenCL language standard to compile for. .TP \fB\-cl\-strict\-aliasing\fR OpenCL only. This option is added for compatibility with OpenCL 1.0. .TP \fB\-cl\-uniform\-work\-group\-size\fR OpenCL only. Defines that the global work\-size be a multiple of the work\-group size specified to clEnqueueNDRangeKernel .TP \fB\-cl\-unsafe\-math\-optimizations\fR OpenCL only. Allow unsafe floating\-point optimizations. Also implies \fB\-cl\-no\-signed\-zeros\fR and \fB\-cl\-mad\-enable\fR. .TP \fB\-\-config=\fR Specify configuration file .TP \fB\-\-cuda\-compile\-host\-device\fR Compile CUDA code for both host and device (default). Has no effect on non\-CUDA compilations. .TP \fB\-\-cuda\-device\-only\fR Compile CUDA code for device only .TP \fB\-\-cuda\-feature=\fR Manually specify the CUDA feature to use .TP \fB\-\-cuda\-host\-only\fR Compile CUDA code for host only. Has no effect on non\-CUDA compilations. .TP \fB\-\-cuda\-include\-ptx=\fR Include PTX for the following GPU architecture (e.g. sm_35) or 'all'. May be specified more than once. .TP \fB\-\-cuda\-noopt\-device\-debug\fR Enable device\-side debug info generation. Disables ptxas optimizations. .TP \fB\-\-cuda\-path\-ignore\-env\fR Ignore environment variables to detect CUDA installation .TP \fB\-\-cuda\-path=\fR CUDA installation path .TP \fB\-cuid=\fR An ID for compilation unit, which should be the same for the same compilation unit but different for different compilation units. It is used to externalize device\-side static variables for single source offloading languages CUDA and HIP so that they can be accessed by the host code of the same compilation unit. .TP \fB\-cxx\-isystem\fR Add directory to the C++ SYSTEM include search path .TP \fB\-C\fR Include comments in preprocessed output .TP \fB\-c\fR Only run preprocess, compile, and assemble steps .TP \fB\-darwin\-target\-variant\-triple\fR Specify the darwin target variant triple .TP \fB\-darwin\-target\-variant\fR Generate code for an additional runtime variant of the deployment target .TP \fB\-dD\fR Print macro definitions in \fB\-E\fR mode in addition to normal output .HP \fB\-dependency\-dot\fR Filename to write DOT\-formatted header dependencies to .TP \fB\-dependency\-file\fR Filename (or \-) to write dependency output to .TP \fB\-dI\fR Print include directives in \fB\-E\fR mode in addition to normal output .TP \fB\-dM\fR Print macro definitions in \fB\-E\fR mode instead of normal output .TP \fB\-dsym\-dir\fR Directory to output dSYM's (if any) to .TP \fB\-dumpdir\fR Use as a prefix to form auxiliary and dump file names .TP \fB\-D\fR = Define to (or 1 if omitted) .TP \fB\-emit\-ast\fR Emit Clang AST files for source inputs .TP \fB\-emit\-interface\-stubs\fR Generate Interface Stub Files. .TP \fB\-emit\-llvm\fR Use the LLVM representation for assembler and object files .TP \fB\-emit\-merged\-ifs\fR Generate Interface Stub Files, emit merged text not binary. .TP \fB\-\-emit\-static\-lib\fR Enable linker job to emit a static library. .TP \fB\-\-emit\-symbol\-graph=\fR Generate Extract API information as a side effect of compilation. .TP \fB\-\-end\-no\-unused\-arguments\fR Start emitting warnings for unused driver arguments .TP \fB\-\-extract\-api\-ignores=\fR Comma separated list of files containing a new line separated list of API symbols to ignore when extracting API information. .TP \fB\-extract\-api\fR Extract API information .TP \fB\-E\fR Only run the preprocessor .TP \fB\-faapcs\-bitfield\-load\fR Follows the AAPCS standard that all volatile bit\-field write generates at least one load. (ARM only). .TP \fB\-faapcs\-bitfield\-width\fR Follow the AAPCS standard requirement stating that volatile bit\-field width is dictated by the field container type. (ARM only). .TP \fB\-faddrsig\fR Emit an address\-significance table .TP \fB\-falign\-loops=\fR N must be a power of two. Align loops to the boundary .TP \fB\-faligned\-allocation\fR Enable C++17 aligned allocation functions .TP \fB\-fallow\-editor\-placeholders\fR Treat editor placeholders as valid source code .TP \fB\-faltivec\-src\-compat=\fR Source\-level compatibility for Altivec vectors (for PowerPC targets). This includes results of vector comparison (scalar for 'xl', vector for 'gcc') as well as behavior when initializing with a scalar (splatting for 'xl', element zero only for 'gcc'). For 'mixed', the compatibility is as 'gcc' for 'vector bool/vector pixel' and as 'xl' for other types. Current default is 'mixed'. .TP \fB\-fansi\-escape\-codes\fR Use ANSI escape codes for diagnostics .TP \fB\-fapple\-kext\fR Use Apple's kernel extensions ABI .TP \fB\-fapple\-link\-rtlib\fR Force linking the clang builtins runtime library .TP \fB\-fapple\-pragma\-pack\fR Enable Apple gcc\-compatible #pragma pack handling .HP \fB\-fapplication\-extension\fR Restrict code to those available for App Extensions .TP \fB\-fapprox\-func\fR Allow certain math function calls to be replaced with an approximately equivalent calculation .TP \fB\-fasync\-exceptions\fR Enable EH Asynchronous exceptions .TP \fB\-fbasic\-block\-sections=\fR Place each function's basic blocks in unique sections (ELF Only) .TP \fB\-fbinutils\-version=\fR Produced object files can use all ELF features supported by this binutils version and newer. If \fB\-fno\-integrated\-as\fR is specified, the generated assembly will consider GNU as support. 'none' means that all ELF features can be used, regardless of binutils support. Defaults to 2.26. .TP \fB\-fblocks\fR Enable the 'blocks' language feature .TP \fB\-fborland\-extensions\fR Accept non\-standard constructs supported by the Borland compiler .TP \fB\-fbuild\-session\-file=\fR Use the last modification time of as the build session timestamp .TP \fB\-fbuild\-session\-timestamp=\fR