mirror of https://github.com/python/cpython.git
116 lines
2.8 KiB
TeX
116 lines
2.8 KiB
TeX
\section{\module{stat} ---
|
|
Utilities for interpreting \function{stat()} results.}
|
|
\declaremodule{standard}{stat}
|
|
\sectionauthor{Skip Montanaro}{skip@automatrix.com}
|
|
|
|
|
|
\modulesynopsis{Utilities for interpreting the results of
|
|
\function{os.stat()}, \function{os.lstat()} and \function{os.fstat()}.}
|
|
|
|
|
|
The \module{stat} module defines constants and functions for
|
|
interpreting the results of \function{os.stat()} and
|
|
\function{os.lstat()} (if they exist). For complete details about the
|
|
\cfunction{stat()} and \cfunction{lstat()} system calls, consult your
|
|
local man pages.
|
|
|
|
The \module{stat} module defines the following functions:
|
|
|
|
|
|
\begin{funcdesc}{S_ISDIR}{mode}
|
|
Return non-zero if the mode was gotten from a directory.
|
|
\end{funcdesc}
|
|
|
|
\begin{funcdesc}{S_ISCHR}{mode}
|
|
Return non-zero if the mode was gotten from a character special device.
|
|
\end{funcdesc}
|
|
|
|
\begin{funcdesc}{S_ISBLK}{mode}
|
|
Return non-zero if the mode was gotten from a block special device.
|
|
\end{funcdesc}
|
|
|
|
\begin{funcdesc}{S_ISREG}{mode}
|
|
Return non-zero if the mode was gotten from a regular file.
|
|
\end{funcdesc}
|
|
|
|
\begin{funcdesc}{S_ISFIFO}{mode}
|
|
Return non-zero if the mode was gotten from a FIFO.
|
|
\end{funcdesc}
|
|
|
|
\begin{funcdesc}{S_ISLNK}{mode}
|
|
Return non-zero if the mode was gotten from a symbolic link.
|
|
\end{funcdesc}
|
|
|
|
\begin{funcdesc}{S_ISSOCK}{mode}
|
|
Return non-zero if the mode was gotten from a socket.
|
|
\end{funcdesc}
|
|
|
|
All the data items below are simply symbolic indexes into the 10-tuple
|
|
returned by \code{os.stat()} or \code{os.lstat()}.
|
|
|
|
\begin{datadesc}{ST_MODE}
|
|
Inode protection mode.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_INO}
|
|
Inode number.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_DEV}
|
|
Device inode resides on.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_NLINK}
|
|
Number of links to the inode.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_UID}
|
|
User id of the owner.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_GID}
|
|
Group id of the owner.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_SIZE}
|
|
File size in bytes.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_ATIME}
|
|
Time of last access.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_MTIME}
|
|
Time of last modification.
|
|
\end{datadesc}
|
|
|
|
\begin{datadesc}{ST_CTIME}
|
|
Time of last status change (see manual pages for details).
|
|
\end{datadesc}
|
|
|
|
Example:
|
|
|
|
\begin{verbatim}
|
|
import os, sys
|
|
from stat import *
|
|
|
|
def process(dir, func):
|
|
'''recursively descend the directory rooted at dir, calling func for
|
|
each regular file'''
|
|
|
|
for f in os.listdir(dir):
|
|
mode = os.stat('%s/%s' % (dir, f))[ST_MODE]
|
|
if S_ISDIR(mode):
|
|
# recurse into directory
|
|
process('%s/%s' % (dir, f), func)
|
|
elif S_ISREG(mode):
|
|
func('%s/%s' % (dir, f))
|
|
else:
|
|
print 'Skipping %s/%s' % (dir, f)
|
|
|
|
def f(file):
|
|
print 'frobbed', file
|
|
|
|
if __name__ == '__main__': process(sys.argv[1], f)
|
|
\end{verbatim}
|