REALPATH

名前

書式

#include <limits.h>
#include <stdlib.h>

char *realpath(const char *path, char *resolved_path);

glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):

realpath(): _BSD_SOURCE || _XOPEN_SOURCE >= 500  

説明

返り値

それ以外の場合は、ヌル (NULL) ポインターが返り、配列 resolved_path の内容は不定である。 グローバル変数 errno がエラーの内容にあわせてセットされる。  

エラー

EACCES

パスのディレクトリ部分に、読み出し許可または検索許可が与えられていない。

EINVAL

path か resolved_path のいずれかが NULL である。 (libc5 では、このような場合 segfault を起こすだけであろう) 但し、下記の「注意」の節を参照のこと。

EIO

ファイルシステムを読むときに、I/Oエラーが起こった。

ELOOP

パス名の変換にあたり、解決すべきシンボリック・リンクの数が多過ぎた。

ENAMETOOLONG

パス名の一要素の文字数が NAME_MAX を越えている、またはパス名全体の文字数が PATH_MAX を越えている。

ENOENT

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

ENOTDIR

パスのディレクトリ要素が、ディレクトリでない。

バージョン

準拠

4.4BSD と Solaris では、パス名の長さの上限は (<sys/param.h> の中にある) MAXPATHLEN である。SUSv2 では PATH_MAX と NAME_MAX が規定されており、 これらは <limits.h> で定義されているか、 pathconf(3) 関数から得られる。以下のようなソースコードになっていることが多い (バグの章も参照のこと) :

#ifdef PATH_MAX
  path_max = PATH_MAX;
#else
  path_max = pathconf(path, _PC_PATH_MAX);
  if (path_max <= 0)
         path_max = 4096;
#endif

4.4BSD、Linux、SUSv2 では、返り値は常に絶対パス名である。 Solaris では、 引き数 path が相対パスの場合、返り値が相対パスになることがある。 realpath() のプロトタイプ宣言は、 libc4 と libc5 では <unistd.h> にあるが、 それ以外の環境ではいずれも <stdlib.h> にある。  

注意

バグ

libc4 と libc5 の実装はバッファ・オーバーフローの可能性を持っている (libc-5.4.13 で修正されたが)。したがって、mount のような set-user-ID されるプログラムでは、この関数相当の関数を自前で持つ必要がある。  

関連項目

Index

名前

書式

説明

返り値

エラー

バージョン

準拠

注意

バグ

関連項目