Info:: pcFsWithPostgres - pcupdatedb - pclocate

De wiki_pcwiki2
Aller à la navigationAller à la recherche

KEYWORDS: pcFsWithPostgres, pcupdatedb, pclocate

Le 06/05/2026:
pcFsWithPostgres est un (gros) updatedb LIKE basé sur postgresql et qui en fait beaucoup plus que l'originel
il existe deux liens à cette App: pcupdatedb et pclocate
Installation:
C'est la grande nouveauté: cette app est capable de s'auto installer grâce à une énorme astuce: 
Il existe un launcher avec le même nom. 

Ce launcher vérifie que tout a été& installé (même les apt) et installe ce qu'il faut si nécessaire, sinon, il passe la main à pcFsWithPostgres.real
donc: pcFsWithPostgres --autoinstall fait tout le travail d'installation
  ou: pc --autoinstall fait tout le travail d'installation
  ou: pcFsWithPostgres --autoinstall fait tout le travail d'installation
Utilisation:
root@debian-dvt:/Atelier/pcFsWithPostgres/V1.07/build# pcupdatedb  --help
================================================================
  pcupdatedb — Mise à jour & maintenance de la BD
================================================================

USAGE:
  pcupdatedb [options] [PATTERN]

OPTIONS:
  --init, -i           Index initial complet (récursif)
  --setmeta, -m        Rebase le snapshot _orig depuis l'état courant
                       (combiner avec PATTERN ou '*' pour toute la base)
  --restoremeta        Restaure l'état courant depuis le snapshot _orig
                       (combiner avec PATTERN ou '*' pour toute la base)
  --regex, -r          PATTERN interprété comme regex POSIX (par défaut: LIKE)
  --nocase, -n         Insensible à la casse
  --autoinstall, -a    Installation automatique from scratch (require root)
  --setIni, -I ["<dirs>"] Crée/affiche /root/.config/pcFsWithPostgres/pcFsWithPostgres.ini
  --test, -t           Lance la suite de tests (crée /tmp/test)
  --version, -v        Affiche la version
  --help, -h           Cette aide
  (sans option)        Synchronisation depuis audit.log

DÉTAILS DES OPTIONS :

  --init / -i
    ➜ À QUOI ÇA SERT ?
      - Créer une base de données à partir de zéro
      - Scanner récursivement /home, /root, /etc, /var, /usr, /tmp
      - Établir le snapshot initial (_orig) qui servira de référence
      - Après --init, audit.log suivi automatiquement par pcupdatedb
    Exemple: pcupdatedb --init
    → Indexe ~500k fichiers, crée les snapshots de référence

  --setmeta / -m
    ➜ À QUOI ÇA SERT ?
      - Valider l'état courant comme 'correct' et l'établir comme nouveau baseline
      - Marquer que les changements détectés sont intentionnels et acceptables
      - Après --setmeta, --diff ne montre plus ces fichiers jusqu'à un nouveau changement
      - Cas d'usage: vous venez de patcher vos fichiers .conf, vous validez avec --setmeta
    Exemple: pcupdatedb -m '*.conf'
    → Les .conf actuels deviennent le nouveau snapshot
    → Futur --diff ignorera ces .conf tant qu'ils ne changent pas

  --restoremeta
    ➜ À QUOI ÇA SERT ?
      - RÉCUPÉRER les droits/ownership depuis le snapshot de référence
      - Annuler les modifications involontaires (chmod accidental, chown, etc.)
      - Restaurer après une modification de masse erronée
      - Cas d'usage: quelqu'un a changé chmod 644→777 sur /etc, vous restaurez avec --restoremeta
    Exemple: pcupdatedb --restoremeta '/etc/*.conf'
    → Restaure les perms/owner de /etc/*.conf depuis le snapshot
    → /etc/app.conf passe de 0777 root:root → 0644 root:root (snapshot)
    Exemple: pcupdatedb --restoremeta '*'
    → Restaure TOUT le filesystem (extreme, confirmation forte requise)

  (sans option)
    ➜ À QUOI ÇA SERT ?
      - Synchroniser la base avec les changements du filesystem détectés par auditd
      - Mettre à jour audit.log depuis le dernier run de pcupdatedb
      - Commande de maintenance quotidienne/horaire à lancer régulièrement
    Exemple: pcupdatedb
    → Traite ~50k événements auditd, sync en 2-3 secondes
    → Utile dans un cron: */5 * * * * pcupdatedb

  --test / -t
    ➜ À QUOI ÇA SERT ?
      - Vérifier que toutes les options fonctionnent correctement
      - Valider après une compilation/mise à jour
      - Afficher un rapport d'état du système
root@debian-dvt:/Atelier/pcFsWithPostgres/V1.07/build# pclocate  --help
================================================================
  pclocate — Recherche de fichiers dans la BD
================================================================

USAGE:
  pclocate [options] PATTERN
  pclocate PATTERN              (équivalent à --search)

OPTIONS:
  --search PATTERN, -s     Recherche par pattern (LIKE)
  --searchLong PATTERN, -S Recherche au format long (perms user:grp size mtime|path)
  --regex PATTERN, -r      Recherche par regex POSIX
  --regexLong PATTERN, -R  Regex avec format long
  --list PATTERN, -l       Format ls -la (type perms nlink user group size date path)
  --nocase, -n             Insensible à la casse
  --cmd CMD, -c CMD        Exécute CMD sur chaque résultat (confirmation)
  --diff, -d               N'affiche que les fichiers où courant ≠ _orig
  --count                  Affiche seulement le nombre de fichiers trouvés
  --autoinstall, -a        Installation automatique from scratch (require root)
  --setIni, -I ["<dirs>"] Crée/affiche /root/.config/pcFsWithPostgres/pcFsWithPostgres.ini
  --test, -t               Lance la suite de tests
  --version, -v            Affiche la version
  --help, -h               Cette aide

DÉTAILS DES OPTIONS :

  PATTERN seul (ou --search)
    ➜ À QUOI ÇA SERT ?
      - Trouver rapidement tous les fichiers contenant le pattern
      - Recherche simple, insensible aux chemins absolus
      - La plus rapide pour une recherche "classique"
    Exemple: pclocate 'main.cpp'
    → Affiche tous les chemins contenant 'main.cpp'
       /home/user/src/main.cpp
       /var/backup/main.cpp.bak

  --searchLong / -S
    ➜ À QUOI ÇA SERT ?
      - Voir les métadonnées (perms, owner, size, mtime) à côté du chemin
      - Vérifier les permissions avant d'agir
      - Auditer qui a créé/modifié les fichiers
    Exemple: pclocate -S 'config'
    → 0644 root:root 1234 2026-05-05 10:00:00|/etc/config.json
       (vous voyez immédiatement que c'est root:root avec perms 0644)

  --regex / -r
    ➜ À QUOI ÇA SERT ?
      - Recherche puissante avec expressions régulières
      - Filtrer par chemin complet ou extension de façon flexible
      - Excluder des patterns complexes
    Exemple: pclocate -r '^/home/.*\.cpp$'
    → SEULEMENT les fichiers .cpp dans /home (pas /tmp/home/, etc.)

  --regexLong / -R
    ➜ À QUOI ÇA SERT ?
      - Regex + métadonnées = audit complet d'un groupe de fichiers
      - Vérifier les perms/owner d'une catégorie spécifique
    Exemple: pclocate -R '^/etc/.*\.conf$'
    → Tous les .conf de /etc avec perms/size/mtime

  --list / -l
    ➜ À QUOI ÇA SERT ?
      - Afficher les résultats exactement comme 'ls -la'
      - Voir type (d/-/l), permissions rwxrwxrwx, nlink, user, group, taille, date
      - Compatible avec les outils qui parsent le format ls (scripts, awk)
    Exemple: pclocate -l '*.conf'
    → -rw-r--r-- 1 root root   512 May  6 12:00 /etc/app.conf
       drwxr-xr-x 3 root root  4096 Jan  1  2025 /etc/nginx
    Exemple: pclocate -r -l '^/etc/.*\.conf$'
    → (regex + format ls)

  --nocase / -n
    ➜ À QUOI ÇA SERT ?
      - Ignore la casse (MAIN.cpp = main.cpp = Main.cpp)
      - Utile si vous ne savez pas la casse du fichier
    Exemple: pclocate -s MAIN.CPP -n
    → Trouve main.cpp, Main.cpp, MAIN.CPP, etc.

  --cmd / -c CMD
    ➜ À QUOI ÇA SERT ?
      - Exécuter une action (rm, chmod, chown, etc.) sur chaque fichier trouvé
      - Interactif : confirmation avant d'exécuter
      - Cas d'usage: supprimer tous les fichiers temporaires d'un coup
    Exemple: pclocate -s '*.tmp' -c 'rm -f {}'
    → Demande "Confirmer ? [y/N]" puis supprime tous les .tmp
    Exemple: pclocate -r '^/var/log/.*\.old$' -c 'gzip {}'
    → Compresse tous les .old dans /var/log

  --diff / -d
    ➜ À QUOI ÇA SERT ?
      - Voir SEULEMENT les fichiers qui ont changé depuis le snapshot
      - Auditer les modifications non autorisées
      - Vérifier l'intégrité d'un répertoire critique (ex: /etc)
    Exemple: pclocate -s '/etc' -d
    → Affiche SEULEMENT les fichiers /etc qui ont divergé
       [chmod: 0644→0600] /etc/shadow
       [size: 512→1024] /etc/config.json

  --count
    ➜ À QUOI ÇA SERT ?
      - Compter rapidement sans afficher les fichiers (output compact)
      - Sans pattern : retourne le nombre total de fichiers en base
      - Avec pattern : nombre de fichiers matchant le pattern
      - Utiliser dans des scripts pour prendre des décisions
    Exemple: pclocate --count
    → 219302  (total de la base)
    Exemple: pclocate -s '*.tmp' --count
    → 42  (affiche juste le nombre de .tmp)
    Dans un script:
      if [ $(pclocate --count '*.tmp') -gt 100 ]; then
          pclocate -s '*.tmp' -c 'rm {}'