RENAME

Section: System Calls (2)
索引 jman

BSD mandoc

索引

名称

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

索引

ライブラリ

Lb libc

索引

書式

In stdio.h Ft int Fn rename const char *from const char *to

索引

解説

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

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

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

索引

戻り値

Rv -std rename

索引

エラー

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

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

索引

規格

Fn rename システムコールは St -p1003.1-96 に適合しています。

索引

jman

Time: 07:06:29 GMT, January 12, 2009

RENAME

名称

ライブラリ

書式

解説

戻り値

エラー

関連項目

規格

Index