diff --git a/Doc/library/os.rst b/Doc/library/os.rst --- a/Doc/library/os.rst +++ b/Doc/library/os.rst @@ -2356,6 +2356,9 @@ *dirpath*, *dirnames* and *filenames* are identical to :func:`walk` output, and *dirfd* is a file descriptor referring to the directory *dirpath*. + It can be used, for example, to walk a directory tree in a way that is + immune to symlink attacks. + .. note:: Since :func:`fwalk` yields file descriptors, those are only valid until