.\"
.\" FIXME: Linux 2.6.39 added AT_EMPTY_PATH
.\"
-.\" Japanese Version Copyright (c) 2006 Yuichi SATO
-.\" all rights reserved.
-.\" Translated 2006-09-30 by Yuichi SATO <ysato444@yahoo.co.jp>, LDP v2.39
+.\"*******************************************************************
.\"
-.TH LINKAT 2 2009-12-13 "Linux" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH LINKAT 2 2009\-12\-13 Linux "Linux Programmer's Manual"
.SH 名前
-linkat \- ディレクトリファイルディスクリプタから相対的な位置にファイルリンクを作成する
+linkat \- ディレクトリファイルディスクリプタから相対的な位置にファイルリンクを作成する
.SH 書式
.nf
-.B #include <fcntl.h> /* AT_* 定数の定義 */
-.B #include <unistd.h>
+\fB#include <fcntl.h> /* AT_* 定数の定義 */\fP
+\fB#include <unistd.h>\fP
.sp
-.BI "int linkat(int " olddirfd ", const char *" oldpath ,
-.BI " int " newdirfd ", const char *" newpath ", int " flags );
+\fBint linkat(int \fP\fIolddirfd\fP\fB, const char *\fP\fIoldpath\fP\fB,\fP
+\fB int \fP\fInewdirfd\fP\fB, const char *\fP\fInewpath\fP\fB, int \fP\fIflags\fP\fB);\fP
.fi
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
-.BR linkat ():
+\fBlinkat\fP():
.PD 0
.ad l
.RS 4
-.TP 4
+.TP 4
glibc 2.10 以降:
_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
-.TP
+.TP
glibc 2.10 より前:
_ATFILE_SOURCE
.RE
.ad
.PD
.SH 説明
-.BR linkat ()
-システムコールは、この man ページで説明する違い以外は、
-.BR link (2)
-と全く同じように動作する。
+\fBlinkat\fP() システムコールは、この man ページで説明する違い以外は、 \fBlink\fP(2) と全く同じように動作する。
-.I oldpath
-で指定されるパス名が相対パス名である場合、
-ファイルディスクリプタ
-.I olddirfd
-で参照されるディレクトリからの相対パス名として解釈される
-.RB ( link (2)
-では、相対パスは呼び出し元プロセスの
+\fIoldpath\fP で指定されるパス名が相対パス名である場合、 ファイルディスクリプタ \fIolddirfd\fP
+で参照されるディレクトリからの相対パス名として解釈される (\fBlink\fP(2) では、相対パスは呼び出し元プロセスの
カレントワーキングディレクトリからの相対パスとなる)。
-.I oldpath
-が相対パスであり、かつ
-.I olddirfd
-が特別な値
-.B AT_FDCWD
-である場合、
-.I oldpath
-は
-.RB ( link (2)
-と同じように) 呼び出し元プロセスの
-カレントワーキングディレクトリからの相対パス名として解釈される。
+\fIoldpath\fP が相対パスであり、かつ \fIolddirfd\fP が特別な値 \fBAT_FDCWD\fP である場合、 \fIoldpath\fP は
+(\fBlink\fP(2) と同じように) 呼び出し元プロセスの カレントワーキングディレクトリからの相対パス名として解釈される。
-.I oldpath
-が絶対パスである場合、
-.I olddirfd
-は無視される。
+\fIoldpath\fP が絶対パスである場合、 \fIolddirfd\fP は無視される。
-.I newpath
-の解釈は
-.I oldpath
-と同様であるが、
-相対パス名はファイルディスクリプタ
-.I newdirfd
+\fInewpath\fP の解釈は \fIoldpath\fP と同様であるが、 相対パス名はファイルディスクリプタ \fInewdirfd\fP
で参照されるディレクトリからの相対パス名として解釈される。
-デフォルトでは、
-.I oldpath
-がシンボリック・リンクの場合、
-.RB ( link (2)
-同様)
-.BR linkat ()
-は
-.I oldpath
-の参照の解決を行わない。
-Linux 2.6.18 以降では、
-.B AT_SYMLINK_FOLLOW
-フラグを
-.I flags
-に指定することができる。このフラグを指定すると、
-.I oldpath
-がシンボリック・リンクの場合、
-.I oldpath
-の参照の解決を行う。
-2.6.18 以前のカーネルでは、
-.I flags
-引き数は使用されず、
-0 を指定しなければならなかった。
+デフォルトでは、 \fIoldpath\fP がシンボリック・リンクの場合、 (\fBlink\fP(2) 同様) \fBlinkat\fP() は
+\fIoldpath\fP の参照の解決を行わない。 Linux 2.6.18 以降では、 \fBAT_SYMLINK_FOLLOW\fP フラグを
+\fIflags\fP に指定することができる。このフラグを指定すると、 \fIoldpath\fP がシンボリック・リンクの場合、 \fIoldpath\fP
+の参照の解決を行う。 2.6.18 以前のカーネルでは、 \fIflags\fP 引き数は使用されず、 0 を指定しなければならなかった。
.SH 返り値
-成功した場合、
-.BR linkat ()
-は 0 を返す。
-エラーの場合、\-1 が返されて、
-.I errno
-にはエラーを示す値が設定される。
+成功した場合、 \fBlinkat\fP() は 0 を返す。 エラーの場合、\-1 が返されて、 \fIerrno\fP にはエラーを示す値が設定される。
.SH エラー
-.BR link (2)
-と同じエラーが
-.BR linkat ()
-でも起こる。
-.BR linkat ()
-では、その他に以下のエラーが起こる:
-.TP
-.B EBADF
-.I olddirfd
-または
-.I newdirfd
-が有効なファイルディスクリプタでない。
-.TP
-.B ENOTDIR
-.I oldpath
-が相対パスで、かつ
-.I olddirfd
-がディレクトリ以外のファイルを参照するファイルディスクリプタである。
-または
-.I newpath
-と
-.I newdirfd
-について、同様のことが起きている。
+\fBlink\fP(2) と同じエラーが \fBlinkat\fP() でも起こる。 \fBlinkat\fP() では、その他に以下のエラーが起こる:
+.TP
+\fBEBADF\fP
+\fIolddirfd\fP または \fInewdirfd\fP が有効なファイルディスクリプタでない。
+.TP
+\fBENOTDIR\fP
+\fIoldpath\fP が相対パスで、かつ \fIolddirfd\fP がディレクトリ以外のファイルを参照するファイルディスクリプタである。 または
+\fInewpath\fP と \fInewdirfd\fP について、同様のことが起きている。
.SH バージョン
-.BR linkat ()
-は Linux カーネル 2.6.16 で追加された。
+\fBlinkat\fP() は Linux カーネル 2.6.16 で追加された。
.SH 準拠
-POSIX.1-2008.
+POSIX.1\-2008.
.SH 注意
-.BR linkat ()
-が必要な理由については、
-.BR openat (2)
-を参照すること。
+\fBlinkat\fP() が必要な理由については、 \fBopenat\fP(2) を参照すること。
.SH 関連項目
-.BR link (2),
-.BR openat (2),
-.BR path_resolution (7),
-.BR symlink (7)
+\fBlink\fP(2), \fBopenat\fP(2), \fBpath_resolution\fP(7), \fBsymlink\fP(7)
OSDN Git Service
