名前¶

書式¶

#include <unistd.h>

ssize_t readlink(const char *pathname, char *buf, size_t bufsiz);

#include <fcntl.h>           /* AT_* 定数の定義 */
#include <unistd.h>

ssize_t readlinkat(int dirfd, const char *pathname,
                   char *buf, size_t bufsiz);

readlink():

readlinkat():

説明¶

返り値¶

エラー¶

EACCES

パスのディレクトリ部分に検索許可が与えられていない (path_resolution(7) も参照すること)。

EFAULT

buf がプロセスに割り当てられたアドレス空間の外を指している。

EINVAL

bufsiz が正でない。

EINVAL

指定したファイルがシンボリックリンクでない。

EIO

ファイルシステムの読み込み中に I/O エラーが起こった。

ELOOP

パス名にシンボリックリンクが多すぎる。

ENAMETOOLONG

パス名かパス名の一部分が長過ぎる。

ENOENT

その名前のファイルが存在しない。

ENOMEM

十分なカーネルメモリーがない。

ENOTDIR

パスのディレクトリ部分がディレクトリでない。

readlinkat() では以下のエラーも発生する。

EBADF

dirfd が有効なファイルディスクリプターではない。

ENOTDIR

pathname が相対パスで、 dirfd がディレクトリ以外のファイルを参照しているファイルディスクリプターである。

バージョン¶

準拠¶

readlinkat(): POSIX.1-2008.

注意¶

静的な大きさのバッファーを使うと、 シンボリックリンクの内容を格納するのに十分な領域がない場合がある。 バッファーに必要なサイズは、 そのシンボリックリンクに対して lstat(2) の呼び出しで返される stat.st_size の値から取得できる。 ただし、 readlink() や readlinkat() が書き込んだバイト数をチェックして、 シンボリックリンクのサイズが二つの呼び出しの間で増えていないことを確認すべきである。 readlink() や readlinkat() 用のバッファーを動的に割り当てる方法でも、 バッファーサイズとして PATH_MAX を使用する場合に共通する移植性の問題を解決することができる。 なぜなら、POSIX では、 システムがそのような上限値を定義していない場合には、 PATH_MAX が定義されることが保証されていないからである。

例¶

#include <sys/types.h>
#include <sys/stat.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
int
main(int argc, char *argv[])
{
    struct stat sb;
    char *linkname;
    ssize_t r;
    if (argc != 2) {
        fprintf(stderr, "Usage: %s <pathname>\n", argv[0]);
        exit(EXIT_FAILURE);
    }
    if (lstat(argv[1], &sb) == -1) {
        perror("lstat");
        exit(EXIT_FAILURE);
    }
    linkname = malloc(sb.st_size + 1);
    if (linkname == NULL) {
        fprintf(stderr, "insufficient memory\n");
        exit(EXIT_FAILURE);
    }
    r = readlink(argv[1], linkname, sb.st_size + 1);
    if (r == -1) {
        perror("readlink");
        exit(EXIT_FAILURE);
    }
    if (r > sb.st_size) {
        fprintf(stderr, "symlink increased in size "
                        "between lstat() and readlink()\n");
        exit(EXIT_FAILURE);
    }
    linkname[r] = '\0';
    printf("'%s' points to '%s'\n", argv[1], linkname);
    free(linkname);
    exit(EXIT_SUCCESS);
}

関連項目¶

この文書について¶