linux-stable/Documentation/networking
Linus Torvalds 496322bc91 Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next
Pull networking updates from David Miller:
 "This is a re-do of the net-next pull request for the current merge
  window.  The only difference from the one I made the other day is that
  this has Eliezer's interface renames and the timeout handling changes
  made based upon your feedback, as well as a few bug fixes that have
  trickeled in.

  Highlights:

   1) Low latency device polling, eliminating the cost of interrupt
      handling and context switches.  Allows direct polling of a network
      device from socket operations, such as recvmsg() and poll().

      Currently ixgbe, mlx4, and bnx2x support this feature.

      Full high level description, performance numbers, and design in
      commit 0a4db187a9 ("Merge branch 'll_poll'")

      From Eliezer Tamir.

   2) With the routing cache removed, ip_check_mc_rcu() gets exercised
      more than ever before in the case where we have lots of multicast
      addresses.  Use a hash table instead of a simple linked list, from
      Eric Dumazet.

   3) Add driver for Atheros CQA98xx 802.11ac wireless devices, from
      Bartosz Markowski, Janusz Dziedzic, Kalle Valo, Marek Kwaczynski,
      Marek Puzyniak, Michal Kazior, and Sujith Manoharan.

   4) Support reporting the TUN device persist flag to userspace, from
      Pavel Emelyanov.

   5) Allow controlling network device VF link state using netlink, from
      Rony Efraim.

   6) Support GRE tunneling in openvswitch, from Pravin B Shelar.

   7) Adjust SOCK_MIN_RCVBUF and SOCK_MIN_SNDBUF for modern times, from
      Daniel Borkmann and Eric Dumazet.

   8) Allow controlling of TCP quickack behavior on a per-route basis,
      from Cong Wang.

   9) Several bug fixes and improvements to vxlan from Stephen
      Hemminger, Pravin B Shelar, and Mike Rapoport.  In particular,
      support receiving on multiple UDP ports.

  10) Major cleanups, particular in the area of debugging and cookie
      lifetime handline, to the SCTP protocol code.  From Daniel
      Borkmann.

  11) Allow packets to cross network namespaces when traversing tunnel
      devices.  From Nicolas Dichtel.

  12) Allow monitoring netlink traffic via AF_PACKET sockets, in a
      manner akin to how we monitor real network traffic via ptype_all.
      From Daniel Borkmann.

  13) Several bug fixes and improvements for the new alx device driver,
      from Johannes Berg.

  14) Fix scalability issues in the netem packet scheduler's time queue,
      by using an rbtree.  From Eric Dumazet.

  15) Several bug fixes in TCP loss recovery handling, from Yuchung
      Cheng.

  16) Add support for GSO segmentation of MPLS packets, from Simon
      Horman.

  17) Make network notifiers have a real data type for the opaque
      pointer that's passed into them.  Use this to properly handle
      network device flag changes in arp_netdev_event().  From Jiri
      Pirko and Timo Teräs.

  18) Convert several drivers over to module_pci_driver(), from Peter
      Huewe.

  19) tcp_fixup_rcvbuf() can loop 500 times over loopback, just use a
      O(1) calculation instead.  From Eric Dumazet.

  20) Support setting of explicit tunnel peer addresses in ipv6, just
      like ipv4.  From Nicolas Dichtel.

  21) Protect x86 BPF JIT against spraying attacks, from Eric Dumazet.

  22) Prevent a single high rate flow from overruning an individual cpu
      during RX packet processing via selective flow shedding.  From
      Willem de Bruijn.

  23) Don't use spinlocks in TCP md5 signing fast paths, from Eric
      Dumazet.

  24) Don't just drop GSO packets which are above the TBF scheduler's
      burst limit, chop them up so they are in-bounds instead.  Also
      from Eric Dumazet.

  25) VLAN offloads are missed when configured on top of a bridge, fix
      from Vlad Yasevich.

  26) Support IPV6 in ping sockets.  From Lorenzo Colitti.

  27) Receive flow steering targets should be updated at poll() time
      too, from David Majnemer.

  28) Fix several corner case regressions in PMTU/redirect handling due
      to the routing cache removal, from Timo Teräs.

  29) We have to be mindful of ipv4 mapped ipv6 sockets in
      upd_v6_push_pending_frames().  From Hannes Frederic Sowa.

  30) Fix L2TP sequence number handling bugs, from James Chapman."

* git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next: (1214 commits)
  drivers/net: caif: fix wrong rtnl_is_locked() usage
  drivers/net: enic: release rtnl_lock on error-path
  vhost-net: fix use-after-free in vhost_net_flush
  net: mv643xx_eth: do not use port number as platform device id
  net: sctp: confirm route during forward progress
  virtio_net: fix race in RX VQ processing
  virtio: support unlocked queue poll
  net/cadence/macb: fix bug/typo in extracting gem_irq_read_clear bit
  Documentation: Fix references to defunct linux-net@vger.kernel.org
  net/fs: change busy poll time accounting
  net: rename low latency sockets functions to busy poll
  bridge: fix some kernel warning in multicast timer
  sfc: Fix memory leak when discarding scattered packets
  sit: fix tunnel update via netlink
  dt:net:stmmac: Add dt specific phy reset callback support.
  dt:net:stmmac: Add support to dwmac version 3.610 and 3.710
  dt:net:stmmac: Allocate platform data only if its NULL.
  net:stmmac: fix memleak in the open method
  ipv6: rt6_check_neigh should successfully verify neigh if no NUD information are available
  net: ipv6: fix wrong ping_v6_sendmsg return value
  ...
2013-07-09 18:24:39 -07:00
..
caif Documentation/networking/caif: Update documentation 2012-06-25 16:44:12 -07:00
mac80211_hwsim
timestamping Merge branch 'master' of /home/davem/src/GIT/linux-2.6/ 2010-03-15 16:23:54 -07:00
.gitignore bonding: remove ifenslave.c from kernel source 2013-05-27 23:34:46 -07:00
00-INDEX bonding: remove ifenslave.c from kernel source 2013-05-27 23:34:46 -07:00
3c505.txt
3c509.txt drivers/net: delete all code/drivers depending on CONFIG_MCA 2012-05-17 16:37:41 -04:00
6pack.txt Update Andreas Koensgen's email address 2009-07-17 10:07:12 -07:00
alias.txt
arcnet-hardware.txt
arcnet.txt Documentation: Fix references to defunct linux-net@vger.kernel.org 2013-07-09 12:42:19 -07:00
atm.txt
ax25.txt
batman-adv.txt batman-adv: Distributed ARP Table - add a new debug log level 2012-11-07 20:00:18 +01:00
baycom.txt Documentation: remove references to /etc/modprobe.conf 2012-03-30 16:03:15 -07:00
bonding.txt bonding: add an option to fail when any of arp_ip_target is inaccessible 2013-06-25 16:58:38 -07:00
bridge.txt bridge: update documentation references 2012-07-19 10:48:07 -07:00
can.txt canfd: update documentation according to CAN FD extensions 2012-06-19 21:40:26 +02:00
cops.txt
cs89x0.txt networking/cs89x0.txt: delete stale information about hand patching 2013-01-11 16:52:26 -08:00
cxacru-cf.py USB: cxacru: remove cxacru-cf.bin loader 2010-03-02 14:53:01 -08:00
cxacru.txt USB: cxacru: remove cxacru-cf.bin loader 2010-03-02 14:53:01 -08:00
cxgb.txt
dccp.txt Merge branch 'for-next' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial 2011-01-13 10:05:56 -08:00
de4x5.txt
decnet.txt Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
dl2k.txt Documentation: remove references to /etc/modprobe.conf 2012-03-30 16:03:15 -07:00
dm9000.txt trivial: Miscellaneous documentation typo fixes 2009-06-12 18:01:47 +02:00
dmfe.txt Documentation: networking: dmfe.txt: Remove the maintainer of orphan networking driver 2011-09-15 14:49:43 -04:00
dns_resolver.txt KEYS: Allow special keyrings to be cleared 2012-01-19 14:38:51 +11:00
driver.txt doc, net: Update ndo_start_xmit return type and values 2012-04-06 02:43:13 -04:00
e100.txt Documentation: remove references to /etc/modprobe.conf 2012-03-30 16:03:15 -07:00
e1000.txt Documentation/networking: Update Intel Wired LAN docs 2010-12-24 21:26:47 -08:00
e1000e.txt Documentation/networking: Update Intel Wired LAN docs 2010-12-24 21:26:47 -08:00
eql.txt
fib_trie.txt
filter.txt sk-filter: Add ability to lock a socket filter program 2013-01-17 03:21:25 -05:00
fore200e.txt drivers/net: delete all code/drivers depending on CONFIG_MCA 2012-05-17 16:37:41 -04:00
framerelay.txt
gen_stats.txt
generic-hdlc.txt
generic_netlink.txt Docs/Kconfig: Update: osdl.org -> linuxfoundation.org 2010-11-15 23:50:13 +01:00
gianfar.txt
ieee802154.txt Documentation/networking/ieee802154 fix a typo 2013-06-05 16:24:59 +02:00
igb.txt igb: Add anti-spoofing feature documentation 2011-04-13 19:15:50 -07:00
igbvf.txt Documentation/networking: Update Intel Wired LAN docs 2010-12-24 21:26:47 -08:00
ip-sysctl.txt Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/jikos/trivial 2013-07-04 11:40:58 -07:00
ip_dynaddr.txt
ipddp.txt Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
iphase.txt Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
ipv6.txt Documentation: remove references to /etc/modprobe.conf 2012-03-30 16:03:15 -07:00
ipvs-sysctl.txt ipvs: add sync_persist_mode flag 2013-06-26 18:01:46 +09:00
irda.txt
ixgb.txt Documentation: remove references to /etc/modprobe.conf 2012-03-30 16:03:15 -07:00
ixgbe.txt Documentation/networking: Update Intel Wired LAN docs 2010-12-24 21:26:47 -08:00
ixgbevf.txt Documentation/networking/ixgbevf.txt: Update documentation 2010-12-10 22:12:23 -08:00
l2tp.txt ppp: Replace uses of <linux/if_ppp.h> with <linux/ppp-ioctl.h> 2012-03-04 20:41:38 -05:00
lapb-module.txt
LICENSE.qla3xxx
LICENSE.qlcnic qlcnic: Updating copyright information. 2013-02-04 21:08:48 -05:00
LICENSE.qlge qlge: Updating Schultz LICENSE.qlge file. 2012-02-04 15:59:30 -05:00
ltpc.txt Documentation: remove references to /etc/modprobe.conf 2012-03-30 16:03:15 -07:00
mac80211-auth-assoc-deauth.txt mac80211: set HT channel before association 2012-04-10 14:54:07 -04:00
mac80211-injection.txt mac80211: Update injection documentation 2011-10-11 16:41:16 -04:00
Makefile bonding: remove ifenslave.c from kernel source 2013-05-27 23:34:46 -07:00
multiqueue.txt
netconsole.txt netconsole: add IPv6 example in doc 2013-01-08 17:56:10 -08:00
netdev-features.txt doc/net: Fix typo in netdev-features.txt 2012-11-13 14:37:48 -05:00
netdevices.txt doc, net: Update netdev operation names 2012-04-06 02:43:12 -04:00
netif-msg.txt
netlink_mmap.txt Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next 2013-07-09 18:24:39 -07:00
nf_conntrack-sysctl.txt netfilter: doc: add nf_conntrack sysctl api documentation 2013-01-21 12:50:06 +01:00
nfc.txt NFC: add Documentation/networking/nfc.txt 2011-07-05 15:26:58 -04:00
openvswitch.txt openvswitch: Fix typo in documentation. 2012-07-20 14:51:07 -07:00
operstates.txt rtnl: expose carrier value with possibility to set it 2012-12-28 15:24:18 -08:00
packet_mmap.txt doc: packet: simplify tpacket example code 2013-06-07 14:39:05 -07:00
phonet.txt Phonet: kill the ST-Ericsson pipe controller Kconfig 2011-03-09 11:59:33 -08:00
phy.txt net: phy: remove flags argument from phy_{attach, connect, connect_direct} 2013-01-14 15:11:50 -05:00
pktgen.txt pktgen: increasing transmission granularity 2010-06-11 18:37:09 -07:00
PLIP.txt
policy-routing.txt
ppp_generic.txt ppp: Move ioctl definitions from if_ppp.h to new ppp-ioctl.h 2012-03-04 20:41:38 -05:00
proc_net_tcp.txt
radiotap-headers.txt
ray_cs.txt Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
rds.txt
README.ipw2100 Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
README.ipw2200 Fix common misspellings 2011-03-31 11:26:23 -03:00
README.sb1000 Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
regulatory.txt wireless: support internal statically compiled regulatory database 2009-12-21 18:56:10 -05:00
rxrpc.txt
s2io.txt vxge/s2io: remove dead URLs 2012-07-10 23:24:47 -07:00
scaling.txt rps: document flow limit in scaling.txt 2013-05-23 18:54:44 -07:00
sctp.txt
secid.txt
skfp.txt tree-wide: Assorted spelling fixes 2010-02-09 11:13:56 +01:00
smc9.txt
spider_net.txt
stmmac.txt stmmac: review driver documentation 2013-04-08 16:55:27 -04:00
tc-actions-env-rules.txt Fix common misspellings 2011-03-31 11:26:23 -03:00
tcp-thin.txt net: TCP thin-stream detection 2010-02-18 15:43:07 -08:00
tcp.txt
team.txt net: introduce ethernet teaming device 2011-11-13 16:10:10 -05:00
timestamping.txt net: simplify flags for tx timestamping 2010-08-19 00:08:30 -07:00
tlan.txt Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
tproxy.txt
tuntap.txt net: docs: document multiqueue tuntap API 2013-03-06 14:56:10 -05:00
udplite.txt Documentation: update broken web addresses. 2010-08-04 15:21:40 +02:00
vortex.txt Documentation: Fix references to defunct linux-net@vger.kernel.org 2013-07-09 12:42:19 -07:00
vxge.txt vxge/s2io: remove dead URLs 2012-07-10 23:24:47 -07:00
vxlan.txt vxlan: fix command usage in its doc 2012-11-23 14:03:04 -05:00
x25-iface.txt X25: Update X25 interface documentation 2010-04-22 16:12:52 -07:00
x25.txt
xfrm_proc.txt
xfrm_sync.txt
xfrm_sysctl.txt
z8530drv.txt

sb1000 is a module network device driver for the General Instrument (also known
as NextLevel) SURFboard1000 internal cable modem board.  This is an ISA card
which is used by a number of cable TV companies to provide cable modem access.
It's a one-way downstream-only cable modem, meaning that your upstream net link
is provided by your regular phone modem.

This driver was written by Franco Venturi <fventuri@mediaone.net>.  He deserves
a great deal of thanks for this wonderful piece of code!

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

Support for this device is now a part of the standard Linux kernel.  The
driver source code file is drivers/net/sb1000.c.  In addition to this
you will need:

1.) The "cmconfig" program.  This is a utility which supplements "ifconfig"
to configure the cable modem and network interface (usually called "cm0");
and

2.) Several PPP scripts which live in /etc/ppp to make connecting via your
cable modem easy.

   These utilities can be obtained from:

      http://www.jacksonville.net/~fventuri/

   in Franco's original source code distribution .tar.gz file.  Support for
   the sb1000 driver can be found at:

      http://web.archive.org/web/*/http://home.adelphia.net/~siglercm/sb1000.html
      http://web.archive.org/web/*/http://linuxpower.cx/~cable/

   along with these utilities.

3.) The standard isapnp tools.  These are necessary to configure your SB1000
card at boot time (or afterwards by hand) since it's a PnP card.

   If you don't have these installed as a standard part of your Linux
   distribution, you can find them at:

      http://www.roestock.demon.co.uk/isapnptools/

   or check your Linux distribution binary CD or their web site.  For help with
   isapnp, pnpdump, or /etc/isapnp.conf, go to:

      http://www.roestock.demon.co.uk/isapnptools/isapnpfaq.html

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

To make the SB1000 card work, follow these steps:

1.) Run `make config', or `make menuconfig', or `make xconfig', whichever
you prefer, in the top kernel tree directory to set up your kernel
configuration.  Make sure to say "Y" to "Prompt for development drivers"
and to say "M" to the sb1000 driver.  Also say "Y" or "M" to all the standard
networking questions to get TCP/IP and PPP networking support.

2.) *BEFORE* you build the kernel, edit drivers/net/sb1000.c.  Make sure
to redefine the value of READ_DATA_PORT to match the I/O address used
by isapnp to access your PnP cards.  This is the value of READPORT in
/etc/isapnp.conf or given by the output of pnpdump.

3.) Build and install the kernel and modules as usual.

4.) Boot your new kernel following the usual procedures.

5.) Set up to configure the new SB1000 PnP card by capturing the output
of "pnpdump" to a file and editing this file to set the correct I/O ports,
IRQ, and DMA settings for all your PnP cards.  Make sure none of the settings
conflict with one another.  Then test this configuration by running the
"isapnp" command with your new config file as the input.  Check for
errors and fix as necessary.  (As an aside, I use I/O ports 0x110 and
0x310 and IRQ 11 for my SB1000 card and these work well for me.  YMMV.)
Then save the finished config file as /etc/isapnp.conf for proper configuration
on subsequent reboots.

6.) Download the original file sb1000-1.1.2.tar.gz from Franco's site or one of
the others referenced above.  As root, unpack it into a temporary directory and
do a `make cmconfig' and then `install -c cmconfig /usr/local/sbin'.  Don't do
`make install' because it expects to find all the utilities built and ready for
installation, not just cmconfig.

7.) As root, copy all the files under the ppp/ subdirectory in Franco's
tar file into /etc/ppp, being careful not to overwrite any files that are
already in there.  Then modify ppp@gi-on to set the correct login name,
phone number, and frequency for the cable modem.  Also edit pap-secrets
to specify your login name and password and any site-specific information
you need.

8.) Be sure to modify /etc/ppp/firewall to use ipchains instead of
the older ipfwadm commands from the 2.0.x kernels.  There's a neat utility to
convert ipfwadm commands to ipchains commands:

   http://users.dhp.com/~whisper/ipfwadm2ipchains/

You may also wish to modify the firewall script to implement a different
firewalling scheme.

9.) Start the PPP connection via the script /etc/ppp/ppp@gi-on.  You must be
root to do this.  It's better to use a utility like sudo to execute
frequently used commands like this with root permissions if possible.  If you
connect successfully the cable modem interface will come up and you'll see a
driver message like this at the console:

         cm0: sb1000 at (0x110,0x310), csn 1, S/N 0x2a0d16d8, IRQ 11.
         sb1000.c:v1.1.2 6/01/98 (fventuri@mediaone.net)

The "ifconfig" command should show two new interfaces, ppp0 and cm0.
The command "cmconfig cm0" will give you information about the cable modem
interface.

10.) Try pinging a site via `ping -c 5 www.yahoo.com', for example.  You should
see packets received.

11.) If you can't get site names (like www.yahoo.com) to resolve into
IP addresses (like 204.71.200.67), be sure your /etc/resolv.conf file
has no syntax errors and has the right nameserver IP addresses in it.
If this doesn't help, try something like `ping -c 5 204.71.200.67' to
see if the networking is running but the DNS resolution is where the
problem lies.

12.) If you still have problems, go to the support web sites mentioned above
and read the information and documentation there.

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

Common problems:

1.) Packets go out on the ppp0 interface but don't come back on the cm0
interface.  It looks like I'm connected but I can't even ping any
numerical IP addresses.  (This happens predominantly on Debian systems due
to a default boot-time configuration script.)

Solution -- As root `echo 0 > /proc/sys/net/ipv4/conf/cm0/rp_filter' so it
can share the same IP address as the ppp0 interface.  Note that this
command should probably be added to the /etc/ppp/cablemodem script
*right*between* the "/sbin/ifconfig" and "/sbin/cmconfig" commands.
You may need to do this to /proc/sys/net/ipv4/conf/ppp0/rp_filter as well.
If you do this to /proc/sys/net/ipv4/conf/default/rp_filter on each reboot
(in rc.local or some such) then any interfaces can share the same IP
addresses.

2.) I get "unresolved symbol" error messages on executing `insmod sb1000.o'.

Solution -- You probably have a non-matching kernel source tree and
/usr/include/linux and /usr/include/asm header files.  Make sure you
install the correct versions of the header files in these two directories.
Then rebuild and reinstall the kernel.

3.) When isapnp runs it reports an error, and my SB1000 card isn't working.

Solution -- There's a problem with later versions of isapnp using the "(CHECK)"
option in the lines that allocate the two I/O addresses for the SB1000 card.
This first popped up on RH 6.0.  Delete "(CHECK)" for the SB1000 I/O addresses.
Make sure they don't conflict with any other pieces of hardware first!  Then
rerun isapnp and go from there.

4.) I can't execute the /etc/ppp/ppp@gi-on file.

Solution -- As root do `chmod ug+x /etc/ppp/ppp@gi-on'.

5.) The firewall script isn't working (with 2.2.x and higher kernels).

Solution -- Use the ipfwadm2ipchains script referenced above to convert the
/etc/ppp/firewall script from the deprecated ipfwadm commands to ipchains.

6.) I'm getting *tons* of firewall deny messages in the /var/kern.log,
/var/messages, and/or /var/syslog files, and they're filling up my /var
partition!!!

Solution -- First, tell your ISP that you're receiving DoS (Denial of Service)
and/or portscanning (UDP connection attempts) attacks!  Look over the deny
messages to figure out what the attack is and where it's coming from.  Next,
edit /etc/ppp/cablemodem and make sure the ",nobroadcast" option is turned on
to the "cmconfig" command (uncomment that line).  If you're not receiving these
denied packets on your broadcast interface (IP address xxx.yyy.zzz.255
typically), then someone is attacking your machine in particular.  Be careful
out there....

7.) Everything seems to work fine but my computer locks up after a while
(and typically during a lengthy download through the cable modem)!

Solution -- You may need to add a short delay in the driver to 'slow down' the
SURFboard because your PC might not be able to keep up with the transfer rate
of the SB1000. To do this, it's probably best to download Franco's
sb1000-1.1.2.tar.gz archive and build and install sb1000.o manually.  You'll
want to edit the 'Makefile' and look for the 'SB1000_DELAY'
define.  Uncomment those 'CFLAGS' lines (and comment out the default ones)
and try setting the delay to something like 60 microseconds with:
'-DSB1000_DELAY=60'.  Then do `make' and as root `make install' and try
it out.  If it still doesn't work or you like playing with the driver, you may
try other numbers.  Remember though that the higher the delay, the slower the
driver (which slows down the rest of the PC too when it is actively
used). Thanks to Ed Daiga for this tip!

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

Credits:  This README came from Franco Venturi's original README file which is
still supplied with his driver .tar.gz archive.  I and all other sb1000 users
owe Franco a tremendous "Thank you!"  Additional thanks goes to Carl Patten
and Ralph Bonnell who are now managing the Linux SB1000 web site, and to
the SB1000 users who reported and helped debug the common problems listed
above.


					Clemmitt Sigler
					csigler@vt.edu