OSDN Git Service

(split) LDP: Update draft and release (from the previous commit)
[linuxjm/LDP_man-pages.git] / release / man2 / intro.2
index b8510f2..a68a30e 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.
@@ -19,6 +20,7 @@
 .\"
 .\" 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
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH INTRO 2 2010\-11\-11 Linux "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 2008  Akihiro MOTOKI
+.\"         all rights reserved.
+.\" Translated 2008-02-10, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\"
+.TH INTRO 2 2014\-02\-20 Linux "Linux Programmer's Manual"
 .SH 名前
 intro \- システムコールの説明
 .SH 説明
@@ -38,6 +45,26 @@ intro \- システムコールの説明
 そのラッパー関数がシステムコールを呼び出すのに必要な処理を実行する。 そのため、システムコールを呼び出すのは通常のライブラリ関数を呼び出すのと
 同じように見える。
 
+In many cases, the C library wrapper function does nothing more than:
+.IP * 3
+copying arguments and the unique system call number to the registers where
+the kernel expects them;
+.IP *
+trapping to kernel mode, at which point the kernel does the real work of the
+system call; and
+.IP *
+setting \fIerrno\fP if the system call returns an error number when the kernel
+returns the CPU to user mode.
+.LP
+However, in a few cases, a wrapper function may do rather more than this,
+for example, performing some preprocessing of the arguments of arguments
+before trapping to kernel mode, or postprocessing of values returned by the
+system call.  Where this is the case, the manual pages in Section 2
+generally try to note the details of both the (usually GNU) C library API
+interface and the raw system call.  Most commonly, the main DESCRIPTION will
+focus on the C library interface, and differences for the system call are
+covered in the NOTES section.
+
 Linux のシステムコールのリストについては \fBsyscalls\fP(2)  を参照のこと。
 .SH 返り値
 エラーの場合、ほとんどのシステムコールは負のエラー番号を返す (具体的には \fBerrno\fP(3)
@@ -69,6 +96,6 @@ Linux のシステムコールのリストについては \fBsyscalls\fP(2)  を
 \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.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.63 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。