====== Rješavanje Problema ======

Ovdje ćete pronaći rješenja za česte probleme prilikom kompilacije OpenSSL-a.

----

===== Greške pri Kompilaciji =====

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

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

**Uzrok:** Windows SDK nije instaliran ili nije u PATH-u.

**Rješenje:**

<code powershell>
# Opcija 1: Instalirajte Windows SDK
winget install Microsoft.WindowsSDK.10.0.22621

# Opcija 2: U Visual Studio Installeru
# → "Individual Components" → odaberite "Windows 10 SDK"
</code>

Zatim: Ponovno učitajte Visual Studio okruženje:

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

----

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

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

**Uzrok:** Perl nije instaliran ili nije u PATH-u.

**Rješenje:**

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

# Ručno postavite PATH (ako još uvijek nije pronađen nakon ponovnog pokretanja)
set PATH=C:\Strawberry\perl\bin;%PATH%
</code>

----

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

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

**Uzrok:** NASM nije instaliran ili nije u PATH-u.

**Rješenje A: Instalirajte NASM (preporučeno)**

<code powershell>
winget install NASM.NASM

# Postavite PATH (putanja može varirati!)
set PATH=%LOCALAPPDATA%\bin\NASM;%PATH%

# Provjerite
nasm -v
</code>

**Rješenje B: Kompilirajte bez NASM-a (sporije)**

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

<WRAP important>
Bez NASM-a, AES i SHA su značajno sporiji!
</WRAP>

----

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

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

**Uzrok:** Visual Studio okruženje nije učitano.

**Rješenje:**

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

<WRAP tip>
**Savjet:** Uvijek pokrenite "Developer Command Prompt for VS 2022" iz Start izbornika - okruženje je već učitano.
</WRAP>

----

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

==== "cl.exe uzrokuje grešku unatoč uspjehu" ====

**Simptom:** PowerShell skripta se prekida iako ''cl.exe'' radi.

**Uzrok:** ''cl.exe'' piše informacije o verziji na stderr, što se interpretira kao greška s ''$ErrorActionPreference = "Stop"''.

**Rješenje u skripti:**

<code powershell>
# Ispravno rukujte cl.exe izlazom
try {
    $clOutput = & cl 2>&1 | Out-String
    Write-Host "cl.exe pronađen"
} catch {
    Write-Host "cl.exe pronađen (stderr ignoriran)"
}
</code>

----

===== Problemi u Izvršavanju =====

==== "DLL not found" pri pokretanju programa ====

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

**Rješenje:**

1. Kopirajte DLL datoteke u mapu aplikacije:
<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. Ili automatski kopirajte u .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 nije dostupan" ====

**Simptom:**
<code>
openssl list -signature-algorithms | findstr mldsa
# Nema izlaza
</code>

**Mogući uzroci:**

1. **Pogrešna verzija OpenSSL-a** - Potrebna je 3.6.0 ili novija
<code powershell>
openssl version
# Mora biti: OpenSSL 3.6.0 ili noviji
</code>

2. **Provider nije učitan**
<code powershell>
openssl list -providers
# Trebao bi pokazati "default" i eventualno "oqsprovider"
</code>

----

===== Daljnja Pomoć =====

Ako vaš problem nije ovdje naveden:

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