source: introduction/welcome/askhelp.xml@ ec4b257

10.0 10.1 11.0 6.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk v1_0 v5_0 v5_0-pre1 v5_1 v5_1-pre1 xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since ec4b257 was ec4b257, checked in by Larry Lawrence <larry@…>, 19 years ago

new appendix

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@850 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 3.8 KB
Line 
1<sect1 id="intro-welcome-askhelp">
2<?dbhtml filename="askhelp.html" dir="introduction"?>
3<title>Asking for help and the FAQ</title>
4
5<para>If you encounter a problem while using this book, and your problem
6is not listed in the FAQ (<ulink
7url="http://www.linuxfromscratch.org/faq"/>), you will find that most
8of the people on Internet Relay Chat (IRC) and
9on the mailing lists are willing to help you. An
10overview of the LFS mailing lists can be found in
11<xref linkend="intro-welcome-maillists"/>. To assist us in diagnosing and solving
12your problem, include as much relevant information as possible in your
13request for help.</para>
14
15<sect2>
16<title>Things to check prior to asking</title>
17
18<para>Before asking for help, you should review the following
19items:</para>
20
21<itemizedlist>
22<listitem><para>Is the hardware support compiled into the kernel or
23available as a module to the kernel. If it is a module, is it configured
24properly in <filename>modules.conf</filename> and has it been loaded. You
25should use <userinput>lsmod</userinput> to see if it's loaded. Check the
26<filename>sys.log</filename> or run <userinput>modprobe
27&lt;driver&gt;</userinput>
28to review any error message. If it loads properly, you may need to add
29the <userinput>modprobe</userinput> to your boot scripts.</para></listitem>
30
31<listitem><para>Are your permissions properly set, especially for
32devices. LFS uses groups to make these settings easier, but it also
33adds the step of adding users to groups to allow access. A simple
34<userinput>moduser -G audio &lt;user&gt;</userinput> may be all that's
35necessary for that user to have access to the sound
36system. Any question that starts out with "It works as root, but not as
37..." should review permissions throughly prior to asking.</para></listitem>
38
39<listitem><para>BLFS liberally uses <filename>/opt/&lt;package&gt;</filename>. The main objection to this centers around the need to
40expand your environment variables for each package placed there (e.g.
41PATH=$PATH:/opt/kde/bin). In some cases, the package will walk you
42through the changes, but some will not. <xref linkend="appendices-generic"/> is available to
43help you check.</para></listitem>
44</itemizedlist></sect2>
45
46<sect2>
47<title>Things to mention</title>
48
49<para>Apart from a brief explanation of the problem you're having, the
50essential things to include in your request are:</para>
51
52<itemizedlist>
53<listitem><para>the version of the book you are using (being
54&version;),</para></listitem>
55<listitem><para>the package or section giving you
56problems,</para></listitem>
57<listitem><para>the exact error message or symptom you are
58receiving,</para></listitem>
59<listitem><para>whether you have deviated from the book or LFS at
60all.</para></listitem>
61</itemizedlist>
62
63<para>(Note that saying that you've deviated from the book doesn't mean
64that we won't help you. It'll just help us to see other possible causes of your problem.)</para>
65
66<para>Expect guidance instead of specific instructions. If you are
67instructed to read something, please do so, it generally implies that
68the answer was way too obvious and that the question would not have been asked if a little
69research was done prior to asking. The volunteers in the mailing list
70prefer not to be used as an alternative to doing reasonable research on
71your end. In addition, the quality of your experience with BLFS is also greatly
72enhanced by this research, and the quality of volunteers is enhanced
73because they don't feel that their time has been abused, so they are
74far more likely to participate.</para>
75
76<para>An excellent article on asking for help on the Internet in general
77has been written by Eric S. Raymond. It is available online at <ulink
78url="http://www.tuxedo.org/~esr/faqs/smart-questions.html"/>.
79Read and follow the hints in that document and you are much more likely
80to get a response to start with and also to get the help you actually
81need.</para>
82</sect2>
83
84</sect1>
85
Note: See TracBrowser for help on using the repository browser.