开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 操作系统开发 > 查看源码
STAT.2
资源名称：os_source.zip　[点击查看]
上传用户：datang2001
上传日期：2007-02-01
资源大小：53269k
文件大小：4k
源码类别：

操作系统开发

开发平台：

C/C++

STAT.2：源码内容
  1. ." Copyright (c) 1980 Regents of the University of California.
  2. ." All rights reserved.  The Berkeley software License Agreement
  3. ." specifies the terms and conditions for redistribution.
  4. ."
  5. ." @(#)stat.2 6.5 (Berkeley) 5/12/86
  6. ."
  7. .TH STAT 2 "May 12, 1986"
  8. .UC 4
  9. .SH NAME
  10. stat, lstat, fstat - get file status
  11. .SH SYNOPSIS
  12. .nf
  13. .ft B
  14. #include <sys/types.h>
  15. #include <sys/stat.h>
  17. .ta +54n
  18. int stat(const char *fIpathfP, struct stat *fIbuffP)
  19. int lstat(const char *fIpathfP, struct stat *fIbuffP) (Minix-vmd)
  20. int fstat(int fIfdfP, struct stat *fIbuffP)
  21. .fi
  22. .ft R
  23. .SH DESCRIPTION
  24. .B Stat
  25. obtains information about the file
  26. .IR path .
  27. Read, write or execute
  28. permission of the named file is not required, but all directories
  29. listed in the path name leading to the file must be reachable.
  30. .PP
  31. .B Lstat
  32. is like fBstatfP except in the case where the named file is a symbolic link,
  33. in which case
  34. .B lstat
  35. returns information about the link,
  36. while
  37. .B stat
  38. returns information about the file the link references.
  39. (Minix-vmd)
  40. .PP
  41. .B Fstat
  42. obtains the same information about an open file
  43. referenced by the argument descriptor, such as would
  44. be obtained by an fBopenfP call.  Pipe descriptors
  45. look like named pipes with a link count of zero.  The
  46. st_size field of pipes or named pipes shows the amount of
  47. bytes currently buffered in the pipe.
  48. .PP
  49. .I Buf
  50. is a pointer to a
  51. .B stat
  52. structure into which information is placed concerning the file.
  53. The contents of the structure pointed to by
  54. .I buf
  55. is as follows:
  56. .PP
  57. .if t .RS
  58. .nf
  59. .ta +0.4i +0.8i +1i
  60. struct stat {
  61. dev_t st_dev; /* device inode resides on */
  62. ino_t st_ino; /* this inode's number */
  63. mode_t st_mode; /* file mode, protection bits, etc. */
  64. nlink_t st_nlink; /* number or hard links to the file */
  65. uid_t st_uid; /* user-id of the file's owner */
  66. gid_t st_gid; /* group-id of the file's owner */
  67. dev_t st_rdev; /* the device type, for inode that is device */
  68. off_t st_size; /* total size of file */
  69. time_t st_atime; /* time of last access */
  70. time_t st_mtime; /* time of last data modification */
  71. time_t st_ctime; /* time of last file status change */
  72. };
  73. .fi
  74. .if t .RE
  75. .DT
  76. .PP
  77. .TP 12
  78. st_atime
  79. Time when file data was last read or modified.  Changed by the following system
  80. calls:
  81. .BR mknod (2),
  82. .BR utime (2),
  83. .BR read (2),
  84. and
  85. .BR write (2).
  86. For reasons of efficiency, 
  87. st_atime is not set when a directory
  88. is searched, although this would be more logical.
  89. .TP 12
  90. st_mtime
  91. Time when data was last modified.
  92. It is not set by changes of owner, group, link count, or mode.
  93. Changed by the following system calls:
  94. .BR mknod (2),
  95. .BR utime (2),
  96. .BR write (2).
  97. .TP 12
  98. st_ctime
  99. Time when file status was last changed.
  100. It is set both both by writing and changing the i-node.
  101. Changed by the following system calls:
  102. .BR chmod (2)
  103. .BR chown (2),
  104. .BR link (2),
  105. .BR mknod (2),
  106. .BR rename (2),
  107. .BR unlink (2),
  108. .BR utime (2),
  109. .BR write (2).
  110. .PP
  111. The file type information in fBst_modefP has bits:
  112. .PP
  113. .nf
  114. .in +5n
  115. .ta 1.6i 2.5i 3i
  116. #define S_IFMT 0170000 /* type of file */
  117. #define    S_IFIFO 0010000 /* named pipe */
  118. #define    S_IFCHR 0020000 /* character special */
  119. #define    S_IFDIR 0040000 /* directory */
  120. #define    S_IFBLK 0060000 /* block special */
  121. #define    S_IFREG 0100000 /* regular */
  122. #define    S_IFLNK 0120000 /* symbolic link (Minix-vmd) */
  123. .fi
  124. .in -5n
  125. .PP
  126. The mode bits 0007777 encode set-uid/gid bits and
  127. permission bits (see
  128. .BR chmod (2)).
  129. .SH "RETURN VALUE
  130. Upon successful completion a value of 0 is returned.
  131. Otherwise, a value of -1 is returned and
  132. .B errno
  133. is set to indicate the error.
  134. .SH "ERRORS
  135. .B Stat
  136. and
  137. .B lstat
  138. will fail if one or more of the following are true:
  139. .TP 15
  140. [ENOTDIR]
  141. A component of the path prefix is not a directory.
  142. .TP 15
  143. [ENAMETOOLONG]
  144. The path name exceeds PATH_MAX characters.
  145. .TP 15
  146. [ENOENT]
  147. The named file does not exist.
  148. .TP 15
  149. [EACCES]
  150. Search permission is denied for a component of the path prefix.
  151. .TP 15
  152. [ELOOP]
  153. Too many symbolic links were encountered in translating the pathname.
  154. (Minix-vmd)
  155. .TP 15
  156. [EFAULT]
  157. .I Buf
  158. or
  159. .I name
  160. points to an invalid address.
  161. .TP 15
  162. [EIO]
  163. An I/O error occurred while reading from or writing to the file system.
  164. .PP
  165. .B Fstat
  166. will fail if one or both of the following are true:
  167. .TP 15
  168. [EBADF]
  169. .I Fildes
  170. is not a valid open file descriptor.
  171. .TP 15
  172. [EFAULT]
  173. .I Buf
  174. points to an invalid address.
  175. .TP 15
  176. [EIO]
  177. An I/O error occurred while reading from or writing to the file system.
  178. .SH "SEE ALSO"
  179. .BR chmod (2),
  180. .BR chown (2),
  181. .BR utime (2).