linux-stable.git/Documentation/vm, branch linux-2.6.35.y

numa: update Documentation/vm/numa, add memoryless node info

2010-05-27T16:12:57+00:00

Kamezawa Hiroyuki requested documentation for the numa_mem_id() and slab
related changes.  He suggested Documentation/vm/numa for this
documentation.  Looking at this file, it seems to me to be hopelessly out
of date relative to current Linux NUMA support.  At the risk of going down
a rathole, I have made an attempt to rewrite the doc at a slightly higher
level [I think] and provide pointers to other in-tree documents and
out-of-tree man pages that cover the details.

Let the games begin.

Signed-off-by: Lee Schermerhorn 
Cc: Tejun Heo 
Cc: Mel Gorman 
Cc: Christoph Lameter 
Cc: Nick Piggin 
Cc: David Rientjes 
Cc: Eric Whitney 
Cc: KAMEZAWA Hiroyuki 
Cc: Ingo Molnar 
Cc: Thomas Gleixner 
Cc: "H. Peter Anvin" 
Cc: "Luck, Tony" 
Cc: Pekka Enberg 
Cc: Randy Dunlap 
Cc: 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Documentation/vm: use better value for MAP_HUGETLB

2010-05-24T14:30:56+00:00

documentation: slightly more correct value for MAP_HUGETLB in map_hugetlb.c

still not correct for alpha, mips, parisc or xtensa but working out of
the box in the most common architectures without having to deal with
complicated macros or including architecture specific headers.

Signed-off-by: Carlo Marcelo Arenas Belon 
Signed-off-by: Randy Dunlap 
Signed-off-by: Linus Torvalds

Documentation/: it's -> its where appropriate

2010-04-23T00:09:52+00:00

Fix obvious cases of "it's" being used when "its" was meant.

Signed-off-by: Francis Galiegue 
Acked-by: Randy Dunlap 
Signed-off-by: Jiri Kosina

Documentation/vm/: split txt and source files

2010-03-12T23:52:35+00:00

Documentation/vm/:
Expose example and tool source files in the Documentation/ directory in
their own files instead of being buried (almost hidden) in readme/txt files.
This should help to prevent bitrot.

This will make them more visible/usable to users who may need
to use them, to developers who may need to test with them, and
to anyone who would fix/update them if they were more visible.

Also, if any of these possibly should not be in the kernel tree at
all, it will be clearer that they are here and we can discuss if
they should be removed.

Also build the recently-added map_hugetlb.c.
Make several functions static to prevent linker warnings.

Signed-off-by: Randy Dunlap 
Acked-by: Eric B Munson 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

failslab: add ability to filter slab caches

2010-02-26T17:19:39+00:00

This patch allow to inject faults only for specific slabs.
In order to preserve default behavior cache filter is off by
default (all caches are faulty).

One may define specific set of slabs like this:
# mark skbuff_head_cache as faulty
echo 1 > /sys/kernel/slab/skbuff_head_cache/failslab
# Turn on cache filter (off by default)
echo 1 > /sys/kernel/debug/failslab/cache-filter
# Turn on fault injection
echo 1 > /sys/kernel/debug/failslab/times
echo 1 > /sys/kernel/debug/failslab/probability

Acked-by: David Rientjes 
Acked-by: Akinobu Mita 
Acked-by: Christoph Lameter 
Signed-off-by: Dmitry Monakhov 
Signed-off-by: Pekka Enberg

HWPOISON: Use correct name for MADV_HWPOISON in documentation

2009-12-16T11:20:00+00:00

Signed-off-by: Andi Kleen

HWPOISON: add memory cgroup filter

2009-12-16T11:19:59+00:00

The hwpoison test suite need to inject hwpoison to a collection of
selected task pages, and must not touch pages not owned by them and
thus kill important system processes such as init. (But it's OK to
mis-hwpoison free/unowned pages as well as shared clean pages.
Mis-hwpoison of shared dirty pages will kill all tasks, so the test
suite will target all or non of such tasks in the first place.)

The memory cgroup serves this purpose well. We can put the target
processes under the control of a memory cgroup, and tell the hwpoison
injection code to only kill pages associated with some active memory
cgroup.

The prerequisite for doing hwpoison stress tests with mem_cgroup is,
the mem_cgroup code tracks task pages _accurately_ (unless page is
locked).  Which we believe is/should be true.

The benefits are simplification of hwpoison injector code. Also the
mem_cgroup code will automatically be tested by hwpoison test cases.

The alternative interfaces pin-pfn/unpin-pfn can also delegate the
(process and page flags) filtering functions reliably to user space.
However prototype implementation shows that this scheme adds more
complexity than we wanted.

Example test case:

	mkdir /cgroup/hwpoison

	usemem -m 100 -s 1000 &
	echo `jobs -p` > /cgroup/hwpoison/tasks

	memcg_ino=$(ls -id /cgroup/hwpoison | cut -f1 -d' ')
	echo $memcg_ino > /debug/hwpoison/corrupt-filter-memcg

	page-types -p `pidof init`   --hwpoison  # shall do nothing
	page-types -p `pidof usemem` --hwpoison  # poison its pages

[AK: Fix documentation]
[Add fix for problem noticed by Li Zefan ;
dentry in the css could be NULL]

CC: KOSAKI Motohiro 
CC: Hugh Dickins 
CC: Daisuke Nishimura 
CC: Balbir Singh 
CC: KAMEZAWA Hiroyuki 
CC: Li Zefan 
CC: Paul Menage 
CC: Nick Piggin 
CC: Andi Kleen 
Signed-off-by: Wu Fengguang 
Signed-off-by: Andi Kleen

HWPOISON: add page flags filter

2009-12-16T11:19:59+00:00

When specified, only poison pages if ((page_flags & mask) == value).

-       corrupt-filter-flags-mask
-       corrupt-filter-flags-value

This allows stress testing of many kinds of pages.

Strictly speaking, the buddy pages requires taking zone lock, to avoid
setting PG_hwpoison on a "was buddy but now allocated to someone" page.
However we can just do nothing because we set PG_locked in the beginning,
this prevents the page allocator from allocating it to someone. (It will
BUG() on the unexpected PG_locked, which is fine for hwpoison testing.)

[AK: Add select PROC_PAGE_MONITOR to satisfy dependency]

CC: Nick Piggin 
Signed-off-by: Wu Fengguang 
Signed-off-by: Andi Kleen

HWPOISON: limit hwpoison injector to known page types

2009-12-16T11:19:59+00:00

__memory_failure()'s workflow is

	set PG_hwpoison
	//...
	unset PG_hwpoison if didn't pass hwpoison filter

That could kill unrelated process if it happens to page fault on the
page with the (temporary) PG_hwpoison. The race should be big enough to
appear in stress tests.

Fix it by grabbing the page and checking filter at inject time.  This
also avoids the very noisy "Injecting memory failure..." messages.

- we don't touch madvise() based injection, because the filters are
  generally not necessary for it.
- if we want to apply the filters to h/w aided injection, we'd better to
  rearrange the logic in __memory_failure() instead of this patch.

AK: fix documentation, use drain all, cleanups

CC: Haicheng Li 
Signed-off-by: Wu Fengguang 
Signed-off-by: Andi Kleen

HWPOISON: add fs/device filters

2009-12-16T11:19:59+00:00

Filesystem data/metadata present the most tricky-to-isolate pages.
It requires careful code review and stress testing to get them right.

The fs/device filter helps to target the stress tests to some specific
filesystem pages. The filter condition is block device's major/minor
numbers:
        - corrupt-filter-dev-major
        - corrupt-filter-dev-minor
When specified (non -1), only page cache pages that belong to that
device will be poisoned.

The filters are checked reliably on the locked and refcounted page.

Haicheng: clear PG_hwpoison and drop bad page count if filter not OK
AK: Add documentation

CC: Haicheng Li 
CC: Nick Piggin 
Signed-off-by: Wu Fengguang 
Signed-off-by: Andi Kleen