summaryrefslogtreecommitdiffstats
path: root/man3/ftw.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/ftw.3')
-rw-r--r--man3/ftw.328
1 files changed, 14 insertions, 14 deletions
diff --git a/man3/ftw.3 b/man3/ftw.3
index 655bd38ac..184c02261 100644
--- a/man3/ftw.3
+++ b/man3/ftw.3
@@ -39,7 +39,7 @@ Standard C library
.P
.RS -4
Feature Test Macro Requirements for glibc (see
-.BR feature_test_macros (7)):
+.MR feature_test_macros 7 ):
.RE
.P
.BR nftw ():
@@ -91,7 +91,7 @@ was expressed as an absolute pathname.
is a pointer to the
.I stat
structure returned by a call to
-.BR stat (2)
+.MR stat 2
for
.IR fpath .
.P
@@ -129,7 +129,7 @@ and subdirectories within \fIfpath\fP have been processed.
.TP
.B FTW_NS
The
-.BR stat (2)
+.MR stat 2
call failed on
.IR fpath ,
which is not a symbolic link.
@@ -139,7 +139,7 @@ on the parent directory, so that the filename
could be seen,
but did not have execute permission,
so that the file could not be reached for
-.BR stat (2).
+.MR stat 2 .
The contents of the buffer pointed to by
.I sb
are undefined.
@@ -164,7 +164,7 @@ In this case the
argument passed to
.IR fn ()
contains information returned by performing
-.BR lstat (2)
+.MR lstat 2
on the "dangling" symbolic link.
(But see BUGS.)
.P
@@ -204,7 +204,7 @@ As long as \fIfn\fP() returns 0,
will continue either until it has traversed the entire tree,
in which case it will return zero,
or until it encounters an error (such as a
-.BR malloc (3)
+.MR malloc 3
failure), in which case it will return \-1.
.P
Because
@@ -214,7 +214,7 @@ exit out of a tree walk is to return a nonzero value from \fIfn\fP().
To allow a signal to terminate the walk without causing a memory leak,
have the handler set a global flag that is checked by \fIfn\fP().
\fIDon't\fP use
-.BR longjmp (3)
+.MR longjmp 3
unless the program is going to terminate.
.P
The \fIflags\fP argument of
@@ -274,7 +274,7 @@ obtain the definition of \fBFTW_ACTIONRETVAL\fP from \fI<ftw.h>\fP.
.TP
.B FTW_CHDIR
If set, do a
-.BR chdir (2)
+.MR chdir 2
to each directory before handling its contents.
This is useful if the program needs to perform some action
in the directory in which \fIfpath\fP resides.
@@ -352,7 +352,7 @@ and that value is returned as the result of
.BR nftw ().
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
-.BR attributes (7).
+.MR attributes 7 .
.TS
allbox;
lbx lb lb
@@ -380,7 +380,7 @@ will use \fBFTW_SL\fP for each symbolic link.
If
.I fpath
is a symbolic link and
-.BR stat (2)
+.MR stat 2
failed, POSIX.1-2008 states
that it is undefined whether \fBFTW_NS\fP or \fBFTW_SL\fP
is passed in
@@ -416,7 +416,7 @@ the buffer pointed to by
.I sb
should contain information about the dangling symbolic link
(obtained by calling
-.BR lstat (2)
+.MR lstat 2
on the link).
Early glibc versions correctly followed the POSIX specification on this point.
However, as a result of a regression introduced in glibc 2.4,
@@ -497,6 +497,6 @@ main(int argc, char *argv[])
.EE
.\" SRC END
.SH SEE ALSO
-.BR stat (2),
-.BR fts (3),
-.BR readdir (3)
+.MR stat 2 ,
+.MR fts 3 ,
+.MR readdir 3