.\" Updated & Modified Fri Apr 22 02:35:03 JST 2005 by Yuichi SATO
.\" Updated 2007-05-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.44
.\"
-.\"WORD: least significant bit ºÇ²¼°Ì¥Ó¥Ã¥È
+.\"WORD: least significant bit 最下位ビット
.\"
.TH MINCORE 2 2008-04-22 "Linux" "Linux Programmer's Manual"
-.SH ̾Á°
-mincore \- ¥Ú¡¼¥¸¤¬¥á¥â¥êÆâ¤Ë¤¢¤ë¤«¤É¤¦¤«¤òȽÄꤹ¤ë
-.SH ½ñ¼°
+.SH 名前
+mincore \- ページがメモリ内にあるかどうかを判定する
+.SH 書式
.B #include <unistd.h>
.br
.B #include <sys/mman.h>
.BI "int mincore(void *" addr ", size_t " length ", unsigned char *" vec );
.sp
.in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.in
.sp
.BR mincore ():
_BSD_SOURCE || _SVID_SOURCE
-.SH ÀâÌÀ
+.SH 説明
.BR mincore ()
-¤Ï¡¢¸Æ¤Ó½Ð¤·¸µ¥×¥í¥»¥¹¤Î²¾ÁÛ¥á¥â¥ê¤Î¥Ú¡¼¥¸¤¬¥³¥¢ (RAM) Æâ¤Ë¸ºß¤·¡¢
-¥Ú¡¼¥¸»²¾È»þ¤Ë¥Ç¥£¥¹¥¯¥¢¥¯¥»¥¹ (¥Ú¡¼¥¸¡¦¥Õ¥©¡¼¥ë¥È) ¤òµ¯¤³¤µ¤Ê¤¤¤«
-¤É¤¦¤«¤ò¼¨¤¹¥Ù¥¯¥È¥ë¤òÊÖ¤¹¡£¥«¡¼¥Í¥ë¤Ï¡¢¥¢¥É¥ì¥¹
+は、呼び出し元プロセスの仮想メモリのページがコア (RAM) 内に存在し、
+ページ参照時にディスクアクセス (ページ・フォールト) を起こさないか
+ã\81©ã\81\86ã\81\8bã\82\92示ã\81\99ã\83\99ã\82¯ã\83\88ã\83«ã\82\92è¿\94ã\81\99ã\80\82ã\82«ã\83¼ã\83\8dã\83«ã\81¯ã\80\81ã\82¢ã\83\89ã\83¬ã\82¹
.I addr
-¤«¤é»Ï¤Þ¤ë
+から始まる
.I length
-¥Ð¥¤¥È¤ÎÈϰϤΥڡ¼¥¸¤Ë´Ø¤¹¤ë¸ºß¾ðÊó¤òÊÖ¤¹¡£
+バイトの範囲のページに関する存在情報を返す。
.I addr
-°ú¤¿ô¤Ï¥·¥¹¥Æ¥à¤Î¥Ú¡¼¥¸¥µ¥¤¥º¤ÎÇÜ¿ô¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+引き数はシステムのページサイズの倍数でなければならない。
.I length
-°ú¤¿ô¤Ï¥Ú¡¼¥¸¥µ¥¤¥º¤ÎÇÜ¿ô¤Ç¤¢¤ëɬÍפϤʤ¤¤¬¡¢
-¥Ú¡¼¥¸Á´ÂΤ˴ؤ¹¤ë¸ºß¾ðÊó¤¬ÊÖ¤µ¤ì¤ë¤Î¤Ç¡¢»ö¼Â¾å
+引き数はページサイズの倍数である必要はないが、
+ページ全体に関する存在情報が返されるので、事実上
.I length
-¤Ï¥Ú¡¼¥¸¥µ¥¤¥º¤ÎÇÜ¿ô¤ËÀÚ¤ê¾å¤²¤é¤ì¤ë¤³¤È¤Ë¤Ê¤ë¡£
-¥Ú¡¼¥¸¥µ¥¤¥º
+はページサイズの倍数に切り上げられることになる。
+ã\83\9aã\83¼ã\82¸ã\82µã\82¤ã\82º
.RB ( PAGE_SIZE )
-¤Ï
+は
.I sysconf(_SC_PAGESIZE)
-¤ò»È¤Ã¤ÆÆþ¼ê¤Ç¤¤ë¡£
+を使って入手できる。
.I vec
-°ú¤¿ô¤Ï¡¢¾¯¤Ê¤¯¤È¤â
+引き数は、少なくとも
.I "(length+PAGE_SIZE\-1) / PAGE_SIZE"
-¥Ð¥¤¥È¤¬³ÊǼ¤Ç¤¤ëÇÛÎó¤ò»Ø¤·¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-¤³¤Î¸Æ¤Ó½Ð¤·¤¬ÊÖ¤ë¤È¤¡¢
-³Æ¥Ð¥¤¥È¤ÎºÇ²¼°Ì¥Ó¥Ã¥È¤Ï¡¢Âбþ¤¹¤ë¥Ú¡¼¥¸¤¬¥á¥â¥êÆâ¤Ë¤½¤Î¤È¤Â¸ºß¤¹¤ì¤Ð
-¥»¥Ã¥È¤µ¤ì¡¢¤½¤¦¤Ç¤Ê¤¤¾ì¹ç¤Ï¥¯¥ê¥¢¤µ¤ì¤ë
-(³Æ¥Ð¥¤¥È¤Î¤½¤Î¾¤Î¥Ó¥Ã¥È¤Ï̤ÄêµÁ¤Ç¤¢¤ê¡¢¤³¤ì¤é¤Î¥Ó¥Ã¥È¤Ï¾Íè¤Î»ÈÍѤË
-¤½¤Ê¤¨¤ÆͽÌ󤵤ì¤Æ¤¤¤ë)¡£
-¤â¤Á¤í¤ó¡¢
+バイトが格納できる配列を指していなければならない。
+この呼び出しが返るとき、
+各バイトの最下位ビットは、対応するページがメモリ内にそのとき存在すれば
+セットされ、そうでない場合はクリアされる
+(各バイトのその他のビットは未定義であり、これらのビットは将来の使用に
+そなえて予約されている)。
+もちろん、
.I vec
-¤ÇÊÖ¤µ¤ì¤¿¾ðÊó¤Ï¥¹¥Ê¥Ã¥×¥·¥ç¥Ã¥È¤Ç¤·¤«¤Ê¤¤¡£
-¥á¥â¥êÆâ¤Ë¥í¥Ã¥¯¤µ¤ì¤Æ¤¤¤Ê¤¤¥Ú¡¼¥¸¤Ï¡¢Ç¤°Õ¤Î»þÅÀ¤Ç¥á¥â¥êÆâ¤Ë
-Æþ¤Ã¤¿¤ê½Ð¤¿¤ê¤Ç¤¡¢¤³¤Î¸Æ¤Ó½Ð¤·¤¬ÊÖ¤ë¤È¤¤Ë¤Ï
+で返された情報はスナップショットでしかない。
+メモリ内にロックされていないページは、任意の時点でメモリ内に
+入ったり出たりでき、この呼び出しが返るときには
.I vec
-¤ÎÆâÍƤϤ¹¤Ç¤Ë¸Å¤¯¤Ê¤Ã¤Æ¤¤¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤·¤¿¾ì¹ç¡¢
+の内容はすでに古くなっているかもしれない。
+.SH 返り値
+成功した場合、
.BR mincore ()
-¤Ï 0 ¤òÊÖ¤¹¡£
-¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤òÊÖ¤·¤Æ¡¢
+は 0 を返す。
+エラーの場合は \-1 を返して、
.I errno
-¤òŬÀÚ¤ÊÃͤËÀßÄꤹ¤ë¡£
-.SH ¥¨¥é¡¼
+を適切な値に設定する。
+.SH ã\82¨ã\83©ã\83¼
.B EAGAIN
-¥«¡¼¥Í¥ë¤¬°ì»þŪ¤Ë¥ê¥½¡¼¥¹¤ò»È¤¤²Ì¤¿¤·¤Æ¤¤¤ë¡£
+カーネルが一時的にリソースを使い果たしている。
.TP
.B EFAULT
.I vec
-¤¬Ìµ¸ú¤Ê¥¢¥É¥ì¥¹¤ò»Ø¤·¤Æ¤¤¤ë¡£
+が無効なアドレスを指している。
.TP
.B EINVAL
.I addr
-¤¬¥Ú¡¼¥¸¥µ¥¤¥º¤ÎÇÜ¿ô¤Ç¤Ê¤¤¡£
+がページサイズの倍数でない。
.TP
.B ENOMEM
.I length
-¤¬
+が
.RI ( TASK_SIZE " \- " addr )
-¤è¤êÂ礤¤¡£
+より大きい。
.RI ( length
-¤ËÉé¤ÎÃͤ¬»ØÄꤵ¤ì¤¿¾ì¹ç¡¢
-¤½¤ÎÃͤ¬Â礤ÊÉä¹æ¤Ê¤·À°¿ô¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¤¿¤á¤Ëµ¯¤³¤ë¤³¤È¤¬¤¢¤ë¡£)
-Linux 2.6.11 °ÊÁ°¤Ç¤Ï¡¢¤³¤Î¾ò·ï¤Î¾ì¹ç¤Ï¥¨¥é¡¼
+に負の値が指定された場合、
+その値が大きな符号なし整数として解釈されるために起こることがある。)
+Linux 2.6.11 以å\89\8dã\81§ã\81¯ã\80\81ã\81\93ã\81®æ\9d¡ä»¶ã\81®å ´å\90\88ã\81¯ã\82¨ã\83©ã\83¼
.B EINVAL
-¤¬ÊÖ¤µ¤ì¤Æ¤¤¤¿¡£
+が返されていた。
.TP
.B ENOMEM
.I addr
-¤«¤é
+から
.I addr
+
.I length
-¤Î´Ö¤Ë¥Þ¥Ã¥×¤µ¤ì¤Æ¤¤¤Ê¤¤¥á¥â¥ê¤¬¤¢¤Ã¤¿¡£
-.SH ¥Ð¡¼¥¸¥ç¥ó
-Linux 2.3.99pre1 ¤È glibc 2.2 ¤«¤éÍøÍѲÄǽ¤Ç¤¢¤ë¡£
-.SH ½àµò
+の間にマップされていないメモリがあった。
+.SH バージョン
+Linux 2.3.99pre1 と glibc 2.2 から利用可能である。
+.SH 準拠
.BR mincore ()
-¤Ï POSIX.1-2001 ¤Ëµ½Ò¤µ¤ì¤Æ¤ª¤é¤º¡¢
-Á´¤Æ¤Î UNIX ¼ÂÁõ¤ÇÍøÍѲÄǽ¤Ç¤¢¤ë¤ï¤±¤Ç¤Ï¤Ê¤¤¡£
+は POSIX.1-2001 に記述されておらず、
+全ての UNIX 実装で利用可能であるわけではない。
.\" It is on at least NetBSD, FreeBSD, OpenBSD, Solaris 8,
.\" AIX 5.1, SunOS 4.1
-.\" .SH Îò»Ë
+.\" .SH 歴史
.\" .BR mincore ()
-.\" ´Ø¿ô¤Ï 4.4BSD ¤Ç½é¤á¤ÆÅо줷¤¿¡£
-.SH ¥Ð¥°
-¥«¡¼¥Í¥ë 2.6.21 ¤è¤êÁ°¤Ï¡¢
+.\" 関数は 4.4BSD で初めて登場した。
+.SH ã\83\90ã\82°
+カーネル 2.6.21 より前は、
.BR mincore ()
-¤Ï¡¢
+は、
.B MAP_PRIVATE
-¥Þ¥Ã¥Ô¥ó¥°¤äÈóÀþ·Á¥Þ¥Ã¥Ô¥ó¥°
+ã\83\9eã\83\83ã\83\94ã\83³ã\82°ã\82\84é\9d\9eç·\9aå½¢ã\83\9eã\83\83ã\83\94ã\83³ã\82°
.RB ( remap_file_pages (2)
-¤ò»È¤Ã¤ÆºîÀ®¤µ¤ì¤ë) ¤Ë¤Ä¤¤¤ÆÀµ¤·¤¤¾ðÊó¤òÊÖ¤µ¤Ê¤«¤Ã¤¿¡£
-.\" Linux ¤Ç¤Ï (2.6.5 ¤Î¸½ºß¤Ë»ê¤ë¤Þ¤Ç)¡¢
+を使って作成される) について正しい情報を返さなかった。
+.\" Linux では (2.6.5 の現在に至るまで)、
.\" .B mincore
-.\" ¤Ï MAP_PRIVATE ¥Þ¥Ã¥Ô¥ó¥°¤Ë¤Ä¤¤¤Æ¤ÎÀµ¤·¤¤¾ðÊó¤òÊÖ¤µ¤Ê¤¤¡£
-.\" MAP_PRIVATE ¥Õ¥¡¥¤¥ë¥Þ¥Ã¥Ô¥ó¥°¤Ë¤Ä¤¤¤Æ¡¢
+.\" は MAP_PRIVATE マッピングについての正しい情報を返さない。
+.\" MAP_PRIVATE ファイルマッピングについて、
.\" .B mincore
-.\" ¤Ï½ñ¤¹þ¤ß»þ¥³¥Ô¡¼ (copy on write) ¤µ¤ì¤Æ¤¤¤Æ
-.\" ½¤Àµ¤µ¤ì¤¿¥×¥í¥»¥¹¤Î¥×¥é¥¤¥Ù¡¼¥È¥Ú¡¼¥¸¤òÊÖ¤¹¤Î¤Ç¤Ï¤Ê¤¯¡¢
-.\" ¥Õ¥¡¥¤¥ë¥Ú¡¼¥¸¤¬Â¸ºß¤¹¤ë¤«Èݤ«¤òÊÖ¤¹¡£
+.\" は書き込み時コピー (copy on write) されていて
+.\" 修正されたプロセスのプライベートページを返すのではなく、
+.\" ファイルページが存在するか否かを返す。
.\" .I /dev/zero
-.\" ¤Î MAP_PRIVATE ¥Þ¥Ã¥Ô¥ó¥°¤Ë¤Ä¤¤¤Æ¡¢
+.\" の MAP_PRIVATE マッピングについて、
.\" .B mincore
-.\" ¤Ï¾ï¤Ë¥Ú¡¼¥¸¤¬Â¸ºß¤·¤Ê¤¤¤È¤¤¤¦Åú¤¨¤òÊÖ¤¹¡£
-.\" MAP_PRIVATE, MAP_ANONYMOUS ¥Þ¥Ã¥Ô¥ó¥°¤Ë¤Ä¤¤¤Æ¡¢
+.\" は常にページが存在しないという答えを返す。
+.\" MAP_PRIVATE, MAP_ANONYMOUS マッピングについて、
.\" .B mincore
-.\" ¤Ï¾ï¤Ë
+.\" は常に
.\" .B ENOMEM
-.\" ¤Ç¼ºÇÔ¤¹¤ë¡£
-.SH ´ØÏ¢¹àÌÜ
+.\" で失敗する。
+.SH 関連項目
.BR mlock (2),
.BR mmap (2)
OSDN Git Service
