aboutsummaryrefslogtreecommitdiffstats
path: root/man3/fopen.3
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2012-04-22 14:40:25 +1200
committerMichael Kerrisk <mtk.manpages@gmail.com>2012-04-22 14:48:28 +1200
commitd33e84666fe4f3aa97c27fe75575eb762ba5989d (patch)
tree45600dc61435203afed18dfa4578efc9aa1312f0 /man3/fopen.3
parent78a9ad25229ba9d06a4e7fc76f8ec22f17886963 (diff)
downloadman-pages-d33e84666fe4f3aa97c27fe75575eb762ba5989d.tar.gz
fopen.3: Document ",ccs=string" feature of 'mode' for fopen()/freopen()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man3/fopen.3')
-rw-r--r--man3/fopen.329
1 files changed, 26 insertions, 3 deletions
diff --git a/man3/fopen.3 b/man3/fopen.3
index 7e8f5c6412..0ccdac4297 100644
--- a/man3/fopen.3
+++ b/man3/fopen.3
@@ -300,9 +300,32 @@ to
.BR EEXIST .
This flag is ignored for
.BR fdopen ().
-.\" FIXME document /,ccs= charset/
-.SH BUGS
-In versions of glibc before
+.PP
+In addition to the above characters,
+.BR fopen ()
+and
+.BR freopen ()
+support the folloing syntax
+in
+.IR mode :
+
+.BI " ,ccs=" string
+
+The given
+.I string
+is taken as the name of a coded character set and
+the stream is marked as wide-oriented.
+Thereafter, internal conversion functions convert I/O
+to and from the character set
+.IR string .
+If the
+.BI ,ccs= string
+syntax is not specified,
+then the wide-orientation of the stream is
+determined by the first file operation.
+If that operation is a wide-character oepration,
+the stream is marked wide-oriented,
+and functions to convert to the coded character set are loaded.
.SH "SEE ALSO"
.BR open (2),
.BR fclose (3),