build: Better Build System

1 files changed, 128 insertions, 0 deletions

diff --git a/static/unix-v10/man2/stat.2 b/static/unix-v10/man2/stat.2
new file mode 100644
index 00000000..03d25626
--- /dev/null
+++ b/static/unix-v10/man2/stat.2
@@ -0,0 +1,128 @@
+.TH STAT 2
+.CT 2 file_inq_creat
+.SH NAME
+stat, lstat, fstat \(mi get file status
+.SH SYNOPSIS
+.nf
+.B #include <sys/types.h>
+.B #include <sys/stat.h>
+.PP
+.B int stat(name, buf)
+.B char *name;
+.B struct stat *buf;
+.PP
+.B int lstat(name, buf)
+.B char *name;
+.B struct stat *buf;
+.PP
+.B int fstat(fildes, buf)
+.B struct stat *buf;
+.fi
+.SH DESCRIPTION
+.I Stat
+puts detailed information about the file
+.I name
+in a structure whose address is
+.IR buf .
+.I Lstat
+does the same except when
+.I name
+is a symbolic
+link (see
+.IR link (2)),
+in which case it
+supplies information about the link itself.
+.I Fstat
+does the same for an open file
+known by a file descriptor.
+.PP
+It is unnecessary to have any
+permissions at all with respect to
+.IR name ,
+but all directories
+leading to the file must be searchable.
+.nf
+.ta \w'\fLnnnnnnnn\fP'u +\w'\fLunsigned short st_mode; \fP'u
+\fLstruct stat
+{
+	\fLdev_t st_dev;\fR	major/minor device numbers for the inode
+	\fLino_t st_ino;\fP	inode number
+	\fLunsigned short st_mode;\fP	file mode encoded as below
+	\fLshort st_nlink;\fP	number of links (not symbolic links)
+	\fLshort st_uid;\fP	uid of owner
+	\fLshort st_gid;\fP	gid of owner
+	\fLdev_t st_rdev;\fP	if special, the major/minor device numbers
+	\fLoff_t st_size;\fP	size in bytes
+	\fLtime_t st_atime;\fP	time file was last read or created
+	\fLtime_t st_mtime;\fP	time file was last written or created
+	\fLtime_t st_ctime;\fP	time file or inode was last written or created
+\fL};\fP
+.fi
+.PP
+For reasons of efficiency,
+.B st_atime
+is not set when a directory
+is searched, although this might be more logical.
+.PP
+The bits in
+.B st_mode
+are defined by
+.nf
+.ft L
+.ta 12n 22n
+.ft P
+\fLS_IFMT	0170000\fP	file type
+\fLS_IFDIR	0040000\fP	directory
+\fLS_IFCHR	0020000\fP	special character device
+\fLS_IFBLK	0060000\fP	special block device
+\fLS_IFREG	0100000\fP	regular file
+\fLS_IFLNK	0120000\fP	symbolic link
+\fLS_ISUID	0004000\fP	set userid on execution
+\fLS_ISGID	0002000\fP	set groupid on execution
+\fLS_ICCTYP	0007000\fP	type of concurrency control
+\fLS_ISYNC	0001000\fP	1 writer and n readers (synchronized access)
+\fLS_IEXCL	0003000\fP	1 writer or n readers (exclusive access)
+\fLS_IAPPEND	0005000\fP	append-only file
+\fLS_IBLIND	0007000\fP	blind directory
+\fL	0000400\fP	read by owner
+\fL	0000200\fP	write by owner
+\fL	0000100\fP	execute (search on directory) by owner
+\fL	0000070\fP	read, write, execute (search) by group
+\fL	0000007\fP	read, write, execute (search) by others
+.fi
+.PP
+.B S_IFMT
+and
+.B S_ICCTYP
+are field masks; the other constants encode modes.
+Codes contained in the 
+.B S_IFMT
+field are mutually exclusive.
+Codes containing bit 01000 are incompatible with other
+codes contained in the
+.B S_ICCTYP
+field.
+.PP
+.I Fstat,
+which reads the inode,
+and
+.IR write (2)
+can be performed on the same file descriptor only if
+the security labels of file and process reach the same value
+or if the process has capability
+.BR T_NOCHK .
+.SH "SEE ALSO"
+.IR chmod (1), 
+.IR ls (1), 
+.IR stat (1),
+.IR chmod (2), 
+.IR filsys (5)
+.SH DIAGNOSTICS
+.BR EACCES ,
+.BR EBADF ,
+.BR EFAULT ,
+.BR EIO ,
+.BR ELAB ,
+.BR ELOOP ,
+.BR ENOENT ,
+.BR ENOTDIR