====== clinfo - Ghid complet ======

''clinfo'' este un utilitar de linie de comandă care afișează informații detaliate despre platformele și dispozitivele [[https://www.khronos.org/opencl/|OpenCL]] disponibile în sistem. Este util pentru diagnosticare, depanare și verificarea suportului OpenCL pe GPU-uri, CPU-uri și APU-uri.

===== Ce este OpenCL? =====

OpenCL (Open Computing Language) este un standard deschis pentru programare paralelă pe procesoare heterogene - GPU-uri, CPU-uri și acceleratoare. Este folosit de aplicații precum Darktable, Blender, Kdenlive, HashCat și multe altele pentru a accelera calcule intensive folosind placa video.

===== Instalare =====

==== Debian / Ubuntu / Linux Mint ====

<code bash>
sudo apt install clinfo
</code>

==== Arch Linux / Manjaro ====

<code bash>
sudo pacman -S clinfo
</code>

==== Fedora ====

<code bash>
sudo dnf install clinfo
</code>

===== Utilizare de bază =====

<code bash>
clinfo
</code>

Afișează toate informațiile disponibile despre platformele și dispozitivele OpenCL detectate.

<code bash>
clinfo -l
</code>

Afișează o listă scurtă (//list//) cu platformele și dispozitivele găsite, fără detalii tehnice.

<code bash>
clinfo --human
</code>

Formatează valorile în mod lizibil (ex: ''13107 MB'' în loc de bytes bruti). Acesta este comportamentul implicit.

<code bash>
clinfo --raw
</code>

Afișează valorile brute, fără formatare - util pentru scripturi sau parsing automat.

===== Interpretarea outputului =====

==== Numărul de platforme ====

<code>
Number of platforms: 1
</code>

Indică câte ICD-uri (Installable Client Driver) OpenCL sunt instalate. O valoare de ''0'' înseamnă că nu există niciun driver OpenCL instalat.

==== Informații despre platformă ====

<code>
Platform Version:   OpenCL 2.1 AMD-APP (3581.0)
Platform Name:      AMD Accelerated Parallel Processing
Platform Vendor:    Advanced Micro Devices, Inc.
</code>

^ Câmp ^ Semnificație ^
| Platform Version | Versiunea OpenCL suportată de driver |
| Platform Name | Numele stack-ului OpenCL |
| Platform Vendor | Producătorul driverului |
| Platform Extensions | Extensii suplimentare suportate |

==== Numărul de dispozitive ====

<code>
Number of devices: 0
</code>

Dacă valoarea este ''0'', platforma este detectată dar niciun dispozitiv fizic nu este expus. Cauza obișnuită este lipsa unui driver de kernel corespunzător sau un GPU nesuportat.

==== Informații despre dispozitiv ====

Când un dispozitiv este detectat corect, outputul include:

<code>
Device Name:                  AMD Radeon RX 6600
Device Type:                  GPU
Device Vendor:                Advanced Micro Devices, Inc.
Device Version:               OpenCL 2.0
Driver Version:               3581.0
Max Compute Units:            28
Max Clock Frequency:          2491 MHz
Global Memory Size:           8192 MB
Local Memory Size:            32 KB
Max Work Group Size:          256
</code>

^ Câmp ^ Semnificație ^
| Device Type | CPU, GPU sau Accelerator |
| Max Compute Units | Numărul de unități de procesare paralele |
| Max Clock Frequency | Frecvența maximă a dispozitivului |
| Global Memory Size | Memoria totală disponibilă pentru calcule OpenCL |
| Local Memory Size | Memoria partajată per grup de lucru |
| Max Work Group Size | Dimensiunea maximă a unui work-group |

===== Probleme frecvente =====

==== Number of platforms: 0 ====

Nu este instalat niciun ICD OpenCL. Instalează driverul potrivit:

^ Hardware ^ Pachet de instalat ^
| Intel (iGPU) | ''intel-opencl-icd'' |
| AMD (GPU/APU) | ''mesa-opencl-icd'' sau ROCm |
| NVIDIA | Driver proprietar NVIDIA |
| Orice CPU (fallback) | ''pocl-opencl-icd'' |

Exemplu pentru un sistem cu procesor Intel sau ca fallback pe orice sistem:

<code bash>
sudo apt install pocl-opencl-icd
</code>

==== Number of devices: 0 ====

Platforma e recunoscută dar GPU-ul nu apare. Verifică:

<code bash>
# Verifică ce driver de display este activ
lspci -k | grep -A 3 VGA

# Verifică mesaje din kernel legate de GPU
sudo dmesg | grep -i amd
sudo dmesg | grep -i drm
</code>

Pentru AMD, instalează driverul open-source:

<code bash>
sudo apt install mesa-opencl-icd
</code>

==== Conflict între mai multe ICD-uri ====

Dacă ai mai multe ICD-uri instalate și vrei să vezi toate platformele:

<code bash>
clinfo -l
</code>

Lista ICD-urilor instalate se găsește în:

<code bash>
ls /etc/OpenCL/vendors/
</code>

===== Exemple practice =====

==== Verificare rapidă suport OpenCL ====

<code bash>
clinfo -l
</code>

Output de succes:

<code>
Platform #0: AMD Accelerated Parallel Processing
 `-- Device #0: gfx1032
Platform #1: Portable Computing Language
 `-- Device #0: pthread-AMD Ryzen 5 5600G
</code>

==== Salvarea outputului complet într-un fișier ====

<code bash>
clinfo > clinfo_output.txt
</code>

Util pentru raportarea problemelor pe forumuri sau comunități de suport.

==== Verificarea versiunii OpenCL suportate ====

<code bash>
clinfo | grep "Platform Version"
</code>

==== Verificarea memoriei GPU disponibile pentru OpenCL ====

<code bash>
clinfo | grep "Global Memory Size"
</code>

===== Resurse utile =====

  * [[https://github.com/Oblomov/clinfo|Pagina oficială clinfo pe GitHub]]
  * [[https://www.khronos.org/opencl/|Specificații OpenCL - Khronos Group]]
  * [[https://rocm.docs.amd.com/|Documentație ROCm pentru AMD]]

{{tag>clinfo opencl fedora arch ubuntu}}