From: Luke S. <lsc...@us...> - 2004-03-07 04:28:17
|
Update of /cvsroot/gaim/web/htdocs In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv16482/htdocs Modified Files: faq-ssl.txt faq.txt plugins.php protocol.php Log Message: nosnilmot didn't give me a commit message for this. Its some useful updates. Index: faq-ssl.txt =================================================================== RCS file: /cvsroot/gaim/web/htdocs/faq-ssl.txt,v retrieving revision 1.5 retrieving revision 1.6 diff -u -d -p -r1.5 -r1.6 --- faq-ssl.txt 20 Jan 2004 15:07:05 -0000 1.5 +++ faq-ssl.txt 7 Mar 2004 04:12:56 -0000 1.6 @@ -10,10 +10,13 @@ read on, maybe you're in luck. but proba </p> Q: General Notes -A: Mozilla 1.5 will not provide all the pieces for NSPR & NSS due to breakage in +A: Gaim needs to be compiled with SSL support to work with MSN, and for +SSL connections on Jabber (where the server supports it). You will need either +GnuTLS (and all its dependencies) or Mozilla NSS & NSPR. +<p>Mozilla 1.5 will not provide all the pieces for NSPR & NSS due to breakage in Mozilla that misses out some .h files (or something...). You might be able to install mozilla-{nss,nspr}{,-devel} from 1.4, or install nss from source, in -parallel and link against those for Gaim. Or just use GnuTLS. +parallel and link against those for Gaim. Or just use GnuTLS.</p> <p> OpenSSL is not an option for SSL support in Gaim because the OpenSSL license (BSD-style) is not compatible with the Gaim license (GPL) @@ -172,7 +175,7 @@ A: There's a 3rd party package for Slack http://www.uidzero.co.uk/pkg/slack91/</a> This package does not have gtkspell support because gtkspell is not part of the base Slackware distribution (same package is also at <a -href="http://www.linuxpackages.net/">http://www.linuxpackages.net</a>). +href="http://www.linuxpackages.net/">http://www.linuxpackages.net/</a>). This one should work out of the box. <p> The Gaim 0.74 package from Slackware does NOT work out of the box. I have not @@ -246,7 +249,14 @@ dependancy on gettext) by configuring li <pre> ./configure --disable-nls </pre> - +<p> +Apparently GnuTLS is no longer working for FreeBSD users (and possibly +others), but it (apparently, again) does work with NSS/NSPR from ports +(nss-3.8): +</p> +<pre> +cd /usr/ports/net/gaim ; make WITHOUT_GNUTLS=t WITH_NSS=t WITHOUT_AUDIO=t package clean +</pre> Q: OpenBSD (3.4) A: Compile from source. See the note below on GnuTLS versions that have been reported to work with *BSD, these tips might also help you: @@ -281,7 +291,13 @@ Gaim developers or in #gaim. </p> Q: Solaris -A: See below on compiling from source +A: There are 3rd party packages for Solaris here : +<a href="http://sourceforge.net/project/showfiles.php?group_id=19386&package_id=98537"> +http://sourceforge.net/project/showfiles.php?group_id=19386&package_id=98537</a> +<p> +If you're compiling from source, you must make sure everything is compiled +using gcc and not Sun's cc +</p> Q: Mac OS X (10.3.1) A: Information on setting up GnuTLS can be found at: <a href="http://alphamonkey.org/view.php?type=notes&id=309"> @@ -321,12 +337,6 @@ A: Mozilla NSS & NSPR can be found h ftp://ftp.mozilla.org/pub/mozilla.org/security/nss/releases/NSS_3_8_RTM/src/nss-3.8.tar.gz</a> (despite it's name, it contains both NSS & NSPR) <p> -This older one has been referenced here for a while, but did not have much success with -it:<br> -<a href="ftp://ftp.mozilla.org/pub/mozilla.org/security/nss-3.1.1-with-nspr-4.1-dbm.tar.gz"> -ftp://ftp.mozilla.org/pub/mozilla.org/security/nss-3.1.1-with-nspr-4.1-dbm.tar.gz</a> -</p> -<p> --with-{nss,nspr}-includes should point to the directory with the .h files in (eg. nspr.h) --with-{nss,nspr}-libs should point to the directory with the .so files in (eg. libnss3.so) </p> @@ -335,17 +345,33 @@ If you can't add to /etc/ld.so.conf (or the LD_LIBRARY_PATH environment variable instead, either before running gaim or (for bourne shell & bash) on the gaim command line, eg. csh: +</p> <pre> setenv LD_LIBRARY_PATH /usr/lib/mozilla-1.4 </pre> +<p> sh/bash: +</p> <pre> LD_LIBRARY_PATH=/usr/lib/mozilla-1.4 ; export LD_LIBRARY_PATH </pre> +<p> or sh/bash: run gaim with this command: +</p> <pre> LD_LIBRARY_PATH=/usr/lib/mozilla-1.4 gaim </pre> +<p> +If you have multiple versions of Mozilla installed, you might have some +problems with which version is detected by <code>./configure</code> and which +libs are used at runtime. This is because, by default, +<code>./configure</code> uses pkg-config to find the Mozilla NSS & NSPR +libs and includes. If you explicitly specify the Mozilla libs and includes +to use with the --with-nss etc. options to <code>./configure</code> then +pkg-config will not be used, and you might have more success. +</p> +<p> +The notes below on installing Mozilla NSS & NSPR might also help. </p> Q: GnuTLS @@ -375,7 +401,7 @@ GnuTLS (needed by gaim): ftp://ftp.gnutls.org/pub/gnutls/attic/gnutls-0.9.91.tar.gz</a> </p> <p> -libopenck is a PITA, don't use it, GnuTLS will break. Also version 0.9.92 of +libopencdk is a PITA, don't use it, GnuTLS will break. Also version 0.9.92 of GnuTLS doesn't compile because the maintainer forgot to add 1 file needed. 0.9.91 works, so just do that. </p> @@ -395,6 +421,9 @@ For FreeBSD (and, it seems, OpenBSD) use </pre> Thanks synic. </p> +<p> +The notes below on installing GnuTLS as non-root might also help. +</p> Q: Non-root (mozilla-{nss,nspr} or GnuTLS already installed) A: If you don't have root access on the system you're trying to install gaim @@ -423,6 +452,16 @@ cd nss-3.8/mozilla/security/nss make nss_build_all make install </pre> +<p>If compiling on Solaris (and maybe other Unixes), the Mozilla build system +defaults to using the OS supplied cc even if it's not in the path. You must +force the build to use gcc using these make commands instead of the above. +Also, make sure you have a relatively recent gcc (3.2.x has been reported to +work, 3.1.x has been reported to fail). Thanks to Bill Tompkins for these +pointers.</p> +<pre> +NS_USE_GCC=1 make nss_build_all +NS_USE_GCC=1 make install +</pre> <p> (on systems where make is not GNU make, use gmake) </p> @@ -436,6 +475,12 @@ cp -Lr ../../dist/public/* /home/usernam cp -Lr ../../dist/*/include/* /home/username/include/nspr </pre> <p> +The above lines require GNU find & GNU cp, on Solaris you can get these from +<a href="http://www.sunfreeware.com/">Sunfreeware.com</a> in the findutils and +coreutils packages (remember to make sure the GNU commands are in your path +before the OS versions). +</p> +<p> Gaim: </p> <pre> @@ -502,3 +547,106 @@ In some cases, it might be necessary to <code>LD_LIBRARY_PATH=/home/username/lib</code> before running Gaim (this was not necessary on the tested system) </p> +!SECTION Troubleshooting +Q: ./configure +A: ./configure will tell you when it is finished what SSL implementation +is going to be used. You will get one of these 4 lines: +<pre> +SSL Library/Libraries......... : None +SSL Library/Libraries......... : Mozilla NSS +SSL Library/Libraries......... : GnuTLS +SSL Library/Libraries......... : Mozilla NSS and GnuTLS +</pre> +<p> +It should be fairly obvious that if it says "None", it is not going to work +for you, so you should fix that by making sure you're passing the right +--with-xxx-libs & --with-xxx-includes as described above before even bothering +to try "make". +</p> +Q: Compiling +A: If <code>./configure</code> said it was going to compile with SSL but +the make fails to build, it is likely that you have a broken installation of +the chosen SSL libs. If you did not specify any --with-xxx-libs or +--with-xxx-includes when running configure, try explicitly pointing it at your +SSL libs includes. +<p> +If it still fails during <code>make</code>, you should probably try the other +SSL option and explictly disable the one that failed with +<code>--enable-nss=no</code> or <code>--enable-gnutls=no</code> as appropriate. +</p> +Q: Runtime +A: If you've managed to build Gaim, with SSL support reported by +<code>./configure</code> and without any build failures, but when running it +still complains, there are a few things you can try. +<p> +Make sure that you only have one copy of gaim installed, it is possible that +there is another one in your path that does not have SSL support. You can +check which gaim is being run with "<code>which gaim</code>", or you +can be sure to run the version you've just compiled by specifiying the full +path to it. Note: <code>./configure</code> will warn you if it finds an old +version of gaim already installed. +</p> +<p> +If you are sure that you are running your freshly compiled Gaim, check Gaim's +SSL plugin is actually linked to the necessary libs. If you compiled with +Mozilla NSS, you can do this (replace /usr/local/lib with the prefix you +installed to): + +</p> +<pre> +$ ldd /usr/local/lib/gaim/ssl-nss.so + libnsl.so.1 => /lib/libnsl.so.1 (0x40023000) + libc.so.6 => /lib/i686/libc.so.6 (0x42000000) + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x80000000) +</pre> +<p> +That one is NOT linked against NSS, and will not work. Go back to the +beginning and try again (or, if you also compiled with GnuTLS, keep reading). +</p> +<pre> +$ ldd /usr/local/lib/gaim/ssl-nss.so + libnss3.so => /usr/lib/libnss3.so (0x4004e000) + libsmime3.so => /usr/lib/libsmime3.so (0x400b0000) + libssl3.so => /usr/lib/libssl3.so (0x400d0000) + libsoftokn3.so => /usr/lib/libsoftokn3.so (0x400f0000) + libpthread.so.0 => /lib/i686/libpthread.so.0 (0x40155000) + libdl.so.2 => /lib/libdl.so.2 (0x401a5000) + libnsl.so.1 => /lib/libnsl.so.1 (0x401a8000) + libc.so.6 => /lib/i686/libc.so.6 (0x42000000) + libplc4.so => /usr/lib/libplc4.so (0x401bf000) + libplds4.so => /usr/lib/libplds4.so (0x401c4000) + libnspr4.so => /usr/lib/libnspr4.so (0x401c7000) + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x80000000) +</pre> +<p> +That one is linked against the necessary things, and all libs were found. If +any of the bits on the right say "not found", then the compile worked but the +libs cannot be found by the dynamic loader. See notes above about +<code>/etc/ld.so.conf</code>, <code>ldconfig</code> and the LD_LIBRARY_PATH +environment variable. +</p> +<p> +If you compiled with GnuTLS (or both), the steps to check the Gaim SSL plugin +are similar to above, except the file to check is <code>ssl-gnutls.so</code>. +The output should look like this if all is good: +</p> +<pre> +$ ldd /usr/local/lib/ssl-gnutls.so + libgnutls.so.8 => /usr/lib/libgnutls.so.8 (0x40003000) + libgcrypt.so.7 => /usr/lib/libgcrypt.so.7 (0x4005e000) + libnsl.so.1 => /lib/libnsl.so.1 (0x400c6000) + libc.so.6 => /lib/i686/libc.so.6 (0x42000000) + libz.so.1 => /usr/lib/libz.so.1 (0x400dc000) + libgpg-error.so.0 => /usr/lib/libgpg-error.so.0 (0x400ea000) + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x80000000) +</pre> +<p> +For completeness, here's the output if it can't find some of the libs: +</p> +<pre> + libgnutls.so.8 => not found + libgcrypt.so.7 => not found + libnsl.so.1 => /lib/libnsl.so.1 (0x002b7000) + libc.so.6 => /lib/tls/libc.so.6 (0x004f4000) + /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x0088d000) +</pre> Index: faq.txt =================================================================== RCS file: /cvsroot/gaim/web/htdocs/faq.txt,v retrieving revision 1.117 retrieving revision 1.118 diff -u -d -p -r1.117 -r1.118 --- faq.txt 29 Feb 2004 07:36:05 -0000 1.117 +++ faq.txt 7 Mar 2004 04:12:56 -0000 1.118 @@ -153,7 +153,7 @@ A: This depends on the protocol. <p><b>AIM:</b> Go to <a href="http://my.screenname.aol.com/_cqr/login/login.psp?siteId=snshomepage&authLev=1&mcState=initialized&createSn=1">this website</a>.</p> <p><b>ICQ:</b> Go to <a href="http://web.icq.com/register">http://web.icq.com/register</a>.</p> <p><b>Yahoo:</b> Go to <a href="http://edit.yahoo.com/config/eval_register">http://edit.yahoo.com/config/eval_register</a>.</p> -<p><b>MSN</b> (including hotmail email)<b>:</b> Go to <a href="http://registernet.passport.com/">http://registernet.passport.com</a>.</p> +<p><b>MSN</b> (including hotmail email)<b>:</b> Go to <a href="http://registernet.passport.com/">http://registernet.passport.com/</a>.</p> <p><b>MSN</b> (using your own email address)<b>:</b> Go to <a href="https://register.passport.net/reg.srf?lc=1033&id=486&ru=http%3A%2F%2Fwww%2Epassport%2Enet%2FConsumer%2FDefault%2Easp%3Flc%3D1033&sl=1"> this website</a></p> @@ -342,7 +342,7 @@ or <i>some</i>thing? A: Yeah, Gaim supports what is called a system tray icon that conforms to the standards at -<a href="http://www.freedesktop.org/">http://www.freedesktop.org</a>. +<a href="http://www.freedesktop.org/">www.freedesktop.org</a>. This tray icon is supported by Windows, KDE 3.1, Gnome 2.2, and Red Hat Gnome 2.0. All you have to do is load the "System Tray Icon" plugin by going to Preferences and then Plugins. @@ -401,9 +401,14 @@ A: It's not possible to perfectly conver new format because the old format is missing some information necessary to do that (eg. which account the messages were sent from). <p> -However, it shouldn't be too difficult to do a rough conversion using a +It shouldn't be too difficult to do a rough conversion using a small script, or using the <code>old_logger_*</code> functions in gaim itself. </p> +<p> +Peter Johnson has written a python script to do just this, it is available +on <a href="http://tam.hiddenrock.com/projects/scripts/index.php">his +website</a> (at the bottom). +</p> Q: Where has the system log gone? @@ -728,10 +733,10 @@ Q: Is MSNP9 (MSN6) going to be supported A: MSNP9 support has existed in Gaim since 0.69. However, at this point, features such as custom smileys and buddy icons aren't yet implemented. -Q: Will I be able to use Gaim for MSN after October 15th? (The day they're preventing third party clients from connecting) +Q: Will I be able to use Gaim for MSN after October 15th 2003? (The day they're preventing third party clients from connecting) A: Yes. We use MSNP9, which is available in 0.69 and up, and MSNP9 is -supported after October 15th. +supported after October 15th 2003. Q: I just upgraded Gaim and the MSN plugin will not load. Why? @@ -752,7 +757,7 @@ include file are for NSS and NSPR, see . Mozilla 1.5 has a broken .pc file and does not install the necessary .h files, and so will not be detected. </p> <p> - See <a href="./faq-ssl.php">these notes</a> on getting ssl to work with gaim. + See <a href="./faq-ssl.php">these notes</a> on getting SSL to work with gaim. </p> @@ -761,7 +766,7 @@ include file are for NSS and NSPR, see . Q: What is Gadu-Gadu? A: Gadu-Gadu is an IM protocol popular in Poland. You can find more about -it at <a href="http://www.gadu-gadu.pl">http://www.gadu-gadu.pl</a> +it at <a href="http://www.gadu-gadu.pl/">www.gadu-gadu.pl</a> (website in Polish). @@ -920,11 +925,16 @@ requires, among other things, an authent your data stream without verifying the party with whom you are chatting is not secure in any way; some other clients offer options like this, but we feel that such measures instill a false sense of security that is more -harmful than helpful. <p>There are a number of 3rd party plugin developers -working on developing a secure IM framework, the better ones using the -GnuPG and the OpenPGP trust model for authentication. If you are serious -about secure instant messaging, read the documentation on the "web of trust" -model available at http://www.gnupg.org/ and try out one of these..</p> +harmful than helpful. +<p> + There are a number of 3rd party plugin developers + working on developing a secure IM framework, the better ones using the + GnuPG and the OpenPGP trust model for authentication. If you are serious + about secure instant messaging, read the documentation on the "web of + trust" model available at + <a href="http://www.gnupg.org/">www.gnupg.org</a> and try out one of + these. +</p> !ANCHOR plaintext-passwords Q: Why are the passwords in accounts.xml not encrypted? Index: plugins.php =================================================================== RCS file: /cvsroot/gaim/web/htdocs/plugins.php,v retrieving revision 1.6 retrieving revision 1.7 diff -u -d -p -r1.6 -r1.7 --- plugins.php 31 Jan 2004 21:01:43 -0000 1.6 +++ plugins.php 7 Mar 2004 04:12:56 -0000 1.7 @@ -4,11 +4,11 @@ start_html("Plugins"); $plugins = array( - "gaim-blogger" => array( +/* "gaim-blogger" => array( "URL" => "http://gaim-blogger.sourceforge.net", "TEXT" => "Makes use of Gaim's IM interface to post, edit, view and track blogs" ), - +*/ "guifications" => array( "URL" => "http://guifications.sourceforge.net/", "TEXT" => "Graphical notification when buddies sign on, sign off, go away, etc." @@ -16,7 +16,11 @@ "gaim-e" => array( "URL" => "http://gaim-e.sourceforge.net/", - "TEXT" => "Gaim-e Encryption Plugin (may not work with current versions of Gaim)" + "TEXT" => "Gaim-e Encryption Plugin (GPG encryption) (may not work with current versions of Gaim)" + ), + "gaim-encryption" => array( + "URL" => "http://gaim-encryption.sourceforge.net/", + "TEXT" => "Another Gaim encryption plugin (RSA encryption)" ), ); Index: protocol.php =================================================================== RCS file: /cvsroot/gaim/web/htdocs/protocol.php,v retrieving revision 1.6 retrieving revision 1.7 diff -u -d -p -r1.6 -r1.7 --- protocol.php 15 Dec 2003 13:38:39 -0000 1.6 +++ protocol.php 7 Mar 2004 04:12:56 -0000 1.7 @@ -39,10 +39,10 @@ <p> ICQ99 was the last official ICQ client to use the UDP-based protocol. Starting with ICQ2000, the official ICQ client uses a modified version of - Oscar. It is now possible (and recommended) to use Oscar to connect to - the ICQ network instead of ICQ/libicq. In fact, we recommend this so - strongly that we've stopped officially distributing the protocol plugin - for ICQ. + <a href="#oscar">Oscar</a>. It is now possible (and recommended) to use + <a href="#oscar">Oscar</a> to connect to the ICQ network instead of + ICQ/libicq. In fact, we recommend this so strongly that we've stopped + officially distributing the protocol plugin for ICQ. </p> <?php end_section() ?> @@ -87,7 +87,7 @@ username would be war...@ja... or rob...@ja.... Jabber also lets you connect using the same username multiple times, using what they term a "resource". A resource is an arbitrary string, often seen - appended to your username, e.g. war...@ja.../GAIM (GAIM in this + appended to your username, e.g. war...@ja.../Gaim (Gaim in this case being the resource), which lets the server keep track of how many times that username is signed on. </p> @@ -119,7 +119,11 @@ <a name="msn"></a> <?php start_section("MSN") ?> -<p>This section has not yet been written.</p> +<p>The MSN protocol was originally published by Microsoft as an +<a href="http://www.hypothetic.org/docs/msn/ietf_draft.txt">IETF draft</a>. It has +since been "embraced and extended" to the point that it had to +be reverse engineered to work. Some documentation on this effort is available +<a href="http://www.hypothetic.org/docs/msn/index.php">here</a>.</p> <?php end_section() ?> <a name="napster"></a> @@ -127,7 +131,7 @@ <p> Ahh, Napster. The music sharing network that started it all. Gaim does not support sharing files over Napster. With that out of the way, what -does Gaim support? Insant messages and buddy list notification. We are +does Gaim support? Instant messages and buddy list notification. We are not aware of anyone that actually uses this... but it does work. You can get a free Napster Server from <a href="http://opennap.sourceforge.net/">http://opennap.sourceforge.net/</a>. @@ -175,6 +179,10 @@ They distribute Windows binaries. I'm n has always just been incidental while AOL blocked another service (Odigo and Jabber come to mind). </p> +<p> + There is some documentation of the Oscar protocol + <a href="http://www.kingant.net/oscar/">here</a> and + <a href="http://www.stud.uni-karlsruhe.de/~uck4/ICQ/Packets">here</a>. <?php end_section() ?> <a name="toc"></a> |