OpenVMS マニュアル

readlink (Integrity, Alpha)

指定したシンボリック・リンクの内容を読み取って，ユーザの指定したバッファに格納します。

形式

#include <unistd.h>

ssize_t readlink (const char *restrict link_name, char *restrict user_buffer, size_t buffer_size);

引数

link_name

シンボリック・リンク・ファイルの名前を示すテキスト文字列へのポインタ。

user_buffer

ユーザ・バッファへのポインタ。

buffer_size

ユーザ・バッファのサイズ。

説明

readlink関数は，指定したシンボリック・リンク (link_name) の内容を読み取って，ユーザの指定した，サイズが buffer_size のバッファ (user_buffer) に格納します。

symlink， unlink， realpath， lchown，および lstatも参照してください。

戻り値

n	成功したことを示します。n は， user_buffer に格納されたバイト数です。
-1	エラーが発生したことを示します。バッファは変更されておらず， errno に，エラーを示す次のいずれかの値が設定されます。 EACCES ---(1) 読み取り対象のシンボリック・リンクがあるディレクトリに，このユーザの読み取り許可が設定されていないか， (2) link_name のパス接頭辞に，検索許可のないコンポーネントが存在しています。 ENAMETOOLONG ---(1) link_name 引数の長さが PATH_MAX を超えているか， (2) パス名に，長さが NAME_MAX を超えるコンポーネントが存在しています。 close ， open ，または read から返された errno の値。