📄 stat.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>stat</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_008_837"> </a>NAME</h4><blockquote>stat - get file status</blockquote><h4><a name = "tag_000_008_838"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="systypes.h.html">sys/types.h</a>>#include <<a href="sysstat.h.html">sys/stat.h</a>>int stat(const char *<i>path</i>, struct stat *<i>buf</i>);</code></pre></blockquote><h4><a name = "tag_000_008_839"> </a>DESCRIPTION</h4><blockquote>The<i>stat()</i>function obtains information about the named file and writes itto the area pointed to by the<i>buf</i>argument.The<i>path</i>argument points to a pathname naming a file. Read, write or executepermission of the named file is not required, but all directories listed inthe pathname leading to the file must be searchable. An implementation thatprovides additional or alternate file access control mechanisms may, underimplementation-dependent conditions, cause<i>stat()</i>to fail. In particular, the system may deny the existence of thefile specified by<i>path</i>.<p>The<i>buf</i>argument is a pointer to a<i>stat</i>structure, as defined in the header<i><a href="sysstat.h.html"><sys/stat.h></a></i>,into which information is placed concerning the file.<p>The<i>stat()</i>function updates any time-related fields (as described in the definition of<b>File Times Update</b>in the <b>XBD</b> specification), before writing into the<b>stat</b>structure.<p>The structure members<i>st_mode</i>,<i>st_ino</i>,<i>st_dev</i>,<i>st_uid</i>,<i>st_gid</i>,<i>st_atime</i>,<i>st_ctime</i>and<i>st_mtime</i>will have meaningful values for all file types defined in this document.The value of the member<i>st_nlink</i>will be set to the number of links to the file.</blockquote><h4><a name = "tag_000_008_840"> </a>RETURN VALUE</h4><blockquote>Upon successful completion, 0 is returned. Otherwise, -1 is returned and<i>errno</i>is set to indicate the error.</blockquote><h4><a name = "tag_000_008_841"> </a>ERRORS</h4><blockquote>The<i>stat()</i>function will fail if:<dl compact><dt>[EACCES]<dd>Search permission is denied for a component of the path prefix.<dt>[EIO]<dd>An error occurred while reading from the file system.<dt>[ELOOP]<dd>Too many symbolic links were encountered in resolving <i>path</i>.<dt>[ENAMETOOLONG]<dd>The length of the<i>path</i>argument exceeds {PATH_MAX} or a pathname component is longer than{NAME_MAX}.<dt>[ENOENT]<dd>A component of <i>path</i> does not name an existing fileor <i>path</i> is an empty string.<dt>[ENOTDIR]<dd>A component of the path prefix is not a directory.<dt>[EOVERFLOW]<dd>The file size in bytes or the number of blocks allocated to the fileor the file serial number cannot be represented correctly in thestructure pointed to by <i>buf</i>.</dl><p>The<i>stat()</i>function may fail if:<dl compact><dt>[ENAMETOOLONG]<dd>Pathname resolution of a symbolic link produced an intermediate result whoselength exceeds {PATH_MAX}.<dt>[EOVERFLOW]<dd>A value to be stored would overflow one of the membersof the <b>stat</b> structure.</dl></blockquote><h4><a name = "tag_000_008_842"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_008_843"> </a>APPLICATION USAGE</h4><blockquote>None.</blockquote><h4><a name = "tag_000_008_844"> </a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_008_845"> </a>SEE ALSO</h4><blockquote><i><a href="fstat.html">fstat()</a></i>,<i><a href="lstat.html">lstat()</a></i>,<i><a href="sysstat.h.html"><sys/stat.h></a></i>,<i><a href="systypes.h.html"><sys/types.h></a></i>.</blockquote><h4>DERIVATION</h4><blockquote>Derived from Issue 1 of the SVID.</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -