| 1 | <? |
|---|
| 2 | include "header.php"; |
|---|
| 3 | ?> |
|---|
| 4 | |
|---|
| 5 | <div id="content" > |
|---|
| 6 | |
|---|
| 7 | <div id="main"><img src="images/main_title_faqs.gif" alt="Faqs" /></div> |
|---|
| 8 | <div id="maincontent"> |
|---|
| 9 | <div id="subcontent"> |
|---|
| 10 | |
|---|
| 11 | <!-- News Item Begin--> |
|---|
| 12 | <div class="news"> |
|---|
| 13 | <h2>Licq FAQ</h2> |
|---|
| 14 | <h3>September 30, 2004</h3> |
|---|
| 15 | |
|---|
| 16 | <p> |
|---|
| 17 | Originally written by Graham Roff<br> |
|---|
| 18 | Rewritten by Jon Keating |
|---|
| 19 | </p> |
|---|
| 20 | <div class="footer"> |
|---|
| 21 | <div class="footer_right"></div> |
|---|
| 22 | </div> |
|---|
| 23 | </div> |
|---|
| 24 | <!-- News Item End--> |
|---|
| 25 | |
|---|
| 26 | <!-- News Item Begin--> |
|---|
| 27 | <div class="news"> |
|---|
| 28 | <h2>Section 1: Basics</h2> |
|---|
| 29 | <p> |
|---|
| 30 | <blockquote> |
|---|
| 31 | <A HREF="#1_1">1.1: Who wrote Licq?</A><BR> |
|---|
| 32 | <A HREF="#1_2">1.2: What does Licq stand for anyway?</A><BR> |
|---|
| 33 | <A HREF="#1_3">1.3: Is Licq based on micq code like many of the other clones?</A><BR> |
|---|
| 34 | </blockquote> |
|---|
| 35 | </p> |
|---|
| 36 | |
|---|
| 37 | <h3>Section 2: Compiling / Installing</h3> |
|---|
| 38 | <blockquote> |
|---|
| 39 | <A HREF="#2_1">2.1: What is needed to compile Licq?</A><BR> |
|---|
| 40 | <A HREF="#2_2">2.2: How do I get Licq working through a SOCKS5 server?</A><BR> |
|---|
| 41 | |
|---|
| 42 | <A HREF="#2_3">2.3: How do I do a manual install (ie I have a binary distribution)?</A><BR> |
|---|
| 43 | <A HREF="#2_4">2.4: I am trying to compile with Solaris and the compilation freezes at the "moc" line.</A><BR> |
|---|
| 44 | <A HREF="#2_5">2.5: I am compiling under Solaris and I get an internal error.</A><BR> |
|---|
| 45 | <A HREF="#2_6">2.6: I am using an older compiler (ie gcc 2.7) and get errors about ANSI C++ not allowing implicit casting of "void *".</A><BR> |
|---|
| 46 | <A HREF="#2_7">2.7: What is socklen_t?</A><BR> |
|---|
| 47 | </blockquote> |
|---|
| 48 | |
|---|
| 49 | <h3>Section 3: Using</h3> |
|---|
| 50 | <blockquote> |
|---|
| 51 | <A HREF="#3_1">3.1: Where do I get a uin from?</A><BR> |
|---|
| 52 | <A HREF="#3_2">3.2: Does multi-party chat work?</A><BR> |
|---|
| 53 | <A HREF="#3_3">3.3: What is, and how do I use, the licq fifo?</A><BR> |
|---|
| 54 | <A HREF="#3_4">3.4: What happened to the "beep" OnEvent option, or, how do I make the pc-speaker beep when receiving a message?</A><BR> |
|---|
| 55 | <A HREF="#3_5">3.5: Licq appears 5 times in my process list, what's going on?</A><BR> |
|---|
| 56 | <A HREF="#3_6">3.6: I get "[ERR] Unable to allocate TCP port for local server (Unknown host)" when I start Licq.</A><BR> |
|---|
| 57 | <A HREF="#3_7">3.7: What happened to the spoof uin option?</A><BR> |
|---|
| 58 | <A HREF="#3_8">3.8: I am using ip_masq_icq module and it doesn't forward connections to Licq.</A><BR> |
|---|
| 59 | <A HREF="#3_9">3.9: How do I configure ipmasq for ICQ?</A><BR> |
|---|
| 60 | |
|---|
| 61 | <A HREF="#3_10">3.10: I can't connect to ICQ, all I get are timeouts!</A><BR> |
|---|
| 62 | <A HREF="#3_11">3.11: Does Licq support server side contact lists?</A><BR> |
|---|
| 63 | </blockquote> |
|---|
| 64 | |
|---|
| 65 | <h3>Section 4: Plugins</h3> |
|---|
| 66 | <BLOCKQUOTE> |
|---|
| 67 | <A HREF="#4_1">4.1: I get something about being unable to load a plugin because "file not found" or "no such file or directory".</A><BR> |
|---|
| 68 | <A HREF="#4_2">4.2: I get something about "undefined symbol: ..." when I try and load the Qt-GUI plugin.</A><BR> |
|---|
| 69 | <A HREF="#4_3">4.3: Licq starts up but then exits with "licq: Fatal IO error: client killed".</A><BR> |
|---|
| 70 | |
|---|
| 71 | <A HREF="#4_4">4.4: What does "undefined symbol: LP_Main" mean?</A><BR> |
|---|
| 72 | <A HREF="#4_5">4.5: Qt-gui crashes on startup, it says something about "XRegisterIMInstantiateCallback"</A><BR> |
|---|
| 73 | <A HREF="#4_6">4.6: When Licq is docked it is still visible in the taskbar, what can i do?"</A><BR> |
|---|
| 74 | </BLOCKQUOTE> |
|---|
| 75 | |
|---|
| 76 | <h3>Section 5: Qt-GUI Plugin</h3> |
|---|
| 77 | <BLOCKQUOTE> |
|---|
| 78 | <A HREF="#5_1">5.1: The GUI says it is unable to load <file>.xpm or <file>.gif, but the file is there!</A><BR> |
|---|
| 79 | |
|---|
| 80 | <A HREF="#5_2">5.2: How do I change the colors of the Qt-Gui?</A><BR> |
|---|
| 81 | <A HREF="#5_3">5.3: Why are there no spaces between words in the History tab?</A><BR> |
|---|
| 82 | <A HREF="#5_4">5.4: How do I dock the Licq icon?</A><BR> |
|---|
| 83 | <A HREF="#5_5">5.5: How do I see other encodings (Russian, Japanese, etc.)?</A><BR> |
|---|
| 84 | </BLOCKQUOTE> |
|---|
| 85 | |
|---|
| 86 | <h3>Section 6: Protocol Plugins</h3> |
|---|
| 87 | <BLOCKQUOTE> |
|---|
| 88 | <A HREF="#6_1">6.1: What protocols are available?</A><BR> |
|---|
| 89 | <A HREF="#6_2">6.2: How do I start using a protocol plugin?</A><BR> |
|---|
| 90 | </BLOCKQUOTE> |
|---|
| 91 | |
|---|
| 92 | <h3>Section 7: Donations</h3> |
|---|
| 93 | <BLOCKQUOTE> |
|---|
| 94 | <A HREF="#7_1">7.1: What are the operating expenses?</A><BR> |
|---|
| 95 | <A HREF="#7_2">7.2: What is the emergency fund?</A><BR> |
|---|
| 96 | <A HREF="#7_3">7.3: How do I know my donation is going to the project?</A><BR> |
|---|
| 97 | |
|---|
| 98 | <A HREF="#7_4">7.4: I donated money, will you add the feature I want?</A><BR> |
|---|
| 99 | </BLOCKQUOTE> |
|---|
| 100 | <div class="footer"> |
|---|
| 101 | <div class="footer_right"></div> |
|---|
| 102 | </div> |
|---|
| 103 | </div> |
|---|
| 104 | <!-- News Item End--> |
|---|
| 105 | |
|---|
| 106 | <!-- News Item Begin--> |
|---|
| 107 | <div class="news"> |
|---|
| 108 | |
|---|
| 109 | <H3><STRONG>Section 1: Basics</STRONG></H3> |
|---|
| 110 | <P> |
|---|
| 111 | <A NAME="1_1"><STRONG>1.1: Who wrote Licq?</STRONG> |
|---|
| 112 | <P> |
|---|
| 113 | Licq was first begun as a text mode client to ICQ in February 1998 by |
|---|
| 114 | Graham Roff and a programmer who wishes for some strange |
|---|
| 115 | reason to remain anonymous. He's from Nova Scotia, perhaps that explains |
|---|
| 116 | things. The Qt port was written by Graham Roff and starting in June |
|---|
| 117 | 1998.<BR><BR> |
|---|
| 118 | Since then the entire code was rewritten by Graham Roff, with the |
|---|
| 119 | assistance of numerous internet volunteers. The protocol plugin |
|---|
| 120 | rewrite of Licq was done by the current maintainer, Jon Keating. All |
|---|
| 121 | current development is done by Jon Keating, Thomas Reitelbach, and |
|---|
| 122 | many volunteers. |
|---|
| 123 | <P> |
|---|
| 124 | <BR> |
|---|
| 125 | |
|---|
| 126 | <A NAME="1_2"><STRONG>1.2: What does Licq stand for anyway?</STRONG> |
|---|
| 127 | <P> |
|---|
| 128 | Contrary to popular belief, it does not stand for Linux ICQ. This |
|---|
| 129 | would be (a) a bit conceited, and (b) way too obvious a name for a linux |
|---|
| 130 | program. |
|---|
| 131 | <P> |
|---|
| 132 | <BR> |
|---|
| 133 | |
|---|
| 134 | <A NAME="1_3"><STRONG>1.3: Is Licq based on micq code like many of the other clones? </STRONG> |
|---|
| 135 | <P> |
|---|
| 136 | Licq was begun a long time before micq was released and is based |
|---|
| 137 | completely on original source code. It is also done in C++ as opposed to C |
|---|
| 138 | like micq and most of the other clones. |
|---|
| 139 | <P> |
|---|
| 140 | <BR> |
|---|
| 141 | |
|---|
| 142 | <H3><STRONG>Section 2: Compiling and Installing</STRONG></H3> |
|---|
| 143 | <P> |
|---|
| 144 | |
|---|
| 145 | <A NAME="2_1"><STRONG>2.1: What is needed to compile Licq?</STRONG> |
|---|
| 146 | <P> |
|---|
| 147 | See the web page in the info section under Requirements for all the details. |
|---|
| 148 | <P> |
|---|
| 149 | <BR> |
|---|
| 150 | |
|---|
| 151 | <A NAME="2_2"><STRONG>2.2: How do I get Licq working with a SOCKS5 server?</STRONG> |
|---|
| 152 | <P> |
|---|
| 153 | I do not use socks, and didn't write the code to make Licq work with |
|---|
| 154 | socks. After configuring with --enable-socks5 you have to set some environment |
|---|
| 155 | variables as well, follow the guidelines that come with the socks5 client. |
|---|
| 156 | Other than that, I can't help you. Try the README.SOCKS included with the |
|---|
| 157 | Licq distribution. |
|---|
| 158 | <P> |
|---|
| 159 | <BR> |
|---|
| 160 | |
|---|
| 161 | <A NAME="2_3"><STRONG>2.3: How do I do a manual install (ie I have a binary distribution)?</STRONG> |
|---|
| 162 | <P> |
|---|
| 163 | <EM>&lt;= 0.61</EM><BR> |
|---|
| 164 | Easy, first copy the binary to somewhere nice (like /usr/local/bin). |
|---|
| 165 | Then copy licq-base.tar.gz to /usr/local/share. There are some other |
|---|
| 166 | interesting documents to look at if you want as well. Then run licq and it |
|---|
| 167 | should finish the install for you. See, it's easy.<BR> |
|---|
| 168 | <EM>&gt;= 0.70</EM><BR> |
|---|
| 169 | Copy the binary somewhere nice like above. Then copy everything from the |
|---|
| 170 | share/ directory to /usr/local/share/licq. To manually install a plugin simply |
|---|
| 171 | copy it to /usr/local/lib/licq/plugins. |
|---|
| 172 | |
|---|
| 173 | <P> |
|---|
| 174 | <BR> |
|---|
| 175 | |
|---|
| 176 | <A NAME="2_4"><STRONG>2.4: I am trying to compile and the compilation freezes at the "moc" line.</STRONG> |
|---|
| 177 | <P> |
|---|
| 178 | Licq requires GNU make to compiler properly. Alternatively, |
|---|
| 179 | you can compile all the moc files by hand doing:<BR> |
|---|
| 180 | $> moc <infile> -o <outfile><BR> |
|---|
| 181 | The list of files to moc is in the Makefile. If you do this, you will |
|---|
| 182 | still have to replace the $^ in the following section:<BR> |
|---|
| 183 | |
|---|
| 184 | ++ licq: $(OBJECTS) $(METAOBJ)<BR> |
|---|
| 185 | ++ $(CXX) $(CXXFLAGS) -o $@ $^ $(LDFLAGS) $(LDLIBS)<BR> |
|---|
| 186 | to be:<BR> |
|---|
| 187 | ++ licq: $(OBJECTS) $(METAOBJ)<BR> |
|---|
| 188 | ++ $(CXX) $(CXXFLAGS) -o $@ $(OBJECTS) $(METAOBJ) $(LDFLAGS) $(LDLIBS)<BR> |
|---|
| 189 | <P> |
|---|
| 190 | <BR> |
|---|
| 191 | |
|---|
| 192 | <A NAME="2_5"><STRONG>2.5: I am compiling and I get an internal error.</STRONG> |
|---|
| 193 | <P> |
|---|
| 194 | This is a problem with some versions of g++. Simply remove <EM>-O2</EM> |
|---|
| 195 | |
|---|
| 196 | from the relevant Makefile and it should work fine. |
|---|
| 197 | <P> |
|---|
| 198 | <BR> |
|---|
| 199 | |
|---|
| 200 | <A NAME="2_6"><STRONG>2.6: I get errors about ANSI C++ not allowing implicit casting of "void *".</STRONG> |
|---|
| 201 | <P> |
|---|
| 202 | Some older implementations of libstdc++ erroneously define NULL as being |
|---|
| 203 | ((void *)0), which causes some c++ compilers to complain. If this is the case, |
|---|
| 204 | you can either upgrade to a newer compiler or simply run the "remove-null.sh" (included |
|---|
| 205 | with the licq-data package in <EM>contrib</EM>) |
|---|
| 206 | inside the <EM>src/</EM> directory, which will replace all NULL's with zeros. |
|---|
| 207 | <P> |
|---|
| 208 | <BR> |
|---|
| 209 | |
|---|
| 210 | <A NAME="2_7"><STRONG>2.7: What is socklen_t?</STRONG> |
|---|
| 211 | |
|---|
| 212 | <P> |
|---|
| 213 | If you get compile errors refering to socklen_t simply edit config.h and |
|---|
| 214 | add "#define socklen_t int" to it somewhere. |
|---|
| 215 | <P> |
|---|
| 216 | <BR> |
|---|
| 217 | |
|---|
| 218 | |
|---|
| 219 | <H3><STRONG>Section 3: Using</STRONG></H3> |
|---|
| 220 | <P> |
|---|
| 221 | |
|---|
| 222 | |
|---|
| 223 | <A NAME="3_1"><STRONG>3.1: How do I get a uin?</STRONG> |
|---|
| 224 | <P> |
|---|
| 225 | Licq can register a new user with Mirabilis. Just select "Register User" from |
|---|
| 226 | the user menu. See http://www.mirabilis.com for more info. |
|---|
| 227 | <P> |
|---|
| 228 | <BR> |
|---|
| 229 | |
|---|
| 230 | <A NAME="3_2"><STRONG>3.2: Does multi-party chat work?</STRONG> |
|---|
| 231 | <P> |
|---|
| 232 | Yes. |
|---|
| 233 | <P> |
|---|
| 234 | <BR> |
|---|
| 235 | |
|---|
| 236 | <A NAME="3_3"><STRONG>3.3: What is, and how do I use, the licq fifo?</STRONG> |
|---|
| 237 | <P> |
|---|
| 238 | |
|---|
| 239 | Please see the <A HREF="README.FIFO">README.FIFO</A> |
|---|
| 240 | <P> |
|---|
| 241 | <BR> |
|---|
| 242 | |
|---|
| 243 | <A NAME="3_4"><STRONG>3.4: What happened to the "beep" OnEvent option, or, how do I make the pc-speaker beep when receiving a message?</STRONG> |
|---|
| 244 | <P> |
|---|
| 245 | The beep command did not work properly and so was incorporated into a |
|---|
| 246 | self-contained executable (build beep.c in the contrib directory using the |
|---|
| 247 | instructions contained therein) which can be called instead of "play" (or |
|---|
| 248 | whatever) in order to generate a beep.<BR> |
|---|
| 249 | So to rephrase, instead of a beep option, you can build a "beep" executable, |
|---|
| 250 | and enter "beep" as the OnEvent Command (the parameters are irrelevant for |
|---|
| 251 | this command). |
|---|
| 252 | <P> |
|---|
| 253 | <BR> |
|---|
| 254 | |
|---|
| 255 | <A NAME="3_5"><STRONG>3.5: Licq appears 5 times in my process list, what's going on?</STRONG> |
|---|
| 256 | |
|---|
| 257 | <P> |
|---|
| 258 | There is really only 1 copy of Licq running, using the resources of one of |
|---|
| 259 | the listed processes. The reason you see multiple copies is that Linux |
|---|
| 260 | shows threads as separate processes. As Licq may be running 5 threads or more |
|---|
| 261 | at a time, multiple process entries will appear. |
|---|
| 262 | <P> |
|---|
| 263 | <BR> |
|---|
| 264 | |
|---|
| 265 | <A NAME="3_6"><STRONG>3.6: I get "[ERR] Unable to allocate TCP port for local server (Unknown host)" when I start Licq.</STRONG> |
|---|
| 266 | <P> |
|---|
| 267 | This will happen if you have not set up your hostname properly. This is a |
|---|
| 268 | necessary step for running many network applications. Make sure your hostname |
|---|
| 269 | (which can be found by typing "hostname") resolves to a valid ip. Typically |
|---|
| 270 | this involves adding it to /etc/hosts and setting the ip to your static ip or |
|---|
| 271 | to 127.0.0.1 if you don't have one. |
|---|
| 272 | <P> |
|---|
| 273 | <BR> |
|---|
| 274 | |
|---|
| 275 | <A NAME="3_7"><STRONG>3.7: What happened to the spoof uin option?</STRONG> |
|---|
| 276 | <P> |
|---|
| 277 | This is no longer supported by the ICQ protocol. Sorry. |
|---|
| 278 | <P> |
|---|
| 279 | <BR> |
|---|
| 280 | |
|---|
| 281 | |
|---|
| 282 | <A NAME="3_8"><STRONG>3.8: I am using ip_masq_icq module and it doesn't forward connections to Licq.</STRONG> |
|---|
| 283 | <P> |
|---|
| 284 | The ip_masq_icq module uses the ip contained in the logon packet to determine whether |
|---|
| 285 | or not to forward connections to your machine. This IP is determined typically |
|---|
| 286 | by looking at the hostname of the local machine. If your hostname is not set correctly |
|---|
| 287 | or cannot be resolved, then Licq will default to using 127.0.0.1, which will be ignored |
|---|
| 288 | by the module.<BR> |
|---|
| 289 | The solution is to ensure that your hostname (to find it, type "hostname" at the prompt) |
|---|
| 290 | resolves to your correct sub-net IP. To find out, ping your hostname ("ping <hostname>") |
|---|
| 291 | and see what the ip ends up being.<BR> |
|---|
| 292 | This ip will probably be something in the 192.168.xx.xx or 10.xx.xx.xx range. If it |
|---|
| 293 | resolves to 127.0.0.1 or 0, then there is a problem. To fix this, simply edit |
|---|
| 294 | <I>/etc/hosts</I> and enter the correct ip and hostname there, for example: |
|---|
| 295 | <P> |
|---|
| 296 | 127.0.0.1 localhost<BR> |
|---|
| 297 | |
|---|
| 298 | 192.168.0.2 <hostname><BR> |
|---|
| 299 | ...<BR> |
|---|
| 300 | <P> |
|---|
| 301 | <BR> |
|---|
| 302 | |
|---|
| 303 | <A NAME="3_9"><STRONG>3.9: How do I configure ipmasq for ICQ?</STRONG> |
|---|
| 304 | <P> |
|---|
| 305 | Configuring ipmasq and ipchains for ICQ is fairly simple. The relevant |
|---|
| 306 | man pages contain a good source of information as well. Here is a sample |
|---|
| 307 | configuration using ipmasq:<BR> |
|---|
| 308 | ---(cut here)---<BR> |
|---|
| 309 | <BR> |
|---|
| 310 | # Enable port forwarding for ICQ Client<BR> |
|---|
| 311 | |
|---|
| 312 | #<BR> |
|---|
| 313 | port=2000<BR> |
|---|
| 314 | while [ $port -lt 2020 ]<BR> |
|---|
| 315 | do<BR> |
|---|
| 316 | /usr/sbin/ipmasqadm portfw -a -P tcp -L $xnet $port -R 192.168.1.2 $port<BR> |
|---|
| 317 | port=$((port+1))<BR> |
|---|
| 318 | done<BR> |
|---|
| 319 | /usr/sbin/ipmasqadm portfw -a -P udp -L $xnet 4000 -R 192.168.1.2 4000<BR> |
|---|
| 320 | |
|---|
| 321 | <BR> |
|---|
| 322 | ---(cut here)---<BR> |
|---|
| 323 | <BR> |
|---|
| 324 | And here is an example using iptables which is used with the Linux Kernel 2.4.x:<BR> |
|---|
| 325 | ---(cut here)---<BR> |
|---|
| 326 | <BR> |
|---|
| 327 | iptables -t nat -A PREROUTING -p tcp --destination-port 2000:2020 -i ppp0 -j DNAT --to 192.168.1.2<BR> |
|---|
| 328 | iptables -t nat -A PREROUTING -p udp --destination-port 4000 -i ppp0 -j DNAT --to 192.168.1.2<BR> |
|---|
| 329 | |
|---|
| 330 | <BR> |
|---|
| 331 | ---(cut here)---<BR> |
|---|
| 332 | |
|---|
| 333 | <BR> |
|---|
| 334 | This script will forward tcp ports 2000-2020 and udp port 4000 to your |
|---|
| 335 | machine inside the firewall. Note $xnet is the ip address issued to you by |
|---|
| 336 | your ISP and 192.168.1.2 should be changed to the ip address of the |
|---|
| 337 | machine that you are running Licq on. Also note that this is just one |
|---|
| 338 | sample configuration and there are other ways to do this, using ipchains |
|---|
| 339 | for example.<BR> |
|---|
| 340 | <P> |
|---|
| 341 | <BR> |
|---|
| 342 | |
|---|
| 343 | |
|---|
| 344 | <A NAME="3_10"><STRONG>3.10: I can't connect to ICQ, all I get are timeouts!</STRONG> |
|---|
| 345 | <P> |
|---|
| 346 | This is a problem with the ICQ servers and people who use icq2000. For |
|---|
| 347 | some reason a selection of the icq servers do not allow you to log on using |
|---|
| 348 | another client after using icq2000.<BR> |
|---|
| 349 | The solution? Edit ~/.licq/licq.conf and set the servers to be a valid |
|---|
| 350 | icq.mirabilis.com ip except 205.188.153.*, eg 205.188.179.33. Try |
|---|
| 351 | "nslookup icq.mirabilis.com" for more.<BR> |
|---|
| 352 | This, hopefully, will make it work. In any case, it's not a Licq problem, but |
|---|
| 353 | a mirabilis stupidity.<BR> |
|---|
| 354 | <P> |
|---|
| 355 | |
|---|
| 356 | |
|---|
| 357 | <BR> |
|---|
| 358 | |
|---|
| 359 | <A NAME="3_11"><STRONG>3.11: Does Licq support server side contact lists?</STRONG> |
|---|
| 360 | <P> |
|---|
| 361 | |
|---|
| 362 | Yes, it is enabled by default. Licq supports having a user in multiple groups |
|---|
| 363 | but the server only allows one group per user. This is a little difficult to |
|---|
| 364 | manage, so there is a seperate menu item to change the server group of a user. |
|---|
| 365 | Just right click a user in the Qt-GUI and take a look for yourself. |
|---|
| 366 | <P> |
|---|
| 367 | <BR> |
|---|
| 368 | |
|---|
| 369 | |
|---|
| 370 | <H3><STRONG>Section 4: Plugins</STRONG></H3> |
|---|
| 371 | <P> |
|---|
| 372 | |
|---|
| 373 | <A NAME="4_1"><STRONG>4.1: I get something about being unable to load a plugin because "file not found" or "no such file or directory".</STRONG> |
|---|
| 374 | <P> |
|---|
| 375 | If this happens with QT-GUI then you most likely configured --with-kde support. |
|---|
| 376 | In this case, please type "licq -p kde-gui" to start licq and read the README.KDE file.<BR> |
|---|
| 377 | In all other cases the plugin may be unable to find a necessary library. |
|---|
| 378 | Use "ldd" on the offending plugin to see which library it can't find. Then add |
|---|
| 379 | the directory containing that missing library to your /etc/ld.so.conf file or |
|---|
| 380 | LD_LIBRARY_PATH environment variable (see 4.2). |
|---|
| 381 | <P> |
|---|
| 382 | <BR> |
|---|
| 383 | |
|---|
| 384 | <A NAME="4_2"><STRONG>4.2: I get something about "undefined symbol: ..." when I try and load the Qt-GUI plugin.</STRONG> |
|---|
| 385 | <P> |
|---|
| 386 | This problem occurs if you have a copy of qt 1.4 somewhere on your system |
|---|
| 387 | and Licq is linked to it. Verify this using <EM>ldd /usr/local/lib/licq/licq_qt-gui.so</EM> |
|---|
| 388 | and see which qt library it's linked to. If it is qt 1.4 then this library will have |
|---|
| 389 | to be moved to somewhere after the location of the qt 2.0 library, as listed |
|---|
| 390 | in /etc/ld.so.conf. Read the README-QT-1.4-AND-2.0 for more information.<BR> |
|---|
| 391 | One other solution is simply to add the directory with Qt 2.0 in it to your |
|---|
| 392 | LD_LIBRARY_PATH environment variable like so:<BR> |
|---|
| 393 | <EM>export LD_LIBRARY_PATH=/usr/local/qt/lib</EM><BR> |
|---|
| 394 | which can be added to /etc/profile as per the Qt installation instructions. |
|---|
| 395 | <P> |
|---|
| 396 | <BR> |
|---|
| 397 | |
|---|
| 398 | <A NAME="4_3"><STRONG>4.3: Licq starts up but then exits with "licq: Fatal IO error: client killed".</STRONG> |
|---|
| 399 | |
|---|
| 400 | <P> |
|---|
| 401 | Because Licq is multi-threaded, it requires thread-safe X11 libraries. These |
|---|
| 402 | can be aquired by recompiling your X server with the thread option or by grabbing |
|---|
| 403 | the binaries (see the Info section of the Licq web page under Requirements). |
|---|
| 404 | <P> |
|---|
| 405 | <BR> |
|---|
| 406 | |
|---|
| 407 | <A NAME="4_4"><STRONG>4.4: What does "undefined symbol: LP_Main" mean?</STRONG> |
|---|
| 408 | <P> |
|---|
| 409 | This is a bug with the dynamic loader used in SMP machines. Try changing DLOPEN_POLICY |
|---|
| 410 | in config.h to RTLD_NOW and rebuild. Or upgrade your kernel/ld. |
|---|
| 411 | <P> |
|---|
| 412 | <BR> |
|---|
| 413 | <A NAME="4_5"><STRONG>4.5: Qt-gui crashes on startup, it says something about "XRegisterIMInstantiateCallback"</STRONG> |
|---|
| 414 | <P> |
|---|
| 415 | There is a bug in QT 3.x whith X Input Methods (XIM).<BR> |
|---|
| 416 | Try to start licq like this: "licq -- -noxim". |
|---|
| 417 | |
|---|
| 418 | <P> |
|---|
| 419 | <BR> |
|---|
| 420 | <A NAME="4_6"><STRONG>4.6: When Licq is docked it is still visible in the taskbar, what can i do?</STRONG> |
|---|
| 421 | <P> |
|---|
| 422 | When you are using KDE you can prevent Licq from beeing visible in the taskbar.<BR> |
|---|
| 423 | Simply prepend "kstart --skiptaskbar" to your commandline:<BR> |
|---|
| 424 | <TT>kstart --skiptaskbar licq</TT> |
|---|
| 425 | <P> |
|---|
| 426 | <BR> |
|---|
| 427 | |
|---|
| 428 | |
|---|
| 429 | <H3><STRONG>Section 5: Qt-GUI Plugin</STRONG></H3> |
|---|
| 430 | <P> |
|---|
| 431 | |
|---|
| 432 | <A NAME="5_1"><STRONG>5.1: The QUI says it is unable to load <file>.xpm or <file>.gif, but the file is there!</STRONG> |
|---|
| 433 | <P> |
|---|
| 434 | Qt has problems loading certain formats of xpm. The solution is simply |
|---|
| 435 | to save the pixmap in question as a gif and edit the skin file appropriately. If the |
|---|
| 436 | file in question is a gif, then make sure that you compiled qt with gif support |
|---|
| 437 | enabled (<EM>configure -gif</EM>). |
|---|
| 438 | <P> |
|---|
| 439 | <BR> |
|---|
| 440 | |
|---|
| 441 | <A NAME="5_2"><STRONG>5.2: How do I change the colors of the Qt-Gui?</STRONG> |
|---|
| 442 | <P> |
|---|
| 443 | |
|---|
| 444 | Colors are now integrated into the skin file. To change colors you must |
|---|
| 445 | edit the skin file (found in <EM>/usr/local/share/licq/qt-gui/skin.<name></EM>) and |
|---|
| 446 | add the following:<BR> |
|---|
| 447 | <BR> |
|---|
| 448 | # --- colors ---<BR> |
|---|
| 449 | colors.online = #ff0000 <BR> |
|---|
| 450 | colors.away = dark green<BR> |
|---|
| 451 | colors.offline = firebrick<BR> |
|---|
| 452 | colors.newuser = yellow<BR> |
|---|
| 453 | colors.background = default<BR> |
|---|
| 454 | |
|---|
| 455 | colors.gridlines = black<BR> |
|---|
| 456 | <BR> |
|---|
| 457 | Of course you get to select your own colors! |
|---|
| 458 | <P> |
|---|
| 459 | <BR> |
|---|
| 460 | |
|---|
| 461 | <A NAME="5_3"><STRONG>5.3: Why are there no spaces between words in the History tab?</STRONG> |
|---|
| 462 | <P> |
|---|
| 463 | This seems to be a bug in the Qt widget being used. The solution is simply to use a TrueType font. |
|---|
| 464 | Select one from the Options Dialog in the Font section. |
|---|
| 465 | <P> |
|---|
| 466 | <BR> |
|---|
| 467 | |
|---|
| 468 | <A NAME="5_4"><STRONG>5.4: How do I dock the Licq icon?</STRONG> |
|---|
| 469 | <P> |
|---|
| 470 | |
|---|
| 471 | Docking the licq qt-gui status icon is fairly simple to do. Here is a list |
|---|
| 472 | of window managers and what to do. If your window manager supports the |
|---|
| 473 | freedesktop.org standard, just enable the "Small Icon" in the Options. If you |
|---|
| 474 | are using KDE, use the KDE-GUI (./configure --with-kde for the Qt-GUI). |
|---|
| 475 | |
|---|
| 476 | If you aren't using a freedesktop.org compliant window manager, do the following:<BR> |
|---|
| 477 | <BR> |
|---|
| 478 | 1. Start Licq and enable the dock icon in the Options screen.<BR> |
|---|
| 479 | 2. Select "Save Settings" from the system menu.<BR> |
|---|
| 480 | 3. Restart Licq (very important).<BR> |
|---|
| 481 | <BR> |
|---|
| 482 | <STRONG>WindowMaker</STRONG><BR> |
|---|
| 483 | 4. Drag the status icon to the dock and voila.<BR> |
|---|
| 484 | Note that the other icon that appears is from windowmaker and can be set |
|---|
| 485 | to something nice, or disable entirely using the windowmaker menu.<BR> |
|---|
| 486 | <BR> |
|---|
| 487 | |
|---|
| 488 | <STRONG>AfterStep</STRONG><BR> |
|---|
| 489 | 4. Add the following to your ~/GNUstep/Library/AfterStep/wharf file:<BR> |
|---|
| 490 | "*Wharf licq - Swallow "LicqWharf" echo &"<BR> |
|---|
| 491 | 5. Next time start Licq, the icon should appear in the wharf.<BR> |
|---|
| 492 | 4*.Another possibility is to add:<BR> |
|---|
| 493 | *FvwmButtons(Swallow (UseOld,NoKill,NoClose) "LicqWharf" Nop, Action (Mouse 1) 'Exec |
|---|
| 494 | /usr/bin/licq')<BR> |
|---|
| 495 | to your FvwmButtons config file.<BR> |
|---|
| 496 | <BR> |
|---|
| 497 | |
|---|
| 498 | <STRONG>KDE</STRONG><BR> |
|---|
| 499 | 4. Configure the qt-gui plugin with --with-kde and then licq will dock in Kicker.<BR> |
|---|
| 500 | 5. Start Licq and there it goes!<BR> |
|---|
| 501 | <BR> |
|---|
| 502 | <STRONG>Gnome</STRONG><BR> |
|---|
| 503 | 4. Pick a smaller dock icon then the default (either 64x48 or one of the themed icons).<BR> |
|---|
| 504 | 5. Select "Swallow App" from the gnome panel menu.<BR> |
|---|
| 505 | 6. Set "Title = LicqWharf", "Width = 64", "Height = 48".<BR> |
|---|
| 506 | <BR> |
|---|
| 507 | <P> |
|---|
| 508 | |
|---|
| 509 | <A NAME="5_5"><STRONG>5.5: How do I see other encodings (Russian, Japanese, etc.)?</STRONG><BR> |
|---|
| 510 | <P> |
|---|
| 511 | In the options, you can select a default encoding. Also, there are per-user encodings. In the event window, there is an encoding button in the top right corner. If the proper encoding isn't listed there, select the "Show all encodings" in the options dialog. You may have to experiment to find the correct encoding (there are 3 Japanese ones), but it does work properly. So please try all the appropriate encodings before saying that it doesn't work. |
|---|
| 512 | </P> |
|---|
| 513 | <BR> |
|---|
| 514 | |
|---|
| 515 | <H3><STRONG>Section 6: Protocol Plugins</STRONG></H3> |
|---|
| 516 | <P> |
|---|
| 517 | |
|---|
| 518 | <A NAME="6_1"><STRONG>6.1: What protocols are available?</STRONG><BR> |
|---|
| 519 | <P> |
|---|
| 520 | Currently ICQ, AIM and MSN are available. Only one account per protocol can be used with the 1.3.0 release. This limitation will be removed in a future release. ICQ and AIM are viewed as one protocol from Licq, so this means only one AIM or ICQ account can be used. Fortunately, this isn't too bad of a problem since ICQ and AIM work together. This means you can add AIM users to your ICQ list and vice versa. As for MSN, it is still being developed and supports basic functionality, but will be a full featured client soon!<BR><BR> |
|---|
| 521 | Other protocols such as Yahoo will come later.. unless someone else starts to work on it, then sooner. |
|---|
| 522 | </P> |
|---|
| 523 | <BR> |
|---|
| 524 | |
|---|
| 525 | <A NAME="6_2"><STRONG>6.2: How do I start using a protocol plugin?</STRONG><BR> |
|---|
| 526 | <P> |
|---|
| 527 | First you need to install the protocol plugin. If you installed Licq from source, it can be found in the 'plugins' directory. After it is installed, you need to load the plugin. From the Qt-GUI this is done from the Plugin Manager dialog. After it is loaded, open up the Owner Manager and add your account for the new protocol. |
|---|
| 528 | </P> |
|---|
| 529 | <BR> |
|---|
| 530 | |
|---|
| 531 | <H3><STRONG>Section 7: Donations</STRONG></H3> |
|---|
| 532 | <P> |
|---|
| 533 | |
|---|
| 534 | <A NAME="7_1"><STRONG>7.1: What are the operating expenses?</STRONG><BR> |
|---|
| 535 | <P> |
|---|
| 536 | The mail server and DNS server are currently run by Dennis Tenn and he pays all costs privately. A percentage of the donations will go to pay for the cost of running this server. Also, the domain names must be paid for every few years. |
|---|
| 537 | </P> |
|---|
| 538 | <BR> |
|---|
| 539 | |
|---|
| 540 | <A NAME="7_2"><STRONG>7.2: What is the emergency fund?</A></STRONG><BR> |
|---|
| 541 | <P> |
|---|
| 542 | It is a percentage of donations that are kept in case a main developer has a personal emergency that requires monetary assistance. The usage for this money will be for necessary items such as food, rent, medicine, and other similiar items. It will not be used for unnecessary items such as alcohol, hardware, or anything that is a personal interest. |
|---|
| 543 | |
|---|
| 544 | </P> |
|---|
| 545 | <BR> |
|---|
| 546 | |
|---|
| 547 | <A NAME="7_3"><STRONG>7.3: How do I know my donation is going to the project?</A></STRONG><BR> |
|---|
| 548 | <P> |
|---|
| 549 | Since you are using Licq, you trust us not to put a backdoor in the program. With this reasoning, you should trust us that your valued contribution will be used solely to directly help Licq. |
|---|
| 550 | </P> |
|---|
| 551 | <BR> |
|---|
| 552 | |
|---|
| 553 | <A NAME="7_4"><STRONG>7.4: I donated money, will you add the feature I want?</A></STRONG><BR> |
|---|
| 554 | <P> |
|---|
| 555 | Just because you donated money does not entitle you to automatically have a feature you want to be added. It will be considered as all other feature requests are considered. Your donations are appreciated, but they are viewed as contribuations you make to help continue the Licq project. |
|---|
| 556 | </P> |
|---|
| 557 | <BR> |
|---|
| 558 | <div class="footer"> |
|---|
| 559 | <div class="footer_right"></div> |
|---|
| 560 | </div> |
|---|
| 561 | </div> |
|---|
| 562 | <!-- News Item End--> |
|---|
| 563 | |
|---|
| 564 | </div> |
|---|
| 565 | </div> |
|---|
| 566 | |
|---|
| 567 | <div id="mainfooter"><p id="mainfooter_left"></p><!-- <img src="images/main_bg_bottomleft.gif" border="0" alt="Main" /> --></div> |
|---|
| 568 | |
|---|
| 569 | </div> |
|---|
| 570 | |
|---|
| 571 | <? include "footer.php" ?> |
|---|