名称

symlink − ファイルへのシンボリックリンクを作る

形式

symlink(name1, name2)
char ∗name1, ∗name2;

解説

シンボリックリンク name2 が name1 に対して作成されます(name2 は作成されるファイルの名前であり、 name1 はそのシンボリックリンクの作成で使用される文字列です)。 いずれの名前も任意のパス名で構いません。 これらのファイルは、 同一ファイルシステムに入っている必要はありません。

リターン値

正常終了した場合には、 値 0 が返されます。 エラーが発生した場合には、 エラーコードが errno に入れられ、 値 −1 が返されます。

エラー

以下に示されている項目のうちの 1つまたは複数が真でない限り、 シンボリックリンクが作成されます。

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

[EINVAL] name1 または name2 のいずれかに最上位ビットの セットされたキャラクタが含まれている。 (NEWS-OSではおきない。)

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

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

[EACCES] name2 パスプレフィックスの構成要素がサーチパーミッションを 否定している。

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

[EEXIST] name2 が既に存在している。

[EIO] name2 のディレクトリエントリの作成中、 name2 の iノードの割当て中、 またはname2 のリンク内容の書き込み中に、 入出力エラーが発生した。

[EROFS] ファイル name2 が、 読み取り専用のファイルシステム上に置かれる。

[ENOSPC] 新しいシンボリックリンクのエントリを 入れるディレクトリのあるファイルシステムにスペースが残されていないために、 そのディレクトリを拡張することができない。

[ENOSPC] 新しいシンボリックリンクが収められるファイルシステムに スペースが残されていないために、 そのシンボリックリンクを作成することができない。

[ENOSPC] そのシンボリックリンクが作成されるファイルシステムに、 空いている iノードがない。

[EDQUOT] その新しいシンボリックリンクのエントリを 入れるディレクトリのあるファイルシステムで、 そのユーザのディスクブロックの割当て量が使い果たされているために、 そのディレクトリを 拡張することができない。

[EDQUOT] その新しいシンボリックリンクが収められるファイルシステムで、 そのユーザのディスクブロックの割当て量が使い果たされているために、 そのシンボリックリンクを 作成することができない。

[EDQUOT] そのシンボリックリンクが作成されるファイルシステムで、 そのユーザのiノードの割当て量が使い果たされている。

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

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

関連事項

link(2), ln(1), unlink(2), cslink(7)

NEWS-OSRelease 3.3