manページ  — RENAME

rename – ファイル名を変更する

ライブラリ 書式 解説 戻り値 エラー 関連項目 規格

Standard C Library (libc, -lc)

#include <stdio.h>

int
rename(const char *from, const char *to);

rename() システムコールによって from と名づけられたリンクを to に変更します。 to がすでに存在する場合は、先にこれを削除します。 from と to は同じタイプでなければならず (両方とも ディレクトリであるか、両方ともディレクトリではないか)、 同じファイルシステム上に存在している必要があります。

to が既に存在する場合には、操作の途中でシステムがクラッシュしたとしても、 rename() システムコールは to のインスタンスが必ず存在することを保証します。

from の最後の構成要素がシンボリックリンクの場合、それが指している ファイルまたはディレクトリではなく、 そのシンボリックリンクの名前が変更されます。

The rename function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

rename() システムコールは次の場合に失敗し、いずれの引数ファイルも影響を受けません:

[ENAMETOOLONG]
	いずれかのパス名の構成要素が 255 文字を越えているか、またはいずれかの パス名全体の長さが 1023 文字を越えています。
[ENOENT]
	from パスの構成要素が存在しないか、または to の前置パス名が存在しません。
[EACCES]
	指定されたパスには、検索が許可されていないディレクトリが含まれています。
[EACCES]
	指定されたリンクは、書込みが許可されていない ディレクトリへの書込みを要求しています。
[EPERM]
	from ファイルを含むディレクトリにスティッキビットが設定されており、 そのディレクトリと from のどちらの所有者も実効ユーザ ID とは異なっています。
[EPERM]
	to 引数によって指されるファイルが存在し、かつ to を含んでいるディレクトリにスティッキビットが設定されており、 そのディレクトリと to ファイルのどちらの所有者も実効ユーザ ID とは異なっています。
[ELOOP]
	パス名を変換するときに検出されたシンボリックリンクが多すぎます。
[ENOTDIR]
	パスの構成要素中にディレクトリ以外のものが含まれています。
[ENOTDIR]
	from 引数はディレクトリですが、 to はディレクトリではありません。
[EISDIR]
	to 引数はディレクトリですが、 from はディレクトリではありません。
[EXDEV]
	to によって指定されたリンク、および from によって指定されたファイルが 異なる論理デバイス (ファイルシステム) 上にあります。 実装がクロスデバイスリンクを許容する場合、このエラーコードは 返らないことに注意してください。
[ENOSPC]
	ディレクトリを格納しているファイルシステム上の空間が枯渇したため、 新しい名前のためのエントリを置くディレクトリを拡張できません。
[EDQUOT]
	ディレクトリを格納しているファイルシステム上のディスクブロックのユーザの クォータが枯渇したため、 新しい名前のためのエントリを置くディレクトリを拡張できません。
[EIO]	ディレクトリエントリを作成または更新している間に入出力エラーが発生しました。
[EROFS]
	指定されたリンクは、読取り専用ファイルシステム上のディレクトリへの 書込みを要求しています。
[EFAULT]
	path は、プロセスに割り当てられたアドレス空間の範囲外を指しています。
[EINVAL]
	from 引数が to の親ディレクトリであるか、 ‘.amp;’ または ‘amp;..’ に名前を変更しようとしました。
[ENOTEMPTY]
	to 引数はディレクトリであり、空ではありません。

rename() システムコールは IEEE Std 1003.1-96 ("POSIX.1") に適合しています。