summaryrefslogtreecommitdiffstats
path: root/man3/fopen.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/fopen.3')
-rw-r--r--man3/fopen.349
1 files changed, 25 insertions, 24 deletions
diff --git a/man3/fopen.3 b/man3/fopen.3
index 4e230a8fd..4d8a9a83d 100644
--- a/man3/fopen.3
+++ b/man3/fopen.3
@@ -34,7 +34,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 fdopen ():
@@ -104,7 +104,7 @@ See NOTES below for details of glibc extensions for
Any created file will have the mode
.BR S_IRUSR " | " S_IWUSR " | " S_IRGRP " | " S_IWGRP " | " S_IROTH " | " S_IWOTH
(0666), as modified by the process's umask value (see
-.BR umask (2)).
+.MR umask 2 ).
.P
Reads and writes may be intermixed on read/write streams in any order.
Note that ANSI C requires that a file positioning function intervene
@@ -113,9 +113,9 @@ between output and input, unless an input operation encounters end-of-file.
result of writes other than the most recent.)
Therefore it is good practice (and indeed sometimes necessary
under Linux) to put an
-.BR fseek (3)
+.MR fseek 3
or
-.BR fsetpos (3)
+.MR fsetpos 3
operation between write and read operations on such a stream.
This operation may be an apparent no-op
(as in \fIfseek(..., 0L, SEEK_CUR)\fP
@@ -133,7 +133,7 @@ fseek(stream, 0, SEEK_END);
.in
.P
The file descriptor associated with the stream is opened as if by a call to
-.BR open (2)
+.MR open 2
with the following flags:
.RS
.TS
@@ -244,34 +244,34 @@ and
functions may also fail and set
.I errno
for any of the errors specified for the routine
-.BR malloc (3).
+.MR malloc 3 .
.P
The
.BR fopen ()
function may also fail and set
.I errno
for any of the errors specified for the routine
-.BR open (2).
+.MR open 2 .
.P
The
.BR fdopen ()
function may also fail and set
.I errno
for any of the errors specified for the routine
-.BR fcntl (2).
+.MR fcntl 2 .
.P
The
.BR freopen ()
function may also fail and set
.I errno
for any of the errors specified for the routines
-.BR open (2),
-.BR fclose (3),
+.MR open 2 ,
+.MR fclose 3 ,
and
-.BR fflush (3).
+.MR fflush 3 .
.SH ATTRIBUTES
For an explanation of the terms used in this section, see
-.BR attributes (7).
+.MR attributes 7 .
.TS
allbox;
lbx lb lb
@@ -320,21 +320,22 @@ Open the file with the
.B O_CLOEXEC
flag.
See
-.BR open (2)
+.MR open 2
for more information.
This flag is ignored for
.BR fdopen ().
.TP
.BR m " (since glibc 2.3)"
Attempt to access the file using
-.BR mmap (2),
+.MR mmap 2 ,
rather than I/O system calls
-.RB ( read (2),
-.BR write (2)).
+\%(\c
+.MR read 2 ,
+.MR write 2 ).
Currently,
.\" As at glibc 2.4:
use of
-.BR mmap (2)
+.MR mmap 2
is attempted only for a file opened for reading.
.TP
.B x
@@ -344,7 +345,7 @@ Open the file exclusively
(like the
.B O_EXCL
flag of
-.BR open (2)).
+.MR open 2 ).
If the file already exists,
.BR fopen ()
fails, and sets
@@ -397,9 +398,9 @@ The current implementation of
parses at most 5 characters in
.IR mode .
.SH SEE ALSO
-.BR open (2),
-.BR fclose (3),
-.BR fileno (3),
-.BR fmemopen (3),
-.BR fopencookie (3),
-.BR open_memstream (3)
+.MR open 2 ,
+.MR fclose 3 ,
+.MR fileno 3 ,
+.MR fmemopen 3 ,
+.MR fopencookie 3 ,
+.MR open_memstream 3