« back to all changes in this revision
Viewing changes to FAQ.html
- browse files at revision 12
- compare with another revision
- download diff
- download tarball
- view history from revision 12
- Committer: Bazaar Package Importer
- Author(s): Robert Grimm
- Date: 2010-06-13 20:41:10 UTC
- mfrom: (1.2.2 upstream)
- Revision ID: james.westby@ubuntu.com-20100613204110-jn5da77ih13v8oau
Tags: 1.11.8-1
* New upstream release.
- Fix file descriptor leak in getbody_newno() (closes: #568128).
* Added Danish Debconf translation, kindly provided by
Joe Hansen <joedalton2@yahoo.dk> (closes: #581055).
* Depend on netbase.
* Standards version 3.8.4 (no changes).
* Switch to dpkg source 3.0 (quilt) format.
- Fix file descriptor leak in getbody_newno() (closes: #568128).
* Added Danish Debconf translation, kindly provided by
Joe Hansen <joedalton2@yahoo.dk> (closes: #581055).
* Depend on netbase.
* Standards version 3.8.4 (no changes).
* Switch to dpkg source 3.0 (quilt) format.
- files added:
- .pc
- .pc/config_example.patch
- debian/patches
- debian/source
- files removed:
- README.FIRST
- files modified:
- ChangeLog
added
removed
FAQ.html
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Leafnode FAQ</title><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="id2429848"></a>Leafnode FAQ</h2></div><div><div class="author"><h3 class="author"><span class="honorific">Dr</span>. <span class="firstname">Cornelius</span> <span class="surname">Krasel</span></h3></div></div><div><div class="author"><h3 class="author"><span class="firstname">Matthias</span> <span class="surname">Andree</span></h3></div></div><div><p class="copyright">Copyright � 2002 Cornelius Krasel</p></div><div><p class="copyright">Copyright � 2002, 2003, 2004, 2005, 2006 Matthias Andree</p></div><div><p class="pubdate">$Date: 2006/04/09 17:19:32 $</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#FAQ">Leafnode frequently asked questions, with answers.</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2528458">Installation problems</a></span></dt><dt><span class="sect2"><a href="#id2485875">Configuration problems</a></span></dt><dt><span class="sect2"><a href="#id2481122">Problems at run time</a></span></dt><dt><span class="sect2"><a href="#id2529730">Problems with particular newsreaders</a></span></dt></dl></dd><dt><span class="sect1"><a href="#backtrace">Obtaining a stack backtrace</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2529968">From a core file.</a></span></dt><dt><span class="sect2"><a href="#id2530016">Running a program under gdb supervision.</a></span></dt><dt><span class="sect2"><a href="#id2530124">From a running/hanging leafnode
2
program.</a></span></dt></dl></dd><dt><span class="sect1"><a href="#redhat-xinetd">Red Hat and the inetd vs. xinetd issue.</a></span></dt></dl></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="FAQ"></a>Leafnode frequently asked questions, with answers.</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2528458"></a>Installation problems</h3></div></div></div><div class="qandaset"><dl><dt>Q: <a href="#id2516735">Leafnode does not compile on my Mac
3
OS X system.</a></dt><dt>Q: <a href="#id2485785">Compiling causes a message
4
'SA_RESETHAND undeclared'!</a></dt><dt>Q: <a href="#id2485802">I cannot compile leafnode on Linux!</a></dt><dt>Q: <a href="#id2485839">Where/how do I get the source RPM? I
5
want to modify it.</a></dt></dl><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="id2516735"></a><a name="id2494095"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Leafnode does not compile on my Mac
6
OS X system.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Apple introduced <a class="ulink" href="http://developer.apple.com/techpubs/macosx/ReleaseNotes/TwoLevelNamespaces.html" target="_top">Two-Level
7
Namespace Executables</a> with
8
MacOS X 10.1. This change affects how
9
the linker works, and the linker itself
10
is driven by the
11
<span class="application">libtool</span> parts that ship
12
with PCRE. <span class="application">libtool</span> as of that version
13
and up to version 1.4.2 does not yet
14
support the new linker semantics of
15
MacOS X 10.1, and the compile broke up
16
to and including leafnode 1.9.27.</p><p>Since leafnode 1.9.28, the embedded
17
<code class="filename">pcre/</code> directory
18
contains two changes to overcome these
19
problems:</p><div class="orderedlist"><ol type="1"><li><p>the
20
embedded
21
<span class="application">libtool</span>
22
parts in <code class="filename">configure</code>are patched to detect
23
these new MacOS versions and
24
pass appropriate options to the
25
linker.</p></li><li><p>When leafnode uses the
26
embedded libtool, it passes the
27
<code class="option">--disable-shared</code>
28
option to PCRE's
29
<code class="filename">configure</code>,
30
which avoids this trouble with
31
shared libraries and speeds up
32
the build -- leafnode will links
33
statically anyhow to avoid the
34
PCRE installation. The file
35
<code class="filename">configure.gnu</code>
36
does that, and it will not get
37
applied if you explicitly
38
configure
39
<code class="filename">pcre/</code>.</p></li></ol></div><p>So, effectively, an update to leafnode
40
1.9.28 should fix this problem. If it
41
does not, contact the leafnode mailing
42
list.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2485785"></a><a name="id2485787"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Compiling causes a message
43
'SA_RESETHAND undeclared'!</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>This means that
44
your operating system is too old and
45
lacks this symbol which is required by
46
POSIX.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2485802"></a><a name="id2485804"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>I cannot compile leafnode on Linux!</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Another common reason for the build to
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Leafnode FAQ</title><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" title="Leafnode FAQ"><div class="titlepage"><div><div><h2 class="title"><a name="id2486914"></a>Leafnode FAQ</h2></div><div><div class="author"><h3 class="author"><span class="honorific">Dr</span>. <span class="firstname">Cornelius</span> <span class="surname">Krasel</span></h3></div></div><div><div class="author"><h3 class="author"><span class="firstname">Matthias</span> <span class="surname">Andree</span></h3></div></div><div><p class="copyright">Copyright � 2002 Cornelius Krasel</p></div><div><p class="copyright">Copyright � 2002, 2003, 2004, 2005, 2006, 2009 Matthias Andree</p></div><div><p class="pubdate">$Date: 2006/04/09 17:19:32 $</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#FAQ">Leafnode frequently asked questions, with answers.</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2522100">Installation-related problems, including relocations</a></span></dt><dt><span class="sect2"><a href="#id2492461">Configuration problems</a></span></dt><dt><span class="sect2"><a href="#id2491867">Problems at run time</a></span></dt><dt><span class="sect2"><a href="#id2535667">Problems with particular newsreaders</a></span></dt></dl></dd><dt><span class="sect1"><a href="#backtrace">Obtaining a stack backtrace</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2535930">From a core file.</a></span></dt><dt><span class="sect2"><a href="#id2535978">Running a program under gdb supervision.</a></span></dt><dt><span class="sect2"><a href="#id2536086">From a running/hanging leafnode
2
program.</a></span></dt></dl></dd><dt><span class="sect1"><a href="#redhat-xinetd">Red Hat and the inetd vs. xinetd issue.</a></span></dt></dl></div><div class="sect1" title="Leafnode frequently asked questions, with answers."><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="FAQ"></a>Leafnode frequently asked questions, with answers.</h2></div></div></div><div class="sect2" title="Installation-related problems, including relocations"><div class="titlepage"><div><div><h3 class="title"><a name="id2522100"></a>Installation-related problems, including relocations</h3></div></div></div><div class="qandaset" title="Frequently Asked Questions"><a name="id2509281"></a><dl><dt>Q: <a href="#id2522677">Compiling causes a message
3
'SA_RESETHAND undeclared'!</a></dt><dt>Q: <a href="#id2526391">I cannot compile leafnode on Linux!</a></dt><dt>Q: <a href="#id2487632">Where/how do I get the source RPM? I
4
want to modify it.</a></dt><dt>Q: <a href="#id2492352">How do I copy/move the spool?</a></dt></dl><table border="0" width="100%" summary="Q and A Set"><col align="left" width="1%"><col><tbody><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2522677"></a><a name="id2500038"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Compiling causes a message
5
'SA_RESETHAND undeclared'!</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>This means that your operating system is too old and
6
lacks this symbol which is required by POSIX.
7
Please update your operating system. </p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2526391"></a><a name="id2526393"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>I cannot compile leafnode on Linux!</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Another common reason for the build to
47
8
fail is that Leafnode depends on some
48
9
system-specific information which is usually
49
10
included in the sources of the kernel.</p><p>Unfortunately, some Linux distribution do
54
15
Linux, if the kernel sources are installed in
55
16
<code class="filename">/usr/src/linux-a.b.cc</code> (with a.b.cc being the version
56
17
number of your kernel), create a symlink to
57
<code class="filename">/usr/src/linux</code>.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2485839"></a><a name="id2485842"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Where/how do I get the source RPM? I
18
<code class="filename">/usr/src/linux</code>.</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2487632"></a><a name="id2487634"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Where/how do I get the source RPM? I
58
19
want to modify it.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>You can generate it yourself from the
59
20
source tarball (which contains the necessary
60
21
<code class="filename">.spec</code> file. Just
63
24
course, you will have to adjust the version
64
25
shown here. For RPM 3.x and older, type this instead:
65
26
<strong class="userinput"><code>rpm -ts leafnode-1.11.5.tar.bz2</code></strong>
66
</p></td></tr></tbody></table></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2485875"></a>Configuration problems</h3></div></div></div><div class="qandaset"><dl><dt>Q: <a href="#id2485883">Leafnode refuses to start and tells
67
things about my hostname!</a></dt><dt>Q: <a href="#id2485908">Does leafnode support local
27
</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2492352"></a><a name="id2492354"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I copy/move the spool?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>There are two important requirements to heed:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>You must copy hard links as hard links. There are three supported methods to achieve that. In each of the following examples, replace the source and DEST directories:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>On POSIX compliant systems, use <strong class="userinput"><code>mkdir DEST && sudo pax -r -w -p e -H /var/spool/news/ DEST</code></strong></p></li><li class="listitem"><p>If rsync is installed, use (note the trailing slash!), use <strong class="userinput"><code>rsync -aH /var/spool/news/ DEST</code></strong></p></li><li class="listitem"><p>If GNU cp is installed (it's sometimes called gcp), use <strong class="userinput"><code>cp -a /var/spool/news/ DEST</code></strong></p></li></ul></div><p>If you fail to do this, texpire may expire articles too early. You can repair broken hard links with <strong class="userinput"><code>texpire -r</code></strong>.</p></li><li class="listitem"><p>You must update the hashed message.id/nnn/ links if you are running leafnode from the new location. Unless the new spool directory has the same name as the old one (if, for instance, moving to a new computer), run <strong class="userinput"><code>texpire -r</code></strong> before any other leafnode program. Leafnode-1's spool layout unfortunately depends on the name of the spool directory, and when that changes, files may have to be moved between the message.id/nnn/ directories, and <strong class="userinput"><code>texpire -r</code></strong> does just that - and it also repairs hard links.</p><p>If you fail to do this, leafnode may not find articles in its spool.</p></li></ol></div></td></tr></tbody></table></div></div><div class="sect2" title="Configuration problems"><div class="titlepage"><div><div><h3 class="title"><a name="id2492461"></a>Configuration problems</h3></div></div></div><div class="qandaset" title="Frequently Asked Questions"><a name="id2492465"></a><dl><dt>Q: <a href="#id2492470">Leafnode refuses to start and tells
28
things about my hostname!</a></dt><dt>Q: <a href="#id2492495">Does leafnode support local
68
29
newsgroups?</a></dt><dt>Q: <a href="#nntpds">How do I run leafnode as NNTP+SSL
69
30
server?</a></dt><dt>Q: <a href="#nntps">How do I use fetchnews with NNTP/SSL
70
31
servers, such as
71
nntp.sourceforge.net?</a></dt></dl><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="id2485883"></a><a name="id2485884"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Leafnode refuses to start and tells
32
nntp.sourceforge.net?</a></dt></dl><table border="0" width="100%" summary="Q and A Set"><col align="left" width="1%"><col><tbody><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2492470"></a><a name="id2492471"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Leafnode refuses to start and tells
72
33
things about my hostname!</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>There is a separate documentation file dedicated
73
34
to this issue, how to obtain a hostname, and how to tell
74
35
leafnode about it. Please see
75
36
<code class="filename">README-FQDN</code> or
76
<code class="filename">README-FQDN.html</code> for details.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2485908"></a><a name="id2485909"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Does leafnode support local
37
<code class="filename">README-FQDN.html</code> for details.</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2492495"></a><a name="id2492496"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Does leafnode support local
77
38
newsgroups?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Leafnode 1.x does not support local newsgroups.
78
Leafnode 2.x will do that.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="nntpds"></a><a name="id2485930"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I run leafnode as NNTP+SSL
79
server?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Wrap leafnode with an SSL wrapper:</p><div class="orderedlist"><ol type="1"><li><p>
39
Leafnode 2.x will do that.</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="nntpds"></a><a name="id2491705"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I run leafnode as NNTP+SSL
40
server?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Wrap leafnode with an SSL wrapper:</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
80
41
Obtain <a class="ulink" href="http://stunnel.mirt.net" target="_top">stunnel
81
42
version 3</a>
82
43
and install it.
83
</p></li><li><p>Create a certificate and
44
</p></li><li class="listitem"><p>Create a certificate and
84
45
save it to
85
46
<code class="filename">/etc/leafnode/stunnel.pem</code>, see
86
47
the stunnel documentation.
87
48
Implications such as whether to
88
49
use signed certificates are beyond the
89
scope of this document.</p></li><li><p>Add a configuration to your
50
scope of this document.</p></li><li class="listitem"><p>Add a configuration to your
90
51
inetd.conf, xinetd.conf or spawn a new
91
52
tcpserver process as described in the
92
53
<code class="filename">INSTALL</code> document; but instead of
94
55
you'll type</p><p>
95
56
<strong class="userinput"><code>/usr/local/sbin/stunnel -f -p
96
57
/etc/leafnode/stunnel.pem -l
97
/usr/local/sbin/leafnode.</code></strong></p></li></ol></div></td></tr><tr class="question"><td align="left" valign="top"><a name="nntps"></a><a name="id2486000"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I use fetchnews with NNTP/SSL
58
/usr/local/sbin/leafnode.</code></strong></p></li></ol></div></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="nntps"></a><a name="id2491774"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>How do I use fetchnews with NNTP/SSL
98
59
servers, such as
99
60
<code class="filename">nntp.sourceforge.net</code>?</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Warning: SourceForge does not
100
61
currently support the
105
66
now. leafnode-2 will work for lurking, but
106
67
will likely be unable to post. Sourceforge
107
68
are aware that we need these commands and
108
will add them at a later time.</p><div class="orderedlist"><ol type="1"><li><p>
69
will add them at a later time.</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
109
70
Obtain <a class="ulink" href="http://stunnel.mirt.net" target="_top">stunnel
110
71
version 3</a>
111
72
and install it.
112
</p></li><li><p>Arrange for stunnel to be started at
73
</p></li><li class="listitem"><p>Arrange for stunnel to be started at
113
74
system boot time, try:</p><p><strong class="userinput"><code>/usr/sbin/stunnel -c -d
114
75
127.0.0.1:563 -r
115
76
nntp.sourceforge.net:563</code></strong></p><p>Add</p><pre class="programlisting">server = localhost
118
79
password = TOP_SECRET
119
80
</pre><p>to your
120
81
<code class="filename">/etc/leafnode/config</code>.
121
</p></li></ol></div></td></tr></tbody></table></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2481122"></a>Problems at run time</h3></div></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2481126"></a>leafnode (the NNTP server)</h4></div></div></div><div class="qandaset"><dl><dt>Q: <a href="#id2481135">I cannot post, leafnode tells me the
122
Message-ID is invalid.</a></dt><dt>Q: <a href="#id2481170">I cannot connect to my newsserver.</a></dt><dt>Q: <a href="#id2481220">Remote users cannot connect to leafnode.</a></dt></dl><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="id2481135"></a><a name="id2481136"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>I cannot post, leafnode tells me the
82
</p></li></ol></div></td></tr></tbody></table></div></div><div class="sect2" title="Problems at run time"><div class="titlepage"><div><div><h3 class="title"><a name="id2491867"></a>Problems at run time</h3></div></div></div><div class="sect3" title="leafnode (the NNTP server)"><div class="titlepage"><div><div><h4 class="title"><a name="id2491871"></a>leafnode (the NNTP server)</h4></div></div></div><div class="qandaset" title="Frequently Asked Questions"><a name="id2491875"></a><dl><dt>Q: <a href="#id2491880">I cannot post, leafnode tells me the
83
Message-ID is invalid.</a></dt><dt>Q: <a href="#id2491915">I cannot connect to my newsserver.</a></dt><dt>Q: <a href="#id2491965">Remote users cannot connect to leafnode.</a></dt></dl><table border="0" width="100%" summary="Q and A Set"><col align="left" width="1%"><col><tbody><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2491880"></a><a name="id2491881"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>I cannot post, leafnode tells me the
123
84
Message-ID is invalid.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Netscape Communicator, Mozilla and derived
124
85
products (Beonex) will by default generate the Message-ID
125
86
from the domain part of your E-Mail address. However, if
129
90
addresses into double quote marks, like
130
91
this:<strong class="userinput"><code>"matthias.andree@gmx.de"</code></strong>This
131
92
will prevent your Netscape-based newsreader from generating
132
the invalid Message-ID and leave the generation to leafnode.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2481170"></a><a name="id2481172"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>I cannot connect to my newsserver.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>You may not have configured <span class="application">inetd</span> or
93
the invalid Message-ID and leave the generation to leafnode.</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2491915"></a><a name="id2491917"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>I cannot connect to my newsserver.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>You may not have configured <span class="application">inetd</span> or
133
94
<span class="application">xinetd</span> properly,
134
95
or the corresponding super server is not running. Please review
135
96
the installation instructions. <a class="link" href="#redhat-xinetd" title="Red Hat and the inetd vs. xinetd issue.">See below for
139
100
reply with (on one line):
140
101
</p><pre class="screen">200 Leafnode NNTP Daemon, version 1.9.27.rel running at merlin.emma.line.org
141
102
(my fqdn: merlin.emma.line.org)</pre><p>
142
</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2481220"></a><a name="id2481222"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Remote users cannot connect to leafnode.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>You are connecting from outside the same
103
</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2491965"></a><a name="id2491967"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Remote users cannot connect to leafnode.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>You are connecting from outside the same
143
104
networks that your leafnode
144
105
server is in. Leafnode by default refuses connections from
145
106
outside your
158
119
dynamic IP, please use other methods of
159
120
access instead, for instance SSH tunnels
160
121
(which are also available on Windows, before
161
you ask).</p></td></tr></tbody></table></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2481378"></a>fetchnews</h4></div></div></div><div class="qandaset"><dl><dt>1. <a href="#id2481385">Fetchnews does not fetch any articles.</a></dt><dt>2. <a href="#id2481442">Fetchnews has problems
162
retrieving new newsgroups.</a></dt><dt>3. <a href="#id2481499">Since the update, fetchnews does
163
not post my new articles!</a></dt><dt>4. <a href="#id2481524">While fetchnews is running, my modem hangs up.</a></dt><dt>5. <a href="#id2481551">How can I run fetchnews as regular user (not
164
root)?</a></dt><dt>6. <a href="#id2481622">I have unsubscribed from a newsgroup, but
165
fetchnews still pulls articles for that group.</a></dt><dt>7. <a href="#id2529591">How do I stop fetchnews from unsubscribing from
166
newsgroups?</a></dt><dt>8. <a href="#id2529629">fetchnews is slow, how do I
167
speed it up?</a></dt><dt>9. <a href="#id2529650">fetchnews keeps downloading the full newsgroup list
168
every time it runs</a></dt></dl><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="id2481385"></a><a name="id2481387"></a><p><b>1.</b></p></td><td align="left" valign="top"><p>Fetchnews does not fetch any articles.</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>There are several reasons why this may
169
be the case:</p><div class="itemizedlist"><ul type="disc"><li><p>You did not read any pseudo articles with
122
you ask).</p></td></tr></tbody></table></div></div><div class="sect3" title="fetchnews"><div class="titlepage"><div><div><h4 class="title"><a name="id2487155"></a>fetchnews</h4></div></div></div><div class="qandaset" title="Frequently Asked Questions"><a name="id2487160"></a><dl><dt>1. <a href="#id2487162">Fetchnews does not fetch any articles.</a></dt><dt>2. <a href="#id2487215">Fetchnews has problems
123
retrieving new newsgroups.</a></dt><dt>3. <a href="#id2487273">Since the update, fetchnews does
124
not post my new articles!</a></dt><dt>4. <a href="#id2487298">While fetchnews is running, my modem hangs up.</a></dt><dt>5. <a href="#id2487325">How can I run fetchnews as regular user (not
125
root)?</a></dt><dt>6. <a href="#id2487399">I have unsubscribed from a newsgroup, but
126
fetchnews still pulls articles for that group.</a></dt><dt>7. <a href="#id2535528">How do I stop fetchnews from unsubscribing from
127
newsgroups?</a></dt><dt>8. <a href="#id2535566">fetchnews is slow, how do I
128
speed it up?</a></dt><dt>9. <a href="#id2535586">fetchnews keeps downloading the full newsgroup list
129
every time it runs</a></dt></dl><table border="0" width="100%" summary="Q and A Set"><col align="left" width="1%"><col><tbody><tr class="question" title="1."><td align="left" valign="top"><a name="id2487162"></a><a name="id2487164"></a><p><b>1.</b></p></td><td align="left" valign="top"><p>Fetchnews does not fetch any articles.</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>There are several reasons why this may
130
be the case:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>You did not read any pseudo articles with
170
131
your news reader. Subscribe to some groups,
171
132
enter them and read the leafnode placeholder
172
article.</p></li><li><p>Your groupinfo file may be corrupt.
133
article.</p></li><li class="listitem"><p>Your groupinfo file may be corrupt.
173
134
Run <strong class="userinput"><code>fetchnews
174
-f</code></strong>.</p></li><li><p><code class="filename">/var/spool/news</code> may have
135
-f</code></strong>.</p></li><li class="listitem"><p><code class="filename">/var/spool/news</code> may have
175
136
wrong permissions.
176
137
<code class="filename">/var/spool/news</code> and all its
177
138
subdirectories should be owned by user and
178
139
group news and have permissions drwxrwsr-x
179
(02755).</p></li></ul></div></td></tr><tr class="question"><td align="left" valign="top"><a name="id2481442"></a><a name="id2481444"></a><p><b>2.</b></p></td><td align="left" valign="top"><p>Fetchnews has problems
140
(02755).</p></li></ul></div></td></tr><tr class="question" title="2."><td align="left" valign="top"><a name="id2487215"></a><a name="id2487217"></a><p><b>2.</b></p></td><td align="left" valign="top"><p>Fetchnews has problems
180
141
retrieving new newsgroups.</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>Maybe your upstream server supports neither the
181
142
<span class="command"><strong>XGTITLE news.group.name</strong></span> nor the
182
143
<span class="command"><strong>LIST NEWSGROUPS news.group.name</strong></span>
186
147
as described in the
187
148
<span class="citerefentry"><span class="refentrytitle">leafnode</span>(8)</span>
188
149
manual page and the
189
<code class="filename">/etc/leafnode/config.example</code> file.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2481499"></a><a name="id2481500"></a><p><b>3.</b></p></td><td align="left" valign="top"><p>Since the update, fetchnews does
150
<code class="filename">/etc/leafnode/config.example</code> file.</p></td></tr><tr class="question" title="3."><td align="left" valign="top"><a name="id2487273"></a><a name="id2487274"></a><p><b>3.</b></p></td><td align="left" valign="top"><p>Since the update, fetchnews does
190
151
not post my new articles!</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>You have probably mixed old and new
191
152
binaries. Check your
192
153
<code class="filename">inetd.conf</code> or
193
154
<code class="filename">xinetd.conf</code> configuration
194
if they really point to the new binary.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2481524"></a><a name="id2481526"></a><p><b>4.</b></p></td><td align="left" valign="top"><p>While fetchnews is running, my modem hangs up.</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>
155
if they really point to the new binary.</p></td></tr><tr class="question" title="4."><td align="left" valign="top"><a name="id2487298"></a><a name="id2487300"></a><p><b>4.</b></p></td><td align="left" valign="top"><p>While fetchnews is running, my modem hangs up.</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>
195
156
An article that causes the interruption may contain
196
three plus signs in a row (“<span class="quote">+++</span>”), which
157
three plus signs in a row (<span class="quote">“<span class="quote">+++</span>”</span>), which
197
158
many modems interpret as the beginning of a command.
198
You can change or disable this “<span class="quote">escape</span>”
159
You can change or disable this <span class="quote">“<span class="quote">escape</span>”</span>
199
160
sequence. Consult your modem's manual, register S2 is
200
161
a common place to configure this.
201
</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2481551"></a><a name="id2481552"></a><p><b>5.</b></p></td><td align="left" valign="top"><p>How can I run fetchnews as regular user (not
202
root)?</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>For security reasons, this is not possible.</p><p>However, there is a tool named “<span class="quote">sudo</span>”
162
</p></td></tr><tr class="question" title="5."><td align="left" valign="top"><a name="id2487325"></a><a name="id2487326"></a><p><b>5.</b></p></td><td align="left" valign="top"><p>How can I run fetchnews as regular user (not
163
root)?</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>For security reasons, this is not possible.</p><p>However, there is a tool named <span class="quote">“<span class="quote">sudo</span>”</span>
203
164
that allows a regular, unprivileged user to
204
165
impersonate another user, and this can be used to
205
enable a regular user to run fetchnews.</p><p>“<span class="quote">sudo</span>” is available from
206
<a class="ulink" href="http://www.courtesan.com/sudo/" target="_top">http://www.courtesan.com/sudo/</a>.</p><p>If “<span class="quote">sudo</span>” is installed on your
166
enable a regular user to run fetchnews.</p><p><span class="quote">“<span class="quote">sudo</span>”</span> is available from
167
<a class="ulink" href="http://www.courtesan.com/sudo/" target="_top">http://www.courtesan.com/sudo/</a>.</p><p>If <span class="quote">“<span class="quote">sudo</span>”</span> is installed on your
207
168
system, then run
208
169
<strong class="userinput"><code>visudo</code></strong> as root and
209
170
add this line:
210
171
</p><pre class="programlisting">username ALL = (news) NOPASSWD: /path/to/fetchnews</pre><p>
211
172
Remember to replace
212
“<span class="quote">username</span>” and “<span class="quote">/path/to/</span>” with the
173
<span class="quote">“<span class="quote">username</span>”</span> and <span class="quote">“<span class="quote">/path/to/</span>”</span> with the
213
174
user's login and the proper path to
214
175
fetchnews.</p><p>Now, the user who has been enabled access to fetchnews can
215
176
just type <strong class="userinput"><code>sudo -u news
216
177
/path/to/fetchnews</code></strong>
217
to run fetchnews.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2481622"></a><a name="id2481624"></a><p><b>6.</b></p></td><td align="left" valign="top"><p>I have unsubscribed from a newsgroup, but
178
to run fetchnews.</p></td></tr><tr class="question" title="6."><td align="left" valign="top"><a name="id2487399"></a><a name="id2487401"></a><p><b>6.</b></p></td><td align="left" valign="top"><p>I have unsubscribed from a newsgroup, but
218
179
fetchnews still pulls articles for that group.</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>Your news reader talks to leafnode via the NNTP
219
180
protocol. This protocol provides no means for Leafnode to
220
181
determine which newsgroups you are actually subscribe.
228
189
<code class="filename">/var/spool/news/interesting.groups/</code>
229
190
directory. The articles that are already in your spool are
230
191
still subject to the regular <span class="command"><strong>texpire</strong></span>
231
schedule, however.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2529591"></a><a name="id2529592"></a><p><b>7.</b></p></td><td align="left" valign="top"><p>How do I stop fetchnews from unsubscribing from
192
schedule, however.</p></td></tr><tr class="question" title="7."><td align="left" valign="top"><a name="id2535528"></a><a name="id2535529"></a><p><b>7.</b></p></td><td align="left" valign="top"><p>How do I stop fetchnews from unsubscribing from
232
193
newsgroups?</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>Make sure that your newsreader issues
233
194
GROUP or LIST ACTIVE commands for each of
234
195
the groups it is subscribed to when checking
237
198
instance, a newsreader configured to read
238
199
the whole active file with a LIST command
239
200
may lose subscriptions for low-traffic
240
groups. <a class="link" href="#gnus" title="Question">See also the Gnus
201
groups. <a class="link" href="#gnus" title="Q:">See also the Gnus
241
202
FAQ below.</a></p><p>As a last resort, change your cron job or
242
203
ip-up script to run
243
204
<strong class="userinput"><code>fetchnews -n</code></strong> rather than just
244
<strong class="userinput"><code>fetchnews</code></strong>.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2529629"></a><a name="id2529630"></a><p><b>8.</b></p></td><td align="left" valign="top"><p>fetchnews is slow, how do I
205
<strong class="userinput"><code>fetchnews</code></strong>.</p></td></tr><tr class="question" title="8."><td align="left" valign="top"><a name="id2535566"></a><a name="id2535567"></a><p><b>8.</b></p></td><td align="left" valign="top"><p>fetchnews is slow, how do I
245
206
speed it up?</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>If you are using filters, try the
246
207
article_despite_filter option (introduced in
247
208
leafnode v1.9.33).</p><p>If your upstream server does not support
248
209
XOVER, try using as few of the
249
210
maxage, maxlines, maxbytes, minlines,
250
maxcrosspost options as possible.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2529650"></a><a name="id2529651"></a><p><b>9.</b></p></td><td align="left" valign="top"><p>fetchnews keeps downloading the full newsgroup list
211
maxcrosspost options as possible.</p></td></tr><tr class="question" title="9."><td align="left" valign="top"><a name="id2535586"></a><a name="id2535588"></a><p><b>9.</b></p></td><td align="left" valign="top"><p>fetchnews keeps downloading the full newsgroup list
251
212
every time it runs</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>Watch the fetchnews output for error messages, if you see a
252
213
message such as <code class="computeroutput">Reading newsgroups descriptions
253
214
failed: 501 bad command usage.</code> then try adding
254
215
<strong class="userinput"><code>nodesc = 1</code></strong> blow the
255
server=news.example.org line of the server that showed this error.</p></td></tr></tbody></table></div></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2529680"></a>texpire</h4></div></div></div><div class="qandaset"><dl><dt>1. <a href="#id2529687">Texpire does not expire
256
articles.</a></dt><dt>2. <a href="#id2529713">Texpire message.id counts do
257
not match the sum of the group counts!</a></dt></dl><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="id2529687"></a><a name="id2529688"></a><p><b>1.</b></p></td><td align="left" valign="top"><p>Texpire does not expire
216
server=news.example.org line of the server that showed this error.</p></td></tr></tbody></table></div></div><div class="sect3" title="texpire"><div class="titlepage"><div><div><h4 class="title"><a name="id2535617"></a>texpire</h4></div></div></div><div class="qandaset" title="Frequently Asked Questions"><a name="id2535622"></a><dl><dt>1. <a href="#id2535624">Texpire does not expire
217
articles.</a></dt><dt>2. <a href="#id2535650">Texpire message.id counts do
218
not match the sum of the group counts!</a></dt></dl><table border="0" width="100%" summary="Q and A Set"><col align="left" width="1%"><col><tbody><tr class="question" title="1."><td align="left" valign="top"><a name="id2535624"></a><a name="id2535625"></a><p><b>1.</b></p></td><td align="left" valign="top"><p>Texpire does not expire
258
219
articles.</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>The backup software
259
220
that you are using may not reset the atime after reading a
260
221
file. Check if you can reconfigure it to reset the
261
“<span class="quote">atime</span>”.</p><p>As a workaround, run
222
<span class="quote">“<span class="quote">atime</span>”</span>.</p><p>As a workaround, run
262
223
<strong class="userinput"><code>texpire -f</code></strong>. This will expire articles
263
224
somewhat earlier because expiry is then determined from the
264
225
time the file was last modified, rather than when it was last
265
accessed.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2529713"></a><a name="id2529714"></a><p><b>2.</b></p></td><td align="left" valign="top"><p>Texpire message.id counts do
226
accessed.</p></td></tr><tr class="question" title="2."><td align="left" valign="top"><a name="id2535650"></a><a name="id2535651"></a><p><b>2.</b></p></td><td align="left" valign="top"><p>Texpire message.id counts do
266
227
not match the sum of the group counts!</p></td></tr><tr class="answer"><td align="left" valign="top"></td><td align="left" valign="top"><p>This may happen if texpire has been
267
228
interrupted previously, crashed, some other
268
application touched the spool or the spool is corrupt.</p></td></tr></tbody></table></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529730"></a>Problems with particular newsreaders</h3></div></div></div><div class="qandaset"><dl><dt>Q: <a href="#id2529739">leafnode loses subscriptions of low-traffic
269
groups with Gnus.</a></dt><dt>Q: <a href="#id2529771">When searching news with Netscape, I only get back
270
“unknown command”.</a></dt><dt>Q: <a href="#id2529806">Outlook Express locks up.</a></dt><dt>Q: <a href="#id2529839">Tin complains about a missing file
271
/var/lib/news/active.</a></dt></dl><table border="0" summary="Q and A Set"><col align="left" width="1%"><tbody><tr class="question"><td align="left" valign="top"><a name="id2529739"></a><a name="gnus"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>leafnode loses subscriptions of low-traffic
229
application touched the spool or the spool is corrupt.</p></td></tr></tbody></table></div></div></div><div class="sect2" title="Problems with particular newsreaders"><div class="titlepage"><div><div><h3 class="title"><a name="id2535667"></a>Problems with particular newsreaders</h3></div></div></div><div class="qandaset" title="Frequently Asked Questions"><a name="id2535672"></a><dl><dt>Q: <a href="#id2535676">leafnode loses subscriptions of low-traffic
230
groups with Gnus.</a></dt><dt>Q: <a href="#id2535708">leafnode loses subscriptions of low-traffic
231
groups with slrn.</a></dt><dt>Q: <a href="#id2535733">When searching news with Netscape, I only get back
232
“unknown command”.</a></dt><dt>Q: <a href="#id2535768">Outlook Express locks up.</a></dt><dt>Q: <a href="#id2535802">Tin complains about a missing file
233
/var/lib/news/active.</a></dt></dl><table border="0" width="100%" summary="Q and A Set"><col align="left" width="1%"><col><tbody><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2535676"></a><a name="gnus"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>leafnode loses subscriptions of low-traffic
272
234
groups with Gnus.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Check the setting of gnus-read-active-file (you
273
235
can use customize-variable to do that), it should be
274
236
<strong class="userinput"><code>'some</code></strong> or
275
237
<strong class="userinput"><code>nil</code></strong>.
276
</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2529771"></a><a name="id2529773"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>When searching news with Netscape, I only get back
277
“<span class="quote">unknown command</span>”.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>
238
</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2535708"></a><a name="slrn"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>leafnode loses subscriptions of low-traffic
239
groups with slrn.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>Check the setting of read_active, it should be
240
<strong class="userinput"><code>0</code></strong> (the default).
241
</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2535733"></a><a name="id2535735"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>When searching news with Netscape, I only get back
242
<span class="quote">“<span class="quote">unknown command</span>”</span>.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>
278
243
To search news, older versions of Netscape needed a
279
244
news server which supports the XPAT command.
280
245
Leafnode-1 does not. If you want to use Netscape, you
281
246
have to upgrade to version 4.5 and press the
282
“<span class="quote">options</span>” button which appears in the
283
“<span class="quote">search
284
messages</span>” window. In the box which appears you have
285
to select “<span class="quote">on your local system</span>”.
286
</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2529806"></a><a name="id2529808"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Outlook Express locks up.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>
247
<span class="quote">“<span class="quote">options</span>”</span> button which appears in the
248
<span class="quote">“<span class="quote">search
249
messages</span>”</span> window. In the box which appears you have
250
to select <span class="quote">“<span class="quote">on your local system</span>”</span>.
251
</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2535768"></a><a name="id2535770"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Outlook Express locks up.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>
287
252
This can be caused by a corrupted <code class="filename">inbox</code>
288
253
file in Outlook Express. It is said to happen during the
289
254
initial install of Internet Explorer. To fix this problem,
290
go to “<span class="quote">Add/Remove Programs</span>”, choose
291
“<span class="quote">Internet Explorer</span>”, then “<span class="quote">Repair
292
installation.</span>”
255
go to <span class="quote">“<span class="quote">Add/Remove Programs</span>”</span>, choose
256
<span class="quote">“<span class="quote">Internet Explorer</span>”</span>, then <span class="quote">“<span class="quote">Repair
257
installation.</span>”</span>
293
258
</p><p>Thanks to Jim Gifford who talked to Microsoft to
294
find this solution.</p></td></tr><tr class="question"><td align="left" valign="top"><a name="id2529839"></a><a name="id2529841"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Tin complains about a missing file
259
find this solution.</p></td></tr><tr class="question" title="Q:"><td align="left" valign="top"><a name="id2535802"></a><a name="id2535804"></a><p><b>Q:</b></p></td><td align="left" valign="top"><p>Tin complains about a missing file
295
260
<code class="filename">/var/lib/news/active</code>.</p></td></tr><tr class="answer"><td align="left" valign="top"><p><b>A:</b></p></td><td align="left" valign="top"><p>
296
261
Either you have started the wrong version of tin (the one
297
262
which tries to read news directly from the spool) or your
302
267
this does not help, try to rebuild the
303
268
groupinfo file by running
304
269
<strong class="userinput"><code>fetchnews -f</code></strong>.
305
</p></td></tr></tbody></table></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="backtrace"></a>Obtaining a stack backtrace</h2></div></div></div><p>This section will tell you how to obtain a <span class="emphasis"><em>stack
270
</p></td></tr></tbody></table></div></div></div><div class="sect1" title="Obtaining a stack backtrace"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="backtrace"></a>Obtaining a stack backtrace</h2></div></div></div><p>This section will tell you how to obtain a <span class="emphasis"><em>stack
306
271
backtrace</em></span>, a special program state output that is
307
272
very useful to somebody who is about to debug a crash.</p><p>The prerequisite to work is that the program is
308
273
<span class="emphasis"><em>not stripped</em></span>, i. e. it contains the debug
316
281
<code class="filename">/usr/sbin/leafnode</code> instead), here is a sample
317
282
output of an unstripped program:</p><pre class="screen"><code class="prompt">$</code> <strong class="userinput"><code>file /usr/local/sbin/leafnode</code></strong>
318
283
<code class="computeroutput">/usr/local/sbin/leafnode: ELF 32-bit LSB executable, Intel 80386, version 1,
319
dynamically linked (uses shared libs), not stripped</code></pre><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2529968"></a>From a core file.</h3></div></div></div><p>This is simple:
320
</p><div class="orderedlist"><ol type="1"><li><p>Type <strong class="userinput"><code>gdb
284
dynamically linked (uses shared libs), not stripped</code></pre><div class="sect2" title="From a core file."><div class="titlepage"><div><div><h3 class="title"><a name="id2535930"></a>From a core file.</h3></div></div></div><p>This is simple:
285
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Type <strong class="userinput"><code>gdb
321
286
<em class="replaceable"><code>PROGRAM</code></em>
322
287
core</code></strong>. Replace
323
288
PROGRAM by the name of the
324
289
program that crashed, for
325
example fetchnews.</p></li><li><p>Type <strong class="userinput"><code>backtrace
326
full</code></strong>.</p></li><li><p>Type
290
example fetchnews.</p></li><li class="listitem"><p>Type <strong class="userinput"><code>backtrace
291
full</code></strong>.</p></li><li class="listitem"><p>Type
327
292
<strong class="userinput"><code>quit</code></strong>.</p></li></ol></div><p>
328
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530016"></a>Running a program under gdb supervision.</h3></div></div></div><div class="orderedlist"><ol type="1"><li><p>Type <strong class="userinput"><code>gdb
293
</p></div><div class="sect2" title="Running a program under gdb supervision."><div class="titlepage"><div><div><h3 class="title"><a name="id2535978"></a>Running a program under gdb supervision.</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Type <strong class="userinput"><code>gdb
329
294
<em class="replaceable"><code>PROGRAM</code></em></code></strong>.
330
295
Replace PROGRAM by the name of the program that
331
296
crashes, for example fetchnews. Do not give any program
332
options, gdb does not understand them here.</p></li><li><p>Type <strong class="userinput"><code>run
297
options, gdb does not understand them here.</p></li><li class="listitem"><p>Type <strong class="userinput"><code>run
333
298
<em class="replaceable"><code>OPTIONS</code></em></code></strong>, where
334
299
you name the options that you would normally pass to the
335
300
program itself. Just a plain
336
301
<strong class="userinput"><code>run</code></strong> is
337
also fine.</p></li><li><p>Wait until the program crashes. The output might
302
also fine.</p></li><li class="listitem"><p>Wait until the program crashes. The output might
338
303
look like similar to this:</p><pre class="screen"><code class="computeroutput">
339
304
This GDB was configured as "i686-pc-linux-gnu"...</code>
340
305
<code class="prompt">(gdb)</code> <strong class="userinput"><code>run -vvn</code></strong>
345
310
main () at crashme.c:4
346
311
4 *x = 4;
347
312
<code class="prompt">(gdb)</code>
348
</code></pre></li><li><p>Type <strong class="userinput"><code>backtrace
313
</code></pre></li><li class="listitem"><p>Type <strong class="userinput"><code>backtrace
349
314
full</code></strong>, this is the
350
desired <span class="emphasis"><em>stack backtrace</em></span>.</p></li><li><p>Type <strong class="userinput"><code>quit</code></strong> to leave
351
gdb.</p></li></ol></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2530124"></a>From a running/hanging leafnode
352
program.</h3></div></div></div><div class="orderedlist"><ol type="1"><li><p>Find out the Process
315
desired <span class="emphasis"><em>stack backtrace</em></span>.</p></li><li class="listitem"><p>Type <strong class="userinput"><code>quit</code></strong> to leave
316
gdb.</p></li></ol></div></div><div class="sect2" title="From a running/hanging leafnode program."><div class="titlepage"><div><div><h3 class="title"><a name="id2536086"></a>From a running/hanging leafnode
317
program.</h3></div></div></div><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>Find out the Process
353
318
ID of the hanging leafnode
354
319
program. Type
355
320
<strong class="userinput"><code>ps axw | grep
365
330
like:
366
331
</p><pre class="screen"> 1995 ? S 0:00 /usr/local/sbin/leafnode
367
332
</pre><p> 1995 is the
368
Process ID.</p></li><li><p>Then attach gdb:
333
Process ID.</p></li><li class="listitem"><p>Then attach gdb:
369
334
<strong class="userinput"><code>gdb
370
335
<em class="replaceable"><code>PROGRAM</code></em>
371
336
<em class="replaceable"><code>12345</code></em></code></strong>,
374
339
program's name and
375
340
<em class="replaceable"><code>12345</code></em>
376
341
by the PID that you have just
377
found out.</p></li><li><p>Type
342
found out.</p></li><li class="listitem"><p>Type
378
343
<strong class="userinput"><code>backtrace
379
full</code></strong>.</p></li><li><p>Type
380
<strong class="userinput"><code>detach</code></strong>.</p></li><li><p>Type
381
<strong class="userinput"><code>quit</code></strong>.</p></li></ol></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="redhat-xinetd"></a>Red Hat and the inetd vs. xinetd issue.</h2></div><div><div class="author"><h3 class="author"><span class="firstname">William</span> <span class="surname">Hooper</span></h3></div></div></div></div><p>RedHat Linux has changed stance on <span class="application">inetd</span>/<span class="application">xinetd</span>
344
full</code></strong>.</p></li><li class="listitem"><p>Type
345
<strong class="userinput"><code>detach</code></strong>.</p></li><li class="listitem"><p>Type
346
<strong class="userinput"><code>quit</code></strong>.</p></li></ol></div></div></div><div class="sect1" title="Red Hat and the inetd vs. xinetd issue."><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="redhat-xinetd"></a>Red Hat and the inetd vs. xinetd issue.</h2></div><div><div class="author"><h3 class="author"><span class="firstname">William</span> <span class="surname">Hooper</span></h3></div></div></div></div><p>RedHat Linux has changed stance on <span class="application">inetd</span>/<span class="application">xinetd</span>
382
347
over the years. In the 6.x version, <span class="application">inetd</span> was used, while
383
348
<span class="application">xinetd</span> is used in the 7.x series and 8.0. Note in the
384
349
following I make the assumption that the "Gnome workstation"
402
367
dependency. </p><p>In cases where <span class="application">inetd</span> is not installed, no other RPMs
403
368
are required to install it. This means to install it you
404
369
have three options (for RedHat 6.2 substitute <span class="application">inetd</span> instead of
405
<span class="application">xinetd</span>): </p><div class="orderedlist"><ol type="1"><li><p><span class="emphasis"><em>Best</em></span>
370
<span class="application">xinetd</span>): </p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p><span class="emphasis"><em>Best</em></span>
406
371
- If you have registered for Redhat's up2date
407
372
service, just type "up2date xinetd" as
408
root.</p></li><li><p><span class="emphasis"><em>Next Best</em></span>
373
root.</p></li><li class="listitem"><p><span class="emphasis"><em>Next Best</em></span>
409
374
- Install RPM from updates.redhat.com (version
410
375
numbers current as of 2002-11-10 for RH 7.3). You
411
376
can manually download the RPM and install it (as
413
378
xinetd-2.3.9-0.73.i386.rpm</code></strong>, or have
414
379
RPM download it for you by using (again, as root)
415
380
<strong class="userinput"><code>rpm -ivh
416
http://updates.redhat.com/7.3/en/os/i386/xinetd-2.3.9-0.73.i386.rpm</code></strong></p></li><li><p><span class="emphasis"><em>Worse</em></span>
381
http://updates.redhat.com/7.3/en/os/i386/xinetd-2.3.9-0.73.i386.rpm</code></strong></p></li><li class="listitem"><p><span class="emphasis"><em>Worse</em></span>
417
382
- Install the RPM from the original CD. This is usually the worse
418
383
option because the updates (used above) are released to fix security issues.
419
384
</p><p>
Loggerhead is a web-based interface for Breezy
Version: 2.0.1