other versions
other sections
SYMLINK(2) | Linux Programmer's Manual | SYMLINK(2) |
名前¶
symlink - ファイルに新しい名前を付ける書式¶
#include <unistd.h>glibc 向けの機能検査マクロの要件 ( feature_test_macros(7) 参照):
_BSD_SOURCE ||
_XOPEN_SOURCE >= 500 ||
_XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED ||
_POSIX_C_SOURCE >= 200112L
説明¶
symlink() は oldpath という文字列をファイルの内容として持つ newpath というシンボリックリンク (symbolic link) を作成する。返り値¶
成功した場合は 0 が返される。エラーの場合は -1 が返され、 errno が適切に設定される。エラー¶
- EACCES
- newpath を含んでいるディレクトリへの書き込みが拒否されたか、 newpath に含まれているディレクトリのどれかに検索許可が与えられていない ( path_resolution(7) も参照すること)。
- EEXIST
- newpath が既に存在する。
- EFAULT
- oldpath や newpath がアクセス可能なアドレス空間の外を指している。
- EIO
- I/O エラーが発生した。
- ELOOP
- newpath を解決する際に遭遇したシンボリックリンクが多過ぎる。
- ENAMETOOLONG
- oldpath または newpath が長過ぎる。
- ENOENT
- newpath に含まれるディレクトリ部分が存在しないか、壊れたリンクであるか、 oldpath が空文字列である。
- ENOMEM
- 十分なカーネルメモリーがない。
- ENOSPC
- そのファイルを含んでいるデバイスに新しいディレクトリエントリを 作成するための空きがない。
- ENOTDIR
- newpath に含まれるディレクトリ部分が、実際には、ディレクトリではない。
- EPERM
- newpath を含んでいるファイルシステム (file system) が シンボリックリンクの作成をサポートしていない。
- EROFS
- newpath が読み込み専用のファイルシステムに存在している。
準拠¶
SVr4, 4.3BSD, POSIX.1-2001.注意¶
oldpath についてのチェックは行なわれない。関連項目¶
ln(1), lchown(2), link(2), lstat(2), open(2), readlink(2), rename(2), symlinkat(2), unlink(2), path_resolution(7), symlink(7)この文書について¶
この man ページは Linux man-pages プロジェクトのリリース 3.41 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。2010-09-20 | Linux |