LIBDXCOMPILER.SO:(1)

🦋 libdxcompiler.so: — DirectX Shader Compiler 🦋

okay so bestie, this whole thing comes from the User Commands section of the manual, page 1 — aka LIBDXCOMPILER.SO:(1) ✨ it's the DirectX Shader Compiler and she is lowkey iconic 💅

💖 NAME 💖

libdxcompiler.so: — DirectX Shader Compiler

🌸 DESCRIPTION 🌸

OVERVIEW: HLSL Compiler for Linux

Version: libdxcompiler.so: 1.9(0-00000000)(1.9.2602.0)

USAGE:

dxc.exe [options] <inputs>

---

✨ Common Options ✨

• -help — spills all the available options, the whole tea ☕
• -Qunused-arguments — don't throw a warning at us for unused driver arguments, we're not gonna snitch
• --version — shows off the compiler version info 🎀

🎀 Compilation Options 🎀

• -all-resources-bound — turns on agressive flattening
• -auto-binding-space <value> — sets the auto binding space; this is what enables auto resource binding in libraries
• -Cc — output color coded assembly listings 🌈
• -default-linkage <value> — sets the default linkage for non-shader functions when you're compiling or linking to a library target (values: internal, external)
• -denorm <value> — picks your denormal value options (any, preserve, ftz). any is the default fr
• -disable-payload-qualifiers — turns OFF support for payload access qualifiers for raytracing payloads in SM 6.7
• -D <value> — define a macro
• -enable-16bit-types — enables 16bit types and disables min precision types. available in HLSL 2018 and shader model 6.2
• -enable-lifetime-markers — enables generation of lifetime markers
• -enable-payload-qualifiers — turns ON support for payload access qualifiers for raytracing payloads in SM 6.6
• -encoding <value> — sets the default encoding for source inputs and text outputs (utf8|utf16(win)|utf32(*nix)|wide), default is utf8
• -export-shaders-only — only export shaders when compiling a library
• -exports <value> — specify exports when compiling a library, like: export1[[,export1_clone,...]=internal_name][;...]
• -E <value> — the entry point name
• -Fc <file> — output that assembly code listing file
• -fdiagnostics-format=<value> — select your diagnostic message format. supported values: clang, msvc, mdvc-fallback, vi
• -fdiagnostics-show-option — print the option name alongside mappable diagnostics
• -fdisable-loc-tracking — disables source location tracking in IR. ⚠️ heads up: this will break diagnostic generation for late validation. (it gets ignored if /Zi is passed)
• -Fd <file> — write debug information to the given file, or to an automatically named file in a directory when the name ends in \
• -Fe <file> — send warnings and errors to the given file
• -Fh <file> — output a header file containing object code
• -Fi <file> — set the preprocess output file name (used with /P)
• -flegacy-macro-expansion — expand the operands before doing the token-pasting operation (aka that fxc behavior)
• -flegacy-resource-reservation — reserve unused explicit register assignments for compatibility with shader model 5.0 and below
• -fnew-inlining-behavior — 🧪 experimental option to use heuristics-driven late inlining and disable the alwaysinline annotation for library shaders
• -fno-diagnostics-show-option — do NOT print the option name with mappable diagnostics
• -force-rootsig-ver <profile> — force that root signature version (rootsig_1_1 if omitted)
• -Fo <file> — output object file
• -Fre <file> — output reflection to the given file
• -Frs <file> — output root signature to the given file
• -Fsh <file> — output shader hash to the given file
• -ftime-report — print a time report ⏱️
• -ftime-trace-granularity=<value> — minimum time granularity (in microseconds) traced by the time profiler
• -ftime-trace=<value> — print hierchial time tracing to a file
• -ftime-trace — print hierchial time tracing to stdout
• -Gec — enable backward compatibility mode
• -Ges — enable strict mode
• -Gfa — avoid flow control constructs
• -Gfp — prefer flow control constructs
• -Gis — force IEEE strictness
• -HV <value> — HLSL version (2016, 2017, 2018, 2021). default is 2021
• -H — show header includes and nesting depth
• -ignore-line-directives — ignore line directives
• -I <value> — add a directory to the include search path
• -Lx — output hexadecimal literals
• -Ni — output instruction numbers in assembly listings
• -no-warnings — suppress warnings 🤫
• -No — output instruction byte offsets in assembly listings
• -Odump — print the optimizer commands.
• -Od — disable optimizations
• -pack-optimized — optimize signature packing assuming an identical signature is provided for each connecting stage
• -pack-prefix-stable — (default) pack signatures preserving the prefix-stable property — appended elements will not disturb the placement of prior elements
• -recompile — recompile from a DXIL container with Debug Info or a Debug Info bitcode file
• -res-may-alias — assume that UAVs/SRVs may alias
• -rootsig-define <value> — read the root signature from a #define
• -T <profile> — set the target profile. here's the whole menu, bestie:

<profile>: ps_6_0, ps_6_1, ps_6_2, ps_6_3, ps_6_4, ps_6_5, ps_6_6, ps_6_7, ps_6_8, ps_6_9,

vs_6_0, vs_6_1, vs_6_2, vs_6_3, vs_6_4, vs_6_5, vs_6_6, vs_6_7, vs_6_8, vs_6_9, gs_6_0, gs_6_1, gs_6_2, gs_6_3, gs_6_4, gs_6_5, gs_6_6, gs_6_7, gs_6_8, gs_6_9, hs_6_0, hs_6_1, hs_6_2, hs_6_3, hs_6_4, hs_6_5, hs_6_6, hs_6_7, hs_6_8, hs_6_9, ds_6_0, ds_6_1, ds_6_2, ds_6_3, ds_6_4, ds_6_5, ds_6_6, ds_6_7, ds_6_8, ds_6_9, cs_6_0, cs_6_1, cs_6_2, cs_6_3, cs_6_4, cs_6_5, cs_6_6, cs_6_7, cs_6_8, cs_6_9, lib_6_1, lib_6_2, lib_6_3, lib_6_4, lib_6_5, lib_6_6, lib_6_7, lib_6_8, lib_6_9, ms_6_5, ms_6_6, ms_6_7, ms_6_8, ms_6_9, as_6_5, as_6_6, as_6_7, as_6_8, as_6_9,

• -Vd — disable validation
• -verbose — allow emission of verbose compiler information
• -verify<value> — verify diagnostic output using comment directives
• -Vi — display details about the include process.
• -Vn <name> — use <name> as the variable name in the header file
• -v — alias for -verbose
• -WX — treat warnings as errors 😤
• -Zi — enable debug information. cannot be used together with -Zs
• -Zpc — pack matrices in column-major order
• -Zpr — pack matrices in row-major order
• -Zsb — compute Shader Hash considering only the output binary
• -Zss — compute Shader Hash considering source information
• -Zs — generate a small PDB with just sources and compile options. cannot be used together with -Zi

🌟 OPTIONS 🌟

• -MD — write a file with a .d extension that will hold the list of compilation target dependencies.
• -MF <file> — write the specfied file that will hold the list of compilation target dependencies.
• -M — dumps the list of compilation target dependencies.

🔥 Optimization Options 🔥

• -ffinite-math-only — allow optimizations for floating-point arithmetic that assume arguments and results are not NaNs or +-Infs.
• -fno-finite-math-only — disallow optimizations for floating-point arithmetic that assume arguments and results are not NaNs or +-Infs.
• -O0 — Optimization Level 0
• -O1 — Optimization Level 1
• -O2 — Optimization Level 2
• -O3 — Optimization Level 3 (Default)

🧚 Rewriter Options 🧚

• -decl-global-cb — collect all global constants outside cbuffer declarations into cbuffer GlobalCB { ... }. still experimental 🧪, not all dependency scenarios are handled.
• -extract-entry-uniforms — move uniform parameters from the entry point to global scope
• -global-extern-by-default — set extern on non-static globals
• -keep-user-macro — write out user defines after the rewritten HLSL
• -line-directive — add line directive
• -remove-unused-functions — remove unused functions and types
• -remove-unused-globals — remove unused static globals and functions
• -skip-fn-body — translate function definitions to declarations
• -skip-static — remove static functions and globals when used with -skip-fn-body
• -unchanged — rewrite HLSL, without changes. (she's just standing there, menacingly ✋)

💜 SPIR-V CodeGen Options 💜

• -fspv-debug=<value> — specify a whitelist of debug info category (file -> source -> line, tool, vulkan-with-source)
• -fspv-enable-maximal-reconvergence — enables the MaximallyReconvergesKHR execution mode for this module.
• -fspv-entrypoint-name=<value> — specify the SPIR-V entry point name. defaults to the HLSL entry point name.
• -fspv-extension=<value> — specify a SPIR-V extension permitted to use
• -fspv-flatten-resource-arrays — flatten arrays of resources so each array element takes one binding number
• -fspv-max-id <shift> <space> — set the maximum value for an id in the SPIR-V binary. default is 0x3FFFFF, which is the largest value all drivers must support.
• -fspv-preserve-bindings — preserves all bindings declared within the module, even when those bindings are unused
• -fspv-preserve-interface — preserves all interface variables in the entry point, even when those variables are unused
• -fspv-print-all — print the SPIR-V module before each pass and after the last one. so useful for debugging SPIR-V legalization and optimization passes 🐛
• -fspv-reduce-load-size — replaces loads of composite objects to reduce memory pressure for the loads
• -fspv-reflect — emit additional SPIR-V instructions to aid reflection
• -fspv-target-env=<value> — specify the target environment: vulkan1.0 (default), vulkan1.1, vulkan1.1spirv1.4, vulkan1.2, vulkan1.3, or universal1.5
• -fspv-use-legacy-buffer-matrix-order — assume the legacy matrix order (row major) when accessing raw buffers (e.g., ByteAdddressBuffer)
• -fspv-use-unknown-image-format — for storage images and texel buffers, sets the default format to 'Unknown' when not specified via the vk::image_format attribute. if you don't use this option, the format gets inferred from the resource's data type.
• -fspv-use-vulkan-memory-model — generates SPIR-V modules that use the Vulkan memory model instead of GLSL450.
• -fvk-auto-shift-bindings — apply fvk-*-shift to resources without an explicit register assignment.
• -fvk-b-shift <shift> <space> — specify the Vulkan binding number shift for a b-type register
• -fvk-bind-counter-heap <binding> <set> — specify the Vulkan binding number and set number for the counter heap.

---

okay bestie we are SO not done yet — hold that thought, because part 2 is right there waiting for you 💅✨

okay so we're still in the option list bestie, no we're not stopping, we're gonna finish her 💪 continuing right where we left off:

• -fvk-bind-globals <binding> <set> — sets the Vulkan binding number and the set number for the $Globals cbuffer. two numbers, one job 🎀
• -fvk-bind-register <type-number> <space> <binding> <set> — wanna pin down the Vulkan descriptor set and binding for one specific register? this is the one. it eats four things: type-number, space, binding, set. count them or perish 😭
• -fvk-bind-resource-heap <binding> <set> — Vulkan binding number + set number for the resource heap ✨
• -fvk-bind-sampler-heap <binding> <set> — same deal but for the sampler heap 🎀
• -fvk-invert-y — flips SV_Position.y (negates it, bestie) before it gets written to stage output in VS/DS/GS/MS/Lib, so Vulkan's coordinate system stops being weird about it 🙃
• -fvk-s-shift <shift> <space> — the Vulkan binding number shift for s-type registers 💅
• -fvk-support-nonzero-base-instance — follows the Vulkan spec and uses gl_BaseInstance as the first vertex instance, so SV_InstanceID = gl_InstanceIndex - gl_BaseInstance. and no, without this option it's just SV_InstanceID = gl_InstanceIndex. that difference? iconic 🫶
• -fvk-support-nonzero-base-vertex — same vibe for vertices: follows the Vulkan spec, uses gl_BaseVertex as the first vertex, making SV_VertexID = gl_VertexIndex - gl_BaseVertex. without it? SV_VertexID = gl_VertexIndex. periodt 💜
• -fvk-t-shift <shift> <space> — Vulkan binding number shift for t-type registers ✨
• -fvk-u-shift <shift> <space> — and for u-type registers too, we love a matching set 🌸
• -fvk-use-dx-layout — DirectX memory layout for your Vulkan resources. we're doing it DX style 😎
• -fvk-use-dx-position-w — reciprocates SV_Position.w after reading from stage input in PS, fixing up the whole Vulkan-vs-DirectX situation 🔥
• -fvk-use-gl-layout — strict OpenGL std140/std430 memory layout for Vulkan resources. strict! she said what she said 💅
• -fvk-use-scalar-layout — scalar memory layout for Vulkan resources. simple, clean, main character energy ✨
• -metal — generates Metal code 🍎
• -Oconfig=<value> — takes a comma-separated list of SPIRV-Tools passes so you can customise the optimization configuration. the docs live at http://khr.io/hlsl2spirv#optimization if you wanna read up 📖
• -spirv — generates SPIR-V code 💫

---

✨ Utility Options ✨ (the little helpers, the sidekicks, the icons)

• -dumpbin — loads a binary file instead of compiling. like, just look at it. no compiling today 💀
• -extractrootsignature — pulls the root signature out of shader bytecode. ⚠️ must be used with /Fo <file>, okay? required, not optional 🙈
• -getprivate <file> — saves the private data from a shader blob 🎀
• -link — links the list of libraries you handed over in the <inputs> argument, separated by ';' 🔗
• -P — preprocess to file 📄
• -Qembed_debug — embeds the PDB inside the shader container. ⚠️ must be used with /Zi 🌸
• -Qsource_in_debug_module — embeds the source code inside the PDB 🫶
• -Qstrip_debug — strips the debug info out of 4_0+ shader bytecode. ⚠️ must be used with /Fo <file> 💅
• -Qstrip_priv — strips the private data out of shader bytecode. ⚠️ also must be used with /Fo <file> 🌈
• -Qstrip_reflect — strips the reflection data out of shader bytecode. ⚠️ yep, must be used with /Fo <file> ⭐
• -Qstrip_rootsignature — strips the root signature data out of shader bytecode. ⚠️ must be used with /Fo <file> 🔥
• -setprivate <file> — the private data you want added to the compiled shader blob 💜
• -setrootsignature <file> — attaches a root signature to shader bytecode 🎀
• -verifyrootsignature <file> — verifies shader bytecode against a root signature. vibe check but for your root signature ✅

---

⚠️ Warning Options ⚠️

• -W[no-]<warning> — enables or disables the warning you name. slap a no- in there and it's off instead of on. so -W<warning> turns it on, -Wno-<warning> turns it off 💅

---

🌈 SEE ALSO 🌈

the full documentation for libdxcompiler.so: lives as a Texinfo manual, bestie. so if info and the libdxcompiler.so: programs are properly installed on your system, then this:

info libdxcompiler.so:

is gonna hand you the entire complete manual 🫶 go get it.

---

and that's the whole page, we did it, we actually did it 😭 this was libdxcompiler.so: version 1.9(0-0000000..., dated March 2026 — LIBDXCOMPILER.SO:(1) fr fr. love u, go compile something gorgeous, mwah 💖✨💅