fstat64()--Get File Information by Descriptor (Large File Enabled)

 #include <sys/stat.h>

 int fstat64(int fildes, struct stat64 *buf);  

The fstat64() function gets status information about the file specified by the open file descriptor file_descriptor and stores the information in the area of memory indicated by the buf argument. The status information is returned in a stat64 structure, as defined in the <sys/stat.h> header file.

fstat64() is enabled for large files. It is capable of operating on files larger than 2GB minus 1 byte as long as the file has been opened by either of the following:

• Using the open64() function (see open64()--Open File (Large File Enabled)).
• Using the open() function (see open()--Open File) with O_LARGEFILE set in the oflag parameter.

The elements of the stat64 structure are described in stat64()--Get File Information (Large File Enabled).

For additional information about parameters, authorities required, and error conditions, see fstat()--Get File Information by Descriptor.

Usage Notes

1. When you develop in C-based languages, the prototypes for the 64-bit APIs are normally hidden. To use the fstat64() API and the struct stat64 data type, you must compile the source with the _LARGE_FILE_API macro defined.
   
2. All of the usage notes for fstat() apply to fstat64(). See Usage Notes in the fstat() API.

Example

The following example gets status information.

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.

#define _LARGE_FILE_API
#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>
#include <stdio.h>
#include <time.h>

main() {
  char fn[]="temp.file";
  struct stat64 info;
  int file_descriptor;

  if ((file_descriptor = creat64(fn, S_IWUSR)) < 0)
    perror("creat64() error");
  else {
    if (ftruncate64(file_descriptor, 8589934662) != 0)
      perror("ftruncate64() error");
    else {
      if (fstat64(file_descriptor, &info) != 0)
        perror("fstat64() error");
      else {
        puts("fstat64() 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("   size:   %lld\n", (long long) info.st_size);
      }
    }
    close(file_descriptor);
    unlink(fn);
  }
}

Output: Note that the output may vary from system to system.

fstat64() returned:
  inode:   3057
 dev id:   1
   mode:   03000080
  links:   1
    uid:   137
    gid:   500
   size:   8589934662

[ Back to top | UNIX-Type APIs | APIs by category ]