All of lore.kernel.org
 help / color / mirror / Atom feed
From: Minchan Kim <minchan@kernel.org>
To: Andrew Morton <akpm@linux-foundation.org>
Cc: linux-mm@kvack.org, linux-kernel@vger.kernel.org,
	Michael Kerrisk <mtk.manpages@gmail.com>,
	Rik van Riel <riel@redhat.com>,
	Dave Hansen <dave.hansen@intel.com>,
	Minchan Kim <minchan@kernel.org>, Rob Landley <rob@landley.net>
Subject: [PATCH v2 6/6] add documentation on proc.txt
Date: Wed, 24 Apr 2013 10:41:04 +0900	[thread overview]
Message-ID: <1366767664-17541-7-git-send-email-minchan@kernel.org> (raw)
In-Reply-To: <1366767664-17541-1-git-send-email-minchan@kernel.org>

This patch adds stuff about new reclaim field in proc.txt

Cc: Rob Landley <rob@landley.net>
Signed-off-by: Minchan Kim <minchan@kernel.org>
---

Rob, I didn't add your Acked-by because interface was slight changed.
I hope you give Acke-by after review again.
Thanks.

 Documentation/filesystems/proc.txt | 22 ++++++++++++++++++++++
 mm/Kconfig                         |  7 +------
 2 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt
index 488c094..1411ad0 100644
--- a/Documentation/filesystems/proc.txt
+++ b/Documentation/filesystems/proc.txt
@@ -136,6 +136,7 @@ Table 1-1: Process specific entries in /proc
  maps		Memory maps to executables and library files	(2.4)
  mem		Memory held by this process
  root		Link to the root directory of this process
+ reclaim	Reclaim pages in this process
  stat		Process status
  statm		Process memory status information
  status		Process status in human readable form
@@ -489,6 +490,27 @@ To clear the soft-dirty bit
 
 Any other value written to /proc/PID/clear_refs will have no effect.
 
+The file /proc/PID/reclaim is used to reclaim pages in this process.
+To reclaim file-backed pages,
+    > echo file > /proc/PID/reclaim
+
+To reclaim anonymous pages,
+    > echo anon > /proc/PID/reclaim
+
+To reclaim all pages,
+    > echo all > /proc/PID/reclaim
+
+Also, you can specify address range of process so part of address space
+will be reclaimed. The format is following as
+    > echo addr size-byte > /proc/PID/reclaim
+
+NOTE: addr should be page-aligned.
+
+Below is example which try to reclaim 2 pages from 0x100000.
+
+To reclaim both pages in address range,
+    > echo $((1<<20) 8192 > /proc/PID/reclaim
+
 The /proc/pid/pagemap gives the PFN, which can be used to find the pageflags
 using /proc/kpageflags and number of times a page is mapped using
 /proc/kpagecount. For detailed explanation, see Documentation/vm/pagemap.txt.
diff --git a/mm/Kconfig b/mm/Kconfig
index 314bf49..9d6b306 100644
--- a/mm/Kconfig
+++ b/mm/Kconfig
@@ -486,9 +486,4 @@ config PROCESS_RECLAIM
 	default n
 	help
 	 It allows to reclaim pages of the process by /proc/pid/reclaim.
-
-	 (echo file > /proc/PID/reclaim) reclaims file-backed pages only.
-	 (echo anon > /proc/PID/reclaim) reclaims anonymous pages only.
-	 (echo all > /proc/PID/reclaim) reclaims all pages.
-
- 	 Any other vaule is ignored.
+	 See Documentation/filesystem/proc.txt for more details.
-- 
1.8.2

--
To unsubscribe, send a message with 'unsubscribe linux-mm' in
the body to majordomo@kvack.org.  For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"dont@kvack.org"> email@kvack.org </a>

WARNING: multiple messages have this Message-ID (diff)
From: Minchan Kim <minchan@kernel.org>
To: Andrew Morton <akpm@linux-foundation.org>
Cc: linux-mm@kvack.org, linux-kernel@vger.kernel.org,
	Michael Kerrisk <mtk.manpages@gmail.com>,
	Rik van Riel <riel@redhat.com>,
	Dave Hansen <dave.hansen@intel.com>,
	Minchan Kim <minchan@kernel.org>, Rob Landley <rob@landley.net>
Subject: [PATCH v2 6/6] add documentation on proc.txt
Date: Wed, 24 Apr 2013 10:41:04 +0900	[thread overview]
Message-ID: <1366767664-17541-7-git-send-email-minchan@kernel.org> (raw)
In-Reply-To: <1366767664-17541-1-git-send-email-minchan@kernel.org>

This patch adds stuff about new reclaim field in proc.txt

Cc: Rob Landley <rob@landley.net>
Signed-off-by: Minchan Kim <minchan@kernel.org>
---

Rob, I didn't add your Acked-by because interface was slight changed.
I hope you give Acke-by after review again.
Thanks.

 Documentation/filesystems/proc.txt | 22 ++++++++++++++++++++++
 mm/Kconfig                         |  7 +------
 2 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt
index 488c094..1411ad0 100644
--- a/Documentation/filesystems/proc.txt
+++ b/Documentation/filesystems/proc.txt
@@ -136,6 +136,7 @@ Table 1-1: Process specific entries in /proc
  maps		Memory maps to executables and library files	(2.4)
  mem		Memory held by this process
  root		Link to the root directory of this process
+ reclaim	Reclaim pages in this process
  stat		Process status
  statm		Process memory status information
  status		Process status in human readable form
@@ -489,6 +490,27 @@ To clear the soft-dirty bit
 
 Any other value written to /proc/PID/clear_refs will have no effect.
 
+The file /proc/PID/reclaim is used to reclaim pages in this process.
+To reclaim file-backed pages,
+    > echo file > /proc/PID/reclaim
+
+To reclaim anonymous pages,
+    > echo anon > /proc/PID/reclaim
+
+To reclaim all pages,
+    > echo all > /proc/PID/reclaim
+
+Also, you can specify address range of process so part of address space
+will be reclaimed. The format is following as
+    > echo addr size-byte > /proc/PID/reclaim
+
+NOTE: addr should be page-aligned.
+
+Below is example which try to reclaim 2 pages from 0x100000.
+
+To reclaim both pages in address range,
+    > echo $((1<<20) 8192 > /proc/PID/reclaim
+
 The /proc/pid/pagemap gives the PFN, which can be used to find the pageflags
 using /proc/kpageflags and number of times a page is mapped using
 /proc/kpagecount. For detailed explanation, see Documentation/vm/pagemap.txt.
diff --git a/mm/Kconfig b/mm/Kconfig
index 314bf49..9d6b306 100644
--- a/mm/Kconfig
+++ b/mm/Kconfig
@@ -486,9 +486,4 @@ config PROCESS_RECLAIM
 	default n
 	help
 	 It allows to reclaim pages of the process by /proc/pid/reclaim.
-
-	 (echo file > /proc/PID/reclaim) reclaims file-backed pages only.
-	 (echo anon > /proc/PID/reclaim) reclaims anonymous pages only.
-	 (echo all > /proc/PID/reclaim) reclaims all pages.
-
- 	 Any other vaule is ignored.
+	 See Documentation/filesystem/proc.txt for more details.
-- 
1.8.2


  parent reply	other threads:[~2013-04-24  1:41 UTC|newest]

Thread overview: 22+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2013-04-24  1:40 [PATCH v2 0/6] Per process reclaim Minchan Kim
2013-04-24  1:40 ` Minchan Kim
2013-04-24  1:40 ` [PATCH v2 1/6] mm: " Minchan Kim
2013-04-24  1:40   ` Minchan Kim
2013-04-24  1:41 ` [PATCH v2 2/6] mm: make shrink_page_list with pages work from multiple zones Minchan Kim
2013-04-24  1:41   ` Minchan Kim
2013-04-24  1:41 ` [PATCH v2 3/6] mm: Remove shrink_page Minchan Kim
2013-04-24  1:41   ` Minchan Kim
2013-04-24  1:41 ` [PATCH v2 4/6] mm: Enhance per process reclaim to consider shared pages Minchan Kim
2013-04-24  1:41   ` Minchan Kim
2013-04-24  1:41 ` [PATCH v2 5/6] mm: Support address range reclaim Minchan Kim
2013-04-24  1:41   ` Minchan Kim
2013-04-24 11:01   ` Namhyung Kim
2013-04-24 11:01     ` Namhyung Kim
2013-04-25  0:50     ` Minchan Kim
2013-04-25  0:50       ` Minchan Kim
2013-04-24  1:41 ` Minchan Kim [this message]
2013-04-24  1:41   ` [PATCH v2 6/6] add documentation on proc.txt Minchan Kim
2013-04-24  6:49   ` Rob Landley
2013-04-24  6:49     ` Rob Landley
2013-04-24  8:18     ` Minchan Kim
2013-04-24  8:18       ` Minchan Kim

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1366767664-17541-7-git-send-email-minchan@kernel.org \
    --to=minchan@kernel.org \
    --cc=akpm@linux-foundation.org \
    --cc=dave.hansen@intel.com \
    --cc=linux-kernel@vger.kernel.org \
    --cc=linux-mm@kvack.org \
    --cc=mtk.manpages@gmail.com \
    --cc=riel@redhat.com \
    --cc=rob@landley.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.