commit 8e032ef3ce62345174b26501900b3bbc72525957
parent 67f4778ba7db9cae5ad30989f5bfd66de23528aa
Author: Antoine Amarilli <a3nm@a3nm.net>
Date: Sun, 5 May 2019 11:54:40 +0200
document latest situation with openssl 1.0 and 1.1
Diffstat:
| README | | | 45 | +++++++++++++++++++++++++++++++++++---------- |
1 file changed, 35 insertions(+), 10 deletions(-)
diff --git a/README b/README
@@ -41,18 +41,43 @@ location of your PATH if you want to use it as "irctk", otherwise replace
The rest of this section presents how to compile libircclient by yourself if
necessary, and how to install irctk without requiring root privileges.
-=== 2.1. Compiling libircclient ===
+=== 2.1. Installing OpenSSL ===
First, if you want support for SSL, you need to install the OpenSSL library and
-header files. You need to use OpenSSL version 1.0.2, *not* OpenSSL version 1.1.
-On Debian stretch and later, you can do so by running:
+header files. There are two mutually incompatible options: using OpenSSL version
+1.1, which requires a more recent version of libircclient; or using OpenSSL
+version 1.0.2, which works with libircclient version 1.9.
+
+- To use OpenSSL version 1.1, you can install the required headers on
+ sufficiently recent Debian versions with:
+
+ sudo apt-get install libssl-dev
+
+ This will work with libircclient compiled from revision r142 or later from the
+ source repository.
+
+- Use OpenSSL version 1.0.2. On Debian stretch and later, you can do so by
+ running:
sudo apt-get install libssl1.0-dev
-Second, you should get the latest libircclient (currently libircclient-1.9) from
-<https://sourceforge.net/projects/libircclient/>, compile it and install it
-(this requires of course make, a C compiler, etc., which you can get on Debian
-systems by installing e.g. the package build-essential). Then run:
+ This will work with libircclient version == 1.9 OR with libircclient compiled
+ from revision r142 or later from the source repository.
+
+=== 2.2. Compiling libircclient ===
+
+Second, you should get libircclient from
+<https://sourceforge.net/projects/libircclient/>. Either download a tagged
+release, e.g., libircclient-1.9 from
+<https://sourceforge.net/projects/libircclient/files/libircclient/1.9/>. Or
+check out the latest version of the source code with Subversion (apt-get install
+subversion) by issuing:
+
+ svn co svn://svn.code.sf.net/p/libircclient/code/trunk
+
+Then compile and install libircclient (this requires of course make, a C
+compiler, etc., which you can get on Debian systems by installing e.g. the
+package build-essential). To do this, going into the right folder, run:
umask 022 # avoids permission issues on installed files
./configure -enable-openssl --enable-shared
@@ -62,7 +87,7 @@ systems by installing e.g. the package build-essential). Then run:
Note that libircclient will install its libraries in /lib instead of
/usr/local/lib.
-=== 2.2. Installing without root ===
+=== 2.3. Installing without root ===
If you cannot install libircclient system-wide, compile it as previously
explained, without the "sudo" command. Then, issue (in the libircclient folder):
@@ -75,11 +100,11 @@ Now go back to the irctk folder, and edit the Makefile to add the following at
the end of the CFLAGS line, adjusting for the location of the libircclient
folder:
- -I/where/you/put/libircclient-1.9/include
+ -I/where/you/put/libircclient/include
Compile with "make", and now run irctk with the following invocation:
- LD_LIBRARY_PATH="/where/you/put/libircclient-1.9/src/:$LD_LIBRARY_PATH" ./irctk
+ LD_LIBRARY_PATH="/where/you/put/libircclient/src/:$LD_LIBRARY_PATH" ./irctk
== 3. How to use ==
