lstat()、lstat64() — ファイル/シンボリック・リンクの状況の取得

S_ISBLK(mode)

ブロック特殊ファイルに対してゼロ以外です。

S_ISCHR(mode)

文字特殊ファイルに対してゼロ以外です。

S_ISDIR(mode)

ディレクトリーに対してゼロ以外です。

S_ISEXTL(mode,genvalue)

外部リンクに対してゼロ以外です。

S_ISFIFO(mode)

パイプおよび FIFO 特殊ファイルに対してゼロ以外です。

S_ISLNK(mode)

シンボリック・リンクに対してゼロ以外です。

S_ISREG(mode)

通常のファイルに対してゼロ以外です。

S_ISSOCK(mode)

ソケットに対してゼロ以外です。

エラー・コード

説明

EACCES

プロセスに、pathname 接頭部の一部のコンポーネントの検索許可がありません。

EINVAL

buf に NULL が入っています。

EIO

XPG4.2 の追加事項: ファイル・システムからの読み取り中に、入出力エラーが発生しました。

ELOOP

ループがシンボリック・リンクに存在しています。このエラーは、pathname 引数の解析中に検出されたシンボリック・ リンクの数が POSIX_SYMLOOP より大きい場合に発生します。

ENAMETOOLONG

_POSIX_NO_TRUNC が有効ですが、pathname が PATH_MAX 文字より長いか、または pathname の一部のコンポーネントが NAME_MAX 文字より長くなっています。シンボリック・リンクの場合、シンボリック・リンクの代替となる pathname ストリングの長さが PATH_MAX を超えています。PATH_MAX と NAME_MAX の値は、pathconf() を使用して確認できます。

ENOENT

pathname という名前のファイルが存在しないか、または pathname が空ストリングです。

ENOTDIR

pathname の接頭部のコンポーネントが ディレクトリーではありません。

EOVERFLOW

ファイル・サイズ (バイト数) またはファイルの割り振られたブロックの数、またはファイル・シリアル番号を、buf が指す構造体に正しく表すことができません。

注: z/OS V1.9 以降、環境変数 _EDC_EOVERFLOW は、z/OS UNIX ファイルの EOVERFLOW 条件の検出に関する lstat() の動作を制御するために使用できます。デフォルトでは、buf が指す構造体にファイル・サイズを正しく表すことができない場合、lstat() は EOVERFLOW を設定しません。_EDC_EOVERFLOW が YES に設定された場合、lstat() はオーバーフロー条件を確認します。

/* CELEBL12

   This example provides status information for a file.

 */
#define _POSIX_SOURCE
#include <fcntl.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
#undef _POSIX_SOURCE
#include <stdio.h>
#include <time.h>

main() {
  char fn[]="temp.file", ln[]="temp.link";
  struct stat info;
  int fd;

  if ((fd = creat(fn, S_IWUSR)) < 0)
    perror("creat() error");
  else {
    close(fd);
    if (link(fn, ln) != 0)
      perror("link() error");
    else {
      if (lstat(ln, &info) != 0)
        perror("lstat() error");
      else {
        puts("lstat() returned:");
        printf("  inode:   %d¥n",   (int) info.st_ino);
        printf(" dev id:   %d¥n",   (int) info.st_dev);
        printf("   mode:   %08x¥n",       info.st_mode);
        printf("  links:   %d¥n",         info.st_nlink);
        printf("    uid:   %d¥n",   (int) info.st_uid);
        printf("    gid:   %d¥n",   (int) info.st_gid);
        printf("created:   %s",           ctime(&info.st_createtime));
      }
      unlink(ln);
    }
    unlink(fn);
  }
}

lstat() returned:
  inode:   3022
 dev id:   1
   mode:   03000080
  links:   2
    uid:   25
    gid:   500
created:   Fri Jun 16 15:00:00 2006