Date: Sun, 18 Mar 2012 21:46:27 +0000 (UTC) From: Jilles Tjoelker <jilles@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r233132 - head/lib/libc/gen Message-ID: <201203182146.q2ILkR7a037120@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: jilles Date: Sun Mar 18 21:46:27 2012 New Revision: 233132 URL: http://svn.freebsd.org/changeset/base/233132 Log: fts(3): Mention that FTS_NOCHDIR imposes {PATH_MAX} limits on the returned pathnames. With the current API (no *at functions), FTS_NOCHDIR requires that the fts_accpath start with the original path passed to fts_open(); therefore, the depth that can be reached is limited by the {PATH_MAX} constraint on this pathname. MFC after: 1 week Modified: head/lib/libc/gen/fts.3 Modified: head/lib/libc/gen/fts.3 ============================================================================== --- head/lib/libc/gen/fts.3 Sun Mar 18 21:19:21 2012 (r233131) +++ head/lib/libc/gen/fts.3 Sun Mar 18 21:46:27 2012 (r233132) @@ -419,14 +419,17 @@ be provided to the .Fn fts_open function. .It Dv FTS_NOCHDIR -As a performance optimization, the +To allow descending to arbitrary depths +(independent of +.Brq Dv PATH_MAX ) +and improve performance, the .Nm functions change directories as they walk the file hierarchy. This has the side-effect that an application cannot rely on being in any particular directory during the traversal. The .Dv FTS_NOCHDIR -option turns off this optimization, and the +option turns off this feature, and the .Nm functions will not change the current directory. Note that applications should not themselves change their current directory
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201203182146.q2ILkR7a037120>