| 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] |