OSDN Git Service

LDP: Translate madvise.2 and duplocale.3
authorAkihiro MOTOKI <amotoki@gmail.com>
Mon, 28 Apr 2014 17:09:03 +0000 (02:09 +0900)
committerAkihiro MOTOKI <amotoki@gmail.com>
Mon, 28 Apr 2014 17:09:03 +0000 (02:09 +0900)
manual/LDP_man-pages/draft/man2/madvise.2
manual/LDP_man-pages/draft/man3/duplocale.3
manual/LDP_man-pages/po4a/locale/po/ja.po
manual/LDP_man-pages/po4a/memory/po/ja.po
manual/LDP_man-pages/release/man2/madvise.2
manual/LDP_man-pages/release/man3/duplocale.3
manual/LDP_man-pages/stats/locale
manual/LDP_man-pages/stats/memory
manual/LDP_man-pages/translation_list
manual/LDP_man-pages/untrans.html

index 6f4d3d9..5cde851 100644 (file)
@@ -127,71 +127,52 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参
 の前後でマッピングは継承されるようになる。
 .TP 
 \fBMADV_HWPOISON\fP (Linux 2.6.32 以降)
-Poison a page and handle it like a hardware memory corruption.  This
-operation is available only 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 available only 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 available only 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 merges only 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 available only 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 work only 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 available only 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 以降)
 以前の \fBMADV_DONTDUMP\fP の効果を取り消す。
index b994fef..4355b2d 100644 (file)
@@ -70,23 +70,19 @@ _GNU_SOURCE
 .SH 準拠
 POSIX.1\-2008.
 .SH 注意
-Duplicating a locale can serve the following purposes:
+ロケールの複製は以下のことを行う際に役立つ。
 .IP * 3
-To create a copy of a locale object in which one of more categories are to
-be modified (using \fBnewlocale\fP(3)).
+ロケールオブジェクトのコピーを作成し、  (\fBnewlocale\fP(3) を使って) いくつかのカテゴリだけを変更する。
 .IP *
-To obtain a handle for the current locale which can used in other functions
-that employ a locale handle, such as \fBtoupper_l\fP(3).  This is done by
-applying \fBduplocale\fP()  to the value returned by the following call:
+現在のロケールに対するハンドルを取得する。 このハンドルはロケールハンドルを受け取る他の関数 (\fBtoupper_l\fP(3) など) で使用できる。
+これを行うには、 以下の呼び出しが返した値を \fBduplocale\fP() に渡せばよい。
 
     loc = uselocale((locale_t) 0);
 
 .IP
-This technique is necessary, because the above \fBuselocale\fP(3)  call may
-return the value \fBLC_GLOBAL_LOCALE\fP, which results in undefined behavior if
-passed to functions such as \fBtoupper_l\fP(3).  Calling \fBduplocale\fP()  can be
-used to ensure that the \fBLC_GLOBAL_LOCALE\fP value is converted into a usable
-locale object.  See EXAMPLE, below.
+上記の \fBuselocale\fP(3) の呼び出しは値 \fBLC_GLOBAL_LOCALE\fP を返すことがあり、 この値を
+\fBtoupper_l\fP(3) などの関数に渡した場合の動作は不定なので、 この方法は必要である。 \fBduplocale\fP()
+を呼び出すことで、確実に \fBLC_GLOBAL_LOCALE\fP が使用可能なロケールオブジェクトに変換することができる。 下記の「例」を参照。
 .PP
 \fBduplocale\fP() で作成された各ロケールオブジェクトは \fBfreelocale\fP(3) を使って解放すべきである。
 .SH 例
index ec14c54..bd95bb4 100644 (file)
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "POT-Creation-Date: 2014-04-24 00:51+0900\n"
-"PO-Revision-Date: 2014-04-27 06:38+0900\n"
+"PO-Revision-Date: 2014-04-28 06:17+0900\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "Language: \n"
@@ -870,7 +870,7 @@ msgstr "POSIX.1-2008."
 #. type: Plain text
 #: build/C/man3/duplocale.3:87
 msgid "Duplicating a locale can serve the following purposes:"
-msgstr ""
+msgstr "ロケールの複製は以下のことを行う際に役立つ。"
 
 #. type: IP
 #: build/C/man3/duplocale.3:87 build/C/man3/duplocale.3:91
@@ -890,7 +890,7 @@ msgstr "*"
 msgid ""
 "To create a copy of a locale object in which one of more categories are to "
 "be modified (using B<newlocale>(3))."
-msgstr ""
+msgstr "ロケールオブジェクトのコピーを作成し、  (B<newlocale>(3) を使って) いくつかのカテゴリだけを変更する。"
 
 #. type: Plain text
 #: build/C/man3/duplocale.3:98
@@ -898,7 +898,7 @@ msgid ""
 "To obtain a handle for the current locale which can used in other functions "
 "that employ a locale handle, such as B<toupper_l>(3).  This is done by "
 "applying B<duplocale>()  to the value returned by the following call:"
-msgstr ""
+msgstr "現在のロケールに対するハンドルを取得する。 このハンドルはロケールハンドルを受け取る他の関数 (B<toupper_l>(3) など) で使用できる。 これを行うには、 以下の呼び出しが返した値を B<duplocale>() に渡せばよい。"
 
 #. type: Plain text
 #: build/C/man3/duplocale.3:100
@@ -914,7 +914,7 @@ msgid ""
 "passed to functions such as B<toupper_l>(3).  Calling B<duplocale>()  can be "
 "used to ensure that the B<LC_GLOBAL_LOCALE> value is converted into a usable "
 "locale object.  See EXAMPLE, below."
-msgstr ""
+msgstr "上記の B<uselocale>(3) の呼び出しは値 B<LC_GLOBAL_LOCALE> を返すことがあり、 この値を B<toupper_l>(3) などの関数に渡した場合の動作は不定なので、 この方法は必要である。 B<duplocale>() を呼び出すことで、確実に B<LC_GLOBAL_LOCALE> が使用可能なロケールオブジェクトに変換することができる。 下記の「例」を参照。"
 
 #. type: Plain text
 #: build/C/man3/duplocale.3:119
index 4fa4a4f..558bde1 100644 (file)
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: PACKAGE VERSION\n"
 "POT-Creation-Date: 2014-04-27 08:03+0900\n"
-"PO-Revision-Date: 2014-04-28 02:47+0900\n"
+"PO-Revision-Date: 2014-04-29 00:50+0900\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
 "Language: \n"
@@ -1578,7 +1578,7 @@ msgid ""
 "the page being unmapped.  This feature is intended for testing of memory "
 "error-handling code; it is available only if the kernel was configured with "
 "B<CONFIG_MEMORY_FAILURE>."
-msgstr ""
+msgstr "ページに毒入れを行い、ハードウェアメモリの破損のようにそのページを取り扱う。 この操作は特権 (B<CAP_SYS_ADMIN> を持った) プロセスだけが利用できる。 この操作の結果、呼び出したプロセスは B<SIGBUS> を受け取り、そのページはアンマップされる。 この機能はメモリのエラー処理コードをテストするためのものである。 カーネルで B<CONFIG_MEMORY_FAILURE> が有効になっている場合にのみ利用可能である。"
 
 #. type: TP
 #: build/C/man2/madvise.2:162
@@ -1598,7 +1598,7 @@ msgid ""
 "calling process.  This feature is intended for testing of memory error-"
 "handling code; it is available only if the kernel was configured with "
 "B<CONFIG_MEMORY_FAILURE>."
-msgstr ""
+msgstr "I<addr> と I<length> で指定された範囲のページをソフトオフラインにする。 指定された範囲の各ページのメモリの内容は保持され (すなわち、次にアクセスされた際に、同じ内容が見えるが、新しい物理ページフレームになる)、 元のフレームはオフラインになる (すなわち、 そのフレームは使用される、通常のメモリ管理からは取り除かれる)。 B<MADV_SOFT_OFFLINE> 操作の影響は呼び出したプロセスには見えない (つまり呼び出したプロセスの動作は変化しない)。 この機能はメモリのエラー処理コードをテストすることを目的に作られた。 カーネルで B<CONFIG_MEMORY_FAILURE> が有効になっている場合にのみ利用可能である。"
 
 #. type: TP
 #: build/C/man2/madvise.2:180
@@ -1621,7 +1621,7 @@ msgid ""
 "I<Documentation/vm/ksm.txt> for more details.  The B<MADV_MERGEABLE> and "
 "B<MADV_UNMERGEABLE> operations are available only if the kernel was "
 "configured with B<CONFIG_KSM>."
-msgstr ""
+msgstr "Kernel Samepage Merging (KSM; カーネルによる同じページの統合) を I<addr> と I<length> で指定された領域に対して有効にする。 カーネルは、 統合可能の印がついたユーザーメモリの領域を定期的にスキャンし、内容が全く同じページを探す。 内容が全く同じページがあれば、それらのページは書き込み保護 (write-protected) がかかった一つのページで置き換えられる (プロセスが後でページの内容を更新しようとした際には自動的にページのコピーが行われる)。 KSM はプライベートな無名ページ (anonymous pages) だけを統合する (B<mmap>(2) 参照)。 KSM 機能は、 同じデータのインスタンスを大量に生成するアプリケーション (KVM などの仮想化システム) での利用を想定している。 この機能はプロセッシング能力を大量に消費する場合があり、注意して使用すること。 詳細は Linux カーネルソースファイル I<Documentation/vm/ksm.txt> を参照。 B<MADV_MERGEABLE> と B<MADV_UNMERGEABLE> は、 カーネルで B<CONFIG_KSM> オプションを有効になっている場合にのみ利用できる。"
 
 #. type: TP
 #: build/C/man2/madvise.2:205
@@ -1635,7 +1635,7 @@ msgid ""
 "Undo the effect of an earlier B<MADV_MERGEABLE> operation on the specified "
 "address range; KSM unmerges whatever pages it had merged in the address "
 "range specified by I<addr> and I<length>."
-msgstr ""
+msgstr "指定されたアドレス範囲に関して、それ以前に行われた B<MADV_MERGEABLE> 操作の効果を取り消す。 KSM は、  I<addr> と I<length> で指定されたアドレス範囲の統合済みのすべてのページの統合解除を行う。"
 
 #. type: TP
 #: build/C/man2/madvise.2:214
@@ -1662,7 +1662,7 @@ msgid ""
 "transhuge.txt> for more details.  The B<MADV_HUGEPAGE> and "
 "B<MADV_NOHUGEPAGE> operations are available only if the kernel was "
 "configured with B<CONFIG_TRANSPARENT_HUGEPAGE>."
-msgstr ""
+msgstr "Transparent Huge Pages (THP) を I<addr> と I<length> で指定された領域に対して有効にする。 現在のところ、Transparent Huge Pages はプライベートな無名ページ (anonymous pages) についてのみ機能する。 カーネルは定期的にヒュージページ (huge page) 候補の印がついたページをスキャンし、ヒュージページと置き換える。 また、カーネルはその領域がヒュージページのサイズに合っている場合、ヒュージページを直接割り当てる (B<posix_memalign>(2) 参照)。 この機能は、大きなデータマッピングを使用し、一度にそのメモリの大きな範囲にアクセスするようなアプリケーション (例えば QEMU のような仮想化システム) で使うことを主に想定されている。 この機能は非常に簡単にメモリを浪費してしまう (例えば、1 バイトしかアクセスしない 2MB のマッピングが、 4KB ページではなく 2MB の実際のメモリを使ってしまう)。 詳細は Linux カーネルソースファイル I<Documentation/vm/transhuge.txt> を参照。 B<MADV_HUGEPAGE> と B<MADV_NOHUGEPAGE> は、 カーネルで B<CONFIG_TRANSPARENT_HUGEPAGE> オプションを有効になっている場合にのみ利用できる。"
 
 #. type: TP
 #: build/C/man2/madvise.2:243
@@ -1675,7 +1675,7 @@ msgstr "B<MADV_NOHUGEPAGE> (Linux 2.6.38 以降)"
 msgid ""
 "Ensures that memory in the address range specified by I<addr> and I<length> "
 "will not be collapsed into huge pages."
-msgstr ""
+msgstr "I<addr> と I<length> で指定されたアドレス範囲のメモリがヒュージページに組み込まれないようにする。"
 
 #. type: TP
 #: build/C/man2/madvise.2:250
@@ -1691,7 +1691,7 @@ msgid ""
 "that are known not to be useful in a core dump.  The effect of "
 "B<MADV_DONTDUMP> takes precedence over the bit mask that is set via the I</"
 "proc/PID/coredump_filter> file (see B<core>(5))."
-msgstr ""
+msgstr "コアダンプから I<addr> と I<length> で指定された範囲のページを除外する。 これは、 コアダンプに含めても役に立たないことが分かっている大きなメモリ領域があるアプリケーションで有用である。 B<MADV_DONTDUMP> の効果は I</proc/PID/coredump_filter> ファイル経由で設定されたビットマスクよりも優先される (B<core>(5) 参照)。"
 
 #. type: TP
 #: build/C/man2/madvise.2:264
@@ -10986,18 +10986,6 @@ msgstr ""
 msgid "B<fdatasync>(2), B<fsync>(2), B<msync>(2), B<sync>(2)"
 msgstr "B<fdatasync>(2), B<fsync>(2), B<msync>(2), B<sync>(2)"
 
-#~ msgid "I<mode>"
-#~ msgstr "I<mode>"
-
-#~ msgid "2014-01-24"
-#~ msgstr "2014-01-24"
-
-#~ msgid "2012-04-28"
-#~ msgstr "2012-04-28"
-
-#~ msgid "2011-09-14"
-#~ msgstr "2011-09-14"
-
 #~ msgid ""
 #~ "Maximum size in bytes for a shared memory segment: policy dependent (on "
 #~ "Linux, this limit can be read and modified via I</proc/sys/kernel/"
@@ -11016,27 +11004,6 @@ msgstr "B<fdatasync>(2), B<fsync>(2), B<msync>(2), B<sync>(2)"
 #~ "より前では 128。 Linux では、この上限値は I</proc/sys/kernel/shmmni> 経由"
 #~ "で参照したり、変更したりできる)。"
 
-#~ msgid "2013-05-12"
-#~ msgstr "2013-05-12"
-
-#~ msgid "2012-04-16"
-#~ msgstr "2012-04-16"
-
-#~ msgid "2012-08-14"
-#~ msgstr "2012-08-14"
-
-#~ msgid "2012-03-23"
-#~ msgstr "2012-03-23"
-
-#~ msgid "B<fallocate>()  returns zero on success, and -1 on failure."
-#~ msgstr "B<fallocate>()  は成功すると 0 を返し、エラーの場合は -1 を返す。"
-
-#~ msgid "On success, B<malloc_info>()  returns 0; on error, it returns -1."
-#~ msgstr "B<malloc_info>() は成功すると 0 を返す。エラーの場合は -1 を返す。"
-
-#~ msgid "2012-05-31"
-#~ msgstr "2012-05-31"
-
 #~ msgid ""
 #~ "A valid segment identifier, I<shmid>, is returned on success, -1 on error."
 #~ msgstr ""
@@ -11117,26 +11084,3 @@ msgstr "B<fdatasync>(2), B<fsync>(2), B<msync>(2), B<sync>(2)"
 #~ "有用である。 ファイルサイズが I<offset>+I<len> よりも小さい場合であって"
 #~ "も、ブロックの前もっての割り当てにより (B<stat>(2)  が返す) ファイルサイズ"
 #~ "は変更されることはない。"
-
-#~ msgid ""
-#~ "(Linux 2.6.9 and later) the caller was not privileged (B<CAP_IPC_LOCK>)  "
-#~ "and its B<RLIMIT_MEMLOCK> soft resource limit was 0."
-#~ msgstr ""
-#~ "(Linux 2.6.9 以降) 呼び出し元は特権 (B<CAP_IPC_LOCK>)  を持たず、ソフト資"
-#~ "源制限 B<RLIMIT_MEMLOCK> が 0 である。"
-
-#~ msgid ""
-#~ "(Linux 2.6.8 and earlier)  The calling process has insufficient privilege "
-#~ "to call B<munlockall>().  Under Linux the B<CAP_IPC_LOCK> capability is "
-#~ "required."
-#~ msgstr ""
-#~ "(Linux 2.6.8 以前)  呼び出し元プロセスが B<munlockall>()  を呼び出すのに必"
-#~ "要な特権を所有していなかった。 Linux では、 B<CAP_IPC_LOCK> ケーパビリティ"
-#~ "が必要である。"
-
-#~ msgid ""
-#~ "B<posix_fadvise>()  appeared in kernel 2.5.60.  Glibc support has been "
-#~ "provided since version 2.2."
-#~ msgstr ""
-#~ "B<posix_fadvise>()  はカーネル 2.5.60 で登場した。 glibc でのサポートは "
-#~ "glibc バージョン 2.2 以降で行われている。"
index 6f4d3d9..5cde851 100644 (file)
@@ -127,71 +127,52 @@ glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参
 の前後でマッピングは継承されるようになる。
 .TP 
 \fBMADV_HWPOISON\fP (Linux 2.6.32 以降)
-Poison a page and handle it like a hardware memory corruption.  This
-operation is available only 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 available only 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 available only 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 merges only 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 available only 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 work only 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 available only 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 以降)
 以前の \fBMADV_DONTDUMP\fP の効果を取り消す。
index b994fef..4355b2d 100644 (file)
@@ -70,23 +70,19 @@ _GNU_SOURCE
 .SH 準拠
 POSIX.1\-2008.
 .SH 注意
-Duplicating a locale can serve the following purposes:
+ロケールの複製は以下のことを行う際に役立つ。
 .IP * 3
-To create a copy of a locale object in which one of more categories are to
-be modified (using \fBnewlocale\fP(3)).
+ロケールオブジェクトのコピーを作成し、  (\fBnewlocale\fP(3) を使って) いくつかのカテゴリだけを変更する。
 .IP *
-To obtain a handle for the current locale which can used in other functions
-that employ a locale handle, such as \fBtoupper_l\fP(3).  This is done by
-applying \fBduplocale\fP()  to the value returned by the following call:
+現在のロケールに対するハンドルを取得する。 このハンドルはロケールハンドルを受け取る他の関数 (\fBtoupper_l\fP(3) など) で使用できる。
+これを行うには、 以下の呼び出しが返した値を \fBduplocale\fP() に渡せばよい。
 
     loc = uselocale((locale_t) 0);
 
 .IP
-This technique is necessary, because the above \fBuselocale\fP(3)  call may
-return the value \fBLC_GLOBAL_LOCALE\fP, which results in undefined behavior if
-passed to functions such as \fBtoupper_l\fP(3).  Calling \fBduplocale\fP()  can be
-used to ensure that the \fBLC_GLOBAL_LOCALE\fP value is converted into a usable
-locale object.  See EXAMPLE, below.
+上記の \fBuselocale\fP(3) の呼び出しは値 \fBLC_GLOBAL_LOCALE\fP を返すことがあり、 この値を
+\fBtoupper_l\fP(3) などの関数に渡した場合の動作は不定なので、 この方法は必要である。 \fBduplocale\fP()
+を呼び出すことで、確実に \fBLC_GLOBAL_LOCALE\fP が使用可能なロケールオブジェクトに変換することができる。 下記の「例」を参照。
 .PP
 \fBduplocale\fP() で作成された各ロケールオブジェクトは \fBfreelocale\fP(3) を使って解放すべきである。
 .SH 例
index 6c69652..ebccf4a 100644 (file)
@@ -1,5 +1,4 @@
 # pagename,#complete,#remaining,#all
-duplocale.3,51,4,55
 locale.1,33,18,51
 locale.5,316,91,407
 newlocale.3,60,29,89
index d042d0f..1017228 100644 (file)
@@ -1,5 +1,4 @@
 # pagename,#complete,#remaining,#all
-madvise.2,75,7,82
 mallinfo.3,48,17,65
 malloc_get_state.3,18,7,25
 malloc_trim.3,18,8,26
index ddf1ccb..839a1f3 100644 (file)
 @:LDP man-pages:3.65:2014/02/06:lsetxattr:2:setxattr:2:
 @:LDP man-pages:3.65:2014/03/19:lstat:2:stat:2:
 @:LDP man-pages:3.65:2014/03/19:lstat64:2:lstat:2:
\98\86:LDP man-pages:3.50=>3.65:2014/04/20:madvise:2:2013/03/25::amotoki@gmail.com:Akihiro MOTOKI:
\97\8b:LDP man-pages:3.65:2014/04/20:madvise:2:2014/04/29::amotoki@gmail.com:Akihiro MOTOKI:
 @:LDP man-pages:3.65:2013/02/12:madvise1:2:unimplemented:2:
 ○:LDP man-pages:3.65:2008/08/15:mbind:2:2014/04/24::amotoki@dd.iij4u.or.jp:Akihiro MOTOKI:
 ○:LDP man-pages:3.65:2012/08/01:migrate_pages:2:2014/04/24::amotoki@gmail.com:Akihiro MOTOKI:
 @:LDP man-pages:3.65:2010/09/20:drem:3:remainder:3:
 @:LDP man-pages:3.65:2010/09/20:dremf:3:remainder:3:
 @:LDP man-pages:3.65:2010/09/20:dreml:3:remainder:3:
-×:LDP man-pages:3.65:2014/03/12:duplocale:3:::::
+○:LDP man-pages:3.65:2014/03/12:duplocale:3:2014/04/28::amotoki@gmail.com:Akihiro MOTOKI:
 ○:LDP man-pages:3.65:2013/09/25:dysize:3:2014/04/24::nakano@apm.seikei.ac.jp:NAKANO Takeo:
 @:LDP man-pages:3.65:2013/09/25:eaccess:3:euidaccess:3:
 @:LDP man-pages:3.65:2013/09/18:ecb_crypt:3:des_crypt:3:
index a3af553..134f50c 100644 (file)
@@ -27,7 +27,6 @@
 <TR><TD>delete_module.2</TD><TD>22/60</TD><TD>63.33</TD></TR>
 <TR><TD>init_module.2</TD><TD>34/78</TD><TD>56.41</TD></TR>
 <TR><TD ALIGN="center" COLSPAN=3 BGCOLOR="Yellow"><B>locale</B></TD></TR>
-<TR class="over80"><TD>duplocale.3</TD><TD>4/55</TD><TD>92.73</TD></TR>
 <TR><TD>locale.1</TD><TD>18/51</TD><TD>64.71</TD></TR>
 <TR class="over70"><TD>locale.5</TD><TD>91/407</TD><TD>77.64</TD></TR>
 <TR><TD>newlocale.3</TD><TD>29/89</TD><TD>67.42</TD></TR>
@@ -41,7 +40,6 @@
 <TR><TD>ptrace.2</TD><TD>203/289</TD><TD>29.76</TD></TR>
 <TR><TD>quotactl.2</TD><TD>47/102</TD><TD>53.92</TD></TR>
 <TR><TD ALIGN="center" COLSPAN=3 BGCOLOR="Yellow"><B>memory</B></TD></TR>
-<TR class="over80"><TD>madvise.2</TD><TD>7/82</TD><TD>91.46</TD></TR>
 <TR class="over70"><TD>mallinfo.3</TD><TD>17/65</TD><TD>73.85</TD></TR>
 <TR class="over70"><TD>malloc_get_state.3</TD><TD>7/25</TD><TD>72.00</TD></TR>
 <TR><TD>malloc_trim.3</TD><TD>8/26</TD><TD>69.23</TD></TR>
@@ -79,6 +77,6 @@
 <TR class="over70"><TD>futimesat.2</TD><TD>10/37</TD><TD>72.97</TD></TR>
 <TR><TD>utimensat.2</TD><TD>49/107</TD><TD>54.21</TD></TR>
 <TR class="over80"><TD>zdump.8</TD><TD>1/22</TD><TD>95.45</TD></TR>
-<TR><TD COLSPAN=3>Total 52 pages</TD></TR>
+<TR><TD COLSPAN=3>Total 50 pages</TD></TR>
 </TABLE>
 </BODY></HTML>