-.\" Hey Emacs! This file is -*- nroff -*- source.
-.\"
.\" Copyright (C) 2001 David Gómez <davidge@jazzfree.com>
.\"
+.\" %%%LICENSE_START(VERBATIM)
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Formatted or processed versions of this manual, if unaccompanied by
.\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
.\"
.\" Based on comments from mm/filemap.c. Last modified on 10-06-2001
.\" Modified, 25 Feb 2002, Michael Kerrisk, <mtk.manpages@gmail.com>
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
-.TH MADVISE 2 2011\-09\-18 Linux "Linux Programmer's Manual"
+.TH MADVISE 2 2012\-04\-28 Linux "Linux Programmer's Manual"
.SH 名前
madvise \- メモリ利用に関するアドバイスを与える
.SH 書式
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 kernel source file
+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.
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
+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 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.
+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.
.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.
+.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)).
+.TP
+\fBMADV_DODUMP\fP (Linux 3.4 以降)
+Undo the effect of an earlier \fBMADV_DONTDUMP\fP.
.SH 返り値
\fBmadvise\fP() は成功すると 0 を返す。 エラーが起こると \-1 を返し、 \fIerrno\fP を適切な値に設定する。
.SH エラー
\fBENOMEM\fP
指定した範囲のアドレスが、現在マップされていない。 あるいはプロセスのアドレス空間の内部にない。
.SH 準拠
-.\" FIXME . Write a posix_fadvise(3) page.
+.\" FIXME . Write a posix_madvise(3) page.
POSIX.1b. POSIX.1\-2001 では、 \fBposix_madvise\fP(3) を \fBPOSIX_MADV_NORMAL\fP
などの定数とともに記述していた (それぞれの振る舞いはここで述べたものに近い)。 ファイルアクセスに対しても \fBposix_fadvise\fP(2)
という類似の関数が存在する。
\fBMADV_REMOVE\fP, \fBMADV_DONTFORK\fP, \fBMADV_DOFORK\fP, \fBMADV_HWPOISON\fP,
\fBMADV_MERGEABLE\fP, \fBMADV_UNMERGEABLE\fP は Linux 固有である。
.SH 注意
-.SS "Linux での注意"
+.SS "Linux notes"
.LP
現在の Linux の実装 (2.4.0) では、 このシステムコールをアドバイスというよりは命令と見ている。
したがってこのアドバイスに対して通常行われる動作が不可能な場合は、 エラーを返すことがある (上記の エラー の記述を参照)。
これらを無視して残りの部分にアドバイスを適用する (しかしシステムコールに対してはちゃんと \fBENOMEM\fP を返す)。
.SH 関連項目
\fBgetrlimit\fP(2), \fBmincore\fP(2), \fBmmap\fP(2), \fBmprotect\fP(2), \fBmsync\fP(2),
-\fBmunmap\fP(2)
+\fBmunmap\fP(2), \fBcore\fP(5)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
