1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN">
7
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
9
<title>The Debian GNU/Linux FAQ - Getting support for Debian GNU/Linux</title>
15
<p><a name="ch-support"></a></p>
19
[ <a href="ch-customizing.en.html">previous</a> ]
20
[ <a href="index.en.html#contents">Contents</a> ]
21
[ <a href="ch-basic_defs.en.html">1</a> ]
22
[ <a href="ch-getting.en.html">2</a> ]
23
[ <a href="ch-compat.en.html">3</a> ]
24
[ <a href="ch-software.en.html">4</a> ]
25
[ <a href="ch-ftparchives.en.html">5</a> ]
26
[ <a href="ch-pkg_basics.en.html">6</a> ]
27
[ <a href="ch-pkgtools.en.html">7</a> ]
28
[ <a href="ch-uptodate.en.html">8</a> ]
29
[ <a href="ch-kernel.en.html">9</a> ]
30
[ <a href="ch-customizing.en.html">10</a> ]
32
[ <a href="ch-contributing.en.html">12</a> ]
33
[ <a href="ch-redistrib.en.html">13</a> ]
34
[ <a href="ch-nexttime.en.html">14</a> ]
35
[ <a href="ch-faqinfo.en.html">15</a> ]
36
[ <a href="ch-contributing.en.html">next</a> ]
42
The Debian GNU/Linux FAQ
43
<br>Chapter 11 - Getting support for Debian GNU/Linux
48
<h2><a name="s-debiandocs"></a>11.1 What other documentation exists on and for a Debian system?</h2>
52
Installation instructions for the current release: see <code><a
53
href="http://www.debian.org/releases/stable/installmanual">http://www.debian.org/releases/stable/installmanual</a></code>.
60
The Debian GNU/Linux reference covers many aspects of system administration
61
through shell-command examples. Basic tutorials, tips, and other information
62
are provided for many different topics ranging from system administration to
67
Get it from the <code>debian-reference</code> package, or at <code><a
68
href="http://www.debian.org/doc/user-manuals#quick-reference">http://www.debian.org/doc/user-manuals#quick-reference</a></code>.
75
Policy manual documents the policy requirements for the distribution, i.e. the
76
structure and contents of the Debian archive, several design issues of the
77
operating system etc. It also includes the technical requirements that each
78
package must satisfy to be included in the distribution, and documents the
79
basic technical aspects of Debian binary and source packages.
83
Get it from the <code>debian-policy</code> package, or at <code><a
84
href="http://www.debian.org/doc/devel-manuals#policy">http://www.debian.org/doc/devel-manuals#policy</a></code>.
91
Documentation developed by the Debian Documentation Project. It is available
93
href="http://www.debian.org/doc/">http://www.debian.org/doc/</a></code> and
94
includes user guides, administration guides and security guides for the Debian
95
GNU/Linux operating system.
102
Documentation on installed Debian packages: Most packages have files that are
103
unpacked into <samp>/usr/share/doc/PACKAGE</samp>.
110
Documentation on the Linux project: The Debian package <code>doc-linux</code>
111
installs all of the most recent versions of the HOWTOs and mini-HOWTOs from the
112
<code><a href="http://www.tldp.org/">Linux Documentation Project</a></code>.
119
Unix-style `man' pages: Most commands have manual pages written in the style of
120
the original Unix 'man' files. They are referenced by the section of the 'man'
121
directory where they reside: e.g., foo(3) refers to a manual page which resides
122
in /usr/share/man/man3/, and it can be called by executing the command:
123
<samp>man 3 foo</samp>, or just <samp>man foo</samp> if section 3 is the first
124
one containing a page on <samp>foo</samp>.
128
One can learn which directory of <samp>/usr/share/man/</samp> contains a
129
certain manual page by executing <samp>man -w foo</samp>.
133
New Debian users should note that the 'man' pages of many general system
134
commands are not available until they install these packages:
139
<samp>man-db</samp>, which contains the <samp>man</samp> program itself, and
140
other programs for manipulating the manual pages.
147
<samp>manpages</samp>, which contains the system manual pages. (see <a
148
href="ch-software.en.html#s-nonenglish">How does Debian support non-English
149
languages?, Section 4.8</a>).
158
GNU-style `info' pages: User documentation for many commands, particularly GNU
159
tools, is available not in `man' pages, but in `info' files which can be read
160
by the GNU tool <samp>info</samp>, by running <samp>M-x info</samp> within GNU
161
Emacs, or with some other Info page viewer.
165
Its main advantage over the original `man' pages are that it is a hypertext
166
system. It does <em>not</em> require the WWW, however; <samp>info</samp> can
167
be run from a plain text console. It was designed by Richard Stallman and
174
Note that you may access a lot of documentation on your system by using a WWW
175
browser, through `dwww', `dhelp' or `doccentral' commands, found in respective
181
<h2><a name="s-onlineresources"></a>11.2 Are there any on-line resources for discussing Debian?</h2>
184
Yes. In fact, the main method of support Debian provides to our users is by
190
<h3><a name="s11.2.1"></a>11.2.1 Mailing lists</h3>
193
There are a lot of <code><a
194
href="http://www.debian.org/MailingLists/">Debian-related mailing
199
On a system with the <code>doc-debian</code> package installed there is a
200
complete list of mailing lists in
201
<code>/usr/share/doc/debian/mailing-lists.txt</code>.
205
Debian mailing lists are named following the pattern
206
debian-<var>list-subject</var>. Examples are debian-announce, debian-user,
207
debian-news. To subscribe to any list debian-<var>list-subject</var>, send
208
mail to debian-<var>list-subject</var>-request@lists.debian.org with the word
209
"subscribe" in the Subject: header. Be sure to remember to add
210
<em>-request</em> to the e-mail address when using this method to subscribe or
211
unsubscribe. Otherwise your e-mail will go to the list itself, which could be
212
embarrassing or annoying, depending on your point of view.
216
If you have a forms-capable World Wide Web browser, you can subscribe to
217
mailing lists using the <code><a
218
href="http://www.debian.org/MailingLists/subscribe">WWW form</a></code>. You
219
can also un-subscribe using a <code><a
220
href="http://www.debian.org/MailingLists/unsubscribe">WWW form</a></code>.
224
The list manager's e-mail address is <code><a
225
href="mailto:listmaster@lists.debian.org">listmaster@lists.debian.org</a></code>,
226
in case you have any trouble.
230
The mailing lists are public forums. All e-mails sent to the lists are also
231
copied to the public archive, for anybody (even non-subscribers) to browse or
232
search. Please make sure you never send any confidential or unlicensed
233
material to the lists. This includes things like e-mail addresses. Of
234
particular note is the fact that spammers have been known to abuse e-mail
235
addresses posted to our mailing lists. See the <code><a
236
href="http://www.debian.org/MailingLists/index.en.html#disclaimer">Mailing
237
Lists Privacy policy</a></code> for more information.
241
Archives of the Debian mailing lists are available via WWW at <code><a
242
href="http://lists.debian.org/">http://lists.debian.org/</a></code>.
247
<h4><a name="s-mailinglistconduct"></a>11.2.1.1 What is the code of conduct for the mailing lists?</h4>
250
When using the Debian mailing lists, please follow these rules:
255
Do not send spam. See the <code><a
256
href="http://www.debian.org/MailingLists/#ads">Debian mailing list advertising
264
Do not flame; it is not polite. The people developing Debian are all
265
volunteers, donating their time, energy and money in an attempt to bring the
266
Debian project together.
273
Do not use foul language; besides, some people receive the lists via packet
274
radio, where swearing is illegal.
281
Make sure that you are using the proper list. <em>Never</em> post your
282
(un)subscription requests to the mailing list itself[<a
283
href="footnotes.en.html#f6" name="fr6">6</a>]
290
See section <a href="#s-bugreport">How do I report a bug in Debian?, Section
291
11.5</a> for notes on reporting bugs.
298
<h3><a name="s11.2.2"></a>11.2.2 Maintainers</h3>
301
Users can address questions to individual package maintainers using e-mail. To
302
reach a maintainer of a package called xyz, send e-mail to
303
<em>xyz@packages.debian.org</em>.
308
<h3><a name="s11.2.3"></a>11.2.3 Usenet newsgroups</h3>
311
Users should post non-Debian-specific questions to one of the Linux USENET
312
groups, which are named comp.os.linux.* or linux.*. There are several lists of
313
Linux Usenet newsgroups and other related resources on the WWW, e.g. on the
314
<code><a href="http://www.linux.org/docs/usenet.html">Linux Online</a></code>
316
href="http://www.linuxjournal.com/helpdesk.php">LinuxJournal</a></code> sites.
321
<h2><a name="s-searchtools"></a>11.3 Is there a quick way to search for information on Debian GNU/Linux?</h2>
324
There is a variety of search engines that serve documentation related to
330
<code><a href="http://search.debian.org/">Debian WWW search site</a></code>.
337
<code><a href="http://groups.google.com/">Google Groups</a></code>: a search
338
engine for newsgroups.
342
For example, to find out what experiences people have had with finding drivers
343
for Promise controllers under Debian, try searching on the phrase <samp>Promise
344
Linux driver</samp>. This will show you all the postings that contain these
345
strings, i.e. those where people discussed these topics. If you add
346
<samp>Debian</samp> to those search strings, you'll also get the postings
347
specifically related to Debian.
354
Any of the common web spidering engines, such as <code><a
355
href="http://www.altavista.com/">AltaVista</a></code> or <code><a
356
href="http://www.google.com/">Google</a></code>, as long as you use the right
361
For example, searching on the string "cgi-perl" gives a more detailed
362
explanation of this package than the brief description field in its control
370
<h2><a name="s-buglogs"></a>11.4 Are there logs of known bugs?</h2>
373
Reports on unsolved (and closed) issues are publicly available: Debian
374
promissed to do so by stating "We will not hide problems" in the
375
<code><a href="http://www.debian.org/social_contract">Debian Social
380
The Debian GNU/Linux distribution has a bug tracking system (BTS) which files
381
details of bugs reported by users and developers. Each bug is given a number,
382
and is kept on file until it is marked as having been dealt with.
386
Copies of this information are available at <code><a
387
href="http://www.debian.org/Bugs/">http://www.debian.org/Bugs/</a></code>.
391
A mail server provides access to the bug tracking system database via e-mail.
392
In order to get the instructions, send an e-mail to request@bugs.debian.org
393
with "help" in the body.
398
<h2><a name="s-bugreport"></a>11.5 How do I report a bug in Debian?</h2>
401
If you have found a bug in Debian, please read the instructions for reporting a
402
bug in Debian. These instructions can be obtained in one of several ways:
407
By anonymous FTP. Debian mirror sites contain the instructions in the file
408
<samp>doc/bug-reporting.txt</samp>.
415
From the WWW. A copy of the instructions is shown at <code><a
416
href="http://www.debian.org/Bugs/Reporting">http://www.debian.org/Bugs/Reporting</a></code>.
423
On any Debian system with the <code>doc-debian</code> package installed. The
424
instructions are in the file
425
<code>/usr/share/doc/debian/bug-reporting.txt</code>.
431
You can use the package <code>reportbug</code> that will guide you through the
432
reporting process and mail the message to the proper address, with some extra
433
details about your system added automatically. It will also show you a list of
434
bugs already reported to the package you are reporting against in case your bug
435
has been reported previously, so that you can additional information to the
440
If you want to mail the report with an e-mail program, send a message to
442
href="mailto:submit@bugs.debian.org">submit@bugs.debian.org</a></code>. The
443
message's first line must be similar to
447
Package: package-name
451
(replace <var>package-name</var> with the name of the package). The next line
452
should relate the package version number in a similar way:
456
Version: version-number
460
The version number for any package installed on your system can be obtained
461
using the command line
465
dpkg -s <var>package-name</var>
469
This section is referred to as the pseudo-header. The rest of the message
470
should contain the description of the bug (please make it moderately detailed),
471
the Debian release you are using, and versions of other relevant packages. The
472
Debian release number will be displayed by the command
476
cat /etc/debian_version
480
Expect to get an automatic acknowledgement of your bug report. It will also be
481
automatically given a bug tracking number, entered into the bug log and
482
forwarded to the debian-bugs-dist mailing list.
488
[ <a href="ch-customizing.en.html">previous</a> ]
489
[ <a href="index.en.html#contents">Contents</a> ]
490
[ <a href="ch-basic_defs.en.html">1</a> ]
491
[ <a href="ch-getting.en.html">2</a> ]
492
[ <a href="ch-compat.en.html">3</a> ]
493
[ <a href="ch-software.en.html">4</a> ]
494
[ <a href="ch-ftparchives.en.html">5</a> ]
495
[ <a href="ch-pkg_basics.en.html">6</a> ]
496
[ <a href="ch-pkgtools.en.html">7</a> ]
497
[ <a href="ch-uptodate.en.html">8</a> ]
498
[ <a href="ch-kernel.en.html">9</a> ]
499
[ <a href="ch-customizing.en.html">10</a> ]
501
[ <a href="ch-contributing.en.html">12</a> ]
502
[ <a href="ch-redistrib.en.html">13</a> ]
503
[ <a href="ch-nexttime.en.html">14</a> ]
504
[ <a href="ch-faqinfo.en.html">15</a> ]
505
[ <a href="ch-contributing.en.html">next</a> ]
511
The Debian GNU/Linux FAQ
515
version 3.1.5, 17 January 2007<br>
517
Authors are listed at <a href="ch-faqinfo.en.html#s-authors">Debian FAQ Authors</a><br>