manページ  — UNLINK

unlink – ディレクトリエントリの削除

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

Standard C Library (libc, -lc)

#include <unistd.h>

int
unlink(const char *path);

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

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

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

[ENOTDIR]
	パスの構成要素中にディレクトリ以外のものが含まれています。
[ENAMETOOLONG]
	パス名の構成要素が 255 文字を越えているか、 またはパス名全体が 1023 文字を越えています。
[ENOENT]
	指定されたファイルが存在しません。
[EACCES]
	前置パス名の構成要素について検索許可が拒否されています。
[EACCES]
	削除するリンクを含むディレクトリで、書込み許可が拒否されています。
[ELOOP]
	パス名を変換するときに検出されたシンボリックリンクが多すぎます。
[EPERM]
	指定されたファイルがディレクトリになっています。
[EPERM]
	指定されたファイルはそれが変更不可 (immutable) であるか追加専用 (append-only) のフラグが設定されています。 詳しい情報に関しては chflags(2) マニュアルページを参照してください。
[EPERM]
	ファイルを含むディレクトリがスティッキとマークされ、 削除するファイルを含むディレクトリまたはファイルが、 有効なユーザ ID に所有されていません。
[EBUSY]
	リンクを削除するエントリが、 マウント済みファイルシステムのマウントポイントです。
[EIO]	ディレクトリエントリの削除中か、inode の割り当て解除中に 入出力エラーが発生しました。
[EROFS]
	指定されたファイルは読取り専用ファイルシステム上にあります。
[EFAULT]
	path 引数が、プロセスに割り当てられたアドレス空間の範囲外を指しています。

unlink() 関数は、 AT&T v6 で登場しました。

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