OSDN Git Service

(split) LDP: Update the version to 3.53 in PO files
[linuxjm/LDP_man-pages.git] / draft / man2 / intro.2
index 5acf3f2..2648243 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright (C) 2007 Michael Kerrisk <mtk.manpages@gmail.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
 .\"
 .\" 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.
 .\"
-.\" Japanese Version Copyright (c) 2008  Akihiro MOTOKI
-.\"         all rights reserved.
-.\" Translated 2008-02-10, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" 
-.TH INTRO 2 2010-02-03 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O intro \- Introduction to system calls
-intro \- ¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÎÀâÌÀ
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O Section 2 of the manual describes the Linux system calls.
-.\"O A system call is an entry point into the Linux kernel.
-.\"O Usually, system calls are not invoked directly:
-.\"O instead, most system calls have corresponding C library
-.\"O wrapper functions which perform the steps required
-.\"O (e.g., trapping to kernel mode) in order to invoke
-.\"O the system call.
-.\"O Thus, making a system call looks the same as invoking a normal
-.\"O library function.
-¥Þ¥Ë¥å¥¢¥ë¤Î 2 ¾Ï¤Ç¤Ï Linux ¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤Ä¤¤¤ÆÀâÌÀ¤·¤Æ¤¤¤ë¡£
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ¥«¡¼¥Í¥ë¤Ø¤Î¥¨¥ó¥È¥ê¥Ý¥¤¥ó¥È¤Ç¤¢¤ë¡£
-Ä̾ï¤Ï¡¢¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÏľÀܵ¯Æ°¤µ¤ì¤ëÌõ¤Ç¤Ï¤Ê¤¯¡¢
-¤Û¤È¤ó¤É¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤ÏÂбþ¤¹¤ë C ¥é¥¤¥Ö¥é¥ê¤Î¥é¥Ã¥Ñ¡¼´Ø¿ô¤¬¤¢¤ê¡¢
-¤½¤Î¥é¥Ã¥Ñ¡¼´Ø¿ô¤¬¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò¸Æ¤Ó½Ð¤¹¤Î¤ËɬÍפʽèÍý¤ò¼Â¹Ô¤¹¤ë¡£
-¤½¤Î¤¿¤á¡¢¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò¸Æ¤Ó½Ð¤¹¤Î¤ÏÄ̾ï¤Î¥é¥¤¥Ö¥é¥ê´Ø¿ô¤ò¸Æ¤Ó½Ð¤¹¤Î¤È
-Ʊ¤¸¤è¤¦¤Ë¸«¤¨¤ë¡£
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH INTRO 2 2010\-11\-11 Linux "Linux Programmer's Manual"
+.SH 名前
+intro \- システムコールの説明
+.SH 説明
+マニュアルの 2 章では Linux のシステムコールについて説明している。 システムコールは Linux カーネルへのエントリポイントである。
+通常は、システムコールは直接起動される訳ではなく、 ほとんどのシステムコールには対応する C ライブラリのラッパー関数があり、
+そのラッパー関数がシステムコールを呼び出すのに必要な処理を実行する。 そのため、システムコールを呼び出すのは通常のライブラリ関数を呼び出すのと
+同じように見える。
 
-.\"O For a list of the Linux system calls, see
-.\"O .BR syscalls (2).
-Linux ¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Î¥ê¥¹¥È¤Ë¤Ä¤¤¤Æ¤Ï
-.BR syscalls (2)
-¤ò»²¾È¤Î¤³¤È¡£
-.\"O .SH RETURN VALUE
-.SH ÊÖ¤êÃÍ
-.\"O On error, most system calls return a negative error number
-.\"O (i.e., the negated value of one of the constants described in
-.\"O .BR errno (3)).
-.\"O The C library wrapper hides this detail from the caller: when a
-.\"O system call returns a negative value, the wrapper copies the
-.\"O absolute value into the
-.\"O .I errno
-.\"O variable, and returns \-1 as the return value of the wrapper.
-¥¨¥é¡¼¤Î¾ì¹ç¡¢¤Û¤È¤ó¤É¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÏÉé¤Î¥¨¥é¡¼ÈÖ¹æ¤òÊÖ¤¹
-(¶ñÂÎŪ¤Ë¤Ï
-.BR errno (3)
-¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ëÄê¿ô¤Î¤¤¤º¤ì¤«¤òÉé¤Ë¤·¤¿ÃͤòÊÖ¤¹)¡£
-C ¥é¥¤¥Ö¥é¥ê¤Î¥é¥Ã¥Ñ¡¼¤Ï¸Æ¤Ó½Ð¤·¸µ¤«¤é¤³¤¦¤·¤¿¾ÜºÙ¤ò±£Ê䷤Ƥ¤¤ë¡£
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬Éé¤ÎÃͤòÊÖ¤·¤¿¾ì¹ç¡¢¥é¥Ã¥Ñ¡¼¤ÏÀäÂÐÃͤò
-.I errno
-ÊÑ¿ô¤Ë¥³¥Ô¡¼¤·¡¢¥é¥Ã¥Ñ¡¼¤ÎÊÖ¤êÃͤȤ·¤Æ \-1 ¤òÊÖ¤¹¡£
+Linux のシステムコールのリストについては \fBsyscalls\fP(2)  を参照のこと。
+.SH 返り値
+エラーの場合、ほとんどのシステムコールは負のエラー番号を返す (具体的には \fBerrno\fP(3)
+で説明されている定数のいずれかを負にした値を返す)。 C ライブラリのラッパーは呼び出し元からこうした詳細を隠蔽している。
+システムコールが負の値を返した場合、ラッパーは絶対値を \fIerrno\fP 変数にコピーし、ラッパーの返り値として \-1 を返す。
 
-.\"O The value returned by a successful system call depends on the call.
-.\"O Many system calls return 0 on success, but some can return nonzero
-.\"O values from a successful call.
-.\"O The details are described in the individual manual pages.
-À®¸ù»þ¤Ë¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬ÊÖ¤¹Ãͤϥ·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤è¤ê°Û¤Ê¤ë¡£
-¿¤¯¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÏÀ®¸ù»þ¤Ë 0 ¤òÊÖ¤¹¤¬¡¢
-À®¸ù»þ¤Ë 0 °Ê³°¤ÎÃͤòÊÖ¤¹¥·¥¹¥Æ¥à¥³¡¼¥ë¤â¤¢¤ë¡£
-¾ÜºÙ¤Ï¸Ä¡¹¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¡£
+成功時にシステムコールが返す値はシステムコールにより異なる。 多くのシステムコールは成功時に 0 を返すが、 成功時に 0
+以外の値を返すシステムコールもある。 詳細は個々のマニュアルページで説明されている。
 
-.\"O In some cases,
-.\"O the programmer must define a feature test macro in order to obtain
-.\"O the declaration of a system call from the header file specified
-.\"O in the man page SYNOPSIS section.
-.\"O In such cases, the required macro is described in the man page.
-.\"O For further information on feature test macros, see
-.\"O .BR feature_test_macros (7).
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î¡Ö½ñ¼°¡×¤ÎÀá¤Ëµ¬Äꤵ¤ì¤¿¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤«¤é´Ø¿ô¤ÎÄêµÁ¤ò
-ÆÀ¤ë¤¿¤á¤Ë¡¢¥×¥í¥°¥é¥Þ¤¬µ¡Ç½¸¡ºº¥Þ¥¯¥í¤òÄêµÁ¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¾ì¹ç¤¬¤¢¤ë¡£
-¤³¤Î¤è¤¦¤Ê¾ì¹ç¤Ë¤Ï¡¢É¬Íפʥޥ¯¥í¤¬¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¡£
-µ¡Ç½¸¡ºº¥Þ¥¯¥í¤Î¤µ¤é¤Ê¤ë¾ðÊó¤Ë¤Ä¤¤¤Æ¤Ï¡¢
-.BR feature_test_macros (7)
-¤ò»²¾È¤Î¤³¤È¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O Certain terms and abbreviations are used to indicate Unix variants
-.\"O and standards to which calls in this section conform.
-.\"O See
-.\"O .BR standards (7).
-¤³¤Î¾Ï¤Î´Ø¿ô¤¬½àµò¤¹¤ë Unix ¥·¥¹¥Æ¥à¤äɸ½à¤ò¼¨¤¹¤Î¤Ë¤¤¤¯¤Ä¤«¤Îñ¸ì¤äά¹æ¤¬
-»ÈÍѤµ¤ì¤Æ¤¤¤ë¡£
-.BR standards (7)
-¤ò»²¾È¤Î¤³¤È¡£
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O .SS "Calling Directly"
-.SS "ľÀܸƤӽФ¹"
-.\"O In most cases, it is unnecessary to invoke a system call directly,
-.\"O but there are times when the Standard C library does not implement
-.\"O a nice wrapper function for you.
-.\"O In this case, the programmer must manually invoke the system call using
-.\"O .BR syscall (2).
-.\"O Historically, this was also possible using one of the _syscall macros
-.\"O described in
-.\"O .BR _syscall (2).
-¤Û¤È¤ó¤É¤Î¾ì¹ç¡¢Ä¾ÀÜ¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò¸Æ¤Ó½Ð¤¹É¬ÍפϤʤ¤¤¬¡¢
-¾ì¹ç¤Ë¤è¤Ã¤Æ¤Ïɸ½à C ¥é¥¤¥Ö¥é¥ê¤ËŬÀڤʴؿô¤¬¼ÂÁõ¤µ¤ì¤Æ¤¤¤Ê¤¤¤³¤È¤â¤¢¤ë¡£
-¤³¤Î¤è¤¦¤Ê¾ì¹ç¤Ï¡¢¥×¥í¥°¥é¥Þ¤Ï
-.BR syscall (2)
-¤ò»È¤Ã¤Æ¡¢¼«Ê¬¤Ç¥·¥¹¥Æ¥à¥³¡¼¥ë¤ò¸Æ¤Ó½Ð¤µ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-²áµî¤Ë¤Ï¡¢
-.BR _syscall (2)
-¥Þ¥¯¥í¤Î°ì¤Ä¤ò»È¤Ã¤Æ¥·¥¹¥Æ¥à¥³¡¼¥ë¤Î¸Æ¤Ó½Ð¤¹¤³¤È¤â¤Ç¤­¤¿¡£
-.\"O .SS Authors and Copyright Conditions
-.SS "Ãø¼Ô¤ÈÃøºî¸¢"
-.\"O Look at the header of the manual page source for the author(s) and copyright
-.\"O conditions.
-.\"O Note that these can be different from page to page!
-Ãø¼Ô¤ÈÃøºî¸¢ (copyright) ¤Ë´Ø¤·¤Æ¤Ï³Æ¥Þ¥Ë¥å¥¢¥ë¡¦¥Ú¡¼¥¸¤Î¥½¡¼¥¹¤Î¥Ø¥Ã¥À¤ò
-¸«¤ë¤³¤È¡£¤³¤ì¤é¤Ï¥Ú¡¼¥¸¤´¤È¤Ë°Û¤Ã¤Æ¤¤¤ë¡£
-.\"O .SH "SEE ALSO"
-.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.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。