Debian Codegraph @

README

raw
1 30 Jan 2025
2
3 This is NFSWATCH Version 4.99.14. Changes from Version 4.99.13 are:
4
5 - Fix to allow build using gcc version 15
6 due to problems with old-style function definitions
7
8 20 Mar 2024
9
10 This is NFSWATCH Version 4.99.13. Changes from Version 4.99.12 are:
11
12 - Warn only once when receiving packets for an unsupported NFS version
13 - nfswatch fails to cross build from source, because the upstream
14 Makefile hard codes the build architecture pkg-config. After making
15 it substitutable, it cross builds just fine as dh_auto_build passes
16 the standard substitution.
17 - Fix typo in error mesage when filelist is missing
18 - Correct manpage sections.
19 - rm ChangeLog now that we are in git; note one more change in spec
20 and README
21
22 2 Aug 2022
23
24 This is NFSWATCH Version 4.99.12. Changes from Version 4.99.11 are:
25
26 - use libtirpc
27 - replace sighold() and sigrelse() by sigprocmask()
28 - include <sys/sysmacros.h> in util.c
29 - fix printf format issues in screen.c
30 - fix prototype of rpcxdr_getargs() in rpcutil.c
31
32 -------------------------------------------------------------------------------
33
34 23 Apr 2010
35
36 This is NFSWATCH Version 4.99.11. Changes from Version 4.99.10 are:
37
38 - README file converted to utf8
39 - Fix compile issues on Solaris and Linux alpha machines
40 - Add a ChangeLog file
41 - Add TODO note about broken strict aliasing rule
42
43 -------------------------------------------------------------------------------
44
45 15 Apr 2009
46
47 This is NFSWATCH Version 4.99.10. Changes from Version 4.99.9 are:
48
49 - use libpcap for packet capturing, thus allowing to monitor NFS
50 traffic also on InfiniBand and other interconnects.
51 - Add some TODO items...
52
53 -------------------------------------------------------------------------------
54
55 25 May 2007
56
57 This is NFSWATCH Version 4.99.9. Changes from Version 4.99.8 are:
58
59 - Improve filehandle decoding on Linux.
60 - Exclude known non-exports instead of guessing exports.
61 - Do not handle the second argument of RENAME3 and LINK3,
62 as it doesn't seem to work anyway.
63
64 -------------------------------------------------------------------------------
65
66 13 March 2007
67
68 This is NFSWATCH Version 4.99.8. Changes from Version 4.99.7 are:
69
70 - Handle more Linux filehandle's fsid_type
71 - Improve parsing of device name and instance number in dlpi
72
73 -------------------------------------------------------------------------------
74
75 30 January 2007
76
77 This is NFSWATCH Version 4.99.7. Changes from Version 4.99.6 are:
78
79 - Make per-procedure statistics work for NFSv3
80 - Makefile cleanups
81
82 -------------------------------------------------------------------------------
83
84 14 June 2006
85
86 This is NFSWATCH Version 4.99.6. Changes from Version 4.99.5 are:
87
88 - Fix buffer overflow problems
89 - Compiler warnings cleanup
90 - Allow compiling on IRIX (using GCC)
91
92 -------------------------------------------------------------------------------
93
94 22 November 2005
95
96 This is NFSWATCH Version 4.99.5. Changes from Version 4.99.4 are:
97
98 - Analyze NFS on TCP
99 - Improve total packet count display
100 - Allow compiling for 64-bit Solaris
101 - Allow compiling for older Solaris releases (5.6 and 5.7)
102 - Compiler warnings cleanup
103
104 -------------------------------------------------------------------------------
105
106 13 July 2005
107
108 This is NFSWATCH Version 4.99.4. Changes from Version 4.99.3 are:
109
110 - Fix NFS packet counting bug
111 - Improve Linux filehandle parsing
112
113 -------------------------------------------------------------------------------
114
115 2 June 2005
116
117 This is NFSWATCH Version 4.99.3. Changes from Version 4.99.2 are:
118
119 - Add xfs to the list of recognized filesystems
120
121 -------------------------------------------------------------------------------
122
123 22 April 2005
124
125 This is NFSWATCH Version 4.99.2. Changes from Version 4.99.1 are:
126
127 - Cleanup spec file for Fedora Extras
128
129 -------------------------------------------------------------------------------
130
131 25 February 2005
132
133 This is NFSWATCH Version 4.99.1. Changes from Version 4.3 are:
134
135 - Deal with NFSv3 and Linux filehandles
136
137 -------------------------------------------------------------------------------
138
139 12 February 1996
140
141 This is NFSWATCH Version 4.3. The only changes from Version 4.2 are:
142
143 - Should now compile properly on Solaris 2.5 (SunOS 5.5). Thanks
144 to Alexandre Oliva for the patch. As with Solaris 2.4, expect
145 several warnings on xdr.c.
146
147 - Added a patch to let is_exported() on SVR4 deal with symbolic links
148 in /etc/dfs/dfstab. Thanks to Ronald Hello for the patch.
149
150 - Added a patch to allow NFSWATCH to find out about more local file
151 system types (XFS on IRIX, PCFS and HSFS on SunOS). Thanks to
152 Andreas Stolcke for the patch.
153
154 - Added a patch to allow NFSwatch to understand Network Appliance
155 FAServer file handles. Thanks to Guy Harris for the patch.
156
157 -------------------------------------------------------------------------------
158
159 31 March 1995
160
161 This is NFSWATCH Version 4.2. The only changes from Version 4.1 are:
162
163 - Should now compile properly on Solaris 2.4 (SunOS 5.4), although
164 you should expect several warnings on xdr.c due to some annoying
165 discrepancies between type definitions.
166
167 - Added a workaround to a bug in Solaris 2.3 that causes
168 screwed up packets when the snapshot length is small.
169
170 - Added a patch to fix identification of file system devices
171 in Solaris 2.x.
172
173 - Added the "qeN" devices for Sun's SQE board (Quad Ethernet).
174
175 -------------------------------------------------------------------------------
176
177 1 December 1993
178
179 This is NFSWATCH Version 4.1. It lets you monitor NFS requests to any given
180 machine, or the entire local network. It mostly monitors NFS client traffic
181 (NFS requests); it also monitors the NFS reply traffic from a server in
182 order to measure the response time for each RPC.
183
184 This is primarily a release to fix bugs that were present in the previous
185 release. The following changes and bug fixes have been made since NFSWATCH
186 4.0:
187
188 - Compiles and runs under Solaris 2.2 and Solaris 2.3.
189
190 - Compiles and runs under DEC OSF/1 V1.3 and later.
191
192 - The NFS procedure display code has been fixed.
193
194 - Now understands Auspex file handles (thanks to Guy Harris).
195
196 - Now understands IRIX file handles (thanks to Jim Patterson).
197
198 - Now saves "-procs" output in the log file (thanks to Gary Schaps).
199
200 - The screendump feature now works properly on Solaris 2.x systems
201 (thanks to Gerry Singleton).
202
203 - The mechanism by which NFS file handles are parsed has been split
204 out into a separate module and completely redesigned. It is now
205 independent of the platform on which nfswatch is running, and uses
206 a variety of heuristics to figure out what the file handle
207 represents. Doubtless these heuristics will fail in some cases;
208 we have not been able to test the code against all possible NFS
209 servers.
210
211 If you find that nfswatch is not properly decoding a file handle
212 from one of your servers (say, foo.bar.com), you can help us out
213 by doing
214
215 % nfswatch -dst foo.bar.com -fhdebug
216
217 and capturing a page or two of the output. Then mail it to us,
218 and also tell us exactly what software is running on the server
219 (e.g., "DEC OSF/1 V1.3"). We cannot promise to fix the problem,
220 of course.
221
222 The following features and bug fixes appeared in NFSWATCH 4.0:
223
224 - NFSWATCH now runs on Sun SPARC machines under SunOS 5.x (Solaris
225 2.x) using the Data Link Provider Interface (DLPI), dlpi(7).
226
227 - NFSWATCH now runs on Silicon Graphics machines under IRIX 4.0
228 using the snoop(7) interface. It should also work on versions 3.2
229 and 3.3 (you'll need "-lbsd" on 3.2). Thanks to Tim Hudson of
230 Mincom Pty for the patches.
231
232 - NFSWATCH "almost" works on System V Release 4 systems. There are
233 some problems with the fact that Solaris 2.x uses DLPI 2.0 (good),
234 but most SVR4s out there still use DLPI 1.3 (bad). I've had a few
235 beta testers working on it, but they have not yet gotten it to
236 work. If you manage to get it working, *please* send patches.
237
238 - NFSWATCH now keeps track of timing information in the procedure
239 display, showing how quickly NFS calls receive replies. Thanks to
240 Peter Phillips of the University of British Columbia for the code.
241
242 - NFSWATCH now has an authenticator display, which shows the username
243 or user id of the originator of each packet. Thanks again to Peter
244 Phillips for the code.
245
246 - A first pass at support for FDDI interfaces has been added. The
247 support is better on some systems than others, as described below:
248
249 IRIX40: Has not been tested, and almost definitely will not work
250 "as is". The packet header that's read into from snoop
251 probably needs to be different. Send us patches if you
252 get it to work.
253
254 SUNOS4: Has been tested on a Sun-4/380 under SunOS 4.1.2. Works
255 with the SunNet FDDI/DX boards.
256
257 SUNOS5: Has not been tested, but "should" work. Send us patches
258 if it doesn't.
259
260 SVR4: Has not been tested, but "should" work. Send us patches if
261 it doesn't. (And if you get the rest of it working; see
262 above.)
263
264 ULTRIX: Works with Ultrix V4.2 or later *only*. All flavors of
265 Ultrix 4.2 (including 4.2A, 4.2B, 4.2C) require kernel
266 patches before you can use the FDDI code. Obtain the
267 patched versions of net_common.o and pfilt.o from your
268 Customer Support Center.
269
270 - A new option, "-server hostname" has been added to watch all the
271 traffic between a server and its clients; this is equivalent to
272 "src == hostname || dst == hostname", which is not specifiable
273 using the other options. Thanks again to Peter Phillips for the
274 patches.
275
276 - A new option, "-map", is available to help translate file system
277 device names to "english" names, e.g. "/usr" instead of
278 "fs1(7,23)". Thanks yet again to Peter Phillips.
279
280 - Two new options have been added to allow NFSWATCH to be run from
281 cron, via rsh, etc. The "-bg" option tells NFSWATCH to run in the
282 background, with no screen display. All information will be put
283 into the logfile only. The "-T maxtime" option tells NFSWATCH to
284 terminate execution after maxtime seconds.
285
286 - A new interactive command has been added. The "n" command toggles
287 the display of client names or client host numbers in client mode,
288 so that foreign hosts can be identified.
289
290 - The maximum number of client hosts for a single server has been
291 increased to 512. The maximum number of internet addresses for a
292 single host has been increased to 16. The maximum number of
293 interfaces that can be watched at one time has been increased to
294 16.
295
296 - The bug in which file matching did not work on Sun-3 systems has
297 been fixed.
298
299 - The bug in which the standard input got closed upon exit, making
300 the curses routines screw up, has been fixed.
301
302 - The bug causing miscompilation of nit.c on SunOS 4.0 has been
303 fixed.
304
305 - Note that due to limitations in the SVR4 DLPI, the ethernet broad-
306 cast, arp, and rarp packet counters will not be supported. Also
307 note that on SVR4s still using DLPI 1.3, which does not support
308 promiscuous mode, the "-all" and "-dst" options to NFSWATCH will
309 not work.
310
311 NFSWATCH has been successfully compiled and at least minimally tested on the
312 following architectures and operating systems:
313
314 Architecture Operating System
315 ------------ ----------------
316 Sun-3 (68000) SunOS 4.1.1
317 Sun-4 (SPARC) SunOS 4.1.1, 4.1.2, 4.1.3
318 Sun-4 (SPARC) SunOS 5.1, 5.2, 5.3
319
320 DEC VAX Ultrix 4.0, 4.1, 4.2
321 DEC RISC Ultrix 4.0, 4.1, 4.2
322 DEC Alpha AXP DEC OSF/1 V1.3 and later
323
324 SGI Personal IRIS IRIX 4.0.1
325 SGI 4D/440 IRIX 4.0.5
326
327 To compile NFSWATCH, just say "make." The Makefile will use the "uname"
328 command to determine what operating system should be compiled for. If for
329 some reason this blows up in your face, say "make OS=foo" where "foo" is one
330 of the following:
331
332 Macro Value Operating System
333 ----------- ----------------
334 IRIX40 Silicon Graphics IRIX 4.0
335 SUNOS4 Sun Microsystems SunOS 4.x
336 SUNOS5 Sun Microsystems SunOS 5.x (Solaris 2.x)
337 SVR4 AT&T System V Release 4
338 ULTRIX Digital Equipment Ultrix 4.x
339 DECOSF Digital Equipment Corp. OSF/1 V1.3 & later
340
341 On Sun systems, NFSWATCH needs to either be run as root, or made setuid root
342 (this is safe; it setuids itself back after opening the needed device). On
343 Ultrix systems, it does not need to be setuid root or run as root, but the
344 super-user has to enable promiscuous mode operation using pfconfig(8). On
345 SGI systems, it needs to be either run as root or made setuid to root. On
346 SVR4 systems, it needs to be either run as root or made setuid to root.
347
348 On pre-4.2 Ultrix systems, the enclosed "pfcopyall" program can be used to
349 change the value of the "pfcopyall" variable in the kernel so that you can
350 see packets sent by the host you are running on. Otherwise, these packets
351 will not be included in the output of NFSWATCH.
352
353 You can redistribute this program as much as you want. All we ask is that
354 you give credit where credit is due. If you make modifications or bug fixes,
355 please send them back to us, in "diff -c" format, so they can be incorporated
356 into the next release.
357
358
359 Original authors (email addresses out of date AFAIK):
360
361 Dave Curry Jeff Mogul
362 IBM Internet Security Services Digital Equipment Corp.
363 Integrated Systems Solutions Corporation Western Research Laboratory
364 Long Meadow Road, Mail Stop 223 250 University Avenue
365 Sterling Forest, NY 10979 Palo Alto, CA 94301
366 [email protected] [email protected]
367
368
369 Current Maintainer:
370
371 Christian Iseli
372 Ecole Polytechnique Fédérale de Lausanne (EPFL)
373 Bâtiment AAB, Station 19
374 CH-1015 Lausanne, Switzerland
375 [email protected]