.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH MADVISE 2 2012\-04\-28 Linux "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 2001 NAKANO Takeo all rights reserved.
+.\" Translated Thu Aug 16 2001 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
+.\" Updated Tue 8 Oct 2002 by NAKANO Takeo
+.\" Updated 2007-01-08, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.43
+.\" Updated 2013-05-01, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-07-31, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
+.TH MADVISE 2 2014\-12\-31 Linux "Linux Programmer's Manual"
.SH 名前
-madvise \- メモリ利用に関するアドバイスを与える
+madvise \- メモリー利用に関するアドバイスを与える
.SH 書式
\fB#include <sys/mman.h>\fP
.sp
\fBmadvise\fP(): _BSD_SOURCE
.SH 説明
\fBmadvise\fP() システムコールは、アドレス \fIaddr\fP からはじまる \fIlength\fP
-バイトのメモリブロックのページング入出力をどう扱えば良いか、 カーネルにアドバイスする。 これを用いると、 アプリケーションからカーネルに、
-ã\83\9eã\83\83ã\83\97ã\81\95ã\82\8cã\81\9fã\83¡ã\83¢ã\83ªã\82\84å\85±æ\9c\89ã\83¡ã\83¢ã\83ªをどのように扱ってほしいか伝えることができ、 カーネルはそれに応じて先読みやキャッシュなどの適切な手法を選択できる。
+ã\83\90ã\82¤ã\83\88ã\81®ã\83¡ã\83¢ã\83ªã\83¼ã\83\96ã\83ã\83\83ã\82¯ã\81®ã\83\9aã\83¼ã\82¸ã\83³ã\82°å\85¥å\87ºå\8a\9bã\82\92ã\81©ã\81\86æ\89±ã\81\88ã\81°è\89¯ã\81\84ã\81\8bã\80\81 ã\82«ã\83¼ã\83\8dã\83«ã\81«ã\82¢ã\83\89ã\83\90ã\82¤ã\82¹ã\81\99ã\82\8bã\80\82 ã\81\93ã\82\8cã\82\92ç\94¨ã\81\84ã\82\8bã\81¨ã\80\81 ã\82¢ã\83\97ã\83ªã\82±ã\83¼ã\82·ã\83§ã\83³ã\81\8bã\82\89ã\82«ã\83¼ã\83\8dã\83«ã\81«ã\80\81
+ã\83\9eã\83\83ã\83\97ã\81\95ã\82\8cã\81\9fã\83¡ã\83¢ã\83ªã\83¼ã\82\84å\85±æ\9c\89ã\83¡ã\83¢ã\83ªã\83¼をどのように扱ってほしいか伝えることができ、 カーネルはそれに応じて先読みやキャッシュなどの適切な手法を選択できる。
このコールはアプリケーションの動作そのものには影響しない (\fBMADV_DONTNEED\fP の場合は別) が、 性能には影響しうる。
なおこのアドバイスを受け入れるかどうかはカーネルに任される。
.LP
.TP
\fBMADV_DONTNEED\fP
しばらくアクセスはなさそうだ。 (現時点でアプリケーションは与えた範囲の処理を終えている。 したがってカーネルはこれに関連するリソースを解放して良い。)
-これ以降この範囲のページへのアクセスがあると、 成功はするが、メモリの内容をマップ元のファイルからロードし直すことになる (\fBmmap\fP(2)
+ã\81\93ã\82\8c以é\99\8dã\81\93ã\81®ç¯\84å\9b²ã\81®ã\83\9aã\83¼ã\82¸ã\81¸ã\81®ã\82¢ã\82¯ã\82»ã\82¹ã\81\8cã\81\82ã\82\8bã\81¨ã\80\81 æ\88\90å\8a\9fã\81¯ã\81\99ã\82\8bã\81\8cã\80\81ã\83¡ã\83¢ã\83ªã\83¼ã\81®å\86\85容ã\82\92ã\83\9eã\83\83ã\83\97å\85\83ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\81\8bã\82\89ã\83ã\83¼ã\83\89ã\81\97ç\9b´ã\81\99ã\81\93ã\81¨ã\81«ã\81ªã\82\8b (\fBmmap\fP(2)
を見よ) か、 または元ファイルがないマップページでは アクセスがあったときに 0 埋めが行われることになる。
.TP
\fBMADV_REMOVE\fP (Linux 2.6.16 以降)
の前後でマッピングは継承されるようになる。
.TP
\fBMADV_HWPOISON\fP (Linux 2.6.32 以降)
-Poison a page and handle it like a hardware memory corruption. This
-operation is only available for privileged (\fBCAP_SYS_ADMIN\fP) processes.
-This operation may result in the calling process receiving a \fBSIGBUS\fP and
-the page being unmapped. This feature is intended for testing of memory
-error\-handling code; it is only available if the kernel was configured with
-\fBCONFIG_MEMORY_FAILURE\fP.
+ページに毒入れを行い、ハードウェアメモリーの破損のようにそのページを取り扱う。 この操作は特権 (\fBCAP_SYS_ADMIN\fP を持った)
+プロセスだけが利用できる。 この操作の結果、呼び出したプロセスは \fBSIGBUS\fP を受け取り、そのページはアンマップされる。
+この機能はメモリーのエラー処理コードをテストするためのものである。 カーネルで \fBCONFIG_MEMORY_FAILURE\fP
+が有効になっている場合にのみ利用可能である。
.TP
\fBMADV_SOFT_OFFLINE\fP (Linux 2.6.33 以降)
-Soft offline the pages in the range specified by \fIaddr\fP and \fIlength\fP. The
-memory of each page in the specified range is preserved (i.e., when next
-accessed, the same content will be visible, but in a new physical page
-frame), and the original page is offlined (i.e., no longer used, and taken
-out of normal memory management). The effect of the \fBMADV_SOFT_OFFLINE\fP
-operation is invisible to (i.e., does not change the semantics of) the
-calling process. This feature is intended for testing of memory
-error\-handling code; it is only available if the kernel was configured with
-\fBCONFIG_MEMORY_FAILURE\fP.
+\fIaddr\fP と \fIlength\fP で指定された範囲のページをソフトオフラインにする。 指定された範囲の各ページのメモリーの内容は保持され
+(すなわち、次にアクセスされた際に、同じ内容が見えるが、新しい物理ページフレームになる)、 元のフレームはオフラインになる (すなわち、
+そのフレームは使用される、通常のメモリー管理からは取り除かれる)。 \fBMADV_SOFT_OFFLINE\fP 操作の影響は呼び出したプロセスには見えない
+(つまり呼び出したプロセスの動作は変化しない)。 この機能はメモリーのエラー処理コードをテストすることを目的に作られた。 カーネルで
+\fBCONFIG_MEMORY_FAILURE\fP が有効になっている場合にのみ利用可能である。
.TP
\fBMADV_MERGEABLE\fP (Linux 2.6.32 以降)
-Enable Kernel Samepage Merging (KSM) for the pages in the range specified by
-\fIaddr\fP and \fIlength\fP. The kernel regularly scans those areas of user
-memory that have been marked as mergeable, looking for pages with identical
-content. These are replaced by a single write\-protected page (which is
-automatically copied if a process later wants to update the content of the
-page). KSM only merges private anonymous pages (see \fBmmap\fP(2)). The KSM
-feature is intended for applications that generate many instances of the
-same data (e.g., virtualization systems such as KVM). It can consume a lot
-of processing power; use with care. See the Linux kernel source file
-\fIDocumentation/vm/ksm.txt\fP for more details. The \fBMADV_MERGEABLE\fP and
-\fBMADV_UNMERGEABLE\fP operations are only available if the kernel was
-configured with \fBCONFIG_KSM\fP.
+Kernel Samepage Merging (KSM; カーネルによる同じページの統合) を \fIaddr\fP と \fIlength\fP
+で指定された領域に対して有効にする。 カーネルは、 統合可能の印がついたユーザーメモリーの領域を定期的にスキャンし、内容が全く同じページを探す。
+内容が全く同じページがあれば、それらのページは書き込み保護 (write\-protected) がかかった一つのページで置き換えられる
+(プロセスが後でページの内容を更新しようとした際には自動的にページのコピーが行われる)。 KSM はプライベートな無名ページ (anonymous
+pages) だけを統合する (\fBmmap\fP(2) 参照)。 KSM 機能は、 同じデータのインスタンスを大量に生成するアプリケーション (KVM
+などの仮想化システム) での利用を想定している。 この機能はプロセッシング能力を大量に消費する場合があり、注意して使用すること。 詳細は Linux
+カーネルソースファイル \fIDocumentation/vm/ksm.txt\fP を参照。 \fBMADV_MERGEABLE\fP と
+\fBMADV_UNMERGEABLE\fP は、 カーネルで \fBCONFIG_KSM\fP オプションを有効になっている場合にのみ利用できる。
.TP
\fBMADV_UNMERGEABLE\fP (Linux 2.6.32 以降)
-Undo the effect of an earlier \fBMADV_MERGEABLE\fP operation on the specified
-address range; KSM unmerges whatever pages it had merged in the address
-range specified by \fIaddr\fP and \fIlength\fP.
+指定されたアドレス範囲に関して、それ以前に行われた \fBMADV_MERGEABLE\fP 操作の効果を取り消す。 KSM は、 \fIaddr\fP と
+\fIlength\fP で指定されたアドレス範囲の統合済みのすべてのページの統合解除を行う。
.TP
\fBMADV_HUGEPAGE\fP (Linux 2.6.38 以降)
.\" http://lwn.net/Articles/358904/
.\" https://lwn.net/Articles/423584/
-Enables Transparent Huge Pages (THP) for pages in the range specified by
-\fIaddr\fP and \fIlength\fP. Currently, Transparent Huge Pages only work with
-private anonymous pages (see \fBmmap\fP(2)). The kernel will regularly scan
-the areas marked as huge page candidates to replace them with huge pages.
-The kernel will also allocate huge pages directly when the region is
-naturally aligned to the huge page size (see \fBposix_memalign\fP(2)). This
-feature is primarily aimed at applications that use large mappings of data
-and access large regions of that memory at a time (e.g., virtualization
-systems such as QEMU). It can very easily waste memory (e.g., a 2MB mapping
-that only ever accesses 1 byte will result in 2MB of wired memory instead of
-one 4KB page). See the Linux kernel source file
-\fIDocumentation/vm/transhuge.txt\fP for more details. The \fBMADV_HUGEPAGE\fP
-and \fBMADV_NOHUGEPAGE\fP operations are only available if the kernel was
-configured with \fBCONFIG_TRANSPARENT_HUGEPAGE\fP.
+Transparent Huge Pages (THP) を \fIaddr\fP と \fIlength\fP で指定された領域に対して有効にする。
+現在のところ、Transparent Huge Pages はプライベートな無名ページ (anonymous pages) についてのみ機能する。
+カーネルは定期的にヒュージページ (huge page) 候補の印がついたページをスキャンし、ヒュージページと置き換える。
+また、カーネルはその領域がヒュージページのサイズに合っている場合、ヒュージページを直接割り当てる (\fBposix_memalign\fP(2) 参照)。
+この機能は、大きなデータマッピングを使用し、一度にそのメモリーの大きな範囲にアクセスするようなアプリケーション (例えば QEMU
+のような仮想化システム) で使うことを主に想定されている。 この機能は非常に簡単にメモリーを浪費してしまう (例えば、1 バイトしかアクセスしない
+2MB のマッピングが、 4KB ページではなく 2MB の実際のメモリーを使ってしまう)。 詳細は Linux カーネルソースファイル
+\fIDocumentation/vm/transhuge.txt\fP を参照。 \fBMADV_HUGEPAGE\fP と \fBMADV_NOHUGEPAGE\fP
+は、 カーネルで \fBCONFIG_TRANSPARENT_HUGEPAGE\fP オプションを有効になっている場合にのみ利用できる。
.TP
\fBMADV_NOHUGEPAGE\fP (Linux 2.6.38 以降)
-Ensures that memory in the address range specified by \fIaddr\fP and \fIlength\fP
-will not be collapsed into huge pages.
+\fIaddr\fP と \fIlength\fP で指定されたアドレス範囲のメモリーがヒュージページに組み込まれないようにする。
.TP
\fBMADV_DONTDUMP\fP (Linux 3.4 以降)
-Exclude from a core dump those pages in the range specified by \fIaddr\fP and
-\fIlength\fP. This is useful in applications that have large areas of memory
-that are known not to be useful in a core dump. The effect of
-\fBMADV_DONTDUMP\fP takes precedence over the bit mask that is set via the
-\fI/proc/PID/coredump_filter\fP file (see \fBcore\fP(5)).
+コアダンプから \fIaddr\fP と \fIlength\fP で指定された範囲のページを除外する。 これは、
+コアダンプに含めても役に立たないことが分かっている大きなメモリー領域があるアプリケーションで有用である。 \fBMADV_DONTDUMP\fP の効果は
+\fI/proc/PID/coredump_filter\fP ファイル経由で設定されたビットマスクよりも優先される (\fBcore\fP(5) 参照)。
.TP
\fBMADV_DODUMP\fP (Linux 3.4 以降)
-Undo the effect of an earlier \fBMADV_DONTDUMP\fP.
+以前の \fBMADV_DONTDUMP\fP の効果を取り消す。
.SH 返り値
\fBmadvise\fP() は成功すると 0 を返す。 エラーが起こると \-1 を返し、 \fIerrno\fP を適切な値に設定する。
.SH エラー
指定したマップは存在するが、ファイルではないところをマップしている。
.TP
\fBEINVAL\fP
-This error can occur for the following reasons:
+このエラーは以下の理由で発生する。
.RS
.IP * 3
.\" .I len
.\" is zero,
\fIlen\fP が負の値である。
.IP *
-\fIaddr\fP is not page\-aligned.
+\fIaddr\fP がページ境界ではない。
.IP *
\fIadvice\fP が有効な値でない。
.IP *
アプリケーションがロックされたページや共有ページを (\fBMADV_DONTNEED\fP で) 解放
しようとしている。
.IP *
-\fBMADV_MERGEABLE\fP or \fBMADV_UNMERGEABLE\fP was specified in \fIadvice\fP, but the
-kernel was not configured with \fBCONFIG_KSM\fP.
+\fIadvice\fP に \fBMADV_MERGEABLE\fP か \fBMADV_UNMERGEABLE\fP が指定されたが、 カーネルの設定が
+\fBCONFIG_KSM\fP が有効になっていなかった。
.RE
.TP
\fBEIO\fP
の最大値を越えてしまう。
.TP
\fBENOMEM\fP
-(\fBMADV_WILLNEED\fP の場合) メモリが足りず、ページングに失敗した。
+(\fBMADV_WILLNEED\fP ã\81®å ´å\90\88) ã\83¡ã\83¢ã\83ªã\83¼ã\81\8c足ã\82\8aã\81\9aã\80\81ã\83\9aã\83¼ã\82¸ã\83³ã\82°ã\81«å¤±æ\95\97ã\81\97ã\81\9fã\80\82
.TP
\fBENOMEM\fP
指定した範囲のアドレスが、現在マップされていない。 あるいはプロセスのアドレス空間の内部にない。
+.SH バージョン
+.\" commit d3ac21cacc24790eb45d735769f35753f5b56ceb
+Linux 3.18 以降では、このシステムコールのサポートは任意となり、利用できるかはカーネルが \fBCONFIG_ADVISE_SYSCALLS\fP
+オプションを有効にしてコンパイルされているかに依存する。
.SH 準拠
.\" FIXME . Write a posix_madvise(3) page.
-POSIX.1b. POSIX.1\-2001 では、 \fBposix_madvise\fP(3) を \fBPOSIX_MADV_NORMAL\fP
-などの定数とともに記述していた (それぞれの振る舞いはここで述べたものに近い)。 ファイルアクセスに対しても \fBposix_fadvise\fP(2)
-という類似の関数が存在する。
+POSIX.1b. POSIX.1\-2001 では、 \fBposix_madvise\fP(3) を \fBPOSIX_MADV_NORMAL\fP,
+\fBPOSIX_MADV_RANDOM\fP などの定数とともに記述していた (それぞれの振る舞いはここで述べたものに近い)。 ファイルアクセスに対しても
+\fBposix_fadvise\fP(2) という類似の関数が存在する。
\fBMADV_REMOVE\fP, \fBMADV_DONTFORK\fP, \fBMADV_DOFORK\fP, \fBMADV_HWPOISON\fP,
\fBMADV_MERGEABLE\fP, \fBMADV_UNMERGEABLE\fP は Linux 固有である。
これらを無視して残りの部分にアドバイスを適用する (しかしシステムコールに対してはちゃんと \fBENOMEM\fP を返す)。
.SH 関連項目
\fBgetrlimit\fP(2), \fBmincore\fP(2), \fBmmap\fP(2), \fBmprotect\fP(2), \fBmsync\fP(2),
-\fBmunmap\fP(2), \fBcore\fP(5)
+\fBmunmap\fP(2), \fBprctl\fP(2), \fBcore\fP(5)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
