Changeset 81fd230 for chapter01/askforhelp.xml
- Timestamp:
- 02/19/2005 10:16:42 PM (19 years ago)
- Branches:
- 10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.1, 6.1.1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
- Children:
- 3d31fc4
- Parents:
- 2f9131f
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
chapter01/askforhelp.xml
r2f9131f r81fd230 8 8 <?dbhtml filename="askforhelp.html"?> 9 9 10 <para>See testing</para> 10 <para>If an issue or a question is encountered while working 11 through this book, check the FAQ page at <ulink url="&faq-root;#generalfaq"/>. 12 Questions are often already answered there. If your question is 13 not answered on this page, try to find the source of the problem. The 14 following hint will give you some guidance for troubleshooting: <ulink 15 url="&hints-root;errors.txt"/>.</para> 16 17 <para>We also have a wonderful LFS community that is willing to offer 18 assistance through IRC and the mailing lists (see the <xref 19 linkend="ch-scatter-administrativa"/> section of this book). In order 20 to assist with diagnosing and solving the problem, please include 21 all relevant information in your request for help.</para> 22 23 <sect2> 24 <title>Things to Mention</title> 25 26 <para>Apart from a brief explanation of the problem being experienced, 27 the essential things to include in any request for help are:</para> 28 29 <itemizedlist> 30 <listitem><para>The version of the book being used (in this case 31 &version;)</para></listitem> 32 <listitem><para>The host distribution and version being used to 33 create LFS</para></listitem> 34 <listitem><para>The package or section the problem was encountered in</para></listitem> 35 <listitem><para>The exact error message or symptom being received</para></listitem> 36 <listitem><para>Note whether you have deviated from the book at all </para></listitem> 37 </itemizedlist> 38 39 <note><para>Deviating from this book does <emphasis>not</emphasis> 40 mean that we will not help you. After all, LFS is about personal 41 preference. Being upfront about any changes to the established 42 procedure helps us evaluate and determine possible causes of your 43 problem.</para></note> 44 </sect2> 45 46 <sect2> 47 <title>Configure Problems</title> 48 49 <para>If something goes wrong during the stage where the configure 50 script is run, review the <filename>config.log</filename> file. This 51 file may contain errors encountered during configure which were not 52 printed to the screen. Include those relevant lines if you need to ask 53 for help.</para> 54 </sect2> 55 56 <sect2> 57 <title>Compile Problems</title> 58 59 <para>Both the screen output and the contents of various files are 60 useful in determining the cause of compile issues. The screen output 61 from the <command>./configure</command> script and the 62 <command>make</command> run can be helpful. It 63 is not necessary to include the entire output, but do include enough 64 of the relevant information. Below is an example of the type of 65 information to include from the screen output from <command>make</command>:</para> 66 67 <screen><computeroutput>gcc -DALIASPATH=\"/mnt/lfs/usr/share/locale:.\" 68 -DLOCALEDIR=\"/mnt/lfs/usr/share/locale\" 69 -DLIBDIR=\"/mnt/lfs/usr/lib\" 70 -DINCLUDEDIR=\"/mnt/lfs/usr/include\" -DHAVE_CONFIG_H -I. -I. 71 -g -O2 -c getopt1.c 72 gcc -g -O2 -static -o make ar.o arscan.o commands.o dir.o 73 expand.o file.o function.o getopt.o implicit.o job.o main.o 74 misc.o read.o remake.o rule.o signame.o variable.o vpath.o 75 default.o remote-stub.o version.o opt1.o 76 -lutil job.o: In function `load_too_high': 77 /lfs/tmp/make-3.79.1/job.c:1565: undefined reference 78 to `getloadavg' 79 collect2: ld returned 1 exit status 80 make[2]: *** [make] Error 1 81 make[2]: Leaving directory `/lfs/tmp/make-3.79.1' 82 make[1]: *** [all-recursive] Error 1 83 make[1]: Leaving directory `/lfs/tmp/make-3.79.1' 84 make: *** [all-recursive-am] Error 2</computeroutput></screen> 85 86 <para>In this case, many people would just include the bottom 87 section:</para> 88 89 <screen><computeroutput>make [2]: *** [make] Error 1</computeroutput></screen> 90 91 <para>This is not enough information to properly diagnose the problem 92 because it only notes that something went wrong, not 93 <emphasis>what</emphasis> went wrong. The entire section, as in the 94 example above, is what should be saved because it includes the command 95 that was executed and the associated error message(s).</para> 96 97 <para>An excellent article about asking for help on the Internet is 98 available online at <ulink 99 url="http://catb.org/~esr/faqs/smart-questions.html"/>. Read and 100 follow the hints in this document to increase the likelihood of getting 101 the help you need.</para> 102 </sect2> 103 104 <sect2> 105 <title>Test Suite Problems</title> 106 107 <para>Many packages provide a test suite which, depending on the 108 importance of the package, should be run. Sometimes packages will 109 generate false or expected failures. If these errors are encountered, 110 check the LFS Wiki page at <ulink url="&wiki-root;"/> to see if we have 111 noted and investigated these issues. If these issues are noted and 112 addressed, there is no need to be concerned.</para> 113 </sect2> 11 114 12 115 </sect1> 116
Note:
See TracChangeset
for help on using the changeset viewer.