X-Git-Url: http://git.osdn.net/view?p=linuxjm%2FLDP_man-pages.git;a=blobdiff_plain;f=release%2Fman2%2Fintro.2;h=9284caa94f5be1e11b61412cae8f8c3625e7877b;hp=bc79eb194e636526f903e0ade5eae652e8f3e40a;hb=83f9e5d087c3464d5131604d3c9893479e6228eb;hpb=7e089fcc022461849bbc09437103cc337a88dd9c diff --git a/release/man2/intro.2 b/release/man2/intro.2 index bc79eb19..9284caa9 100644 --- a/release/man2/intro.2 +++ b/release/man2/intro.2 @@ -1,5 +1,6 @@ .\" Copyright (C) 2007 Michael Kerrisk .\" +.\" %%%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. @@ -19,74 +20,75 @@ .\" .\" Formatted or processed versions of this manual, if unaccompanied by .\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END .\" .\" 2007-10-23 mtk: moved the _syscallN specific material to the .\" new _syscall(2) page, and substantially enhanced and rewrote .\" the remaining material on this page. .\" +.\"******************************************************************* +.\" +.\" This file was generated with po4a. Translate the source file. +.\" +.\"******************************************************************* +.\" .\" Japanese Version Copyright (c) 2008 Akihiro MOTOKI .\" all rights reserved. .\" Translated 2008-02-10, Akihiro MOTOKI -.\" -.TH INTRO 2 2010-09-10 "Linux" "Linux Programmer's Manual" -.SH ̾Á° -intro \- ¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÎÀâÌÀ -.SH ÀâÌÀ -¥Þ¥Ë¥å¥¢¥ë¤Î 2 ¾Ï¤Ç¤Ï Linux ¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤Ä¤¤¤ÆÀâÌÀ¤·¤Æ¤¤¤ë¡£ -¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ¥«¡¼¥Í¥ë¤Ø¤Î¥¨¥ó¥È¥ê¥Ý¥¤¥ó¥È¤Ç¤¢¤ë¡£ -Ä̾ï¤Ï¡¢¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÏľÀܵ¯Æ°¤µ¤ì¤ëÌõ¤Ç¤Ï¤Ê¤¯¡¢ -¤Û¤È¤ó¤É¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤ÏÂбþ¤¹¤ë C ¥é¥¤¥Ö¥é¥ê¤Î¥é¥Ã¥Ñ¡¼´Ø¿ô¤¬¤¢¤ê¡¢ -¤½¤Î¥é¥Ã¥Ñ¡¼´Ø¿ô¤¬¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò¸Æ¤Ó½Ð¤¹¤Î¤ËɬÍפʽèÍý¤ò¼Â¹Ô¤¹¤ë¡£ -¤½¤Î¤¿¤á¡¢¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò¸Æ¤Ó½Ð¤¹¤Î¤ÏÄ̾ï¤Î¥é¥¤¥Ö¥é¥ê´Ø¿ô¤ò¸Æ¤Ó½Ð¤¹¤Î¤È -Ʊ¤¸¤è¤¦¤Ë¸«¤¨¤ë¡£ +.\" +.TH INTRO 2 2014\-02\-20 Linux "Linux Programmer's Manual" +.SH 名前 +intro \- システムコールの説明 +.SH 説明 +マニュアルの 2 章では Linux のシステムコールについて説明している。 システムコールは Linux カーネルへのエントリーポイントである。 +通常は、システムコールは直接起動される訳ではなく、 ほとんどのシステムコールには対応する C ライブラリのラッパー関数があり、 +そのラッパー関数がシステムコールを呼び出すのに必要な処理を実行する。 そのため、システムコールを呼び出すのは通常のライブラリ関数を呼び出すのと +同じように見える。 + +多くの場合、 C ライブラリのラッパー関数が行うのは以下のことだけである。 +.IP * 3 +引き数と一意なシステムコール番号をカーネルが期待するレジスターにコピーする +.IP * +カーネルがシステムコールの実際の処理を行う時点でカーネルモードに入る +.IP * +カーネルが CPU をユーザーモードに返した際にシステムコールがエラー番号を返したいれば \fIerrno\fP を設定する +.LP +しかし、ラッパー関数がこれ以上のことを行う場合もいくつかある。例えば、カーネルモードに入る前に引き数に対する前処理を実行したり、システムコールが返した値に対する後処理を行うなどである。このような場合、セクション +2 のマニュアルページでは、基本的に、C ライブラリ API インターフェース (通常は GNU C ライブラリのもの) +と生のシステムコールの両方の詳細をできるだけ説明しようとする。ほとんどの場合、メインとなる「説明」では C +ライブラリのインターフェースに焦点をあてて説明し、システムコールでの差分については「注意」のセクションに説明がある。 -Linux ¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Î¥ê¥¹¥È¤Ë¤Ä¤¤¤Æ¤Ï -.BR syscalls (2) -¤ò»²¾È¤Î¤³¤È¡£ -.SH ÊÖ¤êÃÍ -¥¨¥é¡¼¤Î¾ì¹ç¡¢¤Û¤È¤ó¤É¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÏÉé¤Î¥¨¥é¡¼ÈÖ¹æ¤òÊÖ¤¹ -(¶ñÂÎŪ¤Ë¤Ï -.BR errno (3) -¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ëÄê¿ô¤Î¤¤¤º¤ì¤«¤òÉé¤Ë¤·¤¿ÃͤòÊÖ¤¹)¡£ -C ¥é¥¤¥Ö¥é¥ê¤Î¥é¥Ã¥Ñ¡¼¤Ï¸Æ¤Ó½Ð¤·¸µ¤«¤é¤³¤¦¤·¤¿¾ÜºÙ¤ò±£Ê䷤Ƥ¤¤ë¡£ -¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬Éé¤ÎÃͤòÊÖ¤·¤¿¾ì¹ç¡¢¥é¥Ã¥Ñ¡¼¤ÏÀäÂÐÃͤò -.I errno -ÊÑ¿ô¤Ë¥³¥Ô¡¼¤·¡¢¥é¥Ã¥Ñ¡¼¤ÎÊÖ¤êÃͤȤ·¤Æ \-1 ¤òÊÖ¤¹¡£ +Linux のシステムコールのリストについては \fBsyscalls\fP(2) を参照のこと。 +.SH 返り値 +エラーの場合、ほとんどのシステムコールは負のエラー番号を返す (具体的には \fBerrno\fP(3) +で説明されている定数のいずれかを負にした値を返す)。 C ライブラリのラッパーは呼び出し元からこうした詳細を隠蔽している。 +システムコールが負の値を返した場合、ラッパーは絶対値を \fIerrno\fP 変数にコピーし、ラッパーの返り値として \-1 を返す。 -À®¸ù»þ¤Ë¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬ÊÖ¤¹Ãͤϥ·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤è¤ê°Û¤Ê¤ë¡£ -¿¤¯¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÏÀ®¸ù»þ¤Ë 0 ¤òÊÖ¤¹¤¬¡¢ -À®¸ù»þ¤Ë 0 °Ê³°¤ÎÃͤòÊÖ¤¹¥·¥¹¥Æ¥à¥³¡¼¥ë¤â¤¢¤ë¡£ -¾ÜºÙ¤Ï¸Ä¡¹¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¡£ +成功時にシステムコールが返す値はシステムコールにより異なる。 多くのシステムコールは成功時に 0 を返すが、 成功時に 0 +以外の値を返すシステムコールもある。 詳細は個々のマニュアルページで説明されている。 -¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î¡Ö½ñ¼°¡×¤ÎÀá¤Ëµ¬Äꤵ¤ì¤¿¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤«¤é´Ø¿ô¤ÎÄêµÁ¤ò -ÆÀ¤ë¤¿¤á¤Ë¡¢¥×¥í¥°¥é¥Þ¤¬µ¡Ç½¸¡ºº¥Þ¥¯¥í¤òÄêµÁ¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¾ì¹ç¤¬¤¢¤ë -(µ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÄêµÁ¤¬É¬Íפʾì¹ç¡¢¤³¤ì¤é¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÄêµÁ¤Ï -¡Ö¤É¤Î¡×¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤Î¥¤¥ó¥¯¥ë¡¼¥É¤è¤ê¤âÁ°¤Ç¹Ô¤ï¤ì¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤)¡£ -¤³¤Î¤è¤¦¤Ê¾ì¹ç¤Ë¤Ï¡¢É¬Íפʥޥ¯¥í¤¬¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¡£ -µ¡Ç½¸¡ºº¥Þ¥¯¥í¤Î¤µ¤é¤Ê¤ë¾ðÊó¤Ë¤Ä¤¤¤Æ¤Ï¡¢ -.BR feature_test_macros (7) -¤ò»²¾È¤Î¤³¤È¡£ -.SH ½àµò -¤³¤Î¾Ï¤Î´Ø¿ô¤¬½àµò¤¹¤ë UNIX ¥·¥¹¥Æ¥à¤äɸ½à¤ò¼¨¤¹¤Î¤Ë¤¤¤¯¤Ä¤«¤Îñ¸ì¤äά¹æ¤¬ -»ÈÍѤµ¤ì¤Æ¤¤¤ë¡£ -.BR standards (7) -¤ò»²¾È¤Î¤³¤È¡£ -.SH Ãí°Õ -.SS "ľÀܸƤӽФ¹" -¤Û¤È¤ó¤É¤Î¾ì¹ç¡¢Ä¾ÀÜ¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò¸Æ¤Ó½Ð¤¹É¬ÍפϤʤ¤¤¬¡¢ -¾ì¹ç¤Ë¤è¤Ã¤Æ¤Ïɸ½à C ¥é¥¤¥Ö¥é¥ê¤ËŬÀڤʴؿô¤¬¼ÂÁõ¤µ¤ì¤Æ¤¤¤Ê¤¤¤³¤È¤â¤¢¤ë¡£ -¤³¤Î¤è¤¦¤Ê¾ì¹ç¤Ï¡¢¥×¥í¥°¥é¥Þ¤Ï -.BR syscall (2) -¤ò»È¤Ã¤Æ¡¢¼«Ê¬¤Ç¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò¸Æ¤Ó½Ð¤µ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£ -²áµî¤Ë¤Ï¡¢ -.BR _syscall (2) -¥Þ¥¯¥í¤Î°ì¤Ä¤ò»È¤Ã¤Æ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Î¸Æ¤Ó½Ð¤¹¤³¤È¤â¤Ç¤­¤¿¡£ -.SS "Ãø¼Ô¤ÈÃøºî¸¢" -Ãø¼Ô¤ÈÃøºî¸¢ (copyright) ¤Ë´Ø¤·¤Æ¤Ï³Æ¥Þ¥Ë¥å¥¢¥ë¡¦¥Ú¡¼¥¸¤Î¥½¡¼¥¹¤Î¥Ø¥Ã¥À¤ò -¸«¤ë¤³¤È¡£¤³¤ì¤é¤Ï¥Ú¡¼¥¸¤´¤È¤Ë°Û¤Ã¤Æ¤¤¤ë¡£ -.SH ´ØÏ¢¹àÌÜ -.BR _syscall (2), -.BR syscall (2), -.BR errno (3), -.BR feature_test_macros (7), -.BR standards (7) +マニュアルページの「書式」の節に規定されたヘッダーファイルから関数の定義を 得るために、プログラマが機能検査マクロを定義しなければならない場合がある +(機能検査マクロの定義が必要な場合、これらの機能検査マクロの定義は 「どの」ヘッダーファイルのインクルードよりも前で行われなければならない)。 +このような場合には、必要なマクロがマニュアルページで説明されている。 機能検査マクロのさらなる情報については、 +\fBfeature_test_macros\fP(7) を参照のこと。 +.SH 準拠 +この章の関数が準拠する UNIX システムや標準を示すのにいくつかの単語や略号が 使用されている。 \fBstandards\fP(7) を参照のこと。 +.SH 注意 +.SS 直接呼び出す +ほとんどの場合、直接システムコールを呼び出す必要はないが、 場合によっては標準 C ライブラリに適切な関数が実装されていないこともある。 +このような場合は、プログラマは \fBsyscall\fP(2) を使って、自分でシステムコールを呼び出さなければならない。 過去には、 +\fB_syscall\fP(2) マクロの一つを使ってシステムコールの呼び出すこともできた。 +.SS 著者と著作権 +著者と著作権に関しては各マニュアルページのソースのヘッダーを参照すること。 これらはページごとに異なる可能性があることに注意してほしい。 +.SH 関連項目 +.ad l +.nh +\fB_syscall\fP(2), \fBsyscall\fP(2), \fBsyscalls\fP(2), \fBerrno\fP(3), \fBintro\fP(3), +\fBcapabilities\fP(7), \fBcredentials\fP(7), \fBfeature_test_macros\fP(7), +\fBmq_overview\fP(7), \fBpath_resolution\fP(7), \fBpipe\fP(7), \fBpty\fP(7), +\fBsem_overview\fP(7), \fBshm_overview\fP(7), \fBsignal\fP(7), \fBsocket\fP(7), +\fBstandards\fP(7), \fBsvipc\fP(7), \fBsymlink\fP(7), \fBtime\fP(7) +.SH この文書について +この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。