Merge branches 'debug/dma-api', 'arm/omap', 'arm/msm' and 'core' into api-2

00-INDEX

	- this file

3c359.txt

	- information on the 3Com TokenLink Velocity XL (3c5359) driver.

3c505.txt

	- information on the 3Com EtherLink Plus (3c505) driver.

3c509.txt

	- information on the 3Com Etherlink III Series Ethernet cards.

6pack.txt

	- info on the 6pack protocol, an alternative to KISS for AX.25

DLINK.txt

	- info on the D-Link DE-600/DE-620 parallel port pocket adapters

PLIP.txt

	- PLIP: The Parallel Line Internet Protocol device driver

README.ipw2100

	- README for the Intel PRO/Wireless 2100 driver.

README.ipw2200

	- README for the Intel PRO/Wireless 2915ABG and 2200BG driver.

README.sb1000

	- info on General Instrument/NextLevel SURFboard1000 cable modem.

alias.txt

	- info on where to get ATM programs and support for Linux.

ax25.txt

	- info on using AX.25 and NET/ROM code for Linux

batman-adv.txt

	- B.A.T.M.A.N routing protocol on top of layer 2 Ethernet Frames.

baycom.txt

	- info on the driver for Baycom style amateur radio modems

bonding.txt

	- Linux Ethernet Bonding Driver HOWTO: link aggregation in Linux.

bridge.txt

	- where to get user space programs for ethernet bridging with Linux.

can.txt

	- Conexant AccessRunner USB ADSL Modem

cxacru-cf.py

	- Conexant AccessRunner USB ADSL Modem configuration file parser

cxgb.txt

	- Release Notes for the Chelsio N210 Linux device driver.

dccp.txt

	- the Datagram Congestion Control Protocol (DCCP) (RFC 4340..42).

de4x5.txt

	- the Digital EtherWORKS DE4?? and DE5?? PCI Ethernet driver

decnet.txt

	- info on using the DECnet networking layer in Linux.

depca.txt

	- the Digital DEPCA/EtherWORKS DE1?? and DE2?? LANCE Ethernet driver

dl2k.txt

	- README for D-Link DL2000-based Gigabit Ethernet Adapters (dl2k.ko).

dm9000.txt

	- README for the Simtec DM9000 Network driver.

dmfe.txt

	- info on the Davicom DM9102(A)/DM9132/DM9801 fast ethernet driver.

dns_resolver.txt

	- The DNS resolver module allows kernel servies to make DNS queries.

driver.txt

	- Softnet driver issues.

e100.txt

	- info on Intel's EtherExpress PRO/100 line of 10/100 boards

e1000.txt

	- info on Intel's E1000 line of gigabit ethernet boards

e1000e.txt

	- README for the Intel Gigabit Ethernet Driver (e1000e).

eql.txt

	- serial IP load balancing

ewrk3.txt

	- the Digital EtherWORKS 3 DE203/4/5 Ethernet driver

fib_trie.txt

	- Level Compressed Trie (LC-trie) notes: a structure for routing.

filter.txt

	- Linux Socket Filtering

fore200e.txt

	- FORE Systems PCA-200E/SBA-200E ATM NIC driver info.

framerelay.txt

	- info on using Frame Relay/Data Link Connection Identifier (DLCI).

gen_stats.txt

	- Generic networking statistics for netlink users.

generic_hdlc.txt

	- The generic High Level Data Link Control (HDLC) layer.

generic_netlink.txt

	- info on Generic Netlink

gianfar.txt

	- Gianfar Ethernet Driver.

ieee802154.txt

	- Linux IEEE 802.15.4 implementation, API and drivers

ifenslave.c

	- Configure network interfaces for parallel routing (bonding).

igb.txt

	- README for the Intel Gigabit Ethernet Driver (igb).

igbvf.txt

	- README for the Intel Gigabit Ethernet Driver (igbvf).

ip-sysctl.txt

	- /proc/sys/net/ipv4/* variables

ip_dynaddr.txt

	- AppleTalk-IP Decapsulation and AppleTalk-IP Encapsulation

iphase.txt

	- Interphase PCI ATM (i)Chip IA Linux driver info.

ipv6.txt

	- Options to the ipv6 kernel module.

ipvs-sysctl.txt

	- Per-inode explanation of the /proc/sys/net/ipv4/vs interface.

irda.txt

	- where to get IrDA (infrared) utilities and info for Linux.

ixgb.txt

	- README for the Intel 10 Gigabit Ethernet Driver (ixgb).

ixgbe.txt

	- README for the Intel 10 Gigabit Ethernet Driver (ixgbe).

ixgbevf.txt

	- README for the Intel Virtual Function (VF) Driver (ixgbevf).

l2tp.txt

	- User guide to the L2TP tunnel protocol.

lapb-module.txt

	- programming information of the LAPB module.

ltpc.txt

	- the Apple or Farallon LocalTalk PC card driver

mac80211-injection.txt

	- HOWTO use packet injection with mac80211

multicast.txt

	- Behaviour of cards under Multicast

multiqueue.txt

	- HOWTO for multiqueue network device support.

netconsole.txt

	- The network console module netconsole.ko: configuration and notes.

netdev-features.txt

	- Network interface features API description.

netdevices.txt

	- info on network device driver functions exported to the kernel.

netif-msg.txt

	- Design of the network interface message level setting (NETIF_MSG_*).

nfc.txt

	- The Linux Near Field Communication (NFS) subsystem.

olympic.txt

	- IBM PCI Pit/Pit-Phy/Olympic Token Ring driver info.

operstates.txt

	- Overview of network interface operational states.

packet_mmap.txt

	- User guide to memory mapped packet socket rings (PACKET_[RT]X_RING).

phonet.txt

	- The Phonet packet protocol used in Nokia cellular modems.

phy.txt

	- The PHY abstraction layer.

pktgen.txt

	- User guide to the kernel packet generator (pktgen.ko).

policy-routing.txt

	- IP policy-based routing

ppp_generic.txt

	- Information about the generic PPP driver.

proc_net_tcp.txt

	- Per inode overview of the /proc/net/tcp and /proc/net/tcp6 interfaces.

radiotap-headers.txt

	- Background on radiotap headers.

ray_cs.txt

	- Raylink Wireless LAN card driver info.

rds.txt

	- Background on the reliable, ordered datagram delivery method RDS.

regulatory.txt

	- Overview of the Linux wireless regulatory infrastructure.

rxrpc.txt

	- Guide to the RxRPC protocol.

s2io.txt

	- Release notes for Neterion Xframe I/II 10GbE driver.

scaling.txt

	- Explanation of network scaling techniques: RSS, RPS, RFS, aRFS, XPS.

sctp.txt

	- Notes on the Linux kernel implementation of the SCTP protocol.

secid.txt

	- Explanation of the secid member in flow structures.

skfp.txt

	- SysKonnect FDDI (SK-5xxx, Compaq Netelligent) driver info.

smc9.txt

	- the driver for SMC's 9000 series of Ethernet cards

smctr.txt

	- SMC TokenCard TokenRing Linux driver info.

spider-net.txt

	- README for the Spidernet Driver (as found in PS3 / Cell BE).

stmmac.txt

	- README for the STMicro Synopsys Ethernet driver.

tc-actions-env-rules.txt

	- rules for traffic control (tc) actions.

timestamping.txt

	- overview of network packet timestamping variants.

tcp.txt

	- short blurb on how TCP output takes place.

tcp-thin.txt

	- kernel tuning options for low rate 'thin' TCP streams.

tlan.txt

	- ThunderLAN (Compaq Netelligent 10/100, Olicom OC-2xxx) driver info.

tms380tr.txt

	- SysKonnect Token Ring ISA/PCI adapter driver info.

tproxy.txt

	- Transparent proxy support user guide.

tuntap.txt

	- TUN/TAP device driver, allowing user space Rx/Tx of packets.

udplite.txt

	- UDP-Lite protocol (RFC 3828) introduction.

vortex.txt

	- info on using 3Com Vortex (3c590, 3c592, 3c595, 3c597) Ethernet cards.

vxge.txt

	- README for the Neterion X3100 PCIe Server Adapter.

x25.txt

	- general info on X.25 development.

x25-iface.txt

	- description of the X.25 Packet Layer to LAPB device interface.

xfrm_proc.txt

	- description of the statistics package for XFRM.

xfrm_sync.txt

	- sync patches for XFRM enable migration of an SA between hosts.

xfrm_sysctl.txt

	- description of the XFRM configuration options.

z8530drv.txt

	- info about Linux driver for Z8530 based HDLC cards for AX.25

		TRUE: disable IPv4-mapped address feature

		FALSE: enable IPv4-mapped address feature

	Default: FALSE (as specified in RFC2553bis)

	Default: FALSE (as specified in RFC3493)

IPv6 Fragmentation:

configure. In the bnx2x driver, for instance, this parameter is called

num_queues. A typical RSS configuration would be to have one receive queue

for each CPU if the device supports enough queues, or otherwise at least

one for each cache domain at a particular cache level (L1, L2, etc.).

one for each memory domain, where a memory domain is a set of CPUs that

share a particular memory level (L1, L2, NUMA node, etc.).

The indirection table of an RSS device, which resolves a queue by masked

hash, is usually programmed by the driver at initialization. The

interrupt processing forms a bottleneck. Spreading load between CPUs

decreases queue length. For low latency networking, the optimal setting

is to allocate as many queues as there are CPUs in the system (or the

NIC maximum, if lower). Because the aggregate number of interrupts grows

with each additional queue, the most efficient high-rate configuration

NIC maximum, if lower). The most efficient high-rate configuration

is likely the one with the smallest number of receive queues where no

CPU that processes receive interrupts reaches 100% utilization. Per-cpu

load can be observed using the mpstat utility.

receive queue overflows due to a saturated CPU, because in default

mode with interrupt coalescing enabled, the aggregate number of

interrupts (and thus work) grows with each additional queue.

Per-cpu load can be observed using the mpstat utility, but note that on

processors with hyperthreading (HT), each hyperthread is represented as

a separate CPU. For interrupt handling, HT has shown no benefit in

initial tests, so limit the number of queues to the number of CPU cores

in the system.

RPS: Receive Packet Steering

== Suggested Configuration

For a single queue device, a typical RPS configuration would be to set

the rps_cpus to the CPUs in the same cache domain of the interrupting

the rps_cpus to the CPUs in the same memory domain of the interrupting

CPU. If NUMA locality is not an issue, this could also be all CPUs in

the system. At high interrupt rate, it might be wise to exclude the

interrupting CPU from the map since that already performs much work.

receive queue is mapped to each CPU, then RPS is probably redundant

and unnecessary. If there are fewer hardware queues than CPUs, then

RPS might be beneficial if the rps_cpus for each queue are the ones that

share the same cache domain as the interrupting CPU for that queue.

share the same memory domain as the interrupting CPU for that queue.

RFS: Receive Flow Steering

corresponding socket structure for the flow (e.g. a TCP connection).

This transmit queue is used for subsequent packets sent on the flow to

prevent out of order (ooo) packets. The choice also amortizes the cost

of calling get_xps_queues() over all packets in the connection. To avoid

of calling get_xps_queues() over all packets in the flow. To avoid

ooo packets, the queue for a flow can subsequently only be changed if

skb->ooo_okay is set for a packet in the flow. This flag indicates that

there are no outstanding packets in the flow, so the transmit queue can

  void pm_runtime_irq_safe(struct device *dev);

    - set the power.irq_safe flag for the device, causing the runtime-PM

      suspend and resume callbacks (but not the idle callback) to be invoked

      with interrupts disabled

      callbacks to be invoked with interrupts off

  void pm_runtime_mark_last_busy(struct device *dev);

    - set the power.last_busy field to the current time

F:	drivers/connector/

CONTROL GROUPS (CGROUPS)

M:	Paul Menage <menage@google.com>

M:	Paul Menage <paul@paulmenage.org>

M:	Li Zefan <lizf@cn.fujitsu.com>

L:	containers@lists.linux-foundation.org

S:	Maintained

F:	tools/power/cpupower

CPUSETS

M:	Paul Menage <menage@google.com>

M:	Paul Menage <paul@paulmenage.org>

W:	http://www.bullopensource.org/cpuset/

W:	http://oss.sgi.com/projects/cpusets/

S:	Supported

SAMSUNG AUDIO (ASoC) DRIVERS

M:	Jassi Brar <jassisinghbrar@gmail.com>

M:	Sangbeom Kim <sbkim73@samsung.com>

L:	alsa-devel@alsa-project.org (moderated for non-subscribers)

S:	Supported

F:	sound/soc/samsung

F:	drivers/mmc/host/vub300.c

W1 DALLAS'S 1-WIRE BUS

M:	Evgeniy Polyakov <johnpol@2ka.mipt.ru>

M:	Evgeniy Polyakov <zbr@ioremap.net>

S:	Maintained

F:	Documentation/w1/

F:	drivers/w1/