UNLINK(2)

名称
unlink - ディレクトリエントリの削除

ライブラリ
libc

書式
<unistd.h> int unlink(const char *path)

解説
unlink() 関数は、 path で指定されたリンクをディレクトリから削除し、 そのリンクで参照されていたファイルのリンク数を減らします。 ファイルのリンク数が 0 になり、ファイルを開いているプロセスがなくなると、 ファイルに関連するすべてのリソースが再利用されます。 最後のリンクが削除されたときに、ファイルを開いているプロセスが 1 つ以上あると、リンクは削除されますが、ファイルの削除は、 そのファイルへのすべての参照が閉じられるまで延期されます。 path は、ディレクトリでない場合もあります。

戻り値

エラー
unlink() は、以下の場合に処理を失敗します。

[ENOTDIR]
    パスの構成要素中にディレクトリ以外のものが含まれています。

[ENAMETOOLONG]
    パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。

[ENOENT]
    指定されたファイルが存在しません。

[EACCES]
    前置パス名の構成要素について検索許可が拒否されています。

[EACCES]
    削除するリンクを含むディレクトリで、書込み許可が拒否されています。

[ELOOP]
    パス名を変換するときに検出されたシンボリックリンクが多すぎます。

[EPERM]
    指定されたファイルがディレクトリになっています。

[EPERM]
    ファイルを含むディレクトリがスティッキーとマークされ、 削除するファイルを含むディレクトリまたはファイルが、 有効なユーザ ID に所有されていません。

[EBUSY]
    リンクを削除するエントリが、 マウント済みファイルシステムのマウントポイントです。

[EIO]
    ディレクトリエントリの削除中か、inode の割当て解除中に 入出力エラーが発生しました。

[EROFS]
    指定されたファイルは読取り専用ファイルシステム上にあります。

[EFAULT]
    path は、プロセスに割り当てられたアドレス空間の範囲外を指しています。

関連項目
close(2), link(2), rmdir(2), symlink(7)

歴史
unlink() 関数呼出しは、 AT&T UNIX で登場しました。

古来の unlink() システムコールでは、ファイルシステムを破壊する可能性のあるディレクトリの リンクをスーパユーザが削除できるようになっています。 それを実行することは、すでに許可されなくなっています。