Loading...
--- Libc/Libc-1725.40.4/gen/fts.3
+++ Libc/Libc-498/gen/fts.3
@@ -32,7 +32,7 @@
.\" @(#)fts.3 8.5 (Berkeley) 4/16/94
.\" $FreeBSD: src/lib/libc/gen/fts.3,v 1.13 2001/09/20 12:32:45 ru Exp $
.\"
-.Dd Sept 24, 2012
+.Dd April 16, 1994
.Dt FTS 3
.Os
.Sh NAME
@@ -46,8 +46,6 @@
.In fts.h
.Ft FTS *
.Fn fts_open "char * const *path_argv" "int options" "int (*compar)(const FTSENT **, const FTSENT **)"
-.Ft FTS *
-.Fn fts_open_b "char * const *path_argv" "int options" "int (^compar)(const FTSENT **, const FTSENT **)"
.Ft FTSENT *
.Fn fts_read "FTS *ftsp"
.Ft FTSENT *
@@ -64,9 +62,7 @@
file hierarchies.
A simple overview is that the
.Fn fts_open
-and
-.Fn fts_open_b
-functions return a
+function returns a
.Dq handle
on a file hierarchy, which is then supplied to
the other
@@ -173,8 +169,6 @@
.Ql ..\&
which was not specified as a file name to
.Fn fts_open
-or
-.Fn fts_open_b
(see
.Dv FTS_SEEDOT ) .
.It Dv FTS_DP
@@ -224,8 +218,6 @@
The path for the file relative to the root of the traversal.
This path contains the path specified to
.Fn fts_open
-or
-.Fn fts_open_b
as a prefix.
.It Fa fts_pathlen
The length of the string referenced by
@@ -372,7 +364,7 @@
The options are selected by
.Em or Ns 'ing
the following values:
-.Bl -tag -width "FTS_NOSTAT_TYPE"
+.Bl -tag -width "FTS_PHYSICAL"
.It Dv FTS_COMFOLLOW
This option causes any symbolic link specified as a root path to be
followed immediately whether or not
@@ -421,41 +413,15 @@
.Fa statp
field) for each file visited.
This option relaxes that requirement as a performance optimization,
-not calling
-.Xr stat 2
-whenever possible.
-If
-.Xr stat 2
-doesn't need to be called, the
-.Nm
-functions will set the
+allowing the
+.Nm
+functions to set the
.Fa fts_info
field to
-.Dv FTS_NSOK ;
-otherwise
-.Fa fts_info
-will be set to the correct file information value corresponding to the
-.Xr stat 2
-information.
-In any case, the
+.Dv FTS_NSOK
+and leave the contents of the
.Fa statp
-field will always be undefined.
-Note that because
-.Nm
-detects directory cycles and dangling symbolic links,
-.Xr stat 2
-is always called for directories and is called for symbolic links when
-.Dv FTS_LOGICAL
-is set.
-.It Dv FTS_NOSTAT_TYPE
-Like
-.Dv FTS_NOSTAT
-but if the file type is returned by
-.Xr readdir 3 ,
-the corresponding file information value is returned in
-.Fa fts_info
-instead of
-.Dv FTS_NSOK .
+field undefined.
.It Dv FTS_PHYSICAL
This option causes the
.Nm
@@ -533,30 +499,6 @@
.Fa path_argv
for the root paths, and in the order listed in the directory for
everything else.
-.Sh FTS_OPEN_B
-The
-.Fn fts_open_b
-function is like
-.Fn fts_open
-except
-.Fa compar
-is a block pointer instead of a function pointer.
-This block is passed to
-.Xr qsort_b 3
-(whereas
-.Fn fts_open
-passes its function pointer to
-.Xr qsort 3 ) .
-.Bd -ragged -offset indent
-Note: The
-.Fn Block_copy
-function (defined in
-.In Blocks.h )
-is used by
-.Fn fts_open_b
-to make a copy of the block, especially for the case when a stack-based
-block might go out of scope when the subroutine returns.
-.Ed
.Sh FTS_READ
The
.Fn fts_read
@@ -810,8 +752,7 @@
.Xr find 1 ,
.Xr chdir 2 ,
.Xr stat 2 ,
-.Xr qsort 3 ,
-.Xr qsort_b 3
+.Xr qsort 3
.Sh STANDARDS
The
.Nm