.\" Modified 2004-06-23 by Michael Kerrisk <mtk.manpages@gmail.com>
.\" Modified 2005-04-04, as per suggestion by Michael Hardt for rename.2
.\"
-.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
-.\" all rights reserved.
-.\" Translated Thu Dec 11 23:47:55 JST 1997
-.\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
-.\" Updated & Modified Tue Feb 8 06:36:08 JST 2005
-.\" by Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated & Modified Fri Apr 22 02:05:00 JST 2005 by Yuichi SATO
-.\" Updated 2008-09-07, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.08
+.\"*******************************************************************
.\"
-.\"WORD: link リンク
-.\"WORD: hard link ハード・リンク
-.\"WORD: overwrite 上書き
-.\"WORD: permission 許可(permission)
-.\"WORD: ownership 所有者(ownership)
-.\"WORD: file system ファイル・システム
-.\"WORD: effective uid 実効ユーザーID
-.\"WORD: kernel カーネル
-.\"WORD: symbolic link シンボリック・リンク
-.\"WORD: dangling symbolic link 壊れたシンボリック・リンク
-.\"WORD: directory entry ディレクトリ・エントリ
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH LINK 2 2008-08-21 "Linux" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH LINK 2 2008\-08\-21 Linux "Linux Programmer's Manual"
.SH 名前
link \- ファイルの新しい名前を作成する
.SH 書式
-.B #include <unistd.h>
+\fB#include <unistd.h>\fP
.sp
-.BI "int link(const char *" oldpath ", const char *" newpath );
+\fBint link(const char *\fP\fIoldpath\fP\fB, const char *\fP\fInewpath\fP\fB);\fP
.SH 説明
-.BR link ()
-は存在するファイルへの新しいリンク (link)
-(ハード・リンク (hard link) ともいう) を作成する。
+\fBlink\fP() は存在するファイルへの新しいリンク (link) (ハードリンク (hard link) ともいう) を作成する。
-.I newpath
-が存在する場合には上書きは\fIされない\fR。
+\fInewpath\fP が存在する場合には上書きは\fIされない\fP。
-この新しい名前は全ての操作において古い名前と完全に同じように使用される;
-両方の名前は同じファイルを参照しており
-(それで同じ許可 (permission) や所有者 (ownership) となるので)、
-どちらの名前が本来のものであるか判別できない。
+この新しい名前は全ての操作において古い名前と完全に同じように使用される; 両方の名前は同じファイルを参照しており (それで同じ許可
+(permission) や所有者 (ownership) となるので)、 どちらの名前が本来のものであるか判別できない。
.SH 返り値
-成功した場合は 0 が返される。エラーの場合は \-1 が返され、
-.I errno
-が適切に設定される。
+成功した場合は 0 が返される。エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
.SH エラー
-.TP
-.B EACCES
-.I newpath
-を含んでいるディレクトリへの書き込みが許されていないか、
-.I oldpath
-または
-.I newpath
-へのディレクトリのどれかに検索許可がない
-.RB ( path_resolution (7)
-を参照)。
-.TP
-.B EEXIST
-.I newpath
-が既に存在する。
-.TP
-.B EFAULT
-.IR oldpath " または " newpath "
-がアクセス可能なアドレス空間の外を指している。
-.TP
-.B EIO
+.TP
+\fBEACCES\fP
+\fInewpath\fP を含んでいるディレクトリへの書き込みが許されていないか、 \fIoldpath\fP または \fInewpath\fP
+へのディレクトリのどれかに検索許可がない (\fBpath_resolution\fP(7) を参照)。
+.TP
+\fBEEXIST\fP
+\fInewpath\fP が既に存在する。
+.TP
+\fBEFAULT\fP
+\fIoldpath\fP や \fInewpath\fP がアクセス可能なアドレス空間の外を指している。
+.TP
+\fBEIO\fP
I/O エラーが発生した。
-.TP
-.B ELOOP
-.IR oldpath " または " newpath
-を解決する際に遭遇したシンボリック・リンクが多過ぎる。
-.TP
-.B EMLINK
-.I oldpath
-によって参照されるファイルは
-既に最大数までのリンクを持っている。
-.TP
-.B ENAMETOOLONG
-.IR oldpath " または " newpath "
-が長過ぎる。
-.TP
-.B ENOENT
-.IR oldpath " または " newpath
-のディレクトリ部分が存在しないか、
-壊れた(dangling)シンボリック・リンクである。
-.TP
-.B ENOMEM
-カーネルに十分なメモリがない。
-.TP
-.B ENOSPC
-そのファイルを含んでいるデバイスに新しいディレクトリ・エントリを
-作成するための空きがない。
-.TP
-.B ENOTDIR
-.IR oldpath " または " newpath
-のディレクトリ部分が、実際には、ディレクトリでない。
-.TP
-.B EPERM
-.I oldpath
-がディレクトリである。
-.TP
-.B EPERM
-.IR oldpath " と " newpath
-を含んでいるファイル・システムがハード・リンクをサポートしていない。
-.TP
-.B EROFS
-ファイルが読み込み専用のファイル・システムに存在する。
-.TP
-.B EXDEV
-.IR oldpath " と " newpath
-が同じマウントされたファイル・システムに存在しない。
-(Linux は 1 つのファイル・システムを複数のマウント位置に
-マウントすることを許可している。
-しかし
-.BR link ()
-は、たとえ同じファイル・システムであっても、
+.TP
+\fBELOOP\fP
+\fIoldpath\fP または \fInewpath\fP を解決する際に遭遇したシンボリックリンクが多過ぎる。
+.TP
+\fBEMLINK\fP
+\fIoldpath\fP によって参照されるファイルは 既に最大数までのリンクを持っている。
+.TP
+\fBENAMETOOLONG\fP
+\fIoldpath\fP または \fInewpath\fP が長過ぎる。
+.TP
+\fBENOENT\fP
+\fIoldpath\fP または \fInewpath\fP のディレクトリ部分が存在しないか、 壊れた(dangling)シンボリックリンクである。
+.TP
+\fBENOMEM\fP
+十分なカーネルメモリーがない。
+.TP
+\fBENOSPC\fP
+そのファイルを含んでいるデバイスに新しいディレクトリエントリを 作成するための空きがない。
+.TP
+\fBENOTDIR\fP
+\fIoldpath\fP または \fInewpath\fP のディレクトリ部分が、実際には、ディレクトリでない。
+.TP
+\fBEPERM\fP
+\fIoldpath\fP がディレクトリである。
+.TP
+\fBEPERM\fP
+\fIoldpath\fP と \fInewpath\fP を含んでいるファイルシステムがハードリンクをサポートしていない。
+.TP
+\fBEROFS\fP
+ファイルが読み込み専用のファイルシステムに存在する。
+.TP
+\fBEXDEV\fP
+\fIoldpath\fP と \fInewpath\fP が同じマウントされたファイルシステムに存在しない。 (Linux は 1
+つのファイルシステムを複数のマウント位置に マウントすることを許可している。 しかし \fBlink\fP() は、たとえ同じファイルシステムであっても、
別々のマウント位置を跨いでは動作しない。)
.SH 準拠
-SVr4, 4.3BSD, POSIX.1-2001 (但し「注意」を参照)。
-.\" SVr4 は他に ENOLINK, EMULTIHOP エラー状態についても記述している。
-.\" POSIX.1 には ELOOP についての記述はない。
-.\" X/OPEN には EFAULT, ENOMEM, EIO についての記述はない。
+.\" SVr4 documents additional ENOLINK and
+.\" EMULTIHOP error conditions; POSIX.1 does not document ELOOP.
+.\" X/OPEN does not document EFAULT, ENOMEM or EIO.
+SVr4, 4.3BSD, POSIX.1\-2001 (但し「注意」を参照)。
.SH 注意
-.BR link ()
-でファイル・システムを超えてハード・リンクを作成することはできない。
-このような場合は
-.BR symlink (2)
-を使用すること。
+\fBlink\fP() でファイルシステムを超えてハードリンクを作成することはできない。 このような場合は \fBsymlink\fP(2) を使用すること。
-POSIX.1-2001 では、
-.I oldpath
-がシンボリック・リンクである場合、
-.BR link ()
-は
-.I oldpath
-の参照を解決すべきであると記述されている。
-しかし、カーネル 2.0 以降の
-.\" 正確にはカーネル 1.3.56 以降
-Linux ではそのようになっていない。
-.I oldpath
-がシンボリック・リンクである場合、
-.I newpath
-は同じシンボリック・リンクファイルへの (ハード) リンクとして作成される
-(つまり
-.I newpath
-は
-.I oldpath
-が参照していた同じファイルへのシンボリックリンクになる)。
-他のいくつかの実装でも Linux と同じように動作する。
-.\" 例えば、デフォルトの Solaris のコンパイル環境では
-.\" Linux と同じように動作する。そして Austin メーリングリストの
-.\" 2005 年 3 月のスレッドに投稿した人たちは、
-.\" その他のいくつかの (System V) 実装でも同じであった/ある、
-.\" と報告している -- MTK, Apr 05
-POSIX.1-2008 では
-.BR link ()
-の仕様が変更され、
-.I oldpath
-がシンボリック・リンクの場合にシンボリック・リンクの参照を
-解決するかどうかは実装依存となった。
-リンク作成時のシンボリック・リンクの扱いについての詳細な制御に
-関しては
-.BR linkat (2)
-を参照のこと。
+.\" more precisely: since kernel 1.3.56
+.\" For example, the default Solaris compilation environment
+.\" behaves like Linux, and contributors to a March 2005
+.\" thread in the Austin mailing list reported that some
+.\" other (System V) implementations did/do the same -- MTK, Apr 05
+POSIX.1\-2001 では、 \fIoldpath\fP がシンボリックリンクである場合、 \fBlink\fP() は \fIoldpath\fP
+の参照を解決すべきであると記述されている。 しかし、カーネル 2.0 以降の Linux ではそのようになっていない。 \fIoldpath\fP
+がシンボリックリンクである場合、 \fInewpath\fP は同じシンボリックリンクファイルへの (ハード) リンクとして作成される (つまり
+\fInewpath\fP は \fIoldpath\fP が参照していた同じファイルへのシンボリックリンクになる)。 他のいくつかの実装でも Linux
+と同じように動作する。 POSIX.1\-2008 では \fBlink\fP() の仕様が変更され、 \fIoldpath\fP
+がシンボリックリンクの場合にシンボリックリンクの参照を 解決するかどうかは実装依存となった。
+リンク作成時のシンボリックリンクの扱いについての詳細な制御に 関しては \fBlinkat\fP(2) を参照のこと。
.SH バグ
-NFS ファイル・システムでは、NFS サーバーがリンクを作成した後に、
-それを伝える前に死んだ場合には返り値が不正な場合がある。
-リンクが作成できたかどうか見つけるためには
-.BR stat (2)
-を使用すること。
+NFS ファイルシステムでは、NFS サーバーがリンクを作成した後に、 それを伝える前に死んだ場合には返り値が不正な場合がある。
+リンクが作成できたかどうか見つけるためには \fBstat\fP(2) を使用すること。
.SH 関連項目
-.BR ln (1),
-.BR linkat (2),
-.BR open (2),
-.BR rename (2),
-.BR stat (2),
-.BR symlink (2),
-.BR unlink (2),
-.BR path_resolution (7),
-.BR symlink (7)
+\fBln\fP(1), \fBlinkat\fP(2), \fBopen\fP(2), \fBrename\fP(2), \fBstat\fP(2), \fBsymlink\fP(2),
+\fBunlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\fP(7)
OSDN Git Service
