.\" Modified Thu Mar 3 09:49:35 2005 by Michael Haardt <michael@moria.de>
.\" 2007-03-25, mtk, added various text to DESCRIPTION.
.\"
-.\" Japanese Version Copyright (c) 1997 HANATAKA Shinya
-.\" all rights reserved.
-.\" Translated Fri Dec 12 00:15:52 JST 1997
-.\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
-.\" Updated & Modified Thu Feb 10 07:23:59 JST 2005
-.\" by Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated & Modified Fri Apr 22 03:21:04 JST 2005 by Yuichi SATO
-.\" Updated 2007-05-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v2.44
-.\" Updated 2009-04-24, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.20
+.\"*******************************************************************
.\"
-.\"WORD: directory ¥Ç¥£¥ì¥¯¥È¥ê
-.\"WORD: hard link ¥Ï¡¼¥É¡¦¥ê¥ó¥¯
-.\"WORD: overwrite ¾å½ñ¤(overwrite)
-.\"WORD: process ¥×¥í¥»¥¹
-.\"WORD: crash ¥¯¥é¥Ã¥·¥å
-.\"WORD: symbolic link ¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯
-.\"WORD: working directory ¥ï¡¼¥¥ó¥°¡¦¥Ç¥£¥ì¥¯¥È¥ê
-.\"WORD: root directory ¥ë¡¼¥È¡¦¥Ç¥£¥ì¥¯¥È¥ê
-.\"WORD: effective uid ¼Â¸ú¥æ¡¼¥¶¡¼ID
-.\"WORD: sticky bit ¥¹¥Æ¥£¥Ã¥¡¼¡¦¥Ó¥Ã¥È
-.\"WORD: memory ¥á¥â¥ê
-.\"WORD: read-only Æɤ߹þ¤ßÀìÍÑ
-.\"WORD: uid ¥æ¡¼¥¶¡¼ID
-.\"WORD: dangling symbolic link ²õ¤ì¤¿¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯
-.\"WORD: server ¥µ¡¼¥Ð¡¼
+.\" This file was generated with po4a. Translate the source file.
.\"
-.TH RENAME 2 2009-03-30 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH ̾Á°
-.\"O rename \- change the name or location of a file
-rename \- ¥Õ¥¡¥¤¥ë¤Î̾Á°¤ä°ÌÃÖ¤òÊѹ¹¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #include <stdio.h>
+.\"*******************************************************************
+.TH RENAME 2 2009\-03\-30 Linux "Linux Programmer's Manual"
+.SH 名前
+rename \- ファイルの名前や位置を変更する
+.SH 書式
+\fB#include <stdio.h>\fP
.sp
-.BI "int rename(const char *" oldpath ", const char *" newpath );
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O .BR rename ()
-.\"O renames a file, moving it between directories if required.
-.BR rename ()
-¤Ï¥Õ¥¡¥¤¥ë¤Î̾Á°¤òÊѹ¹¤·¡¢É¬Íפʤé¤Ð¥Ç¥£¥ì¥¯¥È¥ê´Ö¤Î°ÜÆ°¤ò¹Ô¤Ê¤¦¡£
-.\"O Any other hard links to the file (as created using
-.\"O .BR link (2))
-.\"O are unaffected.
-¤½¤Î¥Õ¥¡¥¤¥ë¤ËÂФ¹¤ë
-.RB ( link (2)
-¤ò»ÈÍѤ·¤Æºî¤é¤ì¤¿) ¾¤Î¥Ï¡¼¥É¥ê¥ó¥¯ (hard link) ¤Ë¤Ï±Æ¶Á¤Ï¤Ê¤¤¡£
-.\"O Open file descriptors for
-.\"O .I oldpath
-.\"O are also unaffected.
-¥ª¡¼¥×¥óºÑ¤Î
-.I oldpath
-¤ËÂФ¹¤ë¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ë¤â±Æ¶Á¤Ï¤Ê¤¤¡£
+\fBint rename(const char *\fP\fIoldpath\fP\fB, const char *\fP\fInewpath\fP\fB);\fP
+.SH 説明
+\fBrename\fP() はファイルの名前を変更し、必要ならばディレクトリ間の移動を行なう。 そのファイルに対する (\fBlink\fP(2)
+を使用して作られた) 他のハードリンク (hard link) には影響はない。 オープン済の \fIoldpath\fP
+に対するファイルディスクリプタにも影響はない。
-.\"O If
-.\"O .I newpath
-.\"O already exists it will be atomically replaced (subject to
-.\"O a few conditions; see ERRORS below), so that there is
-.\"O no point at which another process attempting to access
-.\"O .I newpath
-.\"O will find it missing.
-.I newpath
-¤¬´û¤Ë¸ºß¤¹¤ë¾ì¹ç¡¢¤½¤ì¤ÏÉÔ²ÄʬÁàºî¤Ç (atomically) ÃÖ¤´¹¤¨¤é¤ì¤ë
-(¤¿¤À¤·¡¢¤¤¤¯¤Ä¤«¤Î¾ò·ï¤¬¤¢¤ë; °Ê²¼¤Î¡Ö¥¨¥é¡¼¡×¤Î¥»¥¯¥·¥ç¥ó¤ò»²¾È)¡£
-¤½¤Î¤¿¤á¡¢
-.I newpath
-¤Ë¥¢¥¯¥»¥¹¤·¤è¤¦¤È¤·¤Æ¤¤¤ë¾¤Î¥×¥í¥»¥¹¤¬¥Õ¥¡¥¤¥ë¤ò¸«¼º¤¦¤³¤È¤Ï¤Ê¤¤
-(ÌõÃð: ¾ï¤Ë¥¢¥¯¥»¥¹²Äǽ¤Ç¤¢¤ë)¡£
+\fInewpath\fP が既に存在する場合、それは不可分操作で (atomically) 置き換えられる (ただし、いくつかの条件がある;
+以下の「エラー」のセクションを参照)。 そのため、 \fInewpath\fP にアクセスしようとしている他のプロセスがファイルを見失うことはない (訳註:
+常にアクセス可能である)。
-.\"O If
-.\"O .I oldpath
-.\"O and
-.\"O .I newpath
-.\"O are existing hard links referring to the same file, then
-.\"O .BR rename ()
-.\"O does nothing, and returns a success status.
-.I oldpath
-¤È
-.I newpath
-¤¬¤É¤Á¤é¤â´û¸¤Î¥Ï¡¼¥É¥ê¥ó¥¯¤Ç¡¢Æ±¤¸¥Õ¥¡¥¤¥ë¤ò»²¾È¤·¤Æ¤¤¤ë¾ì¹ç¡¢
-.BR rename ()
-¤Ï²¿¤â¹Ô¤ï¤º¡¢¥¹¥Æ¡¼¥¿¥¹¤È¤·¤ÆÀ®¸ù¤òÊÖ¤¹¡£
+\fIoldpath\fP と \fInewpath\fP がどちらも既存のハードリンクで、同じファイルを参照している場合、 \fBrename\fP()
+は何も行わず、ステータスとして成功を返す。
-.\"O If
-.\"O .I newpath
-.\"O exists but the operation fails for some reason
-.\"O .BR rename ()
-.\"O guarantees to leave an instance of
-.\"O .I newpath
-.\"O in place.
-.I newpath
-¤¬Â¸ºß¤·¡¢²¿¤é¤«¤ÎÍýͳ¤ÇÁàºî¤¬¼ºÇÔ¤·¤¿¾ì¹ç¡¢
-.BR rename ()
-¤Ï
-.I newpath
-¤Î¼ÂÂΤò¸µ¤Î¤Þ¤Þ»Ä¤¹¤³¤È¤òÊݾڤ¹¤ë¡£
+\fInewpath\fP が存在し、何らかの理由で操作が失敗した場合、 \fBrename\fP() は \fInewpath\fP
+の実体を元のまま残すことを保証する。
-.\"O .I oldpath
-.\"O can specify a directory.
-.\"O In this case,
-.\"O .I newpath
-.\"O must either not exist, or it must specify an empty directory.
-.I oldpath
-¤Ë¤Ï¥Ç¥£¥ì¥¯¥È¥ê¤ò»ØÄꤹ¤ë¤³¤È¤â¤Ç¤¤ë¡£
-¤³¤Î¾ì¹ç¡¢
-.I newpath
-¤Ï¸ºß¤·¤Ê¤¤¤«¡¢¶õ¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+\fIoldpath\fP にはディレクトリを指定することもできる。 この場合、 \fInewpath\fP は存在しないか、空のディレクトリでなければならない。
-.\"O However, when overwriting there will probably be a window in which
-.\"O both
-.\"O .I oldpath
-.\"O and
-.\"O .I newpath
-.\"O refer to the file being renamed.
-°ìÊý¤Ç¡¢¾å½ñ¤¤ò¹Ô¤Ê¤¦¾ì¹ç¤Ï¡¢rename ¤¬¹Ô¤Ê¤ï¤ì¤ë¥Õ¥¡¥¤¥ë¤ò
-.I oldpath
-¤È
-.I newpath
-¤ÎξÊý¤Ç»²¾È¤Ç¤¤ë½Ö´Ö¤¬¤ª¤½¤é¤¯Â¸ºß¤¹¤ë¡£
+一方で、上書きを行なう場合は、rename が行なわれるファイルを \fIoldpath\fP と \fInewpath\fP
+の両方で参照できる瞬間がおそらく存在する。
-.\"O If
-.\"O .I oldpath
-.\"O refers to a symbolic link the link is renamed; if
-.\"O .I newpath
-.\"O refers to a symbolic link the link will be overwritten.
-.I oldpath
-¤¬¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯ (symbolic link) ¤ò»²¾È¤·¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢
-¥ê¥ó¥¯¤Î̾Á°¤¬Êѹ¹¤µ¤ì¤ë¡£
-¤Þ¤¿¡¢
-.I newpath
-¤¬¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤ò»²¾È¤·¤Æ¤¤¤ë¾ì¹ç¤Ï¡¢¥ê¥ó¥¯¤¬¾å½ñ¤¤µ¤ì¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O On success, zero is returned.
-.\"O On error, \-1 is returned, and
-.\"O .I errno
-.\"O is set appropriately.
-À®¸ù¤·¤¿¾ì¹ç¤Ï 0 ¤òÊÖ¤¹¡£¥¨¥é¡¼¤Î¾ì¹ç¤Ï \-1 ¤òÊÖ¤·¡¢
-.I errno
-¤òŬÀÚ¤ËÀßÄꤹ¤ë¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.TP
-.B EACCES
-.\"O Write permission is denied for the directory containing
-.\"O .I oldpath
-.\"O or
-.\"O .IR newpath ,
-.\"O or, search permission is denied for one of the directories
-.\"O in the path prefix of
-.\"O .I oldpath
-.\"O or
-.\"O .IR newpath ,
-.\"O or
-.\"O .I oldpath
-.\"O is a directory and does not allow write permission (needed to update
-.\"O the
-.\"O .I ..
-.\"O entry).
-.\"O (See also
-.\"O .BR path_resolution (7).)
-.IR oldpath " ¤Þ¤¿¤Ï " newpath
-¤ò´Þ¤ó¤Ç¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Î½ñ¤¹þ¤ßµö²Ä¤¬¤Ê¤¤¡£
-¤Þ¤¿¤Ï¡¢
-.IR oldpath " ¤Þ¤¿¤Ï " newpath
-¤Î¥Ç¥£¥ì¥¯¥È¥êÉôʬ¤Î¤É¤ì¤«¤Ë¸¡º÷µö²Ä¤¬¤Ê¤¤¡£
-¤Þ¤¿¤Ï¡¢
-.I oldpath
-¤¬¥Ç¥£¥ì¥¯¥È¥ê¤Ç
-.RI ( ..
-¥¨¥ó¥È¥ê¤ò¹¹¿·¤¹¤ë¤Î¤ËɬÍפÊ) ½ñ¤¹þ¤ßµö²Ä¤¬¤Ê¤¤
-.RB ( path_resolution (7)
-¤â»²¾È)¡£
-.TP
-.B EBUSY
-.\"O The rename fails because
-.\"O .IR oldpath " or " newpath
-.\"O is a directory that is in use by some process (perhaps as
-.\"O current working directory, or as root directory, or because
-.\"O it was open for reading) or is in use by the system
-.\"O (for example as mount point), while the system considers
-.\"O this an error.
-.IR oldpath " ¤Þ¤¿¤Ï " newpath
-¤¬¥Ç¥£¥ì¥¯¥È¥ê¤Ç¡¢²¿¤é¤«¤Î¥×¥í¥»¥¹¤¬»ÈÍÑÃæ
-(¿ʬ¡¢¥«¥ì¥ó¥È¡¦¥ï¡¼¥¥ó¥°¡¦¥Ç¥£¥ì¥¯¥È¥ê¤«¡¢¥ë¡¼¥È¥Ç¥£¥ì¥¯¥È¥ê¤«¡¢
-Æɤ߹þ¤ß¤Î¤¿¤á¤Ë¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ë¤«¤Ç¤í¤¦)
-¤â¤·¤¯¤Ï¡¢¥·¥¹¥Æ¥à¤¬»ÈÍÑÃæ (Î㤨¤Ð¥Þ¥¦¥ó¥È¡¦¥Ý¥¤¥ó¥È¤Ç¤¢¤ë)
-¤Ç¤¢¤ê¡¢¥·¥¹¥Æ¥à¤¬¤³¤ì¤ò¥¨¥é¡¼¤Ç¤¢¤ë¤ÈȽÃǤ·¤¿¤¿¤á¤Ë rename ¤¬¼ºÇÔ¤·¤¿¡£
-.\"O (Note that there is no requirement to return
-.\"O .B EBUSY
-.\"O in such
-.\"O cases \(em there is nothing wrong with doing the rename anyway \(em
-.\"O but it is allowed to return
-.\"O .B EBUSY
-.\"O if the system cannot otherwise
-.\"O handle such situations.)
-(¤³¤Î¤è¤¦¤Ê¾ì¹ç¤Ë
-.B EBUSY
-¤òÊÖ¤¹¤³¤È¤Ïµ¬³Ê¤Ç¤ÏÍ׵ᤵ¤ì¤Æ¤¤¤Ê¤¤ÅÀ¤ËÃí°Õ¤¹¤ë¤³¤È¡£
-¤³¤Î¤è¤¦¤Ê¾ì¹ç¤Ë¡¢rename ¤ò¤È¤Ë¤«¤¯¼Â¹Ô¤·¤Æ¤ß¤ë¤Î¤Ï²¿¤ÎÌäÂê¤â¤Ê¤¤¡£
-¤¿¤À¤·¡¢¤½¤Î¤è¤¦¤Ê¾õ¶·¤Ç¡¢¥·¥¹¥Æ¥à¤¬Â¾¤ËÊÖ¤¹¥¨¥é¡¼¤¬¤Ê¤¤¾ì¹ç¤Ë¤Ï
-.B EBUSY
-¤òÊÖ¤¹¤³¤È¤¬µö¤µ¤ì¤Æ¤¤¤ë¡£)
-.TP
-.B EFAULT
-.\"O .IR oldpath " or " newpath " points outside your accessible address space."
-.IR oldpath " ¤Þ¤¿¤Ï " newpath
-¤¬¥¢¥¯¥»¥¹²Äǽ¤Ê¥¢¥É¥ì¥¹¶õ´Ö¤Î³°¤ò»Ø¤·¤Æ¤¤¤ë¡£
-.TP
-.B EINVAL
-.\"O The new pathname contained a path prefix of the old, or, more generally,
-.\"O an attempt was made to make a directory a subdirectory of itself.
-.IR newpath " ¤¬ " oldpath
-¤Î¥Ñ¥¹Éôʬ¤ò´Þ¤ó¤Ç¤¤¤ë¡£¥Ç¥£¥ì¥¯¥È¥ê¤ò¼«Ê¬¼«¿È¤Î¥µ¥Ö¥Ç¥£¥ì¥¯¥È¥ê¤Ë
-Êѹ¹¤·¤è¤¦¤È¤·¤¿¾ì¹ç¤¬¤Û¤È¤ó¤É¤Ç¤¢¤ë¡£
-.TP
-.B EISDIR
-.\"O .I newpath
-.\"O is an existing directory, but
-.\"O .I oldpath
-.\"O is not a directory.
-.I newpath
-¤Ï¸ºß¤·¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤¢¤ë¤¬¡¢
-.I oldpath
-¤Ï¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ê¤¤¡£
-.TP
-.B ELOOP
-.\"O Too many symbolic links were encountered in resolving
-.\"O .IR oldpath " or " newpath .
-.IR oldpath " ¤Þ¤¿¤Ï " newpath
-¤ò²ò·è¤¹¤ëºÝ¤ËÁø¶ø¤·¤¿¥·¥ó¥Ü¥ê¥Ã¥¯¡¦¥ê¥ó¥¯¤¬Â¿²á¤®¤ë¡£
-.TP
-.B EMLINK
-.\"O .I oldpath
-.\"O already has the maximum number of links to it, or
-.\"O it was a directory and the directory containing
-.\"O .I newpath
-.\"O has the maximum number of links.
-.I oldpath
-¤Ï´û¤ËºÇÂç¿ô¤Þ¤Ç¤Î¥ê¥ó¥¯¤ò»ý¤Ã¤Æ¤¤¤ë¤«¡¢¤½¤ì¤¬¥Ç¥£¥ì¥¯¥È¥ê¤Ç
-.I newpath
-¤ò´Þ¤ó¤Ç¤¤¤ë¥Ç¥£¥ì¥¯¥È¥ê¤¬ºÇÂç¿ô¤Þ¤Ç¤Î¥ê¥ó¥¯¤ò»ý¤Ã¤Æ¤¤¤ë¡£
-.TP
-.B ENAMETOOLONG
-.\"O .IR oldpath " or " newpath " was too long."
-.IR oldpath " ¤Þ¤¿¤Ï " newpath " ¤¬Ä¹²á¤®¤ë¡£"
-.TP
-.B ENOENT
-.\"O The link named by
-.\"O .I oldpath
-.\"O does not exist;
-.\"O or, a directory component in
-.\"O .I newpath
-.\"O does not exist;
-.\"O or,
-.\"O .I oldpath
-.\"O or
-.\"O .I newpath
-.\"O is an empty string.
-.I oldpath
-¤È¤¤¤¦Ì¾Á°¤Î¥ê¥ó¥¯¤¬Â¸ºß¤·¤Ê¤¤¡£
-¤Þ¤¿¤Ï¡¢
-.I newpath
-¤È¤¤¤¦¥Ç¥£¥ì¥¯¥È¥ê¤¬Â¸ºß¤·¤Ê¤¤¡£
-¤Þ¤¿¤Ï¡¢
-.I oldpath
-¤«
-.I newpath
-¤¬¶õ¤Îʸ»úÎó¤Ç¤¢¤ë¡£
-.TP
-.B ENOMEM
-.\"O Insufficient kernel memory was available.
-¥«¡¼¥Í¥ë¤Ë½½Ê¬¤Ê¥á¥â¥ê¤¬Â¸ºß¤·¤Ê¤¤¡£
-.TP
-.B ENOSPC
-.\"O The device containing the file has no room for the new directory
-.\"O entry.
-¥Õ¥¡¥¤¥ë¤ò´Þ¤ó¤Ç¤¤¤ë¥Ç¥Ð¥¤¥¹¤Ë¿·¤·¤¤¥Ç¥£¥ì¥¯¥È¥ê¡¦¥¨¥ó¥È¥ê¤ò
-ºîÀ®¤¹¤ë¤¿¤á¤Î¶õ¤¤¬¤Ê¤¤¡£
-.TP
-.B ENOTDIR
-.\"O A component used as a directory in
-.\"O .IR oldpath " or " newpath
-.\"O is not, in fact, a directory.
-.IR oldpath " ¤« " newpath
-¤Ë´Þ¤Þ¤ì¤Æ¤¤¤ë¥Ç¥£¥ì¥¯¥È¥êÉôʬ¤¬
-¼ÂºÝ¤Ë¤Ï¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ê¤¤¡£
-.\"O Or,
-.\"O .I oldpath
-.\"O is a directory, and
-.\"O .I newpath
-.\"O exists but is not a directory.
-¤Þ¤¿¤Ï
-.I oldpath
-¤¬¥Ç¥£¥ì¥¯¥È¥ê¤Ç¡¢
-.I newpath
-¤¬Â¸ºß¤·¤Æ¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤Ê¤¤¡£
-.TP
-.\"O .BR ENOTEMPTY " or " EEXIST
-.B ENOTEMPTY " ¤Þ¤¿¤Ï " EEXIST
-.\"O .I newpath
-.\"O is a nonempty directory, that is, contains entries other than "." and "..".
-.I newpath
-¤¬¶õ¤Ç¤Ê¤¤¥Ç¥£¥ì¥¯¥È¥ê¤Ç¤¢¤ë¡£¤¹¤Ê¤ï¤Á "." ¤È ".." °Ê³°¤ò´Þ¤ó¤Ç¤¤¤ë¡£
-.TP
-.\"O .BR EPERM " or " EACCES
-.BR EPERM " ¤Þ¤¿¤Ï " EACCES
-.\"O The directory containing
-.\"O .I oldpath
-.\"O has the sticky bit
-.\"O .RB ( S_ISVTX )
-.\"O set and the process's effective user ID is neither
-.\"O the user ID of the file to be deleted nor that of the directory
-.\"O containing it, and the process is not privileged
-.\"O (Linux: does not have the
-.\"O .B CAP_FOWNER
-.\"O capability);
-.I oldpath
-¤Î¤¢¤ë¥Ç¥£¥ì¥¯¥È¥ê¤Ë¥¹¥Æ¥£¥Ã¥¡¼¡¦¥Ó¥Ã¥È (sticky bit)
-.RB ( S_ISVTX )
-¤¬ÀßÄꤵ¤ì¤Æ¤ª¤ê¡¢
-¥×¥í¥»¥¹¤Î¼Â¸ú¥æ¡¼¥¶¡¼ ID ¤¬
-ºï½ü¤·¤è¤¦¤È¤¹¤ë¥Õ¥¡¥¤¥ë¤Î¥æ¡¼¥¶¡¼ ID ¤È
-¤½¤Î¥Õ¥¡¥¤¥ë¤ò´Þ¤à¥Ç¥£¥ì¥¯¥È¥ê¤Î¥æ¡¼¥¶¡¼ ID ¤Î¤¤¤º¤ì¤È¤â°ìÃפ»¤º¡¢¤«¤Ä
-¥×¥í¥»¥¹¤ËÆø¢¤¬¤Ê¤¤ (Linux ¤Ç¤Ï
-.B CAP_FOWNER
-¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£ (capability) ¤¬¤Ê¤¤)¡£
-.\"O or
-.\"O .I newpath
-.\"O is an existing file and the directory containing it has the sticky bit set
-.\"O and the process's effective user ID is neither the user ID of the file
-.\"O to be replaced nor that of the directory containing it,
-.\"O and the process is not privileged
-.\"O (Linux: does not have the
-.\"O .B CAP_FOWNER
-.\"O capability);
-¤Þ¤¿¤Ï¡¢
-.I newpath
-¤¬¤¹¤Ç¤Ë¸ºß¤¹¤ë¥Õ¥¡¥¤¥ë¤Ç¡¢¿Æ¥Ç¥£¥ì¥¯¥È¥ê¤Ë¥¹¥Æ¥£¥Ã¥¡¼¥Ó¥Ã¥È¤¬ÀßÄꤵ¤ì¤Æ¤ª¤ê¡¢
-¥×¥í¥»¥¹¤Î¼Â¸ú¥æ¡¼¥¶¡¼ ID ¤¬
-ÃÖ¤´¹¤¨¤è¤¦¤È¤¹¤ë¥Õ¥¡¥¤¥ë¤Î¥æ¡¼¥¶¡¼ ID ¤È
-¤½¤Î¥Õ¥¡¥¤¥ë¤ò´Þ¤à¥Ç¥£¥ì¥¯¥È¥ê¤Î¥æ¡¼¥¶¡¼ ID ¤Î¤¤¤º¤ì¤È¤â°ìÃפ»¤º¡¢¤«¤Ä
-¥×¥í¥»¥¹¤ËÆø¢¤¬¤Ê¤¤ (Linux ¤Ç¤Ï
-.B CAP_FOWNER
-¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£¤¬¤Ê¤¤)¡£
-.\"O or the file system containing
-.\"O .I pathname
-.\"O does not support renaming of the type requested.
-¤Þ¤¿¤Ï
-.IR oldpath " ¤È " newpath
-¤¬Â¸ºß¤¹¤ë¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤¬¡¢Í׵ᤵ¤ì¤¿¼ïÎà¤Î̾Á°¤ÎÊѹ¹¤ò
-¥µ¥Ý¡¼¥È¤·¤Æ¤¤¤Ê¤¤¡£
-.TP
-.B EROFS
-.\"O The file is on a read-only file system.
-¥Õ¥¡¥¤¥ë¤¬Æɤ߹þ¤ßÀìÍÑ (read-only) ¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Ë¤¢¤ë¡£
-.TP
-.B EXDEV
-.\"O .IR oldpath " and " newpath
-.\"O are not on the same mounted file system.
-.IR oldpath " ¤È " newpath
-¤¬Æ±¤¸¥Þ¥¦¥ó¥È¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Ë¸ºß¤·¤Ê¤¤¡£
-.\"O (Linux permits a file system to be mounted at multiple points, but
-.\"O .BR rename ()
-.\"O does not work across different mount points,
-.\"O even if the same file system is mounted on both.)
-(Linux ¤Ï 1 ¤Ä¤Î¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤òÊ£¿ô¤Î¥Þ¥¦¥ó¥È°ÌÃÖ¤Ë
-¥Þ¥¦¥ó¥È¤¹¤ë¤³¤È¤òµö²Ä¤·¤Æ¤¤¤ë¡£
-¤·¤«¤·
-.BR rename ()
-¤Ï¡¢¤¿¤È¤¨Æ±¤¸¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Ç¤¢¤Ã¤Æ¤â¡¢
-ÊÌ¡¹¤Î¥Þ¥¦¥ó¥È°ÌÃÖ¤ò¸Ù¤¤¤Ç¤ÏÆ°ºî¤·¤Ê¤¤¡£)
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-4.3BSD, C89, C99, POSIX.1-2001.
-.\"O .SH BUGS
-.SH ¥Ð¥°
-.\"O On NFS file systems, you can not assume that if the operation
-.\"O failed the file was not renamed.
-.\"O If the server does the rename operation
-.\"O and then crashes, the retransmitted RPC which will be processed when the
-.\"O server is up again causes a failure.
-.\"O The application is expected to
-.\"O deal with this.
-.\"O See
-.\"O .BR link (2)
-.\"O for a similar problem.
-NFS ¥Õ¥¡¥¤¥ë¡¦¥·¥¹¥Æ¥à¤Ç¤Ï¡¢Áàºî¤¬¼ºÇÔ¤·¤¿¤«¤é¤È¤¤¤Ã¤Æ¡¢
-¥Õ¥¡¥¤¥ë¤Î̾Á°¤¬Êѹ¹¤Ç¤¤Ê¤«¤Ã¤¿¤È·è¤á¤Æ¤«¤«¤ë¤³¤È¤Ï¤Ç¤¤Ê¤¤¡£
-¥µ¡¼¥Ð¤¬ rename Áàºî¤ò½ª¤¨¤Æ¤«¤é¥¯¥é¥Ã¥·¥å¤·¤¿¾ì¹ç¡¢
-¥µ¡¼¥Ð¤¬ºÆ¤ÓΩ¤Á¾å¤¬¤Ã¤¿¤È¤¤Ë¡¢
-ºÆÁ÷¿®¤µ¤ì¤¿ RPC ¤¬½èÍý¤µ¤ì¤ë¤¬¡¢¤³¤ì¤Ï¼ºÇԤȤʤ롣
-¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ï¤³¤ÎÌäÂê¤òÀµ¤·¤¯¼è¤ê°·¤¦¤³¤È¤¬´üÂÔ¤µ¤ì¤Æ¤¤¤ë¡£
-ƱÍͤÎÌäÂê¤Ë¤Ä¤¤¤Æ
-.BR link (2)
-¤Ë¤â½ñ¤«¤ì¤Æ¤¤¤ë¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR mv (1),
-.BR chmod (2),
-.BR link (2),
-.BR renameat (2),
-.BR symlink (2),
-.BR unlink (2),
-.BR path_resolution (7),
-.BR symlink (7)
+\fIoldpath\fP がシンボリックリンク (symbolic link) を参照している場合は、 リンクの名前が変更される。 また、
+\fInewpath\fP がシンボリックリンクを参照している場合は、リンクが上書きされる。
+.SH 返り値
+成功した場合は 0 が返される。エラーの場合は \-1 が返され、 \fIerrno\fP が適切に設定される。
+.SH エラー
+.TP
+\fBEACCES\fP
+\fIoldpath\fP または \fInewpath\fP を含んでいるディレクトリの書き込み許可がない。 または、 \fIoldpath\fP または
+\fInewpath\fP のディレクトリ部分のどれかに検索許可がない。 または、 \fIoldpath\fP がディレクトリで (\fI..\fP
+エントリを更新するのに必要な) 書き込み許可がない (\fBpath_resolution\fP(7) も参照)。
+.TP
+\fBEBUSY\fP
+\fIoldpath\fP または \fInewpath\fP がディレクトリで、何らかのプロセスが使用中
+(多分、カレントワーキングディレクトリか、ルートディレクトリか、 読み込みのためにオープンされているかでろう) もしくは、システムが使用中
+(例えばマウントポイントである) であり、システムがこれをエラーであると判断したために rename が失敗した。 (このような場合に
+\fBEBUSY\fP を返すことは規格では要求されていない点に注意すること。 このような場合に、rename をとにかく実行してみるのは何の問題もない。
+ただし、そのような状況で、システムが他に返すエラーがない場合には \fBEBUSY\fP を返すことが許されている。)
+.TP
+\fBEFAULT\fP
+\fIoldpath\fP や \fInewpath\fP がアクセス可能なアドレス空間の外を指している。
+.TP
+\fBEINVAL\fP
+\fInewpath\fP が \fIoldpath\fP のパス部分を含んでいる。ディレクトリを自分自身のサブディレクトリに
+変更しようとした場合がほとんどである。
+.TP
+\fBEISDIR\fP
+\fInewpath\fP は存在しているディレクトリであるが、 \fIoldpath\fP はディレクトリでない。
+.TP
+\fBELOOP\fP
+\fIoldpath\fP または \fInewpath\fP を解決する際に遭遇したシンボリックリンクが多過ぎる。
+.TP
+\fBEMLINK\fP
+\fIoldpath\fP は既に最大数までのリンクを持っているか、それがディレクトリで \fInewpath\fP
+を含んでいるディレクトリが最大数までのリンクを持っている。
+.TP
+\fBENAMETOOLONG\fP
+\fIoldpath\fP または \fInewpath\fP が長過ぎる。
+.TP
+\fBENOENT\fP
+\fIoldpath\fP という名前のリンクが存在しない。 または、 \fInewpath\fP というディレクトリが存在しない。 または、 \fIoldpath\fP
+か \fInewpath\fP が空の文字列である。
+.TP
+\fBENOMEM\fP
+十分なカーネルメモリーがない。
+.TP
+\fBENOSPC\fP
+そのファイルを含んでいるデバイスに新しいディレクトリエントリを 作成するための空きがない。
+.TP
+\fBENOTDIR\fP
+\fIoldpath\fP か \fInewpath\fP に含まれているディレクトリ部分が 実際にはディレクトリでない。 または \fIoldpath\fP
+がディレクトリで、 \fInewpath\fP が存在してディレクトリでない。
+.TP
+\fBENOTEMPTY または EEXIST\fP
+\fInewpath\fP が空でないディレクトリである。すなわち "." と ".." 以外を含んでいる。
+.TP
+\fBEPERM\fP または \fBEACCES\fP
+\fIoldpath\fP のあるディレクトリにスティッキービット (sticky bit) (\fBS_ISVTX\fP) が設定されており、
+プロセスの実効ユーザー ID が 削除しようとするファイルのユーザー ID と そのファイルを含むディレクトリのユーザー ID
+のいずれとも一致せず、かつ プロセスに特権がない (Linux では \fBCAP_FOWNER\fP ケーパビリティ (capability) がない)。
+または、 \fInewpath\fP がすでに存在するファイルで、親ディレクトリにスティッキービットが設定されており、 プロセスの実効ユーザー ID が
+置き換えようとするファイルのユーザー ID と そのファイルを含むディレクトリのユーザー ID のいずれとも一致せず、かつ プロセスに特権がない
+(Linux では \fBCAP_FOWNER\fP ケーパビリティがない)。 または \fIoldpath\fP と \fInewpath\fP
+が存在するファイルシステムが、要求された種類の名前の変更を サポートしていない。
+.TP
+\fBEROFS\fP
+ファイルが読み込み専用のファイルシステムに存在する。
+.TP
+\fBEXDEV\fP
+\fIoldpath\fP と \fInewpath\fP が同じマウントされたファイルシステムに存在しない。 (Linux は 1
+つのファイルシステムを複数のマウント位置に マウントすることを許可している。 しかし \fBrename\fP()
+は、たとえ同じファイルシステムであっても、 別々のマウント位置を跨いでは動作しない。)
+.SH 準拠
+4.3BSD, C89, C99, POSIX.1\-2001.
+.SH バグ
+NFS ファイルシステムでは、操作が失敗したからといって、 ファイルの名前が変更できなかったと決めてかかることはできない。 サーバが rename
+操作を終えてからクラッシュした場合、 サーバが再び立ち上がったときに、 再送信された RPC が処理されるが、これは失敗となる。
+アプリケーションはこの問題を正しく取り扱うことが期待されている。 同様の問題について \fBlink\fP(2) にも書かれている。
+.SH 関連項目
+\fBmv\fP(1), \fBchmod\fP(2), \fBlink\fP(2), \fBrenameat\fP(2), \fBsymlink\fP(2),
+\fBunlink\fP(2), \fBpath_resolution\fP(7), \fBsymlink\fP(7)
OSDN Git Service
