[PATCH - RFC] [5/5] 64-bit network statistics - documentation

[Jeff Sipek]

--Boundary_(ID_FYny75bNLkjZXnh/XElm0A)
Content-type: Text/Plain; charset=us-ascii
Content-transfer-encoding: 7BIT
Content-disposition: inline
Content-description: clearsigned data

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

64-bit network statistics:
	Part 5 of 5 - documentation

- -- 
Only two things are infinite, the universe and human stupidity, and I'm 
not sure about the former.
		- Albert Einstein

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.2.2 (GNU/Linux)

iD8DBQE/BOdIwFP0+seVj/4RAq5jAKC5Aa8nif2ipuxbq5tnthmi9XtYuACfYQbb
gqrGGiaOR6u92+zDISWJxeY=
=shpM
-----END PGP SIGNATURE-----

--Boundary_(ID_FYny75bNLkjZXnh/XElm0A)
Content-type: text/x-diff; charset=us-ascii; name=doc.diff
Content-transfer-encoding: 7BIT
Content-disposition: attachment; filename=doc.diff

diff -X dontdiff -Naur linux-2.5.74-vanilla/Documentation/networking/00-INDEX linux-2.5.74-nx/Documentation/networking/00-INDEX
--- linux-2.5.74-vanilla/Documentation/networking/00-INDEX	2003-07-02 16:53:01.000000000 -0400
+++ linux-2.5.74-nx/Documentation/networking/00-INDEX	2003-07-03 15:10:59.000000000 -0400
@@ -2,6 +2,8 @@
 	- this file
 3c505.txt
 	- information on the 3Com EtherLink Plus (3c505) driver.
+64bitstats.txt
+	- information about 64bit network statistics
 6pack.txt
 	- info on the 6pack protocol, an alternative to KISS for AX.25
 8139too.txt
diff -X dontdiff -Naur linux-2.5.74-vanilla/Documentation/networking/64bitstats.txt linux-2.5.74-nx/Documentation/networking/64bitstats.txt
--- linux-2.5.74-vanilla/Documentation/networking/64bitstats.txt	1969-12-31 19:00:00.000000000 -0500
+++ linux-2.5.74-nx/Documentation/networking/64bitstats.txt	2003-07-03 15:10:59.000000000 -0400
@@ -0,0 +1,77 @@
+The New API:
+------------
+
+net_stats_inc(<variable name>, <pointer to statistics struct>)
+	<pointer to statistics struct> -> <variable name> ++;
+
+net_stats_add(<variable name>, <up to u_int64_t>, <pointer to statistics struct>)
+	<pointer to statistics struct> -> <variable name> += <up to u_int64_t>;
+
+net_stats_set(<variable name>, <up to u_int64_t>, <pointer to statistics struct>)
+	<pointer to statistics struct> -> <variable name> = <up to u_int64_t>;
+
+net_stats_get(<variable name>, <pointer to statistics struct>)
+	return <pointer to statistics struct> -> <variable name>;
+
+
+Supported Drivers:
+------------------
+
+  - 8139too
+  - 8390
+  - dummy
+  - eepro100
+  - loopback
+  - ne2k-pci
+  - pcnet32
+
+
+How To Test:
+------------
+
+You want to flood the interface with as many packets/bytes/etc. as possible,
+so, you can either attach it to a very busy network (with a lot of broadcast
+traffic) or you can simulate this traffic using netcat in this fashion:
+
+host1$ netcat -l -p port > /dev/null < /dev/zero
+host2$ netcat host1 port > /dev/null < /dev/zero
+
+*WARNING* Running these commands will saturate the network, use them only if
+you know what you are doing. I cannot be held responsible for damages caused
+by the usage of these commands.
+
+
+Supported Architectures:
+-----------------------
+
+arch		reg. size	addr. space	support
+
+asm-alpha
+asm-arm		32 bit		32 bit		X
+asm-arm26	32 bit		26 bit		X
+asm-cris
+asm-h8300
+asm-i386	32 bit		32 bit		X
+asm-ia64	64 bit		64 bit		N
+asm-m68k
+asm-m68knommu
+asm-mips
+asm-mips64
+asm-parisc	64 bit				*1
+asm-ppc
+asm-ppc64
+asm-s390
+asm-sh
+asm-sparc					X
+asm-sparc64	64 bit		64 bit		N
+asm-um
+asm-v850
+asm-x86_64	64 bit		64 bit		N
+
+legend:
+--------
+	X  = full net_stats_* support
+	N  = native support
+	*1 - #error in 32-bit environment
+	-  = pseudo-support (using non-atomic instructions)
+	   = no support (doesn't compile)

--Boundary_(ID_FYny75bNLkjZXnh/XElm0A)--