BSD 4_3 release
[unix-history] / usr / man / man3 / stat.3f
index 00937f3..d09ad54 100644 (file)
@@ -1,20 +1,35 @@
-.TH STAT 3F "19 January 1983"
+.\" Copyright (c) 1983 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)stat.3f     6.1 (Berkeley) 5/15/85
+.\"
+.TH STAT 3F "May 15, 1985"
+.UC 5
 .SH NAME
 .SH NAME
-stat, fstat \- get file status
+stat, lstat, fstat \- get file status
 .SH SYNOPSIS
 .B integer function stat (name, statb)
 .br
 .B character*(*) name
 .br
 .SH SYNOPSIS
 .B integer function stat (name, statb)
 .br
 .B character*(*) name
 .br
-.B integer statb(11)
+.B integer statb(12)
+.sp 1
+.B integer function lstat (name, statb)
+.br
+.B character*(*) name
+.br
+.B integer statb(12)
 .sp 1
 .B integer function fstat (lunit, statb)
 .br
 .sp 1
 .B integer function fstat (lunit, statb)
 .br
-.B integer statb(11)
+.B integer statb(12)
 .SH DESCRIPTION
 These routines return detailed information about a file.
 .I Stat
 .SH DESCRIPTION
 These routines return detailed information about a file.
 .I Stat
-returns information about file
+and
+.I lstat
+return information about file
 .IR name ;
 .I fstat
 returns information about the file associated with fortran logical unit
 .IR name ;
 .I fstat
 returns information about the file associated with fortran logical unit
@@ -24,7 +39,8 @@ The order and meaning of the information returned in array
 is as described for the structure
 .I stat
 under
 is as described for the structure
 .I stat
 under
-.IR stat (2)
+.IR stat (2).
+The ``spare'' values are not included.
 .PP
 The value of either function will be zero if successful;
 an error code otherwise.
 .PP
 The value of either function will be zero if successful;
 an error code otherwise.
@@ -33,3 +49,6 @@ an error code otherwise.
 .el /usr/lib/libU77.a
 .SH "SEE ALSO"
 stat(2), access(3F), perror(3F), time(3F)
 .el /usr/lib/libU77.a
 .SH "SEE ALSO"
 stat(2), access(3F), perror(3F), time(3F)
+.SH BUGS
+Pathnames can be no longer than MAXPATHLEN as defined in
+.RI < sys/param.h >.