2 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
3 ziffy, a promiscuous Z39.50 APDU sniffer
5 Copyright (c) 1998-2001 R. Carbone <rocco@ntop.org>
16 -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
20 ziffy is a promiscuous Z39.50 APDU sniffer, like the popular tcpdump.
21 ziffy can capture and show all Z39.50 traffic on your LAN segment.
23 To perform its task ziffy needs at least two extra packages providing the
24 following functionalities:
26 (a) a portable framework for low-level network capturing facility
27 (b) BER decoding, printing and freeing routines
30 I compiled and run ziffy on my `explosive' linux intel based box with:
32 (a) libpcap 0.4a6 API, Copyright (c) 1993, 1994, 1995, 1996, 1997
33 by The Regents of the University of California
36 (b) X/ASN.1 Toolkit 1.0.0, Copyright (c) 1989-1998 by Finsiel S.p.A.
37 (c) YAZ Toolkit 1.7 API, Copyright (c) 1995-2001 by Index Data
38 (d) SNACC Toolkit 1.3 API, Copyright (c) 1991, 1993 by Michael Sample and UCB
39 Copyright (c) 1994 1995 by Robert Joop and GMD Fokus
45 The ziffy program is released under the terms of the GNU GPL, read the file
46 COPYING for more information.
51 ziffy depends on a couple of extra packages for working properly:
53 - libpcap, the Packet Capture Library. It can be found at:
55 ftp://ftp.ee.lbl.gov/libpcap.tar.Z
60 - X/ASN.1 Toolkit from Finsiel S.p.A.
61 contact us at zeta@tlcpi.finsiel.it if you need more information
64 - YAZ Toolkit, the so popular "Yet Another Z39.50 Toolkit" from Index Data.
66 You can find the YAZ Toolkit in:
68 ftp://ftp.indexdata.dk/pub/yaz/yaz-1.7.tar.gz
70 for more information about YAZ please visit:
71 http://www.indexdata.dk
74 - SNACC Toolkit, the "Sample Neufeld ASN.1 to C Compiler".
76 You can find the most recent (1.3) version of SNACC at:
78 ftp://ftp.fokus.gmd.de/pub/freeware/snacc/snacc-1.3.tar.gz
81 old version 1.1, but commonly used, is in:
82 ftp://ftp.cs.ucb.ca/pub/local/src/snacc/snacc-1.1.tar.Z
85 for more information visit SNACC home page:
86 http://www.fokus.gmd.de/ovma/freeware/snacc/entry.html
90 If you know of other freeware ASN.1 Toolkits, please drop me a note.
91 I will try to include them in all future versions of ziffy.
98 Sun Solaris 2.5.1 and/or 2.6
99 ix?86 Linux 2.0.X (bug on it! be patient until I have time to fix it!)
104 o To compile ziffy, you need to build and install libpcap and the
105 YAZ Toolkit or SNACC Toolkit first, or both at your choice
107 o Run "./configure" if you have libpcap and SNACC/YAZ Toolkit on standard
108 places. Otherwise, to build from source distributions, run:
110 ./configure --with-pcap-dir=your_libpcap_location
111 --with-yaz-dir=your_yaz_location --with-snacc-dir=your_snacc_location
113 "configure" will determine your system attributes and generate
114 an appropriate Makefile from Makefile.in.
116 o Run "make". If everything is ok, you should have a binary
119 o Run "make install". everything will go to the right places.
124 Importants RFC's you should read to fully understand what we are talking
127 [] RFC 1729: Using the Z39.50 Information Retrieval Protocol
128 in the Internet Environment
133 Please send me patches for any modifications you need to compile,
134 install and run the program.