Important :

Le présent wiki a été migré vers wiki.archlinux.org.

Ce Wiki a été archivé. Toute contribution doit donc désormais se faire là-bas. Cette page de Wiki possède donc potentiellement des informations qui ne sont plus à jour !

Accueil wiki FR sur .org

Dépannage

De ArchwikiFR
Révision datée du 13 février 2021 à 01:03 par Nophke (discussion | contributions) (début de traduction)
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)

Cet article donne une méthode générale de dépannage. Pour des problèmes spécifiques à une application qui possède une page dans le wiki, veuillez vous y référer.

Procédure générale

Attention aux détails

Afin de résoudre votre problème, il est «absolument crucial» que vos connaissances du sous-système qui vous intéresse soient solides. Comment cela fonctionne t'il? Qu'est ce qu'il devrait se passer s'il n'y avait cette erreur? Si vous avez du mal à répondre à ces deux questions, vous devriez probablement revoir vos connaissances sur le sujet.

Questions / checklist

Voici une liste de question que vous devriez vous poser chaque fois que vous êtes face à un système qui fonctionne mal. Sous chaque question se trouvent des notes expliquant comment vous devriez tenter de répondre, suivis d'exemples de façon de collecter des données, et des outils pour accéder aux journaux des opérations.

  1. Quel est le problème?
    Soyez aussi précis que possible. Cela vous aidera à ne pas être submergé ou distrait lors de la recherche d'une information spécifique.
  2. Quels sont les messages d'erreur? (s'il y en a)
    Copier et coller la sortie complète qui contient les messages d'erreur dans un fichier à part tel $HOME/issue.log. Par exemple, pour récupérer la sortie de la commande mkinitcpio vers le fichier $HOME/issue.log:
    $ mkinitcpio -p linux >> $HOME/issue.log
  3. Pouvez-vous reproduire le problème?
    Si oui, établissez la liste exacte des instructions/commandes nécessaires pour le reproduire. En ligne de commande, vous pouvez commencer par enregistrer vos commandes accompagnées de leurs sorties. Voir à ce propos script, une commande fournie par le paquet util-linux. Pour vous débarrasser des caractères de contrôle, et/ou non-imprimables du fichier typescript résultant, utilisez tr. Les séquences d’échappement ANSI sont plus difficiles à gérer (car plus complexes). Pour l'utilisation de sed à ce propos visitez https://stackpointer.io/unix/unix-linux-remove-ansi-escape-sequences/464/.
  4. Quand avez-vous rencontré ce problème pour la première fois? Quand le système a t'il été fonctionnel pour la dernière fois? Qu'est ce qui a changé entre temps?
    Si cela survient après une mise à jour, listez tous les paquet mis à jour, ainsi que leur numéro de version. Examinez /var/log/pacman.log. Pensez aux éventuels services requis pour le bon fonctionnement du système.
    $ systemctl status dhcpcd@eth0.service >> $HOME/issue.log

Approche

Plutôt que d'approcher un problème en constatant

L'application X ne fonctionne pas.

il est plus utile de de formuler le problème dans le contexte de son environnement.

L'application X produit l'erreur Y lors de l’exécution de la tâche Z dans les conditions A et B.

Besoin d'aide?

Après toutes ces étapes, vous devriez certaine idée de ce qu'il se passe sur le système et devriez pouvoir commencer à travailler à une solution.

Si vous avez besoin d'aide, celle-ci peut être trouvée sur le forum.

Note : Le document en version anglophone précise que le support n'est fournis que pour Archlinux uniquement et aucune des distributions dérivées. La communauté francophone est probablement plus coulante la dessus. Mais de grâce si vous utilisez une distribution dérivée, mentionnez-le! (NdT)

Si l'on vous demande les sorties de commandes ou de journaux, postez ceux-ci dans leur intégralité, ne les tronquez pas aux seules sections que vous jugez utiles.

Problèmes de démarrage

Le diagnostique des problèmes de démarrage impliquent de pouvoir changer les paramètres passés au noyau. Cela suppose de pouvoir interagir avec le bootloader. Si cela n'est même pas possible, démarrez depuis une iso live et utilisez arch-chroot.

Messages sur la console

A la fin du processus de démarrage, l'écran est entièrement vidé, et le login (ou un gestionnaire de connexion) apparaît. Ceci laisse l'utilisateur incapable de lire les éventuels messages d'erreur. Ce comportement pour être modifié par chacune des méthodes exposées dans les suivantes sous-sections. La page Messages_au_demarrage explique comment désactiver ceci de façon permanente.

N'oubliez pas que quelle que soit l'option choisie, les messages du noyau peuvent être visualisés après démarrage avec la commande journalctl -k ou dmesg. Pour afficher tous les logs depuis le derniers démarrage utilisez journalctl -b.

Contrôle du flux

Ce système rudimentaire de gestion du flux de la console s'applique à la plupart des émulateurs de terminaux incluant les consoles virtuelles.

  • Utilisez Ctrl+s pour mettre en pause l'affichage
  • Et Ctrl+q pour reprendre.

Cela ne met pas seulement l'affichage «en pause», cela gèle tout le programme qui tente d'afficher sur le terminal. Si le processus de boot semble bloqué, vérifiez que la console n'est pas «en pause».