Fix warning when generate documentation (doxygen)
[metze/wireshark/wip.git] / README.irix
1 1. Some problems seen by one person who tried to build Ethereal on IRIX;
2 your mileage may vary.  Some comments have been added.
3
4 To: ethereal-dev@zing.org
5 Subject: Re: [ethereal-dev] Ethereal on SGI
6 From: Randall Hopper <aa8vb@yahoo.com>
7 Date: Sat, 18 Sep 1999 12:19:31 -0400
8
9  |>      Just tried to build ethereal on SGI IRIX.  configure failed because
10  |> there is no net/bpf.h.
11
12 Thanks for all the help.  I pulled the latest today (0.7.3), and after a
13 few fix-ups, I got it built.  Here are the tweaks I needed to build it for
14 SGI IRIX 6.5 using gcc.
15
16 ==========
17 PROBLEM #1
18 ==========
19
20    Ethereal doesn't use RPATH (see ld(1) for shared library linking on all
21    platforms that support it (e.g. SGI IRIX, FreeBSD ELF, etc.), just
22    Solaris it appears.  Instead, ethereal recommends use of the
23    LD_LIBRARY_PATH hack which causes all sorts problems.
24
25    On SGI IRIX this is -rpath to the linker, on Solaris -R, on FreeBSD ELF
26    --rpath, etc.
27
28    SOLUTION: Slip in my linker flags when configuring ethereal so it can
29              find libgtk, libgmodule, libsnmp, etc. at run-time without
30              LD_LIBRARY_PATH:
31
32    env LDFLAGS="-rpath $HOME/software/gtk+-1.2.3/lib:$HOME/software/glib-1.2.3/lib:/usr/local/lib" configure --prefix=$HOME/software/ethereal-0.7.3 --with-gtk-prefix=$HOME/software/gtk+-1.2.3
33
34    BETTER SOLUTION:  Modify configure to support RPATH for more platforms
35                      than Solaris.
36
37 [NOTE: configure is generated from configure.ac and acinclude.m4, and
38 all the linking stuff is done by libtool.  We don't recommend the
39 LD_LIBRARY_PATH hack - perhaps we did so in the past, but we don't do so
40 now.]
41
42 ==========
43 PROBLEM #2
44 ==========
45
46    __P not defined -- packet-snmp.c fails to build
47    (gcc version 2.95.1 19990816 (release), SGI IRIX 6.5.5f)
48
49    SOLUTION:  Include gnuc.h -- it defines it
50
51    --- ORIG/packet-snmp.c  Mon Aug 30 11:10:17 1999
52    +++ packet-snmp.c       Sat Sep 18 11:35:45 1999
53    @@ -25,4 +25,6 @@
54      */
55
56    +#include "gnuc.h"
57    +
58     #ifdef HAVE_CONFIG_H
59     # include "config.h"
60
61 Randall
62
63 [NOTE: we don't use the __P macro ourselves; some of the SNMP libraries
64 might, but that's a bug in the libraries if they require you to define
65 __P in order to use them.]
66
67 ===============================================================================
68
69 Problem #1:
70
71 checking for GTK - version >= 1.2.0... 186062:./conftest: rld: Fatal Error: Cannot Successfully map soname 'libgtk-1.2.so.1' under any of the filenames /usr/lib32/libgtk-1.2.so.1:/usr/lib32/internal/libgtk-1.2.so.1:/lib32/libgtk-1.2.so.1:/opt/lib32/libgtk
72 no
73 *** Could not run GTK test program, checking why...
74 *** The test program compiled, but did not run. This usually means
75 *** that the run-time linker is not finding GTK or finding the wrong
76 *** version of GTK. If it is not finding GTK, you'll need to set your
77 *** LD_LIBRARY_PATH environment variable, or edit /etc/ld.so.conf to point
78 *** to the installed location  Also, make sure you have run ldconfig if that
79 *** is required on your system
80 ***
81 *** If you have an old version installed, it is best to remove it, although
82 *** you may also be able to get things to work by modifying LD_LIBRARY_PATH
83 ***
84 *** If you have a RedHat 5.0 system, you should remove the GTK package that
85 *** came with the system with the command
86 ***
87 ***    rpm --erase --nodeps gtk gtk-devel
88 configure: error: GTK+ distribution not found.
89
90 ==============================================================================
91
92 Problem #2:
93
94 gcc -DHAVE_CONFIG_H -I. -I. -I.     -Wall -g -O2 -Iwiretap -I/home/rhh/software/gtk+-1.2.3/include -I/home/rhh/software/glib-1.2.3/lib/glib/include -I/home/rhh/software/glib-1.2.3/include -c packet-snmp.c
95 In file included from packet-snmp.c:62:
96 /usr/local/include/ucd-snmp/asn1.h:131: parse error before `__P'
97 /usr/local/include/ucd-snmp/asn1.h:132: parse error before `__P'
98 /usr/local/include/ucd-snmp/asn1.h:133: parse error before `__P'
99 /usr/local/include/ucd-snmp/asn1.h:134: parse error before `__P'
100 /usr/local/include/ucd-snmp/asn1.h:135: parse error before `__P'
101 ...
102 packet-snmp.c: In function `dissect_snmp':
103 packet-snmp.c:344: warning: implicit declaration of function `asn_parse_header'
104 packet-snmp.c:358: warning: implicit declaration of function `snmp_comstr_parse'
105 packet-snmp.c:358: warning: assignment makes pointer from integer without a cast
106 packet-snmp.c:407: warning: assignment makes pointer from integer without a cast
107 ...
108 packet-snmp.c: In function `proto_register_snmp':
109 packet-snmp.c:869: warning: implicit declaration of function `init_mib'
110 gmake[2]: *** [packet-snmp.o] Error 1
111 gmake[2]: Leaving directory `/home/rhh/software/PKGS/t/ethereal-0.7.3'
112 gmake[1]: *** [all-recursive] Error 1
113 gmake[1]: Leaving directory `/home/rhh/software/PKGS/t/ethereal-0.7.3'
114 gmake: *** [all-recursive-am] Error 2
115
116 -------------------------------------------------------------------------------
117
118 Problem #3 (same as Problem #1):
119
120 > ./ethereal 
121 189684:./ethereal: rld: Fatal Error: Cannot Successfully map soname 'libsnmp.so' under any of the filenames /home/rhh/software/gtk+-1.2.3/lib/libsnmp.so:/home/rhh/software/glib-1.2.3/lib/libsnmp.so:/usr/lib32/libsnmp.so:/usr/lib32/internal/libsnmp.so:/lib32/libsnmp.so:/opt/lib32/libsnmp.so: 
122
123 2. Patches to libpcap that may be necessary
124
125 On IRIX, older versions of the libpcap library use, in
126 "pcap_open_live()", the snapshot length passed in, without reducing it
127 to be less than or equal to the MTU of the interface.  If the snapshot
128 length is larger than the interface MTU, IRIX will return an error; this
129 means that, for example, the Wireshark default snapshot length of 65535,
130 chosen so that all of the packet is captured, will not work.
131
132 Current versions of libpcap, from tcpdump.org, do not do so.