msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
-"POT-Creation-Date: 2012-03-19 23:50+0900\n"
+"POT-Creation-Date: 2013-09-28 04:06+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Content-Transfer-Encoding: 8bit\n"
#. type: TH
-#: build/C/man3/asprintf.3:25
+#: build/C/man3/asprintf.3:27
#, no-wrap
msgid "ASPRINTF"
msgstr ""
#. type: TH
-#: build/C/man3/asprintf.3:25
+#: build/C/man3/asprintf.3:27 build/C/man3/fcloseall.3:25 build/C/man3/ferror.3:44 build/C/man3/fmtmsg.3:13 build/C/man3/stdio_ext.3:25 build/C/man3/tmpnam.3:27
#, no-wrap
-msgid "2001-12-18"
+msgid "2013-06-21"
msgstr ""
#. type: TH
-#: build/C/man3/asprintf.3:25 build/C/man3/ctermid.3:24 build/C/man3/dprintf.3:25 build/C/man3/fclose.3:42 build/C/man3/fcloseall.3:24 build/C/man3/fflush.3:43 build/C/man3/fgetwc.3:16 build/C/man3/fmemopen.3:6 build/C/man3/fopen.3:42 build/C/man3/fputwc.3:14 build/C/man3/fread.3:43 build/C/man3/fseek.3:40 build/C/man3/getline.3:24 build/C/man3/gets.3:25 build/C/man3/getw.3:23 build/C/man3/popen.3:38 build/C/man3/printf.3:34 build/C/man3/puts.3:24 build/C/man3/remove.3:31 build/C/man3/scanf.3:50 build/C/man3/wprintf.3:14
+#: build/C/man3/asprintf.3:27 build/C/man3/ctermid.3:26 build/C/man3/dprintf.3:26 build/C/man3/fclose.3:44 build/C/man3/fcloseall.3:25 build/C/man3/fflush.3:45 build/C/man3/fgetwc.3:18 build/C/man3/fmemopen.3:10 build/C/man3/fopen.3:44 build/C/man3/fputwc.3:16 build/C/man3/fread.3:45 build/C/man3/fseek.3:42 build/C/man3/getline.3:26 build/C/man3/gets.3:27 build/C/man3/getw.3:25 build/C/man3/popen.3:40 build/C/man3/printf.3:34 build/C/man3/puts.3:26 build/C/man3/remove.3:31 build/C/man3/scanf.3:52 build/C/man3/wprintf.3:16
#, no-wrap
msgid "GNU"
msgstr ""
#. type: TH
-#: build/C/man3/asprintf.3:25 build/C/man3/ctermid.3:24 build/C/man3/dprintf.3:25 build/C/man3/fclose.3:42 build/C/man3/fcloseall.3:24 build/C/man3/ferror.3:42 build/C/man3/fflush.3:43 build/C/man3/fgetwc.3:16 build/C/man3/flockfile.3:23 build/C/man3/fmemopen.3:6 build/C/man3/fmtmsg.3:9 build/C/man3/fopen.3:42 build/C/man3/fopencookie.3:24 build/C/man3/fpurge.3:23 build/C/man3/fputwc.3:14 build/C/man3/fread.3:43 build/C/man3/fseek.3:40 build/C/man3/fseeko.3:23 build/C/man3/getline.3:24 build/C/man3/gets.3:25 build/C/man3/getw.3:23 build/C/man2/link.2:31 build/C/man2/llseek.2:26 build/C/man2/lseek.2:45 build/C/man3/lseek64.3:23 build/C/man2/open.2:52 build/C/man3/perror.3:30 build/C/man2/pipe.2:36 build/C/man3/popen.3:38 build/C/man3/printf.3:34 build/C/man3/puts.3:24 build/C/man2/read.2:35 build/C/man2/readlink.2:41 build/C/man2/readv.2:30 build/C/man3/remove.3:31 build/C/man2/rename.2:32 build/C/man2/rmdir.2:30 build/C/man3/scanf.3:50 build/C/man3/setbuf.3:46 build/C/man3/stdin.3:9 build/C/man3/stdio.3:37 build/C/man3/stdio_ext.3:23 build/C/man2/symlink.2:32 build/C/man7/symlink.7:35 build/C/man3/tempnam.3:23 build/C/man3/tmpfile.3:29 build/C/man3/tmpnam.3:25 build/C/man2/unlink.2:32 build/C/man3/unlocked_stdio.3:23 build/C/man3/wprintf.3:14 build/C/man2/write.2:39
+#: build/C/man3/asprintf.3:27 build/C/man3/ctermid.3:26 build/C/man3/dprintf.3:26 build/C/man3/fclose.3:44 build/C/man3/fcloseall.3:25 build/C/man3/ferror.3:44 build/C/man3/fflush.3:45 build/C/man3/fgetwc.3:18 build/C/man3/flockfile.3:25 build/C/man3/fmemopen.3:10 build/C/man3/fmtmsg.3:13 build/C/man3/fopen.3:44 build/C/man3/fopencookie.3:26 build/C/man3/fpurge.3:25 build/C/man3/fputwc.3:16 build/C/man3/fread.3:45 build/C/man3/fseek.3:42 build/C/man3/fseeko.3:25 build/C/man3/getline.3:26 build/C/man3/gets.3:27 build/C/man3/getw.3:25 build/C/man2/link.2:31 build/C/man2/llseek.2:28 build/C/man2/lseek.2:47 build/C/man3/lseek64.3:25 build/C/man2/open.2:51 build/C/man3/perror.3:31 build/C/man2/pipe.2:36 build/C/man3/popen.3:40 build/C/man3/printf.3:34 build/C/man3/puts.3:26 build/C/man2/read.2:35 build/C/man2/readlink.2:43 build/C/man2/readv.2:32 build/C/man3/remove.3:31 build/C/man2/rename.2:32 build/C/man2/rmdir.2:30 build/C/man3/scanf.3:52 build/C/man3/setbuf.3:48 build/C/man3/stdin.3:13 build/C/man3/stdio.3:39 build/C/man3/stdio_ext.3:25 build/C/man2/symlink.2:32 build/C/man7/symlink.7:36 build/C/man3/tempnam.3:25 build/C/man3/tmpfile.3:31 build/C/man3/tmpnam.3:27 build/C/man2/unlink.2:32 build/C/man3/unlocked_stdio.3:25 build/C/man3/wprintf.3:16 build/C/man2/write.2:39
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""
#. type: SH
-#: build/C/man3/asprintf.3:26 build/C/man3/ctermid.3:25 build/C/man3/dprintf.3:26 build/C/man3/fclose.3:43 build/C/man3/fcloseall.3:25 build/C/man3/ferror.3:43 build/C/man3/fflush.3:44 build/C/man3/fgetwc.3:17 build/C/man3/flockfile.3:24 build/C/man3/fmemopen.3:7 build/C/man3/fmtmsg.3:10 build/C/man3/fopen.3:43 build/C/man3/fopencookie.3:25 build/C/man3/fpurge.3:24 build/C/man3/fputwc.3:15 build/C/man3/fread.3:44 build/C/man3/fseek.3:41 build/C/man3/fseeko.3:24 build/C/man3/getline.3:25 build/C/man3/gets.3:26 build/C/man3/getw.3:24 build/C/man2/link.2:32 build/C/man2/llseek.2:27 build/C/man2/lseek.2:46 build/C/man3/lseek64.3:24 build/C/man2/open.2:53 build/C/man3/perror.3:31 build/C/man2/pipe.2:37 build/C/man3/popen.3:39 build/C/man3/printf.3:35 build/C/man3/puts.3:25 build/C/man2/read.2:36 build/C/man2/readlink.2:42 build/C/man2/readv.2:31 build/C/man3/remove.3:32 build/C/man2/rename.2:33 build/C/man2/rmdir.2:31 build/C/man3/scanf.3:51 build/C/man3/setbuf.3:47 build/C/man3/stdin.3:10 build/C/man3/stdio.3:38 build/C/man3/stdio_ext.3:24 build/C/man2/symlink.2:33 build/C/man7/symlink.7:36 build/C/man3/tempnam.3:24 build/C/man3/tmpfile.3:30 build/C/man3/tmpnam.3:26 build/C/man2/unlink.2:33 build/C/man3/unlocked_stdio.3:24 build/C/man3/wprintf.3:15 build/C/man2/write.2:40
+#: build/C/man3/asprintf.3:28 build/C/man3/ctermid.3:27 build/C/man3/dprintf.3:27 build/C/man3/fclose.3:45 build/C/man3/fcloseall.3:26 build/C/man3/ferror.3:45 build/C/man3/fflush.3:46 build/C/man3/fgetwc.3:19 build/C/man3/flockfile.3:26 build/C/man3/fmemopen.3:11 build/C/man3/fmtmsg.3:14 build/C/man3/fopen.3:45 build/C/man3/fopencookie.3:27 build/C/man3/fpurge.3:26 build/C/man3/fputwc.3:17 build/C/man3/fread.3:46 build/C/man3/fseek.3:43 build/C/man3/fseeko.3:26 build/C/man3/getline.3:27 build/C/man3/gets.3:28 build/C/man3/getw.3:26 build/C/man2/link.2:32 build/C/man2/llseek.2:29 build/C/man2/lseek.2:48 build/C/man3/lseek64.3:26 build/C/man2/open.2:52 build/C/man3/perror.3:32 build/C/man2/pipe.2:37 build/C/man3/popen.3:41 build/C/man3/printf.3:35 build/C/man3/puts.3:27 build/C/man2/read.2:36 build/C/man2/readlink.2:44 build/C/man2/readv.2:33 build/C/man3/remove.3:32 build/C/man2/rename.2:33 build/C/man2/rmdir.2:31 build/C/man3/scanf.3:53 build/C/man3/setbuf.3:49 build/C/man3/stdin.3:14 build/C/man3/stdio.3:40 build/C/man3/stdio_ext.3:26 build/C/man2/symlink.2:33 build/C/man7/symlink.7:37 build/C/man3/tempnam.3:26 build/C/man3/tmpfile.3:32 build/C/man3/tmpnam.3:28 build/C/man2/unlink.2:33 build/C/man3/unlocked_stdio.3:26 build/C/man3/wprintf.3:17 build/C/man2/write.2:40
#, no-wrap
msgid "NAME"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:28
+#: build/C/man3/asprintf.3:30
msgid "asprintf, vasprintf - print to allocated string"
msgstr ""
#. type: SH
-#: build/C/man3/asprintf.3:28 build/C/man3/ctermid.3:27 build/C/man3/dprintf.3:28 build/C/man3/fclose.3:45 build/C/man3/fcloseall.3:27 build/C/man3/ferror.3:45 build/C/man3/fflush.3:46 build/C/man3/fgetwc.3:19 build/C/man3/flockfile.3:26 build/C/man3/fmemopen.3:9 build/C/man3/fmtmsg.3:12 build/C/man3/fopen.3:45 build/C/man3/fopencookie.3:27 build/C/man3/fpurge.3:26 build/C/man3/fputwc.3:17 build/C/man3/fread.3:46 build/C/man3/fseek.3:43 build/C/man3/fseeko.3:26 build/C/man3/getline.3:27 build/C/man3/gets.3:28 build/C/man3/getw.3:26 build/C/man2/link.2:34 build/C/man2/llseek.2:29 build/C/man2/lseek.2:48 build/C/man3/lseek64.3:26 build/C/man2/open.2:55 build/C/man3/perror.3:33 build/C/man2/pipe.2:39 build/C/man3/popen.3:41 build/C/man3/printf.3:38 build/C/man3/puts.3:27 build/C/man2/read.2:38 build/C/man2/readlink.2:44 build/C/man2/readv.2:33 build/C/man3/remove.3:34 build/C/man2/rename.2:35 build/C/man2/rmdir.2:33 build/C/man3/scanf.3:53 build/C/man3/setbuf.3:49 build/C/man3/stdin.3:12 build/C/man3/stdio.3:40 build/C/man3/stdio_ext.3:28 build/C/man2/symlink.2:35 build/C/man3/tempnam.3:26 build/C/man3/tmpfile.3:32 build/C/man3/tmpnam.3:28 build/C/man2/unlink.2:35 build/C/man3/unlocked_stdio.3:27 build/C/man3/wprintf.3:18 build/C/man2/write.2:42
+#: build/C/man3/asprintf.3:30 build/C/man3/ctermid.3:29 build/C/man3/dprintf.3:29 build/C/man3/fclose.3:47 build/C/man3/fcloseall.3:28 build/C/man3/ferror.3:47 build/C/man3/fflush.3:48 build/C/man3/fgetwc.3:21 build/C/man3/flockfile.3:28 build/C/man3/fmemopen.3:13 build/C/man3/fmtmsg.3:16 build/C/man3/fopen.3:47 build/C/man3/fopencookie.3:29 build/C/man3/fpurge.3:28 build/C/man3/fputwc.3:19 build/C/man3/fread.3:48 build/C/man3/fseek.3:45 build/C/man3/fseeko.3:28 build/C/man3/getline.3:29 build/C/man3/gets.3:30 build/C/man3/getw.3:28 build/C/man2/link.2:34 build/C/man2/llseek.2:31 build/C/man2/lseek.2:50 build/C/man3/lseek64.3:28 build/C/man2/open.2:54 build/C/man3/perror.3:34 build/C/man2/pipe.2:39 build/C/man3/popen.3:43 build/C/man3/printf.3:38 build/C/man3/puts.3:29 build/C/man2/read.2:38 build/C/man2/readlink.2:46 build/C/man2/readv.2:35 build/C/man3/remove.3:34 build/C/man2/rename.2:35 build/C/man2/rmdir.2:33 build/C/man3/scanf.3:55 build/C/man3/setbuf.3:51 build/C/man3/stdin.3:16 build/C/man3/stdio.3:42 build/C/man3/stdio_ext.3:30 build/C/man2/symlink.2:35 build/C/man3/tempnam.3:28 build/C/man3/tmpfile.3:34 build/C/man3/tmpnam.3:30 build/C/man2/unlink.2:35 build/C/man3/unlocked_stdio.3:29 build/C/man3/wprintf.3:20 build/C/man2/write.2:42
#, no-wrap
msgid "SYNOPSIS"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:30
+#: build/C/man3/asprintf.3:32
msgid "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:32 build/C/man3/dprintf.3:30 build/C/man3/fclose.3:47 build/C/man3/ferror.3:47 build/C/man3/fflush.3:48 build/C/man3/fseek.3:45 build/C/man3/perror.3:35 build/C/man3/printf.3:40 build/C/man3/remove.3:36 build/C/man2/rename.2:37 build/C/man3/stdio.3:42 build/C/man3/stdio_ext.3:30
+#: build/C/man3/asprintf.3:34 build/C/man3/dprintf.3:31 build/C/man3/fclose.3:49 build/C/man3/ferror.3:49 build/C/man3/fflush.3:50 build/C/man3/fseek.3:47 build/C/man3/perror.3:36 build/C/man3/printf.3:40 build/C/man3/remove.3:36 build/C/man2/rename.2:37 build/C/man3/stdio.3:44 build/C/man3/stdio_ext.3:32
msgid "B<#include E<lt>stdio.hE<gt>>"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:34
+#: build/C/man3/asprintf.3:36
msgid "B<int asprintf(char **>I<strp>B<, const char *>I<fmt>B<, ...);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:36
+#: build/C/man3/asprintf.3:38
msgid ""
"B<int vasprintf(char **>I<strp>B<, const char *>I<fmt>B<, va_list "
">I<ap>B<);>"
msgstr ""
#. type: SH
-#: build/C/man3/asprintf.3:36 build/C/man3/ctermid.3:44 build/C/man3/dprintf.3:54 build/C/man3/fclose.3:49 build/C/man3/fcloseall.3:34 build/C/man3/ferror.3:63 build/C/man3/fflush.3:50 build/C/man3/fgetwc.3:28 build/C/man3/flockfile.3:49 build/C/man3/fmemopen.3:42 build/C/man3/fmtmsg.3:22 build/C/man3/fopen.3:63 build/C/man3/fopencookie.3:35 build/C/man3/fpurge.3:40 build/C/man3/fputwc.3:26 build/C/man3/fread.3:56 build/C/man3/fseek.3:55 build/C/man3/fseeko.3:35 build/C/man3/getline.3:56 build/C/man3/gets.3:44 build/C/man3/getw.3:57 build/C/man2/link.2:38 build/C/man2/llseek.2:38 build/C/man2/lseek.2:54 build/C/man3/lseek64.3:34 build/C/man2/open.2:66 build/C/man3/perror.3:54 build/C/man2/pipe.2:50 build/C/man3/popen.3:62 build/C/man3/printf.3:76 build/C/man3/puts.3:41 build/C/man2/read.2:44 build/C/man2/readlink.2:61 build/C/man2/readv.2:56 build/C/man3/remove.3:38 build/C/man2/rename.2:39 build/C/man2/rmdir.2:37 build/C/man3/scanf.3:85 build/C/man3/setbuf.3:71 build/C/man3/stdin.3:20 build/C/man3/stdio.3:48 build/C/man3/stdio_ext.3:52 build/C/man2/symlink.2:52 build/C/man3/tempnam.3:40 build/C/man3/tmpfile.3:38 build/C/man3/tmpnam.3:34 build/C/man2/unlink.2:39 build/C/man3/unlocked_stdio.3:104 build/C/man3/wprintf.3:58 build/C/man2/write.2:46
+#: build/C/man3/asprintf.3:38 build/C/man3/ctermid.3:46 build/C/man3/dprintf.3:55 build/C/man3/fclose.3:51 build/C/man3/fcloseall.3:35 build/C/man3/ferror.3:65 build/C/man3/fflush.3:52 build/C/man3/fgetwc.3:30 build/C/man3/flockfile.3:51 build/C/man3/fmemopen.3:46 build/C/man3/fmtmsg.3:26 build/C/man3/fopen.3:65 build/C/man3/fopencookie.3:37 build/C/man3/fpurge.3:42 build/C/man3/fputwc.3:28 build/C/man3/fread.3:58 build/C/man3/fseek.3:57 build/C/man3/fseeko.3:37 build/C/man3/getline.3:58 build/C/man3/gets.3:46 build/C/man3/getw.3:59 build/C/man2/link.2:38 build/C/man2/llseek.2:43 build/C/man2/lseek.2:56 build/C/man3/lseek64.3:36 build/C/man2/open.2:65 build/C/man3/perror.3:55 build/C/man2/pipe.2:51 build/C/man3/popen.3:64 build/C/man3/printf.3:76 build/C/man3/puts.3:43 build/C/man2/read.2:44 build/C/man2/readlink.2:63 build/C/man2/readv.2:58 build/C/man3/remove.3:38 build/C/man2/rename.2:39 build/C/man2/rmdir.2:37 build/C/man3/scanf.3:87 build/C/man3/setbuf.3:73 build/C/man3/stdin.3:24 build/C/man3/stdio.3:50 build/C/man3/stdio_ext.3:54 build/C/man2/symlink.2:52 build/C/man3/tempnam.3:42 build/C/man3/tmpfile.3:40 build/C/man3/tmpnam.3:36 build/C/man2/unlink.2:39 build/C/man3/unlocked_stdio.3:106 build/C/man3/wprintf.3:60 build/C/man2/write.2:46
#, no-wrap
msgid "DESCRIPTION"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:51
+#: build/C/man3/asprintf.3:53
msgid ""
"The functions B<asprintf>() and B<vasprintf>() are analogs of "
"B<sprintf>(3) and B<vsprintf>(3), except that they allocate a string large "
-"enough to hold the output including the terminating null byte, and return a "
-"pointer to it via the first argument. This pointer should be passed to "
-"B<free>(3) to release the allocated storage when it is no longer needed."
+"enough to hold the output including the terminating null byte "
+"(\\(aq\\e0\\(aq), and return a pointer to it via the first argument. This "
+"pointer should be passed to B<free>(3) to release the allocated storage "
+"when it is no longer needed."
msgstr ""
#. type: SH
-#: build/C/man3/asprintf.3:51 build/C/man3/ctermid.3:57 build/C/man3/fclose.3:57 build/C/man3/fcloseall.3:49 build/C/man3/fflush.3:72 build/C/man3/fgetwc.3:53 build/C/man3/flockfile.3:112 build/C/man3/fmemopen.3:172 build/C/man3/fmtmsg.3:148 build/C/man3/fopen.3:189 build/C/man3/fopencookie.3:235 build/C/man3/fpurge.3:56 build/C/man3/fputwc.3:52 build/C/man3/fread.3:81 build/C/man3/fseek.3:117 build/C/man3/fseeko.3:63 build/C/man3/getline.3:108 build/C/man3/gets.3:109 build/C/man3/getw.3:71 build/C/man2/link.2:52 build/C/man2/llseek.2:57 build/C/man2/lseek.2:151 build/C/man2/open.2:466 build/C/man2/pipe.2:91 build/C/man3/popen.3:121 build/C/man3/puts.3:82 build/C/man2/read.2:63 build/C/man2/readlink.2:75 build/C/man2/readv.2:175 build/C/man3/remove.3:60 build/C/man2/rename.2:91 build/C/man2/rmdir.2:40 build/C/man3/scanf.3:528 build/C/man3/setbuf.3:150 build/C/man2/symlink.2:84 build/C/man3/tempnam.3:85 build/C/man3/tmpfile.3:45 build/C/man3/tmpnam.3:68 build/C/man2/unlink.2:55 build/C/man3/wprintf.3:185 build/C/man2/write.2:89
+#: build/C/man3/asprintf.3:53 build/C/man3/ctermid.3:59 build/C/man3/fclose.3:59 build/C/man3/fcloseall.3:50 build/C/man3/fflush.3:74 build/C/man3/fgetwc.3:55 build/C/man3/flockfile.3:120 build/C/man3/fmemopen.3:176 build/C/man3/fmtmsg.3:152 build/C/man3/fopen.3:189 build/C/man3/fopencookie.3:238 build/C/man3/fpurge.3:58 build/C/man3/fputwc.3:54 build/C/man3/fread.3:83 build/C/man3/fseek.3:121 build/C/man3/fseeko.3:75 build/C/man3/getline.3:110 build/C/man3/gets.3:111 build/C/man3/getw.3:73 build/C/man2/link.2:52 build/C/man2/llseek.2:62 build/C/man2/lseek.2:162 build/C/man2/open.2:568 build/C/man2/pipe.2:92 build/C/man3/popen.3:123 build/C/man3/puts.3:84 build/C/man2/read.2:81 build/C/man2/readlink.2:77 build/C/man2/readv.2:177 build/C/man3/remove.3:60 build/C/man2/rename.2:91 build/C/man2/rmdir.2:40 build/C/man3/scanf.3:530 build/C/man3/setbuf.3:152 build/C/man2/symlink.2:84 build/C/man3/tempnam.3:87 build/C/man3/tmpfile.3:47 build/C/man3/tmpnam.3:70 build/C/man2/unlink.2:55 build/C/man3/wprintf.3:205 build/C/man2/write.2:89
#, no-wrap
msgid "RETURN VALUE"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:59
+#: build/C/man3/asprintf.3:61
msgid ""
"When successful, these functions return the number of bytes printed, just "
"like B<sprintf>(3). If memory allocation wasn't possible, or some other "
msgstr ""
#. type: SH
-#: build/C/man3/asprintf.3:59 build/C/man3/ctermid.3:59 build/C/man3/dprintf.3:68 build/C/man3/fclose.3:88 build/C/man3/fcloseall.3:54 build/C/man3/ferror.3:105 build/C/man3/fflush.3:91 build/C/man3/fgetwc.3:65 build/C/man3/flockfile.3:119 build/C/man3/fmemopen.3:191 build/C/man3/fmtmsg.3:221 build/C/man3/fopen.3:246 build/C/man3/fopencookie.3:242 build/C/man3/fpurge.3:68 build/C/man3/fputwc.3:63 build/C/man3/fread.3:96 build/C/man3/fseek.3:164 build/C/man3/fseeko.3:75 build/C/man3/getline.3:132 build/C/man3/gets.3:136 build/C/man3/getw.3:78 build/C/man2/link.2:128 build/C/man2/llseek.2:76 build/C/man2/lseek.2:189 build/C/man2/open.2:612 build/C/man3/perror.3:107 build/C/man2/pipe.2:117 build/C/man3/popen.3:167 build/C/man3/printf.3:807 build/C/man3/puts.3:101 build/C/man2/read.2:155 build/C/man2/readlink.2:123 build/C/man2/readv.2:212 build/C/man3/remove.3:70 build/C/man2/rename.2:229 build/C/man2/rmdir.2:127 build/C/man3/scanf.3:575 build/C/man3/setbuf.3:162 build/C/man3/stdin.3:109 build/C/man3/stdio.3:244 build/C/man2/symlink.2:144 build/C/man3/tempnam.3:94 build/C/man3/tmpfile.3:74 build/C/man3/tmpnam.3:75 build/C/man2/unlink.2:141 build/C/man3/unlocked_stdio.3:111 build/C/man3/wprintf.3:193 build/C/man2/write.2:179
+#: build/C/man3/asprintf.3:61 build/C/man3/ctermid.3:67 build/C/man3/dprintf.3:69 build/C/man3/fclose.3:90 build/C/man3/fcloseall.3:60 build/C/man3/ferror.3:115 build/C/man3/fflush.3:98 build/C/man3/fgetwc.3:70 build/C/man3/flockfile.3:135 build/C/man3/fmemopen.3:195 build/C/man3/fmtmsg.3:237 build/C/man3/fopen.3:246 build/C/man3/fopencookie.3:245 build/C/man3/fpurge.3:70 build/C/man3/fputwc.3:68 build/C/man3/fread.3:103 build/C/man3/fseek.3:168 build/C/man3/fseeko.3:87 build/C/man3/getline.3:137 build/C/man3/gets.3:138 build/C/man3/getw.3:80 build/C/man2/link.2:138 build/C/man2/llseek.2:81 build/C/man2/lseek.2:200 build/C/man2/open.2:727 build/C/man3/perror.3:111 build/C/man2/pipe.2:118 build/C/man3/popen.3:172 build/C/man3/printf.3:807 build/C/man3/puts.3:103 build/C/man2/read.2:173 build/C/man2/readlink.2:125 build/C/man2/readv.2:214 build/C/man3/remove.3:70 build/C/man2/rename.2:232 build/C/man2/rmdir.2:127 build/C/man3/scanf.3:577 build/C/man3/setbuf.3:164 build/C/man3/stdin.3:113 build/C/man3/stdio.3:246 build/C/man2/symlink.2:149 build/C/man3/tempnam.3:98 build/C/man3/tmpfile.3:78 build/C/man3/tmpnam.3:87 build/C/man2/unlink.2:141 build/C/man3/unlocked_stdio.3:113 build/C/man3/wprintf.3:213 build/C/man2/write.2:185
#, no-wrap
msgid "CONFORMING TO"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:65
+#: build/C/man3/asprintf.3:67
msgid ""
"These functions are GNU extensions, not in C or POSIX. They are also "
"available under *BSD. The FreeBSD implementation sets I<strp> to NULL on "
msgstr ""
#. type: SH
-#: build/C/man3/asprintf.3:65 build/C/man3/ctermid.3:69 build/C/man3/dprintf.3:94 build/C/man3/fclose.3:100 build/C/man3/fcloseall.3:56 build/C/man3/ferror.3:112 build/C/man3/fflush.3:106 build/C/man3/fgetwc.3:82 build/C/man3/flockfile.3:127 build/C/man3/fmemopen.3:273 build/C/man3/fmtmsg.3:293 build/C/man3/fopen.3:301 build/C/man3/fopencookie.3:434 build/C/man3/fpurge.3:78 build/C/man3/fputwc.3:80 build/C/man3/fread.3:98 build/C/man3/fseek.3:166 build/C/man3/fseeko.3:81 build/C/man3/getline.3:166 build/C/man3/gets.3:164 build/C/man3/getw.3:84 build/C/man2/link.2:177 build/C/man2/llseek.2:82 build/C/man2/lseek.2:234 build/C/man3/lseek64.3:157 build/C/man2/open.2:851 build/C/man3/perror.3:135 build/C/man2/pipe.2:189 build/C/man3/popen.3:196 build/C/man3/printf.3:1074 build/C/man3/puts.3:110 build/C/man2/read.2:178 build/C/man2/readlink.2:212 build/C/man2/readv.2:282 build/C/man3/remove.3:81 build/C/man2/rename.2:242 build/C/man2/rmdir.2:132 build/C/man3/scanf.3:717 build/C/man3/setbuf.3:198 build/C/man3/stdin.3:150 build/C/man3/stdio.3:248 build/C/man3/stdio_ext.3:130 build/C/man2/symlink.2:159 build/C/man7/symlink.7:470 build/C/man3/tempnam.3:164 build/C/man3/tmpfile.3:86 build/C/man3/tmpnam.3:151 build/C/man2/unlink.2:148 build/C/man3/unlocked_stdio.3:134 build/C/man3/wprintf.3:229 build/C/man2/write.2:205
+#: build/C/man3/asprintf.3:67 build/C/man3/ctermid.3:77 build/C/man3/dprintf.3:95 build/C/man3/fclose.3:102 build/C/man3/fcloseall.3:62 build/C/man3/ferror.3:122 build/C/man3/fflush.3:113 build/C/man3/fgetwc.3:87 build/C/man3/flockfile.3:143 build/C/man3/fmemopen.3:341 build/C/man3/fmtmsg.3:309 build/C/man3/fopen.3:348 build/C/man3/fopencookie.3:437 build/C/man3/fpurge.3:80 build/C/man3/fputwc.3:85 build/C/man3/fread.3:105 build/C/man3/fseek.3:170 build/C/man3/fseeko.3:93 build/C/man3/getline.3:171 build/C/man3/gets.3:173 build/C/man3/getw.3:86 build/C/man2/link.2:187 build/C/man2/llseek.2:87 build/C/man2/lseek.2:245 build/C/man3/lseek64.3:164 build/C/man2/open.2:1000 build/C/man3/perror.3:139 build/C/man2/pipe.2:190 build/C/man3/popen.3:201 build/C/man3/printf.3:1081 build/C/man3/puts.3:112 build/C/man2/read.2:187 build/C/man2/readlink.2:214 build/C/man2/readv.2:284 build/C/man3/remove.3:81 build/C/man2/rename.2:245 build/C/man2/rmdir.2:132 build/C/man3/scanf.3:715 build/C/man3/setbuf.3:200 build/C/man3/stdin.3:154 build/C/man3/stdio.3:250 build/C/man3/stdio_ext.3:151 build/C/man2/symlink.2:164 build/C/man7/symlink.7:471 build/C/man3/tempnam.3:168 build/C/man3/tmpfile.3:97 build/C/man3/tmpnam.3:163 build/C/man2/unlink.2:148 build/C/man3/unlocked_stdio.3:136 build/C/man3/wprintf.3:253 build/C/man2/write.2:211
#, no-wrap
msgid "SEE ALSO"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:69
+#: build/C/man3/asprintf.3:71
msgid "B<free>(3), B<malloc>(3), B<printf>(3)"
msgstr ""
#. type: SH
-#: build/C/man3/asprintf.3:69 build/C/man3/ctermid.3:71 build/C/man3/dprintf.3:96 build/C/man3/fclose.3:106 build/C/man3/fcloseall.3:62 build/C/man3/ferror.3:117 build/C/man3/fflush.3:114 build/C/man3/fgetwc.3:87 build/C/man3/flockfile.3:129 build/C/man3/fmemopen.3:276 build/C/man3/fmtmsg.3:296 build/C/man3/fopen.3:307 build/C/man3/fopencookie.3:439 build/C/man3/fpurge.3:83 build/C/man3/fputwc.3:84 build/C/man3/fread.3:104 build/C/man3/fseek.3:169 build/C/man3/fseeko.3:83 build/C/man3/getline.3:173 build/C/man3/gets.3:179 build/C/man3/getw.3:90 build/C/man2/link.2:187 build/C/man2/llseek.2:85 build/C/man2/lseek.2:241 build/C/man3/lseek64.3:160 build/C/man2/open.2:873 build/C/man3/perror.3:140 build/C/man2/pipe.2:196 build/C/man3/popen.3:206 build/C/man3/printf.3:1083 build/C/man3/puts.3:122 build/C/man2/read.2:191 build/C/man2/readlink.2:220 build/C/man2/readv.2:286 build/C/man3/remove.3:92 build/C/man2/rename.2:251 build/C/man2/rmdir.2:141 build/C/man3/scanf.3:724 build/C/man3/setbuf.3:206 build/C/man3/stdin.3:156 build/C/man3/stdio.3:255 build/C/man3/stdio_ext.3:133 build/C/man2/symlink.2:171 build/C/man7/symlink.7:488 build/C/man3/tempnam.3:169 build/C/man3/tmpfile.3:92 build/C/man3/tmpnam.3:156 build/C/man2/unlink.2:161 build/C/man3/unlocked_stdio.3:137 build/C/man3/wprintf.3:236 build/C/man2/write.2:217
+#: build/C/man3/asprintf.3:71 build/C/man3/ctermid.3:79 build/C/man3/dprintf.3:97 build/C/man3/fclose.3:108 build/C/man3/fcloseall.3:68 build/C/man3/ferror.3:127 build/C/man3/fflush.3:121 build/C/man3/fgetwc.3:92 build/C/man3/flockfile.3:145 build/C/man3/fmemopen.3:344 build/C/man3/fmtmsg.3:312 build/C/man3/fopen.3:354 build/C/man3/fopencookie.3:442 build/C/man3/fpurge.3:85 build/C/man3/fputwc.3:89 build/C/man3/fread.3:111 build/C/man3/fseek.3:173 build/C/man3/fseeko.3:95 build/C/man3/getline.3:178 build/C/man3/gets.3:189 build/C/man3/getw.3:92 build/C/man2/link.2:197 build/C/man2/llseek.2:90 build/C/man2/lseek.2:252 build/C/man3/lseek64.3:167 build/C/man2/open.2:1022 build/C/man3/perror.3:144 build/C/man2/pipe.2:197 build/C/man3/popen.3:211 build/C/man3/printf.3:1090 build/C/man3/puts.3:124 build/C/man2/read.2:200 build/C/man2/readlink.2:222 build/C/man2/readv.2:288 build/C/man3/remove.3:92 build/C/man2/rename.2:254 build/C/man2/rmdir.2:141 build/C/man3/scanf.3:722 build/C/man3/setbuf.3:208 build/C/man3/stdin.3:160 build/C/man3/stdio.3:257 build/C/man3/stdio_ext.3:154 build/C/man2/symlink.2:176 build/C/man7/symlink.7:489 build/C/man3/tempnam.3:173 build/C/man3/tmpfile.3:103 build/C/man3/tmpnam.3:168 build/C/man2/unlink.2:161 build/C/man3/unlocked_stdio.3:139 build/C/man3/wprintf.3:260 build/C/man2/write.2:223
#, no-wrap
msgid "COLOPHON"
msgstr ""
#. type: Plain text
-#: build/C/man3/asprintf.3:76 build/C/man3/ctermid.3:78 build/C/man3/dprintf.3:103 build/C/man3/fclose.3:113 build/C/man3/fcloseall.3:69 build/C/man3/ferror.3:124 build/C/man3/fflush.3:121 build/C/man3/fgetwc.3:94 build/C/man3/flockfile.3:136 build/C/man3/fmemopen.3:283 build/C/man3/fmtmsg.3:303 build/C/man3/fopen.3:314 build/C/man3/fopencookie.3:446 build/C/man3/fpurge.3:90 build/C/man3/fputwc.3:91 build/C/man3/fread.3:111 build/C/man3/fseek.3:176 build/C/man3/fseeko.3:90 build/C/man3/getline.3:180 build/C/man3/gets.3:186 build/C/man3/getw.3:97 build/C/man2/link.2:194 build/C/man2/llseek.2:92 build/C/man2/lseek.2:248 build/C/man3/lseek64.3:167 build/C/man2/open.2:880 build/C/man3/perror.3:147 build/C/man2/pipe.2:203 build/C/man3/popen.3:213 build/C/man3/printf.3:1090 build/C/man3/puts.3:129 build/C/man2/read.2:198 build/C/man2/readlink.2:227 build/C/man2/readv.2:293 build/C/man3/remove.3:99 build/C/man2/rename.2:258 build/C/man2/rmdir.2:148 build/C/man3/scanf.3:731 build/C/man3/setbuf.3:213 build/C/man3/stdin.3:163 build/C/man3/stdio.3:262 build/C/man3/stdio_ext.3:140 build/C/man2/symlink.2:178 build/C/man7/symlink.7:495 build/C/man3/tempnam.3:176 build/C/man3/tmpfile.3:99 build/C/man3/tmpnam.3:163 build/C/man2/unlink.2:168 build/C/man3/unlocked_stdio.3:144 build/C/man3/wprintf.3:243 build/C/man2/write.2:224
+#: build/C/man3/asprintf.3:78 build/C/man3/ctermid.3:86 build/C/man3/dprintf.3:104 build/C/man3/fclose.3:115 build/C/man3/fcloseall.3:75 build/C/man3/ferror.3:134 build/C/man3/fflush.3:128 build/C/man3/fgetwc.3:99 build/C/man3/flockfile.3:152 build/C/man3/fmemopen.3:351 build/C/man3/fmtmsg.3:319 build/C/man3/fopen.3:361 build/C/man3/fopencookie.3:449 build/C/man3/fpurge.3:92 build/C/man3/fputwc.3:96 build/C/man3/fread.3:118 build/C/man3/fseek.3:180 build/C/man3/fseeko.3:102 build/C/man3/getline.3:185 build/C/man3/gets.3:196 build/C/man3/getw.3:99 build/C/man2/link.2:204 build/C/man2/llseek.2:97 build/C/man2/lseek.2:259 build/C/man3/lseek64.3:174 build/C/man2/open.2:1029 build/C/man3/perror.3:151 build/C/man2/pipe.2:204 build/C/man3/popen.3:218 build/C/man3/printf.3:1097 build/C/man3/puts.3:131 build/C/man2/read.2:207 build/C/man2/readlink.2:229 build/C/man2/readv.2:295 build/C/man3/remove.3:99 build/C/man2/rename.2:261 build/C/man2/rmdir.2:148 build/C/man3/scanf.3:729 build/C/man3/setbuf.3:215 build/C/man3/stdin.3:167 build/C/man3/stdio.3:264 build/C/man3/stdio_ext.3:161 build/C/man2/symlink.2:183 build/C/man7/symlink.7:496 build/C/man3/tempnam.3:180 build/C/man3/tmpfile.3:110 build/C/man3/tmpnam.3:175 build/C/man2/unlink.2:168 build/C/man3/unlocked_stdio.3:146 build/C/man3/wprintf.3:267 build/C/man2/write.2:230
msgid ""
-"This page is part of release 3.35 of the Linux I<man-pages> project. A "
+"This page is part of release 3.54 of the Linux I<man-pages> project. A "
"description of the project, and information about reporting bugs, can be "
-"found at http://man7.org/linux/man-pages/."
+"found at \\%http://www.kernel.org/doc/man-pages/."
msgstr ""
#. type: TH
-#: build/C/man3/ctermid.3:24
+#: build/C/man3/ctermid.3:26
#, no-wrap
msgid "CTERMID"
msgstr ""
#. type: TH
-#: build/C/man3/ctermid.3:24 build/C/man3/perror.3:30
+#: build/C/man3/ctermid.3:26
#, no-wrap
-msgid "2007-07-26"
+msgid "2013-07-04"
msgstr ""
#. type: Plain text
-#: build/C/man3/ctermid.3:27
+#: build/C/man3/ctermid.3:29
msgid "ctermid - get controlling terminal name"
msgstr ""
#. type: Plain text
-#: build/C/man3/ctermid.3:32 build/C/man3/fgetwc.3:22 build/C/man3/flockfile.3:29 build/C/man3/fmemopen.3:12 build/C/man3/fopen.3:48 build/C/man3/fputwc.3:20 build/C/man3/fread.3:49 build/C/man3/fseeko.3:29 build/C/man3/getline.3:30 build/C/man3/gets.3:31 build/C/man3/getw.3:29 build/C/man3/popen.3:44 build/C/man3/puts.3:30 build/C/man3/scanf.3:56 build/C/man3/setbuf.3:52 build/C/man3/stdin.3:15 build/C/man3/tempnam.3:29 build/C/man3/tmpfile.3:35 build/C/man3/tmpnam.3:31 build/C/man3/unlocked_stdio.3:30
+#: build/C/man3/ctermid.3:34 build/C/man3/fgetwc.3:24 build/C/man3/flockfile.3:31 build/C/man3/fmemopen.3:16 build/C/man3/fopen.3:50 build/C/man3/fputwc.3:22 build/C/man3/fread.3:51 build/C/man3/fseeko.3:31 build/C/man3/getline.3:32 build/C/man3/gets.3:33 build/C/man3/getw.3:31 build/C/man3/popen.3:46 build/C/man3/puts.3:32 build/C/man3/scanf.3:58 build/C/man3/setbuf.3:54 build/C/man3/stdin.3:19 build/C/man3/tempnam.3:31 build/C/man3/tmpfile.3:37 build/C/man3/tmpnam.3:33 build/C/man3/unlocked_stdio.3:32
#, no-wrap
msgid "B<#include E<lt>stdio.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/ctermid.3:34
+#: build/C/man3/ctermid.3:36
#, no-wrap
msgid "B<char *ctermid(char *>I<s>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/ctermid.3:39 build/C/man3/dprintf.3:38 build/C/man3/ferror.3:59 build/C/man3/flockfile.3:40 build/C/man3/fmemopen.3:25 build/C/man3/fopen.3:59 build/C/man3/getline.3:40 build/C/man3/getw.3:38 build/C/man3/perror.3:49 build/C/man3/popen.3:53 build/C/man3/printf.3:63 build/C/man2/readlink.2:52 build/C/man2/readv.2:51 build/C/man3/scanf.3:71 build/C/man3/setbuf.3:66 build/C/man2/symlink.2:43 build/C/man3/tempnam.3:36 build/C/man3/unlocked_stdio.3:66 build/C/man3/wprintf.3:37
+#: build/C/man3/ctermid.3:41 build/C/man3/dprintf.3:39 build/C/man3/ferror.3:61 build/C/man3/flockfile.3:42 build/C/man3/fmemopen.3:29 build/C/man3/fopen.3:61 build/C/man3/getline.3:42 build/C/man3/getw.3:40 build/C/man3/perror.3:50 build/C/man3/popen.3:55 build/C/man3/printf.3:63 build/C/man2/readlink.2:54 build/C/man2/readv.2:53 build/C/man3/scanf.3:73 build/C/man3/setbuf.3:68 build/C/man2/symlink.2:43 build/C/man3/tempnam.3:38 build/C/man3/unlocked_stdio.3:68 build/C/man3/wprintf.3:39
msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
msgstr ""
#. From <unistd.h>: _XOPEN_SOURCE
#. type: Plain text
-#: build/C/man3/ctermid.3:44
+#: build/C/man3/ctermid.3:46
msgid "B<ctermid>(): _POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/ctermid.3:57
+#: build/C/man3/ctermid.3:59
msgid ""
"B<ctermid>() returns a string which is the pathname for the current "
"controlling terminal for this process. If I<s> is NULL, a static buffer is "
msgstr ""
#. type: Plain text
-#: build/C/man3/ctermid.3:59
+#: build/C/man3/ctermid.3:61
msgid "The pointer to the pathname."
msgstr ""
+#. type: SH
+#: build/C/man3/ctermid.3:61 build/C/man3/fcloseall.3:55 build/C/man3/ferror.3:106 build/C/man3/fflush.3:93 build/C/man3/flockfile.3:127 build/C/man3/fmtmsg.3:225 build/C/man3/lseek64.3:159 build/C/man3/stdio_ext.3:132 build/C/man3/tmpnam.3:77
+#, no-wrap
+msgid "ATTRIBUTES"
+msgstr ""
+
+#. type: SS
+#: build/C/man3/ctermid.3:62 build/C/man3/fcloseall.3:56 build/C/man3/ferror.3:107 build/C/man3/fflush.3:94 build/C/man3/flockfile.3:128 build/C/man3/fmtmsg.3:226 build/C/man3/lseek64.3:160 build/C/man3/stdio_ext.3:133 build/C/man3/tmpnam.3:78
+#, no-wrap
+msgid "Multithreading (see pthreads(7))"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/ctermid.3:61
+#: build/C/man3/ctermid.3:67
+msgid ""
+"The B<ctermid>() function is thread-safe with exceptions. It is not "
+"thread-safe if called with a NULL parameter."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/ctermid.3:69
msgid "Svr4, POSIX.1-2001."
msgstr ""
#. type: SH
-#: build/C/man3/ctermid.3:61 build/C/man3/fmemopen.3:201 build/C/man3/gets.3:143 build/C/man3/getw.3:80 build/C/man2/link.2:171 build/C/man2/open.2:840 build/C/man3/popen.3:173 build/C/man3/printf.3:930 build/C/man3/puts.3:103 build/C/man2/readv.2:256 build/C/man3/remove.3:78 build/C/man2/rename.2:231 build/C/man2/rmdir.2:129 build/C/man3/scanf.3:682 build/C/man3/setbuf.3:168 build/C/man3/tempnam.3:154 build/C/man3/tmpnam.3:144 build/C/man2/unlink.2:145
+#: build/C/man3/ctermid.3:69 build/C/man3/fmemopen.3:213 build/C/man3/fopen.3:331 build/C/man3/gets.3:152 build/C/man3/getw.3:82 build/C/man2/link.2:181 build/C/man2/open.2:989 build/C/man3/popen.3:178 build/C/man3/printf.3:930 build/C/man3/puts.3:105 build/C/man2/readv.2:258 build/C/man3/remove.3:78 build/C/man2/rename.2:234 build/C/man2/rmdir.2:129 build/C/man3/scanf.3:646 build/C/man3/setbuf.3:170 build/C/man3/tempnam.3:158 build/C/man3/tmpnam.3:156 build/C/man2/unlink.2:145
#, no-wrap
msgid "BUGS"
msgstr ""
#. type: Plain text
-#: build/C/man3/ctermid.3:65
+#: build/C/man3/ctermid.3:73
msgid ""
"The path returned may not uniquely identify the controlling terminal; it "
"may, for example, be I</dev/tty>."
#. in glibc 2.3.x, x >= 4, the glibc headers threw an error
#. if ctermid() was given an argument; fixed in 2.4.
#. type: Plain text
-#: build/C/man3/ctermid.3:69
+#: build/C/man3/ctermid.3:77
msgid "It is not assured that the program can open the terminal."
msgstr ""
#. type: Plain text
-#: build/C/man3/ctermid.3:71
+#: build/C/man3/ctermid.3:79
msgid "B<ttyname>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/dprintf.3:25
+#: build/C/man3/dprintf.3:26
#, no-wrap
msgid "DPRINTF"
msgstr ""
#. type: TH
-#: build/C/man3/dprintf.3:25 build/C/man3/fmemopen.3:6
+#: build/C/man3/dprintf.3:26
#, no-wrap
msgid "2010-09-15"
msgstr ""
#. type: Plain text
-#: build/C/man3/dprintf.3:28
+#: build/C/man3/dprintf.3:29
msgid "dprintf, vdprintf - print to a file descriptor"
msgstr ""
#. type: Plain text
-#: build/C/man3/dprintf.3:32
+#: build/C/man3/dprintf.3:33
msgid "B<int dprintf(int >I<fd>B<, const char *>I<format>B<, ...);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/dprintf.3:34
+#: build/C/man3/dprintf.3:35
msgid "B<int vdprintf(int >I<fd>B<, const char *>I<format>B<, va_list >I<ap>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/dprintf.3:42
+#: build/C/man3/dprintf.3:43
msgid "B<dprintf>(), B<vdprintf>():"
msgstr ""
#. type: TP
-#: build/C/man3/dprintf.3:45 build/C/man3/fmemopen.3:33 build/C/man3/getline.3:47
+#: build/C/man3/dprintf.3:46 build/C/man3/fmemopen.3:37 build/C/man3/getline.3:49
#, no-wrap
msgid "Since glibc 2.10:"
msgstr ""
#. type: Plain text
-#: build/C/man3/dprintf.3:48 build/C/man3/fmemopen.3:36
+#: build/C/man3/dprintf.3:49 build/C/man3/fmemopen.3:40
msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
msgstr ""
#. type: TP
-#: build/C/man3/dprintf.3:48 build/C/man3/fmemopen.3:36 build/C/man3/getline.3:50
+#: build/C/man3/dprintf.3:49 build/C/man3/fmemopen.3:40 build/C/man3/getline.3:52
#, no-wrap
msgid "Before glibc 2.10:"
msgstr ""
#. type: Plain text
-#: build/C/man3/dprintf.3:51 build/C/man3/fmemopen.3:39 build/C/man3/getline.3:53 build/C/man3/unlocked_stdio.3:102
+#: build/C/man3/dprintf.3:52 build/C/man3/fmemopen.3:43 build/C/man3/getline.3:55 build/C/man3/unlocked_stdio.3:104
msgid "_GNU_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/dprintf.3:68
+#: build/C/man3/dprintf.3:69
msgid ""
"The functions B<dprintf>() and B<vdprintf>() (as found in the glibc2 "
"library) are exact analogs of B<fprintf>(3) and B<vfprintf>(3), except that "
#. A better name would have been
#. .BR fdprintf ().
#. type: Plain text
-#: build/C/man3/dprintf.3:94
+#: build/C/man3/dprintf.3:95
msgid ""
"These functions are GNU extensions that are nowadays specified in "
"POSIX.1-2008."
msgstr ""
#. type: Plain text
-#: build/C/man3/dprintf.3:96
+#: build/C/man3/dprintf.3:97
msgid "B<printf>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fclose.3:42
+#: build/C/man3/fclose.3:44
#, no-wrap
msgid "FCLOSE"
msgstr ""
#. type: TH
-#: build/C/man3/fclose.3:42 build/C/man3/fopen.3:42 build/C/man2/read.2:35
+#: build/C/man3/fclose.3:44
#, no-wrap
msgid "2009-02-23"
msgstr ""
#. type: Plain text
-#: build/C/man3/fclose.3:45
+#: build/C/man3/fclose.3:47
msgid "fclose - close a stream"
msgstr ""
#. type: Plain text
-#: build/C/man3/fclose.3:49
+#: build/C/man3/fclose.3:51
msgid "B<int fclose(FILE *>I<fp>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fclose.3:57
+#: build/C/man3/fclose.3:59
msgid ""
-"The B<fclose>() function will flushes the stream pointed to by I<fp> "
-"(writing any buffered output data using B<fflush>(3)) and closes the "
-"underlying file descriptor."
+"The B<fclose>() function flushes the stream pointed to by I<fp> (writing "
+"any buffered output data using B<fflush>(3)) and closes the underlying file "
+"descriptor."
msgstr ""
#. type: Plain text
-#: build/C/man3/fclose.3:68
+#: build/C/man3/fclose.3:70
msgid ""
"Upon successful completion 0 is returned. Otherwise, B<EOF> is returned and "
"I<errno> is set to indicate the error. In either case any further access "
msgstr ""
#. type: SH
-#: build/C/man3/fclose.3:68 build/C/man3/ferror.3:95 build/C/man3/fflush.3:79 build/C/man3/fgetwc.3:59 build/C/man3/flockfile.3:117 build/C/man3/fopen.3:201 build/C/man3/fpurge.3:63 build/C/man3/fputwc.3:58 build/C/man3/fseek.3:132 build/C/man3/fseeko.3:72 build/C/man3/getline.3:120 build/C/man2/link.2:57 build/C/man2/llseek.2:64 build/C/man2/lseek.2:159 build/C/man2/open.2:474 build/C/man2/pipe.2:96 build/C/man3/popen.3:141 build/C/man2/read.2:77 build/C/man2/readlink.2:83 build/C/man2/readv.2:186 build/C/man3/remove.3:65 build/C/man2/rename.2:96 build/C/man2/rmdir.2:45 build/C/man3/scanf.3:545 build/C/man2/symlink.2:89 build/C/man3/tempnam.3:90 build/C/man3/tmpfile.3:52 build/C/man3/tmpnam.3:73 build/C/man2/unlink.2:60 build/C/man2/write.2:107
+#: build/C/man3/fclose.3:70 build/C/man3/ferror.3:96 build/C/man3/fflush.3:81 build/C/man3/fgetwc.3:64 build/C/man3/flockfile.3:125 build/C/man3/fopen.3:201 build/C/man3/fpurge.3:65 build/C/man3/fputwc.3:63 build/C/man3/fseek.3:136 build/C/man3/fseeko.3:84 build/C/man3/getline.3:125 build/C/man2/link.2:57 build/C/man2/llseek.2:69 build/C/man2/lseek.2:170 build/C/man2/open.2:576 build/C/man2/pipe.2:97 build/C/man3/popen.3:146 build/C/man2/read.2:95 build/C/man2/readlink.2:85 build/C/man2/readv.2:188 build/C/man3/remove.3:65 build/C/man2/rename.2:96 build/C/man2/rmdir.2:45 build/C/man3/scanf.3:547 build/C/man2/symlink.2:89 build/C/man3/tempnam.3:94 build/C/man3/tmpfile.3:56 build/C/man3/tmpnam.3:75 build/C/man2/unlink.2:60 build/C/man2/write.2:107
#, no-wrap
msgid "ERRORS"
msgstr ""
#. type: TP
-#: build/C/man3/fclose.3:69 build/C/man3/fflush.3:80 build/C/man3/fpurge.3:64 build/C/man3/fseek.3:133 build/C/man2/llseek.2:65 build/C/man2/lseek.2:160 build/C/man2/read.2:96 build/C/man3/scanf.3:551 build/C/man2/write.2:126
+#: build/C/man3/fclose.3:71 build/C/man3/fflush.3:82 build/C/man3/fpurge.3:66 build/C/man3/fseek.3:137 build/C/man2/llseek.2:70 build/C/man2/lseek.2:171 build/C/man2/read.2:114 build/C/man3/scanf.3:553 build/C/man2/write.2:126
#, no-wrap
msgid "B<EBADF>"
msgstr ""
#. you must have closed the stream's low-level file descriptor using
#. something like close(fileno(fp)).
#. type: Plain text
-#: build/C/man3/fclose.3:78
+#: build/C/man3/fclose.3:80
msgid "The file descriptor underlying I<fp> is not valid."
msgstr ""
#. type: Plain text
-#: build/C/man3/fclose.3:88
+#: build/C/man3/fclose.3:90
msgid ""
"The B<fclose>() function may also fail and set I<errno> for any of the "
"errors specified for the routines B<close>(2), B<write>(2) or B<fflush>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/fclose.3:90 build/C/man3/fseek.3:166 build/C/man3/puts.3:103
+#: build/C/man3/fclose.3:92 build/C/man3/fseek.3:170 build/C/man3/puts.3:105
msgid "C89, C99."
msgstr ""
#. type: SH
-#: build/C/man3/fclose.3:90 build/C/man3/fflush.3:97 build/C/man3/fgetwc.3:67 build/C/man3/fmemopen.3:195 build/C/man3/fmtmsg.3:236 build/C/man3/fopen.3:255 build/C/man3/fpurge.3:76 build/C/man3/fputwc.3:65 build/C/man3/fseeko.3:77 build/C/man2/link.2:133 build/C/man2/llseek.2:79 build/C/man2/lseek.2:199 build/C/man2/open.2:638 build/C/man3/perror.3:120 build/C/man3/printf.3:868 build/C/man2/read.2:157 build/C/man2/readlink.2:128 build/C/man2/readv.2:224 build/C/man3/remove.3:72 build/C/man3/scanf.3:606 build/C/man3/stdin.3:118 build/C/man2/symlink.2:150 build/C/man3/tempnam.3:99 build/C/man3/tmpfile.3:76 build/C/man3/tmpnam.3:80 build/C/man3/wprintf.3:195 build/C/man2/write.2:188
+#: build/C/man3/fclose.3:92 build/C/man3/fflush.3:104 build/C/man3/fgetwc.3:72 build/C/man3/fmemopen.3:207 build/C/man3/fmtmsg.3:252 build/C/man3/fopen.3:255 build/C/man3/fpurge.3:78 build/C/man3/fputwc.3:70 build/C/man3/fseeko.3:89 build/C/man2/link.2:143 build/C/man2/llseek.2:84 build/C/man2/lseek.2:210 build/C/man2/open.2:754 build/C/man3/perror.3:124 build/C/man3/printf.3:868 build/C/man2/read.2:175 build/C/man2/readlink.2:130 build/C/man2/readv.2:226 build/C/man3/remove.3:72 build/C/man3/scanf.3:608 build/C/man3/stdin.3:122 build/C/man2/symlink.2:155 build/C/man3/tempnam.3:103 build/C/man3/tmpfile.3:80 build/C/man3/tmpnam.3:92 build/C/man3/wprintf.3:215 build/C/man2/write.2:194
#, no-wrap
msgid "NOTES"
msgstr ""
#. type: Plain text
-#: build/C/man3/fclose.3:100
+#: build/C/man3/fclose.3:102
msgid ""
-"Note that B<fclose>() only flushes the user space buffers provided by the C "
+"Note that B<fclose>() only flushes the user-space buffers provided by the C "
"library. To ensure that the data is physically stored on disk the kernel "
"buffers must be flushed too, for example, with B<sync>(2) or B<fsync>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/fclose.3:106
+#: build/C/man3/fclose.3:108
msgid "B<close>(2), B<fcloseall>(3), B<fflush>(3), B<fopen>(3), B<setbuf>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fcloseall.3:24
+#: build/C/man3/fcloseall.3:25
#, no-wrap
msgid "FCLOSEALL"
msgstr ""
-#. type: TH
-#: build/C/man3/fcloseall.3:24
-#, no-wrap
-msgid "2006-12-27"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/fcloseall.3:27
+#: build/C/man3/fcloseall.3:28
msgid "fcloseall - close all open streams"
msgstr ""
#. type: Plain text
-#: build/C/man3/fcloseall.3:31 build/C/man3/fopencookie.3:31
+#: build/C/man3/fcloseall.3:32 build/C/man3/fopencookie.3:33
#, no-wrap
msgid ""
"B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fcloseall.3:33
+#: build/C/man3/fcloseall.3:34
#, no-wrap
msgid "B<int fcloseall(void);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fcloseall.3:42
+#: build/C/man3/fcloseall.3:43
msgid ""
"The B<fcloseall>() function closes all of the calling process's open "
"streams. Buffered output for each stream is written before it is closed (as "
msgstr ""
#. type: Plain text
-#: build/C/man3/fcloseall.3:49
+#: build/C/man3/fcloseall.3:50
msgid "The standard streams, I<stdin>, I<stdout>, and I<stderr> are also closed."
msgstr ""
#. type: Plain text
-#: build/C/man3/fcloseall.3:54
+#: build/C/man3/fcloseall.3:55
msgid ""
"This function returns 0 if all files were successfully closed; on error, "
"B<EOF> is returned."
msgstr ""
#. type: Plain text
-#: build/C/man3/fcloseall.3:56
-msgid "This function is a GNU extension."
+#: build/C/man3/fcloseall.3:60
+msgid ""
+"The B<fcloseall>() function does not lock the streams, so it is not "
+"thread-safe."
msgstr ""
#. type: Plain text
#: build/C/man3/fcloseall.3:62
-msgid "B<close>(2), B<fclose>(3), B<fflush>(3), B<fopen>(3), B<setbuf>(3)"
+msgid "This function is a GNU extension."
msgstr ""
-#. type: TH
-#: build/C/man3/ferror.3:42
-#, no-wrap
-msgid "FERROR"
+#. type: Plain text
+#: build/C/man3/fcloseall.3:68
+msgid "B<close>(2), B<fclose>(3), B<fflush>(3), B<fopen>(3), B<setbuf>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/ferror.3:42 build/C/man3/flockfile.3:23 build/C/man3/unlocked_stdio.3:23
+#: build/C/man3/ferror.3:44
#, no-wrap
-msgid "2008-08-29"
+msgid "FERROR"
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:45
+#: build/C/man3/ferror.3:47
msgid "clearerr, feof, ferror, fileno - check and reset stream status"
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:49
+#: build/C/man3/ferror.3:51
msgid "B<void clearerr(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:51
+#: build/C/man3/ferror.3:53
msgid "B<int feof(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:53
+#: build/C/man3/ferror.3:55
msgid "B<int ferror(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:55
+#: build/C/man3/ferror.3:57
msgid "B<int fileno(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:63
+#: build/C/man3/ferror.3:65
msgid "B<fileno>(): _POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:68
+#: build/C/man3/ferror.3:70
msgid ""
"The function B<clearerr>() clears the end-of-file and error indicators for "
"the stream pointed to by I<stream>."
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:77
+#: build/C/man3/ferror.3:78
msgid ""
"The function B<feof>() tests the end-of-file indicator for the stream "
"pointed to by I<stream>, returning nonzero if it is set. The end-of-file "
-"indicator can only be cleared by the function B<clearerr>()."
+"indicator can be cleared only by the function B<clearerr>()."
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:86
+#: build/C/man3/ferror.3:87
msgid ""
"The function B<ferror>() tests the error indicator for the stream pointed "
-"to by I<stream>, returning nonzero if it is set. The error indicator can "
-"only be reset by the B<clearerr>() function."
+"to by I<stream>, returning nonzero if it is set. The error indicator can be "
+"reset only by the B<clearerr>() function."
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:92
+#: build/C/man3/ferror.3:93
msgid ""
"The function B<fileno>() examines the argument I<stream> and returns its "
"integer descriptor."
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:95 build/C/man3/fgetwc.3:53 build/C/man3/fputwc.3:52 build/C/man3/fread.3:81 build/C/man3/gets.3:109 build/C/man3/puts.3:82
+#: build/C/man3/ferror.3:96 build/C/man3/fgetwc.3:55 build/C/man3/fputwc.3:54 build/C/man3/fread.3:83 build/C/man3/gets.3:111 build/C/man3/puts.3:84
msgid "For nonlocking counterparts, see B<unlocked_stdio>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:105
+#: build/C/man3/ferror.3:106
msgid ""
"These functions should not fail and do not set the external variable "
"I<errno>. (However, in case B<fileno>() detects that its argument is not a "
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:112
+#: build/C/man3/ferror.3:115
+msgid ""
+"The B<clearerr>(), B<feof>(), B<ferror>(), and B<fileno>() functions are "
+"thread-safe."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/ferror.3:122
msgid ""
"The functions B<clearerr>(), B<feof>(), and B<ferror>() conform to C89 and "
"C99."
msgstr ""
#. type: Plain text
-#: build/C/man3/ferror.3:117
+#: build/C/man3/ferror.3:127
msgid "B<open>(2), B<fdopen>(3), B<stdio>(3), B<unlocked_stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fflush.3:43
+#: build/C/man3/fflush.3:45
#, no-wrap
msgid "FFLUSH"
msgstr ""
#. type: TH
-#: build/C/man3/fflush.3:43
+#: build/C/man3/fflush.3:45
#, no-wrap
-msgid "2009-09-06"
+msgid "2013-07-15"
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:46
+#: build/C/man3/fflush.3:48
msgid "fflush - flush a stream"
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:50
+#: build/C/man3/fflush.3:52
msgid "B<int fflush(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:61
+#: build/C/man3/fflush.3:63
msgid ""
"For output streams, B<fflush>() forces a write of all user-space buffered "
"data for the given output or update I<stream> via the stream's underlying "
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:69
+#: build/C/man3/fflush.3:71
msgid ""
"If the I<stream> argument is NULL, B<fflush>() flushes I<all> open output "
"streams."
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:72
+#: build/C/man3/fflush.3:74
msgid "For a nonlocking counterpart, see B<unlocked_stdio>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:79
+#: build/C/man3/fflush.3:81
msgid ""
"Upon successful completion 0 is returned. Otherwise, B<EOF> is returned and "
"I<errno> is set to indicate the error."
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:84
+#: build/C/man3/fflush.3:86
msgid "I<Stream> is not an open stream, or is not open for writing."
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:91
+#: build/C/man3/fflush.3:93
msgid ""
"The function B<fflush>() may also fail and set I<errno> for any of the "
"errors specified for B<write>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:93
+#: build/C/man3/fflush.3:98
+msgid "The B<fflush>() function is thread-safe."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/fflush.3:100
msgid "C89, C99, POSIX.1-2001, POSIX.1-2008."
msgstr ""
#. Verified on: Solaris 8.
#. type: Plain text
-#: build/C/man3/fflush.3:97
+#: build/C/man3/fflush.3:104
msgid ""
"The standards do not specify the behavior for input streams. Most other "
"implementations behave the same as Linux."
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:106
+#: build/C/man3/fflush.3:113
msgid ""
-"Note that B<fflush>() only flushes the user space buffers provided by the C "
+"Note that B<fflush>() only flushes the user-space buffers provided by the C "
"library. To ensure that the data is physically stored on disk the kernel "
"buffers must be flushed too, for example, with B<sync>(2) or B<fsync>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/fflush.3:114
+#: build/C/man3/fflush.3:121
msgid ""
"B<fsync>(2), B<sync>(2), B<write>(2), B<fclose>(3), B<fopen>(3), "
"B<setbuf>(3), B<unlocked_stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fgetwc.3:16
+#: build/C/man3/fgetwc.3:18
#, no-wrap
msgid "FGETWC"
msgstr ""
#. type: TH
-#: build/C/man3/fgetwc.3:16 build/C/man3/fputwc.3:14
+#: build/C/man3/fgetwc.3:18 build/C/man3/fputwc.3:16 build/C/man3/getline.3:26 build/C/man3/popen.3:40 build/C/man3/tempnam.3:25
#, no-wrap
-msgid "1999-07-25"
+msgid "2013-04-19"
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:19
+#: build/C/man3/fgetwc.3:21
msgid "fgetwc, getwc - read a wide character from a FILE stream"
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:24 build/C/man3/fmemopen.3:18 build/C/man3/fputwc.3:22 build/C/man3/unlocked_stdio.3:52
+#: build/C/man3/fgetwc.3:26 build/C/man3/fmemopen.3:22 build/C/man3/fputwc.3:24 build/C/man3/unlocked_stdio.3:54
#, no-wrap
msgid "B<#include E<lt>wchar.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:27
+#: build/C/man3/fgetwc.3:29
#, no-wrap
msgid ""
"B<wint_t fgetwc(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:42
+#: build/C/man3/fgetwc.3:44
msgid ""
"The B<fgetwc>() function is the wide-character equivalent of the "
"B<fgetc>(3) function. It reads a wide character from I<stream> and returns "
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:50
+#: build/C/man3/fgetwc.3:52
msgid ""
"The B<getwc>() function or macro functions identically to B<fgetwc>(). It "
"may be implemented as a macro, and may evaluate its argument more than "
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:59
+#: build/C/man3/fgetwc.3:64
msgid ""
"The B<fgetwc>() function returns the next wide-character from the stream, "
-"or B<WEOF>."
+"or B<WEOF>. In the event of an error, I<errno> is set to indicate the "
+"cause."
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:61 build/C/man3/fputwc.3:60
+#: build/C/man3/fgetwc.3:66 build/C/man3/fputwc.3:65
msgid "Apart from the usual ones, there is"
msgstr ""
#. type: TP
-#: build/C/man3/fgetwc.3:61 build/C/man3/fputwc.3:60 build/C/man3/scanf.3:556
+#: build/C/man3/fgetwc.3:66 build/C/man3/fputwc.3:65 build/C/man3/scanf.3:558
#, no-wrap
msgid "B<EILSEQ>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:65
+#: build/C/man3/fgetwc.3:70
msgid "The data obtained from the input stream does not form a valid character."
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:67 build/C/man3/fputwc.3:65
+#: build/C/man3/fgetwc.3:72 build/C/man3/fputwc.3:70
msgid "C99, POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:74
+#: build/C/man3/fgetwc.3:79
msgid ""
"The behavior of B<fgetwc>() depends on the B<LC_CTYPE> category of the "
"current locale."
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:82
+#: build/C/man3/fgetwc.3:87
msgid ""
"In the absence of additional information passed to the B<fopen>(3) call, it "
"is reasonable to expect that B<fgetwc>() will actually read a multibyte "
msgstr ""
#. type: Plain text
-#: build/C/man3/fgetwc.3:87
+#: build/C/man3/fgetwc.3:92
msgid "B<fgetws>(3), B<fputwc>(3), B<ungetwc>(3), B<unlocked_stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/flockfile.3:23
+#: build/C/man3/flockfile.3:25
#, no-wrap
msgid "FLOCKFILE"
msgstr ""
+#. type: TH
+#: build/C/man3/flockfile.3:25
+#, no-wrap
+msgid "2013-07-23"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/flockfile.3:26
+#: build/C/man3/flockfile.3:28
msgid "flockfile, ftrylockfile, funlockfile - lock FILE for stdio"
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:31
+#: build/C/man3/flockfile.3:33
#, no-wrap
msgid "B<void flockfile(FILE *>I<filehandle>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:33
+#: build/C/man3/flockfile.3:35
#, no-wrap
msgid "B<int ftrylockfile(FILE *>I<filehandle>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:35
+#: build/C/man3/flockfile.3:37
#, no-wrap
msgid "B<void funlockfile(FILE *>I<filehandle>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:44 build/C/man3/wprintf.3:41
+#: build/C/man3/flockfile.3:46 build/C/man3/wprintf.3:43
msgid "All functions shown above:"
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:47
+#: build/C/man3/flockfile.3:49
msgid ""
"_POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE "
"|| _POSIX_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:61
+#: build/C/man3/flockfile.3:63
msgid ""
"The stdio functions are thread-safe. This is achieved by assigning to each "
"I<FILE> object a lockcount and (if the lockcount is nonzero) an owning "
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:67
+#: build/C/man3/flockfile.3:69
msgid ""
"(Note: this locking has nothing to do with the file locking done by "
"functions like B<flock>(2) and B<lockf>(3).)"
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:75
+#: build/C/man3/flockfile.3:77
msgid ""
"All this is invisible to the C-programmer, but there may be two reasons to "
"wish for more detailed control. On the one hand, maybe a series of I/O "
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:92
+#: build/C/man3/flockfile.3:94
msgid ""
"To this end, a thread can explicitly lock the I<FILE> object, then do its "
"series of I/O actions, then unlock. This prevents other threads from coming "
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:99
+#: build/C/man3/flockfile.3:105
msgid ""
"The B<flockfile>() function waits for I<*filehandle> to be no longer locked "
"by a different thread, then makes the current thread owner of "
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:103
+#: build/C/man3/flockfile.3:109
msgid "The B<funlockfile>() function decrements the lock count."
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:112
+#: build/C/man3/flockfile.3:120
msgid ""
"The B<ftrylockfile>() function is a nonblocking version of B<flockfile>(). "
"It does nothing in case some other thread owns I<*filehandle>, and it "
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:117
+#: build/C/man3/flockfile.3:125
msgid ""
"The B<ftrylockfile>() function returns zero for success (the lock was "
"obtained), and nonzero for failure."
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:119
+#: build/C/man3/flockfile.3:127
msgid "None."
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:121 build/C/man3/popen.3:169
+#: build/C/man3/flockfile.3:135
+msgid ""
+"The B<flockfile>(), B<ftrylockfile>(), and B<funlockfile>() functions are "
+"thread-safe."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/flockfile.3:137 build/C/man3/popen.3:174
msgid "POSIX.1-2001."
msgstr ""
#. type: SH
-#: build/C/man3/flockfile.3:121
+#: build/C/man3/flockfile.3:137
#, no-wrap
msgid "AVAILABILITY"
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:127
+#: build/C/man3/flockfile.3:143
msgid ""
"These functions are available when B<_POSIX_THREAD_SAFE_FUNCTIONS> is "
"defined. They are in libc since libc 5.1.1 and in glibc since glibc 2.0."
msgstr ""
#. type: Plain text
-#: build/C/man3/flockfile.3:129
+#: build/C/man3/flockfile.3:145
msgid "B<unlocked_stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fmemopen.3:6
+#: build/C/man3/fmemopen.3:10
#, no-wrap
msgid "FMEMOPEN"
msgstr ""
+#. type: TH
+#: build/C/man3/fmemopen.3:10
+#, no-wrap
+msgid "2012-04-28"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/fmemopen.3:9
+#: build/C/man3/fmemopen.3:13
msgid "fmemopen, open_memstream, open_wmemstream - open memory as stream"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:14
+#: build/C/man3/fmemopen.3:18
#, no-wrap
msgid ""
"B<FILE *fmemopen(void *>I<buf>B<, size_t >I<size>B<, const char "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:16
+#: build/C/man3/fmemopen.3:20
#, no-wrap
msgid "B<FILE *open_memstream(char **>I<ptr>B<, size_t *>I<sizeloc>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:20
+#: build/C/man3/fmemopen.3:24
#, no-wrap
msgid "B<FILE *open_wmemstream(wchar_t **>I<ptr>B<, size_t *>I<sizeloc>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:30
+#: build/C/man3/fmemopen.3:34
msgid "B<fmemopen>(), B<open_memstream>(), B<open_wmemstream>():"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:53
+#: build/C/man3/fmemopen.3:57
msgid ""
"The B<fmemopen>() function opens a stream that permits the access specified "
"by I<mode>. The stream allows I/O to be performed on the string or memory "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:73
+#: build/C/man3/fmemopen.3:77
msgid ""
"The argument I<mode> is the same as for B<fopen>(3). If I<mode> specifies "
"an append mode, then the initial file position is set to the location of the "
"first null byte (\\(aq\\e0\\(aq) in the buffer; otherwise the initial file "
-"position is set to the start of the buffer. Since glibc 2.9, the letter 'b' "
-"may be specified as the second character in I<mode>. This provides "
-"\"binary\" mode: writes don't implicitly add a terminating null byte, and "
-"B<fseek>(3) B<SEEK_END> is relative to the end of the buffer (i.e., the "
-"value specified by the I<size> argument), rather than the current string "
-"length."
+"position is set to the start of the buffer. Since glibc 2.9, the letter "
+"\\(aqb\\(aq may be specified as the second character in I<mode>. This "
+"provides \"binary\" mode: writes don't implicitly add a terminating null "
+"byte, and B<fseek>(3) B<SEEK_END> is relative to the end of the buffer "
+"(i.e., the value specified by the I<size> argument), rather than the current "
+"string length."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:85
+#: build/C/man3/fmemopen.3:89
msgid ""
"When a stream that has been opened for writing is flushed (B<fflush>(3)) or "
"closed (B<fclose>(3)), a null byte is written at the end of the buffer if "
#. and
#. http://sources.redhat.com/ml/libc-alpha/2006-04/msg00064.html
#. type: Plain text
-#: build/C/man3/fmemopen.3:103
+#: build/C/man3/fmemopen.3:107
msgid ""
"Attempts to write more than I<size> bytes to the buffer result in an error. "
-"(By default, such errors will only be visible when the I<stdio> buffer is "
+"(By default, such errors will be visible only when the I<stdio> buffer is "
"flushed. Disabling buffering with I<setbuf(fp,\\ NULL)> may be useful to "
"detect errors at the time of an output operation. Alternatively, the caller "
"can explicitly set I<buf> as the stdio stream buffer, at the same time "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:111
+#: build/C/man3/fmemopen.3:115
msgid ""
"In a stream opened for reading, null bytes (\\(aq\\e0\\(aq) in the buffer do "
"not cause read operations to return an end-of-file indication. A read from "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:126
+#: build/C/man3/fmemopen.3:130
msgid ""
"If I<buf> is specified as NULL, then B<fmemopen>() dynamically allocates a "
"buffer I<size> bytes long. This is useful for an application that wants to "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:137
+#: build/C/man3/fmemopen.3:141
msgid ""
"The B<open_memstream>() function opens a stream for writing to a buffer. "
"The buffer is dynamically allocated (as with B<malloc>(3)), and "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:152
+#: build/C/man3/fmemopen.3:156
msgid ""
"When the stream is closed (B<fclose>(3)) or flushed (B<fflush>(3)), the "
"locations pointed to by I<ptr> and I<sizeloc> are updated to contain, "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:158
+#: build/C/man3/fmemopen.3:162
msgid ""
"A null byte is maintained at the end of the buffer. This byte is I<not> "
"included in the size value stored at I<sizeloc>."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:166
+#: build/C/man3/fmemopen.3:170
msgid ""
"The stream's file position can be changed with B<fseek>(3) or "
"B<fseeko>(3). Moving the file position past the end of the data already "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:172
+#: build/C/man3/fmemopen.3:176
msgid ""
"The B<open_wmemstream>() is similar to B<open_memstream>(), but operates on "
"wide characters instead of bytes."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:184
+#: build/C/man3/fmemopen.3:188
msgid ""
"Upon successful completion B<fmemopen>(), B<open_memstream>() and "
"B<open_wmemstream>() return a I<FILE> pointer. Otherwise, NULL is returned "
msgstr ""
#. type: SH
-#: build/C/man3/fmemopen.3:184 build/C/man3/fmtmsg.3:218 build/C/man3/getline.3:130 build/C/man2/pipe.2:112 build/C/man2/readv.2:207
+#: build/C/man3/fmemopen.3:188 build/C/man3/fmtmsg.3:222 build/C/man3/getline.3:135 build/C/man2/pipe.2:113 build/C/man2/readv.2:209
#, no-wrap
msgid "VERSIONS"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:191
+#: build/C/man3/fmemopen.3:195
msgid ""
"B<fmemopen>() and B<open_memstream>() were already available in glibc "
"1.0.x. B<open_wmemstream>() is available since glibc 2.4."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:195
+#: build/C/man3/fmemopen.3:199
msgid ""
"POSIX.1-2008. These functions are not specified in POSIX.1-2001, and are "
"not widely available on other systems."
msgstr ""
+#. http://austingroupbugs.net/view.php?id=396
+#. type: Plain text
+#: build/C/man3/fmemopen.3:207
+msgid ""
+"POSIX.1-2008 specifies that \\(aqb\\(aq in I<mode> shall be ignored. "
+"However, Technical Corrigendum 1 adjusts the standard to allow "
+"implementation-specific treatment for this case, thus permitting the glibc "
+"treatment of \\(aqb\\(aq."
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/fmemopen.3:201
+#: build/C/man3/fmemopen.3:213
msgid ""
"There is no file descriptor associated with the file stream returned by "
"these functions (i.e., B<fileno>(3) will return an error if called on the "
#. http://sourceware.org/bugzilla/show_bug.cgi?id=1996
#. type: Plain text
-#: build/C/man3/fmemopen.3:208
+#: build/C/man3/fmemopen.3:220
msgid ""
"In glibc before version 2.7, seeking past the end of a stream created by "
"B<open_memstream>() does not enlarge the buffer; instead the B<fseek>(3) "
"call fails, returning -1."
msgstr ""
+#. FIXME http://sourceware.org/bugzilla/show_bug.cgi?id=11216
+#. type: Plain text
+#: build/C/man3/fmemopen.3:231
+msgid ""
+"If I<size> is specified as zero, B<fmemopen>() fails with the error "
+"B<EINVAL>. It would be more consistent if this case successfully created a "
+"stream that then returned end of file on the first attempt at reading. "
+"Furthermore, POSIX.1-2008 does not specify a failure for this case."
+msgstr ""
+
+#. FIXME http://sourceware.org/bugzilla/show_bug.cgi?id=13152
+#. type: Plain text
+#: build/C/man3/fmemopen.3:239
+msgid ""
+"Specifying append mode (\"a\" or \"a+\") for B<fmemopen>() sets the initial "
+"file position to the first null byte, but (if the file offset is reset to a "
+"location other than the end of the stream) does not force subsequent writes "
+"to append at the end of the stream."
+msgstr ""
+
+#. FIXME http://sourceware.org/bugzilla/show_bug.cgi?id=13151
+#. type: Plain text
+#: build/C/man3/fmemopen.3:255
+msgid ""
+"If the I<mode> argument to B<fmemopen>() specifies append (\"a\" or "
+"\"a+\"), and the I<size> argument does not cover a null byte in I<buf> then, "
+"according to POSIX.1-2008, the initial file position should be set to the "
+"next byte after the end of the buffer. However, in this case the glibc "
+"B<fmemopen>() sets the file position to -1."
+msgstr ""
+
+#. FIXME http://sourceware.org/bugzilla/show_bug.cgi?id=12836
+#. type: Plain text
+#: build/C/man3/fmemopen.3:268
+msgid ""
+"To specify binary mode for B<fmemopen>() the \\(aqb\\(aq must be the "
+"I<second> character in I<mode>. Thus, for example, \"wb+\" has the desired "
+"effect, but \"w+b\" does not. This is inconsistent with the treatment of "
+"I<mode> by B<fopen>(3)."
+msgstr ""
+
+#. http://sourceware.org/bugzilla/show_bug.cgi?id=6544
+#. type: Plain text
+#: build/C/man3/fmemopen.3:276
+msgid ""
+"The glibc 2.9 addition of \"binary\" mode for B<fmemopen>() silently "
+"changed the ABI: previously, B<fmemopen>() ignored \\(aqb\\(aq in I<mode>."
+msgstr ""
+
#. type: SH
-#: build/C/man3/fmemopen.3:208 build/C/man3/fmtmsg.3:240 build/C/man3/fopencookie.3:244 build/C/man3/getline.3:139 build/C/man2/pipe.2:123 build/C/man3/printf.3:974 build/C/man2/readlink.2:155 build/C/man2/readv.2:263
+#: build/C/man3/fmemopen.3:276 build/C/man3/fmtmsg.3:256 build/C/man3/fopencookie.3:247 build/C/man3/getline.3:144 build/C/man2/pipe.2:124 build/C/man3/printf.3:974 build/C/man2/readlink.2:157 build/C/man2/readv.2:265 build/C/man3/scanf.3:681
#, no-wrap
msgid "EXAMPLE"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:218
+#: build/C/man3/fmemopen.3:286
msgid ""
"The program below uses B<fmemopen>() to open an input buffer, and "
"B<open_memstream>() to open a dynamically sized output buffer. The program "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:223
+#: build/C/man3/fmemopen.3:291
#, no-wrap
msgid ""
"$B< ./a.out \\(aq1 23 43\\(aq>\n"
msgstr ""
#. type: SS
-#: build/C/man3/fmemopen.3:225 build/C/man3/fopencookie.3:268
+#: build/C/man3/fmemopen.3:293 build/C/man3/fopencookie.3:271
#, no-wrap
msgid "Program source"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:232
+#: build/C/man3/fmemopen.3:300
#, no-wrap
msgid ""
"#define _GNU_SOURCE\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:235
+#: build/C/man3/fmemopen.3:303
#, no-wrap
msgid ""
"#define handle_error(msg) \\e\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:243
+#: build/C/man3/fmemopen.3:311
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:248
+#: build/C/man3/fmemopen.3:316
#, no-wrap
msgid ""
" if (argc != 2) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:252
+#: build/C/man3/fmemopen.3:320
#, no-wrap
msgid ""
" in = fmemopen(argv[1], strlen(argv[1]), \"r\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:256
+#: build/C/man3/fmemopen.3:324
#, no-wrap
msgid ""
" out = open_memstream(&ptr, &size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:261
+#: build/C/man3/fmemopen.3:329
#, no-wrap
msgid ""
" for (;;) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:272
+#: build/C/man3/fmemopen.3:340
#, no-wrap
msgid ""
" s = fprintf(out, \"%d \", v * v);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmemopen.3:276
+#: build/C/man3/fmemopen.3:344
msgid "B<fopen>(3), B<fopencookie>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fmtmsg.3:9
+#: build/C/man3/fmtmsg.3:13
#, no-wrap
msgid "FMTMSG"
msgstr ""
-#. type: TH
-#: build/C/man3/fmtmsg.3:9
-#, no-wrap
-msgid "2008-06-14"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/fmtmsg.3:12
+#: build/C/man3/fmtmsg.3:16
msgid "fmtmsg - print formatted error messages"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:15
+#: build/C/man3/fmtmsg.3:19
#, no-wrap
msgid "B<#include E<lt>fmtmsg.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:17
+#: build/C/man3/fmtmsg.3:21
#, no-wrap
msgid "B<int fmtmsg(long >I<classification>B<, const char *>I<label>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:19
+#: build/C/man3/fmtmsg.3:23
#, no-wrap
msgid "B< int >I<severity>B<, const char *>I<text>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:21
+#: build/C/man3/fmtmsg.3:25
#, no-wrap
msgid "B< const char *>I<action>B<, const char *>I<tag>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:32
+#: build/C/man3/fmtmsg.3:36
msgid ""
"This function displays a message described by its arguments on the device(s) "
"specified in the I<classification> argument. For messages written to "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:39
+#: build/C/man3/fmtmsg.3:43
msgid ""
"The I<label> argument identifies the source of the message. The string must "
"consist of two colon separated parts where the first part has not more than "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:43
+#: build/C/man3/fmtmsg.3:47
msgid "The I<text> argument describes the condition of the error."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:48
+#: build/C/man3/fmtmsg.3:52
msgid ""
"The I<action> argument describes possible steps to recover from the error. "
"If it is printed, it is prefixed by \"TO FIX: \"."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:56
+#: build/C/man3/fmtmsg.3:60
msgid ""
"The I<tag> argument is a reference to the online documentation where more "
"information can be found. It should contain the I<label> value and a unique "
msgstr ""
#. type: SS
-#: build/C/man3/fmtmsg.3:56
+#: build/C/man3/fmtmsg.3:60
#, no-wrap
msgid "Dummy arguments"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:75
+#: build/C/man3/fmtmsg.3:79
msgid ""
"Each of the arguments can have a dummy value. The dummy classification "
"value B<MM_NULLMC> (0L) does not specify any output, so nothing is printed. "
"The dummy severity value B<NO_SEV> (0) says that no severity is supplied. "
"The values B<MM_NULLLBL>, B<MM_NULLTXT>, B<MM_NULLACT>, B<MM_NULLTAG> are "
-"synonyms for I<((char *) 0)>, the empty string, and B<MM_NULLSEV> is a "
+"synonyms for I<((char\\ *)\\ 0)>, the empty string, and B<MM_NULLSEV> is a "
"synonym for B<NO_SEV>."
msgstr ""
#. type: SS
-#: build/C/man3/fmtmsg.3:75
+#: build/C/man3/fmtmsg.3:79
#, no-wrap
msgid "The classification argument"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:79
+#: build/C/man3/fmtmsg.3:83
msgid ""
"The I<classification> argument is the sum of values describing 4 types of "
"information."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:82
+#: build/C/man3/fmtmsg.3:86
msgid "The first value defines the output channel."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:82
+#: build/C/man3/fmtmsg.3:86
#, no-wrap
msgid "B<MM_PRINT>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:86
+#: build/C/man3/fmtmsg.3:90
msgid "Output to I<stderr>."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:86
+#: build/C/man3/fmtmsg.3:90
#, no-wrap
msgid "B<MM_CONSOLE>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:89
+#: build/C/man3/fmtmsg.3:93
msgid "Output to the system console."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:89
+#: build/C/man3/fmtmsg.3:93
#, no-wrap
msgid "B<MM_PRINT | MM_CONSOLE>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:92
+#: build/C/man3/fmtmsg.3:96
msgid "Output to both."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:94
+#: build/C/man3/fmtmsg.3:98
msgid "The second value is the source of the error:"
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:94
+#: build/C/man3/fmtmsg.3:98
#, no-wrap
msgid "B<MM_HARD>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:97
+#: build/C/man3/fmtmsg.3:101
msgid "A hardware error occurred."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:97
+#: build/C/man3/fmtmsg.3:101
#, no-wrap
msgid "B<MM_FIRM>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:100
+#: build/C/man3/fmtmsg.3:104
msgid "A firmware error occurred."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:100
+#: build/C/man3/fmtmsg.3:104
#, no-wrap
msgid "B<MM_SOFT>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:103
+#: build/C/man3/fmtmsg.3:107
msgid "A software error occurred."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:105
+#: build/C/man3/fmtmsg.3:109
msgid "The third value encodes the detector of the problem:"
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:105
+#: build/C/man3/fmtmsg.3:109
#, no-wrap
msgid "B<MM_APPL>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:108
+#: build/C/man3/fmtmsg.3:112
msgid "It is detected by an application."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:108
+#: build/C/man3/fmtmsg.3:112
#, no-wrap
msgid "B<MM_UTIL>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:111
+#: build/C/man3/fmtmsg.3:115
msgid "It is detected by a utility."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:111
+#: build/C/man3/fmtmsg.3:115
#, no-wrap
msgid "B<MM_OPSYS>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:114
+#: build/C/man3/fmtmsg.3:118
msgid "It is detected by the operating system."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:116
+#: build/C/man3/fmtmsg.3:120
msgid "The fourth value shows the severity of the incident:"
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:116
+#: build/C/man3/fmtmsg.3:120
#, no-wrap
msgid "B<MM_RECOVER>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:119
+#: build/C/man3/fmtmsg.3:123
msgid "It is a recoverable error."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:119
+#: build/C/man3/fmtmsg.3:123
#, no-wrap
msgid "B<MM_NRECOV>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:122
+#: build/C/man3/fmtmsg.3:126
msgid "It is a nonrecoverable error."
msgstr ""
#. type: SS
-#: build/C/man3/fmtmsg.3:122
+#: build/C/man3/fmtmsg.3:126
#, no-wrap
msgid "The severity argument"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:126
+#: build/C/man3/fmtmsg.3:130
msgid "The I<severity> argument can take one of the following values:"
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:126
+#: build/C/man3/fmtmsg.3:130
#, no-wrap
msgid "B<MM_NOSEV>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:129
+#: build/C/man3/fmtmsg.3:133
msgid "No severity is printed."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:129
+#: build/C/man3/fmtmsg.3:133
#, no-wrap
msgid "B<MM_HALT>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:132
+#: build/C/man3/fmtmsg.3:136
msgid "This value is printed as HALT."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:132
+#: build/C/man3/fmtmsg.3:136
#, no-wrap
msgid "B<MM_ERROR>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:135
+#: build/C/man3/fmtmsg.3:139
msgid "This value is printed as ERROR."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:135
+#: build/C/man3/fmtmsg.3:139
#, no-wrap
msgid "B<MM_WARNING>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:138
+#: build/C/man3/fmtmsg.3:142
msgid "This value is printed as WARNING."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:138
+#: build/C/man3/fmtmsg.3:142
#, no-wrap
msgid "B<MM_INFO>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:141
+#: build/C/man3/fmtmsg.3:145
msgid "This value is printed as INFO."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:148
+#: build/C/man3/fmtmsg.3:152
msgid ""
"The numeric values are between 0 and 4. Using B<addseverity>(3) or the "
"environment variable B<SEV_LEVEL> you can add more levels and strings to "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:150
+#: build/C/man3/fmtmsg.3:154
msgid "The function can return 4 values:"
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:150
+#: build/C/man3/fmtmsg.3:154
#, no-wrap
msgid "B<MM_OK>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:153
+#: build/C/man3/fmtmsg.3:157
msgid "Everything went smooth."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:153
+#: build/C/man3/fmtmsg.3:157
#, no-wrap
msgid "B<MM_NOTOK>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:156
+#: build/C/man3/fmtmsg.3:160
msgid "Complete failure."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:156
+#: build/C/man3/fmtmsg.3:160
#, no-wrap
msgid "B<MM_NOMSG>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:160
+#: build/C/man3/fmtmsg.3:164
msgid "Error writing to I<stderr>."
msgstr ""
#. type: TP
-#: build/C/man3/fmtmsg.3:160
+#: build/C/man3/fmtmsg.3:164
#, no-wrap
msgid "B<MM_NOCON>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:163
+#: build/C/man3/fmtmsg.3:167
msgid "Error writing to the console."
msgstr ""
#. type: SH
-#: build/C/man3/fmtmsg.3:163
+#: build/C/man3/fmtmsg.3:167
#, no-wrap
msgid "ENVIRONMENT"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:174
+#: build/C/man3/fmtmsg.3:178
msgid ""
"The environment variable B<MSGVERB> (\"message verbosity\") can be used to "
"suppress parts of the output to I<stderr>. (It does not influence output to "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:186
+#: build/C/man3/fmtmsg.3:190
msgid ""
"The environment variable B<SEV_LEVEL> can be used to introduce new severity "
"levels. By default, only the five severity levels described above are "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:189
+#: build/C/man3/fmtmsg.3:193
msgid "SEV_LEVEL=[description[:description[:...]]]"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:194
+#: build/C/man3/fmtmsg.3:198
msgid ""
"in the environment of the process before the first call to B<fmtmsg>(), "
"where each description is of the form"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:197
+#: build/C/man3/fmtmsg.3:201
msgid "severity-keyword,level,printstring"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:204
+#: build/C/man3/fmtmsg.3:208
msgid ""
"then B<fmtmsg>() will also accept the indicated values for the level (in "
"addition to the standard levels 0-4), and use the indicated printstring when "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:218
+#: build/C/man3/fmtmsg.3:222
msgid ""
"The severity-keyword part is not used by B<fmtmsg>() but it has to be "
"present. The level part is a string representation of a number. The "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:221
+#: build/C/man3/fmtmsg.3:225
msgid "B<fmtmsg>() is provided in glibc since version 2.1."
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:236
+#: build/C/man3/fmtmsg.3:231
+msgid ""
+"Before glibc 2.16, the B<fmtmsg>() function uses a static variable that is "
+"not protected, so it is not thread-safe."
+msgstr ""
+
+#. Modified in commit 7724defcf8873116fe4efab256596861eef21a94
+#. type: Plain text
+#: build/C/man3/fmtmsg.3:237
+msgid ""
+"Since glibc 2.16, the B<fmtmsg>() function uses a lock to protect the "
+"static variable, so it is thread-safe."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/fmtmsg.3:252
msgid ""
"The functions B<fmtmsg>() and B<addseverity>(3), and environment variables "
"B<MSGVERB> and B<SEV_LEVEL> come from System V. The function B<fmtmsg>() "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:240
+#: build/C/man3/fmtmsg.3:256
msgid ""
"System V and UnixWare man pages tell us that these functions have been "
"replaced by \"pfmt() and addsev()\" or by \"pfmt(), vpfmt(), lfmt(), and "
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:245
+#: build/C/man3/fmtmsg.3:261
#, no-wrap
msgid ""
"#include E<lt>stdio.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:251
+#: build/C/man3/fmtmsg.3:267
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:272
+#: build/C/man3/fmtmsg.3:288
#, no-wrap
msgid ""
" err = fmtmsg(class, \"util-linux:mount\", MM_ERROR,\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:275
+#: build/C/man3/fmtmsg.3:291
msgid "The output should be:"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:279
+#: build/C/man3/fmtmsg.3:295
#, no-wrap
msgid ""
" util-linux:mount: ERROR: unknown mount option\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:282
+#: build/C/man3/fmtmsg.3:298
msgid "and after"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:285
+#: build/C/man3/fmtmsg.3:301
#, no-wrap
msgid " MSGVERB=text:action; export MSGVERB\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:288
+#: build/C/man3/fmtmsg.3:304
msgid "the output becomes:"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:292
+#: build/C/man3/fmtmsg.3:308
#, no-wrap
msgid ""
" unknown mount option\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fmtmsg.3:296
+#: build/C/man3/fmtmsg.3:312
msgid "B<addseverity>(3), B<perror>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fopen.3:42
+#: build/C/man3/fopen.3:44
#, no-wrap
msgid "FOPEN"
msgstr ""
+#. type: TH
+#: build/C/man3/fopen.3:44
+#, no-wrap
+msgid "2012-04-22"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/fopen.3:45
+#: build/C/man3/fopen.3:47
msgid "fopen, fdopen, freopen - stream open functions"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:50
+#: build/C/man3/fopen.3:52
#, no-wrap
msgid "B<FILE *fopen(const char *>I<path>B<, const char *>I<mode>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:52
+#: build/C/man3/fopen.3:54
#, no-wrap
msgid "B<FILE *fdopen(int >I<fd>B<, const char *>I<mode>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:54
+#: build/C/man3/fopen.3:56
#, no-wrap
msgid ""
"B<FILE *freopen(const char *>I<path>B<, const char *>I<mode>B<, FILE "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:63
+#: build/C/man3/fopen.3:65
msgid "B<fdopen>(): _POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:69
+#: build/C/man3/fopen.3:71
msgid ""
"The B<fopen>() function opens the file whose name is the string pointed to "
"by I<path> and associates a stream with it."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:74
+#: build/C/man3/fopen.3:76
msgid ""
"The argument I<mode> points to a string beginning with one of the following "
-"sequences (Additional characters may follow these sequences.):"
+"sequences (possibly followed by additional characters, as described below):"
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:74
+#: build/C/man3/fopen.3:76
#, no-wrap
msgid "B<r>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:78
+#: build/C/man3/fopen.3:80
msgid ""
"Open text file for reading. The stream is positioned at the beginning of "
"the file."
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:78
+#: build/C/man3/fopen.3:80
#, no-wrap
msgid "B<r+>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:82
+#: build/C/man3/fopen.3:84
msgid ""
"Open for reading and writing. The stream is positioned at the beginning of "
"the file."
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:82
+#: build/C/man3/fopen.3:84
#, no-wrap
msgid "B<w>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:86
+#: build/C/man3/fopen.3:88
msgid ""
"Truncate file to zero length or create text file for writing. The stream is "
"positioned at the beginning of the file."
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:86
+#: build/C/man3/fopen.3:88
#, no-wrap
msgid "B<w+>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:92
+#: build/C/man3/fopen.3:94
msgid ""
"Open for reading and writing. The file is created if it does not exist, "
"otherwise it is truncated. The stream is positioned at the beginning of the "
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:92 build/C/man3/scanf.3:444
+#: build/C/man3/fopen.3:94 build/C/man3/scanf.3:447
#, no-wrap
msgid "B<a>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:97
+#: build/C/man3/fopen.3:99
msgid ""
"Open for appending (writing at end of file). The file is created if it does "
"not exist. The stream is positioned at the end of the file."
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:97
+#: build/C/man3/fopen.3:99
#, no-wrap
msgid "B<a+>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:103
+#: build/C/man3/fopen.3:105
msgid ""
"Open for reading and appending (writing at end of file). The file is "
"created if it does not exist. The initial file position for reading is at "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:116
+#: build/C/man3/fopen.3:118
msgid ""
"The I<mode> string can also include the letter \\(aqb\\(aq either as a last "
"character or as a character between the characters in any of the "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:119
+#: build/C/man3/fopen.3:121
msgid "See NOTES below for details of glibc extensions for I<mode>."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:124
+#: build/C/man3/fopen.3:126
msgid ""
"Any created files will have mode B<S_IRUSR> | B<S_IWUSR> | B<S_IRGRP> | "
"B<S_IWGRP> | B<S_IROTH> | B<S_IWOTH> (0666), as modified by the process's "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:139
+#: build/C/man3/fopen.3:141
msgid ""
"Reads and writes may be intermixed on read/write streams in any order. Note "
"that ANSI C requires that a file positioning function intervene between "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:144
+#: build/C/man3/fopen.3:146
msgid ""
"Opening a file in append mode (B<a> as the first character of I<mode>) "
"causes all subsequent write operations to this stream to occur at "
-"end-of-file, as if preceded by an"
+"end-of-file, as if preceded the call:"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:147
+#: build/C/man3/fopen.3:149
#, no-wrap
-msgid " fseek(stream,0,SEEK_END);\n"
-msgstr ""
-
-#. type: Plain text
-#: build/C/man3/fopen.3:150
-msgid "call."
+msgid " fseek(stream, 0, SEEK_END);\n"
msgstr ""
#. type: Plain text
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:202 build/C/man3/fseek.3:138 build/C/man3/getline.3:121 build/C/man2/llseek.2:72 build/C/man2/lseek.2:164 build/C/man2/pipe.2:101 build/C/man2/read.2:108 build/C/man2/read.2:119 build/C/man2/readlink.2:93 build/C/man2/readlink.2:102 build/C/man2/readv.2:198 build/C/man2/rename.2:136 build/C/man2/rmdir.2:67 build/C/man3/scanf.3:563 build/C/man2/write.2:148
+#: build/C/man3/fopen.3:202 build/C/man3/fseek.3:142 build/C/man3/getline.3:126 build/C/man2/llseek.2:77 build/C/man2/lseek.2:175 build/C/man2/open.2:613 build/C/man2/pipe.2:102 build/C/man2/read.2:126 build/C/man2/read.2:137 build/C/man2/readlink.2:95 build/C/man2/readlink.2:104 build/C/man2/readv.2:200 build/C/man2/rename.2:139 build/C/man2/rmdir.2:67 build/C/man3/scanf.3:565 build/C/man2/write.2:154
#, no-wrap
msgid "B<EINVAL>"
msgstr ""
#. type: SS
#: build/C/man3/fopen.3:256
#, no-wrap
-msgid "Glibc Notes"
+msgid "Glibc notes"
msgstr ""
#. type: Plain text
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:264
+#: build/C/man3/fopen.3:266
msgid ""
"Do not make the open operation, or subsequent read and write operations, "
-"thread cancellation points."
+"thread cancellation points. This flag is ignored for B<fdopen>()."
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:264
+#: build/C/man3/fopen.3:266
#, no-wrap
msgid "B<e> (since glibc 2.7)"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:272
+#: build/C/man3/fopen.3:276
msgid ""
"Open the file with the B<O_CLOEXEC> flag. See B<open>(2) for more "
-"information."
+"information. This flag is ignored for B<fdopen>()."
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:272
+#: build/C/man3/fopen.3:276
#, no-wrap
msgid "B<m> (since glibc 2.3)"
msgstr ""
#. As at glibc 2.4:
#. type: Plain text
-#: build/C/man3/fopen.3:284
+#: build/C/man3/fopen.3:288
msgid ""
"Attempt to access the file using B<mmap>(2), rather than I/O system calls "
-"(B<read>(2), B<write>(2)). Currently, use of B<mmap>(2) is only attempted "
+"(B<read>(2), B<write>(2)). Currently, use of B<mmap>(2) is attempted only "
"for a file opened for reading."
msgstr ""
#. type: TP
-#: build/C/man3/fopen.3:284 build/C/man3/scanf.3:418
+#: build/C/man3/fopen.3:288 build/C/man3/scanf.3:421
#, no-wrap
msgid "B<x>"
msgstr ""
#. Since glibc 2.0?
-#. FIXME document /,ccs= charset/
+#. FIXME C11 specifies this flag
#. type: Plain text
-#: build/C/man3/fopen.3:301
+#: build/C/man3/fopen.3:305
msgid ""
"Open the file exclusively (like the B<O_EXCL> flag of B<open>(2)). If the "
"file already exists, B<fopen>() fails, and sets I<errno> to B<EEXIST>. "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopen.3:307
+#: build/C/man3/fopen.3:313
+msgid ""
+"In addition to the above characters, B<fopen>() and B<freopen>() support "
+"the following syntax in I<mode>:"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/fopen.3:315
+msgid "B< ,ccs=>I<string>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/fopen.3:331
+msgid ""
+"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 I<string>. If the "
+"B<,ccs=>I<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 operation, the stream is marked wide-oriented, and functions "
+"to convert to the coded character set are loaded."
+msgstr ""
+
+#. FIXME http://sourceware.org/bugzilla/show_bug.cgi?id=12685
+#. type: Plain text
+#: build/C/man3/fopen.3:348
+msgid ""
+"When parsing for individual flag characters in I<mode> (i.e., the characters "
+"preceding the \"ccs\" specification), the glibc implementation of B<fopen>() "
+"and B<freopen>() limits the number of characters examined in I<mode> to 7 "
+"(or, in glibc versions before 2.14, to 6, which was not enough to include "
+"possible specifications such as \"rb+cmxe\"). The current implementation of "
+"B<fdopen>() parses at most 5 characters in I<mode>."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/fopen.3:354
msgid "B<open>(2), B<fclose>(3), B<fileno>(3), B<fmemopen>(3), B<fopencookie>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fopencookie.3:24
+#: build/C/man3/fopencookie.3:26
#, no-wrap
msgid "FOPENCOOKIE"
msgstr ""
#. type: TH
-#: build/C/man3/fopencookie.3:24
+#: build/C/man3/fopencookie.3:26
#, no-wrap
-msgid "2008-12-05"
+msgid "2013-03-17"
msgstr ""
#. type: TH
-#: build/C/man3/fopencookie.3:24 build/C/man2/link.2:31 build/C/man2/llseek.2:26 build/C/man2/lseek.2:45 build/C/man3/lseek64.3:23 build/C/man2/open.2:52 build/C/man2/pipe.2:36 build/C/man2/read.2:35 build/C/man2/readlink.2:41 build/C/man2/readv.2:30 build/C/man2/rename.2:32 build/C/man2/rmdir.2:30 build/C/man3/setbuf.3:46 build/C/man3/stdin.3:9 build/C/man2/symlink.2:32 build/C/man7/symlink.7:35 build/C/man2/unlink.2:32 build/C/man2/write.2:39
+#: build/C/man3/fopencookie.3:26 build/C/man2/link.2:31 build/C/man2/llseek.2:28 build/C/man2/lseek.2:47 build/C/man3/lseek64.3:25 build/C/man2/open.2:51 build/C/man2/pipe.2:36 build/C/man2/read.2:35 build/C/man2/readlink.2:43 build/C/man2/readv.2:32 build/C/man2/rename.2:32 build/C/man2/rmdir.2:30 build/C/man3/setbuf.3:48 build/C/man3/stdin.3:13 build/C/man2/symlink.2:32 build/C/man7/symlink.7:36 build/C/man2/unlink.2:32 build/C/man2/write.2:39
#, no-wrap
msgid "Linux"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:27
+#: build/C/man3/fopencookie.3:29
msgid "fopencookie - opening a custom stream"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:34
+#: build/C/man3/fopencookie.3:36
#, no-wrap
msgid ""
"B<FILE *fopencookie(void *>I<cookie>B<, const char *>I<mode>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:47
+#: build/C/man3/fopencookie.3:49
msgid ""
"The B<fopencookie>() function allows the programmer to create a custom "
"implementation for a standard I/O stream. This implementation can store the "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:49
+#: build/C/man3/fopencookie.3:51
msgid "In order to create a custom stream the programmer must:"
msgstr ""
#. type: IP
-#: build/C/man3/fopencookie.3:49 build/C/man3/fopencookie.3:52 build/C/man3/fopencookie.3:63 build/C/man3/scanf.3:669 build/C/man3/scanf.3:674 build/C/man3/scanf.3:680 build/C/man7/symlink.7:248 build/C/man7/symlink.7:258 build/C/man7/symlink.7:288 build/C/man7/symlink.7:348 build/C/man7/symlink.7:377 build/C/man7/symlink.7:406 build/C/man7/symlink.7:437 build/C/man7/symlink.7:450
+#: build/C/man3/fopencookie.3:51 build/C/man3/fopencookie.3:54 build/C/man3/fopencookie.3:65 build/C/man2/open.2:470 build/C/man2/open.2:478 build/C/man2/open.2:484 build/C/man2/open.2:490 build/C/man2/open.2:497 build/C/man2/open.2:503 build/C/man3/scanf.3:633 build/C/man3/scanf.3:638 build/C/man3/scanf.3:644 build/C/man7/symlink.7:249 build/C/man7/symlink.7:259 build/C/man7/symlink.7:289 build/C/man7/symlink.7:349 build/C/man7/symlink.7:378 build/C/man7/symlink.7:407 build/C/man7/symlink.7:438 build/C/man7/symlink.7:451
#, no-wrap
msgid "*"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:52
+#: build/C/man3/fopencookie.3:54
msgid ""
"Implement four \"hook\" functions that are used internally by the standard "
"I/O library when performing I/O on the stream."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:63
+#: build/C/man3/fopencookie.3:65
msgid ""
"Define a \"cookie\" data type, a structure that provides bookkeeping "
"information (e.g., where to store data) used by the aforementioned hook "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:68
+#: build/C/man3/fopencookie.3:70
msgid ""
"Call B<fopencookie>() to open a new stream and associate the cookie and "
"hook functions with that stream."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:76
+#: build/C/man3/fopencookie.3:78
msgid ""
"The B<fopencookie>() function serves a purpose similar to B<fopen>(3): it "
"opens a new stream and returns a pointer to a I<FILE> object that is used to "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:83
+#: build/C/man3/fopencookie.3:85
msgid ""
"The I<cookie> argument is a pointer to the caller's cookie structure that is "
"to be associated with the new stream. This pointer is supplied as the first "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:99
+#: build/C/man3/fopencookie.3:101
msgid ""
"The I<mode> argument serves the same purpose as for B<fopen>(3). The "
"following modes are supported: I<r>, I<w>, I<a>, I<r+>, I<w+>, and I<a+>. "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:105
+#: build/C/man3/fopencookie.3:107
msgid ""
"The I<io_funcs> argument is a structure that contains four fields pointing "
"to the programmer-defined hook functions that are used to implement this "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:114
+#: build/C/man3/fopencookie.3:116
#, no-wrap
msgid ""
-"struct cookie_io_functions_t {\n"
+"typedef struct {\n"
" cookie_read_function_t *read;\n"
" cookie_write_function_t *write;\n"
" cookie_seek_function_t *seek;\n"
" cookie_close_function_t *close;\n"
-"};\n"
+"} cookie_io_functions_t;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:118
+#: build/C/man3/fopencookie.3:120
msgid "The four fields are as follows:"
msgstr ""
#. type: TP
-#: build/C/man3/fopencookie.3:118
+#: build/C/man3/fopencookie.3:120
#, no-wrap
msgid "I<cookie_read_function_t *read>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:122
+#: build/C/man3/fopencookie.3:124
msgid ""
"This function implements read operations for the stream. When called, it "
"receives three arguments:"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:124
+#: build/C/man3/fopencookie.3:126
#, no-wrap
msgid " ssize_t read(void *cookie, char *buf, size_t size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:139
+#: build/C/man3/fopencookie.3:141
msgid ""
"The I<buf> and I<size> arguments are, respectively, a buffer into which "
"input data can be placed and the size of that buffer. As its function "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:144
+#: build/C/man3/fopencookie.3:146
msgid ""
"If I<*read> is a NULL pointer, then reads from the custom stream always "
"return end of file."
msgstr ""
#. type: TP
-#: build/C/man3/fopencookie.3:144
+#: build/C/man3/fopencookie.3:146
#, no-wrap
msgid "I<cookie_write_function_t *write>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:148
+#: build/C/man3/fopencookie.3:150
msgid ""
"This function implements write operations for the stream. When called, it "
"receives three arguments:"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:150
+#: build/C/man3/fopencookie.3:152
#, no-wrap
msgid " ssize_t write(void *cookie, const char *buf, size_t size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:165
+#: build/C/man3/fopencookie.3:168
msgid ""
"The I<buf> and I<size> arguments are, respectively, a buffer of data to be "
"output to the stream and the size of that buffer. As its function result, "
"the I<write> function should return the number of bytes copied from I<buf>, "
-"or -1 on error. The I<write> function should update the stream offset "
-"appropriately."
+"or 0 on error. (The function must not return a negative value.) The "
+"I<write> function should update the stream offset appropriately."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:170
+#: build/C/man3/fopencookie.3:173
msgid "If I<*write> is a NULL pointer, then output to the stream is discarded."
msgstr ""
#. type: TP
-#: build/C/man3/fopencookie.3:170
+#: build/C/man3/fopencookie.3:173
#, no-wrap
msgid "I<cookie_seek_function_t *seek>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:174
+#: build/C/man3/fopencookie.3:177
msgid ""
"This function implements seek operations on the stream. When called, it "
"receives three arguments:"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:176
+#: build/C/man3/fopencookie.3:179
#, no-wrap
msgid " int seek(void *cookie, off64_t *offset, int whence);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:182
+#: build/C/man3/fopencookie.3:185
msgid ""
"The I<*offset> argument specifies the new file offset depending on which of "
"the following three values is supplied in I<whence>:"
msgstr ""
#. type: TP
-#: build/C/man3/fopencookie.3:183 build/C/man2/lseek.2:65
+#: build/C/man3/fopencookie.3:186 build/C/man2/lseek.2:67
#, no-wrap
msgid "B<SEEK_SET>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:188
+#: build/C/man3/fopencookie.3:191
msgid ""
"The stream offset should be set I<*offset> bytes from the start of the "
"stream."
msgstr ""
#. type: TP
-#: build/C/man3/fopencookie.3:188 build/C/man2/lseek.2:70
+#: build/C/man3/fopencookie.3:191 build/C/man2/lseek.2:72
#, no-wrap
msgid "B<SEEK_CUR>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:192
+#: build/C/man3/fopencookie.3:195
msgid "I<*offset> should be added to the current stream offset."
msgstr ""
#. type: TP
-#: build/C/man3/fopencookie.3:192 build/C/man2/lseek.2:75
+#: build/C/man3/fopencookie.3:195 build/C/man2/lseek.2:77
#, no-wrap
msgid "B<SEEK_END>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:196
+#: build/C/man3/fopencookie.3:199
msgid "The stream offset should be set to the size of the stream plus I<*offset>."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:203
+#: build/C/man3/fopencookie.3:206
msgid ""
"Before returning, the I<seek> function should update I<*offset> to indicate "
"the new stream offset."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:207
+#: build/C/man3/fopencookie.3:210
msgid ""
"As its function result, the I<seek> function should return 0 on success, and "
"-1 on error."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:212
+#: build/C/man3/fopencookie.3:215
msgid ""
"If I<*seek> is a NULL pointer, then it is not possible to perform seek "
"operations on the stream."
msgstr ""
#. type: TP
-#: build/C/man3/fopencookie.3:212
+#: build/C/man3/fopencookie.3:215
#, no-wrap
msgid "I<cookie_close_function_t *close>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:218
+#: build/C/man3/fopencookie.3:221
msgid ""
"This function closes the stream. The hook function can do things such as "
"freeing buffers allocated for the stream. When called, it receives one "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:220
+#: build/C/man3/fopencookie.3:223
#, no-wrap
msgid " int close(void *cookie);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:225
+#: build/C/man3/fopencookie.3:228
msgid ""
"The I<cookie> argument is the cookie that the programmer supplied when "
"calling B<fopencookie>()."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:231
+#: build/C/man3/fopencookie.3:234
msgid ""
"As its function result, the I<close> function should return 0 on success, "
"and B<EOF> on error."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:235
+#: build/C/man3/fopencookie.3:238
msgid ""
"If I<*close> is NULL, then no special action is performed when the stream is "
"closed."
#. .SH ERRORS
#. It's not clear if errno ever gets set...
#. type: Plain text
-#: build/C/man3/fopencookie.3:242
+#: build/C/man3/fopencookie.3:245
msgid ""
"On success B<fopencookie>() returns a pointer to the new stream. On error, "
"NULL is returned."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:244
+#: build/C/man3/fopencookie.3:247
msgid "This function is a nonstandard GNU extension."
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:253
+#: build/C/man3/fopencookie.3:256
msgid ""
"The program below implements a custom stream whose functionality is similar "
"(but not identical) to that available via B<fmemopen>(3). It implements a "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:261
+#: build/C/man3/fopencookie.3:264
#, no-wrap
msgid ""
"$B< ./a.out \\(aqhello world\\(aq>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:268
+#: build/C/man3/fopencookie.3:271
msgid ""
"Note that a more general version of the program below could be improved to "
"more robustly handle various error situations (e.g., opening a stream with a "
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:277
+#: build/C/man3/fopencookie.3:280
#, no-wrap
msgid ""
"#define _GNU_SOURCE\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:279
+#: build/C/man3/fopencookie.3:282
#, no-wrap
msgid "#define INIT_BUF_SIZE 4\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:286
+#: build/C/man3/fopencookie.3:289
#, no-wrap
msgid ""
"struct memfile_cookie {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:292
+#: build/C/man3/fopencookie.3:295
#, no-wrap
msgid ""
"ssize_t\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:294
+#: build/C/man3/fopencookie.3:297
#, no-wrap
msgid " /* Buffer too small? Keep doubling size until big enough */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:304
+#: build/C/man3/fopencookie.3:307
#, no-wrap
msgid ""
" while (size + cookie-E<gt>offset E<gt> cookie-E<gt>allocated) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:306
+#: build/C/man3/fopencookie.3:309
#, no-wrap
msgid " memcpy(cookie-E<gt>buf + cookie-E<gt>offset, buf, size);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:310
+#: build/C/man3/fopencookie.3:313
#, no-wrap
msgid ""
" cookie-E<gt>offset += size;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:313
+#: build/C/man3/fopencookie.3:316
#, no-wrap
msgid ""
" return size;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:319
+#: build/C/man3/fopencookie.3:322
#, no-wrap
msgid ""
"ssize_t\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:321
+#: build/C/man3/fopencookie.3:324
#, no-wrap
msgid " /* Fetch minimum of bytes requested and bytes available */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:327
+#: build/C/man3/fopencookie.3:330
#, no-wrap
msgid ""
" xbytes = size;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:329
+#: build/C/man3/fopencookie.3:332
#, no-wrap
msgid " memcpy(buf, cookie-E<gt>buf + cookie-E<gt>offset, xbytes);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:333
+#: build/C/man3/fopencookie.3:336
#, no-wrap
msgid ""
" cookie-E<gt>offset += xbytes;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:339
+#: build/C/man3/fopencookie.3:342
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:348
+#: build/C/man3/fopencookie.3:351
#, no-wrap
msgid ""
" if (whence == SEEK_SET)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:351
+#: build/C/man3/fopencookie.3:354
#, no-wrap
msgid ""
" if (new_offset E<lt> 0)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:356
+#: build/C/man3/fopencookie.3:359
#, no-wrap
msgid ""
" cookie-E<gt>offset = new_offset;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:361
+#: build/C/man3/fopencookie.3:364
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:365
+#: build/C/man3/fopencookie.3:368
#, no-wrap
msgid ""
" free(cookie-E<gt>buf);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:368
+#: build/C/man3/fopencookie.3:371
#, no-wrap
msgid ""
" return 0;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:384
+#: build/C/man3/fopencookie.3:387
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:386
+#: build/C/man3/fopencookie.3:389
#, no-wrap
msgid " /* Set up the cookie before calling fopencookie() */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:392
+#: build/C/man3/fopencookie.3:395
#, no-wrap
msgid ""
" mycookie.buf = malloc(INIT_BUF_SIZE);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:396
+#: build/C/man3/fopencookie.3:399
#, no-wrap
msgid ""
" mycookie.allocated = INIT_BUF_SIZE;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:402
+#: build/C/man3/fopencookie.3:405
#, no-wrap
msgid ""
" fp = fopencookie(&mycookie,\"w+\", memfile_func);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:404
+#: build/C/man3/fopencookie.3:407
#, no-wrap
msgid " /* Write command-line arguments to our file */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:410
+#: build/C/man3/fopencookie.3:413
#, no-wrap
msgid ""
" for (j = 1; j E<lt> argc; j++)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:412
+#: build/C/man3/fopencookie.3:415
#, no-wrap
msgid " /* Read two bytes out of every five, until EOF */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:427
+#: build/C/man3/fopencookie.3:430
#, no-wrap
msgid ""
" for (p = 0; ; p += 5) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:430
+#: build/C/man3/fopencookie.3:433
#, no-wrap
msgid ""
" printf(\"/%.*s/\\en\", nread, buf);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:433 build/C/man2/readlink.2:211
+#: build/C/man3/fopencookie.3:436 build/C/man2/readlink.2:213
#, no-wrap
msgid ""
" exit(EXIT_SUCCESS);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fopencookie.3:439
+#: build/C/man3/fopencookie.3:442
msgid "B<fclose>(3), B<fmemopen>(3), B<fopen>(3), B<fseek>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fpurge.3:23
+#: build/C/man3/fpurge.3:25
#, no-wrap
msgid "FPURGE"
msgstr ""
#. type: TH
-#: build/C/man3/fpurge.3:23
+#: build/C/man3/fpurge.3:25
#, no-wrap
msgid "2001-12-15"
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:26
+#: build/C/man3/fpurge.3:28
msgid "fpurge, __fpurge - purge a stream"
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:30
+#: build/C/man3/fpurge.3:32
#, no-wrap
msgid ""
"/* unsupported */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:32
+#: build/C/man3/fpurge.3:34
#, no-wrap
msgid "B<int fpurge(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:35
+#: build/C/man3/fpurge.3:37
#, no-wrap
msgid ""
"/* supported */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:37
+#: build/C/man3/fpurge.3:39
#, no-wrap
msgid "B<#include E<lt>stdio_ext.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:39
+#: build/C/man3/fpurge.3:41
#, no-wrap
msgid "B<void __fpurge(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:52
+#: build/C/man3/fpurge.3:54
msgid ""
"The function B<fpurge>() clears the buffers of the given stream. For "
"output streams this discards any unwritten output. For input streams this "
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:56
+#: build/C/man3/fpurge.3:58
msgid ""
"The function B<__fpurge>() does precisely the same, but without returning a "
"value."
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:63
+#: build/C/man3/fpurge.3:65
msgid ""
"Upon successful completion B<fpurge>() returns 0. On error, it returns -1 "
"and sets I<errno> appropriately."
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:68
+#: build/C/man3/fpurge.3:70
msgid "I<stream> is not an open stream."
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:76
+#: build/C/man3/fpurge.3:78
msgid ""
"These functions are nonstandard and not portable. The function B<fpurge>() "
"was introduced in 4.4BSD and is not available under Linux. The function "
msgstr ""
#. type: Plain text
-#: build/C/man3/fpurge.3:78
+#: build/C/man3/fpurge.3:80
msgid "Usually it is a mistake to want to discard input buffers."
msgstr ""
#. .BR fclean (3),
#. type: Plain text
-#: build/C/man3/fpurge.3:83
+#: build/C/man3/fpurge.3:85
msgid "B<fflush>(3), B<setbuf>(3), B<stdio_ext>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fputwc.3:14
+#: build/C/man3/fputwc.3:16
#, no-wrap
msgid "FPUTWC"
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:17
+#: build/C/man3/fputwc.3:19
msgid "fputwc, putwc - write a wide character to a FILE stream"
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:25
+#: build/C/man3/fputwc.3:27
#, no-wrap
msgid ""
"B<wint_t fputwc(wchar_t >I<wc>B<, FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:41
+#: build/C/man3/fputwc.3:43
msgid ""
"The B<fputwc>() function is the wide-character equivalent of the "
"B<fputc>(3) function. It writes the wide character I<wc> to I<stream>. If "
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:49
+#: build/C/man3/fputwc.3:51
msgid ""
"The B<putwc>() function or macro functions identically to B<fputwc>(). It "
"may be implemented as a macro, and may evaluate its argument more than "
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:58
+#: build/C/man3/fputwc.3:63
msgid ""
"The B<fputwc>() function returns I<wc> if no error occurred, or B<WEOF> to "
-"indicate an error."
+"indicate an error. In the event of an error, I<errno> is set to indicate "
+"the cause."
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:63
+#: build/C/man3/fputwc.3:68
msgid "Conversion of I<wc> to the stream's encoding fails."
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:72
+#: build/C/man3/fputwc.3:77
msgid ""
"The behavior of B<fputwc>() depends on the B<LC_CTYPE> category of the "
"current locale."
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:80
+#: build/C/man3/fputwc.3:85
msgid ""
"In the absence of additional information passed to the B<fopen>(3) call, it "
"is reasonable to expect that B<fputwc>() will actually write the multibyte "
msgstr ""
#. type: Plain text
-#: build/C/man3/fputwc.3:84
+#: build/C/man3/fputwc.3:89
msgid "B<fgetwc>(3), B<fputws>(3), B<unlocked_stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fread.3:43
+#: build/C/man3/fread.3:45
#, no-wrap
msgid "FREAD"
msgstr ""
#. type: TH
-#: build/C/man3/fread.3:43
+#: build/C/man3/fread.3:45
#, no-wrap
-msgid "1996-05-17"
+msgid "2012-03-30"
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:46
+#: build/C/man3/fread.3:48
msgid "fread, fwrite - binary stream input/output"
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:52
+#: build/C/man3/fread.3:54
#, no-wrap
msgid ""
"B<size_t fread(void *>I<ptr>B<, size_t >I<size>B<, size_t >I<nmemb>B<, FILE "
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:55
+#: build/C/man3/fread.3:57
#, no-wrap
msgid ""
"B<size_t fwrite(const void *>I<ptr>B<, size_t >I<size>B<, size_t "
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:67
+#: build/C/man3/fread.3:69
msgid ""
"The function B<fread>() reads I<nmemb> elements of data, each I<size> bytes "
"long, from the stream pointed to by I<stream>, storing them at the location "
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:78
+#: build/C/man3/fread.3:80
msgid ""
"The function B<fwrite>() writes I<nmemb> elements of data, each I<size> "
"bytes long, to the stream pointed to by I<stream>, obtaining them from the "
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:89
+#: build/C/man3/fread.3:96
msgid ""
-"B<fread>() and B<fwrite>() return the number of items successfully read or "
-"written (i.e., not the number of characters). If an error occurs, or the "
-"end-of-file is reached, the return value is a short item count (or zero)."
+"On success, B<fread>() and B<fwrite>() return the number of I<items> read "
+"or written. This number equals the number of bytes transferred only when "
+"I<size> is 1. If an error occurs, or the end of the file is reached, the "
+"return value is a short item count (or zero)."
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:96
+#: build/C/man3/fread.3:103
msgid ""
"B<fread>() does not distinguish between end-of-file and error, and callers "
"must use B<feof>(3) and B<ferror>(3) to determine which occurred."
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:98
+#: build/C/man3/fread.3:105
msgid "C89, POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man3/fread.3:104
+#: build/C/man3/fread.3:111
msgid "B<read>(2), B<write>(2), B<feof>(3), B<ferror>(3), B<unlocked_stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fseek.3:40
+#: build/C/man3/fseek.3:42
#, no-wrap
msgid "FSEEK"
msgstr ""
#. type: TH
-#: build/C/man3/fseek.3:40
+#: build/C/man3/fseek.3:42
#, no-wrap
msgid "1993-11-29"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:43
+#: build/C/man3/fseek.3:45
msgid "fgetpos, fseek, fsetpos, ftell, rewind - reposition a stream"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:47
+#: build/C/man3/fseek.3:49
msgid "B<int fseek(FILE *>I<stream>B<, long >I<offset>B<, int >I<whence>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:49
+#: build/C/man3/fseek.3:51
msgid "B<long ftell(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:51
+#: build/C/man3/fseek.3:53
msgid "B<void rewind(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:53
+#: build/C/man3/fseek.3:55
msgid "B<int fgetpos(FILE *>I<stream>B<, fpos_t *>I<pos>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:55
+#: build/C/man3/fseek.3:57
msgid "B<int fsetpos(FILE *>I<stream>B<, fpos_t *>I<pos>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:79
+#: build/C/man3/fseek.3:81
msgid ""
"The B<fseek>() function sets the file position indicator for the stream "
"pointed to by I<stream>. The new position, measured in bytes, is obtained "
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:85
+#: build/C/man3/fseek.3:87
msgid ""
"The B<ftell>() function obtains the current value of the file position "
"indicator for the stream pointed to by I<stream>."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:92
+#: build/C/man3/fseek.3:94
msgid ""
"The B<rewind>() function sets the file position indicator for the stream "
"pointed to by I<stream> to the beginning of the file. It is equivalent to:"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:95
+#: build/C/man3/fseek.3:97
msgid "(void) fseek(stream, 0L, SEEK_SET)"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:99
+#: build/C/man3/fseek.3:101
msgid ""
"except that the error indicator for the stream is also cleared (see "
"B<clearerr>(3))."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:117
+#: build/C/man3/fseek.3:121
msgid ""
"The B<fgetpos>() and B<fsetpos>() functions are alternate interfaces "
-"equivalent to B<ftell>() and B<fseek>() (with whence set to B<SEEK_SET>), "
-"setting and storing the current value of the file offset into or from the "
-"object referenced by I<pos>. On some non-UNIX systems an I<fpos_t> object "
-"may be a complex object and these routines may be the only way to portably "
-"reposition a text stream."
+"equivalent to B<ftell>() and B<fseek>() (with I<whence> set to "
+"B<SEEK_SET>), setting and storing the current value of the file offset into "
+"or from the object referenced by I<pos>. On some non-UNIX systems, an "
+"I<fpos_t> object may be a complex object and these routines may be the only "
+"way to portably reposition a text stream."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:132
+#: build/C/man3/fseek.3:136
msgid ""
"The B<rewind>() function returns no value. Upon successful completion, "
"B<fgetpos>(), B<fseek>(), B<fsetpos>() return 0, and B<ftell>() returns "
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:138
+#: build/C/man3/fseek.3:142
msgid "The I<stream> specified is not a seekable stream."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:149
+#: build/C/man3/fseek.3:153
msgid ""
"The I<whence> argument to B<fseek>() was not B<SEEK_SET>, B<SEEK_END>, or "
"B<SEEK_CUR>."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:164
+#: build/C/man3/fseek.3:168
msgid ""
"The functions B<fgetpos>(), B<fseek>(), B<fsetpos>(), and B<ftell>() may "
"also fail and set I<errno> for any of the errors specified for the routines "
msgstr ""
#. type: Plain text
-#: build/C/man3/fseek.3:169
+#: build/C/man3/fseek.3:173
msgid "B<lseek>(2), B<fseeko>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/fseeko.3:23
+#: build/C/man3/fseeko.3:25
#, no-wrap
msgid "FSEEKO"
msgstr ""
#. type: TH
-#: build/C/man3/fseeko.3:23
+#: build/C/man3/fseeko.3:25
#, no-wrap
msgid "2001-11-05"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:26
+#: build/C/man3/fseeko.3:28
msgid "fseeko, ftello - seek to or report file position"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:31
+#: build/C/man3/fseeko.3:33
#, no-wrap
msgid "B<int fseeko(FILE *>I<stream>B<, off_t >I<offset>B<, int >I<whence>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:34
+#: build/C/man3/fseeko.3:36
#, no-wrap
msgid ""
"B<off_t ftello(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:52
+#: build/C/man3/fseeko.3:58
msgid ""
"The B<fseeko>() and B<ftello>() functions are identical to B<fseek>(3) "
"and B<ftell>(3) (see B<fseek>(3)), respectively, except that the I<offset> "
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:55
+#: build/C/man3/fseeko.3:65
msgid ""
"On many architectures both I<off_t> and I<long> are 32-bit types, but "
"compilation with"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:59 build/C/man3/lseek64.3:79
+#: build/C/man3/fseeko.3:69 build/C/man3/lseek64.3:81
#, no-wrap
msgid "#define _FILE_OFFSET_BITS 64\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:63
+#: build/C/man3/fseeko.3:75
msgid "will turn I<off_t> into a 64-bit type."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:72
+#: build/C/man3/fseeko.3:84
msgid ""
"On successful completion, B<fseeko>() returns 0, while B<ftello>() returns "
"the current offset. Otherwise, -1 is returned and I<errno> is set to "
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:75
+#: build/C/man3/fseeko.3:87
msgid "See the ERRORS in B<fseek>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:77
+#: build/C/man3/fseeko.3:89
msgid "SUSv2, POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:81
+#: build/C/man3/fseeko.3:93
msgid ""
"These functions are found on System V-like systems. They are not present in "
"libc4, libc5, glibc 2.0 but are available since glibc 2.1."
msgstr ""
#. type: Plain text
-#: build/C/man3/fseeko.3:83
+#: build/C/man3/fseeko.3:95
msgid "B<fseek>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/getline.3:24
+#: build/C/man3/getline.3:26
#, no-wrap
msgid "GETLINE"
msgstr ""
-#. type: TH
-#: build/C/man3/getline.3:24
-#, no-wrap
-msgid "2010-06-12"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/getline.3:27
+#: build/C/man3/getline.3:29
msgid "getline, getdelim - delimited string input"
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:32
+#: build/C/man3/getline.3:34
#, no-wrap
msgid ""
"B<ssize_t getline(char **>I<lineptr>B<, size_t *>I<n>B<, FILE "
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:35
+#: build/C/man3/getline.3:37
#, no-wrap
msgid ""
"B<ssize_t getdelim(char **>I<lineptr>B<, size_t *>I<n>B<, int >I<delim>B<, "
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:45
+#: build/C/man3/getline.3:47
msgid "B<getline>(), B<getdelim>():"
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:50
+#: build/C/man3/getline.3:52
msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 200809L || _XOPEN_SOURCE\\ E<gt>=\\ 700"
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:63
+#: build/C/man3/getline.3:65
msgid ""
"B<getline>() reads an entire line from I<stream>, storing the address of "
"the buffer containing the text into I<*lineptr>. The buffer is "
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:73
+#: build/C/man3/getline.3:75
msgid ""
"If I<*lineptr> is NULL, then B<getline>() will allocate a buffer for "
"storing the line, which should be freed by the user program. (In this case, "
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:91
+#: build/C/man3/getline.3:93
msgid ""
"Alternatively, before calling B<getline>(), I<*lineptr> can contain a "
"pointer to a B<malloc>(3)-allocated buffer I<*n> bytes in size. If the "
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:97
+#: build/C/man3/getline.3:99
msgid ""
"In either case, on a successful call, I<*lineptr> and I<*n> will be updated "
"to reflect the buffer address and allocated size respectively."
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:108
+#: build/C/man3/getline.3:110
msgid ""
"B<getdelim>() works like B<getline>(), except that a line delimiter other "
"than newline can be specified as the I<delimiter> argument. As with "
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:117
+#: build/C/man3/getline.3:119
msgid ""
"On success, B<getline>() and B<getdelim>() return the number of characters "
"read, including the delimiter character, but not including the terminating "
-"null byte. This value can be used to handle embedded null bytes in the line "
-"read."
+"null byte (\\(aq\\e0\\(aq). This value can be used to handle embedded null "
+"bytes in the line read."
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:120
+#: build/C/man3/getline.3:125
msgid ""
"Both functions return -1 on failure to read a line (including end-of-file "
-"condition)."
+"condition). In the event of an error, I<errno> is set to indicate the "
+"cause."
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:130
+#: build/C/man3/getline.3:135
msgid "Bad arguments (I<n> or I<lineptr> is NULL, or I<stream> is not valid)."
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:132
+#: build/C/man3/getline.3:137
msgid "These functions are available since libc 4.6.27."
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:139
+#: build/C/man3/getline.3:144
msgid ""
"Both B<getline>() and B<getdelim>() were originally GNU extensions. They "
"were standardized in POSIX.1-2008."
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:144
+#: build/C/man3/getline.3:149
#, no-wrap
msgid ""
"#define _GNU_SOURCE\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:152
+#: build/C/man3/getline.3:157
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:156
+#: build/C/man3/getline.3:161
#, no-wrap
msgid ""
" fp = fopen(\"/etc/motd\", \"r\");\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:161
+#: build/C/man3/getline.3:166
#, no-wrap
msgid ""
" while ((read = getline(&line, &len, fp)) != -1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:165
+#: build/C/man3/getline.3:170
#, no-wrap
msgid ""
" free(line);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/getline.3:173
+#: build/C/man3/getline.3:178
msgid "B<read>(2), B<fgets>(3), B<fopen>(3), B<fread>(3), B<gets>(3), B<scanf>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/gets.3:25
+#: build/C/man3/gets.3:27
#, no-wrap
msgid "GETS"
msgstr ""
#. type: TH
-#: build/C/man3/gets.3:25 build/C/man3/printf.3:34 build/C/man3/puts.3:24 build/C/man3/scanf.3:50
+#: build/C/man3/gets.3:27
#, no-wrap
-msgid "2011-09-28"
+msgid "2012-01-18"
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:28
+#: build/C/man3/gets.3:30
msgid "fgetc, fgets, getc, getchar, gets, ungetc - input of characters and strings"
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:33
+#: build/C/man3/gets.3:35
#, no-wrap
msgid "B<int fgetc(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:35
+#: build/C/man3/gets.3:37
#, no-wrap
msgid "B<char *fgets(char *>I<s>B<, int >I<size>B<, FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:37
+#: build/C/man3/gets.3:39
#, no-wrap
msgid "B<int getc(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:39
+#: build/C/man3/gets.3:41
#, no-wrap
msgid "B<int getchar(void);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:41
+#: build/C/man3/gets.3:43
#, no-wrap
msgid "B<char *gets(char *>I<s>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:43
+#: build/C/man3/gets.3:45
#, no-wrap
msgid "B<int ungetc(int >I<c>B<, FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:55
+#: build/C/man3/gets.3:57
msgid ""
"B<fgetc>() reads the next character from I<stream> and returns it as an "
"I<unsigned char> cast to an I<int>, or B<EOF> on end of file or error."
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:62
+#: build/C/man3/gets.3:64
msgid ""
"B<getc>() is equivalent to B<fgetc>() except that it may be implemented as "
"a macro which evaluates I<stream> more than once."
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:66
+#: build/C/man3/gets.3:68
msgid "B<getchar>() is equivalent to B<getc(>I<stdin>B<)>."
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:76
+#: build/C/man3/gets.3:78
msgid ""
"B<gets>() reads a line from I<stdin> into the buffer pointed to by I<s> "
"until either a terminating newline or B<EOF>, which it replaces with a null "
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:90
+#: build/C/man3/gets.3:92
msgid ""
"B<fgets>() reads in at most one less than I<size> characters from I<stream> "
"and stores them into the buffer pointed to by I<s>. Reading stops after an "
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:101
+#: build/C/man3/gets.3:103
msgid ""
"B<ungetc>() pushes I<c> back to I<stream>, cast to I<unsigned char>, where "
"it is available for subsequent read operations. Pushed-back characters will "
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:106
+#: build/C/man3/gets.3:108
msgid ""
"Calls to the functions described here can be mixed with each other and with "
"calls to other input functions from the I<stdio> library for the same input "
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:121
+#: build/C/man3/gets.3:123
msgid ""
"B<fgetc>(), B<getc>() and B<getchar>() return the character read as an "
"I<unsigned char> cast to an I<int> or B<EOF> on end of file or error."
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:129
+#: build/C/man3/gets.3:131
msgid ""
"B<gets>() and B<fgets>() return I<s> on success, and NULL on error or when "
"end of file occurs while no characters have been read."
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:136
+#: build/C/man3/gets.3:138
msgid "B<ungetc>() returns I<c> on success, or B<EOF> on error."
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:143
+#: build/C/man3/gets.3:140
+msgid "C89, C99, POSIX.1-2001."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/gets.3:152
msgid ""
-"C89, C99, POSIX.1-2001. LSB deprecates B<gets>(). POSIX.1-2008 marks "
-"B<gets>() obsolescent."
+"LSB deprecates B<gets>(). POSIX.1-2008 marks B<gets>() obsolescent. ISO "
+"C11 removes the specification of B<gets>() from the C language, and since "
+"version 2.16, glibc header files don't expose the function declaration if "
+"the B<_ISOC11_SOURCE> feature test macro is defined."
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:157
+#: build/C/man3/gets.3:166
msgid ""
"Never use B<gets>(). Because it is impossible to tell without knowing the "
"data in advance how many characters B<gets>() will read, and because "
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:164
+#: build/C/man3/gets.3:173
msgid ""
"It is not advisable to mix calls to input functions from the I<stdio> "
"library with low-level calls to B<read>(2) for the file descriptor "
msgstr ""
#. type: Plain text
-#: build/C/man3/gets.3:179
+#: build/C/man3/gets.3:189
msgid ""
"B<read>(2), B<write>(2), B<ferror>(3), B<fgetwc>(3), B<fgetws>(3), "
"B<fopen>(3), B<fread>(3), B<fseek>(3), B<getline>(3), B<getwchar>(3), "
-"B<puts>(3), B<scanf>(3), B<ungetwc>(3), B<unlocked_stdio>(3)"
+"B<puts>(3), B<scanf>(3), B<ungetwc>(3), B<unlocked_stdio>(3), "
+"B<feature_test_macros>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/getw.3:23
+#: build/C/man3/getw.3:25
#, no-wrap
msgid "GETW"
msgstr ""
#. type: TH
-#: build/C/man3/getw.3:23
+#: build/C/man3/getw.3:25
#, no-wrap
msgid "2010-09-26"
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:26
+#: build/C/man3/getw.3:28
msgid "getw, putw - input and output of words (ints)"
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:31
+#: build/C/man3/getw.3:33
#, no-wrap
msgid "B<int getw(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:33
+#: build/C/man3/getw.3:35
#, no-wrap
msgid "B<int putw(int >I<w>B<, FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:42
+#: build/C/man3/getw.3:44
msgid "B<getw>(), B<putw>():"
msgstr ""
#. type: TP
-#: build/C/man3/getw.3:45
+#: build/C/man3/getw.3:47
#, no-wrap
msgid "Since glibc 2.3.3:"
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:48
+#: build/C/man3/getw.3:50
msgid "_SVID_SOURCE || _BSD_SOURCE ||"
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:51
+#: build/C/man3/getw.3:53
#, no-wrap
msgid ""
"(_XOPEN_SOURCE &&\n"
msgstr ""
#. type: TP
-#: build/C/man3/getw.3:51
+#: build/C/man3/getw.3:53
#, no-wrap
msgid "Before glibc 2.3.3:"
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:54
+#: build/C/man3/getw.3:56
msgid "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:64
+#: build/C/man3/getw.3:66
msgid ""
"B<getw>() reads a word (that is, an I<int>) from I<stream>. It's provided "
"for compatibility with SVr4. We recommend you use B<fread>(3) instead."
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:71
+#: build/C/man3/getw.3:73
msgid ""
"B<putw>() writes the word I<w> (that is, an I<int>) to I<stream>. It is "
"provided for compatibility with SVr4, but we recommend you use B<fwrite>(3) "
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:78
+#: build/C/man3/getw.3:80
msgid ""
"Normally, B<getw>() returns the word read, and B<putw>() returns 0. On "
"error, they return B<EOF>."
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:80
+#: build/C/man3/getw.3:82
msgid "SVr4, SUSv2. Not present in POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:84
+#: build/C/man3/getw.3:86
msgid ""
"The value returned on error is also a legitimate data value. B<ferror>(3) "
"can be used to distinguish between the two cases."
msgstr ""
#. type: Plain text
-#: build/C/man3/getw.3:90
+#: build/C/man3/getw.3:92
msgid "B<ferror>(3), B<fread>(3), B<fwrite>(3), B<getc>(3), B<putc>(3)"
msgstr ""
msgstr ""
#. type: TH
-#: build/C/man2/link.2:31
+#: build/C/man2/link.2:31 build/C/man2/rename.2:32 build/C/man2/symlink.2:32 build/C/man2/write.2:39
#, no-wrap
-msgid "2008-08-21"
+msgid "2013-01-27"
msgstr ""
#. type: Plain text
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:36 build/C/man2/lseek.2:52 build/C/man3/lseek64.3:32 build/C/man2/readlink.2:46 build/C/man2/rmdir.2:35 build/C/man2/symlink.2:37 build/C/man2/unlink.2:37 build/C/man2/write.2:44
+#: build/C/man2/link.2:36 build/C/man2/lseek.2:54 build/C/man3/lseek64.3:34 build/C/man2/readlink.2:48 build/C/man2/rmdir.2:35 build/C/man2/symlink.2:37 build/C/man2/unlink.2:37 build/C/man2/write.2:44
msgid "B<#include E<lt>unistd.hE<gt>>"
msgstr ""
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:57 build/C/man2/pipe.2:96 build/C/man3/remove.3:65 build/C/man2/rename.2:96 build/C/man2/rmdir.2:45 build/C/man2/symlink.2:89 build/C/man2/unlink.2:60
+#: build/C/man2/link.2:57 build/C/man2/pipe.2:97 build/C/man3/remove.3:65 build/C/man2/rename.2:96 build/C/man2/rmdir.2:45 build/C/man2/symlink.2:89 build/C/man2/unlink.2:60
msgid ""
"On success, zero is returned. On error, -1 is returned, and I<errno> is set "
"appropriately."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:58 build/C/man2/open.2:475 build/C/man2/readlink.2:84 build/C/man2/rename.2:97 build/C/man2/rmdir.2:46 build/C/man2/symlink.2:90 build/C/man3/tmpfile.3:53 build/C/man2/unlink.2:61
+#: build/C/man2/link.2:58 build/C/man2/open.2:577 build/C/man2/readlink.2:86 build/C/man2/rename.2:97 build/C/man2/rmdir.2:46 build/C/man2/symlink.2:90 build/C/man3/tmpfile.3:57 build/C/man2/unlink.2:61
#, no-wrap
msgid "B<EACCES>"
msgstr ""
msgstr ""
#. type: TP
-#: build/C/man2/link.2:69 build/C/man2/open.2:484 build/C/man2/symlink.2:99 build/C/man3/tmpfile.3:56
+#: build/C/man2/link.2:69 build/C/man2/open.2:586 build/C/man2/rename.2:133 build/C/man2/symlink.2:99 build/C/man2/write.2:135
+#, no-wrap
+msgid "B<EDQUOT>"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/link.2:72 build/C/man2/rename.2:136
+msgid "The user's quota of disk blocks on the filesystem has been exhausted."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/link.2:72 build/C/man2/open.2:592 build/C/man2/symlink.2:104 build/C/man3/tmpfile.3:60
#, no-wrap
msgid "B<EEXIST>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:73 build/C/man2/symlink.2:103
+#: build/C/man2/link.2:76 build/C/man2/symlink.2:108
msgid "I<newpath> already exists."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:73 build/C/man2/llseek.2:69 build/C/man2/open.2:490 build/C/man2/pipe.2:97 build/C/man2/read.2:100 build/C/man2/readlink.2:89 build/C/man2/rename.2:133 build/C/man2/rmdir.2:64 build/C/man2/symlink.2:103 build/C/man2/unlink.2:80 build/C/man2/write.2:135
+#: build/C/man2/link.2:76 build/C/man2/llseek.2:74 build/C/man2/open.2:598 build/C/man2/pipe.2:98 build/C/man2/read.2:118 build/C/man2/readlink.2:91 build/C/man2/rename.2:136 build/C/man2/rmdir.2:64 build/C/man2/symlink.2:108 build/C/man2/unlink.2:80 build/C/man2/write.2:141
#, no-wrap
msgid "B<EFAULT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:76 build/C/man2/rename.2:136 build/C/man2/symlink.2:106
+#: build/C/man2/link.2:79 build/C/man2/rename.2:139 build/C/man2/symlink.2:111
msgid "I<oldpath> or I<newpath> points outside your accessible address space."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:76 build/C/man2/read.2:129 build/C/man2/readlink.2:105 build/C/man2/symlink.2:106 build/C/man2/unlink.2:84 build/C/man2/write.2:159
+#: build/C/man2/link.2:79 build/C/man2/read.2:147 build/C/man2/readlink.2:107 build/C/man2/symlink.2:111 build/C/man2/unlink.2:84 build/C/man2/write.2:165
#, no-wrap
msgid "B<EIO>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:79 build/C/man2/symlink.2:109 build/C/man2/unlink.2:87
+#: build/C/man2/link.2:82 build/C/man2/symlink.2:114 build/C/man2/unlink.2:87
msgid "An I/O error occurred."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:79 build/C/man2/open.2:514 build/C/man2/readlink.2:108 build/C/man2/rename.2:146 build/C/man2/rmdir.2:73 build/C/man2/symlink.2:109 build/C/man2/unlink.2:92
+#: build/C/man2/link.2:82 build/C/man2/open.2:629 build/C/man2/readlink.2:110 build/C/man2/rename.2:149 build/C/man2/rmdir.2:73 build/C/man2/symlink.2:114 build/C/man2/unlink.2:92
#, no-wrap
msgid "B<ELOOP>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:83 build/C/man2/rename.2:150
+#: build/C/man2/link.2:86 build/C/man2/rename.2:153
msgid ""
"Too many symbolic links were encountered in resolving I<oldpath> or "
"I<newpath>."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:83 build/C/man2/rename.2:150
+#: build/C/man2/link.2:86 build/C/man2/rename.2:153
#, no-wrap
msgid "B<EMLINK>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:88
+#: build/C/man2/link.2:91
msgid ""
"The file referred to by I<oldpath> already has the maximum number of links "
"to it."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:88 build/C/man2/open.2:524 build/C/man2/readlink.2:111 build/C/man2/rename.2:157 build/C/man2/rmdir.2:77 build/C/man2/symlink.2:113 build/C/man2/unlink.2:96
+#: build/C/man2/link.2:91 build/C/man2/open.2:639 build/C/man2/readlink.2:113 build/C/man2/rename.2:160 build/C/man2/rmdir.2:77 build/C/man2/symlink.2:118 build/C/man2/unlink.2:96
#, no-wrap
msgid "B<ENAMETOOLONG>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:91 build/C/man2/rename.2:160 build/C/man2/symlink.2:116
+#: build/C/man2/link.2:94 build/C/man2/rename.2:163 build/C/man2/symlink.2:121
msgid "I<oldpath> or I<newpath> was too long."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:91 build/C/man2/open.2:538 build/C/man2/readlink.2:114 build/C/man2/rename.2:160 build/C/man2/rmdir.2:80 build/C/man2/symlink.2:116 build/C/man2/unlink.2:99
+#: build/C/man2/link.2:94 build/C/man2/open.2:653 build/C/man2/readlink.2:116 build/C/man2/rename.2:163 build/C/man2/rmdir.2:80 build/C/man2/symlink.2:121 build/C/man2/unlink.2:99
#, no-wrap
msgid "B<ENOENT>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:96
+#: build/C/man2/link.2:99
msgid ""
"A directory component in I<oldpath> or I<newpath> does not exist or is a "
"dangling symbolic link."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:96 build/C/man2/open.2:545 build/C/man2/readlink.2:117 build/C/man2/rename.2:173 build/C/man2/rmdir.2:85 build/C/man3/scanf.3:568 build/C/man2/symlink.2:123 build/C/man3/tempnam.3:91 build/C/man2/unlink.2:106
+#: build/C/man2/link.2:99 build/C/man2/open.2:660 build/C/man2/readlink.2:119 build/C/man2/rename.2:176 build/C/man2/rmdir.2:85 build/C/man3/scanf.3:570 build/C/man2/symlink.2:128 build/C/man3/tempnam.3:95 build/C/man2/unlink.2:106
#, no-wrap
msgid "B<ENOMEM>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:99 build/C/man2/open.2:548 build/C/man2/readlink.2:120 build/C/man2/rename.2:176 build/C/man2/rmdir.2:88 build/C/man2/symlink.2:126 build/C/man2/unlink.2:109
+#: build/C/man2/link.2:102 build/C/man2/open.2:663 build/C/man2/readlink.2:122 build/C/man2/rename.2:179 build/C/man2/rmdir.2:88 build/C/man2/symlink.2:131 build/C/man2/unlink.2:109
msgid "Insufficient kernel memory was available."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:99 build/C/man2/open.2:548 build/C/man2/rename.2:176 build/C/man2/symlink.2:126 build/C/man3/tmpfile.3:68 build/C/man2/write.2:162
+#: build/C/man2/link.2:102 build/C/man2/open.2:663 build/C/man2/rename.2:179 build/C/man2/symlink.2:131 build/C/man3/tmpfile.3:72 build/C/man2/write.2:168
#, no-wrap
msgid "B<ENOSPC>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:103 build/C/man2/rename.2:180 build/C/man2/symlink.2:130
+#: build/C/man2/link.2:106 build/C/man2/rename.2:183 build/C/man2/symlink.2:135
msgid "The device containing the file has no room for the new directory entry."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:103 build/C/man2/open.2:554 build/C/man2/readlink.2:120 build/C/man2/rename.2:180 build/C/man2/rmdir.2:88 build/C/man2/symlink.2:130 build/C/man2/unlink.2:109
+#: build/C/man2/link.2:106 build/C/man2/open.2:669 build/C/man2/readlink.2:122 build/C/man2/rename.2:183 build/C/man2/rmdir.2:88 build/C/man2/symlink.2:135 build/C/man2/unlink.2:109
#, no-wrap
msgid "B<ENOTDIR>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:108
+#: build/C/man2/link.2:111
msgid ""
"A component used as a directory in I<oldpath> or I<newpath> is not, in fact, "
"a directory."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:108 build/C/man2/link.2:112 build/C/man2/open.2:587 build/C/man2/rmdir.2:107 build/C/man2/rmdir.2:118 build/C/man2/symlink.2:135 build/C/man2/unlink.2:114
+#: build/C/man2/link.2:111 build/C/man2/link.2:115 build/C/man2/open.2:702 build/C/man2/rmdir.2:107 build/C/man2/rmdir.2:118 build/C/man2/symlink.2:140 build/C/man2/unlink.2:114
#, no-wrap
msgid "B<EPERM>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:112
+#: build/C/man2/link.2:115
msgid "I<oldpath> is a directory."
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:117
+#: build/C/man2/link.2:120
msgid ""
-"The file
system containing I<oldpath> and I<newpath> does not support the "
+"The filesystem containing I<oldpath> and I<newpath> does not support the "
"creation of hard links."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:117 build/C/man2/open.2:595 build/C/man2/rename.2:218 build/C/man2/rmdir.2:123 build/C/man2/symlink.2:140 build/C/man3/tmpfile.3:71 build/C/man2/unlink.2:137
+#: build/C/man2/link.2:120
+#, no-wrap
+msgid "B<EPERM> (since Linux 3.6)"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/link.2:127
+msgid ""
+"The caller does not have permission to create a hard link to this file (see "
+"the description of I</proc/sys/fs/protected_hardlink> in B<proc>(5))."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/link.2:127 build/C/man2/open.2:710 build/C/man2/rename.2:221 build/C/man2/rmdir.2:123 build/C/man2/symlink.2:145 build/C/man3/tmpfile.3:75 build/C/man2/unlink.2:137
#, no-wrap
msgid "B<EROFS>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:120 build/C/man2/rename.2:221
-msgid "The file is on a read-only file system."
+#: build/C/man2/link.2:130 build/C/man2/rename.2:224
+msgid "The file is on a read-only filesystem."
msgstr ""
#. type: TP
-#: build/C/man2/link.2:120 build/C/man2/rename.2:221
+#: build/C/man2/link.2:130 build/C/man2/rename.2:224
#, no-wrap
msgid "B<EXDEV>"
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:128
+#: build/C/man2/link.2:138
msgid ""
-"I<oldpath> and I<newpath> are not on the same mounted file system. (Linux "
-"permits a file system to be mounted at multiple points, but B<link>() does "
-"not work across different mount points, even if the same file system is "
+"I<oldpath> and I<newpath> are not on the same mounted filesystem. (Linux "
+"permits a filesystem to be mounted at multiple points, but B<link>() does "
+"not work across different mount points, even if the same filesystem is "
"mounted on both.)"
msgstr ""
#. EMULTIHOP error conditions; POSIX.1 does not document ELOOP.
#. X/OPEN does not document EFAULT, ENOMEM or EIO.
#. type: Plain text
-#: build/C/man2/link.2:133
+#: build/C/man2/link.2:143
msgid "SVr4, 4.3BSD, POSIX.1-2001 (but see NOTES)."
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:140
+#: build/C/man2/link.2:150
msgid ""
-"Hard links, as created by B<link>(), cannot span file systems. Use "
+"Hard links, as created by B<link>(), cannot span filesystems. Use "
"B<symlink>(2) if this is required."
msgstr ""
#. thread in the Austin mailing list reported that some
#. other (System V) implementations did/do the same -- MTK, Apr 05
#. type: Plain text
-#: build/C/man2/link.2:171
+#: build/C/man2/link.2:181
msgid ""
"POSIX.1-2001 says that B<link>() should dereference I<oldpath> if it is a "
"symbolic link. However, since kernel 2.0, Linux does not do so: if "
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:177
+#: build/C/man2/link.2:187
msgid ""
-"On NFS file systems, the return code may be wrong in case the NFS server "
+"On NFS filesystems, the return code may be wrong in case the NFS server "
"performs the link creation and dies before it can say so. Use B<stat>(2) "
"to find out if the link got created."
msgstr ""
#. type: Plain text
-#: build/C/man2/link.2:187
+#: build/C/man2/link.2:197
msgid ""
"B<ln>(1), B<linkat>(2), B<open>(2), B<rename>(2), B<stat>(2), B<symlink>(2), "
"B<unlink>(2), B<path_resolution>(7), B<symlink>(7)"
msgstr ""
#. type: TH
-#: build/C/man2/llseek.2:26
+#: build/C/man2/llseek.2:28
#, no-wrap
msgid "LLSEEK"
msgstr ""
#. type: TH
-#: build/C/man2/llseek.2:26
+#: build/C/man2/llseek.2:28
#, no-wrap
-msgid "2007-06-01"
+msgid "2012-07-13"
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:29
+#: build/C/man2/llseek.2:31
msgid "_llseek - reposition read/write file offset"
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:33
+#: build/C/man2/llseek.2:35
#, no-wrap
msgid ""
"B<#include E<lt>sys/types.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:37
+#: build/C/man2/llseek.2:39
#, no-wrap
msgid ""
"B<int _llseek(unsigned int >I<fd>B<, unsigned long >I<offset_high>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:57
+#: build/C/man2/llseek.2:43
+msgid "I<Note>: There is no glibc wrapper for this system call; see NOTES."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/llseek.2:62
msgid ""
"The B<_llseek>() function repositions the offset of the open file "
"associated with the file descriptor I<fd> to I<(offset_highE<lt>E<lt>32) | "
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:64
+#: build/C/man2/llseek.2:69
msgid ""
"Upon successful completion, B<_llseek>() returns 0. Otherwise, a value of "
"-1 is returned and I<errno> is set to indicate the error."
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:69 build/C/man2/lseek.2:164
+#: build/C/man2/llseek.2:74 build/C/man2/lseek.2:175
msgid "I<fd> is not an open file descriptor."
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:72
+#: build/C/man2/llseek.2:77
msgid "Problem with copying results to user space."
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:76
+#: build/C/man2/llseek.2:81
msgid "I<whence> is invalid."
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:79
+#: build/C/man2/llseek.2:84
msgid ""
"This function is Linux-specific, and should not be used in programs intended "
"to be portable."
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:82
+#: build/C/man2/llseek.2:87
msgid ""
"Glibc does not provide a wrapper for this system call; call it using "
"B<syscall>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man2/llseek.2:85
+#: build/C/man2/llseek.2:90
msgid "B<lseek>(2), B<lseek64>(3)"
msgstr ""
#. type: TH
-#: build/C/man2/lseek.2:45
+#: build/C/man2/lseek.2:47
#, no-wrap
msgid "LSEEK"
msgstr ""
#. type: TH
-#: build/C/man2/lseek.2:45
+#: build/C/man2/lseek.2:47
#, no-wrap
-msgid "2011-09-25"
+msgid "2013-03-27"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:48
+#: build/C/man2/lseek.2:50
msgid "lseek - reposition read/write file offset"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:50 build/C/man3/lseek64.3:30
+#: build/C/man2/lseek.2:52 build/C/man3/lseek64.3:32
msgid "B<#include E<lt>sys/types.hE<gt>>"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:54
+#: build/C/man2/lseek.2:56
msgid "B<off_t lseek(int >I<fd>B<, off_t >I<offset>B<, int >I<whence>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:65
+#: build/C/man2/lseek.2:67
msgid ""
"The B<lseek>() function repositions the offset of the open file associated "
"with the file descriptor I<fd> to the argument I<offset> according to the "
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:70
+#: build/C/man2/lseek.2:72
msgid "The offset is set to I<offset> bytes."
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:75
+#: build/C/man2/lseek.2:77
msgid "The offset is set to its current location plus I<offset> bytes."
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:80
+#: build/C/man2/lseek.2:82
msgid "The offset is set to the size of the file plus I<offset> bytes."
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:88
+#: build/C/man2/lseek.2:90
msgid ""
"The B<lseek>() function allows the file offset to be set beyond the end of "
"the file (but this does not change the size of the file). If data is later "
msgstr ""
#. type: SS
-#: build/C/man2/lseek.2:88
+#: build/C/man2/lseek.2:90
#, no-wrap
msgid "Seeking file data and holes"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:91
+#: build/C/man2/lseek.2:93
msgid ""
"Since version 3.1, Linux supports the following additional values for "
"I<whence>:"
msgstr ""
#. type: TP
-#: build/C/man2/lseek.2:91
+#: build/C/man2/lseek.2:93
#, no-wrap
msgid "B<SEEK_DATA>"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:102
+#: build/C/man2/lseek.2:104
msgid ""
"Adjust the file offset to the next location in the file greater than or "
"equal to I<offset> containing data. If I<offset> points to data, then the "
msgstr ""
#. type: TP
-#: build/C/man2/lseek.2:102
+#: build/C/man2/lseek.2:104
#, no-wrap
msgid "B<SEEK_HOLE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:116
+#: build/C/man2/lseek.2:118
msgid ""
"Adjust the file offset to the next hole in the file greater than or equal to "
"I<offset>. If I<offset> points into the middle of a hole, then the file "
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:122
+#: build/C/man2/lseek.2:124
msgid ""
"In both of the above cases, B<lseek>() fails if I<offset> points past the "
"end of the file."
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:128
+#: build/C/man2/lseek.2:130
msgid ""
"These operations allow applications to map holes in a sparsely allocated "
"file. This can be useful for applications such as file backup tools, which "
#. http://lwn.net/Articles/440255/
#. http://blogs.oracle.com/bonwick/entry/seek_hole_and_seek_data
#. type: Plain text
-#: build/C/man2/lseek.2:151
+#: build/C/man2/lseek.2:153
msgid ""
"For the purposes of these operations, a hole is a sequence of zeros that "
"(normally) has not been allocated in the underlying file storage. However, "
-"a file system is not obliged to report holes, so these operations are not a "
+"a filesystem is not obliged to report holes, so these operations are not a "
"guaranteed mechanism for mapping the storage space actually allocated to a "
"file. (Furthermore, a sequence of zeros that actually has been written to "
"the underlying storage may not be reported as a hole.) In the simplest "
-"implementation, a file system can support the operations by making "
+"implementation, a filesystem can support the operations by making "
"B<SEEK_HOLE> always return the offset of the end of the file, and making "
"B<SEEK_DATA> always return I<offset> (i.e., even if the location referred to "
"by I<offset> is a hole, it can be considered to consist of data that is a "
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:159
+#: build/C/man2/lseek.2:162
+msgid ""
+"The B<_GNU_SOURCE> feature test macro must be defined in order to obtain the "
+"definitions of B<SEEK_DATA> and B<SEEK_HOLE> from I<E<lt>unistd.hE<gt>>."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/lseek.2:170
msgid ""
"Upon successful completion, B<lseek>() returns the resulting offset "
"location as measured in bytes from the beginning of the file. On error, the "
msgstr ""
#. Some systems may allow negative offsets for character devices
-#. and/or for remote file systems.
+#. and/or for remote filesystems.
#. type: Plain text
-#: build/C/man2/lseek.2:172
+#: build/C/man2/lseek.2:183
msgid ""
"I<whence> is not valid. Or: the resulting file offset would be negative, or "
"beyond the end of a seekable device."
msgstr ""
#. type: TP
-#: build/C/man2/lseek.2:172 build/C/man2/open.2:567
+#: build/C/man2/lseek.2:183 build/C/man2/open.2:682
#, no-wrap
msgid "B<EOVERFLOW>"
msgstr ""
#. HP-UX 11 says EINVAL for this case (but POSIX.1 says EOVERFLOW)
#. type: Plain text
-#: build/C/man2/lseek.2:177
+#: build/C/man2/lseek.2:188
msgid "The resulting file offset cannot be represented in an I<off_t>."
msgstr ""
#. type: TP
-#: build/C/man2/lseek.2:177
+#: build/C/man2/lseek.2:188
#, no-wrap
msgid "B<ESPIPE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:181
+#: build/C/man2/lseek.2:192
msgid "I<fd> is associated with a pipe, socket, or FIFO."
msgstr ""
#. type: TP
-#: build/C/man2/lseek.2:181 build/C/man2/open.2:561
+#: build/C/man2/lseek.2:192 build/C/man2/open.2:676
#, no-wrap
msgid "B<ENXIO>"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:189
+#: build/C/man2/lseek.2:200
msgid ""
"I<whence> is B<SEEK_DATA> or B<SEEK_HOLE>, and the current file offset is "
"beyond the end of the file."
#. SVr4 documents additional error
#. conditions EDEADLK, ENOLCK, ENOLNK, ENOSR, ENXIO, or ERANGE.
#. type: Plain text
-#: build/C/man2/lseek.2:191 build/C/man2/read.2:157 build/C/man2/rmdir.2:129 build/C/man2/symlink.2:150 build/C/man2/unlink.2:145 build/C/man2/write.2:183
+#: build/C/man2/lseek.2:202 build/C/man2/read.2:175 build/C/man2/rmdir.2:129 build/C/man2/symlink.2:155 build/C/man2/unlink.2:145 build/C/man2/write.2:189
msgid "SVr4, 4.3BSD, POSIX.1-2001."
msgstr ""
#. FIXME . Review http://austingroupbugs.net/view.php?id=415 in the future
#. type: Plain text
-#: build/C/man2/lseek.2:199
+#: build/C/man2/lseek.2:210
msgid ""
"B<SEEK_DATA> and B<SEEK_HOLE> are nonstandard extensions also present in "
"Solaris, FreeBSD, and DragonFly BSD; they are proposed for inclusion in the "
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:203
+#: build/C/man2/lseek.2:214
msgid ""
"Some devices are incapable of seeking and POSIX does not specify which "
"devices must support B<lseek>()."
#. Other systems return the number of written characters,
#. using SEEK_SET to set the counter. (Of written characters.)
#. type: Plain text
-#: build/C/man2/lseek.2:210
-msgid "On Linux, using B<lseek>() on a tty device returns B<ESPIPE>."
+#: build/C/man2/lseek.2:221
+msgid "On Linux, using B<lseek>() on a terminal device returns B<ESPIPE>."
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:213
+#: build/C/man2/lseek.2:224
msgid ""
"When converting old code, substitute values for I<whence> with the following "
"macros:"
msgstr ""
#. type: tbl table
-#: build/C/man2/lseek.2:216
+#: build/C/man2/lseek.2:227
#, no-wrap
msgid "old\tnew\n"
msgstr ""
#. type: tbl table
-#: build/C/man2/lseek.2:217
+#: build/C/man2/lseek.2:228
#, no-wrap
msgid "0\tSEEK_SET\n"
msgstr ""
#. type: tbl table
-#: build/C/man2/lseek.2:218
+#: build/C/man2/lseek.2:229
#, no-wrap
msgid "1\tSEEK_CUR\n"
msgstr ""
#. type: tbl table
-#: build/C/man2/lseek.2:219
+#: build/C/man2/lseek.2:230
#, no-wrap
msgid "2\tSEEK_END\n"
msgstr ""
#. type: tbl table
-#: build/C/man2/lseek.2:220
+#: build/C/man2/lseek.2:231
#, no-wrap
msgid "L_SET\tSEEK_SET\n"
msgstr ""
#. type: tbl table
-#: build/C/man2/lseek.2:221
+#: build/C/man2/lseek.2:232
#, no-wrap
msgid "L_INCR\tSEEK_CUR\n"
msgstr ""
#. type: tbl table
-#: build/C/man2/lseek.2:222
+#: build/C/man2/lseek.2:233
#, no-wrap
msgid "L_XTND\tSEEK_END\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:234
+#: build/C/man2/lseek.2:245
msgid ""
"Note that file descriptors created by B<dup>(2) or B<fork>(2) share the "
"current file position pointer, so seeking on such files may be subject to "
msgstr ""
#. type: Plain text
-#: build/C/man2/lseek.2:241
+#: build/C/man2/lseek.2:252
msgid ""
"B<dup>(2), B<fork>(2), B<open>(2), B<fseek>(3), B<lseek64>(3), "
"B<posix_fallocate>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/lseek64.3:23
+#: build/C/man3/lseek64.3:25
#, no-wrap
msgid "LSEEK64"
msgstr ""
#. type: TH
-#: build/C/man3/lseek64.3:23
+#: build/C/man3/lseek64.3:25
#, no-wrap
-msgid "2004-12-11"
+msgid "2013-08-19"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:26
+#: build/C/man3/lseek64.3:28
msgid "lseek64 - reposition 64-bit read/write file offset"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:28
+#: build/C/man3/lseek64.3:30
msgid "B<#define _LARGEFILE64_SOURCE> /* See feature_test_macros(7) */"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:34
+#: build/C/man3/lseek64.3:36
msgid "B<off64_t lseek64(int >I<fd>B<, off64_t >I<offset>B<, int >I<whence>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:51
+#: build/C/man3/lseek64.3:53
msgid ""
"The B<lseek>(2) family of functions reposition the offset of the open file "
"associated with the file descriptor I<fd> to I<offset> bytes relative to the "
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:54
+#: build/C/man3/lseek64.3:56
msgid "For more details, return value, and errors, see B<lseek>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:61
+#: build/C/man3/lseek64.3:63
msgid ""
"Four interfaces are available: B<lseek>(2), B<lseek64>(), B<llseek>(2), and "
"the raw system call B<_llseek>(2)."
msgstr ""
#. type: SS
-#: build/C/man3/lseek64.3:61
+#: build/C/man3/lseek64.3:63
#, no-wrap
msgid "lseek"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:63 build/C/man3/lseek64.3:85 build/C/man3/lseek64.3:114
+#: build/C/man3/lseek64.3:65 build/C/man3/lseek64.3:87 build/C/man3/lseek64.3:116
msgid "Prototype:"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:67
+#: build/C/man3/lseek64.3:69
#, no-wrap
msgid "B<off_t lseek(int >I<fd>B<, off_t >I<offset>B<, int >I<whence>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:75
+#: build/C/man3/lseek64.3:77
msgid ""
"B<lseek>(2) uses the type I<off_t>. This is a 32-bit signed type on 32-bit "
"architectures, unless one compiles with"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:83
+#: build/C/man3/lseek64.3:85
msgid "in which case it is a 64-bit signed type."
msgstr ""
#. type: SS
-#: build/C/man3/lseek64.3:83
+#: build/C/man3/lseek64.3:85
#, no-wrap
msgid "lseek64"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:89
+#: build/C/man3/lseek64.3:91
#, no-wrap
msgid "B<off64_t lseek64(int >I<fd>B<, off64_t >I<offset>B<, int >I<whence>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:100
+#: build/C/man3/lseek64.3:102
msgid ""
"The library routine B<lseek64>() uses a 64-bit type even when I<off_t> is a "
"32-bit type. Its prototype (and the type I<off64_t>) is available only "
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:104
+#: build/C/man3/lseek64.3:106
#, no-wrap
msgid "#define _LARGEFILE64_SOURCE\n"
msgstr ""
#. in glibc 2.0.94, not in 2.0.6
#. type: Plain text
-#: build/C/man3/lseek64.3:112
+#: build/C/man3/lseek64.3:114
msgid ""
"The function B<lseek64>() is available since glibc 2.1, and is defined to "
"be an alias for B<llseek>()."
msgstr ""
#. type: SS
-#: build/C/man3/lseek64.3:112
+#: build/C/man3/lseek64.3:114
#, no-wrap
msgid "llseek"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:118
+#: build/C/man3/lseek64.3:120
#, no-wrap
msgid "B<loff_t llseek(int >I<fd>B<, loff_t >I<offset>B<, int >I<whence>B<);>\n"
msgstr ""
#. in libc 5.0.9, not in 4.7.6
#. type: Plain text
-#: build/C/man3/lseek64.3:137
+#: build/C/man3/lseek64.3:139
msgid ""
"The type I<loff_t> is a 64-bit signed type. The library routine B<llseek>() "
"is available in libc5 and glibc and works without special defines. Its "
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:140
+#: build/C/man3/lseek64.3:142
msgid "the \\`llseek\\' function may be dangerous; use \\`lseek64\\' instead."
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:144
+#: build/C/man3/lseek64.3:146
msgid "This makes this function unusable if one desires a warning-free compilation."
msgstr ""
#. type: SS
-#: build/C/man3/lseek64.3:144
+#: build/C/man3/lseek64.3:146
#, no-wrap
msgid "_llseek"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:147
+#: build/C/man3/lseek64.3:149
msgid ""
"All the above functions are implemented in terms of this system call. The "
"prototype is:"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:152
+#: build/C/man3/lseek64.3:154
#, no-wrap
msgid ""
"B<int _llseek(int >I<fd>B<, off_t >I<offset_hi>B<, off_t >I<offset_lo>B<,>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:157
+#: build/C/man3/lseek64.3:159
msgid "For more details, see B<llseek>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/lseek64.3:160
+#: build/C/man3/lseek64.3:164
+msgid "The B<lseek64>() function is thread-safe."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/lseek64.3:167
msgid "B<llseek>(2), B<lseek>(2)"
msgstr ""
#. type: TH
-#: build/C/man2/open.2:52
+#: build/C/man2/open.2:51
#, no-wrap
msgid "OPEN"
msgstr ""
#. type: TH
-#: build/C/man2/open.2:52
+#: build/C/man2/open.2:51
#, no-wrap
-msgid "2011-09-08"
+msgid "2013-08-09"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:55
+#: build/C/man2/open.2:54
msgid "open, creat - open and possibly create a file or device"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:60
+#: build/C/man2/open.2:59
#, no-wrap
msgid ""
"B<#include E<lt>sys/types.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:63
+#: build/C/man2/open.2:62
#, no-wrap
msgid ""
"B<int open(const char *>I<pathname>B<, int >I<flags>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:65
+#: build/C/man2/open.2:64
#, no-wrap
msgid "B<int creat(const char *>I<pathname>B<, mode_t >I<mode>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:76
+#: build/C/man2/open.2:75
msgid ""
"Given a I<pathname> for a file, B<open>() returns a file descriptor, a "
"small, nonnegative integer for use in subsequent system calls (B<read>(2), "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:88
+#: build/C/man2/open.2:87
msgid ""
"By default, the new file descriptor is set to remain open across an "
"B<execve>(2) (i.e., the B<FD_CLOEXEC> file descriptor flag described in "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:107
+#: build/C/man2/open.2:106
msgid ""
"A call to B<open>() creates a new I<open file description>, an entry in the "
"system-wide table of open files. This entry records the file offset and the "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:115
+#: build/C/man2/open.2:114
msgid ""
"The argument I<flags> must include one of the following I<access modes>: "
"B<O_RDONLY>, B<O_WRONLY>, or B<O_RDWR>. These request opening the file "
"read-only, write-only, or read/write, respectively."
msgstr ""
-#. FIXME . Actually is it true that the "file status flags" are all of the
-#. remaining flags listed below? SUSv4 divides the flags into:
+#. SUSv4 divides the flags into:
#. * Access mode
#. * File creation
#. * File status
#. * Other (O_CLOEXEC, O_DIRECTORY, O_NOFOLLOW)
#. though it's not clear what the difference between "other" and
-#. "File creation" flags is. (I've raised an Aardvark to see if this
-#. can be clarified in SUSv4; 10 Oct 2008.)
+#. "File creation" flags is. I raised an Aardvark to see if this
+#. can be clarified in SUSv4; 10 Oct 2008.
+#. http://thread.gmane.org/gmane.comp.standards.posix.austin.general/64/focus=67
+#. TC1 (balloted in 2013), resolved this, so that those three constants
+#. are also categorized" as file status flags.
#. type: Plain text
-#: build/C/man2/open.2:142
+#: build/C/man2/open.2:152
msgid ""
"In addition, zero or more file creation flags and file status flags can be "
-"bitwise-I<or>'d in I<flags>. The I<file creation flags> are B<O_CREAT>, "
-"B<O_EXCL>, B<O_NOCTTY>, and B<O_TRUNC>. The I<file status flags> are all of "
-"the remaining flags listed below. The distinction between these two groups "
-"of flags is that the file status flags can be retrieved and (in some cases) "
+"bitwise-I<or>'d in I<flags>. The I<file creation flags> are B<O_CLOEXEC>, "
+"B<O_CREAT>, B<O_DIRECTORY>, B<O_EXCL>, B<O_NOCTTY>, B<O_NOFOLLOW>, "
+"B<O_TRUNC>, and B<O_TTY_INIT>. The I<file status flags> are all of the "
+"remaining flags listed below. The distinction between these two groups of "
+"flags is that the file status flags can be retrieved and (in some cases) "
"modified using B<fcntl>(2). The full list of file creation flags and file "
"status flags is as follows:"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:142
+#: build/C/man2/open.2:152
#, no-wrap
msgid "B<O_APPEND>"
msgstr ""
#. http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=453946
#. http://nfs.sourceforge.net/
#. type: Plain text
-#: build/C/man2/open.2:159
+#: build/C/man2/open.2:169
msgid ""
"The file is opened in append mode. Before each B<write>(2), the file offset "
"is positioned at the end of the file, as if with B<lseek>(2). B<O_APPEND> "
-"may lead to corrupted files on NFS file systems if more than one process "
+"may lead to corrupted files on NFS filesystems if more than one process "
"appends data to a file at once. This is because NFS does not support "
"appending to a file, so the client kernel has to simulate it, which can't be "
"done without a race condition."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:159
+#: build/C/man2/open.2:169
#, no-wrap
msgid "B<O_ASYNC>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:172
+#: build/C/man2/open.2:182
msgid ""
"Enable signal-driven I/O: generate a signal (B<SIGIO> by default, but this "
"can be changed via B<fcntl>(2)) when input or output becomes possible on "
-"this file descriptor. This feature is only available for terminals, "
+"this file descriptor. This feature is available only for terminals, "
"pseudoterminals, sockets, and (since Linux 2.6) pipes and FIFOs. See "
"B<fcntl>(2) for further details."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:172
+#: build/C/man2/open.2:182
#, no-wrap
msgid "B<O_CLOEXEC> (Since Linux 2.6.23)"
msgstr ""
#. The race can also occur with, for example, descriptors
#. returned by accept(), pipe(), etc.
#. type: Plain text
-#: build/C/man2/open.2:197
+#: build/C/man2/open.2:207
msgid ""
"Enable the close-on-exec flag for the new file descriptor. Specifying this "
"flag permits a program to avoid additional B<fcntl>(2) B<F_SETFD> "
msgstr ""
#. type: TP
-#: build/C/man2/open.2:197
+#: build/C/man2/open.2:207
#, no-wrap
msgid "B<O_CREAT>"
msgstr ""
#. As at 2.6.25, bsdgroups is supported by ext2, ext3, ext4, and
#. XFS (since 2.6.14).
#. type: Plain text
-#: build/C/man2/open.2:213
+#: build/C/man2/open.2:223
msgid ""
"If the file does not exist it will be created. The owner (user ID) of the "
"file is set to the effective user ID of the process. The group ownership "
"(group ID) is set either to the effective group ID of the process or to the "
-"group ID of the parent directory (depending on file system type and mount "
+"group ID of the parent directory (depending on filesystem type and mount "
"options, and the mode of the parent directory, see the mount options "
"I<bsdgroups> and I<sysvgroups> described in B<mount>(8))."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:236
+#: build/C/man2/open.2:246
msgid ""
"I<mode> specifies the permissions to use in case a new file is created. "
"This argument must be supplied when B<O_CREAT> is specified in I<flags>; if "
"B<O_CREAT> is not specified, then I<mode> is ignored. The effective "
"permissions are modified by the process's I<umask> in the usual way: The "
"permissions of the created file are I<(mode\\ &\\ ~umask)>. Note that this "
-"mode only applies to future accesses of the newly created file; the "
+"mode applies only to future accesses of the newly created file; the "
"B<open>() call that creates a read-only file may well return a read/write "
"file descriptor."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:239
+#: build/C/man2/open.2:249
msgid "The following symbolic constants are provided for I<mode>:"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:239
+#: build/C/man2/open.2:249
#, no-wrap
msgid "B<S_IRWXU>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:242
+#: build/C/man2/open.2:252
msgid "00700 user (file owner) has read, write and execute permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:242
+#: build/C/man2/open.2:252
#, no-wrap
msgid "B<S_IRUSR>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:245
+#: build/C/man2/open.2:255
msgid "00400 user has read permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:245
+#: build/C/man2/open.2:255
#, no-wrap
msgid "B<S_IWUSR>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:248
+#: build/C/man2/open.2:258
msgid "00200 user has write permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:248
+#: build/C/man2/open.2:258
#, no-wrap
msgid "B<S_IXUSR>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:251
+#: build/C/man2/open.2:261
msgid "00100 user has execute permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:251
+#: build/C/man2/open.2:261
#, no-wrap
msgid "B<S_IRWXG>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:254
+#: build/C/man2/open.2:264
msgid "00070 group has read, write and execute permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:254
+#: build/C/man2/open.2:264
#, no-wrap
msgid "B<S_IRGRP>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:257
+#: build/C/man2/open.2:267
msgid "00040 group has read permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:257
+#: build/C/man2/open.2:267
#, no-wrap
msgid "B<S_IWGRP>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:260
+#: build/C/man2/open.2:270
msgid "00020 group has write permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:260
+#: build/C/man2/open.2:270
#, no-wrap
msgid "B<S_IXGRP>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:263
+#: build/C/man2/open.2:273
msgid "00010 group has execute permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:263
+#: build/C/man2/open.2:273
#, no-wrap
msgid "B<S_IRWXO>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:266
+#: build/C/man2/open.2:276
msgid "00007 others have read, write and execute permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:266
+#: build/C/man2/open.2:276
#, no-wrap
msgid "B<S_IROTH>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:269
+#: build/C/man2/open.2:279
msgid "00004 others have read permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:269
+#: build/C/man2/open.2:279
#, no-wrap
msgid "B<S_IWOTH>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:272
+#: build/C/man2/open.2:282
msgid "00002 others have write permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:272
+#: build/C/man2/open.2:282
#, no-wrap
msgid "B<S_IXOTH>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:275
+#: build/C/man2/open.2:285
msgid "00001 others have execute permission"
msgstr ""
#. type: TP
-#: build/C/man2/open.2:276
+#: build/C/man2/open.2:286
#, no-wrap
msgid "B<O_DIRECT> (Since Linux 2.4.10)"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:295
+#: build/C/man2/open.2:303
msgid ""
"Try to minimize cache effects of the I/O to and from this file. In general "
"this will degrade performance, but it is useful in special situations, such "
"as when applications do their own caching. File I/O is done directly "
-"to/from user space buffers. The B<O_DIRECT> flag on its own makes at an "
-"effort to transfer data synchronously, but does not give the guarantees of "
-"the B<O_SYNC> that data and necessary metadata are transferred. To "
-"guarantee synchronous I/O the B<O_SYNC> must be used in addition to "
-"B<O_DIRECT>. See B<NOTES> below for further discussion."
+"to/from user-space buffers. The B<O_DIRECT> flag on its own makes an effort "
+"to transfer data synchronously, but does not give the guarantees of the "
+"B<O_SYNC> flag that data and necessary metadata are transferred. To "
+"guarantee synchronous I/O, B<O_SYNC> must be used in addition to "
+"B<O_DIRECT>. See NOTES below for further discussion."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:299
+#: build/C/man2/open.2:307
msgid ""
"A semantically similar (but deprecated) interface for block devices is "
"described in B<raw>(8)."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:299
+#: build/C/man2/open.2:307
#, no-wrap
msgid "B<O_DIRECTORY>"
msgstr ""
#. [PATCH] open: O_DIRECTORY and O_CREAT together should fail
#. O_DIRECTORY | O_CREAT causes O_DIRECTORY to be ignored.
#. type: Plain text
-#: build/C/man2/open.2:313
+#: build/C/man2/open.2:319
msgid ""
"If I<pathname> is not a directory, cause the open to fail. This flag is "
"Linux-specific, and was added in kernel version 2.1.126, to avoid "
"denial-of-service problems if B<opendir>(3) is called on a FIFO or tape "
-"device, but should not be used outside of the implementation of "
-"B<opendir>(3)."
+"device."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:313
+#: build/C/man2/open.2:319
#, no-wrap
msgid "B<O_EXCL>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:323
+#: build/C/man2/open.2:329
msgid ""
"Ensure that this call creates the file: if this flag is specified in "
"conjunction with B<O_CREAT>, and I<pathname> already exists, then B<open>() "
#. POSIX.1-2001 explicitly requires this behavior.
#. type: Plain text
-#: build/C/man2/open.2:331
+#: build/C/man2/open.2:337
msgid ""
"When these two flags are specified, symbolic links are not followed: if "
"I<pathname> is a symbolic link, then B<open>() fails regardless of where "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:347
+#: build/C/man2/open.2:353
msgid ""
"In general, the behavior of B<O_EXCL> is undefined if it is used without "
"B<O_CREAT>. There is one exception: on Linux 2.6 and later, B<O_EXCL> can "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:369
+#: build/C/man2/open.2:375
msgid ""
-"On NFS, B<O_EXCL> is only supported when using NFSv3 or later on kernel 2.6 "
+"On NFS, B<O_EXCL> is supported only when using NFSv3 or later on kernel 2.6 "
"or later. In NFS environments where B<O_EXCL> support is not provided, "
"programs that rely on it for performing locking tasks will contain a race "
"condition. Portable programs that want to perform atomic file locking using "
"a lockfile, and need to avoid reliance on NFS support for B<O_EXCL>, can "
-"create a unique file on the same file system (e.g., incorporating hostname "
+"create a unique file on the same filesystem (e.g., incorporating hostname "
"and PID), and use B<link>(2) to make a link to the lockfile. If B<link>(2) "
"returns 0, the lock is successful. Otherwise, use B<stat>(2) on the unique "
"file to check if its link count has increased to 2, in which case the lock "
msgstr ""
#. type: TP
-#: build/C/man2/open.2:369
+#: build/C/man2/open.2:375
#, no-wrap
msgid "B<O_LARGEFILE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:391
+#: build/C/man2/open.2:397
msgid ""
"(LFS) Allow files whose sizes cannot be represented in an I<off_t> (but can "
"be represented in an I<off64_t>) to be opened. The B<_LARGEFILE64_SOURCE> "
msgstr ""
#. type: TP
-#: build/C/man2/open.2:391
+#: build/C/man2/open.2:397
#, no-wrap
msgid "B<O_NOATIME> (Since Linux 2.6.8)"
msgstr ""
#. The O_NOATIME flag also affects the treatment of st_atime
#. by mmap() and readdir(2), MTK, Dec 04.
#. type: Plain text
-#: build/C/man2/open.2:402
+#: build/C/man2/open.2:410
msgid ""
-"Do not update the file last access time (st_atime in the inode) when the "
+"Do not update the file last access time (I<st_atime> in the inode) when the "
"file is B<read>(2). This flag is intended for use by indexing or backup "
"programs, where its use can significantly reduce the amount of disk "
-"activity. This flag may not be effective on all file systems. One example "
+"activity. This flag may not be effective on all filesystems. One example "
"is NFS, where the server maintains the access time."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:402
+#: build/C/man2/open.2:410
#, no-wrap
msgid "B<O_NOCTTY>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:410
+#: build/C/man2/open.2:418
msgid ""
-"If I<pathname> refers to a terminal device\\(emsee B<tty>(4)\\(em it will "
-"not become the process's controlling terminal even if the process does not "
-"have one."
+"If I<pathname> refers to a terminal device\\(emsee B<tty>(4)\\(emit will not "
+"become the process's controlling terminal even if the process does not have "
+"one."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:410
+#: build/C/man2/open.2:418
#, no-wrap
msgid "B<O_NOFOLLOW>"
msgstr ""
#. definition of this flag; \fIkernels before 2.1.126 will ignore it if
#. used\fP.
#. type: Plain text
-#: build/C/man2/open.2:419
+#: build/C/man2/open.2:430
msgid ""
"If I<pathname> is a symbolic link, then the open fails. This is a FreeBSD "
"extension, which was added to Linux in version 2.1.126. Symbolic links in "
-"earlier components of the pathname will still be followed."
+"earlier components of the pathname will still be followed. See also "
+"B<O_NOPATH> below."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:419
+#: build/C/man2/open.2:430
#, no-wrap
msgid "B<O_NONBLOCK> or B<O_NDELAY>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:432
+#: build/C/man2/open.2:443
msgid ""
"When possible, the file is opened in nonblocking mode. Neither the "
"B<open>() nor any subsequent operations on the file descriptor which is "
msgstr ""
#. type: TP
-#: build/C/man2/open.2:432
+#: build/C/man2/open.2:443
+#, no-wrap
+msgid "B<O_PATH> (since Linux 2.6.39)"
+msgstr ""
+
+#. commit 1abf0c718f15a56a0a435588d1b104c7a37dc9bd
+#. commit 326be7b484843988afe57566b627fb7a70beac56
+#. commit 65cfc6722361570bfe255698d9cd4dccaf47570d
+#
+#. http://thread.gmane.org/gmane.linux.man/2790/focus=3496
+#. Subject: Re: [PATCH] open(2): document O_PATH
+#. Newsgroups: gmane.linux.man, gmane.linux.kernel
+#. type: Plain text
+#: build/C/man2/open.2:465
+msgid ""
+"Obtain a file descriptor that can be used for two purposes: to indicate a "
+"location in the filesystem tree and to perform operations that act purely at "
+"the file descriptor level. The file itself is not opened, and other file "
+"operations (e.g., B<read>(2), B<write>(2), B<fchmod>(2), B<fchown>(2), "
+"B<fgetxattr>(2), B<mmap>(2)) fail with the error B<EBADF>."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:469
+msgid ""
+"The following operations I<can> be performed on the resulting file "
+"descriptor:"
+msgstr ""
+
+#. commit 332a2e1244bd08b9e3ecd378028513396a004a24
+#. fstat(): commit 55815f70147dcfa3ead5738fd56d3574e2e3c1c2
+#. type: Plain text
+#: build/C/man2/open.2:478
+msgid ""
+"B<close>(2); B<fchdir>(2) (since Linux 3.5); B<fstat>(2) (since Linux "
+"3.6)."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:484
+msgid "Duplicating the file descriptor (B<dup>(2), B<fcntl>(2) B<F_DUPFD>, etc.)."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:490
+msgid ""
+"Getting and setting file descriptor flags (B<fcntl>(2) B<F_GETFD> and "
+"B<F_SETFD>)."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:496
+msgid ""
+"Retrieving open file status flags using the B<fcntl>(2) B<F_GETFL> "
+"operation: the returned flags will include the bit B<O_PATH>."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:503
+msgid ""
+"Passing the file descriptor as the I<dirfd> argument of B<openat>(2) and "
+"the other \"*at()\" system calls."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:509
+msgid ""
+"Passing the file descriptor to another process via a UNIX domain socket (see "
+"B<SCM_RIGHTS> in B<unix>(7))."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:520
+msgid ""
+"When B<O_PATH> is specified in I<flags>, flag bits other than B<O_DIRECTORY> "
+"and B<O_NOFOLLOW> are ignored."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:534
+msgid ""
+"If the B<O_NOFOLLOW> flag is also specified, then the call returns a file "
+"descriptor referring to the symbolic link. This file descriptor can be used "
+"as the I<dirfd> argument in calls to B<fchownat>(2), B<fstatat>(2), "
+"B<linkat>(2), and B<readlinkat>(2) with an empty pathname to have the calls "
+"operate on the symbolic link."
+msgstr ""
+
+#. type: TP
+#: build/C/man2/open.2:534
#, no-wrap
msgid "B<O_SYNC>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:440
+#: build/C/man2/open.2:542
msgid ""
"The file is opened for synchronous I/O. Any B<write>(2)s on the resulting "
"file descriptor will block the calling process until the data has been "
msgstr ""
#. type: TP
-#: build/C/man2/open.2:440
+#: build/C/man2/open.2:542
#, no-wrap
msgid "B<O_TRUNC>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:454
+#: build/C/man2/open.2:556
msgid ""
"If the file already exists and is a regular file and the open mode allows "
"writing (i.e., is B<O_RDWR> or B<O_WRONLY>) it will be truncated to length "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:458
+#: build/C/man2/open.2:560
msgid ""
"Some of these optional flags can be altered using B<fcntl>(2) after the "
"file has been opened."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:466
+#: build/C/man2/open.2:568
msgid ""
"B<creat>() is equivalent to B<open>() with I<flags> equal to "
"B<O_CREAT|O_WRONLY|O_TRUNC>."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:474
+#: build/C/man2/open.2:576
msgid ""
"B<open>() and B<creat>() return the new file descriptor, or -1 if an error "
"occurred (in which case, I<errno> is set appropriately)."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:484
+#: build/C/man2/open.2:586
msgid ""
"The requested access to the file is not allowed, or search permission is "
"denied for one of the directories in the path prefix of I<pathname>, or the "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:490
+#: build/C/man2/open.2:592
+msgid ""
+"Where B<O_CREAT> is specified, the file does not exist, and the user's quota "
+"of disk blocks or inodes on the filesystem has been exhausted."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:598
msgid "I<pathname> already exists and B<O_CREAT> and B<O_EXCL> were used."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:494 build/C/man2/rmdir.2:67 build/C/man2/unlink.2:84
+#: build/C/man2/open.2:602 build/C/man2/rmdir.2:67 build/C/man2/unlink.2:84
msgid "I<pathname> points outside your accessible address space."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:494 build/C/man2/write.2:139
+#: build/C/man2/open.2:602 build/C/man2/write.2:145
#, no-wrap
msgid "B<EFBIG>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:498
+#: build/C/man2/open.2:606
msgid "See B<EOVERFLOW>."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:498 build/C/man2/read.2:104 build/C/man3/scanf.3:559 build/C/man3/tmpfile.3:59 build/C/man2/write.2:144
+#: build/C/man2/open.2:606 build/C/man2/read.2:122 build/C/man3/scanf.3:561 build/C/man3/tmpfile.3:63 build/C/man2/write.2:150
#, no-wrap
msgid "B<EINTR>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:505
+#: build/C/man2/open.2:613
msgid ""
"While blocked waiting to complete an open of a slow device (e.g., a FIFO; "
"see B<fifo>(7)), the call was interrupted by a signal handler; see "
"B<signal>(7)."
msgstr ""
+#. type: Plain text
+#: build/C/man2/open.2:620
+msgid ""
+"The filesystem does not support the B<O_DIRECT> flag. See B<NOTES> for more "
+"information."
+msgstr ""
+
#. type: TP
-#: build/C/man2/open.2:505 build/C/man2/read.2:140 build/C/man2/rename.2:140 build/C/man2/unlink.2:87
+#: build/C/man2/open.2:620 build/C/man2/read.2:158 build/C/man2/rename.2:143 build/C/man2/unlink.2:87
#, no-wrap
msgid "B<EISDIR>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:514
+#: build/C/man2/open.2:629
msgid ""
"I<pathname> refers to a directory and the access requested involved writing "
"(that is, B<O_WRONLY> or B<O_RDWR> is set)."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:521
+#: build/C/man2/open.2:636
msgid ""
"Too many symbolic links were encountered in resolving I<pathname>, or "
"B<O_NOFOLLOW> was specified but I<pathname> was a symbolic link."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:521 build/C/man2/pipe.2:106 build/C/man3/tmpfile.3:62
+#: build/C/man2/open.2:636 build/C/man2/pipe.2:107 build/C/man3/tmpfile.3:66
#, no-wrap
msgid "B<EMFILE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:524
+#: build/C/man2/open.2:639
msgid "The process already has the maximum number of files open."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:528 build/C/man2/rmdir.2:80 build/C/man2/unlink.2:99
+#: build/C/man2/open.2:643 build/C/man2/rmdir.2:80 build/C/man2/unlink.2:99
msgid "I<pathname> was too long."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:528 build/C/man2/pipe.2:109 build/C/man3/tmpfile.3:65
+#: build/C/man2/open.2:643 build/C/man2/pipe.2:110 build/C/man3/tmpfile.3:69
#, no-wrap
msgid "B<ENFILE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:531 build/C/man2/pipe.2:112
+#: build/C/man2/open.2:646 build/C/man2/pipe.2:113
msgid "The system limit on the total number of open files has been reached."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:531
+#: build/C/man2/open.2:646
#, no-wrap
msgid "B<ENODEV>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:538
+#: build/C/man2/open.2:653
msgid ""
"I<pathname> refers to a device special file and no corresponding device "
"exists. (This is a Linux kernel bug; in this situation B<ENXIO> must be "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:545
+#: build/C/man2/open.2:660
msgid ""
"B<O_CREAT> is not set and the named file does not exist. Or, a directory "
"component in I<pathname> does not exist or is a dangling symbolic link."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:554
+#: build/C/man2/open.2:669
msgid ""
"I<pathname> was to be created but the device containing I<pathname> has no "
"room for the new file."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:561
+#: build/C/man2/open.2:676
msgid ""
"A component used as a directory in I<pathname> is not, in fact, a directory, "
"or B<O_DIRECTORY> was specified and I<pathname> was not a directory."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:567
+#: build/C/man2/open.2:682
msgid ""
"B<O_NONBLOCK> | B<O_WRONLY> is set, the named file is a FIFO and no process "
"has the file open for reading. Or, the file is a device special file and no "
#. "Open of a large file on 32-bit fails with EFBIG, should be EOVERFLOW"
#. Reported 2006-10-03
#. type: Plain text
-#: build/C/man2/open.2:587
+#: build/C/man2/open.2:702
msgid ""
"I<pathname> refers to a regular file that is too large to be opened. The "
"usual scenario here is that an application compiled on a 32-bit platform "
"B<EFBIG> for this case."
msgstr ""
-#. Strictly speaking, it's the file system UID... (MTK)
+#. Strictly speaking, it's the filesystem UID... (MTK)
#. type: Plain text
-#: build/C/man2/open.2:595
+#: build/C/man2/open.2:710
msgid ""
"The B<O_NOATIME> flag was specified, but the effective user ID of the caller "
"did not match the owner of the file and the caller was not privileged "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:600
+#: build/C/man2/open.2:715
msgid ""
-"I<pathname> refers to a file on a read-only file system and write access was "
+"I<pathname> refers to a file on a read-only filesystem and write access was "
"requested."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:600
+#: build/C/man2/open.2:715
#, no-wrap
msgid "B<ETXTBSY>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:605
+#: build/C/man2/open.2:720
msgid ""
"I<pathname> refers to an executable image which is currently being executed "
"and write access was requested."
msgstr ""
#. type: TP
-#: build/C/man2/open.2:605
+#: build/C/man2/open.2:720
#, no-wrap
msgid "B<EWOULDBLOCK>"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:612
+#: build/C/man2/open.2:727
msgid ""
"The B<O_NONBLOCK> flag was specified, and an incompatible lease was held on "
"the file (see B<fcntl>(2))."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:625
+#: build/C/man2/open.2:741
msgid ""
-"SVr4, 4.3BSD, POSIX.1-2001. The B<O_DIRECTORY>, B<O_NOATIME>, and "
-"B<O_NOFOLLOW> flags are Linux-specific, and one may need to define "
-"B<_GNU_SOURCE> (before including I<any> header files) to obtain their "
-"definitions."
+"SVr4, 4.3BSD, POSIX.1-2001. The B<O_DIRECTORY>, B<O_NOATIME>, "
+"B<O_NOFOLLOW>, and B<O_PATH> flags are Linux-specific, and one may need to "
+"define B<_GNU_SOURCE> (before including I<any> header files) to obtain "
+"their definitions."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:630
+#: build/C/man2/open.2:746
msgid ""
"The B<O_CLOEXEC> flag is not specified in POSIX.1-2001, but is specified in "
"POSIX.1-2008."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:638
+#: build/C/man2/open.2:754
msgid ""
"B<O_DIRECT> is not specified in POSIX; one has to define B<_GNU_SOURCE> "
"(before including I<any> header files) to get its definition."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:646
+#: build/C/man2/open.2:762
msgid ""
"Under Linux, the B<O_NONBLOCK> flag indicates that one wants to open but "
"does not necessarily have the intention to read or write. This is typically "
#. "[RFC] correct flags to f_mode conversion in __dentry_open"
#. LKML, 12 Mar 2008
#. type: Plain text
-#: build/C/man2/open.2:675
+#: build/C/man2/open.2:791
msgid ""
"Unlike the other values that can be specified in I<flags>, the I<access "
"mode> values B<O_RDONLY>, B<O_WRONLY>, and B<O_RDWR>, do not specify "
"nonstandard access mode 3 (binary 11) in I<flags> to mean: check for read "
"and write permission on the file and return a descriptor that can't be used "
"for reading or writing. This nonstandard access mode is used by some Linux "
-"drivers to return a descriptor that is only to be used for device-specific "
+"drivers to return a descriptor that is to be used only for device-specific "
"B<ioctl>(2) operations."
msgstr ""
#. HP-UX 11.22: truncate
#. FreeBSD 4.7: truncate
#. type: Plain text
-#: build/C/man2/open.2:686
+#: build/C/man2/open.2:802
msgid ""
"The (undefined) effect of B<O_RDONLY | O_TRUNC> varies among "
"implementations. On many systems the file is actually truncated."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:690
+#: build/C/man2/open.2:806
msgid ""
"There are many infelicities in the protocol underlying NFS, affecting "
"amongst others B<O_SYNC> and B<O_NDELAY>."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:712
+#: build/C/man2/open.2:828
msgid ""
"POSIX provides for three different variants of synchronized I/O, "
"corresponding to the flags B<O_SYNC>, B<O_DSYNC>, and B<O_RSYNC>. Currently "
-"(2.6.31), Linux only implements B<O_SYNC>, but glibc maps B<O_DSYNC> and "
-"B<O_RSYNC> to the same numerical value as B<O_SYNC>. Most Linux file "
-"systems don't actually implement the POSIX B<O_SYNC> semantics, which "
-"require all metadata updates of a write to be on disk on returning to "
-"userspace, but only the B<O_DSYNC> semantics, which require only actual file "
-"data and metadata necessary to retrieve it to be on disk by the time the "
-"system call returns."
+"(2.6.31), Linux implements only B<O_SYNC>, but glibc maps B<O_DSYNC> and "
+"B<O_RSYNC> to the same numerical value as B<O_SYNC>. Most Linux filesystems "
+"don't actually implement the POSIX B<O_SYNC> semantics, which require all "
+"metadata updates of a write to be on disk on returning to user space, but "
+"only the B<O_DSYNC> semantics, which require only actual file data and "
+"metadata necessary to retrieve it to be on disk by the time the system call "
+"returns."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:720
+#: build/C/man2/open.2:836
msgid ""
"Note that B<open>() can open device special files, but B<creat>() cannot "
"create them; use B<mknod>(2) instead."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:733
+#: build/C/man2/open.2:849
msgid ""
-"On NFS file systems with UID mapping enabled, B<open>() may return a file "
+"On NFS filesystems with UID mapping enabled, B<open>() may return a file "
"descriptor but, for example, B<read>(2) requests are denied with "
"B<EACCES>. This is because the client performs B<open>() by checking the "
"permissions, but UID mapping is performed by the server upon read and write "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:752
+#: build/C/man2/open.2:868
msgid ""
"If the file is newly created, its I<st_atime>, I<st_ctime>, I<st_mtime> "
"fields (respectively, time of last access, time of last status change, and "
msgstr ""
#. type: SS
-#: build/C/man2/open.2:752
+#: build/C/man2/open.2:868
#, no-wrap
msgid "O_DIRECT"
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:769
+#: build/C/man2/open.2:885
msgid ""
"The B<O_DIRECT> flag may impose alignment restrictions on the length and "
-"address of userspace buffers and the file offset of I/Os. In Linux "
-"alignment restrictions vary by file system and kernel version and might be "
-"absent entirely. However there is currently no file system-independent "
+"address of user-space buffers and the file offset of I/Os. In Linux "
+"alignment restrictions vary by filesystem and kernel version and might be "
+"absent entirely. However there is currently no filesystem-independent "
"interface for an application to discover these restrictions for a given file "
-"or file system. Some file systems provide their own interfaces for doing "
-"so, for example the B<XFS_IOC_DIOINFO> operation in B<xfsctl>(3)."
+"or filesystem. Some filesystems provide their own interfaces for doing so, "
+"for example the B<XFS_IOC_DIOINFO> operation in B<xfsctl>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:775
+#: build/C/man2/open.2:890
msgid ""
"Under Linux 2.4, transfer sizes, and the alignment of the user buffer and "
-"the file offset must all be multiples of the logical block size of the file "
-"system. Under Linux 2.6, alignment to 512-byte boundaries suffices."
+"the file offset must all be multiples of the logical block size of the "
+"filesystem. Under Linux 2.6, alignment to 512-byte boundaries suffices."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/open.2:924
+msgid ""
+"B<O_DIRECT> I/Os should never be run concurrently with the B<fork>(2) "
+"system call, if the memory buffer is a private mapping (i.e., any mapping "
+"created with the B<mmap>(2) B<MAP_PRIVATE> flag; this includes memory "
+"allocated on the heap and statically allocated buffers). Any such I/Os, "
+"whether submitted via an asynchronous I/O interface or from another thread "
+"in the process, should be completed before B<fork>(2) is called. Failure "
+"to do so can result in data corruption and undefined behavior in parent and "
+"child processes. This restriction does not apply when the memory buffer for "
+"the B<O_DIRECT> I/Os was created using B<shmat>(2) or B<mmap>(2) with the "
+"B<MAP_SHARED> flag. Nor does this restriction apply when the memory buffer "
+"has been advised as B<MADV_DONTFORK> with B<madvise>(2), ensuring that it "
+"will not be available to the child after B<fork>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:785
+#: build/C/man2/open.2:934
msgid ""
"The B<O_DIRECT> flag was introduced in SGI IRIX, where it has alignment "
"restrictions similar to those of Linux 2.4. IRIX has also a B<fcntl>(2) "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:794
+#: build/C/man2/open.2:943
msgid ""
"B<O_DIRECT> support was added under Linux in kernel version 2.4.10. Older "
-"Linux kernels simply ignore this flag. Some file systems may not implement "
+"Linux kernels simply ignore this flag. Some filesystems may not implement "
"the flag and B<open>() will fail with B<EINVAL> if it is used."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:805
+#: build/C/man2/open.2:954
msgid ""
"Applications should avoid mixing B<O_DIRECT> and normal I/O to the same "
"file, and especially to overlapping byte regions in the same file. Even "
-"when the file system correctly handles the coherency issues in this "
+"when the filesystem correctly handles the coherency issues in this "
"situation, overall I/O throughput is likely to be slower than using either "
"mode alone. Likewise, applications should avoid mixing B<mmap>(2) of files "
"with direct I/O to the same files."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:827
+#: build/C/man2/open.2:976
msgid ""
-"The behaviour of B<O_DIRECT> with NFS will differ from local file systems. "
+"The behaviour of B<O_DIRECT> with NFS will differ from local filesystems. "
"Older kernels, or kernels configured in certain ways, may not support this "
"combination. The NFS protocol does not support passing the flag to the "
-"server, so B<O_DIRECT> I/O will only bypass the page cache on the client; "
+"server, so B<O_DIRECT> I/O will bypass the page cache only on the client; "
"the server may still cache the I/O. The client asks the server to make the "
"I/O synchronous to preserve the synchronous semantics of B<O_DIRECT>. Some "
"servers will perform poorly under these circumstances, especially if the I/O "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:834
+#: build/C/man2/open.2:983
msgid ""
"In summary, B<O_DIRECT> is a potentially powerful tool that should be used "
"with caution. It is recommended that applications treat use of B<O_DIRECT> "
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:839
+#: build/C/man2/open.2:988
msgid ""
"\"The thing that has always disturbed me about O_DIRECT is that the whole "
"interface is just stupid, and was probably designed by a deranged monkey on "
#. FIXME . Check bugzilla report on open(O_ASYNC)
#. See http://bugzilla.kernel.org/show_bug.cgi?id=5993
#. type: Plain text
-#: build/C/man2/open.2:851
+#: build/C/man2/open.2:1000
msgid ""
"Currently, it is not possible to enable signal-driven I/O by specifying "
"B<O_ASYNC> when calling B<open>(); use B<fcntl>(2) to enable this flag."
msgstr ""
#. type: Plain text
-#: build/C/man2/open.2:873
+#: build/C/man2/open.2:1022
msgid ""
"B<chmod>(2), B<chown>(2), B<close>(2), B<dup>(2), B<fcntl>(2), B<link>(2), "
"B<lseek>(2), B<mknod>(2), B<mmap>(2), B<mount>(2), B<openat>(2), B<read>(2), "
msgstr ""
#. type: TH
-#: build/C/man3/perror.3:30
+#: build/C/man3/perror.3:31
#, no-wrap
msgid "PERROR"
msgstr ""
+#. type: TH
+#: build/C/man3/perror.3:31
+#, no-wrap
+msgid "2012-04-17"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/perror.3:33
+#: build/C/man3/perror.3:34
msgid "perror - print a system error message"
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:37
+#: build/C/man3/perror.3:38
msgid "B<void perror(const char *>I<s>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:39
+#: build/C/man3/perror.3:40
msgid "B<#include E<lt>errno.hE<gt>>"
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:41
+#: build/C/man3/perror.3:42
msgid "B<const char *>I<sys_errlist>B<[];>"
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:43
+#: build/C/man3/perror.3:44
msgid "B<int >I<sys_nerr>B<;>"
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:45
+#: build/C/man3/perror.3:46
msgid "B<int >I<errno>B<;>"
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:54
+#: build/C/man3/perror.3:55
msgid "I<sys_errlist>, I<sys_nerr>: _BSD_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:67
+#: build/C/man3/perror.3:68
msgid ""
"The routine B<perror>() produces a message on the standard error output, "
"describing the last error encountered during a call to a system or library "
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:75
+#: build/C/man3/perror.3:76
msgid ""
"To be of most use, the argument string should include the name of the "
"function that incurred the error. The error number is taken from the "
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:86
+#: build/C/man3/perror.3:90
msgid ""
"The global error list I<sys_errlist>[] indexed by I<errno> can be used to "
"obtain the error message without the newline. The largest message number "
-"provided in the table is I<sys_nerr> -1. Be careful when directly accessing "
+"provided in the table is I<sys_nerr>-1. Be careful when directly accessing "
"this list because new error values may not have been added to "
-"I<sys_errlist>[]."
+"I<sys_errlist>[]. The use of I<sys_errlist>[] is nowadays deprecated."
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:107
+#: build/C/man3/perror.3:111
msgid ""
"When a system call fails, it usually returns -1 and sets the variable "
"I<errno> to a value describing what went wrong. (These values can be found "
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:120
+#: build/C/man3/perror.3:124
msgid ""
"The function B<perror>() and the external I<errno> (see B<errno>(3)) "
"conform to C89, C99, 4.3BSD, POSIX.1-2001. The externals I<sys_nerr> and "
#. .I _sys_errlist
#. are provided.
#. type: Plain text
-#: build/C/man3/perror.3:135
+#: build/C/man3/perror.3:139
msgid ""
"The externals I<sys_nerr> and I<sys_errlist> are defined by glibc, but in "
"I<E<lt>stdio.hE<gt>>."
msgstr ""
#. type: Plain text
-#: build/C/man3/perror.3:140
+#: build/C/man3/perror.3:144
msgid "B<err>(3), B<errno>(3), B<error>(3), B<strerror>(3)"
msgstr ""
msgstr ""
#. type: TH
-#: build/C/man2/pipe.2:36 build/C/man3/tmpnam.3:25
+#: build/C/man2/pipe.2:36
#, no-wrap
-msgid "2010-09-10"
+msgid "2012-02-14"
msgstr ""
#. type: Plain text
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:47
+#: build/C/man2/pipe.2:48
#, no-wrap
msgid ""
"B<#define _GNU_SOURCE> /* See feature_test_macros(7) */\n"
+"B<#include E<lt>fcntl.hE<gt>> /* Obtain O_* constant "
+"definitions */\n"
"B<#include E<lt>unistd.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:49
+#: build/C/man2/pipe.2:50
#, no-wrap
msgid "B<int pipe2(int >I<pipefd>B<[2], int >I<flags>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:65
+#: build/C/man2/pipe.2:66
msgid ""
"B<pipe>() creates a pipe, a unidirectional data channel that can be used "
"for interprocess communication. The array I<pipefd> is used to return two "
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:75
+#: build/C/man2/pipe.2:76
msgid ""
"If I<flags> is 0, then B<pipe2>() is the same as B<pipe>(). The following "
"values can be bitwise ORed in I<flags> to obtain different behavior:"
msgstr ""
#. type: TP
-#: build/C/man2/pipe.2:75
+#: build/C/man2/pipe.2:76
#, no-wrap
msgid "B<O_NONBLOCK>"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:83
+#: build/C/man2/pipe.2:84
msgid ""
"Set the B<O_NONBLOCK> file status flag on the two new open file "
"descriptions. Using this flag saves extra calls to B<fcntl>(2) to achieve "
msgstr ""
#. type: TP
-#: build/C/man2/pipe.2:83
+#: build/C/man2/pipe.2:84
#, no-wrap
msgid "B<O_CLOEXEC>"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:91
+#: build/C/man2/pipe.2:92
msgid ""
"Set the close-on-exec (B<FD_CLOEXEC>) flag on the two new file "
"descriptors. See the description of the same flag in B<open>(2) for "
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:101
+#: build/C/man2/pipe.2:102
msgid "I<pipefd> is not valid."
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:106
+#: build/C/man2/pipe.2:107
msgid "(B<pipe2>()) Invalid value in I<flags>."
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:109
+#: build/C/man2/pipe.2:110
msgid "Too many file descriptors are in use by the process."
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:117
+#: build/C/man2/pipe.2:118
msgid ""
"B<pipe2>() was added to Linux in version 2.6.27; glibc support is available "
"starting with version 2.9."
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:120
+#: build/C/man2/pipe.2:121
msgid "B<pipe>(): POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:123
+#: build/C/man2/pipe.2:124
msgid "B<pipe2>() is Linux-specific."
msgstr ""
#. fork.2 refers to this example program.
#. type: Plain text
-#: build/C/man2/pipe.2:139
+#: build/C/man2/pipe.2:140
msgid ""
"The following program creates a pipe, and then B<fork>(2)s to create a child "
"process; the child inherits a duplicate set of file descriptors that refer "
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:146
+#: build/C/man2/pipe.2:147
#, no-wrap
msgid ""
"#include E<lt>sys/wait.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:153
+#: build/C/man2/pipe.2:154
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:158
+#: build/C/man2/pipe.2:159
#, no-wrap
msgid ""
" if (argc != 2) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:163
+#: build/C/man2/pipe.2:164
#, no-wrap
msgid ""
" if (pipe(pipefd) == -1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:169
+#: build/C/man2/pipe.2:170
#, no-wrap
msgid ""
" cpid = fork();\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:172
+#: build/C/man2/pipe.2:173
#, no-wrap
msgid ""
" if (cpid == 0) { /* Child reads from pipe */\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:175
+#: build/C/man2/pipe.2:176
#, no-wrap
msgid ""
" while (read(pipefd[0], &buf, 1) E<gt> 0)\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:179
+#: build/C/man2/pipe.2:180
#, no-wrap
msgid ""
" write(STDOUT_FILENO, \"\\en\", 1);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:188
+#: build/C/man2/pipe.2:189
#, no-wrap
msgid ""
" } else { /* Parent writes argv[1] to pipe */\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/pipe.2:196
+#: build/C/man2/pipe.2:197
msgid ""
"B<fork>(2), B<read>(2), B<socketpair>(2), B<write>(2), B<popen>(3), "
"B<pipe>(7)"
msgstr ""
#. type: TH
-#: build/C/man3/popen.3:38
+#: build/C/man3/popen.3:40
#, no-wrap
msgid "POPEN"
msgstr ""
-#. type: TH
-#: build/C/man3/popen.3:38
-#, no-wrap
-msgid "2010-02-03"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/popen.3:41
+#: build/C/man3/popen.3:43
msgid "popen, pclose - pipe stream to or from a process"
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:46
+#: build/C/man3/popen.3:48
#, no-wrap
msgid "B<FILE *popen(const char *>I<command>B<, const char *>I<type>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:48
+#: build/C/man3/popen.3:50
#, no-wrap
msgid "B<int pclose(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:58
+#: build/C/man3/popen.3:60
msgid "B<popen>(), B<pclose>():"
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:60
+#: build/C/man3/popen.3:62
msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 2 || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:71
+#: build/C/man3/popen.3:73
msgid ""
"The B<popen>() function opens a process by creating a pipe, forking, and "
"invoking the shell. Since a pipe is by definition unidirectional, the "
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:95
+#: build/C/man3/popen.3:97
msgid ""
"The I<command> argument is a pointer to a null-terminated string containing "
"a shell command line. This command is passed to I</bin/sh> using the B<-c> "
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:111
+#: build/C/man3/popen.3:113
msgid ""
"The return value from B<popen>() is a normal standard I/O stream in all "
"respects save that it must be closed with B<pclose>() rather than "
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:115
+#: build/C/man3/popen.3:117
msgid "Note that output B<popen>() streams are fully buffered by default."
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:121
+#: build/C/man3/popen.3:123
msgid ""
"The B<pclose>() function waits for the associated process to terminate and "
"returns the exit status of the command as returned by B<wait4>(2)."
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:129
+#: build/C/man3/popen.3:131
msgid ""
"The B<popen>() function returns NULL if the B<fork>(2) or B<pipe>(2) "
"calls fail, or if it cannot allocate memory."
#. .I stream
#. already "pclose()d", or if
#. type: Plain text
-#: build/C/man3/popen.3:141
+#: build/C/man3/popen.3:146
msgid ""
"The B<pclose>() function returns -1 if B<wait4>(2) returns an error, or "
-"some other error is detected."
+"some other error is detected. In the event of an error, these functions set "
+"I<errno> to indicate the cause of the error."
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:160
+#: build/C/man3/popen.3:165
msgid ""
"The B<popen>() function does not set I<errno> if memory allocation fails. "
"If the underlying B<fork>(2) or B<pipe>(2) fails, I<errno> is set "
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:167
+#: build/C/man3/popen.3:172
msgid ""
"If B<pclose>() cannot obtain the child status, I<errno> is set to "
"B<ECHILD>."
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:173
+#: build/C/man3/popen.3:178
msgid "The \\(aqe\\(aq value for I<type> is a Linux extension."
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:186
+#: build/C/man3/popen.3:191
msgid ""
"Since the standard input of a command opened for reading shares its seek "
"offset with the process that called B<popen>(), if the original process has "
#. .BR pclose ()
#. function appeared in Version 7 AT&T UNIX.
#. type: Plain text
-#: build/C/man3/popen.3:196
+#: build/C/man3/popen.3:201
msgid ""
"Failure to execute the shell is indistinguishable from the shell's failure "
"to execute command, or an immediate exit of the command. The only hint is "
msgstr ""
#. type: Plain text
-#: build/C/man3/popen.3:206
+#: build/C/man3/popen.3:211
msgid ""
"B<sh>(1), B<fork>(2), B<pipe>(2), B<wait4>(2), B<fclose>(3), B<fflush>(3), "
"B<fopen>(3), B<stdio>(3), B<system>(3)"
msgid "PRINTF"
msgstr ""
+#. type: TH
+#: build/C/man3/printf.3:34
+#, no-wrap
+msgid "2013-09-04"
+msgstr ""
+
#. type: Plain text
#: build/C/man3/printf.3:38
msgid ""
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:74 build/C/man3/scanf.3:83
+#: build/C/man3/printf.3:74 build/C/man3/scanf.3:85
msgid "or I<cc -std=c99>"
msgstr ""
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:440
+#: build/C/man3/printf.3:441
msgid ""
"An optional precision, in the form of a period (\\(aq.\\(aq) followed by an "
"optional decimal digit string. Instead of a decimal digit string one may "
"write \"*\" or \"*m$\" (for some decimal integer m) to specify that the "
"precision is given in the next argument, or in the m-th argument, "
"respectively, which must be of type I<int>. If the precision is given as "
-"just \\(aq.\\(aq, or the precision is negative, the precision is taken to be "
-"zero. This gives the minimum number of digits to appear for B<d>, B<i>, "
-"B<o>, B<u>, B<x>, and B<X> conversions, the number of digits to appear after "
-"the radix character for B<a>, B<A>, B<e>, B<E>, B<f>, and B<F> conversions, "
-"the maximum number of significant digits for B<g> and B<G> conversions, or "
-"the maximum number of characters to be printed from a string for B<s> and "
-"B<S> conversions."
+"just \\(aq.\\(aq, the precision is taken to be zero. A negative precision "
+"is taken as if the precision were omitted. This gives the minimum number of "
+"digits to appear for B<d>, B<i>, B<o>, B<u>, B<x>, and B<X> conversions, the "
+"number of digits to appear after the radix character for B<a>, B<A>, B<e>, "
+"B<E>, B<f>, and B<F> conversions, the maximum number of significant digits "
+"for B<g> and B<G> conversions, or the maximum number of characters to be "
+"printed from a string for B<s> and B<S> conversions."
msgstr ""
#. type: SS
-#: build/C/man3/printf.3:440
+#: build/C/man3/printf.3:441
#, no-wrap
msgid "The length modifier"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:450
+#: build/C/man3/printf.3:451
msgid ""
"Here, \"integer conversion\" stands for B<d>, B<i>, B<o>, B<u>, B<x>, or "
"B<X> conversion."
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:450 build/C/man3/scanf.3:291
+#: build/C/man3/printf.3:451 build/C/man3/scanf.3:294
#, no-wrap
msgid "B<hh>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:461
+#: build/C/man3/printf.3:462
msgid ""
"A following integer conversion corresponds to a I<signed char> or I<unsigned "
"char> argument, or a following B<n> conversion corresponds to a pointer to a "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:461 build/C/man3/scanf.3:281
+#: build/C/man3/printf.3:462 build/C/man3/scanf.3:284
#, no-wrap
msgid "B<h>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:472
+#: build/C/man3/printf.3:473
msgid ""
"A following integer conversion corresponds to a I<short int> or I<unsigned "
"short int> argument, or a following B<n> conversion corresponds to a pointer "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:472 build/C/man3/scanf.3:308
+#: build/C/man3/printf.3:473 build/C/man3/scanf.3:311
#, no-wrap
msgid "B<l>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:491
+#: build/C/man3/printf.3:492
msgid ""
"(ell) A following integer conversion corresponds to a I<long int> or "
"I<unsigned long int> argument, or a following B<n> conversion corresponds to "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:491
+#: build/C/man3/printf.3:492
#, no-wrap
msgid "B<ll>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:503
+#: build/C/man3/printf.3:504
msgid ""
"(ell-ell). A following integer conversion corresponds to a I<long long int> "
"or I<unsigned long long int> argument, or a following B<n> conversion "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:503 build/C/man3/scanf.3:335
+#: build/C/man3/printf.3:504 build/C/man3/scanf.3:338
#, no-wrap
msgid "B<L>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:519
+#: build/C/man3/printf.3:520
msgid ""
"A following B<a>, B<A>, B<e>, B<E>, B<f>, B<F>, B<g>, or B<G> conversion "
"corresponds to a I<long double> argument. (C99 allows %LF, but SUSv2 does "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:519 build/C/man3/scanf.3:351
+#: build/C/man3/printf.3:520 build/C/man3/scanf.3:354
#, no-wrap
msgid "B<q>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:525
+#: build/C/man3/printf.3:526
msgid ""
"(\"quad\". 4.4BSD and Linux libc5 only. Don't use.) This is a synonym for "
"B<ll>."
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:525 build/C/man3/scanf.3:299
+#: build/C/man3/printf.3:526 build/C/man3/scanf.3:302
#, no-wrap
msgid "B<j>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:532
+#: build/C/man3/printf.3:533
msgid ""
"A following integer conversion corresponds to an I<intmax_t> or I<uintmax_t> "
"argument."
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:532 build/C/man3/scanf.3:363
+#: build/C/man3/printf.3:533 build/C/man3/scanf.3:366
#, no-wrap
msgid "B<z>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:543
+#: build/C/man3/printf.3:544
msgid ""
"A following integer conversion corresponds to a I<size_t> or I<ssize_t> "
"argument. (Linux libc5 has B<Z> with this meaning. Don't use it.)"
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:543 build/C/man3/scanf.3:356
+#: build/C/man3/printf.3:544 build/C/man3/scanf.3:359
#, no-wrap
msgid "B<t>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:548
+#: build/C/man3/printf.3:549
msgid "A following integer conversion corresponds to a I<ptrdiff_t> argument."
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:577
+#: build/C/man3/printf.3:578
msgid ""
-"The SUSv2 only knows about the length modifiers B<h> (in B<hd>, B<hi>, "
+"The SUSv2 knows about only the length modifiers B<h> (in B<hd>, B<hi>, "
"B<ho>, B<hx>, B<hX>, B<hn>) and B<l> (in B<ld>, B<li>, B<lo>, B<lx>, B<lX>, "
"B<ln>, B<lc>, B<ls>) and B<L> (in B<Le>, B<LE>, B<Lf>, B<Lg>, B<LG>)."
msgstr ""
#. type: SS
-#: build/C/man3/printf.3:577
+#: build/C/man3/printf.3:578
#, no-wrap
msgid "The conversion specifier"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:580
+#: build/C/man3/printf.3:581
msgid ""
"A character that specifies the type of conversion to be applied. The "
"conversion specifiers and their meanings are:"
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:580
+#: build/C/man3/printf.3:581
#, no-wrap
msgid "B<d>, B<i>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:590
+#: build/C/man3/printf.3:591
msgid ""
"The I<int> argument is converted to signed decimal notation. The precision, "
"if any, gives the minimum number of digits that must appear; if the "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:590
+#: build/C/man3/printf.3:591
#, no-wrap
msgid "B<o>, B<u>, B<x>, B<X>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:617
+#: build/C/man3/printf.3:618
msgid ""
"The I<unsigned int> argument is converted to unsigned octal (B<o>), unsigned "
"decimal (B<u>), or unsigned hexadecimal (B<x> and B<X>) notation. The "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:617
+#: build/C/man3/printf.3:618
#, no-wrap
msgid "B<e>, B<E>"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:622
-msgid "The I<double> argument is rounded and converted in the style"
-msgstr ""
-
-#. type: Plain text
#: build/C/man3/printf.3:637
msgid ""
-"[-]dB<\\&.>dddB<e>\\*(Pmdd where there is one digit before the decimal-point "
+"The I<double> argument is rounded and converted in the style "
+"[-]dB<\\&.>dddB<e>\\(+-dd where there is one digit before the decimal-point "
"character and the number of digits after it is equal to the precision; if "
"the precision is missing, it is taken as 6; if the precision is zero, no "
"decimal-point character appears. An B<E> conversion uses the letter B<E> "
msgid ""
"(C99; not in SUSv2) For B<a> conversion, the I<double> argument is converted "
"to hexadecimal notation (using the letters abcdef) in the style "
-"[-]B<0x>hB<\\&.>hhhhB<p>\\
*(Pmd; for B<A> conversion the prefix B<0X>, the "
+"[-]B<0x>hB<\\&.>hhhhB<p>\\
(+-; for B<A> conversion the prefix B<0X>, the "
"letters ABCDEF, and the exponent separator B<P> is used. There is one "
"hexadecimal digit before the decimal point, and the number of digits after "
"it is equal to the precision. The default precision suffices for an exact "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:708 build/C/man3/scanf.3:456 build/C/man3/wprintf.3:132
+#: build/C/man3/printf.3:708 build/C/man3/scanf.3:459 build/C/man3/wprintf.3:151
#, no-wrap
msgid "B<c>"
msgstr ""
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:726 build/C/man3/scanf.3:448 build/C/man3/wprintf.3:146
+#: build/C/man3/printf.3:726 build/C/man3/scanf.3:451 build/C/man3/wprintf.3:165
#, no-wrap
msgid "B<s>"
msgstr ""
#. type: Plain text
#: build/C/man3/printf.3:741
msgid ""
-"If no B<l> modifier is present: The I<const char *> argument is expected to "
-"be a pointer to an array of character type (pointer to a string). "
+"If no B<l> modifier is present: The I<const char\\ *> argument is expected "
+"to be a pointer to an array of character type (pointer to a string). "
"Characters from the array are written up to (but not including) a "
"terminating null byte (\\(aq\\e0\\(aq); if a precision is specified, no more "
"than the number specified are written. If a precision is given, no null "
#. type: Plain text
#: build/C/man3/printf.3:768
msgid ""
-"If an B<l> modifier is present: The I<const wchar_t *> argument is expected "
-"to be a pointer to an array of wide characters. Wide characters from the "
-"array are converted to multibyte characters (each by a call to the "
+"If an B<l> modifier is present: The I<const wchar_t\\ *> argument is "
+"expected to be a pointer to an array of wide characters. Wide characters "
+"from the array are converted to multibyte characters (each by a call to the "
"B<wcrtomb>(3) function, with a conversion state starting in the initial "
"state before the first wide character), up to and including a terminating "
"null wide character. The resulting multibyte characters are written up to "
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:780 build/C/man3/scanf.3:500
+#: build/C/man3/printf.3:780 build/C/man3/scanf.3:502
#, no-wrap
msgid "B<p>"
msgstr ""
#. type: Plain text
#: build/C/man3/printf.3:788
msgid ""
-"The I<void *> pointer argument is printed in hexadecimal (as if by B<%#x> or "
-"B<%#lx>)."
+"The I<void\\ *> pointer argument is printed in hexadecimal (as if by B<%#x> "
+"or B<%#lx>)."
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:788 build/C/man3/scanf.3:508
+#: build/C/man3/printf.3:788 build/C/man3/scanf.3:510
#, no-wrap
msgid "B<n>"
msgstr ""
#: build/C/man3/printf.3:795
msgid ""
"The number of characters written so far is stored into the integer indicated "
-"by the I<int *> (or variant) pointer argument. No argument is converted."
+"by the I<int\\ *> (or variant) pointer argument. No argument is converted."
msgstr ""
#. type: TP
msgstr ""
#. type: TP
-#: build/C/man3/printf.3:801 build/C/man3/scanf.3:374
+#: build/C/man3/printf.3:801 build/C/man3/scanf.3:377
#, no-wrap
msgid "B<%>"
msgstr ""
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:977
-msgid "To print \\*(Pi to five decimal places:"
+#: build/C/man3/printf.3:978
+msgid "To print I<Pi> to five decimal places:"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:983
+#: build/C/man3/printf.3:984
#, no-wrap
msgid ""
"#include E<lt>math.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:992
+#: build/C/man3/printf.3:993
msgid ""
"To print a date and time in the form \"Sunday, July 3, 10:02\", where "
"I<weekday> and I<month> are pointers to strings:"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:998
+#: build/C/man3/printf.3:999
#, no-wrap
msgid ""
"#include E<lt>stdio.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1004
+#: build/C/man3/printf.3:1005
msgid ""
"Many countries use the day-month-year order. Hence, an internationalized "
"version must be able to print the arguments in an order specified by the "
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1010
+#: build/C/man3/printf.3:1011
#, no-wrap
msgid ""
"#include E<lt>stdio.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1017
+#: build/C/man3/printf.3:1018
msgid ""
"where I<format> depends on locale, and may permute the arguments. With the "
"value:"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1021
+#: build/C/man3/printf.3:1022
#, no-wrap
msgid "\"%1$s, %3$d. %2$s, %4$d:%5$.2d\\en\"\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1025
+#: build/C/man3/printf.3:1026
msgid "one might obtain \"Sonntag, 3. Juli, 10:02\"."
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1028
+#: build/C/man3/printf.3:1029
msgid ""
"To allocate a sufficiently large string and print into it (code correct for "
"both glibc 2.0 and glibc 2.1):"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1033
+#: build/C/man3/printf.3:1032
+msgid ""
+"If truncation occurs in glibc versions prior to 2.0.6, this is treated as an "
+"error instead of being handled gracefully."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/printf.3:1037
#, no-wrap
msgid ""
"#include E<lt>stdio.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1041
+#: build/C/man3/printf.3:1045
#, no-wrap
msgid ""
"char *\n"
"make_message(const char *fmt, ...)\n"
"{\n"
" int n;\n"
-" int size = 100; /* Guess we need no more than 100 bytes. */\n"
+" int size = 100; /* Guess we need no more than 100 bytes */\n"
" char *p, *np;\n"
" va_list ap;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1044
+#: build/C/man3/printf.3:1048
#, no-wrap
msgid ""
" if ((p = malloc(size)) == NULL)\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1046
+#: build/C/man3/printf.3:1050
#, no-wrap
msgid " while (1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1048
+#: build/C/man3/printf.3:1052
#, no-wrap
-msgid " /* Try to print in the allocated space. */\n"
+msgid " /* Try to print in the allocated space */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1052
+#: build/C/man3/printf.3:1056
#, no-wrap
msgid ""
" va_start(ap, fmt);\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1054
+#: build/C/man3/printf.3:1058
#, no-wrap
-msgid " /* If that worked, return the string. */\n"
+msgid " /* Check error code */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1057
+#: build/C/man3/printf.3:1061
#, no-wrap
msgid ""
-" if (n E<gt> -1 && n E<lt> size)\n"
-" return p;\n"
+" if (n E<lt> 0)\n"
+" return NULL;\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1059
+#: build/C/man3/printf.3:1063
#, no-wrap
-msgid " /* Else try again with more space. */\n"
+msgid " /* If that worked, return the string */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1064
+#: build/C/man3/printf.3:1066
#, no-wrap
msgid ""
-" if (n E<gt> -1) /* glibc 2.1 */\n"
-" size = n+1; /* precisely what is needed */\n"
-" else /* glibc 2.0 */\n"
-" size *= 2; /* twice the old size */\n"
+" if (n E<lt> size)\n"
+" return p;\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/printf.3:1068
+#, no-wrap
+msgid " /* Else try again with more space */\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/printf.3:1070
+#, no-wrap
+msgid " size = n + 1; /* Precisely what is needed */\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1073
+#: build/C/man3/printf.3:1080
#, no-wrap
msgid ""
" if ((np = realloc (p, size)) == NULL) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/printf.3:1083
+#: build/C/man3/printf.3:1090
msgid ""
"B<printf>(1), B<asprintf>(3), B<dprintf>(3), B<scanf>(3), B<setlocale>(3), "
"B<wcrtomb>(3), B<wprintf>(3), B<locale>(5)"
msgstr ""
#. type: TH
-#: build/C/man3/puts.3:24
+#: build/C/man3/puts.3:26
#, no-wrap
msgid "PUTS"
msgstr ""
+#. type: TH
+#: build/C/man3/puts.3:26
+#, no-wrap
+msgid "2011-09-28"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/puts.3:27
+#: build/C/man3/puts.3:29
msgid "fputc, fputs, putc, putchar, puts - output of characters and strings"
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:32
+#: build/C/man3/puts.3:34
#, no-wrap
msgid "B<int fputc(int >I<c>B<, FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:34
+#: build/C/man3/puts.3:36
#, no-wrap
msgid "B<int fputs(const char *>I<s>B<, FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:36
+#: build/C/man3/puts.3:38
#, no-wrap
msgid "B<int putc(int >I<c>B<, FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:38
+#: build/C/man3/puts.3:40
#, no-wrap
msgid "B<int putchar(int >I<c>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:40
+#: build/C/man3/puts.3:42
#, no-wrap
msgid "B<int puts(const char *>I<s>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:49
+#: build/C/man3/puts.3:51
msgid ""
"B<fputc>() writes the character I<c>, cast to an I<unsigned char>, to "
"I<stream>."
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:56
+#: build/C/man3/puts.3:58
msgid ""
"B<fputs>() writes the string I<s> to I<stream>, without its terminating "
"null byte (\\(aq\\e0\\(aq)."
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:63
+#: build/C/man3/puts.3:65
msgid ""
"B<putc>() is equivalent to B<fputc>() except that it may be implemented as "
"a macro which evaluates I<stream> more than once."
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:67
+#: build/C/man3/puts.3:69
msgid "B<putchar(>I<c>B<);> is equivalent to B<putc(>I<c>B<,>I<stdout>B<).>"
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:74
+#: build/C/man3/puts.3:76
msgid "B<puts>() writes the string I<s> and a trailing newline to I<stdout>."
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:79
+#: build/C/man3/puts.3:81
msgid ""
"Calls to the functions described here can be mixed with each other and with "
"calls to other output functions from the I<stdio> library for the same "
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:94
+#: build/C/man3/puts.3:96
msgid ""
"B<fputc>(), B<putc>() and B<putchar>() return the character written as an "
"I<unsigned char> cast to an I<int> or B<EOF> on error."
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:101
+#: build/C/man3/puts.3:103
msgid ""
"B<puts>() and B<fputs>() return a nonnegative number on success, or B<EOF> "
"on error."
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:110
+#: build/C/man3/puts.3:112
msgid ""
"It is not advisable to mix calls to output functions from the I<stdio> "
"library with low-level calls to B<write>(2) for the file descriptor "
msgstr ""
#. type: Plain text
-#: build/C/man3/puts.3:122
+#: build/C/man3/puts.3:124
msgid ""
"B<write>(2), B<ferror>(3), B<fopen>(3), B<fputwc>(3), B<fputws>(3), "
"B<fseek>(3), B<fwrite>(3), B<gets>(3), B<putwchar>(3), B<scanf>(3), "
msgid "READ"
msgstr ""
+#. type: TH
+#: build/C/man2/read.2:35
+#, no-wrap
+msgid "2013-02-12"
+msgstr ""
+
#. type: Plain text
#: build/C/man2/read.2:38
msgid "read - read from a file descriptor"
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:63
+#: build/C/man2/read.2:60
+msgid ""
+"On files that support seeking, the read operation commences at the current "
+"file offset, and the file offset is incremented by the number of bytes "
+"read. If the current file offset is at or past the end of file, no bytes "
+"are read, and B<read>() returns zero."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/read.2:75
msgid ""
-"If I<count> is zero, B<read>() returns zero and has no other results. If "
-"I<count> is greater than B<SSIZE_MAX>, the result is unspecified."
+"If I<count> is zero, B<read>() I<may> detect the errors described below. "
+"In the absence of any errors, or if B<read>() does not check for errors, a "
+"B<read>() with a I<count> of 0 returns zero and has no other effects."
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:77
+#: build/C/man2/read.2:81
+msgid "If I<count> is greater than B<SSIZE_MAX>, the result is unspecified."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/read.2:95
msgid ""
"On success, the number of bytes read is returned (zero indicates end of "
"file), and the file position is advanced by this number. It is not an error "
msgstr ""
#. type: TP
-#: build/C/man2/read.2:78 build/C/man3/scanf.3:546 build/C/man2/write.2:108
+#: build/C/man2/read.2:96 build/C/man3/scanf.3:548 build/C/man2/write.2:108
#, no-wrap
msgid "B<EAGAIN>"
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:85
+#: build/C/man2/read.2:103
msgid ""
"The file descriptor I<fd> refers to a file other than a socket and has been "
"marked nonblocking (B<O_NONBLOCK>), and the read would block."
msgstr ""
#. type: TP
-#: build/C/man2/read.2:85 build/C/man2/write.2:115
+#: build/C/man2/read.2:103 build/C/man2/write.2:115
#, no-wrap
msgid "B<EAGAIN> or B<EWOULDBLOCK>"
msgstr ""
#. Actually EAGAIN on Linux
#. type: Plain text
-#: build/C/man2/read.2:96
+#: build/C/man2/read.2:114
msgid ""
"The file descriptor I<fd> refers to a socket and has been marked nonblocking "
"(B<O_NONBLOCK>), and the read would block. POSIX.1-2001 allows either error "
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:100
+#: build/C/man2/read.2:118
msgid "I<fd> is not a valid file descriptor or is not open for reading."
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:104 build/C/man2/write.2:139
+#: build/C/man2/read.2:122 build/C/man2/write.2:145
msgid "I<buf> is outside your accessible address space."
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:108
+#: build/C/man2/read.2:126
msgid ""
"The call was interrupted by a signal before any data was read; see "
"B<signal>(7)."
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:119
+#: build/C/man2/read.2:137
msgid ""
"I<fd> is attached to an object which is unsuitable for reading; or the file "
"was opened with the B<O_DIRECT> flag, and either the address specified in "
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:129
+#: build/C/man2/read.2:147
msgid ""
"I<fd> was created via a call to B<timerfd_create>(2) and the wrong size "
"buffer was given to B<read>(); see B<timerfd_create>(2) for further "
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:140
+#: build/C/man2/read.2:158
msgid ""
"I/O error. This will happen for example when the process is in a background "
-"process group, tries to read from its controlling tty, and either it is "
+"process group, tries to read from its controlling terminal, and either it is "
"ignoring or blocking B<SIGTTIN> or its process group is orphaned. It may "
"also occur when there is a low-level I/O error while reading from a disk or "
"tape."
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:144
+#: build/C/man2/read.2:162
msgid "I<fd> refers to a directory."
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:155
+#: build/C/man2/read.2:173
msgid ""
"Other errors may occur, depending on the object connected to I<fd>. POSIX "
"allows a B<read>() that is interrupted after reading some data to return -1 "
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:169
+#: build/C/man2/read.2:187
msgid ""
-"On NFS file systems, reading small amounts of data will only update the "
-"timestamp the first time, subsequent calls may not do so. This is caused by "
+"On NFS filesystems, reading small amounts of data will update the timestamp "
+"only the first time, subsequent calls may not do so. This is caused by "
"client side attribute caching, because most if not all NFS clients leave "
"st_atime (last file access time) updates to the server and client side "
"reads satisfied from the client's cache will not cause st_atime updates on "
msgstr ""
#. type: Plain text
-#: build/C/man2/read.2:178
-msgid ""
-"Many file systems and disks were considered to be fast enough that the "
-"implementation of B<O_NONBLOCK> was deemed unnecessary. So, B<O_NONBLOCK> "
-"may not be available on files and/or disks."
-msgstr ""
-
-#. type: Plain text
-#: build/C/man2/read.2:191
+#: build/C/man2/read.2:200
msgid ""
"B<close>(2), B<fcntl>(2), B<ioctl>(2), B<lseek>(2), B<open>(2), B<pread>(2), "
"B<readdir>(2), B<readlink>(2), B<readv>(2), B<select>(2), B<write>(2), "
msgstr ""
#. type: TH
-#: build/C/man2/readlink.2:41
+#: build/C/man2/readlink.2:43
#, no-wrap
msgid "READLINK"
msgstr ""
#. type: TH
-#: build/C/man2/readlink.2:41
+#: build/C/man2/readlink.2:43
#, no-wrap
-msgid "2011-09-20"
+msgid "2013-07-18"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:44
+#: build/C/man2/readlink.2:46
msgid "readlink - read value of a symbolic link"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:48
+#: build/C/man2/readlink.2:50
msgid ""
"B<ssize_t readlink(const char *>I<path>B<, char *>I<buf>B<, size_t "
">I<bufsiz>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:56
+#: build/C/man2/readlink.2:58
msgid "B<readlink>():"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:59 build/C/man2/symlink.2:50
+#: build/C/man2/readlink.2:61 build/C/man2/symlink.2:50
msgid ""
"_BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ "
"_XOPEN_SOURCE_EXTENDED || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:75
+#: build/C/man2/readlink.2:77
msgid ""
"B<readlink>() places the contents of the symbolic link I<path> in the "
"buffer I<buf>, which has size I<bufsiz>. B<readlink>() does not append a "
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:83
+#: build/C/man2/readlink.2:85
msgid ""
"On success, B<readlink>() returns the number of bytes placed in I<buf>. On "
"error, -1 is returned and I<errno> is set to indicate the error."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:89
+#: build/C/man2/readlink.2:91
msgid ""
"Search permission is denied for a component of the path prefix. (See also "
"B<path_resolution>(7).)"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:93
+#: build/C/man2/readlink.2:95
msgid "I<buf> extends outside the process's allocated address space."
msgstr ""
#. See: http://thread.gmane.org/gmane.linux.man/380
#. Subject: [patch 0/3] [RFC] kernel/glibc mismatch of "readlink" syscall?
#. type: Plain text
-#: build/C/man2/readlink.2:102
+#: build/C/man2/readlink.2:104
msgid "I<bufsiz> is not positive."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:105
+#: build/C/man2/readlink.2:107
msgid "The named file is not a symbolic link."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:108
-msgid "An I/O error occurred while reading from the file system."
+#: build/C/man2/readlink.2:110
+msgid "An I/O error occurred while reading from the filesystem."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:111
+#: build/C/man2/readlink.2:113
msgid "Too many symbolic links were encountered in translating the pathname."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:114
+#: build/C/man2/readlink.2:116
msgid "A pathname, or a component of a pathname, was too long."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:117
+#: build/C/man2/readlink.2:119
msgid "The named file does not exist."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:123
+#: build/C/man2/readlink.2:125
msgid "A component of the path prefix is not a directory."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:128
+#: build/C/man2/readlink.2:130
msgid "4.4BSD (B<readlink>() first appeared in 4.2BSD), POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:136
+#: build/C/man2/readlink.2:138
msgid ""
"In versions of glibc up to and including glibc 2.4, the return type of "
"B<readlink>() was declared as I<int>. Nowadays, the return type is "
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:155
+#: build/C/man2/readlink.2:157
msgid ""
"Using a statically sized buffer might not provide enough room for the "
"symbolic link contents. The required size for the buffer can be obtained "
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:161
+#: build/C/man2/readlink.2:163
msgid ""
"The following program allocates the buffer needed by B<readlink>() "
"dynamically from the information provided by B<lstat>(), making sure there's "
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:168
+#: build/C/man2/readlink.2:170
#, no-wrap
msgid ""
"#include E<lt>sys/types.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:175
+#: build/C/man2/readlink.2:177
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:180
+#: build/C/man2/readlink.2:182
#, no-wrap
msgid ""
" if (argc != 2) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:185
+#: build/C/man2/readlink.2:187
#, no-wrap
msgid ""
" if (lstat(argv[1], &sb) == -1) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:191
+#: build/C/man2/readlink.2:193
#, no-wrap
msgid ""
" linkname = malloc(sb.st_size + 1);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:193
+#: build/C/man2/readlink.2:195
#, no-wrap
msgid " r = readlink(argv[1], linkname, sb.st_size + 1);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:198
+#: build/C/man2/readlink.2:200
#, no-wrap
msgid ""
-" if (r E<lt> 0) {\n"
+" if (r == -1) {\n"
" perror(\"lstat\");\n"
" exit(EXIT_FAILURE);\n"
" }\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:204
+#: build/C/man2/readlink.2:206
#, no-wrap
msgid ""
" if (r E<gt> sb.st_size) {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:206
+#: build/C/man2/readlink.2:208
#, no-wrap
-msgid " linkname[sb.st_size] = \\(aq\\e0\\(aq;\n"
+msgid " linkname[r] = \\(aq\\e0\\(aq;\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:208
+#: build/C/man2/readlink.2:210
#, no-wrap
msgid ""
" printf(\"\\(aq%s\\(aq points to \\(aq%s\\(aq\\en\", argv[1], "
msgstr ""
#. type: Plain text
-#: build/C/man2/readlink.2:220
+#: build/C/man2/readlink.2:222
msgid ""
"B<readlink>(1), B<lstat>(2), B<readlinkat>(2), B<stat>(2), B<symlink>(2), "
"B<path_resolution>(7), B<symlink>(7)"
msgstr ""
#. type: TH
-#: build/C/man2/readv.2:30
+#: build/C/man2/readv.2:32
#, no-wrap
msgid "READV"
msgstr ""
#. type: TH
-#: build/C/man2/readv.2:30
+#: build/C/man2/readv.2:32
#, no-wrap
msgid "2010-11-17"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:33
+#: build/C/man2/readv.2:35
msgid "readv, writev, preadv, pwritev - read or write data into multiple buffers"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:36
+#: build/C/man2/readv.2:38
#, no-wrap
msgid "B<#include E<lt>sys/uio.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:38
+#: build/C/man2/readv.2:40
#, no-wrap
msgid ""
"B<ssize_t readv(int >I<fd>B<, const struct iovec *>I<iov>B<, int "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:40
+#: build/C/man2/readv.2:42
#, no-wrap
msgid ""
"B<ssize_t writev(int >I<fd>B<, const struct iovec *>I<iov>B<, int "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:43
+#: build/C/man2/readv.2:45
#, no-wrap
msgid ""
"B<ssize_t preadv(int >I<fd>B<, const struct iovec *>I<iov>B<, int "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:46
+#: build/C/man2/readv.2:48
#, no-wrap
msgid ""
"B<ssize_t pwritev(int >I<fd>B<, const struct iovec *>I<iov>B<, int "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:56
+#: build/C/man2/readv.2:58
msgid "B<preadv>(), B<pwritev>(): _BSD_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:66
+#: build/C/man2/readv.2:68
msgid ""
"The B<readv>() system call reads I<iovcnt> buffers from the file associated "
"with the file descriptor I<fd> into the buffers described by I<iov> "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:76
+#: build/C/man2/readv.2:78
msgid ""
"The B<writev>() system call writes I<iovcnt> buffers of data described by "
"I<iov> to the file associated with the file descriptor I<fd> (\"gather "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:85
+#: build/C/man2/readv.2:87
msgid ""
"The pointer I<iov> points to an array of I<iovec> structures, defined in "
"I<E<lt>sys/uio.hE<gt>> as:"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:93
+#: build/C/man2/readv.2:95
#, no-wrap
msgid ""
"struct iovec {\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:101
+#: build/C/man2/readv.2:103
msgid ""
"The B<readv>() system call works just like B<read>(2) except that multiple "
"buffers are filled."
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:107
+#: build/C/man2/readv.2:109
msgid ""
"The B<writev>() system call works just like B<write>(2) except that "
"multiple buffers are written out."
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:126
+#: build/C/man2/readv.2:128
msgid ""
"Buffers are processed in array order. This means that B<readv>() "
"completely fills I<iov>[0] before proceeding to I<iov>[1], and so on. (If "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:144
+#: build/C/man2/readv.2:146
msgid ""
"The data transfers performed by B<readv>() and B<writev>() are atomic: the "
"data written by B<writev>() is written as a single block that is not "
msgstr ""
#. type: SS
-#: build/C/man2/readv.2:144
+#: build/C/man2/readv.2:146
#, no-wrap
msgid "preadv() and pwritev()"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:157
+#: build/C/man2/readv.2:159
msgid ""
"The B<preadv>() system call combines the functionality of B<readv>() and "
"B<pread>(2). It performs the same task as B<readv>(), but adds a fourth "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:170
+#: build/C/man2/readv.2:172
msgid ""
"The B<pwritev>() system call combines the functionality of B<writev>() and "
"B<pwrite>(2). It performs the same task as B<writev>(), but adds a fourth "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:175
+#: build/C/man2/readv.2:177
msgid ""
"The file offset is not changed by these system calls. The file referred to "
"by I<fd> must be capable of seeking."
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:186
+#: build/C/man2/readv.2:188
msgid ""
"On success, B<readv>() and B<preadv>() return the number of bytes read; "
"B<writev>() and B<pwritev>() return the number of bytes written. On "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:198
+#: build/C/man2/readv.2:200
msgid ""
"The errors are as given for B<read>(2) and B<write>(2). Furthermore, "
"B<preadv>() and B<pwritev>() can also fail for the same reasons as "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:207
+#: build/C/man2/readv.2:209
msgid ""
"The sum of the I<iov_len> values overflows an I<ssize_t> value. Or, the "
"vector count I<iovcnt> is less than zero or greater than the permitted "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:212
+#: build/C/man2/readv.2:214
msgid ""
"B<preadv>() and B<pwritev>() first appeared in Linux 2.6.30; library "
"support was added in glibc 2.10."
#. The readv/writev system calls were buggy before Linux 1.3.40.
#. (Says release.libc.)
#. type: Plain text
-#: build/C/man2/readv.2:220
+#: build/C/man2/readv.2:222
msgid ""
"B<readv>(), B<writev>(): 4.4BSD (these system calls first appeared in "
"4.2BSD), POSIX.1-2001. Linux libc5 used I<size_t> as the type of the "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:224
+#: build/C/man2/readv.2:226
msgid "B<preadv>(), B<pwritev>(): nonstandard, but present also on the modern BSDs."
msgstr ""
#. type: SS
-#: build/C/man2/readv.2:225
+#: build/C/man2/readv.2:227
#, no-wrap
-msgid "Linux Notes"
+msgid "Linux notes"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:256
+#: build/C/man2/readv.2:258
msgid ""
"POSIX.1-2001 allows an implementation to place a limit on the number of "
"items that can be passed in I<iov>. An implementation can advertise its "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:263
+#: build/C/man2/readv.2:265
msgid ""
"It is not advisable to mix calls to B<readv>() or B<writev>(), which "
"operate on file descriptors, with the functions from the stdio library; the "
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:266
+#: build/C/man2/readv.2:268
msgid "The following code sample demonstrates the use of B<writev>():"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:273
+#: build/C/man2/readv.2:275
#, no-wrap
msgid ""
"char *str0 = \"hello \";\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:278
+#: build/C/man2/readv.2:280
#, no-wrap
msgid ""
"iov[0].iov_base = str0;\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:280
+#: build/C/man2/readv.2:282
#, no-wrap
msgid "nwritten = writev(STDOUT_FILENO, iov, 2);\n"
msgstr ""
#. type: Plain text
-#: build/C/man2/readv.2:286
+#: build/C/man2/readv.2:288
msgid "B<pread>(2), B<read>(2), B<write>(2)"
msgstr ""
#. type: Plain text
#: build/C/man3/remove.3:46
msgid ""
-"B<remove>() deletes a name from the file system. It calls B<unlink>(2) "
-"for files, and B<rmdir>(2) for directories."
+"B<remove>() deletes a name from the filesystem. It calls B<unlink>(2) for "
+"files, and B<rmdir>(2) for directories."
msgstr ""
#. type: Plain text
msgid "RENAME"
msgstr ""
-#. type: TH
-#: build/C/man2/rename.2:32
-#, no-wrap
-msgid "2009-03-30"
-msgstr ""
-
#. type: Plain text
#: build/C/man2/rename.2:35
msgid "rename - change the name or location of a file"
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:140
+#: build/C/man2/rename.2:143
msgid ""
"The new pathname contained a path prefix of the old, or, more generally, an "
"attempt was made to make a directory a subdirectory of itself."
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:146
+#: build/C/man2/rename.2:149
msgid "I<newpath> is an existing directory, but I<oldpath> is not a directory."
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:157
+#: build/C/man2/rename.2:160
msgid ""
"I<oldpath> already has the maximum number of links to it, or it was a "
"directory and the directory containing I<newpath> has the maximum number of "
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:173
+#: build/C/man2/rename.2:176
msgid ""
"The link named by I<oldpath> does not exist; or, a directory component in "
"I<newpath> does not exist; or, I<oldpath> or I<newpath> is an empty string."
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:190
+#: build/C/man2/rename.2:193
msgid ""
"A component used as a directory in I<oldpath> or I<newpath> is not, in fact, "
"a directory. Or, I<oldpath> is a directory, and I<newpath> exists but is "
msgstr ""
#. type: TP
-#: build/C/man2/rename.2:190
+#: build/C/man2/rename.2:193
#, no-wrap
msgid "B<ENOTEMPTY> or B<EEXIST>"
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:194
+#: build/C/man2/rename.2:197
msgid ""
"I<newpath> is a nonempty directory, that is, contains entries other than "
"\".\" and \"..\"."
msgstr ""
#. type: TP
-#: build/C/man2/rename.2:194 build/C/man2/unlink.2:126
+#: build/C/man2/rename.2:197 build/C/man2/unlink.2:126
#, no-wrap
msgid "B<EPERM> or B<EACCES>"
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:218
+#: build/C/man2/rename.2:221
msgid ""
"The directory containing I<oldpath> has the sticky bit (B<S_ISVTX>) set and "
"the process's effective user ID is neither the user ID of the file to be "
"sticky bit set and the process's effective user ID is neither the user ID of "
"the file to be replaced nor that of the directory containing it, and the "
"process is not privileged (Linux: does not have the B<CAP_FOWNER> "
-"capability); or the file
system containing I<pathname> does not support "
+"capability); or the filesystem containing I<pathname> does not support "
"renaming of the type requested."
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:229
+#: build/C/man2/rename.2:232
msgid ""
-"I<oldpath> and I<newpath> are not on the same mounted file system. (Linux "
-"permits a file system to be mounted at multiple points, but B<rename>() "
-"does not work across different mount points, even if the same file system is "
+"I<oldpath> and I<newpath> are not on the same mounted filesystem. (Linux "
+"permits a filesystem to be mounted at multiple points, but B<rename>() does "
+"not work across different mount points, even if the same filesystem is "
"mounted on both.)"
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:231
+#: build/C/man2/rename.2:234
msgid "4.3BSD, C89, C99, POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:242
+#: build/C/man2/rename.2:245
msgid ""
-"On NFS file systems, you can not assume that if the operation failed the "
-"file was not renamed. If the server does the rename operation and then "
-"crashes, the retransmitted RPC which will be processed when the server is up "
-"again causes a failure. The application is expected to deal with this. See "
+"On NFS filesystems, you can not assume that if the operation failed the file "
+"was not renamed. If the server does the rename operation and then crashes, "
+"the retransmitted RPC which will be processed when the server is up again "
+"causes a failure. The application is expected to deal with this. See "
"B<link>(2) for a similar problem."
msgstr ""
#. type: Plain text
-#: build/C/man2/rename.2:251
+#: build/C/man2/rename.2:254
msgid ""
"B<mv>(1), B<chmod>(2), B<link>(2), B<renameat>(2), B<symlink>(2), "
"B<unlink>(2), B<path_resolution>(7), B<symlink>(7)"
#. type: Plain text
#: build/C/man2/rmdir.2:123
msgid ""
-"The file
system containing I<pathname> does not support the removal of "
+"The filesystem containing I<pathname> does not support the removal of "
"directories."
msgstr ""
#. type: Plain text
#: build/C/man2/rmdir.2:127
-msgid "I<pathname> refers to a directory on a read-only file system."
+msgid "I<pathname> refers to a directory on a read-only filesystem."
msgstr ""
#. type: Plain text
msgstr ""
#. type: TH
-#: build/C/man3/scanf.3:50
+#: build/C/man3/scanf.3:52
#, no-wrap
msgid "SCANF"
msgstr ""
+#. type: TH
+#: build/C/man3/scanf.3:52
+#, no-wrap
+msgid "2013-01-30"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/scanf.3:53
+#: build/C/man3/scanf.3:55
msgid "scanf, fscanf, sscanf, vscanf, vsscanf, vfscanf - input format conversion"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:60
+#: build/C/man3/scanf.3:62
#, no-wrap
msgid ""
"B<int scanf(const char *>I<format>B<, ...);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:62
+#: build/C/man3/scanf.3:64
#, no-wrap
msgid "B<#include E<lt>stdarg.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:66
+#: build/C/man3/scanf.3:68
#, no-wrap
msgid ""
"B<int vscanf(const char *>I<format>B<, va_list >I<ap>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:77
+#: build/C/man3/scanf.3:79
msgid "B<vscanf>(), B<vsscanf>(), B<vfscanf>():"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:80
+#: build/C/man3/scanf.3:82
msgid ""
"_XOPEN_SOURCE\\ E<gt>=\\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ "
"200112L;"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:102
+#: build/C/man3/scanf.3:104
msgid ""
"The B<scanf>() family of functions scans input according to I<format> as "
"described below. This format may contain I<conversion specifications>; the "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:113
+#: build/C/man3/scanf.3:115
msgid ""
"If the number of conversion specifications in I<format> exceeds the number "
"of I<pointer> arguments, the results are undefined. If the number of "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:125
+#: build/C/man3/scanf.3:127
msgid ""
"The B<scanf>() function reads input from the standard input stream "
"I<stdin>, B<fscanf>() reads input from the stream pointer I<stream>, and "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:143
+#: build/C/man3/scanf.3:145
msgid ""
"The B<vfscanf>() function is analogous to B<vfprintf>(3) and reads input "
"from the stream pointer I<stream> using a variable argument list of pointers "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:157
+#: build/C/man3/scanf.3:159
msgid ""
"The I<format> string consists of a sequence of I<directives> which describe "
"how to process the sequence of input characters. If processing of a "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:159
+#: build/C/man3/scanf.3:161
msgid "A directive is one of the following:"
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:159 build/C/man3/scanf.3:165 build/C/man3/scanf.3:169 build/C/man3/scanf.3:188 build/C/man3/scanf.3:199 build/C/man3/scanf.3:217 build/C/man3/scanf.3:229 build/C/man3/scanf.3:243
+#: build/C/man3/scanf.3:161 build/C/man3/scanf.3:167 build/C/man3/scanf.3:171 build/C/man3/scanf.3:190 build/C/man3/scanf.3:201 build/C/man3/scanf.3:220 build/C/man3/scanf.3:232 build/C/man3/scanf.3:246
#, no-wrap
msgid "\\(bu"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:165
+#: build/C/man3/scanf.3:167
msgid ""
"A sequence of white-space characters (space, tab, newline, etc.; see "
"B<isspace>(3)). This directive matches any amount of white space, including "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:169
+#: build/C/man3/scanf.3:171
msgid ""
"An ordinary character (i.e., one other than white space or \\(aq%\\(aq). "
"This character must exactly match the next character of input."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:180
+#: build/C/man3/scanf.3:182
msgid ""
"A conversion specification, which commences with a \\(aq%\\(aq (percent) "
"character. A sequence of characters from the input is converted according "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:188
+#: build/C/man3/scanf.3:190
msgid ""
"Each I<conversion specification> in I<format> begins with either the "
"character \\(aq%\\(aq or the character sequence \"B<%>I<n>B<$>\" (see below "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:199
+#: build/C/man3/scanf.3:201
msgid ""
"An optional \\(aq*\\(aq assignment-suppression character: B<scanf>() reads "
"input as directed by the conversion specification, but discards the input. "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:217
+#: build/C/man3/scanf.3:220
msgid ""
-"An optional \\(aqa\\(aq character. This is used with string conversions, "
-"and relieves the caller of the need to allocate a corresponding buffer to "
-"hold the input: instead, B<scanf>() allocates a buffer of sufficient size, "
-"and assigns the address of this buffer to the corresponding I<pointer> "
-"argument, which should be a pointer to a I<char *> variable (this variable "
-"does not need to be initialized before the call). The caller should "
-"subsequently B<free>(3) this buffer when it is no longer required. This is "
-"a GNU extension; C99 employs the \\(aqa\\(aq character as a conversion "
-"specifier (and it can also be used as such in the GNU implementation)."
+"An optional \\(aqm\\(aq character. This is used with string conversions "
+"(I<%s>, I<%c>, I<%[>), and relieves the caller of the need to allocate a "
+"corresponding buffer to hold the input: instead, B<scanf>() allocates a "
+"buffer of sufficient size, and assigns the address of this buffer to the "
+"corresponding I<pointer> argument, which should be a pointer to a I<char\\ "
+"*> variable (this variable does not need to be initialized before the "
+"call). The caller should subsequently B<free>(3) this buffer when it is no "
+"longer required."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:229
+#: build/C/man3/scanf.3:232
msgid ""
"An optional decimal integer which specifies the I<maximum field width>. "
"Reading of characters stops either when this maximum is reached or when a "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:243
+#: build/C/man3/scanf.3:246
msgid ""
"An optional I<type modifier character>. For example, the B<l> type modifier "
"is used with integer conversions such as B<%d> to specify that the "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:248
+#: build/C/man3/scanf.3:251
msgid ""
"A I<conversion specifier> that specifies the type of input conversion to be "
"performed."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:277
+#: build/C/man3/scanf.3:280
msgid ""
"The conversion specifications in I<format> are of two forms, either "
"beginning with \\(aq%\\(aq or beginning with \"B<%>I<n>B<$>\". The two "
msgstr ""
#. type: SS
-#: build/C/man3/scanf.3:277
+#: build/C/man3/scanf.3:280
#, no-wrap
msgid "Conversions"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:281
+#: build/C/man3/scanf.3:284
msgid ""
"The following I<type modifier characters> can appear in a conversion "
"specification:"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:291
+#: build/C/man3/scanf.3:294
msgid ""
"Indicates that the conversion will be one of B<d>, B<i>, B<o>, B<u>, B<x>, "
"B<X>, or B<n> and the next pointer is a pointer to a I<short int> or "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:299
+#: build/C/man3/scanf.3:302
msgid ""
"As for B<h>, but the next pointer is a pointer to a I<signed char> or "
"I<unsigned char>."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:308
+#: build/C/man3/scanf.3:311
msgid ""
"As for B<h>, but the next pointer is a pointer to an I<intmax_t> or a "
"I<uintmax_t>. This modifier was introduced in C99."
#. This use of l was introduced in Amendment 1 to ISO C90.
#. type: Plain text
-#: build/C/man3/scanf.3:335
+#: build/C/man3/scanf.3:338
msgid ""
"Indicates either that the conversion will be one of B<d>, B<i>, B<o>, B<u>, "
"B<x>, B<X>, or B<n> and the next pointer is a pointer to a I<long int> or "
#. type. Any program using this will not be portable to all
#. architectures).
#. type: Plain text
-#: build/C/man3/scanf.3:351
+#: build/C/man3/scanf.3:354
msgid ""
"Indicates that the conversion will be either B<e>, B<f>, or B<g> and the "
"next pointer is a pointer to I<long double> or the conversion will be B<d>, "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:356
+#: build/C/man3/scanf.3:359
msgid "equivalent to B<L>. This specifier does not exist in ANSI C."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:363
+#: build/C/man3/scanf.3:366
msgid ""
"As for B<h>, but the next pointer is a pointer to a I<ptrdiff_t>. This "
"modifier was introduced in C99."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:370
+#: build/C/man3/scanf.3:373
msgid ""
"As for B<h>, but the next pointer is a pointer to a I<size_t>. This "
"modifier was introduced in C99."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:374
+#: build/C/man3/scanf.3:377
msgid "The following I<conversion specifiers> are available:"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:383
+#: build/C/man3/scanf.3:386
msgid ""
"Matches a literal \\(aq%\\(aq. That is, B<%\\&%> in the format string "
"matches a single input \\(aq%\\(aq character. No conversion is done (but "
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:383
+#: build/C/man3/scanf.3:386
#, no-wrap
msgid "B<d>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:388
+#: build/C/man3/scanf.3:391
msgid ""
"Matches an optionally signed decimal integer; the next pointer must be a "
"pointer to I<int>."
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:388
+#: build/C/man3/scanf.3:391
#, no-wrap
msgid "B<D>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:397
+#: build/C/man3/scanf.3:400
msgid ""
"Equivalent to I<ld>; this exists only for backward compatibility. (Note: "
"thus only in libc4. In libc5 and glibc the B<%D> is silently ignored, "
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:397
+#: build/C/man3/scanf.3:400
#, no-wrap
msgid "B<i>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:409
+#: build/C/man3/scanf.3:412
msgid ""
"Matches an optionally signed integer; the next pointer must be a pointer to "
"I<int>. The integer is read in base 16 if it begins with I<0x> or I<0X>, in "
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:409
+#: build/C/man3/scanf.3:412
#, no-wrap
msgid "B<o>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:413
+#: build/C/man3/scanf.3:416
msgid ""
"Matches an unsigned octal integer; the next pointer must be a pointer to "
"I<unsigned int>."
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:413
+#: build/C/man3/scanf.3:416
#, no-wrap
msgid "B<u>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:418
+#: build/C/man3/scanf.3:421
msgid ""
"Matches an unsigned decimal integer; the next pointer must be a pointer to "
"I<unsigned int>."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:423
+#: build/C/man3/scanf.3:426
msgid ""
"Matches an unsigned hexadecimal integer; the next pointer must be a pointer "
"to I<unsigned int>."
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:423
+#: build/C/man3/scanf.3:426
#, no-wrap
msgid "B<X>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:427
+#: build/C/man3/scanf.3:430
msgid "Equivalent to B<x>."
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:427
+#: build/C/man3/scanf.3:430
#, no-wrap
msgid "B<f>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:432
+#: build/C/man3/scanf.3:435
msgid ""
"Matches an optionally signed floating-point number; the next pointer must be "
"a pointer to I<float>."
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:432
+#: build/C/man3/scanf.3:435
#, no-wrap
msgid "B<e>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:436 build/C/man3/scanf.3:440 build/C/man3/scanf.3:444
+#: build/C/man3/scanf.3:439 build/C/man3/scanf.3:443 build/C/man3/scanf.3:447
msgid "Equivalent to B<f>."
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:436
+#: build/C/man3/scanf.3:439
#, no-wrap
msgid "B<g>"
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:440
+#: build/C/man3/scanf.3:443
#, no-wrap
msgid "B<E>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:448
+#: build/C/man3/scanf.3:451
msgid "(C99) Equivalent to B<f>."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:456
+#: build/C/man3/scanf.3:459
msgid ""
"Matches a sequence of non-white-space characters; the next pointer must be a "
"pointer to character array that is long enough to hold the input sequence "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:467
+#: build/C/man3/scanf.3:469
msgid ""
"Matches a sequence of characters whose length is specified by the I<maximum "
"field width> (default 1); the next pointer must be a pointer to I<char>, and "
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:467
+#: build/C/man3/scanf.3:469
#, no-wrap
msgid "B<\\&[>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:500
+#: build/C/man3/scanf.3:502
msgid ""
"Matches a nonempty sequence of characters from the specified set of accepted "
"characters; the next pointer must be a pointer to I<char>, and there must be "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:508
+#: build/C/man3/scanf.3:510
msgid ""
"Matches a pointer value (as printed by B<%p> in B<printf>(3); the next "
"pointer must be a pointer to a pointer to I<void>."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:528
+#: build/C/man3/scanf.3:530
msgid ""
"Nothing is expected; instead, the number of characters consumed thus far "
"from the input is stored through the next pointer, which must be a pointer "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:533
+#: build/C/man3/scanf.3:535
msgid ""
"These functions return the number of input items successfully matched and "
"assigned, which can be fewer than provided for, or even zero in the event of "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:545
+#: build/C/man3/scanf.3:547
msgid ""
"The value B<EOF> is returned if the end of input is reached before either "
"the first successful conversion or a matching failure occurs. B<EOF> is "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:551
+#: build/C/man3/scanf.3:553
msgid ""
"The file descriptor underlying I<stream> is marked nonblocking, and the read "
"operation would block."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:556
+#: build/C/man3/scanf.3:558
msgid ""
"The file descriptor underlying I<stream> is invalid, or not open for "
"reading."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:559
+#: build/C/man3/scanf.3:561
msgid "Input byte sequence does not form a valid character."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:563
+#: build/C/man3/scanf.3:565
msgid "The read operation was interrupted by a signal; see B<signal>(7)."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:568
+#: build/C/man3/scanf.3:570
msgid "Not enough arguments; or I<format> is NULL."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:571
+#: build/C/man3/scanf.3:573
msgid "Out of memory."
msgstr ""
#. type: TP
-#: build/C/man3/scanf.3:571
+#: build/C/man3/scanf.3:573
#, no-wrap
msgid "B<ERANGE>"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:575
+#: build/C/man3/scanf.3:577
msgid ""
"The result of an integer conversion would exceed the size that can be stored "
"in the corresponding integer type."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:585
+#: build/C/man3/scanf.3:587
msgid ""
"The functions B<fscanf>(), B<scanf>(), and B<sscanf>() conform to C89 and "
"C99 and POSIX.1-2001. These standards do not specify the B<ERANGE> error."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:595
+#: build/C/man3/scanf.3:597
msgid ""
"The B<q> specifier is the 4.4BSD notation for I<long long>, while B<ll> or "
"the usage of B<L> in integer conversions is the GNU notation."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:606
+#: build/C/man3/scanf.3:608
msgid ""
"The Linux version of these functions is based on the I<GNU> I<libio> "
"library. Take a look at the I<info> documentation of I<GNU> I<libc "
"(glibc-1.08)> for a more concise description."
msgstr ""
-#. This feature seems to be present at least as far back as glibc 2.0.
-#. type: Plain text
-#: build/C/man3/scanf.3:624
-msgid ""
-"The GNU C library supports a nonstandard extension that causes the library "
-"to dynamically allocate a string of sufficient size for input strings for "
-"the B<%s> and B<%a[>I<range>B<]> conversion specifiers. To make use of this "
-"feature, specify B<a> as a length modifier (thus B<%as> or "
-"B<%a[>I<range>B<]>). The caller must B<free>(3) the returned string, as in "
-"the following example:"
-msgstr ""
-
-#. type: Plain text
-#: build/C/man3/scanf.3:629
-#, no-wrap
-msgid ""
-"char *p;\n"
-"int n;\n"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/scanf.3:640
-#, no-wrap
+#: build/C/man3/scanf.3:614
msgid ""
-"errno = 0;\n"
-"n = scanf(\"%a[a-z]\", &p);\n"
-"if (n == 1) {\n"
-" printf(\"read: %s\\en\", p);\n"
-" free(p);\n"
-"} else if (errno != 0) {\n"
-" perror(\"scanf\");\n"
-"} else {\n"
-" fprintf(stderr, \"No matching characters\\en\"):\n"
-"}\n"
+"The GNU C library supported the dynamic allocation conversion specifier (as "
+"a nonstandard extension) via the B<a> character. This feature seems to be "
+"present at least as far back as glibc 2.0."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:648
-msgid ""
-"As shown in the above example, it is only necessary to call B<free>(3) if "
-"the B<scanf>() call successfully read a string."
-msgstr ""
-
-#. type: Plain text
-#: build/C/man3/scanf.3:660
+#: build/C/man3/scanf.3:624
msgid ""
-"The B<a> modifier is not available if the program is compiled with I<gcc "
-"-std=c99> or I<gcc -D_ISOC99_SOURCE> (unless B<_GNU_SOURCE> is also "
-"specified), in which case the B<a> is interpreted as a specifier for "
-"floating-point numbers (see above)."
+"It is not available if the program is compiled with I<gcc -std=c99> or I<gcc "
+"-D_ISOC99_SOURCE> (unless B<_GNU_SOURCE> is also specified), in which case "
+"the B<a> is interpreted as a specifier for floating-point numbers (see "
+"above)."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:669
+#: build/C/man3/scanf.3:633
msgid ""
"Since version 2.7, glibc also provides the B<m> modifier for the same "
"purpose as the B<a> modifier. The B<m> modifier has the following "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:674
+#: build/C/man3/scanf.3:638
msgid "It may also be applied to B<%c> conversion specifiers (e.g., B<%3mc>)."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:680
+#: build/C/man3/scanf.3:644
msgid ""
"It avoids ambiguity with respect to the B<%a> floating-point conversion "
"specifier (and is unaffected by I<gcc -std=c99> etc.)"
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:682
-msgid "It is specified in the upcoming revision of the POSIX.1 standard."
+#: build/C/man3/scanf.3:646
+msgid "It is specified in the POSIX.1-2008 standard."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:695
+#: build/C/man3/scanf.3:659
msgid ""
"All functions are fully C89 conformant, but provide the additional "
"specifiers B<q> and B<a> as well as an additional behavior of the B<L> and "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:711
+#: build/C/man3/scanf.3:675
msgid ""
"Some combinations of the type modifiers and conversion specifiers defined by "
-"ANSI C do not make sense (e.g. B<%Ld>). While they may have a well-defined "
+"ANSI C do not make sense (e.g., B<%Ld>). While they may have a well-defined "
"behavior on Linux, this need not to be so on other architectures. Therefore "
"it usually is better to use modifiers that are not defined by ANSI C at all, "
"that is, use B<q> instead of B<L> in combination with B<d>, B<i>, B<o>, "
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:717
+#: build/C/man3/scanf.3:681
msgid ""
"The usage of B<q> is not the same as on 4.4BSD, as it may be used in float "
"conversions equivalently to B<L>."
msgstr ""
#. type: Plain text
-#: build/C/man3/scanf.3:724
+#: build/C/man3/scanf.3:691
+msgid ""
+"To use the dynamic allocation conversion specifier, specify B<m> as a length "
+"modifier (thus B<%ms> or B<%m[>I<range>B<]>). The caller must B<free>(3) "
+"the returned string, as in the following example:"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/scanf.3:696
+#, no-wrap
+msgid ""
+"char *p;\n"
+"int n;\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/scanf.3:707
+#, no-wrap
+msgid ""
+"errno = 0;\n"
+"n = scanf(\"%m[a-z]\", &p);\n"
+"if (n == 1) {\n"
+" printf(\"read: %s\\en\", p);\n"
+" free(p);\n"
+"} else if (errno != 0) {\n"
+" perror(\"scanf\");\n"
+"} else {\n"
+" fprintf(stderr, \"No matching characters\\en\");\n"
+"}\n"
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/scanf.3:715
+msgid ""
+"As shown in the above example, it is necessary to call B<free>(3) only if "
+"the B<scanf>() call successfully read a string."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/scanf.3:722
msgid ""
"B<getc>(3), B<printf>(3), B<setlocale>(3), B<strtod>(3), B<strtol>(3), "
"B<strtoul>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/setbuf.3:46
+#: build/C/man3/setbuf.3:48
#, no-wrap
msgid "SETBUF"
msgstr ""
#. type: TH
-#: build/C/man3/setbuf.3:46
+#: build/C/man3/setbuf.3:48
#, no-wrap
-msgid "2008-06-26"
+msgid "2012-08-03"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:49
+#: build/C/man3/setbuf.3:51
msgid "setbuf, setbuffer, setlinebuf, setvbuf - stream buffering operations"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:54
+#: build/C/man3/setbuf.3:56
#, no-wrap
msgid "B<void setbuf(FILE *>I<stream>B<, char *>I<buf>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:56
+#: build/C/man3/setbuf.3:58
#, no-wrap
msgid "B<void setbuffer(FILE *>I<stream>B<, char *>I<buf>B<, size_t >I<size>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:58
+#: build/C/man3/setbuf.3:60
#, no-wrap
msgid "B<void setlinebuf(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:61
+#: build/C/man3/setbuf.3:63
#, no-wrap
msgid ""
"B<int setvbuf(FILE *>I<stream>B<, char *>I<buf>B<, int >I<mode>B<, size_t "
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:71
+#: build/C/man3/setbuf.3:73
msgid "B<setbuffer>(), B<setlinebuf>(): _BSD_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:94
+#: build/C/man3/setbuf.3:96
msgid ""
"The three types of buffering available are unbuffered, block buffered, and "
"line buffered. When an output stream is unbuffered, information appears on "
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:101
+#: build/C/man3/setbuf.3:103
msgid ""
"The B<setvbuf>() function may be used on any open stream to change its "
"buffer. The I<mode> argument must be one of the following three macros:"
msgstr ""
#. type: TP
-#: build/C/man3/setbuf.3:102
+#: build/C/man3/setbuf.3:104
#, no-wrap
msgid "B<_IONBF>"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:105
+#: build/C/man3/setbuf.3:107
msgid "unbuffered"
msgstr ""
#. type: TP
-#: build/C/man3/setbuf.3:105
+#: build/C/man3/setbuf.3:107
#, no-wrap
msgid "B<_IOLBF>"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:108
+#: build/C/man3/setbuf.3:110
msgid "line buffered"
msgstr ""
#. type: TP
-#: build/C/man3/setbuf.3:108
+#: build/C/man3/setbuf.3:110
#, no-wrap
msgid "B<_IOFBF>"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:111
+#: build/C/man3/setbuf.3:113
msgid "fully buffered"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:127
+#: build/C/man3/setbuf.3:129
msgid ""
"Except for unbuffered files, the I<buf> argument should point to a buffer at "
"least I<size> bytes long; this buffer will be used instead of the current "
"buffer. If the argument I<buf> is NULL, only the mode is affected; a new "
"buffer will be allocated on the next read or write operation. The "
-"B<setvbuf>() function may only be used after opening a stream and before "
+"B<setvbuf>() function may be used only after opening a stream and before "
"any other operations have been performed on it."
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:133
+#: build/C/man3/setbuf.3:135
msgid ""
"The other three calls are, in effect, simply aliases for calls to "
"B<setvbuf>(). The B<setbuf>() function is exactly equivalent to the call"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:136
+#: build/C/man3/setbuf.3:138
msgid "setvbuf(stream, buf, buf ? _IOFBF : _IONBF, BUFSIZ);"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:146
+#: build/C/man3/setbuf.3:148
msgid ""
"The B<setbuffer>() function is the same, except that the size of the buffer "
"is up to the caller, rather than being determined by the default B<BUFSIZ>. "
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:149
-msgid "setvbuf(stream, (char *) NULL, _IOLBF, 0);"
+#: build/C/man3/setbuf.3:151
+msgid "setvbuf(stream, NULL, _IOLBF, 0);"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:160
+#: build/C/man3/setbuf.3:162
msgid ""
"The function B<setvbuf>() returns 0 on success. It returns nonzero on "
"failure (I<mode> is invalid or the request cannot be honored). It may set "
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:162
+#: build/C/man3/setbuf.3:164
msgid "The other functions do not return a value."
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:168
+#: build/C/man3/setbuf.3:170
msgid "The B<setbuf>() and B<setvbuf>() functions conform to C89 and C99."
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:178
+#: build/C/man3/setbuf.3:180
msgid ""
"The B<setbuffer>() and B<setlinebuf>() functions are not portable to "
"versions of BSD before 4.2BSD, and are available under Linux since libc "
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:185
+#: build/C/man3/setbuf.3:187
msgid ""
"You must make sure that the space that I<buf> points to still exists by the "
"time I<stream> is closed, which also happens at program termination. For "
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:188
+#: build/C/man3/setbuf.3:190
#, no-wrap
msgid "#include E<lt>stdio.hE<gt>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:197
+#: build/C/man3/setbuf.3:199
#, no-wrap
msgid ""
"int\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/setbuf.3:206
+#: build/C/man3/setbuf.3:208
msgid ""
"B<fclose>(3), B<fflush>(3), B<fopen>(3), B<fread>(3), B<malloc>(3), "
"B<printf>(3), B<puts>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/stdin.3:9
+#: build/C/man3/stdin.3:13
#, no-wrap
msgid "STDIN"
msgstr ""
#. type: TH
-#: build/C/man3/stdin.3:9 build/C/man3/tmpfile.3:29
+#: build/C/man3/stdin.3:13 build/C/man3/tmpfile.3:31
#, no-wrap
msgid "2008-07-14"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:12
+#: build/C/man3/stdin.3:16
msgid "stdin, stdout, stderr - standard I/O streams"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:19
+#: build/C/man3/stdin.3:23
#, no-wrap
msgid ""
"B<extern FILE *>I<stdin>B<;>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:31
+#: build/C/man3/stdin.3:35
msgid ""
"Under normal circumstances every UNIX program has three streams opened for "
"it when it starts up, one for input, one for output, and one for printing "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:41
+#: build/C/man3/stdin.3:45
msgid ""
"The input stream is referred to as \"standard input\"; the output stream is "
"referred to as \"standard output\"; and the error stream is referred to as "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:50
+#: build/C/man3/stdin.3:54
msgid ""
"Each of these symbols is a B<stdio>(3) macro of type pointer to I<FILE>, "
"and can be used with functions like B<fprintf>(3) or B<fread>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:59
+#: build/C/man3/stdin.3:63
msgid ""
"Since I<FILE>s are a buffering wrapper around UNIX file descriptors, the "
"same underlying files may also be accessed using the raw UNIX file "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:78
+#: build/C/man3/stdin.3:82
msgid ""
"On program startup, the integer file descriptors associated with the streams "
"I<stdin>, I<stdout>, and I<stderr> are 0, 1, and 2, respectively. The "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:91
+#: build/C/man3/stdin.3:95
msgid ""
"Note that mixing use of I<FILE>s and raw file descriptors can produce "
"unexpected results and should generally be avoided. (For the masochistic "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:109
+#: build/C/man3/stdin.3:113
msgid ""
"Since the symbols I<stdin>, I<stdout>, and I<stderr> are specified to be "
"macros, assigning to them is nonportable. The standard streams can be made "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:118
+#: build/C/man3/stdin.3:122
msgid ""
"The I<stdin>, I<stdout>, and I<stderr> macros conform to C89 and this "
"standard also stipulates that these three streams shall be open at program "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:150
+#: build/C/man3/stdin.3:154
msgid ""
"The stream I<stderr> is unbuffered. The stream I<stdout> is line-buffered "
"when it points to a terminal. Partial lines will not appear until "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdin.3:156
+#: build/C/man3/stdin.3:160
msgid "B<csh>(1), B<sh>(1), B<open>(2), B<fopen>(3), B<stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/stdio.3:37
+#: build/C/man3/stdio.3:39
#, no-wrap
msgid "STDIO"
msgstr ""
#. type: TH
-#: build/C/man3/stdio.3:37
+#: build/C/man3/stdio.3:39
#, no-wrap
msgid "2001-12-26"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:40
+#: build/C/man3/stdio.3:42
msgid "stdio - standard input/output library functions"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:44
+#: build/C/man3/stdio.3:46
msgid "B<FILE *>I<stdin>B<;>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:46
+#: build/C/man3/stdio.3:48
msgid "B<FILE *>I<stdout>B<;>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:48
+#: build/C/man3/stdio.3:50
msgid "B<FILE *>I<stderr>B<;>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:55
+#: build/C/man3/stdio.3:57
msgid ""
"The standard I/O library provides a simple and efficient buffered stream I/O "
"interface. Input and output is mapped into logical data streams and the "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:78
+#: build/C/man3/stdio.3:80
msgid ""
"A stream is associated with an external file (which may be a physical "
"device) by I<opening> a file, which may involve creating a new file. "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:88
+#: build/C/man3/stdio.3:90
msgid ""
"A file is disassociated from a stream by I<closing> the file. Output "
"streams are flushed (any unwritten buffer contents are transferred to the "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:101
+#: build/C/man3/stdio.3:103
msgid ""
"A file may be subsequently reopened, by the same or another program "
"execution, and its contents reclaimed or modified (if it can be repositioned "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:117
+#: build/C/man3/stdio.3:119
msgid ""
"At program startup, three text streams are predefined and need not be opened "
"explicitly: I<standard input> (for reading conventional input), I<standard "
"diagnostic output). These streams are abbreviated I<stdin>,I<stdout> and "
"I<stderr>. When opened, the standard error stream is not fully buffered; "
"the standard input and output streams are fully buffered if and only if the "
-"streams do not to refer to an interactive device."
+"streams do not refer to an interactive device."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:127
+#: build/C/man3/stdio.3:129
msgid ""
"Output streams that refer to terminal devices are always line buffered by "
"default; pending output to such streams is written automatically whenever an "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:141
+#: build/C/man3/stdio.3:143
msgid ""
"The I<stdio> library is a part of the library B<libc> and routines are "
"automatically loaded as needed by the compilers B<cc>(1) and B<pc>(1). The "
#. Not on Linux: .BR fropen ,
#. Not on Linux: .BR fwopen ,
#. type: Plain text
-#: build/C/man3/stdio.3:181
+#: build/C/man3/stdio.3:183
msgid ""
"The following are defined as macros; these names may not be reused without "
"first removing their current definitions with B<#undef>: B<BUFSIZ>, B<EOF>, "
msgstr ""
#. type: SS
-#: build/C/man3/stdio.3:181
+#: build/C/man3/stdio.3:183
#, no-wrap
-msgid "List of Functions"
+msgid "List of functions"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:186
+#: build/C/man3/stdio.3:188
#, no-wrap
msgid "Function\tDescription\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:187
+#: build/C/man3/stdio.3:189
#, no-wrap
msgid "_\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:188
+#: build/C/man3/stdio.3:190
#, no-wrap
msgid "clearerr\tcheck and reset stream status\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:189
+#: build/C/man3/stdio.3:191
#, no-wrap
msgid "fclose\tclose a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:190
+#: build/C/man3/stdio.3:192
#, no-wrap
msgid "fdopen\tstream open functions\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:191
+#: build/C/man3/stdio.3:193
#, no-wrap
msgid "feof\tcheck and reset stream status\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:192
+#: build/C/man3/stdio.3:194
#, no-wrap
msgid "ferror\tcheck and reset stream status\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:193
+#: build/C/man3/stdio.3:195
#, no-wrap
msgid "fflush\tflush a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:194
+#: build/C/man3/stdio.3:196
#, no-wrap
msgid "fgetc\tget next character or word from input stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:195
+#: build/C/man3/stdio.3:197
#, no-wrap
msgid "fgetpos\treposition a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:196
+#: build/C/man3/stdio.3:198
#, no-wrap
msgid "fgets\tget a line from a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:197
+#: build/C/man3/stdio.3:199
#, no-wrap
msgid "fileno\treturn the integer descriptor of the argument stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:198
+#: build/C/man3/stdio.3:200
#, no-wrap
msgid "fopen\tstream open functions\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:199
+#: build/C/man3/stdio.3:201
#, no-wrap
msgid "fprintf\tformatted output conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:200
+#: build/C/man3/stdio.3:202
#, no-wrap
msgid "fpurge\tflush a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:201
+#: build/C/man3/stdio.3:203
#, no-wrap
msgid "fputc\toutput a character or word to a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:202
+#: build/C/man3/stdio.3:204
#, no-wrap
msgid "fputs\toutput a line to a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:203
+#: build/C/man3/stdio.3:205
#, no-wrap
msgid "fread\tbinary stream input/output\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:204
+#: build/C/man3/stdio.3:206
#, no-wrap
msgid "freopen\tstream open functions\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:205
+#: build/C/man3/stdio.3:207
#, no-wrap
msgid "fscanf\tinput format conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:206
+#: build/C/man3/stdio.3:208
#, no-wrap
msgid "fseek\treposition a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:207
+#: build/C/man3/stdio.3:209
#, no-wrap
msgid "fsetpos\treposition a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:208
+#: build/C/man3/stdio.3:210
#, no-wrap
msgid "ftell\treposition a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:209
+#: build/C/man3/stdio.3:211
#, no-wrap
msgid "fwrite\tbinary stream input/output\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:210
+#: build/C/man3/stdio.3:212
#, no-wrap
msgid "getc\tget next character or word from input stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:211
+#: build/C/man3/stdio.3:213
#, no-wrap
msgid "getchar\tget next character or word from input stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:212
+#: build/C/man3/stdio.3:214
#, no-wrap
msgid "gets\tget a line from a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:213
+#: build/C/man3/stdio.3:215
#, no-wrap
msgid "getw\tget next character or word from input stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:214
+#: build/C/man3/stdio.3:216
#, no-wrap
msgid "mktemp\tmake temporary filename (unique)\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:215
+#: build/C/man3/stdio.3:217
#, no-wrap
msgid "perror\tsystem error messages\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:216
+#: build/C/man3/stdio.3:218
#, no-wrap
msgid "printf\tformatted output conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:217
+#: build/C/man3/stdio.3:219
#, no-wrap
msgid "putc\toutput a character or word to a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:218
+#: build/C/man3/stdio.3:220
#, no-wrap
msgid "putchar\toutput a character or word to a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:219
+#: build/C/man3/stdio.3:221
#, no-wrap
msgid "puts\toutput a line to a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:220
+#: build/C/man3/stdio.3:222
#, no-wrap
msgid "putw\toutput a character or word to a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:221
+#: build/C/man3/stdio.3:223
#, no-wrap
msgid "remove\tremove directory entry\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:222
+#: build/C/man3/stdio.3:224
#, no-wrap
msgid "rewind\treposition a stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:223
+#: build/C/man3/stdio.3:225
#, no-wrap
msgid "scanf\tinput format conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:224
+#: build/C/man3/stdio.3:226
#, no-wrap
msgid "setbuf\tstream buffering operations\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:225
+#: build/C/man3/stdio.3:227
#, no-wrap
msgid "setbuffer\tstream buffering operations\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:226
+#: build/C/man3/stdio.3:228
#, no-wrap
msgid "setlinebuf\tstream buffering operations\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:227
+#: build/C/man3/stdio.3:229
#, no-wrap
msgid "setvbuf\tstream buffering operations\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:228
+#: build/C/man3/stdio.3:230
#, no-wrap
msgid "sprintf\tformatted output conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:229
+#: build/C/man3/stdio.3:231
#, no-wrap
msgid "sscanf\tinput format conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:230
+#: build/C/man3/stdio.3:232
#, no-wrap
msgid "strerror\tsystem error messages\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:231
+#: build/C/man3/stdio.3:233
#, no-wrap
msgid "sys_errlist\tsystem error messages\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:232
+#: build/C/man3/stdio.3:234
#, no-wrap
msgid "sys_nerr\tsystem error messages\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:233
+#: build/C/man3/stdio.3:235
#, no-wrap
msgid "tempnam\ttemporary file routines\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:234
+#: build/C/man3/stdio.3:236
#, no-wrap
msgid "tmpfile\ttemporary file routines\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:235
+#: build/C/man3/stdio.3:237
#, no-wrap
msgid "tmpnam\ttemporary file routines\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:236
+#: build/C/man3/stdio.3:238
#, no-wrap
msgid "ungetc\tun-get character from input stream\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:237
+#: build/C/man3/stdio.3:239
#, no-wrap
msgid "vfprintf\tformatted output conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:238
+#: build/C/man3/stdio.3:240
#, no-wrap
msgid "vfscanf\tinput format conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:239
+#: build/C/man3/stdio.3:241
#, no-wrap
msgid "vprintf\tformatted output conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:240
+#: build/C/man3/stdio.3:242
#, no-wrap
msgid "vscanf\tinput format conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:241
+#: build/C/man3/stdio.3:243
#, no-wrap
msgid "vsprintf\tformatted output conversion\n"
msgstr ""
#. type: tbl table
-#: build/C/man3/stdio.3:242
+#: build/C/man3/stdio.3:244
#, no-wrap
msgid "vsscanf\tinput format conversion\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:248
+#: build/C/man3/stdio.3:250
msgid "The I<stdio> library conforms to C89."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio.3:255
+#: build/C/man3/stdio.3:257
msgid ""
"B<close>(2), B<open>(2), B<read>(2), B<write>(2), B<stdout>(3), "
"B<unlocked_stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/stdio_ext.3:23
+#: build/C/man3/stdio_ext.3:25
#, no-wrap
msgid "STDIO_EXT"
msgstr ""
-#. type: TH
-#: build/C/man3/stdio_ext.3:23
-#, no-wrap
-msgid "2001-12-16"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/stdio_ext.3:28
+#: build/C/man3/stdio_ext.3:30
msgid ""
"__fbufsize, __flbf, __fpending, __fpurge, __freadable, __freading, "
"__fsetlocking, __fwritable, __fwriting, _flushlbf - interfaces to stdio FILE "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:32
+#: build/C/man3/stdio_ext.3:34
msgid "B<#include E<lt>stdio_ext.hE<gt>>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:34
+#: build/C/man3/stdio_ext.3:36
msgid "B<size_t __fbufsize(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:36
+#: build/C/man3/stdio_ext.3:38
msgid "B<size_t __fpending(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:38
+#: build/C/man3/stdio_ext.3:40
msgid "B<int __flbf(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:40
+#: build/C/man3/stdio_ext.3:42
msgid "B<int __freadable(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:42
+#: build/C/man3/stdio_ext.3:44
msgid "B<int __fwritable(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:44
+#: build/C/man3/stdio_ext.3:46
msgid "B<int __freading(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:46
+#: build/C/man3/stdio_ext.3:48
msgid "B<int __fwriting(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:48
+#: build/C/man3/stdio_ext.3:50
msgid "B<int __fsetlocking(FILE *>I<stream>B<, int >I<type>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:50
+#: build/C/man3/stdio_ext.3:52
msgid "B<void _flushlbf(void);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:52
+#: build/C/man3/stdio_ext.3:54
msgid "B<void __fpurge(FILE *>I<stream>B<);>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:57
+#: build/C/man3/stdio_ext.3:59
msgid ""
"Solaris introduced routines to allow portable access to the internals of the "
"I<FILE> structure, and glibc also implemented these."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:62
+#: build/C/man3/stdio_ext.3:64
msgid ""
"The B<__fbufsize>() function returns the size of the buffer currently used "
"by the given stream."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:69
+#: build/C/man3/stdio_ext.3:71
msgid ""
"The B<__fpending>() function returns the number of bytes in the output "
"buffer. For wide-oriented streams the unit is wide characters. This "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:74
+#: build/C/man3/stdio_ext.3:76
msgid ""
"The B<__flbf>() function returns a nonzero value if the stream is "
"line-buffered, and zero otherwise."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:79
+#: build/C/man3/stdio_ext.3:81
msgid ""
"The B<__freadable>() function returns a nonzero value if the stream allows "
"reading, and zero otherwise."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:84
+#: build/C/man3/stdio_ext.3:86
msgid ""
"The B<__fwritable>() function returns a nonzero value if the stream allows "
"writing, and zero otherwise."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:90
+#: build/C/man3/stdio_ext.3:92
msgid ""
"The B<__freading>() function returns a nonzero value if the stream is "
"read-only, or if the last operation on the stream was a read operation, and "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:96
+#: build/C/man3/stdio_ext.3:98
msgid ""
"The B<__fwriting>() function returns a nonzero value if the stream is "
"write-only (or append-only), or if the last operation on the stream was a "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:104
+#: build/C/man3/stdio_ext.3:106
msgid ""
"The B<__fsetlocking>() function can be used to select the desired type of "
"locking on the stream. It returns the current type. The I<type> argument "
msgstr ""
#. type: TP
-#: build/C/man3/stdio_ext.3:104
+#: build/C/man3/stdio_ext.3:106
#, no-wrap
msgid "B<FSETLOCKING_INTERNAL>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:109
+#: build/C/man3/stdio_ext.3:111
msgid ""
"Perform implicit locking around every operation on the given stream (except "
"for the *_unlocked ones). This is the default."
msgstr ""
#. type: TP
-#: build/C/man3/stdio_ext.3:109
+#: build/C/man3/stdio_ext.3:111
#, no-wrap
msgid "B<FSETLOCKING_BYCALLER>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:116
+#: build/C/man3/stdio_ext.3:118
msgid ""
"The caller will take care of the locking (possibly using B<flockfile>(3) in "
"case there is more than one thread), and the stdio routines will not do "
msgstr ""
#. type: TP
-#: build/C/man3/stdio_ext.3:116
+#: build/C/man3/stdio_ext.3:118
#, no-wrap
msgid "B<FSETLOCKING_QUERY>"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:120
+#: build/C/man3/stdio_ext.3:122
msgid "Don't change the type of locking. (Only return it.)"
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:126
+#: build/C/man3/stdio_ext.3:128
msgid ""
"The B<_flushlbf>() function flushes all line-buffered streams. (Presumably "
"so that output to a terminal is forced out, say before reading keyboard "
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:130
+#: build/C/man3/stdio_ext.3:132
msgid "The B<__fpurge>() function discards the contents of the stream's buffer."
msgstr ""
#. type: Plain text
-#: build/C/man3/stdio_ext.3:133
-msgid "B<flockfile>(3), B<fpurge>(3)"
+#: build/C/man3/stdio_ext.3:141
+msgid ""
+"The B<__fbufsize>(), B<__fpending>(), B<__fpurge>() and B<__fsetlocking>() "
+"functions do not lock the stream, so they are not thread-safe."
msgstr ""
-#. type: TH
-#: build/C/man2/symlink.2:32 build/C/man7/symlink.7:35
-#, no-wrap
-msgid "SYMLINK"
+#. type: Plain text
+#: build/C/man3/stdio_ext.3:151
+msgid ""
+"The B<__flbf>(), B<__freadable>(), B<__freading>(), B<__fwritable>(), "
+"B<__fwriting>() and B<_flushlbf>() functions are thread-safe."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/stdio_ext.3:154
+msgid "B<flockfile>(3), B<fpurge>(3)"
msgstr ""
#. type: TH
-#: build/C/man2/symlink.2:32
+#: build/C/man2/symlink.2:32 build/C/man7/symlink.7:36
#, no-wrap
-msgid "2010-09-20"
+msgid "SYMLINK"
msgstr ""
#. type: Plain text
msgstr ""
#. type: Plain text
-#: build/C/man2/symlink.2:113
+#: build/C/man2/symlink.2:104
+msgid ""
+"The user's quota of resources on the filesystem has been exhausted. The "
+"resources could be inodes or disk blocks, depending on the filesystem "
+"implementation."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/symlink.2:118
msgid "Too many symbolic links were encountered in resolving I<newpath>."
msgstr ""
#. type: Plain text
-#: build/C/man2/symlink.2:123
+#: build/C/man2/symlink.2:128
msgid ""
"A directory component in I<newpath> does not exist or is a dangling symbolic "
"link, or I<oldpath> is the empty string."
msgstr ""
#. type: Plain text
-#: build/C/man2/symlink.2:135
+#: build/C/man2/symlink.2:140
msgid "A component used as a directory in I<newpath> is not, in fact, a directory."
msgstr ""
#. type: Plain text
-#: build/C/man2/symlink.2:140
+#: build/C/man2/symlink.2:145
msgid ""
-"The file system containing I<newpath> does not support the creation of "
+"The filesystem containing I<newpath> does not support the creation of "
"symbolic links."
msgstr ""
#. type: Plain text
-#: build/C/man2/symlink.2:144
-msgid "I<newpath> is on a read-only file system."
+#: build/C/man2/symlink.2:149
+msgid "I<newpath> is on a read-only filesystem."
msgstr ""
#. type: Plain text
-#: build/C/man2/symlink.2:154
+#: build/C/man2/symlink.2:159
msgid "No checking of I<oldpath> is done."
msgstr ""
#. type: Plain text
-#: build/C/man2/symlink.2:159
+#: build/C/man2/symlink.2:164
msgid ""
"Deleting the name referred to by a symlink will actually delete the file "
"(unless it also has other hard links). If this behavior is not desired, use "
msgstr ""
#. type: Plain text
-#: build/C/man2/symlink.2:171
+#: build/C/man2/symlink.2:176
msgid ""
"B<ln>(1), B<lchown>(2), B<link>(2), B<lstat>(2), B<open>(2), B<readlink>(2), "
"B<rename>(2), B<symlinkat>(2), B<unlink>(2), B<path_resolution>(7), "
msgstr ""
#. type: TH
-#: build/C/man7/symlink.7:35
+#: build/C/man7/symlink.7:36
#, no-wrap
msgid "2008-06-18"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:38
+#: build/C/man7/symlink.7:39
msgid "symlink - symbolic link handling"
msgstr ""
#. type: SH
-#: build/C/man7/symlink.7:38
+#: build/C/man7/symlink.7:39
#, no-wrap
msgid "SYMBOLIC LINK HANDLING"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:42
+#: build/C/man7/symlink.7:43
msgid ""
"Symbolic links are files that act as pointers to other files. To understand "
"their behavior, you must first understand how hard links work."
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:58
+#: build/C/man7/symlink.7:59
msgid ""
"A hard link to a file is indistinguishable from the original file because it "
"is a reference to the object underlying the original filename. (To be "
"precise: each of the hard links to a file is a reference to the same "
"I<i-node number>, where an i-node number is an index into the i-node table, "
-"which contains metadata about all files on a file system. See B<stat>(2).) "
+"which contains metadata about all files on a filesystem. See B<stat>(2).) "
"Changes to a file are independent of the name used to reference the file. "
"Hard links may not refer to directories (to prevent the possibility of loops "
-"within the file system tree, which would confuse many programs) and may not "
-"refer to files on different file systems (because i-node numbers are not "
-"unique across file systems)."
+"within the filesystem tree, which would confuse many programs) and may not "
+"refer to files on different filesystems (because i-node numbers are not "
+"unique across filesystems)."
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:65
+#: build/C/man7/symlink.7:66
msgid ""
"A symbolic link is a special type of file whose contents are a string that "
"is the pathname another file, the file to which the link refers. In other "
"words, a symbolic link is a pointer to another name, and not to an "
"underlying object. For this reason, symbolic links may refer to directories "
-"and may cross file system boundaries."
+"and may cross filesystem boundaries."
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:71
+#: build/C/man7/symlink.7:72
msgid ""
"There is no requirement that the pathname referred to by a symbolic link "
"should exist. A symbolic link that refers to a pathname that does not exist "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:83
+#: build/C/man7/symlink.7:84
msgid ""
-"Because a symbolic link and its referenced object coexist in the file system "
+"Because a symbolic link and its referenced object coexist in the filesystem "
"name space, confusion can arise in distinguishing between the link itself "
"and the referenced object. On historical systems, commands and system calls "
"adopted their own link-following conventions in a somewhat ad-hoc fashion. "
msgstr ""
#. type: SS
-#: build/C/man7/symlink.7:83
+#: build/C/man7/symlink.7:84
#, no-wrap
msgid "Symbolic link ownership, permissions, and timestamps"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:91
+#: build/C/man7/symlink.7:92
msgid ""
"The owner and group of an existing symbolic link can be changed using "
"B<lchown>(2). The only time that the ownership of a symbolic link matters "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:97
+#: build/C/man7/symlink.7:98
msgid ""
"The last access and last modification timestamps of a symbolic link can be "
"changed using B<utimensat>(2) or B<lutimes>(3)."
#. .BR chown (2)
#. became apparent.
#. type: Plain text
-#: build/C/man7/symlink.7:116
+#: build/C/man7/symlink.7:117
msgid ""
"On Linux, the permissions of a symbolic link are not used in any operations; "
"the permissions are always 0777 (read, write, and execute for all user "
msgstr ""
#. type: SS
-#: build/C/man7/symlink.7:116
+#: build/C/man7/symlink.7:117
#, no-wrap
msgid "Handling of symbolic links by system calls and commands"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:131
+#: build/C/man7/symlink.7:132
msgid ""
"Symbolic links are handled either by operating on the link itself, or by "
"operating on the object referred to by the link. In the latter case, an "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:134
+#: build/C/man7/symlink.7:135
msgid ""
"There are three separate areas that need to be discussed. They are as "
"follows:"
msgstr ""
#. type: IP
-#: build/C/man7/symlink.7:134
+#: build/C/man7/symlink.7:135
#, no-wrap
msgid "1."
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:136
+#: build/C/man7/symlink.7:137
msgid "Symbolic links used as filename arguments for system calls."
msgstr ""
#. type: IP
-#: build/C/man7/symlink.7:136
+#: build/C/man7/symlink.7:137
#, no-wrap
msgid "2."
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:139
+#: build/C/man7/symlink.7:140
msgid ""
"Symbolic links specified as command-line arguments to utilities that are not "
"traversing a file tree."
msgstr ""
#. type: IP
-#: build/C/man7/symlink.7:139
+#: build/C/man7/symlink.7:140
#, no-wrap
msgid "3."
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:143
+#: build/C/man7/symlink.7:144
msgid ""
"Symbolic links encountered by utilities that are traversing a file tree "
"(either specified on the command line or encountered as part of the file "
msgstr ""
#. type: SS
-#: build/C/man7/symlink.7:143
+#: build/C/man7/symlink.7:144
#, no-wrap
msgid "System calls"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:146
+#: build/C/man7/symlink.7:147
msgid ""
"The first area is symbolic links used as filename arguments for system "
"calls."
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:156
+#: build/C/man7/symlink.7:157
msgid ""
"Except as noted below, all system calls follow symbolic links. For example, "
"if there were a symbolic link I<slink> which pointed to a file named "
#. Maybe one day: .BR fchownat (2)
#. type: Plain text
-#: build/C/man7/symlink.7:206
+#: build/C/man7/symlink.7:207
msgid ""
"Various system calls do not follow links, and operate on the symbolic link "
"itself. They are: B<lchown>(2), B<lgetxattr>(2), B<llistxattr>(2), "
msgstr ""
#. type: SS
-#: build/C/man7/symlink.7:206
+#: build/C/man7/symlink.7:207
#, no-wrap
msgid "Commands not traversing a file tree"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:209
+#: build/C/man7/symlink.7:210
msgid ""
"The second area is symbolic links, specified as command-line filename "
"arguments, to commands which are not traversing a file tree."
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:220
+#: build/C/man7/symlink.7:221
msgid ""
"Except as noted below, commands follow symbolic links named as command-line "
"arguments. For example, if there were a symbolic link I<slink> which "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:228
+#: build/C/man7/symlink.7:229
msgid ""
"It is important to realize that this rule includes commands which may "
"optionally traverse file trees, e.g., the command I<chown file> is included "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:246
+#: build/C/man7/symlink.7:247
msgid ""
"If it is explicitly intended that the command operate on the symbolic link "
"instead of following the symbolic link, e.g., it is desired that I<chown "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:248
+#: build/C/man7/symlink.7:249
msgid "There are some exceptions to this rule:"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:258
+#: build/C/man7/symlink.7:259
msgid ""
"The B<mv>(1) and B<rm>(1) commands do not follow symbolic links named as "
"arguments, but respectively attempt to rename and delete them. (Note, if "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:288
+#: build/C/man7/symlink.7:289
msgid ""
"The B<ls>(1) command is also an exception to this rule. For compatibility "
"with historic systems (when B<ls>(1) is not doing a tree walk, i.e., the "
#. .BR chgrp (1)
#. commands follow symbolic links specified on the command line.
#. type: Plain text
-#: build/C/man7/symlink.7:306
+#: build/C/man7/symlink.7:307
msgid ""
"The B<file>(1) command is also an exception to this rule. The B<file>(1) "
"command does not follow symbolic links named as argument by default. The "
msgstr ""
#. type: SS
-#: build/C/man7/symlink.7:306
+#: build/C/man7/symlink.7:307
#, no-wrap
msgid "Commands traversing a file tree"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:319
+#: build/C/man7/symlink.7:320
msgid ""
"The following commands either optionally or always traverse file trees: "
"B<chgrp>(1), B<chmod>(1), B<chown>(1), B<cp>(1), B<du>(1), B<find>(1), "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:323
+#: build/C/man7/symlink.7:324
msgid ""
"It is important to realize that the following rules apply equally to "
"symbolic links encountered during the file tree traversal and symbolic links "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:328
+#: build/C/man7/symlink.7:329
msgid ""
"The I<first rule> applies to symbolic links that reference files other than "
"directories. Operations that apply to symbolic links are performed on the "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:340
+#: build/C/man7/symlink.7:341
msgid ""
"The command I<rm\\ -r slink directory> will remove I<slink>, as well as any "
"symbolic links encountered in the tree traversal of I<directory>, because "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:345
+#: build/C/man7/symlink.7:346
msgid ""
"The I<second rule> applies to symbolic links that refer to directories. "
"Symbolic links that refer to directories are never followed by default. "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:348
+#: build/C/man7/symlink.7:349
msgid ""
"Certain conventions are (should be) followed as consistently as possible by "
"commands that perform file tree walks:"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:361
+#: build/C/man7/symlink.7:362
msgid ""
"A command can be made to follow any symbolic links named on the command "
"line, regardless of the type of file they reference, by specifying the I<-H> "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:377
+#: build/C/man7/symlink.7:378
msgid ""
"For example, the command I<chown\\ -HR user slink> will traverse the file "
"hierarchy rooted in the file pointed to by I<slink>. Note, the I<-H> is not "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:391
+#: build/C/man7/symlink.7:392
msgid ""
"A command can be made to follow any symbolic links named on the command "
"line, as well as any symbolic links encountered during the traversal, "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:406
+#: build/C/man7/symlink.7:407
msgid ""
"For example, the command I<chown\\ -LR user slink> will change the owner of "
"the file referred to by I<slink>. If I<slink> refers to a directory, "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:413
+#: build/C/man7/symlink.7:414
msgid ""
"A command can be made to provide the default behavior by specifying the "
"I<-P> (for \"physical\") flag. This flag is intended to make the entire "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:431
+#: build/C/man7/symlink.7:432
msgid ""
"For commands that do not by default do file tree traversals, the I<-H>, "
"I<-L>, and I<-P> flags are ignored if the I<-R> flag is not also specified. "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:437
+#: build/C/man7/symlink.7:438
msgid "The B<ls>(1) and B<rm>(1) commands have exceptions to these rules:"
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:450
+#: build/C/man7/symlink.7:451
msgid ""
"The B<rm>(1) command operates on the symbolic link, and not the file it "
"references, and therefore never follows a symbolic link. The B<rm>(1) "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:470
+#: build/C/man7/symlink.7:471
msgid ""
"To maintain compatibility with historic systems, the B<ls>(1) command acts "
"a little differently. If you do not specify the I<-F>, I<-d> or I<-l> "
msgstr ""
#. type: Plain text
-#: build/C/man7/symlink.7:488
+#: build/C/man7/symlink.7:489
msgid ""
"B<chgrp>(1), B<chmod>(1), B<find>(1), B<ln>(1), B<ls>(1), B<mv>(1), "
"B<rm>(1), B<lchown>(2), B<link>(2), B<lstat>(2), B<readlink>(2), "
msgstr ""
#. type: TH
-#: build/C/man3/tempnam.3:23
+#: build/C/man3/tempnam.3:25
#, no-wrap
msgid "TEMPNAM"
msgstr ""
-#. type: TH
-#: build/C/man3/tempnam.3:23
-#, no-wrap
-msgid "2008-08-06"
-msgstr ""
-
#. type: Plain text
-#: build/C/man3/tempnam.3:26
+#: build/C/man3/tempnam.3:28
msgid "tempnam - create a name for a temporary file"
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:31
+#: build/C/man3/tempnam.3:33
#, no-wrap
msgid "B<char *tempnam(const char *>I<dir>B<, const char *>I<pfx>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:40
+#: build/C/man3/tempnam.3:42
msgid "B<tempnam>(): _BSD_SOURCE || _SVID_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:54
+#: build/C/man3/tempnam.3:56
msgid ""
"The B<tempnam>() function returns a pointer to a string that is a valid "
"filename, and such that a file with this name did not exist when "
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:57
+#: build/C/man3/tempnam.3:59
msgid "Attempts to find an appropriate directory go through the following steps:"
msgstr ""
#. type: TP
-#: build/C/man3/tempnam.3:57
+#: build/C/man3/tempnam.3:59
#, no-wrap
msgid "a)"
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:63
+#: build/C/man3/tempnam.3:65
msgid ""
"In case the environment variable B<TMPDIR> exists and contains the name of "
"an appropriate directory, that is used."
msgstr ""
#. type: TP
-#: build/C/man3/tempnam.3:63
+#: build/C/man3/tempnam.3:65
#, no-wrap
msgid "b)"
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:68
+#: build/C/man3/tempnam.3:70
msgid "Otherwise, if the I<dir> argument is non-NULL and appropriate, it is used."
msgstr ""
#. type: TP
-#: build/C/man3/tempnam.3:68
+#: build/C/man3/tempnam.3:70
#, no-wrap
msgid "c)"
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:75
+#: build/C/man3/tempnam.3:77
msgid ""
"Otherwise, I<P_tmpdir> (as defined in I<E<lt>stdio.hE<gt>>) is used when "
"appropriate."
msgstr ""
#. type: TP
-#: build/C/man3/tempnam.3:75
+#: build/C/man3/tempnam.3:77
#, no-wrap
msgid "d)"
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:78
+#: build/C/man3/tempnam.3:80
msgid "Finally an implementation-defined directory may be used."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:85
+#: build/C/man3/tempnam.3:87
msgid ""
"The string returned by B<tempnam>() is allocated using B<malloc>(3) and "
"hence should be freed by B<free>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:90
+#: build/C/man3/tempnam.3:94
msgid ""
-"The B<tempnam>() function returns a pointer to a unique temporary filename, "
-"or NULL if a unique name cannot be generated."
+"On success, the B<tempnam>() function returns a pointer to a unique "
+"temporary filename. It returns NULL if a unique name cannot be generated, "
+"with I<errno> set to indicate the cause of the error."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:94
+#: build/C/man3/tempnam.3:98
msgid "Allocation of storage failed."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:99
+#: build/C/man3/tempnam.3:103
msgid "SVr4, 4.3BSD, POSIX.1-2001. POSIX.1-2008 marks B<tempnam>() as obsolete."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:118
+#: build/C/man3/tempnam.3:122
msgid ""
"Although B<tempnam>() generates names that are difficult to guess, it is "
"nevertheless possible that between the time that B<tempnam>() returns a "
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:126
+#: build/C/man3/tempnam.3:130
msgid ""
"SUSv2 does not mention the use of B<TMPDIR>; glibc will use it only when the "
"program is not set-user-ID. On SVr4, the directory used under B<d)> is "
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:131
+#: build/C/man3/tempnam.3:135
msgid ""
"Because it dynamically allocates memory used to return the pathname, "
"B<tempnam>() is reentrant, and thus thread safe, unlike B<tmpnam>(3)."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:144
+#: build/C/man3/tempnam.3:148
msgid ""
"The B<tempnam>() function generates a different string each time it is "
"called, up to B<TMP_MAX> (defined in I<E<lt>stdio.hE<gt>>) times. If it is "
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:148
+#: build/C/man3/tempnam.3:152
msgid "B<tempnam>() uses at most the first five bytes from I<pfx>."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:154
+#: build/C/man3/tempnam.3:158
msgid ""
"The glibc implementation of B<tempnam>() will fail with the error B<EEXIST> "
"upon failure to find a unique name."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:157
+#: build/C/man3/tempnam.3:161
msgid ""
"The precise meaning of \"appropriate\" is undefined; it is unspecified how "
"accessibility of a directory is determined."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:164 build/C/man3/tmpnam.3:151
+#: build/C/man3/tempnam.3:168 build/C/man3/tmpnam.3:163
msgid "Never use this function. Use B<mkstemp>(3) or B<tmpfile>(3) instead."
msgstr ""
#. type: Plain text
-#: build/C/man3/tempnam.3:169
+#: build/C/man3/tempnam.3:173
msgid "B<mkstemp>(3), B<mktemp>(3), B<tmpfile>(3), B<tmpnam>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/tmpfile.3:29
+#: build/C/man3/tmpfile.3:31
#, no-wrap
msgid "TMPFILE"
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:32
+#: build/C/man3/tmpfile.3:34
msgid "tmpfile - create a temporary file"
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:37
+#: build/C/man3/tmpfile.3:39
#, no-wrap
msgid "B<FILE *tmpfile(void);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:45
+#: build/C/man3/tmpfile.3:47
msgid ""
"The B<tmpfile>() function opens a unique temporary file in binary "
"read/write (w+b) mode. The file will be automatically deleted when it is "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:52
+#: build/C/man3/tmpfile.3:56
msgid ""
"The B<tmpfile>() function returns a stream descriptor, or NULL if a unique "
"filename cannot be generated or the unique file cannot be opened. In the "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:56
+#: build/C/man3/tmpfile.3:60
msgid "Search permission denied for directory in file's path prefix."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:59
+#: build/C/man3/tmpfile.3:63
msgid "Unable to generate a unique filename."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:62
+#: build/C/man3/tmpfile.3:66
msgid "The call was interrupted by a signal."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:65
+#: build/C/man3/tmpfile.3:69
msgid "Too many file descriptors in use by the process."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:68
+#: build/C/man3/tmpfile.3:72
msgid "Too many files open in the system."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:71
+#: build/C/man3/tmpfile.3:75
msgid "There was no room in the directory to add the new filename."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:74
-msgid "Read-only file system."
+#: build/C/man3/tmpfile.3:78
+msgid "Read-only filesystem."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:76
+#: build/C/man3/tmpfile.3:80
msgid "SVr4, 4.3BSD, C89, C99, SUSv2, POSIX.1-2001."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:80
+#: build/C/man3/tmpfile.3:86
msgid ""
"POSIX.1-2001 specifies: an error message may be written to I<stdout> if the "
"stream cannot be opened."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:86
+#: build/C/man3/tmpfile.3:97
msgid ""
"The standard does not specify the directory that B<tmpfile>() will use. "
"Glibc will try the path prefix I<P_tmpdir> defined in I<E<lt>stdio.hE<gt>>, "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpfile.3:92
+#: build/C/man3/tmpfile.3:103
msgid "B<exit>(3), B<mkstemp>(3), B<mktemp>(3), B<tempnam>(3), B<tmpnam>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/tmpnam.3:25
+#: build/C/man3/tmpnam.3:27
#, no-wrap
msgid "TMPNAM"
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:28
+#: build/C/man3/tmpnam.3:30
msgid "tmpnam, tmpnam_r - create a name for a temporary file"
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:33
+#: build/C/man3/tmpnam.3:35
#, no-wrap
msgid "B<char *tmpnam(char *>I<s>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:56
+#: build/C/man3/tmpnam.3:58
msgid ""
"The B<tmpnam>() function returns a pointer to a string that is a valid "
"filename, and such that a file with this name did not exist at some point in "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:68
+#: build/C/man3/tmpnam.3:70
msgid ""
"The pathname that is created, has a directory prefix I<P_tmpdir>. (Both "
"I<L_tmpnam> and I<P_tmpdir> are defined in I<E<lt>stdio.hE<gt>>, just like "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:73
+#: build/C/man3/tmpnam.3:75
msgid ""
"The B<tmpnam>() function returns a pointer to a unique temporary filename, "
"or NULL if a unique name cannot be generated."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:75
+#: build/C/man3/tmpnam.3:77
msgid "No errors are defined."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:80
+#: build/C/man3/tmpnam.3:83
+msgid ""
+"The B<tmpnam>() function is thread-safe with exceptions. It is not "
+"thread-safe if called with a NULL parameter."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/tmpnam.3:87
+msgid "The B<tmpnam_r>() function is thread-safe."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man3/tmpnam.3:92
msgid ""
"SVr4, 4.3BSD, C89, C99, POSIX.1-2001. POSIX.1-2008 marks B<tmpnam>() as "
"obsolete."
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:91
+#: build/C/man3/tmpnam.3:103
msgid ""
"The B<tmpnam>() function generates a different string each time it is "
"called, up to B<TMP_MAX> times. If it is called more than B<TMP_MAX> times, "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:110
+#: build/C/man3/tmpnam.3:122
msgid ""
"Although B<tmpnam>() generates names that are difficult to guess, it is "
"nevertheless possible that between the time that B<tmpnam>() returns a "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:118
+#: build/C/man3/tmpnam.3:130
msgid ""
"Portable applications that use threads cannot call B<tmpnam>() with a NULL "
"argument if either B<_POSIX_THREADS> or B<_POSIX_THREAD_SAFE_FUNCTIONS> is "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:122
+#: build/C/man3/tmpnam.3:134
msgid "A POSIX draft proposed to use a function B<tmpnam_r>() defined by"
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:130
+#: build/C/man3/tmpnam.3:142
#, no-wrap
msgid ""
"char *\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:144
+#: build/C/man3/tmpnam.3:156
msgid ""
"apparently as a warning not to use NULL. A few systems implement it. To "
"get a glibc prototype for this function from I<E<lt>stdio.hE<gt>>, define "
msgstr ""
#. type: Plain text
-#: build/C/man3/tmpnam.3:156
+#: build/C/man3/tmpnam.3:168
msgid "B<mkstemp>(3), B<mktemp>(3), B<tempnam>(3), B<tmpfile>(3)"
msgstr ""
#. type: Plain text
#: build/C/man2/unlink.2:45
msgid ""
-"B<unlink>() deletes a name from the file system. If that name was the last "
+"B<unlink>() deletes a name from the filesystem. If that name was the last "
"link to a file and no processes have the file open the file is deleted and "
"the space it was using is made available for reuse."
msgstr ""
#. type: Plain text
#: build/C/man2/unlink.2:126
-msgid "The file system does not allow unlinking of files."
+msgid "The filesystem does not allow unlinking of files."
msgstr ""
#. type: Plain text
#. type: Plain text
#: build/C/man2/unlink.2:141
-msgid "I<pathname> refers to a file on a read-only file system."
+msgid "I<pathname> refers to a file on a read-only filesystem."
msgstr ""
#. type: Plain text
msgstr ""
#. type: TH
-#: build/C/man3/unlocked_stdio.3:23
+#: build/C/man3/unlocked_stdio.3:25
#, no-wrap
msgid "UNLOCKED_STDIO"
msgstr ""
+#. type: TH
+#: build/C/man3/unlocked_stdio.3:25
+#, no-wrap
+msgid "2008-08-29"
+msgstr ""
+
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:27
+#: build/C/man3/unlocked_stdio.3:29
msgid ""
"getc_unlocked, getchar_unlocked, putc_unlocked, putchar_unlocked - "
"nonlocking stdio functions"
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:35
+#: build/C/man3/unlocked_stdio.3:37
#, no-wrap
msgid ""
"B<int getc_unlocked(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:47
+#: build/C/man3/unlocked_stdio.3:49
#, no-wrap
msgid ""
"B<void clearerr_unlocked(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:50
+#: build/C/man3/unlocked_stdio.3:52
#, no-wrap
msgid ""
"B<char *fgets_unlocked(char *>I<s>B<, int >I<n>B<, FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:61
+#: build/C/man3/unlocked_stdio.3:63
#, no-wrap
msgid ""
"B<wint_t getwc_unlocked(FILE *>I<stream>B<);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:73
+#: build/C/man3/unlocked_stdio.3:75
msgid ""
"B<getc_unlocked>(), B<getchar_unlocked>(), B<putc_unlocked>(), "
"B<putchar_unlocked>():"
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:76
+#: build/C/man3/unlocked_stdio.3:78
msgid ""
"_POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE || "
"_BSD_SOURCE || _SVID_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:87
+#: build/C/man3/unlocked_stdio.3:89
msgid ""
"B<clearerr_unlocked>(), B<feof_unlocked>(), B<ferror_unlocked>(), "
"B<fileno_unlocked>(), B<fflush_unlocked>(), B<fgetc_unlocked>(), "
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:89
+#: build/C/man3/unlocked_stdio.3:91
msgid "_BSD_SOURCE || _SVID_SOURCE"
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:100
+#: build/C/man3/unlocked_stdio.3:102
msgid ""
"B<fgets_unlocked>(), B<fputs_unlocked>(), B<getwc_unlocked>(), "
"B<getwchar_unlocked>(), B<fgetwc_unlocked>(), B<fputwc_unlocked>(), "
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:111
+#: build/C/man3/unlocked_stdio.3:113
msgid ""
"Each of these functions has the same behavior as its counterpart without the "
"\"_unlocked\" suffix, except that they do not use locking (they do not set "
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:118
+#: build/C/man3/unlocked_stdio.3:120
msgid ""
"The four functions B<getc_unlocked>(), B<getchar_unlocked>(), "
"B<putc_unlocked>(), B<putchar_unlocked>() are in POSIX.1-2001."
#. putwc_unlocked, putwchar_unlocked, rewind_unlocked, setvbuf_unlocked,
#. ungetc_unlocked, ungetwc_unlocked.
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:134
+#: build/C/man3/unlocked_stdio.3:136
msgid ""
"The nonstandard B<*_unlocked>() variants occur on a few UNIX systems, and "
"are available in recent glibc. They should probably not be used."
msgstr ""
#. type: Plain text
-#: build/C/man3/unlocked_stdio.3:137
+#: build/C/man3/unlocked_stdio.3:139
msgid "B<flockfile>(3), B<stdio>(3)"
msgstr ""
#. type: TH
-#: build/C/man3/wprintf.3:14
+#: build/C/man3/wprintf.3:16
#, no-wrap
msgid "WPRINTF"
msgstr ""
#. type: TH
-#: build/C/man3/wprintf.3:14
+#: build/C/man3/wprintf.3:16
#, no-wrap
msgid "2011-09-17"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:18
+#: build/C/man3/wprintf.3:20
msgid ""
"wprintf, fwprintf, swprintf, vwprintf, vfwprintf, vswprintf - formatted "
"wide-character output conversion"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:22
+#: build/C/man3/wprintf.3:24
#, no-wrap
msgid ""
"B<#include E<lt>stdio.hE<gt>>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:27
+#: build/C/man3/wprintf.3:29
#, no-wrap
msgid ""
"B<int wprintf(const wchar_t *>I<format>B<, ...);>\n"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:32
+#: build/C/man3/wprintf.3:34
#, no-wrap
msgid ""
"B<int vwprintf(const wchar_t *>I<format>B<, va_list >I<args>B<);>\n"
#. .BR vfwprintf (),
#. .BR vswprintf ():
#. type: Plain text
-#: build/C/man3/wprintf.3:49
+#: build/C/man3/wprintf.3:51
msgid "_XOPEN_SOURCE\\ E<gt>=\\ 500 || _ISOC99_SOURCE ||"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:51
+#: build/C/man3/wprintf.3:53
msgid "_ISOC95_SOURCE /* Since glibc 2.12 */ ||"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:53
+#: build/C/man3/wprintf.3:55
msgid "_POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:56
+#: build/C/man3/wprintf.3:58
msgid "or I<cc\\ -std=c99>"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:67
+#: build/C/man3/wprintf.3:69
msgid ""
"The B<wprintf>() family of functions is the wide-character equivalent of "
"the B<printf>(3) family of functions. It performs formatted output of wide "
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:77
+#: build/C/man3/wprintf.3:81
msgid ""
"The B<wprintf>() and B<vwprintf>() functions perform wide-character output "
"to I<stdout>. I<stdout> must not be byte oriented; see B<fwide>(3) for "
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:87
+#: build/C/man3/wprintf.3:93
msgid ""
"The B<fwprintf>() and B<vfwprintf>() functions perform wide-character "
"output to I<stream>. I<stream> must not be byte oriented; see B<fwide>(3) "
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:98
+#: build/C/man3/wprintf.3:107
msgid ""
"The B<swprintf>() and B<vswprintf>() functions perform wide-character "
"output to an array of wide characters. The programmer must ensure that "
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:109
+#: build/C/man3/wprintf.3:118
msgid ""
"These functions are like the B<printf>(3), B<vprintf>(3), B<fprintf>(3), "
"B<vfprintf>(3), B<sprintf>(3), B<vsprintf>(3) functions except for the "
msgstr ""
#. type: TP
-#: build/C/man3/wprintf.3:109 build/C/man3/wprintf.3:112 build/C/man3/wprintf.3:115
+#: build/C/man3/wprintf.3:118 build/C/man3/wprintf.3:123 build/C/man3/wprintf.3:126
#, no-wrap
msgid "B<\\(bu>"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:112
+#: build/C/man3/wprintf.3:123
msgid "The I<format> string is a wide-character string."
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:115
+#: build/C/man3/wprintf.3:126
msgid "The output consists of wide characters, not bytes."
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:130
+#: build/C/man3/wprintf.3:145
msgid ""
"B<swprintf>() and B<vswprintf>() take a I<maxlen> argument, B<sprintf>(3) "
"and B<vsprintf>(3) do not. (B<snprintf>(3) and B<vsnprintf>(3) take a "
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:132
+#: build/C/man3/wprintf.3:151
msgid "The treatment of the conversion characters B<c> and B<s> is different:"
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:146
+#: build/C/man3/wprintf.3:165
msgid ""
"If no B<l> modifier is present, the I<int> argument is converted to a wide "
"character by a call to the B<btowc>(3) function, and the resulting wide "
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:185
+#: build/C/man3/wprintf.3:205
msgid ""
"If no B<l> modifier is present: The I<const\\ char\\ *> argument is expected "
"to be a pointer to an array of character type (pointer to a string) "
"state. Characters from the array are converted to wide characters (each by "
"a call to the B<mbrtowc>(3) function with a conversion state starting in "
"the initial state before the first byte). The resulting wide characters are "
-"written up to (but not including) the terminating null wide character. If a "
-"precision is specified, no more wide characters than the number specified "
-"are written. Note that the precision determines the number of I<wide "
-"characters> written, not the number of I<bytes> or I<screen positions>. The "
-"array must contain a terminating null byte, unless a precision is given and "
-"it is so small that the number of converted wide characters reaches it "
-"before the end of the array is reached. If an B<l> modifier is present: The "
-"I<const\\ wchar_t\\ *> argument is expected to be a pointer to an array of "
-"wide characters. Wide characters from the array are written up to (but not "
-"including) a terminating null wide character. If a precision is specified, "
-"no more than the number specified are written. The array must contain a "
-"terminating null wide character, unless a precision is given and it is "
-"smaller than or equal to the number of wide characters in the array."
+"written up to (but not including) the terminating null wide character "
+"(L\\(aq\\e0\\(aq). If a precision is specified, no more wide characters "
+"than the number specified are written. Note that the precision determines "
+"the number of I<wide characters> written, not the number of I<bytes> or "
+"I<screen positions>. The array must contain a terminating null byte "
+"(\\(aq\\e0\\(aq), unless a precision is given and it is so small that the "
+"number of converted wide characters reaches it before the end of the array "
+"is reached. If an B<l> modifier is present: The I<const\\ wchar_t\\ *> "
+"argument is expected to be a pointer to an array of wide characters. Wide "
+"characters from the array are written up to (but not including) a "
+"terminating null wide character. If a precision is specified, no more than "
+"the number specified are written. The array must contain a terminating null "
+"wide character, unless a precision is given and it is smaller than or equal "
+"to the number of wide characters in the array."
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:193
+#: build/C/man3/wprintf.3:213
msgid ""
"The functions return the number of wide characters written, excluding the "
"terminating null wide character in case of the functions B<swprintf>() and "
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:195
+#: build/C/man3/wprintf.3:215
msgid "C99."
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:203
+#: build/C/man3/wprintf.3:223
msgid ""
"The behavior of B<wprintf>() et al. depends on the B<LC_CTYPE> category of "
"the current locale."
msgstr ""
#. type: Plain text
-#: build/C/man3/wprintf.3:229
+#: build/C/man3/wprintf.3:253
msgid ""
"If the I<format> string contains non-ASCII wide characters, the program will "
-"only work correctly if the B<LC_CTYPE> category of the current locale at run "
+"work correctly only if the B<LC_CTYPE> category of the current locale at run "
"time is the same as the B<LC_CTYPE> category of the current locale at "
"compile time. This is because the I<wchar_t> representation is platform- "
"and locale-dependent. (The glibc represents wide characters using their "
#. .BR wscanf (3)
#. type: Plain text
-#: build/C/man3/wprintf.3:236
+#: build/C/man3/wprintf.3:260
msgid "B<fprintf>(3), B<fputwc>(3), B<fwide>(3), B<printf>(3), B<snprintf>(3)"
msgstr ""
msgid "WRITE"
msgstr ""
-#. type: TH
-#: build/C/man2/write.2:39
-#, no-wrap
-msgid "2010-08-29"
-msgstr ""
-
#. type: Plain text
#: build/C/man2/write.2:42
msgid "write - write to a file descriptor"
#: build/C/man2/write.2:89
msgid ""
"POSIX requires that a B<read>(2) which can be proved to occur after a "
-"B<write>() has returned returns the new data. Note that not all file "
-"systems are POSIX conforming."
+"B<write>() has returned returns the new data. Note that not all "
+"filesystems are POSIX conforming."
msgstr ""
#. type: Plain text
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:144
+#: build/C/man2/write.2:141
+msgid ""
+"The user's quota of disk blocks on the filesystem containing the file "
+"referred to by I<fd> has been exhausted."
+msgstr ""
+
+#. type: Plain text
+#: build/C/man2/write.2:150
msgid ""
"An attempt was made to write a file that exceeds the implementation-defined "
"maximum file size or the process's file size limit, or to write at a "
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:148
+#: build/C/man2/write.2:154
msgid ""
"The call was interrupted by a signal before any data was written; see "
"B<signal>(7)."
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:159
+#: build/C/man2/write.2:165
msgid ""
"I<fd> is attached to an object which is unsuitable for writing; or the file "
"was opened with the B<O_DIRECT> flag, and either the address specified in "
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:162
+#: build/C/man2/write.2:168
msgid "A low-level I/O error occurred while modifying the inode."
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:167
+#: build/C/man2/write.2:173
msgid ""
"The device containing the file referred to by I<fd> has no room for the "
"data."
msgstr ""
#. type: TP
-#: build/C/man2/write.2:167
+#: build/C/man2/write.2:173
#, no-wrap
msgid "B<EPIPE>"
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:176
+#: build/C/man2/write.2:182
msgid ""
"I<fd> is connected to a pipe or socket whose reading end is closed. When "
"this happens the writing process will also receive a B<SIGPIPE> signal. "
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:179
+#: build/C/man2/write.2:185
msgid "Other errors may occur, depending on the object connected to I<fd>."
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:188
+#: build/C/man2/write.2:194
msgid ""
"Under SVr4 a write may be interrupted and return B<EINTR> at any point, not "
"just before any data is written."
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:197
+#: build/C/man2/write.2:203
msgid ""
"A successful return from B<write>() does not make any guarantee that data "
"has been committed to disk. In fact, on some buggy implementations, it does "
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:205
+#: build/C/man2/write.2:211
msgid ""
"If a B<write>() is interrupted by a signal handler before any bytes are "
"written, then the call fails with the error B<EINTR>; if it is interrupted "
msgstr ""
#. type: Plain text
-#: build/C/man2/write.2:217
+#: build/C/man2/write.2:223
msgid ""
"B<close>(2), B<fcntl>(2), B<fsync>(2), B<ioctl>(2), B<lseek>(2), B<open>(2), "
"B<pwrite>(2), B<read>(2), B<select>(2), B<writev>(2), B<fwrite>(3)"
OSDN Git Service
