# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2012-03-22 04:26+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"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: build/C/man3/MB_CUR_MAX.3:15
#, no-wrap
msgid "MB_CUR_MAX"
msgstr ""

#. type: TH
#: build/C/man3/MB_CUR_MAX.3:15 build/C/man3/MB_LEN_MAX.3:15
#, no-wrap
msgid "1999-07-04"
msgstr ""

#. type: TH
#: build/C/man3/MB_CUR_MAX.3:15 build/C/man3/MB_LEN_MAX.3:15 build/C/man2/_exit.2:29 build/C/man3/atexit.3:31 build/C/man3/clearenv.3:24 build/C/man3/exit.3:23 build/C/man3/getloadavg.3:32 build/C/man3/strtod.3:43
#, no-wrap
msgid "Linux"
msgstr ""

#. type: TH
#: build/C/man3/MB_CUR_MAX.3:15 build/C/man3/MB_LEN_MAX.3:15 build/C/man2/_exit.2:29 build/C/man3/a64l.3:6 build/C/man3/atexit.3:31 build/C/man3/atof.3:29 build/C/man3/atoi.3:31 build/C/man3/canonicalize_file_name.3:5 build/C/man3/cfree.3:23 build/C/man3/clearenv.3:24 build/C/man3/drand48.3:28 build/C/man3/drand48_r.3:25 build/C/man3/ecvt.3:30 build/C/man3/ecvt_r.3:28 build/C/man3/exit.3:23 build/C/man3/gcvt.3:28 build/C/man3/getenv.3:31 build/C/man3/getloadavg.3:32 build/C/man3/getsubopt.3:23 build/C/man3/malloc.3:28 build/C/man3/mblen.3:14 build/C/man3/mbstowcs.3:14 build/C/man3/mbtowc.3:14 build/C/man3/mkdtemp.3:24 build/C/man3/mkstemp.3:33 build/C/man3/mktemp.3:32 build/C/man3/on_exit.3:29 build/C/man3/putenv.3:34 build/C/man3/qecvt.3:26 build/C/man3/rand.3:39 build/C/man3/random.3:31 build/C/man3/random_r.3:24 build/C/man3/rpmatch.3:27 build/C/man3/setenv.3:35 build/C/man3/strtod.3:43 build/C/man3/strtoimax.3:23 build/C/man3/strtol.3:29 build/C/man3/strtoul.3:31 build/C/man3/system.3:28 build/C/man3/wcstombs.3:14 build/C/man3/wctomb.3:14
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""

#. type: SH
#: build/C/man3/MB_CUR_MAX.3:16 build/C/man3/MB_LEN_MAX.3:16 build/C/man2/_exit.2:30 build/C/man3/a64l.3:7 build/C/man3/atexit.3:32 build/C/man3/atof.3:30 build/C/man3/atoi.3:32 build/C/man3/canonicalize_file_name.3:6 build/C/man3/cfree.3:24 build/C/man3/clearenv.3:25 build/C/man3/drand48.3:29 build/C/man3/drand48_r.3:26 build/C/man3/ecvt.3:31 build/C/man3/ecvt_r.3:29 build/C/man3/exit.3:24 build/C/man3/gcvt.3:29 build/C/man3/getenv.3:32 build/C/man3/getloadavg.3:33 build/C/man3/getsubopt.3:24 build/C/man3/malloc.3:29 build/C/man3/mblen.3:15 build/C/man3/mbstowcs.3:15 build/C/man3/mbtowc.3:15 build/C/man3/mkdtemp.3:25 build/C/man3/mkstemp.3:34 build/C/man3/mktemp.3:33 build/C/man3/on_exit.3:30 build/C/man3/putenv.3:35 build/C/man3/qecvt.3:27 build/C/man3/rand.3:40 build/C/man3/random.3:32 build/C/man3/random_r.3:25 build/C/man3/rpmatch.3:28 build/C/man3/setenv.3:36 build/C/man3/strtod.3:44 build/C/man3/strtoimax.3:24 build/C/man3/strtol.3:30 build/C/man3/strtoul.3:32 build/C/man3/system.3:29 build/C/man3/wcstombs.3:15 build/C/man3/wctomb.3:15
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_CUR_MAX.3:18
msgid "MB_CUR_MAX - maximum length of a multibyte character in the current locale"
msgstr ""

#. type: SH
#: build/C/man3/MB_CUR_MAX.3:18 build/C/man3/MB_LEN_MAX.3:18 build/C/man2/_exit.2:32 build/C/man3/a64l.3:9 build/C/man3/atexit.3:34 build/C/man3/atof.3:32 build/C/man3/atoi.3:34 build/C/man3/canonicalize_file_name.3:8 build/C/man3/cfree.3:26 build/C/man3/clearenv.3:27 build/C/man3/drand48.3:32 build/C/man3/drand48_r.3:30 build/C/man3/ecvt.3:33 build/C/man3/ecvt_r.3:31 build/C/man3/exit.3:26 build/C/man3/gcvt.3:31 build/C/man3/getenv.3:34 build/C/man3/getloadavg.3:35 build/C/man3/getsubopt.3:26 build/C/man3/malloc.3:31 build/C/man3/mblen.3:17 build/C/man3/mbstowcs.3:17 build/C/man3/mbtowc.3:17 build/C/man3/mkdtemp.3:27 build/C/man3/mkstemp.3:36 build/C/man3/mktemp.3:35 build/C/man3/on_exit.3:32 build/C/man3/putenv.3:37 build/C/man3/qecvt.3:29 build/C/man3/rand.3:42 build/C/man3/random.3:34 build/C/man3/random_r.3:28 build/C/man3/rpmatch.3:30 build/C/man3/setenv.3:38 build/C/man3/strtod.3:46 build/C/man3/strtoimax.3:26 build/C/man3/strtol.3:32 build/C/man3/strtoul.3:34 build/C/man3/system.3:31 build/C/man3/wcstombs.3:17 build/C/man3/wctomb.3:17
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_CUR_MAX.3:21 build/C/man3/atexit.3:37 build/C/man3/atof.3:35 build/C/man3/atoi.3:37 build/C/man3/cfree.3:30 build/C/man3/clearenv.3:30 build/C/man3/drand48.3:35 build/C/man3/drand48_r.3:33 build/C/man3/ecvt_r.3:34 build/C/man3/exit.3:29 build/C/man3/gcvt.3:34 build/C/man3/getenv.3:37 build/C/man3/malloc.3:34 build/C/man3/mblen.3:20 build/C/man3/mbstowcs.3:20 build/C/man3/mbtowc.3:20 build/C/man3/mkdtemp.3:30 build/C/man3/mkstemp.3:39 build/C/man3/mktemp.3:38 build/C/man3/on_exit.3:35 build/C/man3/putenv.3:40 build/C/man3/rand.3:45 build/C/man3/random.3:37 build/C/man3/random_r.3:31 build/C/man3/rpmatch.3:33 build/C/man3/setenv.3:41 build/C/man3/strtol.3:35 build/C/man3/strtoul.3:37 build/C/man3/system.3:34 build/C/man3/wcstombs.3:20 build/C/man3/wctomb.3:20
#, no-wrap
msgid "B<#include E<lt>stdlib.hE<gt>>\n"
msgstr ""

#. type: SH
#: build/C/man3/MB_CUR_MAX.3:22 build/C/man3/MB_LEN_MAX.3:22 build/C/man2/_exit.2:55 build/C/man3/a64l.3:30 build/C/man3/atexit.3:40 build/C/man3/atof.3:38 build/C/man3/atoi.3:62 build/C/man3/canonicalize_file_name.3:14 build/C/man3/cfree.3:51 build/C/man3/clearenv.3:41 build/C/man3/drand48.3:73 build/C/man3/drand48_r.3:81 build/C/man3/ecvt.3:67 build/C/man3/ecvt_r.3:62 build/C/man3/exit.3:32 build/C/man3/gcvt.3:62 build/C/man3/getenv.3:40 build/C/man3/getloadavg.3:42 build/C/man3/getsubopt.3:48 build/C/man3/malloc.3:40 build/C/man3/mblen.3:23 build/C/man3/mbstowcs.3:23 build/C/man3/mbtowc.3:23 build/C/man3/mkdtemp.3:52 build/C/man3/mkstemp.3:74 build/C/man3/mktemp.3:64 build/C/man3/on_exit.3:46 build/C/man3/putenv.3:52 build/C/man3/qecvt.3:51 build/C/man3/rand.3:60 build/C/man3/random.3:62 build/C/man3/random_r.3:56 build/C/man3/rpmatch.3:44 build/C/man3/setenv.3:59 build/C/man3/strtod.3:71 build/C/man3/strtoimax.3:34 build/C/man3/strtol.3:57 build/C/man3/strtoul.3:60 build/C/man3/system.3:37 build/C/man3/wcstombs.3:23 build/C/man3/wctomb.3:23
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_CUR_MAX.3:29
msgid ""
"The B<MB_CUR_MAX> macro defines an integer expression giving the maximum "
"number of bytes needed to represent a single wide character in the current "
"locale.  It is locale dependent and therefore not a compile-time constant."
msgstr ""

#. type: SH
#: build/C/man3/MB_CUR_MAX.3:29 build/C/man3/MB_LEN_MAX.3:27 build/C/man2/_exit.2:78 build/C/man3/atexit.3:66 build/C/man3/atof.3:53 build/C/man3/atoi.3:89 build/C/man3/cfree.3:95 build/C/man3/clearenv.3:48 build/C/man3/drand48_r.3:94 build/C/man3/ecvt.3:97 build/C/man3/ecvt_r.3:84 build/C/man3/exit.3:80 build/C/man3/gcvt.3:70 build/C/man3/getenv.3:49 build/C/man3/getloadavg.3:53 build/C/man3/getsubopt.3:108 build/C/man3/malloc.3:127 build/C/man3/mblen.3:58 build/C/man3/mbstowcs.3:58 build/C/man3/mbtowc.3:64 build/C/man3/mkdtemp.3:65 build/C/man3/mkstemp.3:136 build/C/man3/mktemp.3:75 build/C/man3/on_exit.3:67 build/C/man3/putenv.3:65 build/C/man3/rand.3:116 build/C/man3/random.3:116 build/C/man3/random_r.3:98 build/C/man3/rpmatch.3:64 build/C/man3/setenv.3:84 build/C/man3/strtod.3:126 build/C/man3/strtoimax.3:44 build/C/man3/strtol.3:99 build/C/man3/strtoul.3:108 build/C/man3/system.3:52 build/C/man3/wcstombs.3:59 build/C/man3/wctomb.3:50
#, no-wrap
msgid "RETURN VALUE"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_CUR_MAX.3:33
msgid ""
"An integer in the range [1, B<MB_LEN_MAX>].  The value 1 denotes traditional "
"8-bit encoded characters."
msgstr ""

#. type: SH
#: build/C/man3/MB_CUR_MAX.3:33 build/C/man3/MB_LEN_MAX.3:29 build/C/man2/_exit.2:80 build/C/man3/a64l.3:59 build/C/man3/atexit.3:71 build/C/man3/atof.3:55 build/C/man3/atoi.3:91 build/C/man3/canonicalize_file_name.3:19 build/C/man3/cfree.3:111 build/C/man3/clearenv.3:58 build/C/man3/drand48.3:202 build/C/man3/drand48_r.3:96 build/C/man3/ecvt.3:108 build/C/man3/ecvt_r.3:86 build/C/man3/exit.3:84 build/C/man3/gcvt.3:75 build/C/man3/getenv.3:54 build/C/man3/getloadavg.3:63 build/C/man3/getsubopt.3:127 build/C/man3/malloc.3:166 build/C/man3/mblen.3:68 build/C/man3/mbstowcs.3:68 build/C/man3/mbtowc.3:76 build/C/man3/mkdtemp.3:83 build/C/man3/mkstemp.3:176 build/C/man3/mktemp.3:88 build/C/man3/on_exit.3:72 build/C/man3/putenv.3:74 build/C/man3/qecvt.3:70 build/C/man3/rand.3:127 build/C/man3/random.3:135 build/C/man3/random_r.3:123 build/C/man3/rpmatch.3:85 build/C/man3/setenv.3:107 build/C/man3/strtod.3:158 build/C/man3/strtoimax.3:57 build/C/man3/strtol.3:137 build/C/man3/strtoul.3:140 build/C/man3/system.3:76 build/C/man3/wcstombs.3:68 build/C/man3/wctomb.3:64
#, no-wrap
msgid "CONFORMING TO"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_CUR_MAX.3:35 build/C/man3/MB_LEN_MAX.3:31 build/C/man3/strtoimax.3:59
msgid "C99, POSIX.1-2001."
msgstr ""

#. type: SH
#: build/C/man3/MB_CUR_MAX.3:35 build/C/man3/MB_LEN_MAX.3:42 build/C/man2/_exit.2:123 build/C/man3/a64l.3:81 build/C/man3/atexit.3:156 build/C/man3/atof.3:57 build/C/man3/atoi.3:111 build/C/man3/canonicalize_file_name.3:21 build/C/man3/cfree.3:116 build/C/man3/clearenv.3:95 build/C/man3/drand48.3:208 build/C/man3/drand48_r.3:98 build/C/man3/ecvt.3:126 build/C/man3/ecvt_r.3:93 build/C/man3/exit.3:165 build/C/man3/gcvt.3:84 build/C/man3/getenv.3:77 build/C/man3/getloadavg.3:67 build/C/man3/getsubopt.3:224 build/C/man3/malloc.3:262 build/C/man3/mblen.3:82 build/C/man3/mbstowcs.3:82 build/C/man3/mbtowc.3:91 build/C/man3/mkdtemp.3:88 build/C/man3/mkstemp.3:211 build/C/man3/mktemp.3:111 build/C/man3/on_exit.3:79 build/C/man3/putenv.3:114 build/C/man3/qecvt.3:81 build/C/man3/rand.3:215 build/C/man3/random.3:163 build/C/man3/random_r.3:127 build/C/man3/rpmatch.3:127 build/C/man3/setenv.3:130 build/C/man3/strtod.3:177 build/C/man3/strtoimax.3:59 build/C/man3/strtol.3:260 build/C/man3/strtoul.3:188 build/C/man3/system.3:151 build/C/man3/wcstombs.3:82 build/C/man3/wctomb.3:79
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_CUR_MAX.3:42
msgid ""
"B<MB_LEN_MAX>(3), B<mblen>(3), B<mbstowcs>(3), B<mbtowc>(3), B<wcstombs>(3), "
"B<wctomb>(3)"
msgstr ""

#. type: SH
#: build/C/man3/MB_CUR_MAX.3:42 build/C/man3/MB_LEN_MAX.3:44 build/C/man2/_exit.2:135 build/C/man3/a64l.3:85 build/C/man3/atexit.3:160 build/C/man3/atof.3:63 build/C/man3/atoi.3:116 build/C/man3/canonicalize_file_name.3:23 build/C/man3/cfree.3:118 build/C/man3/clearenv.3:101 build/C/man3/drand48.3:211 build/C/man3/drand48_r.3:102 build/C/man3/ecvt.3:132 build/C/man3/ecvt_r.3:97 build/C/man3/exit.3:172 build/C/man3/gcvt.3:88 build/C/man3/getenv.3:83 build/C/man3/getloadavg.3:70 build/C/man3/getsubopt.3:226 build/C/man3/malloc.3:268 build/C/man3/mblen.3:84 build/C/man3/mbstowcs.3:85 build/C/man3/mbtowc.3:95 build/C/man3/mkdtemp.3:95 build/C/man3/mkstemp.3:217 build/C/man3/mktemp.3:116 build/C/man3/on_exit.3:83 build/C/man3/putenv.3:120 build/C/man3/qecvt.3:86 build/C/man3/rand.3:218 build/C/man3/random.3:168 build/C/man3/random_r.3:131 build/C/man3/rpmatch.3:133 build/C/man3/setenv.3:135 build/C/man3/strtod.3:183 build/C/man3/strtoimax.3:65 build/C/man3/strtol.3:266 build/C/man3/strtoul.3:194 build/C/man3/system.3:156 build/C/man3/wcstombs.3:85 build/C/man3/wctomb.3:83
#, no-wrap
msgid "COLOPHON"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_CUR_MAX.3:49 build/C/man3/MB_LEN_MAX.3:51 build/C/man2/_exit.2:142 build/C/man3/a64l.3:92 build/C/man3/atexit.3:167 build/C/man3/atof.3:70 build/C/man3/atoi.3:123 build/C/man3/canonicalize_file_name.3:30 build/C/man3/cfree.3:125 build/C/man3/clearenv.3:108 build/C/man3/drand48.3:218 build/C/man3/drand48_r.3:109 build/C/man3/ecvt.3:139 build/C/man3/ecvt_r.3:104 build/C/man3/exit.3:179 build/C/man3/gcvt.3:95 build/C/man3/getenv.3:90 build/C/man3/getloadavg.3:77 build/C/man3/getsubopt.3:233 build/C/man3/malloc.3:275 build/C/man3/mblen.3:91 build/C/man3/mbstowcs.3:92 build/C/man3/mbtowc.3:102 build/C/man3/mkdtemp.3:102 build/C/man3/mkstemp.3:224 build/C/man3/mktemp.3:123 build/C/man3/on_exit.3:90 build/C/man3/putenv.3:127 build/C/man3/qecvt.3:93 build/C/man3/rand.3:225 build/C/man3/random.3:175 build/C/man3/random_r.3:138 build/C/man3/rpmatch.3:140 build/C/man3/setenv.3:142 build/C/man3/strtod.3:190 build/C/man3/strtoimax.3:72 build/C/man3/strtol.3:273 build/C/man3/strtoul.3:201 build/C/man3/system.3:163 build/C/man3/wcstombs.3:92 build/C/man3/wctomb.3:90
msgid ""
"This page is part of release 3.37 of the Linux I<man-pages> project.  A "
"description of the project, and information about reporting bugs, can be "
"found at http://www.kernel.org/doc/man-pages/."
msgstr ""

#. type: TH
#: build/C/man3/MB_LEN_MAX.3:15
#, no-wrap
msgid "MB_LEN_MAX"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_LEN_MAX.3:18
msgid "MB_LEN_MAX - maximum multibyte length of a character across all locales"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_LEN_MAX.3:21
#, no-wrap
msgid "B<#include E<lt>limits.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_LEN_MAX.3:27
msgid ""
"The B<MB_LEN_MAX> macro is the upper bound for the number of bytes needed to "
"represent a single wide character, across all locales."
msgstr ""

#. type: Plain text
#: build/C/man3/MB_LEN_MAX.3:29
msgid "A constant integer greater than zero."
msgstr ""

#. type: SH
#: build/C/man3/MB_LEN_MAX.3:31 build/C/man2/_exit.2:85 build/C/man3/a64l.3:61 build/C/man3/atexit.3:73 build/C/man3/atoi.3:101 build/C/man3/clearenv.3:72 build/C/man3/drand48.3:204 build/C/man3/ecvt.3:120 build/C/man3/ecvt_r.3:88 build/C/man3/exit.3:86 build/C/man3/getenv.3:56 build/C/man3/getsubopt.3:129 build/C/man3/malloc.3:168 build/C/man3/mblen.3:70 build/C/man3/mbstowcs.3:70 build/C/man3/mbtowc.3:78 build/C/man3/mkstemp.3:189 build/C/man3/mktemp.3:92 build/C/man3/putenv.3:76 build/C/man3/qecvt.3:76 build/C/man3/rand.3:139 build/C/man3/random.3:137 build/C/man3/setenv.3:109 build/C/man3/strtod.3:163 build/C/man3/strtol.3:142 build/C/man3/strtoul.3:145 build/C/man3/system.3:78 build/C/man3/wcstombs.3:70 build/C/man3/wctomb.3:66
#, no-wrap
msgid "NOTES"
msgstr ""

#. type: Plain text
#: build/C/man3/MB_LEN_MAX.3:42
msgid ""
"The entities B<MB_LEN_MAX> and I<sizeof(wchar_t)> are totally unrelated.  In "
"glibc, B<MB_LEN_MAX> is typically 6 while I<sizeof(wchar_t)> is 4."
msgstr ""

#. type: Plain text
#: build/C/man3/MB_LEN_MAX.3:44
msgid "B<MB_CUR_MAX>(3)"
msgstr ""

#. type: TH
#: build/C/man2/_exit.2:29
#, no-wrap
msgid "_EXIT"
msgstr ""

#. type: TH
#: build/C/man2/_exit.2:29 build/C/man3/a64l.3:6 build/C/man3/atoi.3:31 build/C/man3/ecvt.3:30 build/C/man3/gcvt.3:28 build/C/man3/mktemp.3:32 build/C/man3/qecvt.3:26 build/C/man3/random.3:31 build/C/man3/strtod.3:43 build/C/man3/strtol.3:29
#, no-wrap
msgid "2010-09-20"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:32
msgid "_exit, _Exit - terminate the calling process"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:34
msgid "B<#include E<lt>unistd.hE<gt>>"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:36
msgid "B<void _exit(int >I<status>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:38 build/C/man3/a64l.3:11 build/C/man3/canonicalize_file_name.3:12 build/C/man3/ecvt.3:35 build/C/man3/getsubopt.3:28 build/C/man3/qecvt.3:31 build/C/man3/strtod.3:48
msgid "B<#include E<lt>stdlib.hE<gt>>"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:40
msgid "B<void _Exit(int >I<status>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:44 build/C/man3/a64l.3:19 build/C/man3/atoi.3:50 build/C/man3/cfree.3:47 build/C/man3/clearenv.3:37 build/C/man3/drand48.3:58 build/C/man3/drand48_r.3:66 build/C/man3/ecvt.3:45 build/C/man3/ecvt_r.3:51 build/C/man3/gcvt.3:41 build/C/man3/getsubopt.3:35 build/C/man3/mkdtemp.3:37 build/C/man3/mkstemp.3:52 build/C/man3/mktemp.3:45 build/C/man3/on_exit.3:42 build/C/man3/putenv.3:48 build/C/man3/qecvt.3:43 build/C/man3/rand.3:56 build/C/man3/random.3:50 build/C/man3/random_r.3:45 build/C/man3/rpmatch.3:40 build/C/man3/setenv.3:50 build/C/man3/strtod.3:58 build/C/man3/strtol.3:45 build/C/man3/strtoul.3:48
msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:48
msgid "B<_Exit>():"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:51 build/C/man3/strtod.3:66
msgid ""
"_XOPEN_SOURCE\\ E<gt>=\\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ "
"200112L;"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:54 build/C/man3/atoi.3:60 build/C/man3/strtod.3:69 build/C/man3/strtol.3:55 build/C/man3/strtoul.3:58
msgid "or I<cc\\ -std=c99>"
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:66
msgid ""
"The function B<_exit>()  terminates the calling process \"immediately\".  "
"Any open file descriptors belonging to the process are closed; any children "
"of the process are inherited by process 1, I<init>, and the process's parent "
"is sent a B<SIGCHLD> signal."
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:73
msgid ""
"The value I<status> is returned to the parent process as the process's exit "
"status, and can be collected using one of the B<wait>(2)  family of calls."
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:78
msgid "The function B<_Exit>()  is equivalent to B<_exit>()."
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:80
msgid "These functions do not return."
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:85
msgid "SVr4, POSIX.1-2001, 4.3BSD.  The function B<_Exit>()  was introduced by C99."
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:89
msgid ""
"For a discussion on the effects of an exit, the transmission of exit status, "
"zombie processes, signals sent, etc., see B<exit>(3)."
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:116
msgid ""
"The function B<_exit>()  is like B<exit>(3), but does not call any functions "
"registered with B<atexit>(3)  or B<on_exit>(3).  Whether it flushes standard "
"I/O buffers and removes temporary files created with B<tmpfile>(3)  is "
"implementation-dependent.  On the other hand, B<_exit>()  does close open "
"file descriptors, and this may cause an unknown delay, waiting for pending "
"output to finish.  If the delay is undesired, it may be useful to call "
"functions like B<tcflush>(3)  before calling B<_exit>().  Whether any "
"pending I/O is canceled, and which pending I/O may be canceled upon "
"B<_exit>(), is implementation-dependent."
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:123
msgid ""
"In glibc up to version 2.3, the B<_exit>()  wrapper function invoked the "
"kernel system call of the same name.  Since glibc 2.3, the wrapper function "
"invokes B<exit_group>(2), in order to terminate all of the threads in a "
"process."
msgstr ""

#. type: Plain text
#: build/C/man2/_exit.2:135
msgid ""
"B<execve>(2), B<exit_group>(2), B<fork>(2), B<kill>(2), B<wait>(2), "
"B<wait4>(2), B<waitpid>(2), B<atexit>(3), B<exit>(3), B<on_exit>(3), "
"B<termios>(3)"
msgstr ""

#. type: TH
#: build/C/man3/a64l.3:6
#, no-wrap
msgid "A64L"
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:9
msgid "a64l, l64a - convert between long and base-64"
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:13
msgid "B<long a64l(char *>I<str64>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:15
msgid "B<char *l64a(long >I<value>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:23
msgid "B<a64l>(), B<l64a>():"
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:28 build/C/man3/ecvt.3:64
msgid ""
"_SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ "
"_XOPEN_SOURCE_EXTENDED"
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:45
msgid ""
"These functions provide a conversion between 32-bit long integers and "
"little-endian base-64 ASCII strings (of length zero to six).  If the string "
"used as argument for B<a64l>()  has length greater than six, only the first "
"six bytes are used.  If the type I<long> has more than 32 bits, then "
"B<l64a>()  uses only the low order 32 bits of I<value>, and B<a64l>()  "
"sign-extends its 32-bit result."
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:47
msgid "The 64 digits in the base-64 system are:"
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:55
#, no-wrap
msgid ""
"\\&\\(aq.\\(aq\trepresents a 0\n"
"\\&\\(aq/\\(aq\trepresents a 1\n"
"0-9\trepresent  2-11\n"
"A-Z\trepresent 12-37\n"
"a-z\trepresent 38-63\n"
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:59
msgid "So 123 = 59*64^0 + 1*64^1 = \"v/\"."
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:61 build/C/man3/getsubopt.3:129
msgid "POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:66
msgid ""
"The value returned by B<l64a>()  may be a pointer to a static buffer, "
"possibly overwritten by later calls."
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:75
msgid ""
"The behavior of B<l64a>()  is undefined when I<value> is negative.  If "
"I<value> is zero, it returns an empty string."
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:78
msgid ""
"These functions are broken in glibc before 2.2.5 (puts most significant "
"digit first)."
msgstr ""

#. type: Plain text
#: build/C/man3/a64l.3:81
msgid "This is not the encoding used by B<uuencode>(1)."
msgstr ""

#.  .BR itoa (3),
#. type: Plain text
#: build/C/man3/a64l.3:85
msgid "B<uuencode>(1), B<strtoul>(3)"
msgstr ""

#. type: TH
#: build/C/man3/atexit.3:31
#, no-wrap
msgid "ATEXIT"
msgstr ""

#. type: TH
#: build/C/man3/atexit.3:31 build/C/man3/on_exit.3:29
#, no-wrap
msgid "2008-12-05"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:34
msgid "atexit - register a function to be called at normal process termination"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:39
#, no-wrap
msgid "B<int atexit(void (*>I<function>B<)(void));>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:49
msgid ""
"The B<atexit>()  function registers the given I<function> to be called at "
"normal process termination, either via B<exit>(3)  or via return from the "
"program's I<main>().  Functions so registered are called in the reverse "
"order of their registration; no arguments are passed."
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:52 build/C/man3/on_exit.3:60
msgid ""
"The same function may be registered multiple times: it is called once for "
"each registration."
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:58
msgid ""
"POSIX.1-2001 requires that an implementation allow at least B<ATEXIT_MAX> "
"(32) such functions to be registered.  The actual limit supported by an "
"implementation can be obtained using B<sysconf>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:66 build/C/man3/on_exit.3:67
msgid ""
"When a child process is created via B<fork>(2), it inherits copies of its "
"parent's registrations.  Upon a successful call to one of the B<exec>(3)  "
"functions, all registrations are removed."
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:71
msgid ""
"The B<atexit>()  function returns the value 0 if successful; otherwise it "
"returns a nonzero value."
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:73
msgid "SVr4, 4.3BSD, C89, C99, POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:80
msgid ""
"Functions registered using B<atexit>()  (and B<on_exit>(3))  are not called "
"if a process terminates abnormally because of the delivery of a signal."
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:87
msgid ""
"If one of the functions registered functions calls B<_exit>(2), then any "
"remaining functions are not invoked, and the other process termination steps "
"performed by B<exit>(3)  are not performed."
msgstr ""

#.  This can happen on OpenBSD 4.2 for example, and is documented
#.  as occurring on FreeBSD as well.
#.  Glibc does "the Right Thing" -- invocation of the remaining
#.  exit handlers carries on as normal.
#. type: Plain text
#: build/C/man3/atexit.3:104
msgid ""
"POSIX.1-2001 says that the result of calling B<exit>(3)  more than once "
"(i.e., calling B<exit>(3)  within a function registered using B<atexit>())  "
"is undefined.  On some systems (but not Linux), this can result in an "
"infinite recursion; portable programs should not invoke B<exit>(3)  inside a "
"function registered using B<atexit>()."
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:113
msgid ""
"The B<atexit>()  and B<on_exit>(3)  functions register functions on the same "
"list: at normal process termination, the registered functions are invoked in "
"reverse order of their registration by these two functions."
msgstr ""

#.  In glibc, things seem to be handled okay
#. type: Plain text
#: build/C/man3/atexit.3:119
msgid ""
"POSIX.1-2001 says that the result is undefined if B<longjmp>(3)  is used to "
"terminate execution of one of the functions registered B<atexit>()."
msgstr ""

#. type: SS
#: build/C/man3/atexit.3:119
#, no-wrap
msgid "Linux Notes"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:126
msgid ""
"Since glibc 2.2.3, B<atexit>()  (and B<on_exit>(3))  can be used within a "
"shared library to establish functions that are called when the shared "
"library is unloaded."
msgstr ""

#. type: SH
#: build/C/man3/atexit.3:126 build/C/man3/getsubopt.3:136 build/C/man3/rand.3:158 build/C/man3/rpmatch.3:102 build/C/man3/strtod.3:172 build/C/man3/strtol.3:179 build/C/man3/strtoul.3:183
#, no-wrap
msgid "EXAMPLE"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:131
#, no-wrap
msgid ""
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>unistd.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:137
#, no-wrap
msgid ""
"void\n"
"bye(void)\n"
"{\n"
"    printf(\"That was all, folks\\en\");\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:143
#, no-wrap
msgid ""
"int\n"
"main(void)\n"
"{\n"
"    long a;\n"
"    int i;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:146
#, no-wrap
msgid ""
"    a = sysconf(_SC_ATEXIT_MAX);\n"
"    printf(\"ATEXIT_MAX = %ld\\en\", a);\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:152
#, no-wrap
msgid ""
"    i = atexit(bye);\n"
"    if (i != 0) {\n"
"        fprintf(stderr, \"cannot set exit function\\en\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:155 build/C/man3/getsubopt.3:223 build/C/man3/rand.3:213 build/C/man3/strtol.3:259
#, no-wrap
msgid ""
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atexit.3:160
msgid "B<_exit>(2), B<exit>(3), B<on_exit>(3)"
msgstr ""

#. type: TH
#: build/C/man3/atof.3:29
#, no-wrap
msgid "ATOF"
msgstr ""

#. type: TH
#: build/C/man3/atof.3:29
#, no-wrap
msgid "1993-03-29"
msgstr ""

#. type: TH
#: build/C/man3/atof.3:29 build/C/man3/atoi.3:31 build/C/man3/canonicalize_file_name.3:5 build/C/man3/drand48_r.3:25 build/C/man3/ecvt_r.3:28 build/C/man3/getenv.3:31 build/C/man3/getsubopt.3:23 build/C/man3/malloc.3:28 build/C/man3/mblen.3:14 build/C/man3/mbstowcs.3:14 build/C/man3/mbtowc.3:14 build/C/man3/mkdtemp.3:24 build/C/man3/mkstemp.3:33 build/C/man3/mktemp.3:32 build/C/man3/on_exit.3:29 build/C/man3/putenv.3:34 build/C/man3/qecvt.3:26 build/C/man3/random.3:31 build/C/man3/random_r.3:24 build/C/man3/rpmatch.3:27 build/C/man3/setenv.3:35 build/C/man3/strtol.3:29 build/C/man3/strtoul.3:31 build/C/man3/wcstombs.3:14 build/C/man3/wctomb.3:14
#, no-wrap
msgid "GNU"
msgstr ""

#. type: Plain text
#: build/C/man3/atof.3:32
msgid "atof - convert a string to a double"
msgstr ""

#. type: Plain text
#: build/C/man3/atof.3:37
#, no-wrap
msgid "B<double atof(const char *>I<nptr>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atof.3:45
msgid ""
"The B<atof>()  function converts the initial portion of the string pointed "
"to by I<nptr> to I<double>.  The behavior is the same as"
msgstr ""

#. type: Plain text
#: build/C/man3/atof.3:48
msgid "strtod(nptr, (char **) NULL);"
msgstr ""

#. type: Plain text
#: build/C/man3/atof.3:53
msgid "except that B<atof>()  does not detect errors."
msgstr ""

#. type: Plain text
#: build/C/man3/atof.3:55 build/C/man3/atoi.3:91
msgid "The converted value."
msgstr ""

#. type: Plain text
#: build/C/man3/atof.3:57 build/C/man3/getenv.3:56
msgid "SVr4, POSIX.1-2001, 4.3BSD, C89, C99."
msgstr ""

#. type: Plain text
#: build/C/man3/atof.3:63
msgid "B<atoi>(3), B<atol>(3), B<strtod>(3), B<strtol>(3), B<strtoul>(3)"
msgstr ""

#. type: TH
#: build/C/man3/atoi.3:31
#, no-wrap
msgid "ATOI"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:34
msgid "atoi, atol, atoll, atoq - convert a string to an integer"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:39
#, no-wrap
msgid "B<int atoi(const char *>I<nptr>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:41
#, no-wrap
msgid "B<long atol(const char *>I<nptr>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:43
#, no-wrap
msgid "B<long long atoll(const char *>I<nptr>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:45
#, no-wrap
msgid "B<long long atoq(const char *>I<nptr>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:54
msgid "B<atoll>():"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:57
msgid ""
"_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
"_ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:69
msgid ""
"The B<atoi>()  function converts the initial portion of the string pointed "
"to by I<nptr> to I<int>.  The behavior is the same as"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:72
msgid "strtol(nptr, (char **) NULL, 10);"
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:77
msgid "except that B<atoi>()  does not detect errors."
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:89
msgid ""
"The B<atol>()  and B<atoll>()  functions behave the same as B<atoi>(), "
"except that they convert the initial portion of the string to their return "
"type of I<long> or I<long long>.  B<atoq>()  is an obsolete name for "
"B<atoll>()."
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:101
msgid ""
"SVr4, POSIX.1-2001, 4.3BSD, C99.  C89 and POSIX.1-1996 include the functions "
"B<atoi>()  and B<atol>()  only.  B<atoq>()  is a GNU extension."
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:111
msgid ""
"The nonstandard B<atoq>()  function is not present in libc 4.6.27 or glibc "
"2, but is present in libc5 and libc 4.7 (though only as an inline function "
"in I<E<lt>stdlib.hE<gt>> until libc 5.4.44).  The B<atoll>()  function is "
"present in glibc 2 since version 2.0.2, but not in libc4 or libc5."
msgstr ""

#. type: Plain text
#: build/C/man3/atoi.3:116
msgid "B<atof>(3), B<strtod>(3), B<strtol>(3), B<strtoul>(3)"
msgstr ""

#. type: TH
#: build/C/man3/canonicalize_file_name.3:5
#, no-wrap
msgid "CANONICALIZE_FILE_NAME"
msgstr ""

#. type: TH
#: build/C/man3/canonicalize_file_name.3:5
#, no-wrap
msgid "2005-07-14"
msgstr ""

#. type: Plain text
#: build/C/man3/canonicalize_file_name.3:8
msgid "canonicalize_file_name - return the canonicalized filename"
msgstr ""

#. type: Plain text
#: build/C/man3/canonicalize_file_name.3:10
msgid "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */"
msgstr ""

#. type: Plain text
#: build/C/man3/canonicalize_file_name.3:14
msgid "B<char *canonicalize_file_name(const char *>I<path>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/canonicalize_file_name.3:19
msgid ""
"The call I<canonicalize_file_name(path)> is equivalent to the call "
"I<realpath(path,\\ NULL)>."
msgstr ""

#. type: Plain text
#: build/C/man3/canonicalize_file_name.3:21
msgid "The function is a GNU extension."
msgstr ""

#. type: Plain text
#: build/C/man3/canonicalize_file_name.3:23
msgid "B<realpath>(3)"
msgstr ""

#. type: TH
#: build/C/man3/cfree.3:23
#, no-wrap
msgid "CFREE"
msgstr ""

#. type: TH
#: build/C/man3/cfree.3:23 build/C/man3/drand48.3:28 build/C/man3/drand48_r.3:25 build/C/man3/ecvt_r.3:28 build/C/man3/putenv.3:34 build/C/man3/rpmatch.3:27
#, no-wrap
msgid "2007-07-26"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:26
msgid "cfree - free allocated memory"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:33
#, no-wrap
msgid ""
"/* In SunOS 4 */\n"
"B<int cfree(void *>I<ptr>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:36
#, no-wrap
msgid ""
"/* In glibc or FreeBSD libcompat */\n"
"B<void cfree(void *>I<ptr>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:39
#, no-wrap
msgid ""
"/* In SCO OpenServer */\n"
"B<void cfree(char *>I<ptr>B<, unsigned >I<num>B<, unsigned >I<size>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:42
#, no-wrap
msgid ""
"/* In Solaris watchmalloc.so.1 */\n"
"B<void cfree(void *>I<ptr>B<, size_t >I<nelem>B<, size_t >I<elsize>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:51
msgid "B<cfree>(): _BSD_SOURCE || _SVID_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:56
msgid "This function should never be used.  Use B<free>(3)  instead."
msgstr ""

#. type: SS
#: build/C/man3/cfree.3:56
#, no-wrap
msgid "1-arg cfree"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:62
msgid ""
"In glibc, the function B<cfree>()  is a synonym for B<free>(3), \"added for "
"compatibility with SunOS\"."
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:68
msgid ""
"Other systems have other functions with this name.  The declaration is "
"sometimes in I<E<lt>stdlib.hE<gt>> and sometimes in I<E<lt>malloc.hE<gt>>."
msgstr ""

#. type: SS
#: build/C/man3/cfree.3:68
#, no-wrap
msgid "3-arg cfree"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:73
msgid ""
"Some SCO and Solaris versions have malloc libraries with a 3-argument "
"B<cfree>(), apparently as an analog to B<calloc>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:75
msgid "If you need it while porting something, add"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:78
msgid "#define cfree(p, n, s) free((p))"
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:81
msgid "to your file."
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:90
msgid ""
"A frequently asked question is \"Can I use B<free>(3)  to free memory "
"allocated with B<calloc>(3), or do I need B<cfree>()?\" Answer: use "
"B<free>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:95
msgid ""
"An SCO manual writes: \"The cfree routine is provided for compliance to the "
"iBCSe2 standard and simply calls free.  The num and size arguments to cfree "
"are not used.\""
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:111
msgid ""
"The SunOS version of B<cfree>()  (which is a synonym for B<free>(3))  "
"returns 1 on success and 0 on failure.  In case of error, I<errno> is set to "
"B<EINVAL>: the value of I<ptr> was not a pointer to a block previously "
"allocated by one of the routines in the B<malloc>(3)  family."
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:116
msgid ""
"The 3-argument version of B<cfree>()  as used by SCO conforms to the iBCSe2 "
"standard: Intel386 Binary Compatibility Specification, Edition 2."
msgstr ""

#. type: Plain text
#: build/C/man3/cfree.3:118
msgid "B<malloc>(3)"
msgstr ""

#. type: TH
#: build/C/man3/clearenv.3:24
#, no-wrap
msgid "CLEARENV"
msgstr ""

#. type: TH
#: build/C/man3/clearenv.3:24
#, no-wrap
msgid "2010-10-04"
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:27
msgid "clearenv - clear the environment"
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:32
#, no-wrap
msgid "B<int clearenv(void);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:41
msgid "B<clearenv>(): _SVID_SOURCE || _BSD_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:48
msgid ""
"The B<clearenv>()  function clears the environment of all name-value pairs "
"and sets the value of the external variable I<environ> to NULL."
msgstr ""

#.  Most versions of UNIX return -1 on error, or do not even have errors.
#.  Glibc info and the Watcom C library document "a nonzero value".
#. type: Plain text
#: build/C/man3/clearenv.3:55
msgid ""
"The B<clearenv>()  function returns zero on success, and a nonzero value on "
"failure."
msgstr ""

#. type: SH
#: build/C/man3/clearenv.3:55 build/C/man3/getloadavg.3:61 build/C/man3/mkdtemp.3:81 build/C/man3/mkstemp.3:169
#, no-wrap
msgid "VERSIONS"
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:58
msgid "Not in libc4, libc5.  In glibc since glibc 2.0."
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:72
msgid ""
"Various UNIX variants (DG/UX, HP-UX, QNX, ...).  POSIX.9 (bindings for "
"FORTRAN77).  POSIX.1-1996 did not accept B<clearenv>()  and B<putenv>(3), "
"but changed its mind and scheduled these functions for some later issue of "
"this standard (cf. B.4.6.1).  However, POSIX.1-2001 only adds B<putenv>(3), "
"and rejected B<clearenv>()."
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:76
msgid ""
"Used in security-conscious applications.  If it is unavailable the "
"assignment"
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:79
#, no-wrap
msgid "    environ = NULL;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:82
msgid "will probably do."
msgstr ""

#.  .LP
#.  HP-UX has a ENOMEM error return.
#. type: Plain text
#: build/C/man3/clearenv.3:95
msgid ""
"The DG/UX and Tru64 man pages write: If I<environ> has been modified by "
"anything other than the B<putenv>(3), B<getenv>(3), or B<clearenv>()  "
"functions, then B<clearenv>()  will return an error and the process "
"environment will remain unchanged."
msgstr ""

#. type: Plain text
#: build/C/man3/clearenv.3:101
msgid "B<getenv>(3), B<putenv>(3), B<setenv>(3), B<unsetenv>(3), B<environ>(7)"
msgstr ""

#. type: TH
#: build/C/man3/drand48.3:28
#, no-wrap
msgid "DRAND48"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:32
msgid ""
"drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, "
"lcong48 - generate uniformly distributed pseudo-random numbers"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:37
#, no-wrap
msgid "B<double drand48(void);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:39
#, no-wrap
msgid "B<double erand48(unsigned short >I<xsubi>B<[3]);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:41
#, no-wrap
msgid "B<long int lrand48(void);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:43
#, no-wrap
msgid "B<long int nrand48(unsigned short >I<xsubi>B<[3]);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:45
#, no-wrap
msgid "B<long int mrand48(void);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:47
#, no-wrap
msgid "B<long int jrand48(unsigned short >I<xsubi>B<[3]);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:49
#, no-wrap
msgid "B<void srand48(long int >I<seedval>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:51
#, no-wrap
msgid "B<unsigned short *seed48(unsigned short >I<seed16v>B<[3]);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:53
#, no-wrap
msgid "B<void lcong48(unsigned short >I<param>B<[7]);>\n"
msgstr ""

#.  .BR drand48 (),
#.  .BR erand48 (),
#.  .BR lrand48 (),
#.  .BR nrand48 (),
#.  .BR mrand48 (),
#.  .BR jrand48 (),
#.  .BR srand48 (),
#.  .BR seed48 (),
#.  .BR lcong48 ():
#. type: Plain text
#: build/C/man3/drand48.3:72
msgid "All functions shown above: _SVID_SOURCE || _XOPEN_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:76
msgid ""
"These functions generate pseudo-random numbers using the linear congruential "
"algorithm and 48-bit integer arithmetic."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:84
msgid ""
"The B<drand48>()  and B<erand48>()  functions return nonnegative "
"double-precision floating-point values uniformly distributed between [0.0, "
"1.0)."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:91
msgid ""
"The B<lrand48>()  and B<nrand48>()  functions return nonnegative long "
"integers uniformly distributed between 0 and 2^31."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:98
msgid ""
"The B<mrand48>()  and B<jrand48>()  functions return signed long integers "
"uniformly distributed between -2^31 and 2^31."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:117
msgid ""
"The B<srand48>(), B<seed48>()  and B<lcong48>()  functions are "
"initialization functions, one of which should be called before using "
"B<drand48>(), B<lrand48>()  or B<mrand48>().  The functions B<erand48>(), "
"B<nrand48>()  and B<jrand48>()  do not require an initialization function to "
"be called first."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:120
msgid ""
"All the functions work by generating a sequence of 48-bit integers, I<Xi>, "
"according to the linear congruential formula:"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:124
#, no-wrap
msgid "B<Xn+1 = (aXn + c) mod m, where n E<gt>= 0>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:131
msgid ""
"The parameter I<m> = 2^48, hence 48-bit integer arithmetic is performed.  "
"Unless B<lcong48>()  is called, I<a> and I<c> are given by:"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:136
#, no-wrap
msgid ""
"B<a = 0x5DEECE66D>\n"
"B<c = 0xB>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:152
msgid ""
"The value returned by any of the functions B<drand48>(), B<erand48>(), "
"B<lrand48>(), B<nrand48>(), B<mrand48>()  or B<jrand48>()  is computed by "
"first generating the next 48-bit I<Xi> in the sequence.  Then the "
"appropriate number of bits, according to the type of data item to be "
"returned, is copied from the high-order bits of I<Xi> and transformed into "
"the returned value."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:171
msgid ""
"The functions B<drand48>(), B<lrand48>()  and B<mrand48>()  store the last "
"48-bit I<Xi> generated in an internal buffer.  The functions B<erand48>(), "
"B<nrand48>()  and B<jrand48>()  require the calling program to provide "
"storage for the successive I<Xi> values in the array argument I<xsubi>.  The "
"functions are initialized by placing the initial value of I<Xi> into the "
"array before calling the function for the first time."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:178
msgid ""
"The initializer function B<srand48>()  sets the high order 32-bits of I<Xi> "
"to the argument I<seedval>.  The low order 16-bits are set to the arbitrary "
"value 0x330E."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:187
msgid ""
"The initializer function B<seed48>()  sets the value of I<Xi> to the 48-bit "
"value specified in the array argument I<seed16v>.  The previous value of "
"I<Xi> is copied into an internal buffer and a pointer to this buffer is "
"returned by B<seed48>()."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:202
msgid ""
"The initialization function B<lcong48>()  allows the user to specify initial "
"values for I<Xi>, I<a> and I<c>.  Array argument elements I<param[0-2]> "
"specify I<Xi>, I<param[3-5]> specify I<a>, and I<param[6]> specifies I<c>.  "
"After B<lcong48>()  has been called, a subsequent call to either "
"B<srand48>()  or B<seed48>()  will restore the standard values of I<a> and "
"I<c>."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:204
msgid "SVr4, POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:208
msgid ""
"These functions are declared obsolete by SVID 3, which states that "
"B<rand>(3)  should be used instead."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48.3:211
msgid "B<rand>(3), B<random>(3)"
msgstr ""

#. type: TH
#: build/C/man3/drand48_r.3:25
#, no-wrap
msgid "DRAND48_R"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:30
msgid ""
"drand48_r, erand48_r, lrand48_r, nrand48_r, mrand48_r, jrand48_r, srand48_r, "
"seed48_r, lcong48_r - generate uniformly distributed pseudo-random numbers "
"reentrantly"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:35
#, no-wrap
msgid "B<int drand48_r(struct drand48_data *>I<buffer>B<, double *>I<result>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:37
#, no-wrap
msgid "B<int erand48_r(unsigned short >I<xsubi>B<[3]>I<,>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:39
#, no-wrap
msgid "B<              struct drand48_data *>I<buffer>B<, double *>I<result>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:41
#, no-wrap
msgid ""
"B<int lrand48_r(struct drand48_data *>I<buffer>B<, long int "
"*>I<result>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:43
#, no-wrap
msgid "B<int nrand48_r(unsigned short int >I<xsubi[3]>B<,>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:45 build/C/man3/drand48_r.3:51
#, no-wrap
msgid ""
"B<              struct drand48_data *>I<buffer>B<, long int "
"*>I<result>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:47
#, no-wrap
msgid ""
"B<int mrand48_r(struct drand48_data *>I<buffer>B<,long int "
"*>I<result>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:49
#, no-wrap
msgid "B<int jrand48_r(unsigned short int >I<xsubi[3]>B<,>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:53
#, no-wrap
msgid ""
"B<int srand48_r(long int >I<seedval>B<, struct drand48_data "
"*>I<buffer>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:55
#, no-wrap
msgid "B<int seed48_r(unsigned short int >I<seed16v[3]>B<,>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:57
#, no-wrap
msgid "B<             struct drand48_data *>I<buffer>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:59
#, no-wrap
msgid "B<int lcong48_r(unsigned short int >I<param[7]>B<,>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:61
#, no-wrap
msgid "B<              struct drand48_data *>I<buffer>B<);>\n"
msgstr ""

#.  .BR drand48_r (),
#.  .BR erand48_r (),
#.  .BR lrand48_r (),
#.  .BR nrand48_r (),
#.  .BR mrand48_r (),
#.  .BR jrand48_r (),
#.  .BR srand48_r (),
#.  .BR seed48_r (),
#.  .BR lcong48_r ():
#. type: Plain text
#: build/C/man3/drand48_r.3:80
msgid "All functions shown above: _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:87
msgid ""
"These functions are the reentrant analogs of the functions described in "
"B<drand48>(3).  Instead of modifying the global random generator state, they "
"use the supplied data I<buffer>."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:94
msgid ""
"Before the first use, this struct must be initialized, for example, by "
"filling it with zeros, or by calling one of the functions B<srand48_r>(), "
"B<seed48_r>(), or B<lcong48_r>()."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:96
msgid "The return value is 0."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:98
msgid "These functions are GNU extensions and are not portable."
msgstr ""

#. type: Plain text
#: build/C/man3/drand48_r.3:102 build/C/man3/random_r.3:131
msgid "B<drand48>(3), B<rand>(3), B<random>(3)"
msgstr ""

#. type: TH
#: build/C/man3/ecvt.3:30
#, no-wrap
msgid "ECVT"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:33
msgid "ecvt, fcvt - convert a floating-point number to a string"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:38
msgid ""
"B<char *ecvt(double >I<number>B<, int >I<ndigits>B<, int *>I<decpt>B<,> "
"B<int *>I<sign>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:41
msgid ""
"B<char *fcvt(double >I<number>B<, int >I<ndigits>B<, int *>I<decpt>B<,> "
"B<int *>I<sign>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:49
msgid "B<ecvt>(), B<fcvt>():"
msgstr ""

#. type: TP
#: build/C/man3/ecvt.3:52 build/C/man3/gcvt.3:47 build/C/man3/mktemp.3:51
#, no-wrap
msgid "Since glibc 2.12:"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:59 build/C/man3/gcvt.3:54
#, no-wrap
msgid ""
"_SVID_SOURCE ||\n"
"    (_XOPEN_SOURCE\\ E<gt>=\\ 500 ||\n"
"        _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED) &&\n"
"    !(_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600)\n"
msgstr ""

#. type: TP
#: build/C/man3/ecvt.3:60 build/C/man3/gcvt.3:55 build/C/man3/mktemp.3:57
#, no-wrap
msgid "Before glibc 2.12:"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:90
msgid ""
"The B<ecvt>()  function converts I<number> to a null-terminated string of "
"I<ndigits> digits (where I<ndigits> is reduced to a system-specific limit "
"determined by the precision of a I<double>), and returns a pointer to the "
"string.  The high-order digit is nonzero, unless I<number> is zero.  The low "
"order digit is rounded.  The string itself does not contain a decimal point; "
"however, the position of the decimal point relative to the start of the "
"string is stored in I<*decpt>.  A negative value for I<*decpt> means that "
"the decimal point is to the left of the start of the string.  If the sign of "
"I<number> is negative, I<*sign> is set to a nonzero value, otherwise it is "
"set to 0.  If I<number> is zero, it is unspecified whether I<*decpt> is 0 or "
"1."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:97
msgid ""
"The B<fcvt>()  function is identical to B<ecvt>(), except that I<ndigits> "
"specifies the number of digits after the decimal point."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:108
msgid ""
"Both the B<ecvt>()  and B<fcvt>()  functions return a pointer to a static "
"string containing the ASCII representation of I<number>.  The static string "
"is overwritten by each call to B<ecvt>()  or B<fcvt>()."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:120
msgid ""
"SVr2; marked as LEGACY in POSIX.1-2001.  POSIX.1-2008 removes the "
"specifications of B<ecvt>()  and B<fcvt>(), recommending the use of "
"B<sprintf>(3)  instead (though B<snprintf>(3)  may be preferable)."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:126
msgid ""
"Linux libc4 and libc5 specified the type of I<ndigits> as I<size_t>.  Not "
"all locales use a point as the radix character (\"decimal point\")."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt.3:132
msgid "B<ecvt_r>(3), B<gcvt>(3), B<qecvt>(3), B<setlocale>(3), B<sprintf>(3)"
msgstr ""

#. type: TH
#: build/C/man3/ecvt_r.3:28
#, no-wrap
msgid "ECVT_R"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:31
msgid ""
"ecvt_r, fcvt_r, qecvt_r, qfcvt_r - convert a floating-point number to a "
"string"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:37
#, no-wrap
msgid ""
"B<int ecvt_r(double >I<number>B<, int >I<ndigits>B<, int *>I<decpt>B<,>\n"
"B<           int *>I<sign>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:40
#, no-wrap
msgid ""
"B<int fcvt_r(double >I<number>B<, int >I<ndigits>B<, int *>I<decpt>B<,>\n"
"B<           int *>I<sign>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:43
#, no-wrap
msgid ""
"B<int qecvt_r(long double >I<number>B<, int >I<ndigits>B<, int "
"*>I<decpt>B<,>\n"
"B<           int *>I<sign>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:46
#, no-wrap
msgid ""
"B<int qfcvt_r(long double >I<number>B<, int >I<ndigits>B<, int "
"*>I<decpt>B<,>\n"
"B<           int *>I<sign>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:58
msgid "B<ecvt_r>(), B<fcvt_r>(), B<qecvt_r>(), B<qfcvt_r>():"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:60
msgid "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500"
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:84
msgid ""
"The functions B<ecvt_r>(), B<fcvt_r>(), B<qecvt_r>()  and B<qfcvt_r>()  are "
"identical to B<ecvt>(3), B<fcvt>(3), B<qecvt>(3)  and B<qfcvt>(3), "
"respectively, except that they do not return their result in a static "
"buffer, but instead use the supplied I<buf> of size I<len>.  See B<ecvt>(3)  "
"and B<qecvt>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:86
msgid "These functions return 0 on success, and -1 otherwise."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:88
msgid "These functions are GNU extensions."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:93 build/C/man3/qecvt.3:81
msgid "These functions are obsolete.  Instead, B<sprintf>(3)  is recommended."
msgstr ""

#. type: Plain text
#: build/C/man3/ecvt_r.3:97
msgid "B<ecvt>(3), B<qecvt>(3), B<sprintf>(3)"
msgstr ""

#. type: TH
#: build/C/man3/exit.3:23
#, no-wrap
msgid "EXIT"
msgstr ""

#. type: TH
#: build/C/man3/exit.3:23 build/C/man3/setenv.3:35
#, no-wrap
msgid "2009-09-20"
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:26
msgid "exit - cause normal process termination"
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:31
#, no-wrap
msgid "B<void exit(int >I<status>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:39
msgid ""
"The B<exit>()  function causes normal process termination and the value of "
"I<status & 0377> is returned to the parent (see B<wait>(2))."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:66
msgid ""
"All functions registered with B<atexit>(3)  and B<on_exit>(3)  are called, "
"in the reverse order of their registration.  (It is possible for one of "
"these functions to use B<atexit>(3)  or B<on_exit>(3)  to register an "
"additional function to be executed during exit processing; the new "
"registration is added to the front of the list of functions that remain to "
"be called.)  If one of these functions does not return (e.g., it calls "
"B<_exit>(2), or kills itself with a signal), then none of the remaining "
"functions is called, and further exit processing (in particular, flushing of "
"B<stdio>(3)  streams) is abandoned.  If a function has been registered "
"multiple times using B<atexit>(3)  or B<on_exit>(3), then it is called as "
"many times as it was registered."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:73
msgid ""
"All open B<stdio>(3)  streams are flushed and closed.  Files created by "
"B<tmpfile>(3)  are removed."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:80
msgid ""
"The C standard specifies two constants, B<EXIT_SUCCESS> and B<EXIT_FAILURE>, "
"that may be passed to B<exit>()  to indicate successful or unsuccessful "
"termination, respectively."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:84
msgid "The B<exit>()  function does not return."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:86
msgid "SVr4, 4.3BSD, POSIX.1-2001, C89, C99."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:97
msgid ""
"It is undefined what happens if one of the functions registered using "
"B<atexit>(3)  and B<on_exit>(3)  calls either B<exit>()  or B<longjmp>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:106
msgid ""
"The use of B<EXIT_SUCCESS> and B<EXIT_FAILURE> is slightly more portable (to "
"non-UNIX environments) than the use of 0 and some nonzero value like 1 or "
"-1.  In particular, VMS uses a different convention."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:109
msgid ""
"BSD has attempted to standardize exit codes; see the file "
"I<E<lt>sysexits.hE<gt>>."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:134
msgid ""
"After B<exit>(), the exit status must be transmitted to the parent process.  "
"There are three cases.  If the parent has set B<SA_NOCLDWAIT>, or has set "
"the B<SIGCHLD> handler to B<SIG_IGN>, the status is discarded.  If the "
"parent was waiting on the child it is notified of the exit status.  In both "
"cases the exiting process dies immediately.  If the parent has not indicated "
"that it is not interested in the exit status, but is not waiting, the "
"exiting process turns into a \"zombie\" process (which is nothing but a "
"container for the single byte representing the exit status) so that the "
"parent can learn the exit status when it later calls one of the B<wait>(2)  "
"functions."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:144
msgid ""
"If the implementation supports the B<SIGCHLD> signal, this signal is sent to "
"the parent.  If the parent has set B<SA_NOCLDWAIT>, it is undefined whether "
"a B<SIGCHLD> signal is sent."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:153
msgid ""
"If the process is a session leader and its controlling terminal is the "
"controlling terminal of the session, then each process in the foreground "
"process group of this controlling terminal is sent a B<SIGHUP> signal, and "
"the terminal is disassociated from this session, allowing it to be acquired "
"by a new controlling process."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:165
msgid ""
"If the exit of the process causes a process group to become orphaned, and if "
"any member of the newly orphaned process group is stopped, then a B<SIGHUP> "
"signal followed by a B<SIGCONT> signal will be sent to each process in this "
"process group.  See B<setpgid>(2)  for an explanation of orphaned process "
"groups."
msgstr ""

#. type: Plain text
#: build/C/man3/exit.3:172
msgid ""
"B<_exit>(2), B<setpgid>(2), B<wait>(2), B<atexit>(3), B<on_exit>(3), "
"B<tmpfile>(3)"
msgstr ""

#. type: TH
#: build/C/man3/gcvt.3:28
#, no-wrap
msgid "GCVT"
msgstr ""

#. type: Plain text
#: build/C/man3/gcvt.3:31
msgid "gcvt - convert a floating-point number to a string"
msgstr ""

#. type: Plain text
#: build/C/man3/gcvt.3:36
#, no-wrap
msgid "B<char *gcvt(double >I<number>B<, size_t >I<ndigit>B<, char *>I<buf>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/gcvt.3:44
msgid "B<gcvt>():"
msgstr ""

#. type: Plain text
#: build/C/man3/gcvt.3:59
msgid ""
"_SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE && "
"_XOPEN_SOURCE_EXTENDED"
msgstr ""

#. type: Plain text
#: build/C/man3/gcvt.3:70
msgid ""
"The B<gcvt>()  function converts I<number> to a minimal length "
"null-terminated ASCII string and stores the result in I<buf>.  It produces "
"I<ndigit> significant digits in either B<printf>(3)  F format or E format."
msgstr ""

#. type: Plain text
#: build/C/man3/gcvt.3:75
msgid ""
"The B<gcvt>()  function returns the address of the string pointed to by "
"I<buf>."
msgstr ""

#. type: Plain text
#: build/C/man3/gcvt.3:84
msgid ""
"Marked as LEGACY in POSIX.1-2001.  POSIX.1-2008 removes the specification of "
"B<gcvt>(), recommending the use of B<sprintf>(3)  instead (though "
"B<snprintf>(3)  may be preferable)."
msgstr ""

#. type: Plain text
#: build/C/man3/gcvt.3:88
msgid "B<ecvt>(3), B<fcvt>(3), B<sprintf>(3)"
msgstr ""

#. type: TH
#: build/C/man3/getenv.3:31
#, no-wrap
msgid "GETENV"
msgstr ""

#. type: TH
#: build/C/man3/getenv.3:31
#, no-wrap
msgid "2008-03-17"
msgstr ""

#. type: Plain text
#: build/C/man3/getenv.3:34
msgid "getenv - get an environment variable"
msgstr ""

#. type: Plain text
#: build/C/man3/getenv.3:39
#, no-wrap
msgid "B<char *getenv(const char *>I<name>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getenv.3:49
msgid ""
"The B<getenv>()  function searches the environment list to find the "
"environment variable I<name>, and returns a pointer to the corresponding "
"I<value> string."
msgstr ""

#. type: Plain text
#: build/C/man3/getenv.3:54
msgid ""
"The B<getenv>()  function returns a pointer to the value in the environment, "
"or NULL if there is no match."
msgstr ""

#. type: Plain text
#: build/C/man3/getenv.3:58
msgid "The strings in the environment list are of the form I<name=value>."
msgstr ""

#. type: Plain text
#: build/C/man3/getenv.3:64
msgid ""
"As typically implemented, B<getenv>()  returns a pointer to a string within "
"the environment list.  The caller must take care not to modify this string, "
"since that would change the environment of the process."
msgstr ""

#. type: Plain text
#: build/C/man3/getenv.3:77
msgid ""
"The implementation of B<getenv>()  is not required to be reentrant.  The "
"string pointed to by the return value of B<getenv>()  may be statically "
"allocated, and can be modified by a subsequent call to B<getenv>(), "
"B<putenv>(3), B<setenv>(3), or B<unsetenv>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/getenv.3:83
msgid "B<clearenv>(3), B<putenv>(3), B<setenv>(3), B<unsetenv>(3), B<environ>(7)"
msgstr ""

#. type: TH
#: build/C/man3/getloadavg.3:32
#, no-wrap
msgid "GETLOADAVG"
msgstr ""

#. type: TH
#: build/C/man3/getloadavg.3:32
#, no-wrap
msgid "2007-12-08"
msgstr ""

#. type: Plain text
#: build/C/man3/getloadavg.3:35
msgid "getloadavg - get system load averages"
msgstr ""

#. type: Plain text
#: build/C/man3/getloadavg.3:39
#, no-wrap
msgid ""
"B<#define _BSD_SOURCE>         /* See feature_test_macros(7) */\n"
"B<#include E<lt>stdlib.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getloadavg.3:41
#, no-wrap
msgid "B<int getloadavg(double >I<loadavg[]>B<, int >I<nelem>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getloadavg.3:53
msgid ""
"The B<getloadavg>()  function returns the number of processes in the system "
"run queue averaged over various periods of time.  Up to I<nelem> samples are "
"retrieved and assigned to successive elements of I<loadavg>[].  The system "
"imposes a maximum of 3 samples, representing averages over the last 1, 5, "
"and 15 minutes, respectively."
msgstr ""

#.  .SH HISTORY
#.  The
#.  BR getloadavg ()
#.  function appeared in
#.  4.3BSD Reno .
#. type: Plain text
#: build/C/man3/getloadavg.3:61
msgid ""
"If the load average was unobtainable, -1 is returned; otherwise, the number "
"of samples actually retrieved is returned."
msgstr ""

#. type: Plain text
#: build/C/man3/getloadavg.3:63
msgid "This function is available in glibc since version 2.2."
msgstr ""

#.  mdoc seems to have a bug - there must be no newline here
#. type: Plain text
#: build/C/man3/getloadavg.3:67
msgid "Not in POSIX.1-2001.  Present on the BSDs and Solaris."
msgstr ""

#. type: Plain text
#: build/C/man3/getloadavg.3:70
msgid "B<uptime>(1), B<proc>(5)"
msgstr ""

#. type: TH
#: build/C/man3/getsubopt.3:23
#, no-wrap
msgid "GETSUBOPT"
msgstr ""

#. type: TH
#: build/C/man3/getsubopt.3:23 build/C/man3/mkdtemp.3:24 build/C/man3/mkstemp.3:33
#, no-wrap
msgid "2010-09-26"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:26
msgid "getsubopt - parse suboption arguments from a string"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:31
msgid ""
"B<int getsubopt(char **>I<optionp>B<, char * const *>I<tokens>B<, char "
"**>I<valuep>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:38
msgid "B<getsubopt>():"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:43
msgid "_XOPEN_SOURCE\\ E<gt>= 500 || _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:45
msgid "|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:62
msgid ""
"B<getsubopt>()  parses the list of comma-separated suboptions provided in "
"I<optionp>.  (Such a suboption list is typically produced when B<getopt>(3)  "
"is used to parse a command line; see for example the I<-o> option of "
"B<mount>(8).)  Each suboption may include an associated value, which is "
"separated from the suboption name by an equal sign.  The following is an "
"example of the kind of string that might be passed in I<optionp>:"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:65
msgid "B<ro,name=xyz>"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:75
msgid ""
"The I<tokens> argument is a pointer to a NULL-terminated array of pointers "
"to the tokens that B<getsubopt>()  will look for in I<optionp>.  The tokens "
"should be distinct, null-terminated strings containing at least one "
"character, with no embedded equal signs or commas."
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:96
msgid ""
"Each call to B<getsubopt>()  returns information about the next unprocessed "
"suboption in I<optionp>.  The first equal sign in a suboption (if any) is "
"interpreted as a separator between the name and the value of that "
"suboption.  The value extends to the next comma, or (for the last suboption) "
"to the end of the string.  If the name of the suboption matches a known name "
"from I<tokens>, and a value string was found, B<getsubopt>()  sets "
"I<*valuep> to the address of that string.  The first comma in I<optionp> is "
"overwritten with a null byte, so I<*valuep> is precisely the \"value "
"string\" for that suboption."
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:100
msgid ""
"If the suboption is recognized, but no value string was found, I<*valuep> is "
"set to NULL."
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:108
msgid ""
"When B<getsubopt>()  returns, I<optionp> points to the next suboption, or to "
"the null byte (\\(aq\\e0\\(aq) at the end of the string if the last "
"suboption was just processed."
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:120
msgid ""
"If the first suboption in I<optionp> is recognized, B<getsubopt>()  returns "
"the index of the matching suboption element in I<tokens>.  Otherwise, -1 is "
"returned and I<*valuep> is the entire I<name>B<[=>I<value>B<]> string."
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:127
msgid ""
"Since I<*optionp> is changed, the first suboption before the call to "
"B<getsubopt>()  is not (necessarily) the same as the first suboption after "
"B<getsubopt>()."
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:136
msgid ""
"Since B<getsubopt>()  overwrites any commas it finds in the string "
"I<*optionp>, that string must be writable; it cannot be a string constant."
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:138
msgid "The following program expects suboptions following a \"-o\" option."
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:144
#, no-wrap
msgid ""
"#define _XOPEN_SOURCE 500\n"
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>assert.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:161
#, no-wrap
msgid ""
"int main(int argc, char **argv)\n"
"{\n"
"    enum {\n"
"        RO_OPT = 0,\n"
"        RW_OPT,\n"
"        NAME_OPT\n"
"    };\n"
"    char *const token[] = {\n"
"        [RO_OPT]   = \"ro\",\n"
"        [RW_OPT]   = \"rw\",\n"
"        [NAME_OPT] = \"name\",\n"
"        NULL\n"
"    };\n"
"    char *subopts;\n"
"    char *value;\n"
"    int opt;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:166
#, no-wrap
msgid ""
"    int readonly = 0;\n"
"    int readwrite = 0;\n"
"    char *name = NULL;\n"
"    int errfnd = 0;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:172
#, no-wrap
msgid ""
"    while ((opt = getopt(argc, argv, \"o:\")) != -1) {\n"
"        switch (opt) {\n"
"        case \\(aqo\\(aq:\n"
"            subopts = optarg;\n"
"            while (*subopts != \\(aq\\e0\\(aq && !errfnd) {\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:177
#, no-wrap
msgid ""
"            switch (getsubopt(&subopts, token, &value)) {\n"
"            case RO_OPT:\n"
"                readonly = 1;\n"
"                break;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:181
#, no-wrap
msgid ""
"            case RW_OPT:\n"
"                readwrite = 1;\n"
"                break;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:189
#, no-wrap
msgid ""
"            case NAME_OPT:\n"
"                if (value == NULL) {\n"
"                    fprintf(stderr, \"Missing value for \"\n"
"                            \"suboption \\(aq%s\\(aq\\en\", "
"token[NAME_OPT]);\n"
"                    errfnd = 1;\n"
"                    continue;\n"
"                }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:192
#, no-wrap
msgid ""
"                name = value;\n"
"                break;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:206
#, no-wrap
msgid ""
"            default:\n"
"                fprintf(stderr, \"No match found \"\n"
"                        \"for token: /%s/\\en\", value);\n"
"                errfnd = 1;\n"
"                break;\n"
"            }\n"
"        }\n"
"        if (readwrite && readonly) {\n"
"            fprintf(stderr, \"Only one of \\(aq%s\\(aq and \\(aq%s\\(aq can "
"be \"\n"
"                    \"specified\\en\", token[RO_OPT], token[RW_OPT]);\n"
"            errfnd = 1;\n"
"        }\n"
"        break;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:211
#, no-wrap
msgid ""
"        default:\n"
"            errfnd = 1;\n"
"        }\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:218
#, no-wrap
msgid ""
"    if (errfnd || argc == 1) {\n"
"        fprintf(stderr, \"\\enUsage: %s -o E<lt>suboptstringE<gt>\\en\", "
"argv[0]);\n"
"        fprintf(stderr, \"suboptions are \\(aqro\\(aq, \\(aqrw\\(aq, \"\n"
"                \"and \\(aqname=E<lt>valueE<gt>\\(aq\\en\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:220
#, no-wrap
msgid "    /* Remainder of program... */\n"
msgstr ""

#. type: Plain text
#: build/C/man3/getsubopt.3:226
msgid "B<getopt>(3)"
msgstr ""

#. type: TH
#: build/C/man3/malloc.3:28
#, no-wrap
msgid "MALLOC"
msgstr ""

#. type: TH
#: build/C/man3/malloc.3:28
#, no-wrap
msgid "2011-09-08"
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:31
msgid "malloc, free, calloc, realloc - Allocate and free dynamic memory"
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:39
#, no-wrap
msgid ""
"B<void *malloc(size_t >I<size>B<);>\n"
"B<void free(void >I<*ptr>B<);>\n"
"B<void *calloc(size_t >I<nmemb>B<, size_t >I<size>B<);>\n"
"B<void *realloc(void >I<*ptr>B<, size_t >I<size>B<);>\n"
msgstr ""

#.  glibc does this:
#. type: Plain text
#: build/C/man3/malloc.3:56
msgid ""
"The B<malloc>()  function allocates I<size> bytes and returns a pointer to "
"the allocated memory.  I<The memory is not initialized>.  If I<size> is 0, "
"then B<malloc>()  returns either NULL, or a unique pointer value that can "
"later be successfully passed to B<free>()."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:72
msgid ""
"The B<free>()  function frees the memory space pointed to by I<ptr>, which "
"must have been returned by a previous call to B<malloc>(), B<calloc>()  or "
"B<realloc>().  Otherwise, or if I<free(ptr)> has already been called before, "
"undefined behavior occurs.  If I<ptr> is NULL, no operation is performed."
msgstr ""

#.  glibc does this:
#. type: Plain text
#: build/C/man3/malloc.3:91
msgid ""
"The B<calloc>()  function allocates memory for an array of I<nmemb> elements "
"of I<size> bytes each and returns a pointer to the allocated memory.  The "
"memory is set to zero.  If I<nmemb> or I<size> is 0, then B<calloc>()  "
"returns either NULL, or a unique pointer value that can later be "
"successfully passed to B<free>()."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:127
msgid ""
"The B<realloc>()  function changes the size of the memory block pointed to "
"by I<ptr> to I<size> bytes.  The contents will be unchanged in the range "
"from the start of the region up to the minimum of the old and new sizes.  If "
"the new size is larger than the old size, the added memory will I<not> be "
"initialized.  If I<ptr> is NULL, then the call is equivalent to "
"I<malloc(size)>, for all values of I<size>; if I<size> is equal to zero, and "
"I<ptr> is not NULL, then the call is equivalent to I<free(ptr)>.  Unless "
"I<ptr> is NULL, it must have been returned by an earlier call to "
"B<malloc>(), B<calloc>()  or B<realloc>().  If the area pointed to was "
"moved, a I<free(ptr)> is done."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:147
msgid ""
"The B<malloc>()  and B<calloc>()  functions return a pointer to the "
"allocated memory that is suitably aligned for any kind of variable.  On "
"error, these functions return NULL.  NULL may also be returned by a "
"successful call to B<malloc>()  with a I<size> of zero, or by a successful "
"call to B<calloc>()  with I<nmemb> or I<size> equal to zero."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:151
msgid "The B<free>()  function returns no value."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:166
msgid ""
"The B<realloc>()  function returns a pointer to the newly allocated memory, "
"which is suitably aligned for any kind of variable and may be different from "
"I<ptr>, or NULL if the request fails.  If I<size> was equal to 0, either "
"NULL or a pointer suitable to be passed to B<free>()  is returned.  If "
"B<realloc>()  fails the original block is left untouched; it is not freed or "
"moved."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:168
msgid "C89, C99."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:184
msgid ""
"By default, Linux follows an optimistic memory allocation strategy.  This "
"means that when B<malloc>()  returns non-NULL there is no guarantee that the "
"memory really is available.  In case it turns out that the system is out of "
"memory, one or more processes will be killed by the OOM killer.  For more "
"information, see the description of I</proc/sys/vm/overcommit_memory> and "
"I</proc/sys/vm/oom_adj> in B<proc>(5), and the kernel source file "
"I<Documentation/vm/overcommit-accounting>."
msgstr ""

#.  FIXME . there is no mallopt(3) man page yet.
#. type: Plain text
#: build/C/man3/malloc.3:206
msgid ""
"Normally, B<malloc>()  allocates memory from the heap, and adjusts the size "
"of the heap as required, using B<sbrk>(2).  When allocating blocks of memory "
"larger than B<MMAP_THRESHOLD> bytes, the glibc B<malloc>()  implementation "
"allocates the memory as a private anonymous mapping using B<mmap>(2).  "
"B<MMAP_THRESHOLD> is 128 kB by default, but is adjustable using "
"B<mallopt>(3).  Allocations performed using B<mmap>(2)  are unaffected by "
"the B<RLIMIT_DATA> resource limit (see B<getrlimit>(2))."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:224
msgid ""
"The UNIX 98 standard requires B<malloc>(), B<calloc>(), and B<realloc>()  to "
"set I<errno> to B<ENOMEM> upon failure.  Glibc assumes that this is done "
"(and the glibc versions of these routines do this); if you use a private "
"malloc implementation that does not set I<errno>, then certain library "
"routines may fail without having a reason in I<errno>."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:233
msgid ""
"Crashes in B<malloc>(), B<calloc>(), B<realloc>(), or B<free>()  are almost "
"always related to heap corruption, such as overflowing an allocated chunk or "
"freeing the same pointer twice."
msgstr ""

#. type: Plain text
#: build/C/man3/malloc.3:262
msgid ""
"Recent versions of Linux libc (later than 5.4.23) and glibc (2.x)  include a "
"B<malloc>()  implementation which is tunable via environment variables.  "
"When B<MALLOC_CHECK_> is set, a special (less efficient) implementation is "
"used which is designed to be tolerant against simple errors, such as double "
"calls of B<free>()  with the same argument, or overruns of a single byte "
"(off-by-one bugs).  Not all such errors can be protected against, however, "
"and memory leaks can result.  If B<MALLOC_CHECK_> is set to 0, any detected "
"heap corruption is silently ignored; if set to 1, a diagnostic message is "
"printed on I<stderr>; if set to 2, B<abort>(3)  is called immediately; if "
"set to 3, a diagnostic message is printed on I<stderr> and the program is "
"aborted.  Using a nonzero B<MALLOC_CHECK_> value can be useful because "
"otherwise a crash may happen much later, and the true cause for the problem "
"is then very hard to track down."
msgstr ""

#.  .BR mallopt (3),
#. type: Plain text
#: build/C/man3/malloc.3:268
msgid "B<brk>(2), B<mmap>(2), B<alloca>(3), B<posix_memalign>(3)"
msgstr ""

#. type: TH
#: build/C/man3/mblen.3:14
#, no-wrap
msgid "MBLEN"
msgstr ""

#. type: TH
#: build/C/man3/mblen.3:14 build/C/man3/wctomb.3:14
#, no-wrap
msgid "1999-07-25"
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:17
msgid "mblen - determine number of bytes in next multibyte character"
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:22
#, no-wrap
msgid "B<int mblen(const char *>I<s>B<, size_t >I<n>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:36
msgid ""
"If I<s> is not a NULL pointer, the B<mblen>()  function inspects at most "
"I<n> bytes of the multibyte string starting at I<s> and extracts the next "
"complete multibyte character.  It uses a static anonymous shift state only "
"known to the B<mblen>()  function.  If the multibyte character is not the "
"null wide character, it returns the number of bytes that were consumed from "
"I<s>.  If the multibyte character is the null wide character, it returns 0."
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:44
msgid ""
"If the I<n> bytes starting at I<s> do not contain a complete multibyte "
"character, B<mblen>()  returns -1.  This can happen even if I<n> is greater "
"than or equal to I<MB_CUR_MAX>, if the multibyte string contains redundant "
"shift sequences."
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:49
msgid ""
"If the multibyte string starting at I<s> contains an invalid multibyte "
"sequence before the next complete character, B<mblen>()  also returns -1."
msgstr ""

#.  The Dinkumware doc and the Single UNIX specification say this, but
#.  glibc doesn't implement this.
#. type: Plain text
#: build/C/man3/mblen.3:58
msgid ""
"If I<s> is a NULL pointer, the B<mblen>()  function resets the shift state, "
"only known to this function, to the initial state, and returns nonzero if "
"the encoding has nontrivial shift state, or zero if the encoding is "
"stateless."
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:68
msgid ""
"The B<mblen>()  function returns the number of bytes parsed from the "
"multibyte sequence starting at I<s>, if a non-null wide character was "
"recognized.  It returns 0, if a null wide character was recognized.  It "
"returns -1, if an invalid multibyte sequence was encountered or if it "
"couldn't parse a complete multibyte character."
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:70 build/C/man3/mbstowcs.3:70 build/C/man3/mbtowc.3:78 build/C/man3/wcstombs.3:70 build/C/man3/wctomb.3:66
msgid "C99."
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:77
msgid ""
"The behavior of B<mblen>()  depends on the B<LC_CTYPE> category of the "
"current locale."
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:82
msgid ""
"The function B<mbrlen>(3)  provides a better interface to the same "
"functionality."
msgstr ""

#. type: Plain text
#: build/C/man3/mblen.3:84
msgid "B<mbrlen>(3)"
msgstr ""

#. type: TH
#: build/C/man3/mbstowcs.3:14
#, no-wrap
msgid "MBSTOWCS"
msgstr ""

#. type: TH
#: build/C/man3/mbstowcs.3:14 build/C/man3/mbtowc.3:14
#, no-wrap
msgid "2011-09-28"
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:17
msgid "mbstowcs - convert a multibyte string to a wide-character string"
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:22
#, no-wrap
msgid ""
"B<size_t mbstowcs(wchar_t *>I<dest>B<, const char *>I<src>B<, size_t "
">I<n>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:33
msgid ""
"If I<dest> is not a NULL pointer, the B<mbstowcs>()  function converts the "
"multibyte string I<src> to a wide-character string starting at I<dest>.  At "
"most I<n> wide characters are written to I<dest>.  The conversion starts in "
"the initial state.  The conversion can stop for three reasons:"
msgstr ""

#. type: IP
#: build/C/man3/mbstowcs.3:33
#, no-wrap
msgid "1."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:38
msgid ""
"An invalid multibyte sequence has been encountered.  In this case "
"I<(size_t)\\ -1> is returned."
msgstr ""

#. type: IP
#: build/C/man3/mbstowcs.3:38
#, no-wrap
msgid "2."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:43
msgid ""
"I<n> non-L\\(aq\\e0\\(aq wide characters have been stored at I<dest>.  In "
"this case the number of wide characters written to I<dest> is returned, but "
"the shift state at this point is lost."
msgstr ""

#. type: IP
#: build/C/man3/mbstowcs.3:43
#, no-wrap
msgid "3."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:48
msgid ""
"The multibyte string has been completely converted, including the "
"terminating null wide character (\\(aq\\e0\\(aq).  In this case the number "
"of wide characters written to I<dest>, excluding the terminating null wide "
"character, is returned."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:51
msgid ""
"The programmer must ensure that there is room for at least I<n> wide "
"characters at I<dest>."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:55
msgid ""
"If I<dest> is NULL, I<n> is ignored, and the conversion proceeds as above, "
"except that the converted wide characters are not written out to memory, and "
"that no length limit exists."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:58
msgid ""
"In order to avoid the case 2 above, the programmer should make sure I<n> is "
"greater or equal to I<mbstowcs(NULL,src,0)+1>."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:68
msgid ""
"The B<mbstowcs>()  function returns the number of wide characters that make "
"up the converted part of the wide-character string, not including the "
"terminating null wide character.  If an invalid multibyte sequence was "
"encountered, I<(size_t)\\ -1> is returned."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:77
msgid ""
"The behavior of B<mbstowcs>()  depends on the B<LC_CTYPE> category of the "
"current locale."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:82
msgid ""
"The function B<mbsrtowcs>(3)  provides a better interface to the same "
"functionality."
msgstr ""

#. type: Plain text
#: build/C/man3/mbstowcs.3:85
msgid "B<mbsrtowcs>(3), B<wcstombs(3)>"
msgstr ""

#. type: TH
#: build/C/man3/mbtowc.3:14
#, no-wrap
msgid "MBTOWC"
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:17
msgid "mbtowc - convert a multibyte sequence to a wide character"
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:22
#, no-wrap
msgid "B<int mbtowc(wchar_t *>I<pwc>B<, const char *>I<s>B<, size_t >I<n>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:37
msgid ""
"The main case for this function is when I<s> is not NULL and I<pwc> is not "
"NULL.  In this case, the B<mbtowc>()  function inspects at most I<n> bytes "
"of the multibyte string starting at I<s>, extracts the next complete "
"multibyte character, converts it to a wide character and stores it at "
"I<*pwc>.  It updates an internal shift state only known to the mbtowc "
"function.  If I<s> does not point to a null byte (\\(aq\\e0\\(aq), it "
"returns the number of bytes that were consumed from I<s>, otherwise it "
"returns 0."
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:44
msgid ""
"If the I<n> bytes starting at I<s> do not contain a complete multibyte "
"character, or if they contain an invalid multibyte sequence, B<mbtowc>()  "
"returns -1.  This can happen even if I<n> E<gt>= I<MB_CUR_MAX>, if the "
"multibyte string contains redundant shift sequences."
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:51
msgid ""
"A different case is when I<s> is not NULL but I<pwc> is NULL.  In this case "
"the B<mbtowc>()  function behaves as above, except that it does not store "
"the converted wide character in memory."
msgstr ""

#.  The Dinkumware doc and the Single UNIX specification say this, but
#.  glibc doesn't implement this.
#. type: Plain text
#: build/C/man3/mbtowc.3:64
msgid ""
"A third case is when I<s> is NULL.  In this case, I<pwc> and I<n> are "
"ignored.  The B<mbtowc>()  function resets the shift state, only known to "
"this function, to the initial state, and returns nonzero if the encoding has "
"nontrivial shift state, or zero if the encoding is stateless."
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:70
msgid ""
"If I<s> is not NULL, the B<mbtowc>()  function returns the number of "
"consumed bytes starting at I<s>, or 0 if I<s> points to a null byte, or -1 "
"upon failure."
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:76
msgid ""
"If I<s> is NULL, the B<mbtowc>()  function returns nonzero if the encoding "
"has nontrivial shift state, or zero if the encoding is stateless."
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:85
msgid ""
"The behavior of B<mbtowc>()  depends on the B<LC_CTYPE> category of the "
"current locale."
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:91
msgid ""
"This function is not multithread safe.  The function B<mbrtowc>(3)  provides "
"a better interface to the same functionality."
msgstr ""

#. type: Plain text
#: build/C/man3/mbtowc.3:95
msgid "B<MB_CUR_MAX>(3), B<mbrtowc>(3), B<mbstowcs>(3)"
msgstr ""

#. type: TH
#: build/C/man3/mkdtemp.3:24
#, no-wrap
msgid "MKDTEMP"
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:27
msgid "mkdtemp - create a unique temporary directory"
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:32
#, no-wrap
msgid "B<char *mkdtemp(char *>I<template>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:40
msgid "B<mkdtemp>():"
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:45
msgid "_BSD_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:47
msgid "|| /* Since glibc 2.10: */"
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:49
msgid "(_POSIX_C_SOURCE\\ E<gt>=\\ 200809L || _XOPEN_SOURCE\\ E<gt>=\\ 700)"
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:65
msgid ""
"The B<mkdtemp>()  function generates a uniquely named temporary directory "
"from I<template>.  The last six characters of I<template> must be XXXXXX and "
"these are replaced with a string that makes the directory name unique.  The "
"directory is then created with permissions 0700.  Since it will be modified, "
"I<template> must not be a string constant, but should be declared as a "
"character array."
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:72
msgid ""
"The B<mkdtemp>()  function returns a pointer to the modified template string "
"on success, and NULL on failure, in which case I<errno> is set "
"appropriately."
msgstr ""

#. type: SH
#: build/C/man3/mkdtemp.3:72 build/C/man3/mkstemp.3:142 build/C/man3/mktemp.3:84 build/C/man3/putenv.3:70 build/C/man3/random.3:130 build/C/man3/random_r.3:100 build/C/man3/rpmatch.3:71 build/C/man3/setenv.3:98 build/C/man3/strtod.3:154 build/C/man3/strtol.3:124 build/C/man3/strtoul.3:127
#, no-wrap
msgid "ERRORS"
msgstr ""

#. type: TP
#: build/C/man3/mkdtemp.3:73 build/C/man3/mkstemp.3:147 build/C/man3/mktemp.3:85 build/C/man3/random.3:131 build/C/man3/random_r.3:101 build/C/man3/random_r.3:105 build/C/man3/random_r.3:114 build/C/man3/setenv.3:99 build/C/man3/strtol.3:125 build/C/man3/strtoul.3:128
#, no-wrap
msgid "B<EINVAL>"
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:77
msgid ""
"The last six characters of I<template> were not XXXXXX.  Now I<template> is "
"unchanged."
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:81
msgid "Also see B<mkdir>(2)  for other possible values for I<errno>."
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:83
msgid "Available since glibc 2.1.91."
msgstr ""

#.  As at 2006, this function is being considered for a revision of POSIX.1
#.  Also in NetBSD 1.4.
#. type: Plain text
#: build/C/man3/mkdtemp.3:88
msgid "POSIX.1-2008.  This function is present on the BSDs."
msgstr ""

#. type: Plain text
#: build/C/man3/mkdtemp.3:95
msgid ""
"B<mkdir>(2), B<mkstemp>(3), B<mktemp>(3), B<tempnam>(3), B<tmpfile>(3), "
"B<tmpnam>(3)"
msgstr ""

#. type: TH
#: build/C/man3/mkstemp.3:33
#, no-wrap
msgid "MKSTEMP"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:36
msgid "mkstemp, mkostemp - create a unique temporary file"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:41
#, no-wrap
msgid "B<int mkstemp(char *>I<template>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:43
#, no-wrap
msgid "B<int mkostemp(char *>I<template>B<, int >I<flags>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:45
#, no-wrap
msgid "B<int mkstemps(char *>I<template>B<, int >I<suffixlen>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:47
#, no-wrap
msgid ""
"B<int mkostemps(char *>I<template>B<, int >I<suffixlen>B<, int "
">I<flags>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:55
msgid "B<mkstemp>():"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:60 build/C/man3/mktemp.3:61
msgid ""
"_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
"_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:62
msgid "|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200112L"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:68
msgid "B<mkostemp>(): _GNU_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:71
msgid "B<mkstemps>(): _BSD_SOURCE || _SVID_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:74
msgid "B<mkostemps>(): _GNU_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:81
msgid ""
"The B<mkstemp>()  function generates a unique temporary filename from "
"I<template>, creates and opens the file, and returns an open file descriptor "
"for the file."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:89
msgid ""
"The last six characters of I<template> must be \"XXXXXX\" and these are "
"replaced with a string that makes the filename unique.  Since it will be "
"modified, I<template> must not be a string constant, but should be declared "
"as a character array."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:99
msgid ""
"The file is created with permissions 0600, that is, read plus write for "
"owner only.  (In glibc versions 2.06 and earlier, the file is created with "
"permissions 0666, that is, read and write for all users.)  The returned file "
"descriptor provides both read and write access to the file.  The file is "
"opened with the B<open>(2)  B<O_EXCL> flag, guaranteeing that the caller is "
"the process that creates the file."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:111
msgid ""
"The B<mkostemp>()  function is like B<mkstemp>(), with the difference that "
"flags as for B<open>(2)  may be specified in I<flags> (e.g., B<O_APPEND>, "
"B<O_SYNC>)."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:127
msgid ""
"The B<mkstemps>()  function is like B<mkstemp>(), except that the string in "
"I<template> contains a suffix of I<suffixlen> characters.  Thus, I<template> "
"is of the form I<prefixXXXXXXsuffix>, and the string XXXXXX is modified as "
"for B<mkstemp>()."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:136
msgid ""
"The B<mkostemps>()  function is to B<mkstemps>()  as B<mkostemp>()  is to "
"B<mkstemp>()."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:142
msgid ""
"On success, these functions return the file descriptor of the temporary "
"file.  On error, -1 is returned, and I<errno> is set appropriately."
msgstr ""

#. type: TP
#: build/C/man3/mkstemp.3:143
#, no-wrap
msgid "B<EEXIST>"
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:147
msgid ""
"Could not create a unique temporary filename.  Now the contents of "
"I<template> are undefined."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:155
msgid ""
"For B<mkstemp>()  and B<mkostemp>(): The last six characters of I<template> "
"were not XXXXXX; now I<template> is unchanged."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:166
msgid ""
"For B<mkstemps>()  and B<mkostemps>(): I<template> is less than I<(6 + "
"suffixlen)> characters long, or the last 6 characters before the suffix in "
"I<template> were not XXXXXX."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:169
msgid ""
"These functions may also fail with any of the errors described for "
"B<open>(2)."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:176
msgid ""
"B<mkostemp>()  is available since glibc 2.7.  B<mkstemps>()  and "
"B<mkostemps>()  are available since glibc 2.11."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:179
msgid "B<mkstemp>(): 4.3BSD, POSIX.1-2001."
msgstr ""

#.  mkstemps() appears to be at least on the BSDs, Mac OS X, Solaris,
#.  and Tru64.
#. type: Plain text
#: build/C/man3/mkstemp.3:184
msgid "B<mkstemps>(): unstandardized, but appears on several other systems."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:189
msgid "B<mkostemp>()  and B<mkostemps>(): are glibc extensions."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:193
msgid ""
"The old behavior of creating a file with mode 0666 may be a security risk, "
"especially since other UNIX flavors use 0600, and somebody might overlook "
"this detail when porting programs."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:204
msgid ""
"More generally, the POSIX specification of B<mkstemp>()  does not say "
"anything about file modes, so the application should make sure its file mode "
"creation mask (see B<umask>(2))  is set appropriately before calling "
"B<mkstemp>()  (and B<mkostemp>())."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:211
msgid ""
"The prototype for B<mktemp>()  is in I<E<lt>unistd.hE<gt>> for libc4, libc5, "
"glibc1; glibc2 follows POSIX.1 and has the prototype in "
"I<E<lt>stdlib.hE<gt>>."
msgstr ""

#. type: Plain text
#: build/C/man3/mkstemp.3:217
msgid "B<mkdtemp>(3), B<mktemp>(3), B<tempnam>(3), B<tmpfile>(3), B<tmpnam>(3)"
msgstr ""

#. type: TH
#: build/C/man3/mktemp.3:32
#, no-wrap
msgid "MKTEMP"
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:35
msgid "mktemp - make a unique temporary filename"
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:40
#, no-wrap
msgid "B<char *mktemp(char *>I<template>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:48
msgid "B<mktemp>():"
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:57
#, no-wrap
msgid ""
"_BSD_SOURCE || _SVID_SOURCE ||\n"
"    (_XOPEN_SOURCE\\ E<gt>=\\ 500 ||\n"
"         _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED) &&\n"
"    !(_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600)\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:75
msgid ""
"The B<mktemp>()  function generates a unique temporary filename from "
"I<template>.  The last six characters of I<template> must be XXXXXX and "
"these are replaced with a string that makes the filename unique.  Since it "
"will be modified, I<template> must not be a string constant, but should be "
"declared as a character array."
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:84
msgid ""
"The B<mktemp>()  function always returns I<template>.  If a unique name was "
"created, the last six bytes of I<template> will have been modified in such a "
"way that the resulting name is unique (i.e., does not exist already)  If a "
"unique name could not be created, I<template> is made an empty string."
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:88
msgid "The last six characters of I<template> were not XXXXXX."
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:92
msgid ""
"4.3BSD, POSIX.1-2001.  POSIX.1-2008 removes the specification of "
"B<mktemp>()."
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:98
msgid ""
"The prototype is in I<E<lt>unistd.hE<gt>> for libc4, libc5, glibc1; glibc2 "
"follows the Single UNIX Specification and has the prototype in "
"I<E<lt>stdlib.hE<gt>>."
msgstr ""

#. type: SH
#: build/C/man3/mktemp.3:98 build/C/man3/rpmatch.3:90 build/C/man3/setenv.3:121
#, no-wrap
msgid "BUGS"
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:111
msgid ""
"Never use B<mktemp>().  Some implementations follow 4.3BSD and replace "
"XXXXXX by the current process ID and a single letter, so that at most 26 "
"different names can be returned.  Since on the one hand the names are easy "
"to guess, and on the other hand there is a race between testing whether the "
"name exists and opening the file, every use of B<mktemp>()  is a security "
"risk.  The race is avoided by B<mkstemp>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/mktemp.3:116
msgid "B<mkstemp>(3), B<tempnam>(3), B<tmpfile>(3), B<tmpnam>(3)"
msgstr ""

#. type: TH
#: build/C/man3/on_exit.3:29
#, no-wrap
msgid "ON_EXIT"
msgstr ""

#. type: Plain text
#: build/C/man3/on_exit.3:32
msgid "on_exit - register a function to be called at normal process termination"
msgstr ""

#. type: Plain text
#: build/C/man3/on_exit.3:37
#, no-wrap
msgid "B<int on_exit(void (*>I<function>B<)(int , void *), void *>I<arg>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/on_exit.3:46
msgid "B<on_exit>(): _BSD_SOURCE || _SVID_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/on_exit.3:57
msgid ""
"The B<on_exit>()  function registers the given I<function> to be called at "
"normal process termination, whether via B<exit>(3)  or via return from the "
"program's I<main>().  The I<function> is passed the status argument given to "
"the last call to B<exit>(3)  and the I<arg> argument from B<on_exit>()."
msgstr ""

#. type: Plain text
#: build/C/man3/on_exit.3:72
msgid ""
"The B<on_exit>()  function returns the value 0 if successful; otherwise it "
"returns a nonzero value."
msgstr ""

#. type: Plain text
#: build/C/man3/on_exit.3:79
msgid ""
"This function comes from SunOS 4, but is also present in libc4, libc5 and "
"glibc.  It no longer occurs in Solaris (SunOS 5).  Avoid this function, and "
"use the standard B<atexit>(3)  instead."
msgstr ""

#. type: Plain text
#: build/C/man3/on_exit.3:83
msgid "B<_exit>(2), B<atexit>(3), B<exit>(3)"
msgstr ""

#. type: TH
#: build/C/man3/putenv.3:34
#, no-wrap
msgid "PUTENV"
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:37
msgid "putenv - change or add an environment variable"
msgstr ""

#.  Not: const char *
#. type: Plain text
#: build/C/man3/putenv.3:43
#, no-wrap
msgid "B<int putenv(char *>I<string>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:52
msgid "B<putenv>(): _SVID_SOURCE || _XOPEN_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:65
msgid ""
"The B<putenv>()  function adds or changes the value of environment "
"variables.  The argument I<string> is of the form I<name>=I<value>.  If "
"I<name> does not already exist in the environment, then I<string> is added "
"to the environment.  If I<name> does exist, then the value of I<name> in the "
"environment is changed to I<value>.  The string pointed to by I<string> "
"becomes part of the environment, so altering the string changes the "
"environment."
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:70
msgid ""
"The B<putenv>()  function returns zero on success, or nonzero if an error "
"occurs."
msgstr ""

#. type: TP
#: build/C/man3/putenv.3:71 build/C/man3/setenv.3:104
#, no-wrap
msgid "B<ENOMEM>"
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:74
msgid "Insufficient space to allocate new environment."
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:76
msgid "SVr4, POSIX.1-2001, 4.3BSD."
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:81
msgid ""
"The B<putenv>()  function is not required to be reentrant, and the one in "
"libc4, libc5 and glibc 2.0 is not, but the glibc 2.1 version is."
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:94
msgid ""
"Description for libc4, libc5, glibc: If the argument I<string> is of the "
"form I<name>, and does not contain an \\(aq=\\(aq character, then the "
"variable I<name> is removed from the environment.  If B<putenv>()  has to "
"allocate a new array I<environ>, and the previous array was also allocated "
"by B<putenv>(), then it will be freed.  In no case will the old storage "
"associated to the environment variable itself be freed."
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:110
msgid ""
"The libc4 and libc5 and glibc 2.1.2 versions conform to SUSv2: the pointer "
"I<string> given to B<putenv>()  is used.  In particular, this string becomes "
"part of the environment; changing it later will change the environment.  "
"(Thus, it is an error is to call B<putenv>()  with an automatic variable as "
"the argument, then return from the calling function while I<string> is still "
"part of the environment.)  However, glibc 2.0-2.1.1 differs: a copy of the "
"string is used.  On the one hand this causes a memory leak, and on the other "
"hand it violates SUSv2.  This has been fixed in glibc 2.1.2."
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:112
msgid "The 4.4BSD version, like glibc 2.0, uses a copy."
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:114
msgid "SUSv2 removes the I<const> from the prototype, and so does glibc 2.1.3."
msgstr ""

#. type: Plain text
#: build/C/man3/putenv.3:120
msgid "B<clearenv>(3), B<getenv>(3), B<setenv>(3), B<unsetenv>(3), B<environ>(7)"
msgstr ""

#. type: TH
#: build/C/man3/qecvt.3:26
#, no-wrap
msgid "QECVT"
msgstr ""

#. type: Plain text
#: build/C/man3/qecvt.3:29
msgid "qecvt, qfcvt, qgcvt - convert a floating-point number to a string"
msgstr ""

#. type: Plain text
#: build/C/man3/qecvt.3:34
msgid ""
"B<char *qecvt(long double >I<number>B<, int >I<ndigits>B<, int "
"*>I<decpt>B<,> B<int *>I<sign>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/qecvt.3:37
msgid ""
"B<char *qfcvt(long double >I<number>B<, int >I<ndigits>B<, int "
"*>I<decpt>B<,> B<int *>I<sign>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/qecvt.3:39
msgid "B<char *qgcvt(long double >I<number>B<, int >I<ndigit>B<, char *>I<buf>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/qecvt.3:50
msgid "B<qecvt>(), B<qfcvt>(), B<qgcvt>(): _SVID_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/qecvt.3:70
msgid ""
"The functions B<qecvt>(), B<qfcvt>()  and B<qgcvt>()  are identical to "
"B<ecvt>(3), B<fcvt>(3)  and B<gcvt>(3)  respectively, except that they use a "
"I<long double> argument I<number>.  See B<ecvt>(3)  and B<gcvt>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/qecvt.3:76
msgid ""
"SVr4.  Not seen in most common UNIX implementations, but occurs in SunOS.  "
"Not supported by libc4 and libc5.  Supported by glibc."
msgstr ""

#. type: Plain text
#: build/C/man3/qecvt.3:86
msgid "B<ecvt>(3), B<ecvt_r>(3), B<gcvt>(3), B<sprintf>(3)"
msgstr ""

#. type: TH
#: build/C/man3/rand.3:39
#, no-wrap
msgid "RAND"
msgstr ""

#. type: TH
#: build/C/man3/rand.3:39
#, no-wrap
msgid "2010-10-01"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:42
msgid "rand, rand_r, srand - pseudo-random number generator"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:47
#, no-wrap
msgid "B<int rand(void);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:49
#, no-wrap
msgid "B<int rand_r(unsigned int *>I<seedp>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:51
#, no-wrap
msgid "B<void srand(unsigned int >I<seed>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:60
msgid "B<rand_r>(): _POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:66
msgid ""
"The B<rand>()  function returns a pseudo-random integer in the range 0 to "
"B<RAND_MAX> inclusive (i.e., the mathematical range [0,\\ B<RAND_MAX>])."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:75
msgid ""
"The B<srand>()  function sets its argument as the seed for a new sequence of "
"pseudo-random integers to be returned by B<rand>().  These sequences are "
"repeatable by calling B<srand>()  with the same seed value."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:79
msgid ""
"If no seed value is provided, the B<rand>()  function is automatically "
"seeded with a value of 1."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:90
msgid ""
"The function B<rand>()  is not reentrant or thread-safe, since it uses "
"hidden state that is modified on each call.  This might just be the seed "
"value to be used by the next call, or it might be something more elaborate.  "
"In order to get reproducible behavior in a threaded application, this state "
"must be made explicit; this can be done using the reentrant function "
"B<rand_r>()."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:106
msgid ""
"Like B<rand>(), B<rand_r>()  returns a pseudo-random integer in the range "
"[0,\\ B<RAND_MAX>].  The I<seedp> argument is a pointer to an I<unsigned "
"int> that is used to store state between calls.  If B<rand_r>()  is called "
"with the same initial value for the integer pointed to by I<seedp>, and that "
"value is not modified between calls, then the same pseudo-random sequence "
"will result."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:116
msgid ""
"The value pointed to by the I<seedp> argument of B<rand_r>()  provides only "
"a very small amount of state, so this function will be a weak pseudo-random "
"generator.  Try B<drand48_r>(3)  instead."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:127
msgid ""
"The B<rand>()  and B<rand_r>()  functions return a value between 0 and "
"B<RAND_MAX> (inclusive).  The B<srand>()  function returns no value."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:139
msgid ""
"The functions B<rand>()  and B<srand>()  conform to SVr4, 4.3BSD, C89, C99, "
"POSIX.1-2001.  The function B<rand_r>()  is from POSIX.1-2001.  POSIX.1-2008 "
"marks B<rand_r>()  as obsolete."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:158
msgid ""
"The versions of B<rand>()  and B<srand>()  in the Linux C Library use the "
"same random number generator as B<random>(3)  and B<srandom>(3), so the "
"lower-order bits should be as random as the higher-order bits.  However, on "
"older B<rand>()  implementations, and on current implementations on "
"different systems, the lower-order bits are much less random than the "
"higher-order bits.  Do not use this function in applications intended to be "
"portable when good randomness is needed.  (Use B<random>(3)  instead.)"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:164
msgid ""
"POSIX.1-2001 gives the following example of an implementation of B<rand>()  "
"and B<srand>(), possibly useful when one needs the same sequence on two "
"different machines."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:168
#, no-wrap
msgid "static unsigned long next = 1;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:174
#, no-wrap
msgid ""
"/* RAND_MAX assumed to be 32767 */\n"
"int myrand(void) {\n"
"    next = next * 1103515245 + 12345;\n"
"    return((unsigned)(next/65536) % 32768);\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:178
#, no-wrap
msgid ""
"void mysrand(unsigned seed) {\n"
"    next = seed;\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:185
msgid ""
"The following program can be used to display the pseudo-random sequence "
"produced by B<rand>()  when given a particular seed."
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:190
#, no-wrap
msgid ""
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:196
#, no-wrap
msgid ""
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    int j, r, nloops;\n"
"    unsigned int seed;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:201
#, no-wrap
msgid ""
"    if (argc != 3) {\n"
"        fprintf(stderr, \"Usage: %s E<lt>seedE<gt> E<lt>nloopsE<gt>\\en\", "
"argv[0]);\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:204
#, no-wrap
msgid ""
"    seed = atoi(argv[1]);\n"
"    nloops = atoi(argv[2]);\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:210
#, no-wrap
msgid ""
"    srand(seed);\n"
"    for (j = 0; j E<lt> nloops; j++) {\n"
"        r =  rand();\n"
"        printf(\"%d\\en\", r);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rand.3:218
msgid "B<drand48>(3), B<random>(3)"
msgstr ""

#. type: TH
#: build/C/man3/random.3:31
#, no-wrap
msgid "RANDOM"
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:34
msgid "random, srandom, initstate, setstate - random number generator"
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:39
#, no-wrap
msgid "B<long int random(void);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:41
#, no-wrap
msgid "B<void srandom(unsigned int >I<seed>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:43
#, no-wrap
msgid ""
"B<char *initstate(unsigned int >I<seed>B<, char *>I<state>B<, size_t "
">I<n>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:45
#, no-wrap
msgid "B<char *setstate(char *>I<state>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:57
msgid "B<random>(), B<srandom>(), B<initstate>(), B<setstate>():"
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:60
msgid ""
"_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
"_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:71
msgid ""
"The B<random>()  function uses a nonlinear additive feedback random number "
"generator employing a default table of size 31 long integers to return "
"successive pseudo-random numbers in the range from 0 to B<RAND_MAX>.  The "
"period of this random number generator is very large, approximately I<16\\ "
"*\\ ((2^31)\\ -\\ 1)>."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:85
msgid ""
"The B<srandom>()  function sets its argument as the seed for a new sequence "
"of pseudo-random integers to be returned by B<random>().  These sequences "
"are repeatable by calling B<srandom>()  with the same seed value.  If no "
"seed value is provided, the B<random>()  function is automatically seeded "
"with a value of 1."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:100
msgid ""
"The B<initstate>()  function allows a state array I<state> to be initialized "
"for use by B<random>().  The size of the state array I<n> is used by "
"B<initstate>()  to decide how sophisticated a random number generator it "
"should use\\(emthe larger the state array, the better the random numbers "
"will be.  I<seed> is the seed for the initialization, which specifies a "
"starting point for the random number sequence, and provides for restarting "
"at the same point."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:116
msgid ""
"The B<setstate>()  function changes the state array used by the B<random>()  "
"function.  The state array I<state> is used for random number generation "
"until the next call to B<initstate>()  or B<setstate>().  I<state> must "
"first have been initialized using B<initstate>()  or be the result of a "
"previous call of B<setstate>()."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:130
msgid ""
"The B<random>()  function returns a value between 0 and B<RAND_MAX>.  The "
"B<srandom>()  function returns no value.  The B<initstate>()  function "
"returns a pointer to the previous state array.  The B<setstate>()  function "
"returns a pointer to the previous state array, or NULL on error."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:135
msgid "A state array of less than 8 bytes was specified to B<initstate>()."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:137 build/C/man3/setenv.3:109
msgid "4.3BSD, POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:143
msgid ""
"Current \"optimal\" values for the size of the state array I<n> are 8, 32, "
"64, 128, and 256 bytes; other amounts will be rounded down to the nearest "
"known amount.  Using less than 8 bytes will cause an error."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:150
msgid ""
"This function should not be used in cases where multiple threads use "
"B<random>()  and the behavior should be reproducible.  Use B<random_r>(3)  "
"for that purpose."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:157
msgid ""
"Random-number generation is a complex topic.  I<Numerical Recipes in C: The "
"Art of Scientific Computing> (William H. Press, Brian P. Flannery, Saul "
"A. Teukolsky, William T. Vetterling; New York: Cambridge University Press, "
"2007, 3rd ed.)  provides an excellent discussion of practical random-number "
"generation issues in Chapter 7 (Random Numbers)."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:163
msgid ""
"For a more theoretical discussion which also covers many practical issues in "
"depth, see Chapter 3 (Random Numbers) in Donald E. Knuth's I<The Art of "
"Computer Programming>, volume 2 (Seminumerical Algorithms), 2nd ed.; "
"Reading, Massachusetts: Addison-Wesley Publishing Company, 1981."
msgstr ""

#. type: Plain text
#: build/C/man3/random.3:168
msgid "B<drand48>(3), B<rand>(3), B<random_r>(3), B<srand>(3)"
msgstr ""

#. type: TH
#: build/C/man3/random_r.3:24
#, no-wrap
msgid "RANDOM_R"
msgstr ""

#. type: TH
#: build/C/man3/random_r.3:24
#, no-wrap
msgid "2008-03-07"
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:28
msgid ""
"random_r, srandom_r, initstate_r, setstate_r - reentrant random number "
"generator"
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:33
#, no-wrap
msgid "B<int random_r(struct random_data *>I<buf>B<, int32_t *>I<result>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:35
#, no-wrap
msgid "B<int srandom_r(unsigned int >I<seed>B<, struct random_data *>I<buf>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:38
#, no-wrap
msgid ""
"B<int initstate_r(unsigned int >I<seed>B<, char *>I<statebuf>B<,>\n"
"B<                size_t >I<statelen>B<, struct random_data *>I<buf>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:40
#, no-wrap
msgid "B<int setstate_r(char *>I<statebuf>B<, struct random_data *>I<buf>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:52
msgid "B<random_r>(), B<srandom_r>(), B<initstate_r>(), B<setstate_r>():"
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:54
msgid "_SVID_SOURCE || _BSD_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:62
msgid ""
"These functions are the reentrant equivalents of the functions described in "
"B<random>(3).  They are suitable for use in multithreaded programs where "
"each thread needs to obtain an independent, reproducible sequence of random "
"numbers."
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:73
msgid ""
"The B<random_r>()  function is like B<random>(3), except that instead of "
"using state information maintained in a global variable, it uses the state "
"information in the argument pointed to by I<buf>.  The generated random "
"number is returned in the argument I<result>."
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:82
msgid ""
"The B<srandom_r>()  function is like B<srandom>(3), except that it "
"initializes the seed for the random number generator whose state is "
"maintained in the object pointed to by I<buf>, instead of the seed "
"associated with the global state variable."
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:90
msgid ""
"The B<initstate_r>()  function is like B<initstate>(3)  except that it "
"initializes the state in the object pointed to by I<buf>, rather than "
"initializing the global state variable."
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:98
msgid ""
"The B<setstate_r>()  function is like B<setstate>(3)  except that it "
"modifies the state in the object pointer to by I<buf>, rather than modifying "
"the global state variable."
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:100
msgid "All of these functions return 0 on success, or -1 on error."
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:105
msgid "A state array of less than 8 bytes was specified to B<initstate_r>()."
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:114
msgid "The I<statebuf> or I<buf> argument to B<setstate_r>()  was NULL."
msgstr ""

#. type: Plain text
#: build/C/man3/random_r.3:123
msgid "The I<buf> or I<result> argument to B<random_r>()  was NULL."
msgstr ""

#.  These functions appear to be on Tru64, but don't seem to be on
#.  Solaris, HP-UX, or FreeBSD.
#. type: Plain text
#: build/C/man3/random_r.3:127
msgid "These functions are nonstandard glibc extensions."
msgstr ""

#. type: TH
#: build/C/man3/rpmatch.3:27
#, no-wrap
msgid "RPMATCH"
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:30
msgid "rpmatch - determine if the answer to a question is affirmative or negative"
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:35
#, no-wrap
msgid "B<int rpmatch(const char *>I<response>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:44
msgid "B<rpmatch>(): _SVID_SOURCE"
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:48
msgid ""
"B<rpmatch>()  handles a user response to yes or no questions, with support "
"for internationalization."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:54
msgid ""
"I<response> should be a null-terminated string containing a user-supplied "
"response, perhaps obtained with B<fgets>(3)  or B<getline>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:60
msgid ""
"The user's language preference is taken into account per the environment "
"variables B<LANG>, B<LC_MESSAGES>, and B<LC_ALL>, if the program has called "
"B<setlocale>(3)  to effect their changes."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:64
msgid ""
"Regardless of the locale, responses matching B<^[Yy]> are always accepted as "
"affirmative, and those matching B<^[Nn]> are always accepted as negative."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:71
msgid ""
"After examining I<response>, B<rpmatch>()  returns 0 for a recognized "
"negative response (\"no\"), 1 for a recognized positive response (\"yes\"), "
"and -1 when the value of I<response> is unrecognized."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:75
msgid ""
"A return value of -1 may indicate either an invalid input, or some other "
"error.  It is incorrect to only test if the return value is nonzero."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:85
msgid ""
"B<rpmatch>()  can fail for any of the reasons that B<regcomp>(3)  or "
"B<regexec>(3)  can fail; the cause of the error is not available from "
"I<errno> or anywhere else, but indicates a failure of the regex engine (but "
"this case is indistinguishable from that of an unrecognized value of "
"I<response>)."
msgstr ""

#.  It is available on at least AIX 5.1 and FreeBSD 6.0.
#. type: Plain text
#: build/C/man3/rpmatch.3:90
msgid ""
"B<rpmatch>()  is not required by any standard, but is available on a few "
"other systems."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:102
msgid ""
"The B<rpmatch>()  implementation looks at only the first character of "
"I<response>.  As a consequence, \"nyes\" returns 0, and \"ynever; not in a "
"million years\" returns 1.  It would be preferable to accept input strings "
"much more strictly, for example (using the extended regular expression "
"notation described in B<regex>(7)): B<^([yY]|yes|YES)$> and "
"B<^([nN]|no|NO)$>."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:106
msgid ""
"The following program displays the results when B<rpmatch>()  is applied to "
"the string given in the program's command-line argument."
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:113
#, no-wrap
msgid ""
"#define _SVID_SOURCE\n"
"#include E<lt>locale.hE<gt>\n"
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>string.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:121
#, no-wrap
msgid ""
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    if (argc != 2 || strcmp(argv[1], \"--help\") == 0) {\n"
"        fprintf(stderr, \"%s response\\en\", argv[0]);\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:126
#, no-wrap
msgid ""
"    setlocale(LC_ALL, \"\");\n"
"    printf(\"rpmatch() returns: %d\\en\", rpmatch(argv[1]));\n"
"    exit(EXIT_SUCCESS);\n"
"}\n"
msgstr ""

#. type: Plain text
#: build/C/man3/rpmatch.3:133
msgid ""
"B<fgets>(3), B<getline>(3), B<nl_langinfo>(3), B<regcomp>(3), "
"B<setlocale>(3)"
msgstr ""

#. type: TH
#: build/C/man3/setenv.3:35
#, no-wrap
msgid "SETENV"
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:38
msgid "setenv - change or add an environment variable"
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:43
#, no-wrap
msgid ""
"B<int setenv(const char *>I<name>B<, const char *>I<value>B<, int "
">I<overwrite>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:45
#, no-wrap
msgid "B<int unsetenv(const char *>I<name>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:55
msgid "B<setenv>(), B<unsetenv>():"
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:57
msgid ""
"_BSD_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ "
"E<gt>=\\ 600"
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:75
msgid ""
"The B<setenv>()  function adds the variable I<name> to the environment with "
"the value I<value>, if I<name> does not already exist.  If I<name> does "
"exist in the environment, then its value is changed to I<value> if "
"I<overwrite> is nonzero; if I<overwrite> is zero, then the value of I<name> "
"is not changed.  This function makes copies of the strings pointed to by "
"I<name> and I<value> (by contrast with B<putenv>(3))."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:84
msgid ""
"The B<unsetenv>()  function deletes the variable I<name> from the "
"environment.  If I<name> does not exist in the environment, then the "
"function succeeds, and the environment is unchanged."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:91
msgid ""
"The B<setenv>()  function returns zero on success, or -1 on error, with "
"I<errno> set to indicate the cause of the error."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:98
msgid ""
"The B<unsetenv>()  function returns zero on success, or -1 on error, with "
"I<errno> set to indicate the cause of the error."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:104
msgid ""
"I<name> is NULL, points to a string of length 0, or contains an \\(aq=\\(aq "
"character."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:107
msgid "Insufficient memory to add a new variable to the environment."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:115
msgid ""
"POSIX.1-2001 does not require B<setenv>()  or B<unsetenv>()  to be "
"reentrant."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:121
msgid ""
"Prior to glibc 2.2.2, B<unsetenv>()  was prototyped as returning I<void>; "
"more recent glibc versions follow the POSIX.1-2001-compliant prototype shown "
"in the SYNOPSIS."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:130
msgid ""
"POSIX.1-2001 specifies that if I<name> contains an \\(aq=\\(aq character, "
"then B<setenv>()  should fail with the error B<EINVAL>; however, versions of "
"glibc before 2.3.4 allowed an \\(aq=\\(aq sign in I<name>."
msgstr ""

#. type: Plain text
#: build/C/man3/setenv.3:135
msgid "B<clearenv>(3), B<getenv>(3), B<putenv>(3), B<environ>(7)"
msgstr ""

#. type: TH
#: build/C/man3/strtod.3:43
#, no-wrap
msgid "STRTOD"
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:46
msgid "strtod, strtof, strtold - convert ASCII string to floating-point number"
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:50
msgid "B<double strtod(const char *>I<nptr>B<, char **>I<endptr>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:52
msgid "B<float strtof(const char *>I<nptr>B<, char **>I<endptr>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:54
msgid "B<long double strtold(const char *>I<nptr>B<, char **>I<endptr>B<);>"
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:63
msgid "B<strtof>(), B<strtold>():"
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:85
msgid ""
"The B<strtod>(), B<strtof>(), and B<strtold>()  functions convert the "
"initial portion of the string pointed to by I<nptr> to I<double>, I<float>, "
"and I<long double> representation, respectively."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:92
msgid ""
"The expected form of the (initial portion of the) string is optional leading "
"white space as recognized by B<isspace>(3), an optional plus (\\(aq+\\(aq) "
"or minus sign (\\(aq-\\(aq) and then either (i) a decimal number, or (ii) a "
"hexadecimal number, or (iii) an infinity, or (iv) a NAN (not-a-number)."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:101
msgid ""
"A I<decimal number> consists of a nonempty sequence of decimal digits "
"possibly containing a radix character (decimal point, locale-dependent, "
"usually \\(aq.\\(aq), optionally followed by a decimal exponent.  A decimal "
"exponent consists of an \\(aqE\\(aq or \\(aqe\\(aq, followed by an optional "
"plus or minus sign, followed by a nonempty sequence of decimal digits, and "
"indicates multiplication by a power of 10."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:112
msgid ""
"A I<hexadecimal number> consists of a \"0x\" or \"0X\" followed by a "
"nonempty sequence of hexadecimal digits possibly containing a radix "
"character, optionally followed by a binary exponent.  A binary exponent "
"consists of a \\(aqP\\(aq or \\(aqp\\(aq, followed by an optional plus or "
"minus sign, followed by a nonempty sequence of decimal digits, and indicates "
"multiplication by a power of 2.  At least one of radix character and binary "
"exponent must be present."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:116
msgid "An I<infinity> is either \"INF\" or \"INFINITY\", disregarding case."
msgstr ""

#.  From glibc 2.8's stdlib/strtod_l.c:
#.      We expect it to be a number which is put in the
#.      mantissa of the number.
#. type: Plain text
#: build/C/man3/strtod.3:126
msgid ""
"A I<NAN> is \"NAN\" (disregarding case) optionally followed by \\(aq(\\(aq, "
"a sequence of characters, followed by \\(aq)\\(aq.  The character string "
"specifies in an implementation-dependent way the type of NAN."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:128
msgid "These functions return the converted value, if any."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:135
msgid ""
"If I<endptr> is not NULL, a pointer to the character after the last "
"character used in the conversion is stored in the location referenced by "
"I<endptr>."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:140
msgid ""
"If no conversion is performed, zero is returned and the value of I<nptr> is "
"stored in the location referenced by I<endptr>."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:154
msgid ""
"If the correct value would cause overflow, plus or minus B<HUGE_VAL> "
"(B<HUGE_VALF>, B<HUGE_VALL>)  is returned (according to the sign of the "
"value), and B<ERANGE> is stored in I<errno>.  If the correct value would "
"cause underflow, zero is returned and B<ERANGE> is stored in I<errno>."
msgstr ""

#. type: TP
#: build/C/man3/strtod.3:155 build/C/man3/strtol.3:131 build/C/man3/strtoul.3:134
#, no-wrap
msgid "B<ERANGE>"
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:158
msgid "Overflow or underflow occurred."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:163
msgid "C89 describes B<strtod>(), C99 describes the other two functions."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:172
msgid ""
"Since 0 can legitimately be returned on both success and failure, the "
"calling program should set I<errno> to 0 before the call, and then determine "
"if an error occurred by checking whether I<errno> has a nonzero value after "
"the call."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:177 build/C/man3/strtoul.3:188
msgid ""
"See the example on the B<strtol>(3)  manual page; the use of the functions "
"described in this manual page is similar."
msgstr ""

#. type: Plain text
#: build/C/man3/strtod.3:183
msgid "B<atof>(3), B<atoi>(3), B<atol>(3), B<strtol>(3), B<strtoul>(3)"
msgstr ""

#. type: TH
#: build/C/man3/strtoimax.3:23
#, no-wrap
msgid "STRTOIMAX"
msgstr ""

#. type: TH
#: build/C/man3/strtoimax.3:23
#, no-wrap
msgid "2003-11-28"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoimax.3:26
msgid "strtoimax, strtoumax - convert string to integer"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoimax.3:29
#, no-wrap
msgid "B<#include E<lt>inttypes.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoimax.3:31
#, no-wrap
msgid ""
"B<intmax_t strtoimax(const char *>I<nptr>B<, char **>I<endptr>B<, int "
">I<base>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoimax.3:33
#, no-wrap
msgid ""
"B<uintmax_t strtoumax(const char *>I<nptr>B<, char **>I<endptr>B<, int "
">I<base>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoimax.3:44
msgid ""
"These functions are just like B<strtol>(3)  and B<strtoul>(3), except that "
"they return a value of type I<intmax_t> and I<uintmax_t>, respectively."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoimax.3:57
msgid ""
"On success, the converted value is returned.  If nothing was found to "
"convert, zero is returned.  On overflow or underflow B<INTMAX_MAX> or "
"B<INTMAX_MIN> or B<UINTMAX_MAX> is returned, and I<errno> is set to "
"B<ERANGE>."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoimax.3:65
msgid "B<imaxabs>(3), B<imaxdiv>(3), B<strtol>(3), B<strtoul>(3), B<wcstoimax>(3)"
msgstr ""

#. type: TH
#: build/C/man3/strtol.3:29
#, no-wrap
msgid "STRTOL"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:32
msgid "strtol, strtoll, strtoq - convert a string to a long integer"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:37
#, no-wrap
msgid ""
"B<long int strtol(const char *>I<nptr>B<, char **>I<endptr>B<, int "
">I<base>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:40
#, no-wrap
msgid ""
"B<long long int strtoll(const char *>I<nptr>B<, char **>I<endptr>B<, int "
">I<base>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:49
msgid "B<strtoll>():"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:52 build/C/man3/strtoul.3:55
msgid ""
"XOPEN_SOURCE\\ E<gt>=\\ 600 || _BSD_SOURCE || _SVID_SOURCE || _ISOC99_SOURCE "
"|| _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:63
msgid ""
"The B<strtol>()  function converts the initial part of the string in I<nptr> "
"to a long integer value according to the given I<base>, which must be "
"between 2 and 36 inclusive, or be the special value 0."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:72 build/C/man3/strtoul.3:79
msgid ""
"The string may begin with an arbitrary amount of white space (as determined "
"by B<isspace>(3))  followed by a single optional \\(aq+\\(aq or \\(aq-\\(aq "
"sign.  If I<base> is zero or 16, the string may then include a \"0x\" "
"prefix, and the number will be read in base 16; otherwise, a zero I<base> is "
"taken as 10 (decimal) unless the next character is \\(aq0\\(aq, in which "
"case it is taken as 8 (octal)."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:81
msgid ""
"The remainder of the string is converted to a I<long int> value in the "
"obvious manner, stopping at the first character which is not a valid digit "
"in the given base.  (In bases above 10, the letter \\(aqA\\(aq in either "
"upper or lower case represents 10, \\(aqB\\(aq represents 11, and so forth, "
"with \\(aqZ\\(aq representing 35.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:93
msgid ""
"If I<endptr> is not NULL, B<strtol>()  stores the address of the first "
"invalid character in I<*endptr>.  If there were no digits at all, "
"B<strtol>()  stores the original value of I<nptr> in I<*endptr> (and returns "
"0).  In particular, if I<*nptr> is not \\(aq\\e0\\(aq but I<**endptr> is "
"\\(aq\\e0\\(aq on return, the entire string is valid."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:99
msgid ""
"The B<strtoll>()  function works just like the B<strtol>()  function but "
"returns a long long integer value."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:124
msgid ""
"The B<strtol>()  function returns the result of the conversion, unless the "
"value would underflow or overflow.  If an underflow occurs, B<strtol>()  "
"returns B<LONG_MIN>.  If an overflow occurs, B<strtol>()  returns "
"B<LONG_MAX>.  In both cases, I<errno> is set to B<ERANGE>.  Precisely the "
"same holds for B<strtoll>()  (with B<LLONG_MIN> and B<LLONG_MAX> instead of "
"B<LONG_MIN> and B<LONG_MAX>)."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:131 build/C/man3/strtoul.3:134
msgid "(not in C99)  The given I<base> contains an unsupported value."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:134 build/C/man3/strtoul.3:137
msgid "The resulting value was out of range."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:137 build/C/man3/strtoul.3:140
msgid ""
"The implementation may also set I<errno> to B<EINVAL> in case no conversion "
"was performed (no digits seen, and 0 returned)."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:142
msgid ""
"B<strtol>()  conforms to SVr4, 4.3BSD, C89, C99 and POSIX.1-2001, and "
"B<strtoll>()  to C99 and POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:160
msgid ""
"Since B<strtol>()  can legitimately return 0, B<LONG_MAX>, or B<LONG_MIN> "
"(B<LLONG_MAX> or B<LLONG_MIN> for B<strtoll>())  on both success and "
"failure, the calling program should set I<errno> to 0 before the call, and "
"then determine if an error occurred by checking whether I<errno> has a "
"nonzero value after the call."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:164
msgid ""
"In locales other than the \"C\" locale, other strings may also be accepted.  "
"(For example, the thousands separator of the current locale may be "
"supported.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:166 build/C/man3/strtoul.3:165
msgid "BSD also has"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:170
#, no-wrap
msgid ""
"B<quad_t strtoq(const char *>I<nptr>B<, char **>I<endptr>B<, int "
">I<base>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:179
msgid ""
"with completely analogous definition.  Depending on the wordsize of the "
"current architecture, this may be equivalent to B<strtoll>()  or to "
"B<strtol>()."
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:193
msgid ""
"The program shown below demonstrates the use of B<strtol>().  The first "
"command-line argument specifies a string from which B<strtol>()  should "
"parse a number.  The second (optional) argument specifies the base to be "
"used for the conversion.  (This argument is converted to numeric form using "
"B<atoi>(3), a function that performs no error checking and has a simpler "
"interface than B<strtol>().)  Some examples of the results produced by this "
"program are the following:"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:209
#, no-wrap
msgid ""
"$B< ./a.out 123>\n"
"strtol() returned 123\n"
"$B< ./a.out \\(aq    123\\(aq>\n"
"strtol() returned 123\n"
"$B< ./a.out 123abc>\n"
"strtol() returned 123\n"
"Further characters after number: abc\n"
"$B< ./a.out 123abc 55>\n"
"strtol: Invalid argument\n"
"$B< ./a.out \\(aq\\(aq>\n"
"No digits were found\n"
"$B< ./a.out 4000000000>\n"
"strtol: Numerical result out of range\n"
msgstr ""

#. type: SS
#: build/C/man3/strtol.3:211
#, no-wrap
msgid "Program source"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:218
#, no-wrap
msgid ""
"#include E<lt>stdlib.hE<gt>\n"
"#include E<lt>limits.hE<gt>\n"
"#include E<lt>stdio.hE<gt>\n"
"#include E<lt>errno.hE<gt>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:225
#, no-wrap
msgid ""
"int\n"
"main(int argc, char *argv[])\n"
"{\n"
"    int base;\n"
"    char *endptr, *str;\n"
"    long val;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:230
#, no-wrap
msgid ""
"    if (argc E<lt> 2) {\n"
"        fprintf(stderr, \"Usage: %s str [base]\\en\", argv[0]);\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:233
#, no-wrap
msgid ""
"    str = argv[1];\n"
"    base = (argc E<gt> 2) ? atoi(argv[2]) : 10;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:236
#, no-wrap
msgid ""
"    errno = 0;    /* To distinguish success/failure after call */\n"
"    val = strtol(str, &endptr, base);\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:238
#, no-wrap
msgid "    /* Check for various possible errors */\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:244
#, no-wrap
msgid ""
"    if ((errno == ERANGE && (val == LONG_MAX || val == LONG_MIN))\n"
"            || (errno != 0 && val == 0)) {\n"
"        perror(\"strtol\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:249
#, no-wrap
msgid ""
"    if (endptr == str) {\n"
"        fprintf(stderr, \"No digits were found\\en\");\n"
"        exit(EXIT_FAILURE);\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:251
#, no-wrap
msgid "    /* If we got here, strtol() successfully parsed a number */\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:253
#, no-wrap
msgid "    printf(\"strtol() returned %ld\\en\", val);\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:256
#, no-wrap
msgid ""
"    if (*endptr != \\(aq\\e0\\(aq)        /* Not necessarily an "
"error... */\n"
"        printf(\"Further characters after number: %s\\en\", endptr);\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtol.3:266
msgid "B<atof>(3), B<atoi>(3), B<atol>(3), B<strtod>(3), B<strtoul>(3)"
msgstr ""

#. type: TH
#: build/C/man3/strtoul.3:31
#, no-wrap
msgid "STRTOUL"
msgstr ""

#. type: TH
#: build/C/man3/strtoul.3:31
#, no-wrap
msgid "2011-09-15"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:34
msgid "strtoul, strtoull, strtouq - convert a string to an unsigned long integer"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:40
#, no-wrap
msgid ""
"B<unsigned long int strtoul(const char *>I<nptr>B<, char **>I<endptr>B<, int "
">I<base>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:43
#, no-wrap
msgid ""
"B<unsigned long long int strtoull(const char *>I<nptr>B<, char "
"**>I<endptr>B<,>\n"
"B<                                int >I<base>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:52
msgid "B<strtoull>():"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:69
msgid ""
"The B<strtoul>()  function converts the initial part of the string in "
"I<nptr> to an I<unsigned long int> value according to the given I<base>, "
"which must be between 2 and 36 inclusive, or be the special value 0."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:88
msgid ""
"The remainder of the string is converted to an I<unsigned long int> value in "
"the obvious manner, stopping at the first character which is not a valid "
"digit in the given base.  (In bases above 10, the letter \\(aqA\\(aq in "
"either upper or lower case represents 10, \\(aqB\\(aq represents 11, and so "
"forth, with \\(aqZ\\(aq representing 35.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:100
msgid ""
"If I<endptr> is not NULL, B<strtoul>()  stores the address of the first "
"invalid character in I<*endptr>.  If there were no digits at all, "
"B<strtoul>()  stores the original value of I<nptr> in I<*endptr> (and "
"returns 0).  In particular, if I<*nptr> is not \\(aq\\e0\\(aq but "
"I<**endptr> is \\(aq\\e0\\(aq on return, the entire string is valid."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:108
msgid ""
"The B<strtoull>()  function works just like the B<strtoul>()  function but "
"returns an I<unsigned long long int> value."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:127
msgid ""
"The B<strtoul>()  function returns either the result of the conversion or, "
"if there was a leading minus sign, the negation of the result of the "
"conversion represented as an unsigned value, unless the original "
"(nonnegated) value would overflow; in the latter case, B<strtoul>()  returns "
"B<ULONG_MAX> and sets I<errno> to B<ERANGE>.  Precisely the same holds for "
"B<strtoull>()  (with B<ULLONG_MAX> instead of B<ULONG_MAX>)."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:145
msgid ""
"B<strtoul>()  conforms to SVr4, C89, C99 and POSIX-2001, and B<strtoull>()  "
"to C99 and POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:159
msgid ""
"Since B<strtoul>()  can legitimately return 0 or B<ULONG_MAX> (B<ULLONG_MAX> "
"for B<strtoull>())  on both success and failure, the calling program should "
"set I<errno> to 0 before the call, and then determine if an error occurred "
"by checking whether I<errno> has a nonzero value after the call."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:163
msgid ""
"In locales other than the \"C\" locale, other strings may be accepted.  (For "
"example, the thousands separator of the current locale may be supported.)"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:169
#, no-wrap
msgid ""
"B<u_quad_t strtouq(const char *>I<nptr>B<, char **>I<endptr>B<, int "
">I<base>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:178
msgid ""
"with completely analogous definition.  Depending on the wordsize of the "
"current architecture, this may be equivalent to B<strtoull>()  or to "
"B<strtoul>()."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:183
msgid ""
"Negative values are considered valid input and are silently converted to the "
"equivalent I<unsigned long int> value."
msgstr ""

#. type: Plain text
#: build/C/man3/strtoul.3:194
msgid "B<atof>(3), B<atoi>(3), B<atol>(3), B<strtod>(3), B<strtol>(3)"
msgstr ""

#. type: TH
#: build/C/man3/system.3:28
#, no-wrap
msgid "SYSTEM"
msgstr ""

#. type: TH
#: build/C/man3/system.3:28
#, no-wrap
msgid "2010-09-10"
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:31
msgid "system - execute a shell command"
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:36
#, no-wrap
msgid "B<int system(const char *>I<command>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:52
msgid ""
"B<system>()  executes a command specified in I<command> by calling B</bin/sh "
"-c> I<command>, and returns after the command has been completed.  During "
"execution of the command, B<SIGCHLD> will be blocked, and B<SIGINT> and "
"B<SIGQUIT> will be ignored."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:67
msgid ""
"The value returned is -1 on error (e.g.  B<fork>(2)  failed), and the return "
"status of the command otherwise.  This latter return status is in the format "
"specified in B<wait>(2).  Thus, the exit code of the command will be "
"I<WEXITSTATUS(status)>.  In case I</bin/sh> could not be executed, the exit "
"status will be that of a command that does I<exit(127)>."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:73
msgid ""
"If the value of I<command> is NULL, B<system>()  returns nonzero if the "
"shell is available, and zero if not."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:76
msgid "B<system>()  does not affect the wait status of any other children."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:78
msgid "C89, C99, POSIX.1-2001."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:91
msgid ""
"If the B<_XOPEN_SOURCE> feature test macro is defined (before including "
"I<any> header files), then the macros described in B<wait>(2)  "
"(B<WEXITSTATUS>(), etc.) are made available when including "
"I<E<lt>stdlib.hE<gt>>."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:102
msgid ""
"As mentioned, B<system>()  ignores B<SIGINT> and B<SIGQUIT>.  This may make "
"programs that call it from a loop uninterruptible, unless they take care "
"themselves to check the exit status of the child.  E.g."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:107
#, no-wrap
msgid ""
"    while (something) {\n"
"        int ret = system(\"foo\");\n"
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:112
#, no-wrap
msgid ""
"        if (WIFSIGNALED(ret) &&\n"
"            (WTERMSIG(ret) == SIGINT || WTERMSIG(ret) == SIGQUIT))\n"
"                break;\n"
"    }\n"
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:132
msgid ""
"Do not use B<system>()  from a program with set-user-ID or set-group-ID "
"privileges, because strange values for some environment variables might be "
"used to subvert system integrity.  Use the B<exec>(3)  family of functions "
"instead, but not B<execlp>(3)  or B<execvp>(3).  B<system>()  will not, in "
"fact, work properly from programs with set-user-ID or set-group-ID "
"privileges on systems on which I</bin/sh> is bash version 2, since bash 2 "
"drops privileges on startup.  (Debian uses a modified bash which does not do "
"this when invoked as B<sh>.)"
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:146
msgid ""
"In versions of glibc before 2.1.3, the check for the availability of "
"I</bin/sh> was not actually performed if I<command> was NULL; instead it was "
"always assumed to be available, and B<system>()  always returned 1 in this "
"case.  Since glibc 2.1.3, this check is performed because, even though "
"POSIX.1-2001 requires a conforming implementation to provide a shell, that "
"shell may not be available or executable if the calling program has "
"previously called B<chroot>(2)  (which is not specified by POSIX.1-2001)."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:151
msgid ""
"It is possible for the shell command to return 127, so that code is not a "
"sure indication that the B<execve>(2)  call failed."
msgstr ""

#. type: Plain text
#: build/C/man3/system.3:156
msgid "B<sh>(1), B<signal>(2), B<wait>(2), B<exec>(3)"
msgstr ""

#. type: TH
#: build/C/man3/wcstombs.3:14
#, no-wrap
msgid "WCSTOMBS"
msgstr ""

#. type: TH
#: build/C/man3/wcstombs.3:14
#, no-wrap
msgid "2011-10-16"
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:17
msgid "wcstombs - convert a wide-character string to a multibyte string"
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:22
#, no-wrap
msgid ""
"B<size_t wcstombs(char *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
">I<n>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:33
msgid ""
"If I<dest> is not a NULL pointer, the B<wcstombs>()  function converts the "
"wide-character string I<src> to a multibyte string starting at I<dest>.  At "
"most I<n> bytes are written to I<dest>.  The conversion starts in the "
"initial state.  The conversion can stop for three reasons:"
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:39
msgid ""
"1. A wide character has been encountered that can not be represented as a "
"multibyte sequence (according to the current locale).  In this case "
"I<(size_t)\\ -1> is returned."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:43
msgid ""
"2. The length limit forces a stop.  In this case the number of bytes written "
"to I<dest> is returned, but the shift state at this point is lost."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:49
msgid ""
"3. The wide-character string has been completely converted, including the "
"terminating null wide character (L\\(aq\\e0\\(aq).  In this case the "
"conversion ends in the initial state.  The number of bytes written to "
"I<dest>, excluding the terminating null byte (\\(aq\\e0\\(aq), is returned."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:52
msgid ""
"The programmer must ensure that there is room for at least I<n> bytes at "
"I<dest>."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:56
msgid ""
"If I<dest> is NULL, I<n> is ignored, and the conversion proceeds as above, "
"except that the converted bytes are not written out to memory, and that no "
"length limit exists."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:59
msgid ""
"In order to avoid the case 2 above, the programmer should make sure I<n> is "
"greater or equal to I<wcstombs(NULL,src,0)+1>."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:68
msgid ""
"The B<wcstombs>()  function returns the number of bytes that make up the "
"converted part of multibyte sequence, not including the terminating null "
"byte.  If a wide character was encountered which could not be converted, "
"I<(size_t)\\ -1> is returned."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:77
msgid ""
"The behavior of B<wcstombs>()  depends on the B<LC_CTYPE> category of the "
"current locale."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:82
msgid ""
"The function B<wcsrtombs>(3)  provides a thread safe interface to the same "
"functionality."
msgstr ""

#. type: Plain text
#: build/C/man3/wcstombs.3:85
msgid "B<mbstowcs>(3), B<wcsrtombs>(3)"
msgstr ""

#. type: TH
#: build/C/man3/wctomb.3:14
#, no-wrap
msgid "WCTOMB"
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:17
msgid "wctomb - convert a wide character to a multibyte sequence"
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:22
#, no-wrap
msgid "B<int wctomb(char *>I<s>B<, wchar_t >I<wc>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:36
msgid ""
"If I<s> is not NULL, the B<wctomb>()  function converts the wide character "
"I<wc> to its multibyte representation and stores it at the beginning of the "
"character array pointed to by I<s>.  It updates the shift state, which is "
"stored in a static anonymous variable only known to the wctomb function, and "
"returns the length of said multibyte representation, that is, the number of "
"bytes written at I<s>."
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:40
msgid ""
"The programmer must ensure that there is room for at least B<MB_CUR_MAX> "
"bytes at I<s>."
msgstr ""

#.  The Dinkumware doc and the Single UNIX specification say this, but
#.  glibc doesn't implement this.
#. type: Plain text
#: build/C/man3/wctomb.3:50
msgid ""
"If I<s> is NULL, the B<wctomb>()  function resets the shift state, only "
"known to this function, to the initial state, and returns nonzero if the "
"encoding has nontrivial shift state, or zero if the encoding is stateless."
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:59
msgid ""
"If I<s> is not NULL, the B<wctomb>()  function returns the number of bytes "
"that have been written to the byte array at I<s>.  If I<wc> can not be "
"represented as a multibyte sequence (according to the current locale), -1 is "
"returned."
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:64
msgid ""
"If I<s> is NULL, the B<wctomb>()  function returns nonzero if the encoding "
"has nontrivial shift state, or zero if the encoding is stateless."
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:73
msgid ""
"The behavior of B<wctomb>()  depends on the B<LC_CTYPE> category of the "
"current locale."
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:79
msgid ""
"This function is not multithread safe.  The function B<wcrtomb>(3)  provides "
"a better interface to the same functionality."
msgstr ""

#. type: Plain text
#: build/C/man3/wctomb.3:83
msgid "B<MB_CUR_MAX>(3), B<wcrtomb>(3), B<wcstombs>(3)"
msgstr ""