(split) LDP: Update draft and release (from the previous commit)

[linuxjm/LDP_man-pages.git] / release / man2 / link.2

diff --git a/release/man2/link.2 b/release/man2/link.2
index 10083d4..80c019b 100644 (file)
--- a/release/man2/link.2
+++ b/release/man2/link.2
@@ -105,19 +105,17 @@ _ATFILE_SOURCE
 \fBAT_EMPTY_PATH\fP (Linux 2.6.39 以降)
 .\" commit 11a7b371b64ef39fc5fb1b6f2218eef7c4d035e3
 .\" Before glibc 2.16, defining _ATFILE_SOURCE sufficed
-If \fIoldpath\fP is an empty string, create a link to the file referenced by
-\fIolddirfd\fP (which may have been obtained using the \fBopen\fP(2)  \fBO_PATH\fP
-flag).  In this case, \fIolddirfd\fP must refer to a file other than a
-directory.  The caller must have the \fBCAP_DAC_READ_SEARCH\fP capability in
-order to use this flag; this prevents arbitrary users from creating hard
-links using file descriptors received via a UNIX domain socket (see the
-discussion of \fBSCM_RIGHTS\fP in \fBunix\fP(7)).  This flag is Linux\-specific;
-define \fB_GNU_SOURCE\fP to obtain its definition.
+\fIoldpath\fP が空文字列の場合、 \fIolddirfd\fP が参照するファイルへのリンクを作成する (\fIolddirfd\fP は
+\fBopen\fP(2) の \fBO_PATH\fP フラグを使って取得する)。 この場合、 \fIolddirfd\fP
+はディレクトリではなくファイルを参照していなければならない。 このフラグを使用するためには、 呼び出し元は \fBCAP_DAC_READ_SEARCH\fP
+ケーパビリティを持っていなければならない。 これにより、 任意のユーザーが UNIX
+ドメインソケット経由で受信したファイルディスクリプターを使ってハードリンクを作成することがないようになっている (\fBunix\fP(7) の
+\fBSCM_RIGHTS\fP の議論を参照)。 このフラグは Linux 固有で、 この定義を得るには \fB_GNU_SOURCE\fP を定義すること。
 .TP 
 \fBAT_SYMLINK_FOLLOW\fP (Linux 2.6.18 以降)
-By default, \fBlinkat\fP(), does not dereference \fIoldpath\fP if it is a symbolic
-link (like \fBlink\fP()).  The flag \fBAT_SYMLINK_FOLLOW\fP can be specified in
-\fIflags\fP to cause \fIoldpath\fP to be dereferenced if it is a symbolic link.
+\fBlinkat\fP() は (\fBlink\fP() 同様) デフォルトでは \fIoldpath\fP がシンボリックリンクの場合リンクの展開を行わない。
+フラグ \fBAT_SYMLINK_FOLLOW\fP を \fIflags\fP に指定することができ、指定した場合 \fIoldpath\fP
+がシンボリックリンクの場合リンクの展開が行われる。
 .PP
 カーネル 2.6.18 より前では、 \fIflags\fP 引き数は未使用で、 0 を指定しなければならなかった。
 .PP
@@ -194,8 +192,7 @@ I/O エラーが発生した。
 ケーパビリティを持っていなかった。
 .TP 
 \fBENOENT\fP
-An attempt was made to link to the \fI/proc/self/fd/NN\fP file corresponding to
-a file descriptor created with
+以下の呼び出しで作成されたファイルディスクリプターに対応する \fI/proc/self/fd/NN\fP ファイルに対してリンクを行おおうとした。
 
     open(path, O_TMPFILE | O_EXCL, mode);
 
@@ -206,8 +203,8 @@ a file descriptor created with
 \fInewdirfd\fP に関して同じ状況である。
 .TP 
 \fBEPERM\fP
-\fBAT_EMPTY_PATH\fP was specified in \fIflags\fP, \fIoldpath\fP is an empty string,
-and \fIolddirfd\fP refers to a directory.
+\fIflags\fP に \fBAT_EMPTY_PATH\fP が指定され、 \fIoldpath\fP が空文字列で、 \fIolddirfd\fP
+がディレクトリを参照している。
 .SH バージョン
 \fBlinkat\fP()  はカーネル 2.6.16 で Linux に追加された。 ライブラリによるサポートはバージョン 2.4 で glibc
 に追加された。