summaryrefslogtreecommitdiffstats
path: root/man3/readdir.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/readdir.3')
-rw-r--r--man3/readdir.338
1 files changed, 19 insertions, 19 deletions
diff --git a/man3/readdir.3 b/man3/readdir.3
index 731e25c85..23626503d 100644
--- a/man3/readdir.3
+++ b/man3/readdir.3
@@ -72,7 +72,7 @@ This is the inode number of the file.
The value returned in
.I d_off
is the same as would be returned by calling
-.BR telldir (3)
+.MR telldir 3
at the current position in the directory stream.
Be aware that despite its type and name, the
.I d_off
@@ -80,7 +80,7 @@ field is seldom any kind of directory offset on modern filesystems.
.\" https://lwn.net/Articles/544298/
Applications should treat this field as an opaque value,
making no assumptions about its contents; see also
-.BR telldir (3).
+.MR telldir 3 .
.TP
.I d_reclen
This is the size (in bytes) of the returned record.
@@ -90,7 +90,7 @@ see NOTES.
.I d_type
This field contains a value indicating the file type,
making it possible to avoid the expense of calling
-.BR lstat (2)
+.MR lstat 2
if further actions depend on the type of the file.
.IP
When a suitable feature test macro is defined
@@ -152,7 +152,7 @@ returns a pointer to a
.I dirent
structure.
(This structure may be statically allocated; do not attempt to
-.BR free (3)
+.MR free 3
it.)
.P
If the end of the directory stream is reached, NULL is returned and
@@ -174,7 +174,7 @@ if NULL is returned.
Invalid directory stream descriptor \fIdirp\fP.
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
-.BR attributes (7).
+.MR attributes 7 .
.TS
allbox;
lbx lb lb
@@ -198,7 +198,7 @@ In cases where multiple threads must read from the same directory stream,
using
.BR readdir ()
with external synchronization is still preferable to the use of the deprecated
-.BR readdir_r (3)
+.MR readdir_r 3
function.
It is expected that a future version of POSIX.1
.\" FIXME .
@@ -283,22 +283,22 @@ POSIX.1-2008.
POSIX.1-2001, SVr4, 4.3BSD.
.SH NOTES
A directory stream is opened using
-.BR opendir (3).
+.MR opendir 3 .
.P
The order in which filenames are read by successive calls to
.BR readdir ()
depends on the filesystem implementation;
it is unlikely that the names will be sorted in any fashion.
.SH SEE ALSO
-.BR getdents (2),
-.BR read (2),
-.BR closedir (3),
-.BR dirfd (3),
-.BR ftw (3),
-.BR offsetof (3),
-.BR opendir (3),
-.BR readdir_r (3),
-.BR rewinddir (3),
-.BR scandir (3),
-.BR seekdir (3),
-.BR telldir (3)
+.MR getdents 2 ,
+.MR read 2 ,
+.MR closedir 3 ,
+.MR dirfd 3 ,
+.MR ftw 3 ,
+.MR offsetof 3 ,
+.MR opendir 3 ,
+.MR readdir_r 3 ,
+.MR rewinddir 3 ,
+.MR scandir 3 ,
+.MR seekdir 3 ,
+.MR telldir 3