Process crashes in IronPdf.Installation.Initialize when debugging on Linux

[emz00]

Description

When running IronPdf.Installation.Initialize(), which calls some native code, under the debugger on Linux it crashes the process. This happens in both Rider 2025.3.1 and VS Code 1.109.5

Reproduction Steps

Create a C# project referencing the IronPdf.Linux package:

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="IronPdf.Linux" Version="2025.12.2" />
  </ItemGroup>
</Project>

Program.cs:

Console.WriteLine("IronPdf initializing...");
IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = false;
//IronPdf.Installation.SingleProcess = true; // No crash with this!
IronPdf.Installation.Initialize(); // crashes here when running under the debugger (in VSCode or Rider) on Linux!
Console.WriteLine("IronPdf initialized!");

Start debugging this program in either VS Code or Rider (F5).

Expected behavior

The program runs to completion and prints "IronPdf initialized!"

Actual behavior

The program crashes in the Installation.Initialize() call. syslog contains:

2026-03-06T11:34:33.012996+01:00 abcd systemd-coredump[60037]: Process 59964 (IronPdfDebug) of user 1000 dumped core.

Module IronPdfDebug/bin/Debug/net10.0/runtimes/linux-x64/native/qpdf.so without build-id.
Module IronPdfDebug/bin/Debug/net10.0/runtimes/linux-x64/native/qpdf.so
Module libzstd.so.1 from deb libzstd-1.5.5+dfsg2-2build1.1.amd64
Module libsystemd.so.0 from deb systemd-255.4-1ubuntu8.12.amd64
Module libgcc_s.so.1 from deb gcc-14-14.2.0-4ubuntu2~24.04.1.amd64
Module libstdc++.so.6 from deb gcc-14-14.2.0-4ubuntu2~24.04.1.amd64
Stack trace of thread 60021:
#0  0x0000702832c3d0e1 n/a (n/a + 0x0)
#1  0x000070184e8dbe54 n/a (IronPdfDebug/bin/Debug/net10.0/runtimes/linux-x64/native/IronInterop.so + 0xdbe54)
#2  0x0000701824000000 n/a (n/a + 0x0)
ELF object binary architecture: AMD x86-64

Regression?

No response

Known Workarounds

If run without debugging it runs successfully.
It also does not crash if I set Isntallation.SingleProcess = true, which "forces IronPdf to run as a single process" according to the vendor.

Configuration

 dotnet --info
.NET SDK:
 Version:           10.0.103
 Commit:            c2435c3e0f
 Workload version:  10.0.100-manifests.a62d7899
 MSBuild version:   18.0.11+c2435c3e0

Runtime Environment:
 OS Name:     linuxmint
 OS Version:  22.3
 OS Platform: Linux
 RID:         ubuntu.24.04-x64
 Base Path:   /usr/lib/dotnet/sdk/10.0.103/

.NET workloads installed:
There are no installed workloads to display.
Configured to use workload sets when installing new manifests.
No workload sets are installed. Run "dotnet workload restore" to install a workload set.

Host:
  Version:      10.0.3
  Architecture: x64
  Commit:       c2435c3e0f

.NET SDKs installed:
  8.0.124 [/usr/lib/dotnet/sdk]
  10.0.103 [/usr/lib/dotnet/sdk]

Other information

I have reported this to JetBrains and to Iron Software (the IronPdf vendor). They say that this may be related to #34964 however that issue is about mixed-mode debugging, which is not currently supported by Rider 2025.3 (it's a preview feature, which I have not enabled) nor by VS Code, as far as I can tell.

[dotnet-policy-service]

Tagging subscribers to this area: @steveisok, @tommcdon, @dotnet/dotnet-diag
See info in area-owners.md if you want to be subscribed.