READLINK

Section: System Calls (2)
索引 jman

BSD mandoc

名称

readlink - シンボリックリンクの値を読み取る

ライブラリ

Lb libc

書式

In unistd.h Ft int Fn readlink const char *path char *buf int bufsiz

解説

Fn readlink システムコールは、 Fa bufsiz サイズであるバッファ Fa buf 内にシンボリックリンク Fa path の内容を配置します。 Fn readlink システムコールは Fa buf の末尾に NUL 文字を追加しません。

戻り値

呼び出しが正常に完了した場合、バッファ内に配置した文字数を返します。エラーが起きた場合は -1 を返し、エラーコードがグローバル変数 errno に設定されます。

エラー

Fn readlink システムコールは次の場合に失敗します:

Bq Er ENOTDIR: パスの構成要素中にディレクトリ以外のものが含まれています。
Bq Er ENAMETOOLONG: パス名の構成要素が 255 文字を越えているか、またはパス名全体が 1023 文字を越えています。
Bq Er ENOENT: 指定されたファイルが存在しません。
Bq Er EACCES: 指定されたパスには、検索が許可されていないディレクトリが含まれています。
Bq Er ELOOP: パス名を変換するときに検出されたシンボリックリンクが多すぎます。
Bq Er EINVAL: 指定のファイルがシンボリックリンクではありません。
Bq Er EIO: ファイルシステムから読み取る間に入出力エラーが発生しました。
Bq Er EFAULT: Fa buf 引数が、プロセスに割り当てられたアドレス空間の範囲外を指しています。

関連項目

lstat(2), stat(2), symlink(2), symlink(7)

歴史

Fn readlink システムコールは BSD 4.2 で登場しました。

Index

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

Time: 07:06:29 GMT, January 12, 2009