summaryrefslogtreecommitdiff
path: root/man3/fopen.3
diff options
context:
space:
mode:
Diffstat (limited to 'man3/fopen.3')
-rw-r--r--man3/fopen.344
1 files changed, 22 insertions, 22 deletions
diff --git a/man3/fopen.3 b/man3/fopen.3
index e9da6d54..7e6338f1 100644
--- a/man3/fopen.3
+++ b/man3/fopen.3
@@ -52,7 +52,7 @@ fopen, fdopen, freopen \- stream open functions
.BI "FILE *freopen(const char *" path ", const char *" mode ", FILE *" stream );
.SH DESCRIPTION
The
-.B fopen
+.BR fopen ()
function opens the file whose name is the string pointed to by
.I path
and associates a stream with it.
@@ -130,7 +130,7 @@ fseek(stream,0,SEEK_END);
call.
.PP
The
-.B fdopen
+.BR fdopen ()
function associates a stream with the existing file descriptor,
.IR fildes .
The
@@ -144,14 +144,14 @@ and the error and end-of-file indicators are cleared.
Modes "w" or "w+" do not cause truncation of the file.
The file descriptor is not dup'ed, and will be closed when
the stream created by
-.B fdopen
+.BR fdopen ()
is closed.
The result of applying
-.B fdopen
+.BR fdopen ()
to a shared memory object is undefined.
.PP
The
-.B freopen
+.BR freopen ()
function opens the file whose name is the string pointed to by
.I path
and associates the stream pointed to by
@@ -159,17 +159,17 @@ and associates the stream pointed to by
with it. The original stream (if it exists) is closed. The
.I mode
argument is used just as in the
-.B fopen
+.BR fopen ()
function. The primary use of the
-.B freopen
+.BR freopen ()
function is to change the file associated with a standard text stream
.IR "" ( stderr ", " stdin ", or " stdout ).
.SH "RETURN VALUE"
Upon successful completion
-.BR fopen ,
-.B fdopen
+.BR fopen (),
+.BR fdopen ()
and
-.B freopen
+.BR freopen ()
return a
.B FILE
pointer. Otherwise,
@@ -183,38 +183,38 @@ is set to indicate the error.
The
.I mode
provided to
-.BR fopen ,
-.BR fdopen ,
+.BR fopen (),
+.BR fdopen (),
or
-.B freopen
+.BR freopen ()
was invalid.
.PP
The
-.BR fopen ,
-.B fdopen
+.BR fopen (),
+.BR fdopen ()
and
-.B freopen
+.BR freopen ()
functions may also fail and set
.I errno
for any of the errors specified for the routine
.BR malloc (3).
.PP
The
-.B fopen
+.BR fopen ()
function may also fail and set
.I errno
for any of the errors specified for the routine
.BR open (2).
.PP
The
-.B fdopen
+.BR fdopen ()
function may also fail and set
.I errno
for any of the errors specified for the routine
.BR fcntl (2).
.PP
The
-.B freopen
+.BR freopen ()
function may also fail and set
.I errno
for any of the errors specified for the routines
@@ -224,11 +224,11 @@ and
.BR fflush (3).
.SH "CONFORMING TO"
The
-.B fopen
+.BR fopen ()
and
-.B freopen
+.BR freopen ()
functions conform to ANSI X3.159-1989 (``ANSI C''). The
-.B fdopen
+.BR fdopen ()
function conforms to IEEE Std1003.1-1988 (``POSIX.1'').
.SH "SEE ALSO"
.BR open (2),