====== 2.1 Clonare il Repository GitHub ======

Questa pagina spiega come scaricare il codice sorgente OpenSSL da GitHub.

----

===== Cos'è Git? =====

**Git** è un sistema di controllo versione. Memorizza:
  * Tutte le versioni di un progetto
  * Chi ha cambiato cosa e quando
  * "Tag" per versioni importanti (es. v3.6.0)

**GitHub** è un sito web che ospita repository Git.

----

===== Preparare la Struttura del Progetto =====

Prima creiamo una struttura di cartelle sensata:

<code powershell>
# Creare la cartella principale
mkdir D:\Projects\openssl-3.6.0

# Creare le sottocartelle
mkdir D:\Projects\openssl-3.6.0\src   # Qui va il codice sorgente
mkdir D:\Projects\openssl-3.6.0\bin   # Qui vanno i file compilati
</code>

Risultato:
<code>
D:\Projects\openssl-3.6.0\
├── src\    # Codice sorgente OpenSSL (da GitHub)
└── bin\    # Destinazione per i binari compilati
</code>

----

===== Clonare OpenSSL =====

==== Opzione A: Solo tag v3.6.0 (consigliato) ====

<code powershell>
cd D:\Projects\openssl-3.6.0
git clone --depth 1 --branch openssl-3.6.0 https://github.com/openssl/openssl.git src
</code>

**Spiegazione dei parametri:**
| Parametro | Significato |
|-----------|-------------|
| ''--depth 1'' | Solo l'ultima versione (risparmia ~500 MB!) |
| ''--branch openssl-3.6.0'' | Il tag per la versione 3.6.0 |
| ''src'' | Cartella di destinazione |

==== Opzione B: Repository completo ====

Se volete provare versioni diverse:

<code powershell>
cd D:\Projects\openssl-3.6.0
git clone https://github.com/openssl/openssl.git src
cd src
git checkout openssl-3.6.0
</code>

<WRAP info>
Il repository completo è circa 500 MB. Con ''--depth 1'' solo ~50 MB.
</WRAP>

----

===== Verificare la Versione =====

<code powershell>
cd D:\Projects\openssl-3.6.0\src

# Mostrare il tag corrente
git describe --tags
# Output atteso: openssl-3.6.0

# Oppure: Mostrare info commit
git log -1 --oneline
</code>

----

===== Problemi Comuni =====

==== "git is not recognized" ====

Git non è installato o non è nel PATH:

<code powershell>
winget install Git.Git
</code>

Dopo l'installazione: Aprire un nuovo terminale.

==== Il firewall blocca GitHub ====

Se siete dietro un firewall aziendale:

<code powershell>
# Impostare il proxy (se necessario)
git config --global http.proxy http://proxy.azienda.it:8080
git config --global https.proxy http://proxy.azienda.it:8080
</code>

----

===== Continua con =====

  * [[.:build:start|3. Compilazione]]

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