Open System Services System Calls Reference Manual (G06.28+, H06.05+)

lstat64(2) OSS System Calls Reference Manual
NAME
lstat64 - Provides information about a symbolic link or any file
LIBRARY
G-series native Guardian processes: system library
G-series native OSS processes: system library
H-series native Guardian processes: implicit libraries
H-series OSS processes: implicit libraries
SYNOPSIS
#include <sys/stat.h>
int lstat64(
const char *path,
struct stat64 *buffer);
PARAMETERS
path Points to the pathname of a file. If used for a symbolic link, the
path parameter points to the pathname of the symbolic link iden-
tifying the file.
buffer Points to a stat64 structure, into which information is placed
about the file.
DESCRIPTION
The lstat64() function is similar to the lstat() function except that, in addition to supporting
smaller files, the lstat64( ) function supports OSS files larger than approximately 2 gigabytes.
An application can explicitly call this function when you compile the application using the
#define _LARGEFILE64_SOURCE 1 feature test macro or an equivalent compiler command
option.
An application call to lstat( ) is automatically mapped to this function when you compile the
application using the #define _FILE_OFFSET_BITS 64 feature test macro or an equivalent
compiler command option.
The lstat64() function obtains information about the symbolic link whose name is pointed to by
the path parameter or about any file pointed to by the path parameter.
The lstat64() function is like the stat64() or fstat64( ) function, except that lstat64( ) returns
information about the link, while the stat64() and fstat64() functions return information about
the file that the link refers to.
Read, write, or execute permission for the named file is not required, but all directories listed in
the pathname leading to the file must be searchable.
4−38 Hewlett-Packard Company 527186-007