.\" Updated & Modifed Sat Feb 12 11:20:18 JST 2005
.\" by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
-.\"WORD: symbolic link ¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯
-.\"WORD: directory ¥Ç¥£¥ì¥¯¥È¥ê
-.\"WORD: soft link ¥½¥Õ¥È¡¦¥ê¥ó¥¯
-.\"WORD: hard link ¥Ï¡¼¥É¡¦¥ê¥ó¥¯
-.\"WORD: dangling link ²õ¤ì¤¿¥ê¥ó¥¯
-.\"WORD: sticky bit ¥¹¥Æ¥£¥Ã¥¡¼¡¦¥Ó¥Ã¥È
-.\"WORD: ownership ½ê͸¢
-.\"WORD: file system ¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à
-.\"WORD: effective uid ¼Â¸ú¥æ¡¼¥¶¡¼ID
-.\"WORD: kernel ¥«¡¼¥Í¥ë
-.\"WORD: entry ¥¨¥ó¥È¥ê
+.\"WORD: symbolic link ã\82·ã\83³ã\83\9cã\83ªã\83\83ã\82¯ã\83»ã\83ªã\83³ã\82¯
+.\"WORD: directory ディレクトリ
+.\"WORD: soft link ã\82½ã\83\95ã\83\88ã\83»ã\83ªã\83³ã\82¯
+.\"WORD: hard link ã\83\8fã\83¼ã\83\89ã\83»ã\83ªã\83³ã\82¯
+.\"WORD: dangling link å£\8aã\82\8cã\81\9fã\83ªã\83³ã\82¯
+.\"WORD: sticky bit スティッキー・ビット
+.\"WORD: ownership 所有権
+.\"WORD: file system ファイル・システム
+.\"WORD: effective uid å®\9få\8a¹ã\83¦ã\83¼ã\82¶ã\83¼ID
+.\"WORD: kernel カーネル
+.\"WORD: entry エントリ
.\"
.TH SYMLINK 2 2010-09-20 "Linux" "Linux Programmer's Manual"
-.SH ̾Á°
-symlink \- ¥Õ¥¡¥¤¥ë¤Ë¿·¤·¤¤Ì¾Á°¤òÉÕ¤±¤ë
-.SH ½ñ¼°
+.SH 名前
+symlink \- ファイルに新しい名前を付ける
+.SH 書式
.B #include <unistd.h>
.sp
.BI "int symlink(const char *" oldpath ", const char *" newpath );
.sp
.in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.in
.sp
.ad l
_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED || _POSIX_C_SOURCE\ >=\ 200112L
.RE
.ad b
-.SH ÀâÌÀ
+.SH 説明
.BR symlink ()
-¤Ï
+は
.I oldpath
-¤È¤¤¤¦Ê¸»úÎó¤ò¥Õ¥¡¥¤¥ë¤ÎÆâÍƤȤ·¤Æ»ý¤Ä
+という文字列をファイルの内容として持つ
.I newpath
-¤È¤¤¤¦¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯ (symbolic link) ¤òºîÀ®¤¹¤ë¡£
+というシンボリック・リンク (symbolic link) を作成する。
-¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤Ï¼Â¹Ô»þ¤Ë²ò¼á¤µ¤ì¡¢
-¥ê¥ó¥¯¤ÎÆâÍƤǥѥ¹¤òÃÖ¤´¹¤¨¤Æ¡¢¤½¤Î¥Ñ¥¹¤òé¤ë¤³¤È¤Ç¡¢
-¥Õ¥¡¥¤¥ë¤ä¥Ç¥£¥ì¥¯¥È¥ê¤ËÅþ㤹¤ë¡£
+シンボリック・リンクは実行時に解釈され、
+リンクの内容でパスを置き換えて、そのパスを辿ることで、
+ファイルやディレクトリに到達する。
-¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤Ï¥Ñ¥¹¤ÎÉôʬ¤Ë
+シンボリック・リンクはパスの部分に
.I ..
-¤ò´Þ¤à¤«¤â¤·¤ì¤Ê¤¤¡£¤³¤ì¤Ï (¤â¤·¥ê¥ó¥¯¤ÎºÇ½é¤Ë»ÈÍѤµ¤ì¤¿¾ì¹ç¤Ï) ¥ê¥ó¥¯¤Î
-¸ºß¤¹¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Î¿Æ¥Ç¥£¥ì¥¯¥È¥ê¤¬»²¾È¤µ¤ì¤ë¡£
+を含むかもしれない。これは (もしリンクの最初に使用された場合は) リンクの
+存在するディレクトリの親ディレクトリが参照される。
-¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤Ï (¥½¥Õ¥È¡¦¥ê¥ó¥¯ (soft link) ¤È¤â¸Æ¤Ð¤ì)
-¸ºß¤¹¤ë¥Õ¥¡¥¤¥ë¤ò»Ø¤·¤Æ¤¤¤ë¤«¤â¤·¤ì¤Ê¤¤¤·¡¢
-¸ºß¤·¤Ê¤¤¥Õ¥¡¥¤¥ë¤ò»Ø¤·¤Æ¤¤¤ë¤«¤â¤·¤ì¤Ê¤¤;
-¸å¼Ô¤Î¾ì¹ç¤Ï²õ¤ì¤¿¥ê¥ó¥¯ (dangling link) ¤È¤â¸Æ¤Ð¤ì¤ë¡£
+シンボリック・リンクは (ソフト・リンク (soft link) とも呼ばれ)
+存在するファイルを指しているかもしれないし、
+存在しないファイルを指しているかもしれない;
+後者の場合は壊れたリンク (dangling link) とも呼ばれる。
-¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤Îµö²Ä (permission) ¤Ï̵°ÕÌ£¤Ç¤¢¤ë;
-¥ê¥ó¥¯¤òÄÉÀפ¹¤ë¾ì¹ç¤Ë¤Ï½ê͸¢ (ownership) ¤Ï̵»ë¤µ¤ì¤ë¡£
-¤¿¤À¤·¡¢¥ê¥ó¥¯¤Îºï½ü¤ä̾Á°¤ÎÊѹ¹¤¬Í׵ᤵ¤ì¡¢¤«¤Ä¥ê¥ó¥¯¤¬Â¸ºß¤¹¤ë
-¥Ç¥£¥ì¥¯¥È¥ê¤Ë¥¹¥Æ¥£¥Ã¥¡¼¡¦¥Ó¥Ã¥È (sticky bit)
+シンボリック・リンクの許可 (permission) は無意味である;
+リンクを追跡する場合には所有権 (ownership) は無視される。
+ただし、リンクの削除や名前の変更が要求され、かつリンクが存在する
+ディレクトリにスティッキー・ビット (sticky bit)
.RB ( S_ISVTX )
-¤¬ÀßÄꤵ¤ì¤Æ¤¤¤ë¾ì¹ç¤Ë¤Ï¡¢½ê͸¢¤Î¥Á¥§¥Ã¥¯¤¬¹Ô¤ï¤ì¤ë¡£
+が設定されている場合には、所有権のチェックが行われる。
.I newpath
-¤¬´û¤Ë¸ºß¤¹¤ë¾ì¹ç¤Ë¤Ï¾å½ñ¤¤Ï\fB¤µ¤ì¤Ê¤¤\fR¡£
-.SH ÊÖ¤êÃÍ
-À®¸ù¤·¤¿¾ì¹ç¤Ë¤Ï 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¤Ë¤Ï \-1 ¤òÊÖ¤·¡¢
+が既に存在する場合には上書きは\fBされない\fR。
+.SH 返り値
+成功した場合には 0 を返す。エラーの場合には \-1 を返し、
.I errno
-¤¬Å¬ÀÚ¤ËÀßÄꤵ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
+が適切に設定される。
+.SH ã\82¨ã\83©ã\83¼
.TP
.B EACCES
.I newpath
-¤ò´Þ¤ó¤Ç¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Ø¤Î½ñ¤¹þ¤ß¤¬µñÈݤµ¤ì¤¿¤«¡¢
+を含んでいるディレクトリへの書き込みが拒否されたか、
.I newpath
-¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Î¤É¤ì¤«¤Ë¸¡º÷µö²Ä¤¬Í¿¤¨¤é¤ì¤Æ¤¤¤Ê¤¤
+に含まれているディレクトリのどれかに検索許可が与えられていない
.RB ( path_resolution (7)
-¤â»²¾È¤¹¤ë¤³¤È)¡£
+も参照すること)。
.TP
.B EEXIST
.I newpath
-¤¬´û¤Ë¸ºß¤·¤Æ¤¤¤ë¡£
+が既に存在している。
.TP
.B EFAULT
-.IR oldpath " ¤ä " newpath " ¤¬¥¢¥¯¥»¥¹²Äǽ¤Ê¥¢¥É¥ì¥¹¶õ´Ö¤Î³°¤ò»Ø¤·¤Æ¤¤¤ë¡£"
+.IR oldpath " や " newpath " がアクセス可能なアドレス空間の外を指している。"
.TP
.B EIO
-I/O ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¡£
+I/O エラーが発生した。
.TP
.B ELOOP
.I newpath
-¤ò²ò·è¤¹¤ëºÝ¤ËÁø¶ø¤·¤¿¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤¬Â¿²á¤®¤ë¡£
+を解決する際に遭遇したシンボリック・リンクが多過ぎる。
.TP
.B ENAMETOOLONG
-.IR oldpath " ¤Þ¤¿¤Ï " newpath " ¤¬Ä¹²á¤®¤ë¡£"
+.IR oldpath " または " newpath " が長過ぎる。"
.TP
.B ENOENT
.I newpath
-¤Ë´Þ¤Þ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥êÉôʬ¤¬Â¸ºß¤·¤Ê¤¤¤«¡¢²õ¤ì¤¿¥ê¥ó¥¯¤Ç¤¢¤ë¤«¡¢
+に含まれるディレクトリ部分が存在しないか、壊れたリンクであるか、
.I oldpath
-¤¬¶õʸ»úÎó¤Ç¤¢¤ë¡£
+が空文字列である。
.TP
.B ENOMEM
-½½Ê¬¤Ê¥«¡¼¥Í¥ë (kernel) ¤Î¥á¥â¥ê¡¼¤¬¤Ê¤¤¡£
+十分なカーネル (kernel) のメモリーがない。
.TP
.B ENOSPC
-¥Õ¥¡¥¤¥ë¤¬´Þ¤Þ¤ì¤Æ¤¤¤ë¥Ç¥Ð¥¤¥¹¤Ë¿·¤·¤¤¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê
-(directory entry) ¤òºîÀ®¤¹¤ë¤À¤±¤Î½½Ê¬¤ÊÍÆÎ̤¬¤Ê¤¤¡£
+ファイルが含まれているデバイスに新しいディレクトリ・エントリ
+(directory entry) を作成するだけの十分な容量がない。
.TP
.B ENOTDIR
.I newpath
-¤Ë´Þ¤Þ¤ì¤ë¥Ç¥£¥ì¥¯¥È¥êÉôʬ¤¬¡¢¼ÂºÝ¤Ë¤Ï¡¢¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ï¤Ê¤¤¡£
+に含まれるディレクトリ部分が、実際には、ディレクトリではない。
.TP
.B EPERM
.I newpath
-¤ò´Þ¤ó¤Ç¤¤¤ë¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à (file system) ¤¬
-¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤ÎºîÀ®¤ò¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¡£
+を含んでいるファイル・システム (file system) が
+シンボリック・リンクの作成をサポートしていない。
.TP
.B EROFS
.I newpath
-¤¬Æɤ߹þ¤ßÀìÍѤΥե¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Ë¸ºß¤·¤Æ¤¤¤ë¡£
-.SH ½àµò
+が読み込み専用のファイル・システムに存在している。
+.SH 準拠
SVr4, 4.3BSD, POSIX.1-2001.
-.\" SVr4 ¤Ë¤Ï¾¤Ë EDQUOT, ENOSYS ¥¨¥é¡¼¤Ë¤Ä¤¤¤Æ¤Îµ½Ò¤¬¤¢¤ë¡£
+.\" SVr4 には他に EDQUOT, ENOSYS エラーについての記述がある。
.\" .BR open (2)
-.\" ¤ò¸«¤Æ¡¢Æ±¤¸Ì¾Á°¤Î½ÅÊ£¤È NFS ¤Ë¤Ä¤¤¤Æ»²¾È¤¹¤ë¤³¤È¡£
-.SH Ãí°Õ
+.\" を見て、同じ名前の重複と NFS について参照すること。
+.SH 注意
.I oldpath
-¤Ë¤Ä¤¤¤Æ¤Î¥Á¥§¥Ã¥¯¤Ï¹Ô¤Ê¤ï¤ì¤Ê¤¤¡£
+についてのチェックは行なわれない。
-symlink ¤Ë¤è¤Ã¤Æ»²¾È¤µ¤ì¤ë̾Á°¤òºï½ü¤¹¤ë¤È (¤½¤ì¤¬Â¾¤Ë¥Ï¡¼¥É¡¦¥ê¥ó¥¯
-(hard link) ¤ò»ý¤¿¤Ê¤±¤ì¤Ð) ¼ÂºÝ¤Ë¥Õ¥¡¥¤¥ë¤¬ºï½ü¤µ¤ì¤ë¡£
-¤³¤ÎÆ°ºî¤¬Ë¾¤ó¤À¤â¤Î¤Ç¤Ê¤¤¾ì¹ç¤Ï¡¢
+symlink ã\81«ã\82\88ã\81£ã\81¦å\8f\82ç\85§ã\81\95ã\82\8cã\82\8bå\90\8då\89\8dã\82\92å\89\8aé\99¤ã\81\99ã\82\8bã\81¨ (ã\81\9dã\82\8cã\81\8cä»\96ã\81«ã\83\8fã\83¼ã\83\89ã\83»ã\83ªã\83³ã\82¯
+(hard link) を持たなければ) 実際にファイルが削除される。
+この動作が望んだものでない場合は、
.BR link (2)
-¤ò»ÈÍѤ¹¤ë¤³¤È¡£
-.SH ´ØÏ¢¹àÌÜ
+を使用すること。
+.SH 関連項目
.BR ln (1),
.BR lchown (2),
.BR link (2),
OSDN Git Service
