1.7. Help

Si vous rencontrez une erreur ou si vous vous posez une question en travaillant avec ce livre, vérifiez la FAQ sur http://trac.clfs.org/wiki/faq#generalfaq. Les questions y ont souvent des réponses. Si votre question n'a pas sa réponse sur cette page, essayez de trouver la source du problème. L'astuce suivante vous donnera quelques conseils pour cela : http://hints.clfs.org/index.php/Errors.

Nous avons aussi une formidable communauté CLFS, volontaire pour offrir une assistance via les listes de discussion et IRC (voir la section Section 1.6, « Resources » de ce livre). Néanmoins, nous recevons plusieurs questions de support chaque jour et un grand nombre d'entre elles ont une réponse dans la FAQ et dans les listes de discussions. Pour que nous puissions vous offrir la meilleure assistance possible, vous devez faire quelques recherches de votre côté. Ceci nous permet de nous concentrer sur les besoins inhabituels. Si vos recherches ne vous apportent aucune solution, merci d'inclure toutes les informations adéquates (mentionnées ci-dessous) dans votre demande d'assistance.

1.7.1. Éléments à mentionner

À part une brève explication du problème, voici les éléments essentiels à inclure dans votre demande d'aide :

  • La version du livre que vous utilisez (dans ce cas, GIT-20170803)

  • La distribution hôte (et sa version) que vous utilisez pour créer CLFS

  • L'architecture de l'hôte et de la cible.

  • La valeur des variables d'environnement ${CLFS_HOST} et ${CLFS_TARGET}, et le cas échéant, de ${BUILD32}, ${BUILD64}, ${BUILDN32} et ${GCCTARGET}.

  • Le paquet ou la section où le problème a été rencontré

  • Le message d'erreur exact ou le symptôme reçu. Voir Section 1.7.3, « Problèmes de compilation » pour un exemple.

  • Notez si vous avez dévié du livre. Un changement de version de paquet ou même un changement mineur sur une commande est considéré comme une déviation.

[Note]

Note

Dévier du livre ne signifie pas que nous n'allons pas vous aider. Après tout, CLFS est basé sur les préférences de l'utilisateur. Nous préciser les modifications effectuées sur la procédure établie nous aide à évaluer et à déterminer les causes probables de votre problème.

1.7.2. Problèmes avec le script configure

Si quelque chose se passe mal lors de l'exécution du script configure, regardez le fichier config.log Ce fichier pourrait contenir les erreurs rencontrées lors de l'exécution de configure qui n'ont pas été affichées à l'écran. Incluez les lignes intéressantes si vous avez besoin d'aide.

1.7.3. Problèmes de compilation

L'affichage à l'écran et le contenu de différents fichiers sont utiles pour déterminer la cause des problèmes de compilation. L'affichage de l'écran du script configure et de make peuvent être utiles. Il n'est pas nécessaire d'inclure la sortie complète mais incluez suffisamment d'informations intéressantes. Ci-dessous se trouve un exemple de type d'informations à inclure à partir de l'affichage écran de make :

gcc -DALIASPATH=\"/mnt/clfs/usr/share/locale:.\"
-DLOCALEDIR=\"/mnt/clfs/usr/share/locale\"
-DLIBDIR=\"/mnt/clfs/usr/lib\"
-DINCLUDEDIR=\"/mnt/clfs/usr/include\" -DHAVE_CONFIG_H -I. -I.
-g -O2 -c getopt1.c
gcc -g -O2 -static -o make ar.o arscan.o commands.o dir.o
expand.o file.o function.o getopt.o implicit.o job.o main.o
misc.o read.o remake.o rule.o signame.o variable.o vpath.o
default.o remote-stub.o version.o opt1.o
-lutil job.o: In function `load_too_high':
/clfs/tmp/make-3.79.1/job.c:1565: undefined reference
to `getloadavg'
collect2: ld returned 1 exit status
make[2]: *** [make] Error 1
make[2]: Leaving directory `/clfs/tmp/make-3.79.1'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/clfs/tmp/make-3.79.1'
make: *** [all-recursive-am] Error 2

Dans ce cas, beaucoup de personnes n’incluraient que la section du bas

make [2]: *** [make] Error 1

Cette information n'est pas suffisante pour diagnostiquer correctement le problème car il note seulement que quelque chose s'est mal passé, pas ce qui s'est mal passé. La section entière, comme dans l'exemple ci-dessus, est ce qui devrait être sauvée car la commande exécutée et le(s) message(s) d'erreur associé(s) sont inclus.

Un excellent article sur les demandes d'aide sur Internet est disponible en ligne sur http://catb.org/~esr/faqs/smart-questions.html. Lisez et suivez les astuces de ce document pour accroître vos chances d'obtenir l'aide dont vous avez besoin.