Differences between version 2 and revision by previous author of fts_open(3).
Other diffs: Previous Major Revision, Previous Revision, or view the Annotated Edit History
| Newer page: | version 2 | Last edited on Thursday, December 9, 2004 10:16:07 am | by MarkKnopper | Revert |
| Older page: | version 1 | Last edited on Monday, June 3, 2002 11:57:14 pm | by perry | Revert |
@@ -55,9 +55,9 @@
files contained in a directory in the hierarchy. In general,
directories are visited two distinguishable times; in
pre-order (before any of their descendants are visited) and
in post-order (after all of their descendants have been
-visited). Files are vis- ited
once. It is possible to walk
+visited). Files are visited
once. It is possible to walk
the hierarchy ``logi- cally'' (ignoring symbolic links) or
physically (visiting symbolic links), order the walk of the
hierarchy or prune and/or re-visit portions of the
hierarchy.
@@ -84,9 +84,9 @@
} FTSENT;
These fields are defined as follows:
- fts_info One of the following flags describing thereturned FTSENT structure and the file it repre-sents
. With the exception of directories with-out
errors (FTS_D
+ fts_info One of the following flags describing thereturned FTSENT structure and the file it represents
. With the exception of directories without
errors (FTS_D
), all of these entries are terminal, that is, they will
not be revisited, nor will any of their descendants be
visited.
@@ -108,9 +108,9 @@
FTS_DNR
A directory which cannot be read. This is an error return,
-and the fts_errno field will be set to indi- cate
what
+and the fts_errno field will be set to indicate
what
caused the error.
FTS_DOT
@@ -135,17 +135,17 @@
A regular file.
FTS_NS
-A file for which no stat(2) informa- tion
was
+A file for which no stat(2) information
was
available. The contents of the fts_statp field are
undefined. This is an error return, and the fts_errno field
will be set to indi- cate what caused the
error.
FTS_NSOK
-A file for which no stat(2) informa- tion
was
+A file for which no stat(2) information
was
requested. The contents of the fts_statp field are
undefined.
@@ -185,9 +185,9 @@
fts_level
The depth of the traversal, numbered from -1 to N, where
-this file was found. The FTSENT struc- ture
representing the
+this file was found. The FTSENT structure
representing the
parent of the starting point (or root) of the traversal is
numbered -1, and the FTSENT structure for the root itself is
numbered 0.
@@ -202,15 +202,15 @@
undefined.
fts_number
-This field is provided for the use of the appli- cation
+This field is provided for the use of the application
program and is not modified by the fts functions. It is
initialized to 0.
fts_pointer
-This field is provided for the use of the appli- cation
+This field is provided for the use of the application
program and is not modified by the fts functions. It is
initialized to NULL.
@@ -219,9 +219,9 @@
the hierarchy immediately above the current file, i.e. the
directory of which this file is a member. A parent structure
for the initial entry point is provided as well, how- ever,
only the fts_level, fts_number and fts_pointer fields are
-guaranteed to be initial-
ized.
+guaranteed to be initia
ized.
fts_link
Upon return from the fts_children() function, the fts_link
@@ -250,10 +250,10 @@
fts_accpath fields are guaranteed to be
NULL-terminated ''only'' for the file most
recently returned by fts_read(). To use these fields to
reference any files represented by other FTSENT structures
-will require that the path buffer be modi- fied
using the
-information contained in that FTSENT struc- ture
's
+will require that the path buffer be modified
using the
+information contained in that FTSENT structure
's
fts_pathlen field. Any such modifications should be undone
before further calls to fts_read() are attempted. The
fts_name field is always
NULL-terminated.
@@ -291,25 +291,25 @@
function.
FTS_NOCHDIR
-As a performance optimization, the fts func- tions
change
+As a performance optimization, the fts functions
change
directories as they walk the file hierarchy. This has the
side-effect that an application cannot rely on being in any
partic- ular directory during the traversal. The
FTS_NOCHDIR option turns off this optimization, and
-the fts functions will not change the cur- rent
directory.
+the fts functions will not change the current
directory.
Note that applications should not themselves change their
current directory and try to access files unless
FTS_NOCHDIR is specified and absolute pathnames
were provided as arguments to fts_open().
FTS_NOSTAT
-By default, returned FTSENT structures refer- ence
file
+By default, returned FTSENT structures reference
file
characteristic information (the statp field) for each file
visited. This option relaxes that requirement as a
-performance opti- mization
, allowing the fts functions to
+performance optimization
, allowing the fts functions to
set the fts_info field to FTS_NSOK and leave the
con- tents of the statp field undefined.
@@ -425,9 +425,9 @@
The fts_set() function returns 0 on success, and -1 if an
error occurs. ''Option'' must be set to one of the
following values:
FTS_AGAIN
-Re-visit the file; any file type may be re-vis- ited
.
+Re-visit the file; any file type may be re-visited
.
The next call to fts_read() will return the referenced file.
The fts_stat and fts_info fields of the structure will be
reinitialized at that time, but no other fields will have
been changed. This option is meaningful only for the most
