====== Risoluzione Problemi ======

Qui troverete soluzioni per i problemi comuni durante la compilazione di OpenSSL.

----

===== Errori di Compilazione =====

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

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

**Causa:** Windows SDK non installato o non nel PATH.

**Soluzione:**

<code powershell>
# Opzione 1: Installare Windows SDK
winget install Microsoft.WindowsSDK.10.0.22621

# Opzione 2: Nel Visual Studio Installer
# → "Individual Components" → selezionare "Windows 10 SDK"
</code>

Poi: Ricaricare l'ambiente Visual Studio:

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

----

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

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

**Causa:** Perl non installato o non nel PATH.

**Soluzione:**

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

# Impostare PATH manualmente (se ancora non trovato dopo il riavvio)
set PATH=C:\Strawberry\perl\bin;%PATH%
</code>

----

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

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

**Causa:** NASM non installato o non nel PATH.

**Soluzione A: Installare NASM (consigliato)**

<code powershell>
winget install NASM.NASM

# Impostare PATH (il percorso può variare!)
set PATH=%LOCALAPPDATA%\bin\NASM;%PATH%

# Verificare
nasm -v
</code>

**Soluzione B: Compilare senza NASM (più lento)**

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

<WRAP important>
Senza NASM, AES e SHA sono significativamente più lenti!
</WRAP>

----

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

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

**Causa:** Ambiente Visual Studio non caricato.

**Soluzione:**

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

<WRAP tip>
**Suggerimento:** Avviate sempre "Developer Command Prompt for VS 2022" dal menu Start - l'ambiente è già caricato.
</WRAP>

----

===== Problemi PowerShell =====

==== "cl.exe causa errore nonostante il successo" ====

**Sintomo:** Lo script PowerShell si interrompe anche se ''cl.exe'' funziona.

**Causa:** ''cl.exe'' scrive informazioni sulla versione su stderr, che viene interpretato come errore con ''$ErrorActionPreference = "Stop"''.

**Soluzione nello script:**

<code powershell>
# Gestire correttamente l'output di cl.exe
try {
    $clOutput = & cl 2>&1 | Out-String
    Write-Host "cl.exe trovato"
} catch {
    Write-Host "cl.exe trovato (stderr ignorato)"
}
</code>

----

===== Problemi di Runtime =====

==== "DLL not found" all'avvio del programma ====

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

**Soluzione:**

1. Copiare le DLL nella cartella dell'applicazione:
<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. Oppure copiare automaticamente nel .csproj:
<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 non disponibile" ====

**Sintomo:**
<code>
openssl list -signature-algorithms | findstr mldsa
# Nessun output
</code>

**Possibili cause:**

1. **Versione OpenSSL errata** - Richiede 3.6.0 o superiore
<code powershell>
openssl version
# Deve essere: OpenSSL 3.6.0 o superiore
</code>

2. **Provider non caricato**
<code powershell>
openssl list -providers
# Dovrebbe mostrare "default" ed eventualmente "oqsprovider"
</code>

----

===== Ulteriore Aiuto =====

Se il vostro problema non è elencato qui:

  * [[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//