Module Name: src
Committed By: jruoho
Date: Mon Jul 18 05:17:16 UTC 2011
Modified Files:
src/lib/libc/stdio: fopen.3
Log Message:
Use a list for clarity, update standards, etc.
To generate a diff of this commit:
cvs rdiff -u -r1.26 -r1.27 src/lib/libc/stdio/fopen.3
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/lib/libc/stdio/fopen.3
diff -u src/lib/libc/stdio/fopen.3:1.26 src/lib/libc/stdio/fopen.3:1.27
--- src/lib/libc/stdio/fopen.3:1.26 Mon Jun 27 08:21:07 2011
+++ src/lib/libc/stdio/fopen.3 Mon Jul 18 05:17:16 2011
@@ -1,4 +1,4 @@
-.\" $NetBSD: fopen.3,v 1.26 2011/06/27 08:21:07 wiz Exp $
+.\" $NetBSD: fopen.3,v 1.27 2011/07/18 05:17:16 jruoho Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -33,7 +33,7 @@
.\"
.\" @(#)fopen.3 8.1 (Berkeley) 6/4/93
.\"
-.Dd June 24, 2011
+.Dd July 18, 2011
.Dt FOPEN 3
.Os
.Sh NAME
@@ -82,6 +82,9 @@
The file is created if it does not exist.
.El
.Pp
+Additionally:
+.Bl -bullet -offset 2n
+.It
The
.Fa mode
string can also include the letter
@@ -94,17 +97,18 @@
and has no effect; the
.Dq b
is ignored.
-.Pp
+.It
The letter
.Dq f
-in the mode string restricts fopen to regular
-files; if the file opened is not a regular file,
+in the mode string restricts
+.Fn fopen
+to regular files; if the file opened is not a regular file,
.Fn fopen
will fail.
This is a non
.St -ansiC
extension.
-.Pp
+.It
The letter
.Dq e
in the mode string sets the close-on-exec flag in the file descriptors of
@@ -114,6 +118,7 @@
This is a non
.St -ansiC
extension.
+.El
.Pp
Any created files will have mode
.Pf \*q Dv S_IRUSR
@@ -129,8 +134,8 @@
.Dv S_IWOTH Ns \*q
.Pq Li 0666 ,
as modified by the process'
-umask value (see
-.Xr umask 2 ) .
+.Xr umask 2
+value.
.Pp
Opening a file with append mode causes all subsequent writes to it
to be forced to the then current end of file, regardless of intervening
@@ -201,18 +206,14 @@
.Va errno
is set to indicate the error.
.Sh ERRORS
+The functions may fail if:
.Bl -tag -width Er
.It Bq Er EFTYPE
The file is not a regular file and the character ``f'' is specified
in the mode.
.It Bq Er EINVAL
-The
+The specified
.Fa mode
-provided to
-.Fn fopen ,
-.Fn fdopen ,
-or
-.Fn freopen
was invalid.
.El
.Pp
@@ -264,13 +265,10 @@
.Fn fopen
and
.Fn freopen
-functions
-conform to
+functions conform to
.St -ansiC .
-The
-.Fn fdopen
-function conforms to
-.St -p1003.1-90 .
+All three functions are specified in
+.St -p1003.1-2008 .
.Sh CAVEATS
Proper code using
.Fn fdopen
