<html>
<head>
<title>Troubleshooting</title>
<link rel="stylesheet" href="camstream.css" type="text/css">
</head>
<body>
<p><a href="index.html" target="_top">Frames</a></p>
<h1>Troubleshooting</h1>
<p>Here are some common problems users have encountered while running or
compiling CamStream. You may find the answer to your question here if you
are having trouble.</p>
<h2>Index</h2>
<p>
<ol>
<li><a href="#sec1">Building problems</a>
<ol>
<li><a href="#sec1.1">Qt library/headerfiles not found</a></li>
<li><a href="#sec1.2">Qt 3</a></li>
</ol>
</li>
<li><a href="#sec2">Running CamStream</a>
<ol>
<li><a href="#sec2.1">Crash after a few minutes of uploading</a>
</ol>
</li>
</ol>
<h2><a name="sec1">Building problems</a></h2>
<h3><a name="sec1.1">Qt library/headerfiles not found</a></h3>
<p>A common problem is that Linux distributors place the Qt libraries
at the weirdest places... The <span class="filename">configure</span> script
checks the most common directories, but can't really test them all. So, if
<span class="filename">configure</span> complains it can't locate the Qt
libraries, you must first set the QTDIR environment variable (this is a
requirement anyhow). So, if your Qt libraries are placed in, for example,
<span class="filedir">/usr/lib/qt-2.3.0</span>, try this:
<p><pre>
# QTDIR=/usr/lib/qt-2.3.0
# export QTDIR
# ./configure [options]
</pre>
<p>This is also the location where the <span class="filename">uic</span>
User Interface Compiler and <span class="filename">moc</span> pre-processor
are supposed to be. If not, make sure these can be found in your PATH!</p>
<p>Another source of confusion is that often the library is present, but not
the header files. It turns out that some distributors (Red Hat, SuSe) split
the Qt package in two parts: just the library, and the header files and
development tools. On your system only the library is installed (this
appears to be the default), which is enough to run programs but not to
compile them!</p>
<p>In that case you have to install the 'qt-dev' package as well. For
example, if you installed the <b>qt-3.0.3</b> rpm on Red Hat, you must
install <b>qt-devel-3.0.3</b> too. Of course the version numbers have to
match! The package name may be slightly different for different systems.</p>
<h3><a name="sec1.2">Qt 3.*</a></h3>
<p>Compilation fails under Qt 3.* with the following error:
<pre>
c++ -I/usr/include/qt -g -Wall -I. -I.. -I../devices -I../video -DHAVE_CONFIG_H -c -o SnapshotSettingsDlg.moc.o SnapshotSettingsDlg.moc.cc
In file included from SnapshotSettingsDlg.h:8,
from SnapshotSettingsDlg.moc.cc:11:
../VideoOptions.h:17: syntax error before ;'
make[1]: *** [SnapshotSettingsDlg.moc.o] Error 1
make[1]: Leaving directory /usr/src/camstream-0.25/src/gui'
make: *** [subdirs] Error 2
</pre>
<p>This is due to incompatibilities in the header files. You should use Qt
2.2.* or 2.3.*; you can install this Qt library parallel to Qt 1.* and Qt
3.*; just make sure your QTDIR environment variable points to the correct
path.</p>
<p>I do not intend to port CamStream to Qt 3 yet. The reason is that it
involves upgrading the .ui files (used for dialog design), and once I've
done that, there is no way back. In other words, I would force users to
upgrade/install Qt 3 and I don't want to do that now.</p>
<h2><a name="sec2">Running CamStream</a></h2>
<p>This sections lists problems and bugs that are encountered when
running the program.</p>
<h3><a name="sec2.1">Crash after a few minutes of uploading</a></h3>
<p>(This applies to CamStream 0.25)</p>
<p>After 10-15 minutes of FTP-ing images to the server, the program may
crash. This is due to a bug in the Qt libraries, when the first FTP
connection to the server times out and gets closed remotely. I mailed
Trolltech about it and they are aware of the problem, but basicly they tell
me they are much more busy with other bugs :-(. I am not satisfied with
their FTP class anyway. It lacks a number of features and their
implementation is quite braindead (it opens a new connection for every FTP
session, even to the same computer and account). This problem has been
reported in Qt 2.2.2, 2.2.4 and 2.3.0.</p>
</body>
</html>
