名称

unlink − ディレクトリエントリを削除する

形式

unlink(path)
char ∗path;

解説

unlink は、 ディレクトリからファイル path のエントリを 削除します。 このエントリがそのファイルへの最後のリンクであって、 どのプロセスもそのファイルを オープンにしてない場合には、 そのファイルに関係するリソースはすべて解放されます。 しかし、 そのファイルが、 プロセスでオープンになっている場合には、 そのディレクトリエントリは削除されても、 そのファイルがクローズされるまで実際のリソースの解放は延期されます。

リターン値

正常終了した場合には、 値 0 が返されます。 そうでない場合には、 値 −1 が返され、 errno がエラーを 示すようにセットされます。

エラー

次の場合でない限り、 unlink は成功します。

[ENOTDIR] パスプレフィックスの構成要素がディレクトリではないものがある。

[EINVAL] パス名に最上位ビットのセットされたキャラクタが含まれている。 (NEWS-OS ではおこらない。)

[ENAMETOOLONG]
パス名の 1 構成要素が 255 バイトを 超えている、 またはパス名全体が 1023 バイトを 超えている。

[ENOENT] 指定されたファイルが存在していない。

[EACCES] パスプレフィックスの構成要素についてサーチパーミッションが 否定されているものがある。

[EACCES] 削除するリンクが収められているディレクトリについて書き込み パーミッションが否定されている。

[ELOOP] パス名の処理で遭遇したシンボリックリンクの数が多すぎる。

[EPERM] 指定されたファイルがディレクトリであり、 かつ、 そのプロセスの有効ユーザ ID がスーパーユーザではない。

[EPERM] そのファイルが収められているディレクトリが sticky としてマークされていて、 その収容しているディレクトリも、 削除するファイルも、 その有効ユーザ ID によって所有されていない。

[EBUSY] リンク解除するエントリが、 マウントされているファイルシステムのマウントポイントになっている。

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

[EROFS] 指定されたファイルが読み取り専用のファイルシステム上にある。

[EFAULT] path が、 そのプロセスの割り当てアドレススペースの外を 指している。

関連事項

close(2), link(2), rmdir(2)

NEWS-OSRelease 4.2.1R