COMPONENT

    net

SUMMARY

    Linux network component

DESCRIPTION

    This network component enables PAPI-C to access the network

    statistics exported by the Linux kernel through the /proc

    pseudo-file system (file /proc/net/dev).

    This component will dynamically create a native events table

    based on the number of interfaces listed in /proc/net/dev (16

    entries for each network interface).

    Event names

    -------------------------

      "<ifname>.rx.bytes",

      "<ifname>.rx.packets",

      "<ifname>.rx.errors",

      "<ifname>.rx.dropped",

      "<ifname>.rx.fifo",

      "<ifname>.rx.frame",

      "<ifname>.rx.compressed",

      "<ifname>.rx.multicast",

      "<ifname>.tx.bytes",

      "<ifname>.tx.packets",

      "<ifname>.tx.errors",

      "<ifname>.tx.dropped",

      "<ifname>.tx.fifo",

      "<ifname>.tx.colls",

      "<ifname>.tx.carrier",

      "<ifname>.tx.compressed"

    By default the Linux kernel only updates the network statistics

    once every second (see the references listed in the "SEE ALSO"

    section for some problems you may come across and for how to

    change the default polling period).

    Note: The Linux network statistics are updated by code that

    resides in the file net/core/dev.c.

AUTHOR

  Initial written by Haihang You <you@cs.utk.edu>.

  Re-written by Jose Pedro Oliveira <jpo@di.uminho.pt> in order

  to source data directly from /proc/net/dev.

SEE ALSO

 * Network Stats Anomaly

   http://collectl.sourceforge.net/NetworkStats.html

 * Occasionally corrupted network stats in /proc/net/dev

   http://kerneltrap.org/mailarchive/linux-netdev/2008/1/14/566936

   http://kerneltrap.org/mailarchive/linux-netdev/2008/1/14/567512

# 2011-11-05 jpo

# vim:set ai ts=4 sw=4 sts=4 et: