Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cpython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kirill Smelkov
cpython
Commits
30178068
Commit
30178068
authored
Mar 10, 2011
by
R David Murray
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
#10999: Add missing documentation for chflags constants to stat module docs
Patch by Michal Nowikowski.
parent
c29cd938
Changes
3
Show whitespace changes
Inline
Side-by-side
Showing
3 changed files
with
77 additions
and
32 deletions
+77
-32
Doc/library/os.rst
Doc/library/os.rst
+10
-10
Doc/library/stat.rst
Doc/library/stat.rst
+66
-22
Misc/ACKS
Misc/ACKS
+1
-0
No files found.
Doc/library/os.rst
View file @
30178068
...
@@ -842,16 +842,16 @@ Files and Directories
...
@@ -842,16 +842,16 @@ Files and Directories
Set the flags of *path* to the numeric *flags*. *flags* may take a combination
Set the flags of *path* to the numeric *flags*. *flags* may take a combination
(bitwise OR) of the following values (as defined in the :mod:`stat` module):
(bitwise OR) of the following values (as defined in the :mod:`stat` module):
*
``UF_NODUMP`
`
*
:data:`stat.UF_NODUMP
`
*
``UF_IMMUTABLE`
`
*
:data:`stat.UF_IMMUTABLE
`
*
``UF_APPEND`
`
*
:data:`stat.UF_APPEND
`
*
``UF_OPAQUE`
`
*
:data:`stat.UF_OPAQUE
`
*
``UF_NOUNLINK`
`
*
:data:`stat.UF_NOUNLINK
`
*
``SF_ARCHIVED`
`
*
:data:`stat.SF_ARCHIVED
`
*
``SF_IMMUTABLE`
`
*
:data:`stat.SF_IMMUTABLE
`
*
``SF_APPEND`
`
*
:data:`stat.SF_APPEND
`
*
``SF_NOUNLINK`
`
*
:data:`stat.SF_NOUNLINK
`
*
``SF_SNAPSHOT`
`
*
:data:`stat.SF_SNAPSHOT
`
Availability: Unix.
Availability: Unix.
...
...
Doc/library/stat.rst
View file @
30178068
...
@@ -73,6 +73,34 @@ for each test. These are also useful when checking for information about a file
...
@@ -73,6 +73,34 @@ for each test. These are also useful when checking for information about a file
that isn't handled by :mod:`os.path`, like the tests for block and character
that isn't handled by :mod:`os.path`, like the tests for block and character
devices.
devices.
Example::
import os, sys
from stat import *
def walktree(top, callback):
'''recursively descend the directory tree rooted at top,
calling the callback function for each regular file'''
for f in os.listdir(top):
pathname = os.path.join(top, f)
mode = os.stat(pathname)[ST_MODE]
if S_ISDIR(mode):
# It's a directory, recurse into it
walktree(pathname, callback)
elif S_ISREG(mode):
# It's a file, call the callback function
callback(pathname)
else:
# Unknown file type, print a message
print('Skipping %s' % pathname)
def visitfile(file):
print('visiting', file)
if __name__ == '__main__':
walktree(sys.argv[1], visitfile)
All the variables below are simply symbolic indexes into the 10-tuple returned
All the variables below are simply symbolic indexes into the 10-tuple returned
by :func:`os.stat`, :func:`os.fstat` or :func:`os.lstat`.
by :func:`os.stat`, :func:`os.fstat` or :func:`os.lstat`.
...
@@ -262,31 +290,47 @@ The following flags can also be used in the *mode* argument of :func:`os.chmod`:
...
@@ -262,31 +290,47 @@ The following flags can also be used in the *mode* argument of :func:`os.chmod`:
Unix V7 synonym for :data:`S_IXUSR`.
Unix V7 synonym for :data:`S_IXUSR`.
Example:
:
The following flags can be used in the *flags* argument of :func:`os.chflags`
:
import os, sys
.. data:: UF_NODUMP
from stat import *
def walktree(top, callback):
Do not dump the file.
'''recursively descend the directory tree rooted at top,
calling the callback function for each regular file'''
for f in os.listdir(top):
.. data:: UF_IMMUTABLE
pathname = os.path.join(top, f)
mode = os.stat(pathname)[ST_MODE]
if S_ISDIR(mode):
# It's a directory, recurse into it
walktree(pathname, callback)
elif S_ISREG(mode):
# It's a file, call the callback function
callback(pathname)
else:
# Unknown file type, print a message
print('Skipping %s' % pathname)
def visitfile(file):
The file may not be changed.
print('visiting', file)
if __name__ == '__main__':
.. data:: UF_APPEND
walktree(sys.argv[1], visitfile)
The file may only be appended to.
.. data:: UF_OPAQUE
The file may not be renamed or deleted.
.. data:: UF_NOUNLINK
The directory is opaque when viewed through a union stack.
.. data:: SF_ARCHIVED
The file may be archived.
.. data:: SF_IMMUTABLE
The file may not be changed.
.. data:: SF_APPEND
The file may only be appended to.
.. data:: SF_NOUNLINK
The file may not be renamed or deleted.
.. data:: SF_SNAPSHOT
The file is a snapshot file.
See the \*BSD or Mac OS systems man page :manpage:`chflags(2)` for more information.
Misc/ACKS
View file @
30178068
...
@@ -578,6 +578,7 @@ Stefan Norberg
...
@@ -578,6 +578,7 @@ Stefan Norberg
Tim Northover
Tim Northover
Joe Norton
Joe Norton
Neal Norwitz
Neal Norwitz
Michal Nowikowski
Nigel O'Brian
Nigel O'Brian
Kevin O'Connor
Kevin O'Connor
Tim O'Malley
Tim O'Malley
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment