Current File : //usr/share/man/man3head/stat.h.3head

'\" te
.\" Copyright (c) 2009, Sun Microsystems, Inc.  All Rights Reserved
.\" Copyright 1989 AT&T
.TH stat.h 3HEAD "1 Sep 2009" "SunOS 5.11" "Headers"
.SH NAME
stat.h, stat \- data returned by stat system call
.SH SYNOPSIS
.LP
.nf
#include <sys/types.h>
#include <sys/stat.h>
.fi

.SH DESCRIPTION
.sp
.LP
The system calls \fBstat()\fR, \fBlstat()\fR and \fBfstat()\fR return data in a \fBstat\fR structure, which is defined in <\fBstat.h\fR>.
.sp
.LP
The constants used in the \fBst_mode\fR field are also defined in this file:
.sp

.sp
.TS
tab();
lw(.81i) lw(1.38i) lw(3.32i) 
lw(.81i) lw(1.38i) lw(3.32i) 
.
#defineS_IFMT/* type of file */
#defineS_IAMB/* access mode bits */
#defineS_IFIFO/* fifo */
#defineS_IFCHR/* character special */
#defineS_IFDIR/* directory */
#defineS_IFNAM/* \fBXENIX\fR special named file */ 
#defineS_INSEM/* \fBXENIX\fR semaphore subtype of \fBIFNAM\fR */
#defineS_INSHD/* \fBXENIX\fR shared data subtype of \fBIFNAM\fR */
#defineS_IFBLK/* block special */
#defineS_IFREG/* regular */
#defineS_IFLNK/* symbolic link */
#defineS_IFSOCK/* socket */
#defineS_IFDOOR/* door */
#defineS_ISUID/* set user id on execution */
#defineS_ISGID/* set group id on execution */
#defineS_ISVTX/* save swapped text even after use */
#defineS_IREAD/* read permission, owner */
#defineS_IWRITE/* write permission, owner */
#defineS_IEXEC/* execute/search permission, owner */
#defineS_ENFMT/* record locking enforcement flag */
#defineS_IRWXU/* read, write, execute: owner */
#defineS_IRUSR/* read permission: owner */
#defineS_IWUSR/* write permission: owner */
#defineS_IXUSR/* execute permission: owner */
#defineS_IRWXG/* read, write, execute: group */
#defineS_IRGRP/* read permission: group */
#defineS_IWGRP/* write permission: group */
#defineS_IXGRP/* execute permission: group */
#defineS_IRWXO/* read, write, execute: other */
#defineS_IROTH/* read permission: other */
#defineS_IWOTH/* write permission: other */
#defineS_IXOTH/* execute permission: other */
.TE

.sp
.LP
The following macros are for POSIX conformance (see \fBstandards\fR(5)):
.sp

.sp
.TS
tab();
lw(.78i) lw(1.43i) lw(3.29i) 
lw(.78i) lw(1.43i) lw(3.29i) 
.
#defineS_ISBLK(mode)block special file
#defineS_ISCHR(mode)character special file
#defineS_ISDIR(mode)directory file
#defineS_ISFIFO(mode)pipe or fifo file
#defineS_ISREG(mode)regular file
#defineS_ISSOCK(mode)socket file
.TE

.sp
.LP
The following symbolic constants are defined as distinct integer values outside of the range [0, 999 999 999], for use with the \fBfutimens()\fR and \fButimensat()\fR functions:
.sp
.in +2
.nf
#define    UTIME_NOW        use the current time
@define    UTIME_OMIT       no time change
.fi
.in -2

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
StandardSee \fBstandards\fR(5).
.TE

.SH SEE ALSO
.sp
.LP
\fBfutimens\fR(2), \fBstat\fR(2), \fBtypes.h\fR(3HEAD), \fBattributes\fR(5), \fBstandards\fR(5)