INFO::pcLibSql modifié par Claude

De wiki_pcwiki2
Aller à la navigationAller à la recherche

pcLibSql V8.99

Répertoire : pcLibSql/V8.99.claude
Version : V8.99 (V8.97 dans le makefile / les binaires livrés)
Langage : C++ (style pré-C++11 : char *, strdup/free, snprintf sur buffers fixes)
Auteur : Patrick Chevalier — PCStreet SAS (1997-2013)
Date de cette fiche : 2026-07-20

But

pcLibSql est une bibliothèque C++ (libpcstreetSqlV8.a / .so) qui encapsule l'accès à MySQL/MariaDB via la bibliothèque externe libmysqlwrapped (classes Database/Query, non incluses dans ce dépôt). Une classe de base (ClassSgbd) fournit les opérations SQL génériques (connexion, création/suppression de base et de table, insertion, update, delete, exécution de requête libre), et une dizaine de classes dérivées spécialisent cet accès pour chaque domaine métier de PCStreet SAS : sauvegarde de comptes (Outbackup/Obodata), administration DNS (PowerDNS), suivi de positionnement Google, gestion d'alias mail (Exim), inventaire physique (Locator).

Cette bibliothèque est consommée par d'autres programmes de l'atelier PCStreet (ex. pcLianLi, InBackup2) qui incluent ses en-têtes depuis /home/local/include/pcstreet/ — répertoire d'installation partagé, distinct de ce dépôt git, dans lequel les .h doivent être recopiés après modification pour que les autres projets voient les changements.

Modules

Classe Fichier Hérite de Rôle
ClassSgbd ClassSgbd.cpp/h ClassMotherOfTheLib Classe de base : connexion MySQL, CRUD SQL générique via concaténation de requêtes, buffer de requête fixe (8192 octets)
ClassSgbd2 ClassSgbd2.cpp/h ClassSgbd Tentative de wrapper plus générique (définition de structure de table, WHERE paramétrable) ; travail inachevé (cf. correctifs)
ClassSgbdDerivedForObodata ClassSgbdDerivedForObodata.cpp/h ClassSgbd Le plus gros module (~7200 lignes) : gestion complète des comptes de sauvegarde Outbackup (comptes, sites, entreprises, distributeurs, disques, volumétrie, versionning, favoris, utilisateurs)
ClassSgbdDerivedForObodataVerify ClassSgbdDerivedForObodataVerify.cpp/h ClassSgbd Calcul de statistiques et vérification de cohérence des volumes de sauvegarde par compte/site/entreprise/distributeur/disque
ClassSgbdDerivedForPowerAdmin ClassSgbdDerivedForPowerAdmin.cpp/h ClassSgbd Administration de zones DNS PowerDNS (enregistrements, SOA, serial, priorités MX/TXT)
ClassInBackup2 ClassInBackup2.cpp/h ClassSgbdDerivedForPowerAdmin CRUD (partiel — seul le Read est implémenté) de la zone DNS maître d'un contrat inbackup.fr
ClassSgbdDerivedForPcGoogleSearch ClassSgbdDerivedForPcGoogleSearch.cpp/h ClassSgbd, ClassLibHost Suivi de positionnement Google (mots-clés, URLs, classements, scores, export CSV pour Highcharts)
ClassSgbdDerivedForPcGoogleSearch2 ClassSgbdDerivedForPcGoogleSearch2.cpp/h ClassSgbd, ClassLibHost Quasi-copie (~95 % identique) de la classe précédente, avec quelques évolutions
ClassSgbdDerivedForExim ClassSgbdDerivedForExim.cpp/h ClassSgbd Gestion des alias mail Exim (lecture des alias hors domaine, ajout d'alias) — ne sait pas créer une DNS, seulement modifier une base d'alias existante
ClassSgbdDerivedForLocator ClassSgbdDerivedForLocator.cpp/h ClassSgbd Insertion dans un inventaire physique (zone/pièce/localisation/boîte/contenu)
ClassSgbdDerived ClassSgbdDerived.cpp ClassSgbd Exemple de squelette de classe dérivée, compilé uniquement sous #ifdef JUSTE_POUR_L_EXEMPLE (jamais actif en pratique)

Architecture technique

  • Aucune requête préparée : toutes les requêtes SQL sont construites par concaténation de chaînes (snprintf avec %s, ou += sur std::string).
  • Buffer de requête fixe ___strQuery_8192[8192] dans ClassSgbd : une requête plus longue est tronquée silencieusement par snprintf (pas de dépassement mémoire, mais requête invalide sans avertissement).
  • Certaines opérations d'administration (fnCreateSgbd, fnDeleteSgbd, fnCreateTable) invoquent le client mysql/mysqladmin via system() plutôt que l'API SQL.
  • Le makefile ne fixe aucun -std=c++17 explicite (standard C++ du compilateur par défaut) et masque les avertissements avec -Wno-unused.
  • Compilation testée dans cet environnement avec : make -f makefile (dépend de libmysqlwrapped.h et des en-têtes pcstreet installés dans /home/local/include/).

Audit et correctifs du 2026-07-20

Un audit complet du code (~16 300 lignes) a été mené à la demande de l'utilisateur, avec relecture manuelle du socle (ClassSgbd, ClassSgbd2) et des petites classes, complétée par trois revues automatisées ciblées sur les plus gros fichiers (ClassSgbdDerivedForObodata.cpp, ClassSgbdDerivedForPcGoogleSearch(2).cpp, ClassSgbdDerivedForPowerAdmin.cpp / ClassSgbdDerivedForObodataVerify.cpp). Chaque correctif retenu ci-dessous a été vérifié manuellement dans le code source avant modification, puis validé par une compilation réelle (make -f makefile, plus compilation individuelle de ClassSgbd2.cpp et ClassSgbdDerivedForPcGoogleSearch2.cpp qui ne font pas partie de la lib principale) : build et link réussis sans nouvelle erreur ni nouveau warning.

Bugs mémoire / crash corrigés

Fichier Fonction Problème Correctif
ClassSgbd.cpp fnOpenSgbd() Fuite mémoire sur ___mySgbd à chaque tentative de connexion échouée (bug documenté depuis des années dans le commentaire du fichier, jamais traité) Ajout de delete ___mySgbd; ___mySgbd = NULL; avant de retenter la connexion
ClassSgbdDerivedForPowerAdmin.cpp Constructeurs + setName/setDomain/destructeur _strName/_strDomainForCopy jamais initialisés à NULL avant leur premier test (lecture de pointeur indéterminé, puis delete[] dessus) ; allocation via strdup (malloc) libérée par delete[] (UB) ; 3 buffers jamais libérés dans le destructeur Initialisation à NULL dans les deux constructeurs, remplacement de delete[] par free(), ajout des free() manquants dans le destructeur
ClassSgbdDerivedForPcGoogleSearch.cpp/h
ClassSgbdDerivedForPcGoogleSearch2.cpp/h
getdblNbPointsOfThisDay() Retourne une référence (double &) sur une variable locale : référence pendante dès le retour de fonction Type de retour changé en double (retour par valeur) dans les 2 .h et les 2 .cpp
ClassSgbdDerivedForPcGoogleSearch.cpp
ClassSgbdDerivedForPcGoogleSearch2.cpp
échappement des mots-clés (l.711 / l.676) Faute de frappe : "\'" (un simple caractère quote) au lieu de "\\'" — l'échappement anti-injection était un no-op Correction en "\\'", conforme au même échappement utilisé correctement ailleurs dans les mêmes fichiers
ClassSgbdDerivedForObodata.cpp getstringAssociatedServerObo(string&) Écriture hors-borne : cast const char*→char* sur le buffer interne d'un std::string puis écriture à l'indice 1 sans vérifier la longueur (chaîne vide → UB) ; test if (intPos) inversé (string::find retourne npos, converti en int = -1, si non trouvé) Test remplacé par une comparaison explicite à string::npos ; remplacement de l'écriture brute par std::string::resize(1)
ClassSgbd2.cpp getlistOfRecords() Fonction inachevée : la boucle de décodage ne remplit jamais _listOfRecords (ligne de décodage commentée), donc retour systématique d'une liste vide. Jamais appelée dans le projet (le test dédié utilise getliststringOfRecords(), fonctionnelle) Non « réparée » (la logique de décodage manquante n'est pas devinable sans inventer un comportement) ; documentée explicitement comme cassée/inachevée dans un commentaire, avec renvoi vers l'alternative fonctionnelle

Bugs de logique métier corrigés

Fichier Fonction Problème Correctif
ClassSgbdDerivedForObodata.cpp boolDeleteOboUser() Un //else accidentellement commenté rendait l'appel à getintIndexOfDistributeur() inconditionnel (concaténé après la branche C/S/E) ; la clause WHERE comparait le littéral 'intElement' (chaîne) au lieu de la colonne intElement → coercition MySQL vers 0 → le DELETE ne matchait jamais aucune ligne. Le compte n'était donc jamais effectivement supprimé de la table auth (comptes orphelins persistants) Décommenté le else ; colonne intElement non quotée dans la clause WHERE
ClassSgbdDerivedForObodata.cpp boolDeleteFavoriteRecords() Le paramètre stringNiveau était reçu mais jamais utilisé : 'S' codé en dur dans la requête quel que soit le niveau demandé (compte/site/entreprise) stringNiveau désormais utilisé à la place du 'S' figé
ClassSgbdDerivedForPowerAdmin.cpp updateDomainSerial() boolRet déclaré et initialisé à false mais jamais réassigné ; la fonction retournait en réalité _lngSerialOfTheDay (unsigned long) implicitement converti en bool, incohérent avec le prototype bool boolRet = true; ajouté après la mise à jour réussie ; retour de boolRet
ClassSgbdDerivedForPcGoogleSearch.cpp/2.cpp getintIdUrl, getintIdKeyWord, getintIdGenre, getstringGenre, getintNbQueries, getintDayScoreMini, getstringUrlLeader, getintGenre Si la requête SQL ne retournait aucune ligne (élément introuvable en base), ces fonctions renvoyaient silencieusement la valeur du membre laissée par le dernier appel réussi (donnée périmée), ou une variable locale non initialisée (getintGenre) Réinitialisation à une valeur sentinelle (-1 pour les entiers, "" pour les chaînes) juste avant l'exécution de la requête, pour rendre le cas « non trouvé » explicite et distinguable d'un ancien résultat
ClassSgbdDerivedForPowerAdmin.cpp getlngDomainId(), getlngGreatestPrio() Même défaut : membres _lngDomainId/_lngGreatestPrio non réinitialisés avant requête, valeur périmée renvoyée si le domaine/enregistrement est introuvable Réinitialisation à 0 juste avant la requête

Risques structurels identifiés mais volontairement non corrigés

À la demande explicite de l'utilisateur (portée trop large pour cette session), les points suivants restent en l'état et nécessitent un chantier séparé :

  • Injection SQL généralisée : la quasi-totalité des méthodes du projet construit ses requêtes par concaténation de chaînes sans échappement des quotes (présent dans ClassSgbdDerivedForObodata.cpp, ClassSgbdDerivedForObodataVerify.cpp, ClassSgbdDerivedForPowerAdmin.cpp, ClassSgbdDerivedForPcGoogleSearch(2).cpp...).
  • Injection shell dans ClassSgbd.cpp (fnDeleteSgbd, fnCreateSgbd, fnCreateTable) : system() appelé avec login/mot de passe/nom de base non échappés dans une commande shell.
  • Mots de passe en clair dans le code source (ex. "fromspace") répétés dans plusieurs fichiers .cpp.

Compilation

Paquets Debian requis : g++, libmariadb-dev (fournit mysql.h via /usr/include/mariadb), libboost-dev (regex).
Dépendances externes (hors dépôt) : /home/local/include/libmysqlwrapped.h et /home/local/include/pcstreet/*.h (bibliothèque pcstreet commune à l'atelier).

Commande de build :

make -f makefile

Piège : les .h de ce dépôt et ceux installés dans /home/local/include/pcstreet/ peuvent diverger — après modification d'un en-tête ici, le recopier vers /home/local/include/pcstreet/ pour que la compilation (et les autres projets qui en dépendent) reflète le changement.