Debian Codegraph @

INSTALL

raw
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.