From: Andreas Jaeger Date: Mon, 9 Apr 2012 19:06:55 +0000 (+0200) Subject: Document additional fopen options X-Git-Tag: upstream/2.30~11260 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=823fbbb41b4a7cbd45e5506d3f2d9381e9112405;p=external%2Fglibc.git Document additional fopen options [BZ #10254] The manual failed to explain the new (the first were introduced with glibc 2.3 or so) parameters to fopen. --- diff --git a/ChangeLog b/ChangeLog index 58006ee..74758bd 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2012-04-09 Andreas Jaeger + + [BZ #10254] + * manual/stdio.texi (Opening Streams): Document additional fopen + parameters. + 2012-04-09 Carlos O'Donell [BZ # 13963] diff --git a/NEWS b/NEWS index b3ff976..99d8000 100644 --- a/NEWS +++ b/NEWS @@ -13,14 +13,14 @@ Version 2.16 2563, 2565, 2566, 2576, 2678, 3335, 3866, 3868, 3976, 3992, 4026, 4108, 4596, 4822, 5077, 5461, 5805, 5993, 6471, 6486, 6578, 6649, 6730, 6770, 6884, 6890, 6895, 6907, 6911, 9739, 9902, 10110, 10135, 10140, 10153, - 10210, 10346, 10545, 10716, 11174, 11322, 11365, 11451, 11494, 12047, - 12340, 13058, 13525, 13526, 13527, 13528, 13529, 13530, 13531, 13532, - 13533, 13547, 13551, 13552, 13553, 13555, 13559, 13566, 13583, 13592, - 13618, 13637, 13656, 13658, 13673, 13691, 13695, 13704, 13705, 13706, - 13726, 13738, 13760, 13761, 13786, 13792, 13806, 13824, 13840, 13841, - 13844, 13846, 13851, 13852, 13854, 13871, 13873, 13879, 13883, 13892, - 13895, 13908, 13910, 13911, 13912, 13913, 13915, 13916, 13917, 13918, - 13919, 13920, 13921, 13926, 13928, 13938, 13963 + 10210, 10254, 10346, 10545, 10716, 11174, 11322, 11365, 11451, 11494, + 12047, 12340, 13058, 13525, 13526, 13527, 13528, 13529, 13530, 13531, + 13532, 13533, 13547, 13551, 13552, 13553, 13555, 13559, 13566, 13583, + 13592, 13618, 13637, 13656, 13658, 13673, 13691, 13695, 13704, 13705, + 13706, 13726, 13738, 13760, 13761, 13786, 13792, 13806, 13824, 13840, + 13841, 13844, 13846, 13851, 13852, 13854, 13871, 13873, 13879, 13883, + 13892, 13895, 13908, 13910, 13911, 13912, 13913, 13915, 13916, 13917, + 13918, 13919, 13920, 13921, 13926, 13928, 13938, 13963 * ISO C11 support: diff --git a/manual/stdio.texi b/manual/stdio.texi index 0d23daa..e870afb 100644 --- a/manual/stdio.texi +++ b/manual/stdio.texi @@ -196,13 +196,31 @@ Additional characters may appear after these to specify flags for the call. Always put the mode (@samp{r}, @samp{w+}, etc.) first; that is the only part you are guaranteed will be understood by all systems. -@Theglibc{} defines one additional character for use in -@var{opentype}: the character @samp{x} insists on creating a new -file---if a file @var{filename} already exists, @code{fopen} fails -rather than opening it. If you use @samp{x} you are guaranteed that -you will not clobber an existing file. This is equivalent to the -@code{O_EXCL} option to the @code{open} function (@pxref{Opening and -Closing Files}). +@Theglibc{} defines additional characters for use in @var{opentype}: + +@table @samp +@item c +The file is opened with cancellation in the I/O functions disabled. + +@item e +The underlying file descriptor will be closed if you use any of the +@code{exec@dots{}} functions (@pxref{Executing a File}). (This is +equivalent to having set @code{FD_CLOEXEC} on that descriptor. +@xref{Descriptor Flags}.) + +@item m +The file is opened and accessed using @code{mmap}. This is only +supported with files opened for reading. + +@item x +Insist on creating a new file---if a file @var{filename} already +exists, @code{fopen} fails rather than opening it. If you use +@samp{x} you are guaranteed that you will not clobber an existing +file. This is equivalent to the @code{O_EXCL} option to the +@code{open} function (@pxref{Opening and Closing Files}). + +The @samp{x} modifier is part of @w{ISO C11}. +@end table The character @samp{b} in @var{opentype} has a standard meaning; it requests a binary stream rather than a text stream. But this makes no