linux-sg2042/Documentation/networking
Linus Torvalds f8965467f3 Merge git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next-2.6
* git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next-2.6: (1674 commits)
  qlcnic: adding co maintainer
  ixgbe: add support for active DA cables
  ixgbe: dcb, do not tag tc_prio_control frames
  ixgbe: fix ixgbe_tx_is_paused logic
  ixgbe: always enable vlan strip/insert when DCB is enabled
  ixgbe: remove some redundant code in setting FCoE FIP filter
  ixgbe: fix wrong offset to fc_frame_header in ixgbe_fcoe_ddp
  ixgbe: fix header len when unsplit packet overflows to data buffer
  ipv6: Never schedule DAD timer on dead address
  ipv6: Use POSTDAD state
  ipv6: Use state_lock to protect ifa state
  ipv6: Replace inet6_ifaddr->dead with state
  cxgb4: notify upper drivers if the device is already up when they load
  cxgb4: keep interrupts available when the ports are brought down
  cxgb4: fix initial addition of MAC address
  cnic: Return SPQ credit to bnx2x after ring setup and shutdown.
  cnic: Convert cnic_local_flags to atomic ops.
  can: Fix SJA1000 command register writes on SMP systems
  bridge: fix build for CONFIG_SYSFS disabled
  ARCNET: Limit com20020 PCI ID matches for SOHARD cards
  ...

Fix up various conflicts with pcmcia tree drivers/net/
{pcmcia/3c589_cs.c, wireless/orinoco/orinoco_cs.c and
wireless/orinoco/spectrum_cs.c} and feature removal
(Documentation/feature-removal-schedule.txt).

Also fix a non-content conflict due to pm_qos_requirement getting
renamed in the PM tree (now pm_qos_request) in net/mac80211/scan.c
2010-05-20 21:04:44 -07:00
..
caif net-caif: add CAIF documentation 2010-03-30 19:08:50 -07:00
mac80211_hwsim mac80211_hwsim: Update documentation (AP mode enabled) 2008-11-21 11:08:16 -05:00
timestamping Merge branch 'master' of /home/davem/src/GIT/linux-2.6/ 2010-03-15 16:23:54 -07:00
.gitignore .gitignore updates 2008-10-30 11:38:45 -07:00
00-INDEX USB: cxacru: remove cxacru-cf.bin loader 2010-03-02 14:53:01 -08:00
3c359.txt
3c505.txt [NET]: Remove references to net-modules.txt. 2007-11-12 21:03:58 -08:00
3c509.txt Documentation/3c509: document ethtool support 2010-01-11 15:53:45 -08:00
6pack.txt Update Andreas Koensgen's email address 2009-07-17 10:07:12 -07:00
DLINK.txt
LICENSE.qla3xxx [PATCH] qla3xxx NIC driver 2006-07-29 00:28:51 -04:00
LICENSE.qlge qlge: New Qlogic 10Gb Ethernet Driver. 2008-09-18 11:56:28 -04:00
Makefile timestamping: fix example build 2010-03-15 16:00:46 -07:00
PLIP.txt
README.ipw2100 [PATCH] ipw2x00: expend Copyright to 2006 2006-03-17 16:14:47 -05:00
README.ipw2200 ipw2x00: change default policy for auto-associate 2008-10-31 19:00:24 -04:00
README.sb1000
alias.txt net: update documentation ip aliases 2009-01-29 16:16:31 -08:00
arcnet-hardware.txt Fix "can not" in Documentation and Kconfig 2006-10-03 22:53:09 +02:00
arcnet.txt Fix various old email addresses for dwmw2 2008-06-06 11:29:10 -07:00
atm.txt
ax25.txt [NET] AX.25 Kconfig and docs updates and fixes 2007-03-25 18:48:02 -07:00
baycom.txt
bonding.txt bonding: introduce primary_reselect option 2009-10-07 01:07:39 -07:00
bridge.txt bridge: update URL 2008-06-03 16:00:01 -07:00
can.txt Merge branch 'master' of master.kernel.org:/pub/scm/linux/kernel/git/torvalds/linux-2.6 2009-06-15 03:02:23 -07:00
cops.txt
cs89x0.txt Remove Andrew Morton's old email accounts 2008-10-16 11:21:32 -07: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 Fix typos in Documentation/: 'F'-'G' 2006-10-03 22:49:15 +02:00
dccp.txt dccp: allow probing of CCID-array length 2010-02-12 11:47:00 -08:00
de4x5.txt
decnet.txt Documentation: "decnet=" should read "decnet.addr=". 2008-02-03 15:18:45 +02:00
depca.txt
dl2k.txt Fix typos in Documentation/: 'B'-'C' 2006-10-03 22:46:31 +02:00
dm9000.txt trivial: Miscellaneous documentation typo fixes 2009-06-12 18:01:47 +02:00
dmfe.txt Rationalise Randy's address a bit 2008-10-30 11:38:47 -07:00
driver.txt netdevice: Kill netdev->priv 2008-12-08 01:14:16 -08:00
e100.txt e100: update e100.txt 2006-03-14 15:51:07 -08:00
e1000.txt e1000: delete non NAPI code from the driver 2008-07-22 19:39:11 -04:00
eql.txt
ewrk3.txt
fib_trie.txt Fix typos in Documentation/: 'F'-'G' 2006-10-03 22:49:15 +02:00
filter.txt
fore200e.txt
framerelay.txt
gen_stats.txt Fix typos in Documentation/: 'N'-'P' 2006-10-03 22:52:05 +02:00
generic-hdlc.txt WAN: new synchronous PPP implementation for generic HDLC. 2008-11-22 02:49:48 +01:00
generic_netlink.txt [NETLIK]: Add a pointer to the Generic Netlink wiki page. 2006-12-06 18:39:10 -08:00
gianfar.txt
ieee802154.txt ieee802154: document the skb->cb usage clearly. 2009-08-19 23:08:19 +04:00
ifenslave.c Documentation/: it's -> its where appropriate 2010-04-23 02:09:52 +02:00
ip-sysctl.txt net: reserve ports for applications using fixed port numbers 2010-05-15 23:28:40 -07:00
ip_dynaddr.txt
ipddp.txt
iphase.txt Fix typos in /Documentation : 'T'' 2006-11-30 04:55:36 +01:00
ipv6.txt IPv6: Add 'autoconf' and 'disable_ipv6' module parameters 2009-06-01 03:07:33 -07:00
ipvs-sysctl.txt [IPVS]: Add sysctl documentation 2006-07-03 19:35:40 -07:00
irda.txt
ixgb.txt ixgb: update readme text 2008-07-11 01:20:28 -04:00
ixgbe.txt ixgbe: Add documentation for the driver 2009-03-14 12:41:14 -07:00
ixgbevf.txt ixgbevf: Kconfig, Makefile and Documentation 2010-01-10 13:34:23 -08:00
l2tp.txt l2tp: Update documentation 2010-04-03 14:56:08 -07:00
lapb-module.txt
ltpc.txt
mac80211-injection.txt mac80211: update injection documentation 2009-04-22 16:54:41 -04:00
multicast.txt
multiqueue.txt multiq: Further multiqueue cleanup 2008-09-12 17:57:23 -07:00
netconsole.txt networking: document "nc" in addition to "netcat" in netconsole.txt 2009-01-26 12:19:23 -08:00
netdevices.txt trivial: Miscellaneous documentation typo fixes 2009-06-12 18:01:47 +02:00
netif-msg.txt Fix typos in Documentation/: 'Q'-'R' 2006-10-03 22:54:15 +02:00
olympic.txt
operstates.txt [PATCH] net core: Some interface flags not returned by SIOCGIFFLAGS 2009-06-11 20:57:21 -07:00
packet_mmap.txt Documentation/: it's -> its where appropriate 2010-04-23 02:09:52 +02:00
phonet.txt trivial: Miscellaneous documentation typo fixes 2009-06-12 18:01:47 +02:00
phy.txt phylib: fix phy name example in documentation 2008-11-19 15:38:24 -08:00
pktgen.txt pktgen: Fix multiqueue handling 2009-10-04 21:08:54 -07:00
policy-routing.txt
ppp_generic.txt
proc_net_tcp.txt [TCP]: Update the /proc/net/tcp documentation 2007-10-15 12:58:35 -07:00
radiotap-headers.txt [PATCH] cfg80211: Radiotap parser 2007-07-12 16:07:24 -04:00
ray_cs.txt [PATCH] Remove MODULE_PARM 2006-03-25 08:22:52 -08:00
rds.txt RDS: Documentation 2009-02-26 23:39:34 -08:00
regulatory.txt wireless: support internal statically compiled regulatory database 2009-12-21 18:56:10 -05:00
rxrpc.txt trivial: fix then -> than typos in comments and documentation 2009-01-06 11:28:06 +01:00
s2io.txt netdev: remove unused S2IO_NAPI 2008-07-07 22:40:26 -07:00
sctp.txt
secid.txt [MLSXFRM]: Add security sid to flowi 2006-09-22 14:53:23 -07:00
skfp.txt tree-wide: Assorted spelling fixes 2010-02-09 11:13:56 +01:00
smc9.txt
smctr.txt Fix typos in Documentation/: 'S' 2006-10-03 22:55:17 +02:00
spider_net.txt spidernet: driver docmentation 2007-07-08 22:16:42 -04:00
stmmac.txt stmmac: add documentation for the driver. 2010-04-01 17:26:00 -07:00
tc-actions-env-rules.txt Documentation cleanup: trivial misspelling, punctuation, and grammar corrections. 2008-07-26 12:00:06 -07:00
tcp-thin.txt net: TCP thin-stream detection 2010-02-18 15:43:07 -08:00
tcp.txt Documentation: fix tcp.txt 2008-02-17 22:21:04 -08:00
timestamping.txt net: corrected documentation for hardware time stamping 2010-04-07 21:52:07 -07:00
tlan.txt
tms380tr.txt documentation: convert the Documentation directory to UTF-8 2007-05-09 08:58:19 +02:00
tproxy.txt netfilter: Add documentation for tproxy 2008-10-08 11:35:12 +02:00
tuntap.txt trivial: fix an -> a typos in documentation and comments 2009-01-06 11:28:07 +01:00
udplite.txt udplite: Protection against coverage value wrap-around 2008-07-21 13:35:08 -07:00
vortex.txt Remove Andrew Morton's http://www.zip.com.au/~akpm/ 2008-10-16 11:21:32 -07:00
vxge.txt Neterion: Driver help file 2009-04-02 00:33:39 -07:00
wavelan.txt Fix file references in documentation and Kconfig 2008-01-22 10:43:36 -08:00
x25-iface.txt X25: Update X25 interface documentation 2010-04-22 16:12:52 -07:00
x25.txt
xfrm_proc.txt [XFRM]: Fix statistics. 2008-01-31 19:28:30 -08:00
xfrm_sync.txt [XFRM]: Fix aevent structuring to be more complete. 2006-12-02 22:22:25 -08:00
xfrm_sysctl.txt [IPSEC]: Add xfrm_sysctl.txt. 2007-05-31 01:34:55 -07:00
z8530drv.txt

README.sb1000

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://home.adelphia.net/~siglercm/sb1000.html
      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