Merge branch 'v2.6.37-rc2' into for-2.6.38/core

What:		dv1394 (a.k.a. "OHCI-DV I/O support" for FireWire)

Contact:	linux1394-devel@lists.sourceforge.net

Description:

	New application development should use raw1394 + userspace libraries

	instead, notably libiec61883 which is functionally equivalent.

Users:

	ffmpeg/libavformat (used by a variety of media players)

	dvgrab v1.x (replaced by dvgrab2 on top of raw1394 and resp. libraries)

What:	/proc/<pid>/oom_adj

When:	August 2012

Why:	/proc/<pid>/oom_adj allows userspace to influence the oom killer's

	badness heuristic used to determine which task to kill when the kernel

	is out of memory.

	The badness heuristic has since been rewritten since the introduction of

	this tunable such that its meaning is deprecated.  The value was

	implemented as a bitshift on a score generated by the badness()

	function that did not have any precise units of measure.  With the

	rewrite, the score is given as a proportion of available memory to the

	task allocating pages, so using a bitshift which grows the score

	exponentially is, thus, impossible to tune with fine granularity.

	A much more powerful interface, /proc/<pid>/oom_score_adj, was

	introduced with the oom killer rewrite that allows users to increase or

	decrease the badness() score linearly.  This interface will replace

	/proc/<pid>/oom_adj.

	A warning will be emitted to the kernel log if an application uses this

	deprecated interface.  After it is printed once, future warnings will be

	suppressed until the kernel is rebooted.

What:		dv1394 (a.k.a. "OHCI-DV I/O support" for FireWire)

Date:		May 2010 (scheduled), finally removed in kernel v2.6.37

Contact:	linux1394-devel@lists.sourceforge.net

Description:

	/dev/dv1394/* were character device files, one for each FireWire

	controller and for NTSC and PAL respectively, from which DV data

	could be received by read() or transmitted by write().  A few

	ioctl()s allowed limited control.

	This special-purpose interface has been superseded by libraw1394 +

	libiec61883 which are functionally equivalent, support HDV, and

	transparently work on top of the newer firewire kernel drivers.

Users:

	ffmpeg/libavformat (if configured for DV1394)

What:		raw1394 (a.k.a. "Raw IEEE1394 I/O support" for FireWire)

Date:		May 2010 (scheduled), finally removed in kernel v2.6.37

Contact:	linux1394-devel@lists.sourceforge.net

Description:

	/dev/raw1394 was a character device file that allowed low-level

	access to FireWire buses.  Its major drawbacks were its inability

	to implement sensible device security policies, and its low level

	of abstraction that required userspace clients do duplicate much

	of the kernel's ieee1394 core functionality.

	Replaced by /dev/fw*, i.e. the <linux/firewire-cdev.h> ABI of

	firewire-core.

Users:

	libraw1394 (works with firewire-cdev too, transparent to library ABI

	users)

What:		legacy isochronous ABI of raw1394 (1st generation iso ABI)

Date:		June 2007 (scheduled), removed in kernel v2.6.23

Contact:	linux1394-devel@lists.sourceforge.net

Description:

	The two request types RAW1394_REQ_ISO_SEND, RAW1394_REQ_ISO_LISTEN have

	been deprecated for quite some time.  They are very inefficient as they

	come with high interrupt load and several layers of callbacks for each

	packet.  Because of these deficiencies, the video1394 and dv1394 drivers

	and the 3rd-generation isochronous ABI in raw1394 (rawiso) were created.

Users:

	libraw1394 users via the long deprecated API raw1394_iso_write,

	raw1394_start_iso_write, raw1394_start_iso_rcv, raw1394_stop_iso_rcv

	libdc1394, which optionally uses these old libraw1394 calls

	alternatively to the more efficient video1394 ABI