| \section{\module{stat} --- |
| Interpreting \function{stat()} results} |
| |
| \declaremodule{standard}{stat} |
| \platform{Unix} |
| \modulesynopsis{Utilities for interpreting the results of |
| \function{os.stat()}, \function{os.lstat()} and \function{os.fstat()}.} |
| \sectionauthor{Skip Montanaro}{skip@automatrix.com} |
| |
| |
| 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 \function{os.stat()} or \function{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): |
| -Egon |
| |
| |
| |
| print 'frobbed', file |
| |
| if __name__ == '__main__': process(sys.argv[1], f) |
| \end{verbatim} |
| |
| -Egon |
| |
| |