Go to main content
Oracle Developer Studio 12.5 Man Pages

Exit Print View

Updated: June 2017
 
 

stat64(3F)

Name

stat64, lstat64, fstat64 - get file status for long files

Synopsis

integer*4 function stat64(name,statb)
character*(*) name
integer*8 statb(13)
integer*4 function lstat64(name,statb)
character*(*) name
integer*8 statb(13)
integer*4 function fstat64(lunit,statb)
integer*8 statb(13)

Description

These routines return detailed information about a file.

They are versions of the corresponding routines stat, lstat, and fstat, that utilize a 64-bit integer status array to return information about long files (Solaris 2.6 and 2.7).

The functions stat64 and lstat64 do the query by filename.

The function fstat64 does the query by FORTRAN logical unit lunit.

The value of each function is zero if successful, and an error code otherwise.

The variable statb receives the status structure for the file.

Calling Sequences:

stat64:
integer*4 stat64
integer*8 statb(13)
character name*(*)
ierr = stat64 ( name, statb )

fstat64:
integer*4 fstat64, logunit
integer*8 statb(13)
ierr = fstat64 ( logunit, statb )

lstat64:
integer*4 lstat64
integer*8 statb(13)
character name*(*)
ierr = lstat64 ( name, statb )

The meaning of the information returned in the array statb is as described for the structure stat under stat(2).

Spare values are not included. The order is:

 
statb(1)        device inode resides on
statb(2)        this inode's number
statb(3)        protection
statb(4)        number of hard links to the file
statb(5)        user id of owner
statb(6)        group id of owner
statb(7)        the device type, for inode that is device
statb(8)        total size of file
statb(9)        file last access time
statb(10)       file last modify time
statb(11)       file last status change time
statb(12)       optimal blocksize for file system i/o ops
statb(13)       actual number of blocks allocated

NOTE

stat64 calls stat(2) in the libc library, while lstat64 calls lstat(2). For the differences between these two libc functions, see the stat(2) man page. In brief, they differ when the named file is a symbolic link; lstat64 will return information about the link, while stat64 will return information about the file the link references.

Files

libfsu.a

See Also

stat(2), stat(3F) access(3F), perror(3F), time(3F)

Bugs

Path names cannot be longer than MAXPATHLEN as defined in <sys/param.h>.