Home
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
Utilities & Libraries
C Library Reference
F
fstatat(), fstatat64()
Get information about a file or directory

QNX Momentics IDE User's Guide
This User's Guide describes version 8.0 of the Integrated Development Environment (IDE) that's part of the QNX Tool Suite.
QNX Software Development Platform
QNX SDP is a cross-compiling and debugging environment, including an IDE and command-line tools, for building binary images and programs for target boards running the QNX OS 8.0.
- Quickstart Guide
- System Architecture
  The System Architecture guide accompanies the QNX OS and is intended for both application developers and end-users.
- OS Components & Operations
- Graphics
- Programming
- System Security Guide
  The QNX System Security Guide is intended for both system integrators who are responsible for the security of a QNX OS system and developers who want to create a QNX OS resource manager free from vulnerabilities.
- Utilities & Libraries
  - C Library Reference
    - What's in a Function Description?
    - Manifests
    - Character Sets
    - A
    - B
    - C
    - D
    - E
    - F
      - fabs(), fabsf(), fabsl()
        Compute the absolute value of a double number
      - faccessat()
        Check if a file or directory at a given location can be accessed
      - fchdir()
        Change the working directory
      - fchecktrust()
        Determine if a file is trusted
      - fchmod()
        Change the permissions for a file
      - fchmodat()
        Change the permissions for a file at a given location
      - fchown()
        Change the user ID and group ID of a file
      - fchownat()
        Change the user ID and group ID of a file at a given location
      - fclose()
        Close a stream
      - fcloseall()
        Close all open stream files
      - fcntl()
        Provide control over an open file
      - fdatasync()
        Synchronize file data
      - fdim(), fdimf(), fdiml()
        Compute the positive difference between two floating-point numbers
      - fdistrusted()
        Determine if a file is trusted
      - fdopen()
        Associate a stream with a file descriptor
      - fdopendir()
        Open the directory associated with a file descriptor
      - feclearexcept()
        Clear the specified floating-point status flags
      - fedisableexcept()
        Mask the specified floating-point exceptions
      - feenableexcept()
        Unmask the specified floating-point exceptions
      - fegetenv()
        Get the current floating-point environment
      - fegetexceptflag()
        Get the states of the specified floating-point status flags
      - fegetprec()
        Get the floating-point precision
      - fegetround()
        Get the current floating-point rounding direction
      - feholdexcept()
        Save the floating-point environment, clear all flags, and ignore future errors
      - feof()
        Test a stream's end-of-file flag
      - feraiseexcept()
        Raise the specified floating-point exceptions
      - ferror()
        Test a stream's error flag
      - fesetenv()
        Set the current floating-point environment
      - fesetexceptflag()
        Set the states of the specified floating-point status flags
      - fesetprec()
        Set the floating-point precision
      - fesetround()
        Set the floating-point rounding direction
      - fetestexcept()
        Determine which of the specified floating-point status flags are set
      - feupdateenv()
        Restore the floating-point environment and raise any previously raised exceptions
      - fflush()
        Flush the buffers for a stream
      - ffs(), ffsl(), ffsll()
        Find the first bit that's set in a bit string
      - fgetc()
        Read a character from a stream
      - fgetpos()
        Get the current position of a stream
      - fgets()
        Read a string from a stream
      - fgetspent()
        Get an entry from the shadow password database
      - fgetwc()
        Read a wide character from a stream
      - fgetws()
        Read a string of wide characters from a stream
      - fileno()
        Return the file descriptor for a stream
      - flock()
        Apply or remove an advisory lock on an open file
      - flockfile()
        Acquire ownership of a file
      - floor(), floorf(), floorl()
        Round down a value to the next integer
      - fls(), flsl(), flsll()
        Find the last bit that's set in a bit string
      - fma(), fmaf(), fmal()
        Multiply two floating-point numbers and then add a third number
      - fmax(), fmaxf(), fmaxl()
        Determine the maximum of two floating-point numbers
      - fmin(), fminf(), fminl()
        Determine the minimum of two floating-point numbers
      - fmod(), fmodf(), fmodl()
        Compute a residue, using floating-point modular arithmetic
      - fnmatch(), _fnmatchv()
        Check to see if a file or path name matches a pattern
      - fopen(), fopen64()
        Open a file stream
      - fork()
        Create a new process
      - forkpty()
        Create a new process operating in a pseudo-tty
      - forksafe_mutex_destroy()
        Destroy a forksafe mutex
      - forksafe_mutex_init()
        Initialize a forksafe mutex
      - forksafe_mutex_lock()
        Lock a forksafe mutex
      - forksafe_mutex_trylock()
        Attempt to lock a forksafe mutex
      - forksafe_mutex_unlock()
        Unlock a forksafe mutex
      - fpathconf()
        Return the value of a configurable limit associated with a file
      - fpclassify()
        Categorize a floating-point number
      - fprintf()
        Write output to a stream
      - fputc()
        Write a character to a stream
      - fputs()
        Write a string to an output stream
      - fputwc()
        Write a wide character to a stream
      - fputws()
        Write a wide-character string to an output stream
      - fread()
        Read elements of a given size from a stream
      - free()
        Deallocate a block of memory
      - freopen(), freopen64()
        Reopen a stream
      - frexp(), frexpf(), frexpl()
        Break a floating-point number into a normalized fraction and an integral power of 2
      - fs_crypto_check()
        Determine if the underlying filesystem supports encryption
      - fs_crypto_domain_add()
        Create a domain
      - fs_crypto_domain_add_flags()
        Create an encryption domain and unlock it if requested
      - fs_crypto_domain_hard_lock()
        Lock a domain
      - fs_crypto_domain_key_change()
        Change the key needed to unlock the specified domain
      - fs_crypto_domain_key_check()
        Determine if a given domain key is valid
      - fs_crypto_domain_key_size()
        Return the size of keys needed by the filesystem encryption
      - fs_crypto_domain_lock()
        Lock a domain
      - fs_crypto_domain_query()
        Get status information for a domain
      - fs_crypto_domain_remove()
        Destroy a domain
      - fs_crypto_domain_unlock()
        Unlock a domain
      - fs_crypto_domain_whitelist_configure()
        Perform whitelist configuration for a domain whitelist
      - fs_crypto_domain_whitelist_ctrl()
        Perform a control action for a domain whitelist
      - fs_crypto_domain_whitelist_ctrl_access_grant()
        Grant a client access to a domain
      - fs_crypto_domain_whitelist_ctrl_access_revoke()
        Revoke a client's access to a domain
      - fs_crypto_domain_whitelist_get_flags()
        Get the flags for a domain whitelist
      - fs_crypto_domain_whitelist_set_flags()
        Perform whitelist configuration for a domain whitelist
      - fs_crypto_enable()
        Enable encryption support on a filesystem
      - fs_crypto_enable_option()
        Enable encryption support on a filesystem
      - fs_crypto_file_get_domain()
        Get the domain of a file or directory
      - fs_crypto_file_set_domain()
        Set the domain of a file or directory
      - fs_crypto_key_gen()
        Generate an encryption key from a password
      - fs_crypto_migrate_control()
        Control encryption migration within the filesystem
      - fs_crypto_migrate_path()
        Mark an entire directory for migration into an encryption domain
      - fs_crypto_migrate_status()
        Get the status of migration in the filesystem
      - fs_crypto_migrate_tag()
        Mark a file for migration into an encryption domain
      - fs_crypto_set_logging()
        Set the logging destination and verbosity
      - fscanf()
        Scan input from a stream
      - fseek(), fseeko(), fseeko64()
        Change the current position of a stream
      - fsetpos()
        Set the current position of a file
      - fstat(), fstat64()
        Get file information, given a file description
      - fstatat(), fstatat64()
        Get information about a file or directory
      - fstatvfs(), fstatvfs64()
        Get filesystem information, given a file descriptor
      - fsync()
        Synchronize the file state
      - ftell(), ftello(), ftello64()
        Return the current position of a stream
      - ftime()
        Get the current time
      - ftruncate(), ftruncate64()
        Truncate a file
      - ftrylockfile()
        Acquire ownership of a file, without blocking
      - ftw(), ftw64()
        Walk a file tree
      - funlockfile()
        Release ownership of a file
      - futime()
        Record the modification time for a file
      - futimens()
        Set the access and modification times for a file
      - fwide()
        Set and get the stream orientation
      - fwprintf()
        Write wide-character output to a stream
      - fwrite()
        Write elements to a file
      - fwscanf()
        Scan wide-character input from a stream
    - G
    - H
    - I
    - J
    - K
    - L
    - M
    - N
    - O
    - P
    - Q
    - R
    - S
    - T
    - U
    - V
    - W
    - X
    - Y
    - Z
    - Full Safety Information
    - Glossary
  - Devctl and Ioctl Commands
  - JSON Library Reference
  - PAM Reference
  - QNX Helpers Developer's Guide
    These libraries provide QNX helpers, including helpers that assist with logging, string conversion, and number and type sizes.
  - SPI Framework Technote
  - Utilities Reference
  - WPA Control Interface Reference
    This document provides a reference for the Wi-Fi Protected Access (WPA) control interface, which provides a C API for the WPA/IEEE 802.11i protocols in Wi-Fi client stations. Application developers who want to control WPA operations and get associated status and event data should read this reference.
- Migrating to QNX OS 8.0
QNX Software in the Cloud
QNX Toolkit for Visual Studio Code
This User's Guide describes the QNX^® Toolkit for Visual Studio Code. The guide introduces you to the QNX Toolkit by explaining the QNX development environment and how to build, run, and debug your QNX^® Operating System (OS) applications and systems.
Typographical Conventions, Support, and Licensing
This section describes the typographical conventions used throughout the documentation, explains how to obtain technical support, and provides some information about licensing.

fstatat(), fstatat64()

QNX SDP8.0C Library ReferenceAPIDeveloper

Get information about a file or directory

Synopsis:

#include <sys/stat.h>

int fstatat( const int fd,
             const char* path, 
             struct stat* buf,
             int flags );

int fstatat64( const int fd,
               const char* path, 
               struct stat64* buf,
               int flags );

Arguments:

fd

The file descriptor of a directory that you want a relative path to be relative to, or AT_FDCWD to make a relative path be relative to the current working directory.

Note:

You must currently pass AT_FDCWD for this argument.

path

The path of the file or directory that you want information about.

buf

A pointer to a struct stat or struct stat64 buffer where the function can store the information.

flag

Flags that affect the behavior of the function; 0 or the following:

AT_SYMLINK_NOFOLLOW — if path names a symbolic link, get information about the link itself.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The fstatat() and fstatat64() functions obtain information about the file or directory referenced in path. This information is placed in the structure located at the address indicated by buf.

Note:

The fstatat64() function is a large-file support version of fstatat() provided for backwards compatibility. If you're using large-file support functions and data types, you should define _LARGEFILE64_SOURCE with a value of 1 to ensure they appear in the name space. For more information, see Classification in What's in a Function Description?.

The results of the fstatat() function are the same as the results of lstat() or stat(), depending on whether or not AT_SYMLINK_NOFOLLOW is set in the flags.

Returns:

0: Success.
-1: An error occurred (errno is set).

Errors:

The same as stat(), as well as the following:

EINVAL: The value of the flag argument was invalid.
ENOTSUP: The value of fd wasn't AT_FDCWD.

Classification:

fstatat() is POSIX 1003.1; fstatat64() is Large-file support


Safety:
Cancellation point	No
Signal handler	Yes
Thread	Yes

Page updated: December 04, 2024