====== Troubleshooting ======

Hier finden Sie Lösungen für häufige Probleme beim OpenSSL Build.

----

===== Build-Fehler =====

==== "stdlib.h not found" oder "windows.h not found" ====

**Symptom:**
<code>
fatal error C1083: Cannot open include file: 'stdlib.h': No such file or directory
</code>

**Ursache:** Windows SDK nicht installiert oder nicht im Pfad.

**Lösung:**

<code powershell>
# Option 1: Windows SDK installieren
winget install Microsoft.WindowsSDK.10.0.22621

# Option 2: In Visual Studio Installer
# → "Einzelne Komponenten" → "Windows 10 SDK" auswählen
</code>

Dann: Visual Studio Umgebung neu laden:

<code batch>
call "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat"
</code>

----

==== "perl is not recognized" ====

**Symptom:**
<code>
'perl' is not recognized as an internal or external command
</code>

**Ursache:** Perl nicht installiert oder nicht im PATH.

**Lösung:**

<code powershell>
# Perl installieren
winget install StrawberryPerl.StrawberryPerl

# PATH manuell setzen (falls nach Neustart immer noch nicht gefunden)
set PATH=C:\Strawberry\perl\bin;%PATH%
</code>

----

==== "NASM not found" ====

**Symptom:**
<code>
NASM not found - please read INSTALL.md
</code>

**Ursache:** NASM nicht installiert oder nicht im PATH.

**Lösung A: NASM installieren (empfohlen)**

<code powershell>
winget install NASM.NASM

# PATH setzen (Pfad kann variieren!)
set PATH=%LOCALAPPDATA%\bin\NASM;%PATH%

# Prüfen
nasm -v
</code>

**Lösung B: Ohne NASM bauen (langsamer)**

<code batch>
perl Configure VC-WIN64A no-asm --prefix=D:\Projects\openssl-3.6.0\bin
</code>

<WRAP important>
Ohne NASM sind AES und SHA deutlich langsamer!
</WRAP>

----

==== "cl.exe not found" ====

**Symptom:**
<code>
'cl' is not recognized as an internal or external command
</code>

**Ursache:** Visual Studio Umgebung nicht geladen.

**Lösung:**

<code batch>
call "C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat"
</code>

<WRAP tip>
**Tipp:** Starten Sie immer mit der "Developer Command Prompt for VS 2022" aus dem Startmenü - dort ist die Umgebung bereits geladen.
</WRAP>

----

==== "nmake hängt bei 'nmake clean'" ====

**Symptom:** ''nmake clean'' antwortet nicht oder bricht mit Fehler ab.

**Ursache:** Bekanntes Problem bei vorherigen fehlgeschlagenen Builds.

**Lösung:**

<code batch>
# Makefile manuell löschen
del makefile

# Neu konfigurieren
perl Configure VC-WIN64A --prefix=D:\Projects\openssl-3.6.0\bin

# Neu bauen
nmake
</code>

----

==== "LNK1181: cannot open input file '*.obj'" ====

**Symptom:**
<code>
LINK : fatal error LNK1181: cannot open input file 'crypto\aes\aes-x86_64.obj'
</code>

**Ursache:** Vorheriger Build fehlgeschlagen, Objektdateien fehlen.

**Lösung:**

<code batch>
# Alles löschen und neu starten
del makefile
nmake clean 2>nul
perl Configure VC-WIN64A --prefix=D:\Projects\openssl-3.6.0\bin
nmake
</code>

----

===== PowerShell-Probleme =====

==== "cl.exe verursacht Fehler trotz Erfolg" ====

**Symptom:** PowerShell-Skript bricht ab, obwohl ''cl.exe'' funktioniert.

**Ursache:** ''cl.exe'' schreibt Versionsinformationen nach stderr, was bei ''$ErrorActionPreference = "Stop"'' als Fehler interpretiert wird.

**Lösung im Skript:**

<code powershell>
# cl.exe Ausgabe richtig behandeln
try {
    $clOutput = & cl 2>&1 | Out-String
    Write-Host "cl.exe gefunden"
} catch {
    Write-Host "cl.exe gefunden (stderr ignoriert)"
}
</code>

----

==== "Execution Policy verhindert Skript" ====

**Symptom:**
<code>
File D:\...\build_openssl.ps1 cannot be loaded because running scripts is disabled
</code>

**Lösung:**

<code powershell>
# Option 1: Für diese Session erlauben
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

# Option 2: Beim Aufruf umgehen
powershell.exe -ExecutionPolicy Bypass -File "build_openssl.ps1"
</code>

----

===== Laufzeit-Probleme =====

==== "DLL not found" bei Programmstart ====

**Symptom:**
<code>
The program can't start because libcrypto-3-x64.dll is missing
</code>

**Lösung:**

1. DLLs in den Anwendungsordner kopieren:
<code powershell>
copy D:\Projects\openssl-3.6.0\bin\bin\libcrypto-3-x64.dll .\
copy D:\Projects\openssl-3.6.0\bin\bin\libssl-3-x64.dll .\
</code>

2. Oder in .csproj automatisch kopieren:
<code xml>
<ItemGroup>
  <None Update="libcrypto-3-x64.dll">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
  <None Update="libssl-3-x64.dll">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
</ItemGroup>
</code>

----

==== "ML-DSA/ML-KEM nicht verfügbar" ====

**Symptom:**
<code>
openssl list -signature-algorithms | findstr mldsa
# Keine Ausgabe
</code>

**Mögliche Ursachen:**

1. **Falsche OpenSSL-Version** - Benötigt 3.6.0 oder neuer
<code powershell>
openssl version
# Muss sein: OpenSSL 3.6.0 oder höher
</code>

2. **Provider nicht geladen**
<code powershell>
openssl list -providers
# Sollte "default" und eventuell "oqsprovider" zeigen
</code>

----

==== "FIPS provider not available" ====

**Symptom:**
<code>
openssl list -providers
# Zeigt kein "fips"
</code>

**Lösung:**

1. Wurde mit ''enable-fips'' gebaut?
<code batch>
perl Configure VC-WIN64A enable-fips --prefix=...
nmake
nmake install_sw install_fips
</code>

2. Ist ''openssl.cnf'' korrekt konfiguriert?
<code ini>
# In openssl.cnf:
[openssl_init]
providers = provider_sect

[provider_sect]
fips = fips_sect
base = base_sect

[fips_sect]
activate = 1

[base_sect]
activate = 1
</code>

----

===== Netzwerk-Probleme =====

==== "Git clone schlägt fehl" ====

**Symptom:** Timeout oder Verbindungsfehler bei ''git clone''.

**Lösung für Unternehmens-Proxy:**

<code powershell>
# Proxy konfigurieren
git config --global http.proxy http://proxy.firma.de:8080
git config --global https.proxy http://proxy.firma.de:8080
</code>

**Lösung für SSL-Zertifikatfehler:**

<code powershell>
# Temporär SSL-Prüfung deaktivieren (nur für Download!)
git config --global http.sslVerify false

# Nach Download wieder aktivieren
git config --global http.sslVerify true
</code>

----

===== Weitere Hilfe =====

Falls Ihr Problem hier nicht aufgeführt ist:

  * [[https://github.com/openssl/openssl/blob/master/NOTES-WINDOWS.md|OpenSSL Windows Notes]]
  * [[https://github.com/openssl/openssl/issues|OpenSSL GitHub Issues]]
  * [[https://stackoverflow.com/questions/tagged/openssl|StackOverflow OpenSSL]]

----
//Wolfgang van der Stille @ EMSR DATA d.o.o. - Post-Quantum Cryptography Professional//