Add comments about nettl support.
[obnox/wireshark/wip.git] / README.hpux
1 Contents :
2
3 1 - Building ethereal
4 2 - "libpcap" on HP-UX
5 3 - nettl support
6
7 1 - Building ethereal
8
9 The Software Porting And Archive Centre for HP-UX, at
10
11         http://hpux.csc.liv.ac.uk/
12
13 (and with mirrors in various countries, listed on the Centre's home
14 page) has ported versions, in both source and binary form, for Ethereal,
15 as well as for the "libpcap", GLib, GTK+, "zlib", and CMU SNMP libraries
16 that it uses.
17
18 The changes they've made appear largely to be compile option changes; if
19 you've downloaded the source to the latest version of Ethereal (the
20 version on the Centre's site may not necessarily be the latest version),
21 it should be able to compile, perhaps with those changes.
22
23 They appear to have used HP-UX's "cc" compiler, with the options "-Ae
24 -O"; there's a comment "Add -Dhpux_9 if building under 9.X".  It may
25 also build with GCC.
26
27 2 - "libpcap" on HP-UX
28
29 If you want to use Ethereal to capture packets, you will have to install
30 "libpcap"; the INSTALL file for "libpcap" has several comments about
31 HP-UX, which you should read if you're going to install and use
32 "libpcap" on HP-UX.
33
34 Another note, from a mail message to the "ethereal-users" list:
35
36   Date: Wed, 22 Dec 1999 09:05:47 -0600 (EST)
37   From: Gerald Combs <gerald@zing.org>
38   To: Lothar Seitter <lothar.seitter@arcormail.de>
39   cc: ethereal-users@zing.org
40   Subject: Re: [ethereal-users] permission problem with capturing
41
42   On Wed, 22 Dec 1999, Lothar Seitter wrote:
43
44   > running 'ethereal' under HP-UX 11 with root permission and
45   > /dev/lan0 set to 777, I always get the message:
46   > "There are no network interfaces that can be opened.
47   > Please to make sure you have sufficient permission to 
48   > capture packets."
49   > 
50   > I start ethereal with 'etheral -i lan0' and lan0 is definitely
51   > the lan interface.
52   > 
53   > What am I missing???
54
55   You may need to reference the card's DLPI device directly.  We were having
56   trouble getting Ethereal to capture on an HP-UX 10.20 machine here.  I
57   found an article on Deja News that says:
58
59   "To access a particular interface, you would say "tcpdump -i /dev/dlpiN"
60   where N is the PPA of the interface you wish to use. You get the PPA by
61   looking at the output of lanscan. On 10.20, it is the same value as the
62   NMID. On 11.X, it is the Card Instance number."
63
64   This didn't help in our case, but it might in yours.  The full article is
65   at http://x34.deja.com/[ST_rn=ps]/getdoc.xp?AN=549366486 .
66
67   Another article by the same author mentions that experimental versions of
68   libpcap and tcpdump are available at
69   ftp://ftp.cup.hp.com/dist/networking/tools/ .  The article itself is at
70   http://x34.deja.com/[ST_rn=ps]/getdoc.xp?AN=558665378 .
71
72 The first of those articles also says:
73
74   BTW, before you have to make a follow-up post, you will find that
75   unless you have the latest lan common/DLPI/driver patches installed,
76   you will _not_ see the system's own outbound traffic.
77
78 It appears that a consequence of the fact that HP-UX's DLPI doesn't work
79 like Solaris's, in that, on Solaris, to get at the device "hme0", say,
80 "libpcap" has to open "/dev/hme" and then tell it to use the 0th
81 interface, whilst on HP-UX you have to go through "/dev/dlpi", you won't
82 get a list of interfaces in the dialog box for "Capture:Start" - you'll
83 have to do through the aforementioned song and dance to find the PPA of
84 the interface you want to use, and supply the "dlpiN" name by hand (I
85 think you can omit the "/dev/" in both tcpdump and Ethereal).
86
87 Here is a patch to "pcap-dlpi.c" in libpcap that, at least on HP-UX
88 11.X, allows the name of the network interface, rather than the "dlpiN"
89 name, to be specified to tcpdump and Ethereal.  It has not been tried on
90 HP-UX 10.20; it fixes one bug that could have caused the code in vanilla
91 libpcap not to correctly find the PPA for an interface on HP-UX 10.20,
92 but HP-UX 10.20's DLPI doesn't supply, in the data returned by a
93 DL_HP_PPA_REQ request, network interface names, so, on systems without
94 the network interface names in that data, the code continues to check
95 the major device number.
96
97 On HP-UX 11.00, the patch allows a network interface to be specified by
98 name as an argument to tcpdump, rather than requiring that you specify a
99 "dlpiN" name (and it should work equally well with Ethereal).
100
101 If you try this code on HP-UX 10.20, and it doesn't let you specify the
102 interface by name, please send mail to ethereal-dev@zing.org, so that we
103 know that it didn't work - we'll probably send you debugging patches in
104 the hopes of being able to make it work on 10.20 as well.
105
106 Here's the patch (to vanilla libpcap 0.4; it patches "configure",
107 "aclocal.m4", and "configure.in", to make the configure script check
108 whether your version of HP-UX supplies the interface names in the reply
109 to a DL_HP_PPA_REQ request, and "pcap-dlpi.c"):
110
111 *** ../libpcap-0.4/configure    Sat Jul 25 12:41:51 1998
112 --- configure   Fri Jan 14 00:40:04 2000
113 ***************
114 *** 1702,1709 ****
115   
116       fi
117   
118   echo $ac_n "checking if unaligned accesses fail""... $ac_c" 1>&6
119 ! echo "configure:1707: checking if unaligned accesses fail" >&5
120       if eval "test \"`echo '$''{'ac_cv_lbl_unaligned_fail'+set}'`\" = set"; then
121     echo $ac_n "(cached) $ac_c" 1>&6
122   else
123 --- 1702,1745 ----
124   
125       fi
126   
127 + echo $ac_n "checking if dl_hp_ppa_info_t struct has dl_module_id_1 member""... $ac_c" 1>&6
128 + echo "configure:1707: checking if dl_hp_ppa_info_t struct has dl_module_id_1 member" >&5
129 +     if eval "test \"`echo '$''{'ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1'+set}'`\" = set"; then
130 +   echo $ac_n "(cached) $ac_c" 1>&6
131 + else
132 +   cat > conftest.$ac_ext <<EOF
133 + #line 1712 "configure"
134 + #include "confdefs.h"
135
136 + #     include <sys/types.h>
137 + #     include <sys/dlpi.h>
138 + #     include <sys/dlpi_ext.h>
139 + int main() {
140 + u_int i = sizeof(((dl_hp_ppa_info_t *)0)->dl_module_id_1)
141 + ; return 0; }
142 + EOF
143 + if { (eval echo configure:1722: \"$ac_compile\") 1>&5; (eval $ac_compile) 2>&5; }; then
144 +   rm -rf conftest*
145 +   ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1=yes
146 + else
147 +   echo "configure: failed program was:" >&5
148 +   cat conftest.$ac_ext >&5
149 +   rm -rf conftest*
150 +   ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1=no
151 + fi
152 + rm -f conftest*
153 + fi
154
155 +     echo "$ac_t""$ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1" 1>&6
156 +     if test $ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1 = yes ; then
157 +           cat >> confdefs.h <<\EOF
158 + #define HAVE_HP_PPA_INFO_T_DL_MODULE_ID_1 1
159 + EOF
160
161 +     fi
162
163   echo $ac_n "checking if unaligned accesses fail""... $ac_c" 1>&6
164 ! echo "configure:1743: checking if unaligned accesses fail" >&5
165       if eval "test \"`echo '$''{'ac_cv_lbl_unaligned_fail'+set}'`\" = set"; then
166     echo $ac_n "(cached) $ac_c" 1>&6
167   else
168 ***************
169 *** 1799,1805 ****
170   # SVR4 /usr/ucb/install, which tries to use the nonexistent group "staff"
171   # ./install, which can be erroneously created by make from ./install.sh.
172   echo $ac_n "checking for a BSD compatible install""... $ac_c" 1>&6
173 ! echo "configure:1803: checking for a BSD compatible install" >&5
174   if test -z "$INSTALL"; then
175   if eval "test \"`echo '$''{'ac_cv_path_install'+set}'`\" = set"; then
176     echo $ac_n "(cached) $ac_c" 1>&6
177 --- 1835,1841 ----
178   # SVR4 /usr/ucb/install, which tries to use the nonexistent group "staff"
179   # ./install, which can be erroneously created by make from ./install.sh.
180   echo $ac_n "checking for a BSD compatible install""... $ac_c" 1>&6
181 ! echo "configure:1839: checking for a BSD compatible install" >&5
182   if test -z "$INSTALL"; then
183   if eval "test \"`echo '$''{'ac_cv_path_install'+set}'`\" = set"; then
184     echo $ac_n "(cached) $ac_c" 1>&6
185
186
187 *** ../libpcap-0.4/aclocal.m4   Fri Jun 12 03:45:15 1998
188 --- aclocal.m4  Tue Jan  4 21:02:13 2000
189 ***************
190 *** 415,420 ****
191 --- 415,454 ----
192       fi])
193   
194   dnl
195 + dnl Checks to see if the dl_hp_ppa_info_t struct has the HP-UX 11.00
196 + dnl dl_module_id_1 member
197 + dnl
198 + dnl usage:
199 + dnl
200 + dnl   AC_LBL_HP_PPA_INFO_T_DL_MODULE_ID_1
201 + dnl
202 + dnl results:
203 + dnl
204 + dnl   HAVE_HP_PPA_INFO_T_DL_MODULE_ID_1 (defined)
205 + dnl
206 + dnl NOTE: any compile failure means we conclude that it doesn't have
207 + dnl that member, so if we don't have DLPI, don't have a <sys/dlpi_ext.h>
208 + dnl header, or have one that doesn't declare a dl_hp_ppa_info_t type,
209 + dnl we conclude it doesn't have that member (which is OK, as either we
210 + dnl won't be using code that would use that member, or we wouldn't
211 + dnl compile in any case).
212 + dnl
213 + AC_DEFUN(AC_LBL_HP_PPA_INFO_T_DL_MODULE_ID_1,
214 +     [AC_MSG_CHECKING(if dl_hp_ppa_info_t struct has dl_module_id_1 member)
215 +     AC_CACHE_VAL(ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1,
216 +       AC_TRY_COMPILE([
217 + #     include <sys/types.h>
218 + #     include <sys/dlpi.h>
219 + #     include <sys/dlpi_ext.h>],
220 +       [u_int i = sizeof(((dl_hp_ppa_info_t *)0)->dl_module_id_1)],
221 +       ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1=yes,
222 +       ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1=no))
223 +     AC_MSG_RESULT($ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1)
224 +     if test $ac_cv_lbl_dl_hp_ppa_info_t_has_dl_module_id_1 = yes ; then
225 +           AC_DEFINE(HAVE_HP_PPA_INFO_T_DL_MODULE_ID_1)
226 +     fi])
227
228 + dnl
229   dnl Checks to see if -R is used
230   dnl
231   dnl usage:
232
233
234 *** ../libpcap-0.4/configure.in Sun Jul 27 22:16:22 1997
235 --- configure.in        Tue Jan  4 21:02:13 2000
236 ***************
237 *** 154,159 ****
238 --- 154,161 ----
239   
240   AC_LBL_SOCKADDR_SA_LEN
241   
242 + AC_LBL_HP_PPA_INFO_T_DL_MODULE_ID_1
243
244   AC_LBL_UNALIGNED_ACCESS
245   
246   if test "${srcdir}" = "." ; then
247
248 *** ../libpcap-0.4/pcap-dlpi.c  Wed Oct 15 21:59:34 1997
249 --- pcap-dlpi.c Tue Jan  4 21:02:13 2000
250 ***************
251 *** 246,255 ****
252         }
253         memset(p, 0, sizeof(*p));
254   
255         /*
256 !       ** Determine device and ppa
257         */
258 !       cp = strpbrk(device, "0123456789");
259         if (cp == NULL) {
260                 sprintf(ebuf, "%s missing unit number", device);
261                 goto bad;
262 --- 246,266 ----
263         }
264         memset(p, 0, sizeof(*p));
265   
266 + #ifdef HAVE_DEV_DLPI
267         /*
268 !       ** Remove any "/dev/" on the front of the device.
269         */
270 !       cp = strrchr(device, '/');
271 !       if (cp == NULL)
272 !               cp = device;
273 !       else
274 !               cp++;
275 !       strcpy(dname, cp);
276
277 !       /*
278 !        * Split the name into a device type and a unit number.
279 !        */
280 !       cp = strpbrk(dname, "0123456789");
281         if (cp == NULL) {
282                 sprintf(ebuf, "%s missing unit number", device);
283                 goto bad;
284 ***************
285 *** 259,281 ****
286                 sprintf(ebuf, "%s bad unit number", device);
287                 goto bad;
288         }
289   
290 !       if (*device == '/')
291 !               strcpy(dname, device);
292 !       else
293 !               sprintf(dname, "%s/%s", PCAP_DEV_PREFIX, device);
294 ! #ifdef HAVE_DEV_DLPI
295 !       /* Map network device to /dev/dlpi unit */
296         cp = "/dev/dlpi";
297         if ((p->fd = open(cp, O_RDWR)) < 0) {
298                 sprintf(ebuf, "%s: %s", cp, pcap_strerror(errno));
299                 goto bad;
300         }
301 !       /* Map network interface to /dev/dlpi unit */
302         ppa = get_dlpi_ppa(p->fd, dname, ppa, ebuf);
303         if (ppa < 0)
304                 goto bad;
305   #else
306         /* Try device without unit number */
307         strcpy(dname2, dname);
308         cp = strchr(dname, *cp);
309 --- 270,331 ----
310                 sprintf(ebuf, "%s bad unit number", device);
311                 goto bad;
312         }
313 +       *cp = '\0';
314   
315 !       /*
316 !        * Use "/dev/dlpi" as the device.
317 !        *
318 !        * XXX - HP's DLPI Programmer's Guide for HP-UX 11.00 says that
319 !        * the "dl_mjr_num" field is for the "major number of interface
320 !        * driver"; that's the major of "/dev/dlpi" on the system on
321 !        * which I tried this, but there may be DLPI devices that
322 !        * use a different driver, in which case we may need to
323 !        * search "/dev" for the appropriate device with that major
324 !        * device number, rather than hardwiring "/dev/dlpi".
325 !        *
326 !        * I'm assuming that the code that was used for HP-UX 10.x
327 !        * is valid, and therefore that, in 10.x, DLPIable devices have
328 !        * "/dev" entries corresponding to them and that their
329 !        * major device number is what appears in the "dl_hp_ppa_info_t"
330 !        * structure for that device.  We can search by name in 11.x
331 !        * (and we may have to, as it's not clear that DLPIable devices
332 !        * will have those sorts of "/dev" entries), but we can't in
333 !        * 10.x, as 10.x doesn't have the "dl_module_id_1" and
334 !        * "dl_module_id_2" members in the "dl_hp_ppa_info_t" structure.
335 !        */
336         cp = "/dev/dlpi";
337         if ((p->fd = open(cp, O_RDWR)) < 0) {
338                 sprintf(ebuf, "%s: %s", cp, pcap_strerror(errno));
339                 goto bad;
340         }
341
342 !       /*
343 !        * Get a table of all PPAs for that device, and search that
344 !        * table for the specified device type name and unit number.
345 !        */
346         ppa = get_dlpi_ppa(p->fd, dname, ppa, ebuf);
347         if (ppa < 0)
348                 goto bad;
349   #else
350 +       /*
351 +       ** Determine device and ppa
352 +       */
353 +       cp = strpbrk(device, "0123456789");
354 +       if (cp == NULL) {
355 +               sprintf(ebuf, "%s missing unit number", device);
356 +               goto bad;
357 +       }
358 +       ppa = strtol(cp, &eos, 10);
359 +       if (*eos != '\0') {
360 +               sprintf(ebuf, "%s bad unit number", device);
361 +               goto bad;
362 +       }
363
364 +       if (*device == '/')
365 +               strcpy(dname, device);
366 +       else
367 +               sprintf(dname, "%s/%s", PCAP_DEV_PREFIX, device);
368
369         /* Try device without unit number */
370         strcpy(dname2, dname);
371         cp = strchr(dname, *cp);
372 ***************
373 *** 391,397 ****
374                 break;
375   
376         default:
377 !               sprintf(ebuf, "unknown mac type 0x%lu", infop->dl_mac_type);
378                 goto bad;
379         }
380   
381 --- 441,448 ----
382                 break;
383   
384         default:
385 !               sprintf(ebuf, "unknown mac type 0x%lu",
386 !                   (unsigned long)infop->dl_mac_type);
387                 goto bad;
388         }
389   
390 ***************
391 *** 709,715 ****
392   
393   #ifdef DL_HP_PPA_ACK_OBS
394   /*
395 !  * Under HP-UX 10, we can ask for the ppa
396    */
397   
398   
399 --- 760,766 ----
400   
401   #ifdef DL_HP_PPA_ACK_OBS
402   /*
403 !  * Under HP-UX 10 and HP-UX 11, we can ask for the ppa
404    */
405   
406   
407 ***************
408 *** 719,736 ****
409       register char *ebuf)
410   {
411         register dl_hp_ppa_ack_t *ap;
412 !       register dl_hp_ppa_info_t *ip;
413         register int i;
414         register u_long majdev;
415 -       dl_hp_ppa_req_t req;
416         struct stat statbuf;
417         bpf_u_int32 buf[MAXDLBUF];
418   
419 !       if (stat(device, &statbuf) < 0) {
420 !               sprintf(ebuf, "stat: %s: %s", device, pcap_strerror(errno));
421                 return (-1);
422         }
423         majdev = major(statbuf.st_rdev);
424   
425         memset((char *)&req, 0, sizeof(req));
426         req.dl_primitive = DL_HP_PPA_REQ;
427 --- 770,800 ----
428       register char *ebuf)
429   {
430         register dl_hp_ppa_ack_t *ap;
431 !       register dl_hp_ppa_info_t *ipstart, *ip;
432         register int i;
433 + #ifndef HAVE_HP_PPA_INFO_T_DL_MODULE_ID_1
434 +       char dname[100];
435         register u_long majdev;
436         struct stat statbuf;
437 + #endif
438 +       dl_hp_ppa_req_t req;
439         bpf_u_int32 buf[MAXDLBUF];
440   
441 ! #ifndef HAVE_HP_PPA_INFO_T_DL_MODULE_ID_1
442 !       /*
443 !        * HP-UX 10 doesn't put the interface name in the
444 !        * "dl_hp_ppa_info_t" structure, so we have to
445 !        * try to get the major device number for the device
446 !        * corresponding to the device and unit name provided to
447 !        * us, and search for the entry with that major device number.
448 !        */
449 !       sprintf(dname, "/dev/%s%d", device, unit);
450 !       if (stat(dname, &statbuf) < 0) {
451 !               sprintf(ebuf, "stat: %s: %s", dname, pcap_strerror(errno));
452                 return (-1);
453         }
454         majdev = major(statbuf.st_rdev);
455 + #endif
456   
457         memset((char *)&req, 0, sizeof(req));
458         req.dl_primitive = DL_HP_PPA_REQ;
459 ***************
460 *** 741,760 ****
461                 return (-1);
462   
463         ap = (dl_hp_ppa_ack_t *)buf;
464 !       ip = (dl_hp_ppa_info_t *)((u_char *)ap + ap->dl_offset);
465   
466           for(i = 0; i < ap->dl_count; i++) {
467 !                 if (ip->dl_mjr_num == majdev && ip->dl_instance_num == unit)
468                           break;
469   
470 !                 ip = (dl_hp_ppa_info_t *)((u_char *)ip + ip->dl_next_offset);
471           }
472           if (i == ap->dl_count) {
473 !                 sprintf(ebuf, "can't find PPA for %s", device);
474                 return (-1);
475           }
476           if (ip->dl_hdw_state == HDW_DEAD) {
477 !                 sprintf(ebuf, "%s: hardware state: DOWN\n", device);
478                 return (-1);
479           }
480           return ((int)ip->dl_ppa);
481 --- 805,831 ----
482                 return (-1);
483   
484         ap = (dl_hp_ppa_ack_t *)buf;
485 !       ipstart = (dl_hp_ppa_info_t *)((u_char *)ap + ap->dl_offset);
486 !       ip = ipstart;
487   
488           for(i = 0; i < ap->dl_count; i++) {
489 ! #ifdef HAVE_HP_PPA_INFO_T_DL_MODULE_ID_1
490 !               if ((strcmp(ip->dl_module_id_1, device) == 0 ||
491 !                    strcmp(ip->dl_module_id_2, device) == 0) &&
492 ! #else
493 !                 if (ip->dl_mjr_num == majdev &&
494 ! #endif
495 !                   ip->dl_instance_num == unit)
496                           break;
497   
498 !                 ip = (dl_hp_ppa_info_t *)((u_char *)ipstart + ip->dl_next_offset);
499           }
500           if (i == ap->dl_count) {
501 !                 sprintf(ebuf, "can't find PPA for %s%d", device, unit);
502                 return (-1);
503           }
504           if (ip->dl_hdw_state == HDW_DEAD) {
505 !                 sprintf(ebuf, "%s%d: hardware state: DOWN\n", device, unit);
506                 return (-1);
507           }
508           return ((int)ip->dl_ppa);
509 ***************
510 *** 783,789 ****
511         register int kd;
512         void *addr;
513         struct ifnet ifnet;
514 !       char if_name[sizeof(ifnet.if_name)], tifname[32];
515   
516         cp = strrchr(ifname, '/');
517         if (cp != NULL)
518 --- 854,860 ----
519         register int kd;
520         void *addr;
521         struct ifnet ifnet;
522 !       char if_name[sizeof(ifnet.if_name) + 1];
523   
524         cp = strrchr(ifname, '/');
525         if (cp != NULL)
526 ***************
527 *** 811,823 ****
528                 if (dlpi_kread(kd, (off_t)addr,
529                     &ifnet, sizeof(ifnet), ebuf) < 0 ||
530                     dlpi_kread(kd, (off_t)ifnet.if_name,
531 !                   if_name, sizeof(if_name), ebuf) < 0) {
532                         (void)close(kd);
533                         return (-1);
534                 }
535 !               sprintf(tifname, "%.*s%d",
536 !                   (int)sizeof(if_name), if_name, ifnet.if_unit);
537 !               if (strcmp(tifname, ifname) == 0)
538                         return (ifnet.if_index);
539         }
540   
541 --- 882,893 ----
542                 if (dlpi_kread(kd, (off_t)addr,
543                     &ifnet, sizeof(ifnet), ebuf) < 0 ||
544                     dlpi_kread(kd, (off_t)ifnet.if_name,
545 !                   if_name, sizeof(ifnet.if_name), ebuf) < 0) {
546                         (void)close(kd);
547                         return (-1);
548                 }
549 !               if_name[sizeof(ifnet.if_name)] = '\0';
550 !               if (strcmp(if_name, ifname) == 0 && ifnet.if_unit == unit)
551                         return (ifnet.if_index);
552         }
553   
554
555
556 3 - nettl support
557
558 nettl is used on HP-UX to trace various streams based subsystems.  Ethereal
559 can read nettl files containing IP frames (NS_LS_IP subsystem) and LAPB
560 frames (SX25L2 subsystem).
561 It has been tested with files generated on HP-UX 9.04 and 10.20.
562
563 Use the following commands to generate a trace (cf. nettl(1M)):
564
565 # IP capture. 0x30000000 means PDU in and PDU out :
566 nettl -tn 0x30000000 -e NS_LS_IP -f tracefile
567 # X25 capture. You must specify an interface :
568 nettl -tn 0x30000000 -e SX25l2 -d /dev/x25_0 -f tracefile
569 # stop capture. subsystem is NS_LS_IP or SX25L2 :
570 nettl -tf -e subsystem
571