| 1 |
@(#)$eterna: INSTALL,v 2.27 2024/01/11 18:51:53 mrg Exp $ |
| 2 |
|
| 3 |
to compile ircii |
| 4 |
|
| 5 |
o ircii now requires an C99 compiler. this was not the case in |
| 6 |
in any version prior to 2014, but 15 years of C99 is long |
| 7 |
enough... |
| 8 |
|
| 9 |
o using configure: |
| 10 |
- we recommend that you create an object directory in the same |
| 11 |
directory that this file is in. you should then cd into your |
| 12 |
new directory and run the `configure' script in the source |
| 13 |
directory. eg: |
| 14 |
|
| 15 |
% mkdir obj-sparc |
| 16 |
% cd obj-sparc |
| 17 |
% ../configure |
| 18 |
|
| 19 |
- this script tries to guess various things about your system |
| 20 |
that are important to it compiling. it creates various files |
| 21 |
in this process. configure takes a couple of minutes to run. |
| 22 |
|
| 23 |
- when this has finished, you might want to check the Makefile |
| 24 |
for the places ircii will be installed. the defaults are |
| 25 |
/usr/local/share, /usr/local/bin and /usr/local/man. you can |
| 26 |
either do `make prefix=/local' or set it with configure, by |
| 27 |
calling configure with the `--prefix=/local' switch. |
| 28 |
|
| 29 |
- you can set the compile-time paranoid switch (currently |
| 30 |
turns of CTCP VERSION and FINGER commands returning host |
| 31 |
system, and user details) with the `--with-paranoid' flag to |
| 32 |
configure. |
| 33 |
|
| 34 |
- you can run `./configure --help' to see all the options that |
| 35 |
you may pass to ./configure. |
| 36 |
|
| 37 |
o to compiling ircii, type `make' in your object directory. |
| 38 |
this will compile the `irc', `ircflush', `ircio', and `wserv' |
| 39 |
programs that reside in the source sub directory. |
| 40 |
|
| 41 |
o once the programs are compiled, you can install them with |
| 42 |
`make install'. this will install all the binaries, scripts, |
| 43 |
translation tables, help files, and the ircii manual page. if |
| 44 |
you don't install the scripts then ircii becomes much less usable. |
| 45 |
|
| 46 |
o you can now delete the object files and binaries from your object |
| 47 |
directory with `make clean'. `make distclean' will also delete |
| 48 |
any file that `configure' created. this is useful for then |
| 49 |
using the same sources to compile on a different architecture. |
| 50 |
|
| 51 |
o there is a relatively "lame" Makefile generated if you try to use |
| 52 |
the old method of "./configure && make" while in the ircii root |
| 53 |
directory. if you're using the old method, you're probably not |
| 54 |
even going to read this file... |
| 55 |
|
| 56 |
|
| 57 |
notes on SOCKS support. |
| 58 |
|
| 59 |
o in order to compile in SOCKS support, you must use `configure' |
| 60 |
and specify the `--with-socks' switch. you can optionally specify |
| 61 |
a path (e.g. `--with-socks=/usr/local/lib/libsocks.a'). otherwise, |
| 62 |
configure will look for the SOCKS library only in the directory |
| 63 |
specified by the `--prefix' option (`/usr/local/lib' by default). |
| 64 |
there are also --with-socks4 and --with-socks5 options to force |
| 65 |
the use of SOCKS4 or SOCKS5 library. |
| 66 |
|
| 67 |
o an irc server getting a connection through a SOCKS proxy will |
| 68 |
not be able to do RFC1413 identification properly. if you have |
| 69 |
an identd running on the SOCKS proxy host, the irc server will |
| 70 |
incorrectly identify all users as `root'. |
| 71 |
|
| 72 |
o SOCKS support is incompatible with ircii's support for non-blocking |
| 73 |
connects. if you don't know what this means, don't worry about it. |
| 74 |
|
| 75 |
|
| 76 |
notes on portability and bugs. |
| 77 |
|
| 78 |
o if you encounter a bug, try the provided `ircbug' script which will |
| 79 |
submit a bug report and have it entered automatically into the |
| 80 |
ircii bugs database. send email with the subject of `--help' (no |
| 81 |
body necessary, but it is ignored) to [email protected] |
| 82 |
to see how to use this service. |
| 83 |
|
| 84 |
o if you are using linux and receive a message from `configure' that |
| 85 |
it can't find tgetent or you get missing tputs symbols, try |
| 86 |
installing the ncurses-devel or libtermcap-devel package. |
| 87 |
|
| 88 |
o apparently you will get errors of "__inet_addr" or "__inet_ntoa" |
| 89 |
as being undefined, if you have BIND version 8 installed into |
| 90 |
/usr/local (the default) and you use gcc. this is caused by the |
| 91 |
annoyingly stupid defines in the BIND provided <arpa/inet.h> header |
| 92 |
file, which gcc will happily pick up from /usr/local/include. |
| 93 |
the solution to this is to add -lbind to the LIBS= line in the |
| 94 |
Makefile, once configure has run. |
| 95 |
|
| 96 |
o on solaris systems with libresolv patches incorporated may see |
| 97 |
instability (crashes) in the client. (sunos 5.5.1 patches |
| 98 |
103680-01, 103683-01, 103686-01, 103743-01, and 103663-01). |
| 99 |
|
| 100 |
o Under NEXTSTEP, after you have run configure, you can change the |
| 101 |
CFLAGS and add "-arch m68k -arch i486 -arch hppa -arch sparc" (without |
| 102 |
the quotes) to create a multiple architecture binary for all supported |
| 103 |
hardware platforms. |