po4a/stdlib/po/stdlib.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2013-08-15 19:32+0900\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: build/C/man3/MB_CUR_MAX.3:17
  21 #, no-wrap
  22 msgid "MB_CUR_MAX"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man3/MB_CUR_MAX.3:17 build/C/man3/MB_LEN_MAX.3:17
  27 #, no-wrap
  28 msgid "1999-07-04"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man3/MB_CUR_MAX.3:17 build/C/man3/MB_LEN_MAX.3:17 build/C/man2/_exit.2:29 build/C/man3/atexit.3:33 build/C/man3/clearenv.3:26 build/C/man3/exit.3:29 build/C/man3/getloadavg.3:34 build/C/man3/strtod.3:45
  33 #, no-wrap
  34 msgid "Linux"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man3/MB_CUR_MAX.3:17 build/C/man3/MB_LEN_MAX.3:17 build/C/man2/_exit.2:29 build/C/man3/a64l.3:9 build/C/man3/atexit.3:33 build/C/man3/atof.3:31 build/C/man3/atoi.3:33 build/C/man3/canonicalize_file_name.3:26 build/C/man3/cfree.3:24 build/C/man3/clearenv.3:26 build/C/man3/drand48.3:30 build/C/man3/drand48_r.3:27 build/C/man3/ecvt.3:32 build/C/man3/ecvt_r.3:30 build/C/man3/exit.3:29 build/C/man3/gcvt.3:30 build/C/man3/getauxval.3:27 build/C/man3/getenv.3:33 build/C/man3/getloadavg.3:34 build/C/man3/getsubopt.3:25 build/C/man3/malloc.3:30 build/C/man3/mblen.3:16 build/C/man3/mbstowcs.3:16 build/C/man3/mbtowc.3:16 build/C/man3/mkdtemp.3:26 build/C/man3/mkstemp.3:35 build/C/man3/mktemp.3:34 build/C/man3/on_exit.3:31 build/C/man3/putenv.3:36 build/C/man3/qecvt.3:28 build/C/man3/rand.3:41 build/C/man3/random.3:33 build/C/man3/random_r.3:26 build/C/man3/rpmatch.3:29 build/C/man3/setenv.3:37 build/C/man3/strtod.3:45 build/C/man3/strtoimax.3:24 build/C/man3/strtol.3:31 build/C/man3/strtoul.3:33 build/C/man3/system.3:30 build/C/man3/wcstombs.3:16 build/C/man3/wctomb.3:16
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man3/MB_CUR_MAX.3:18 build/C/man3/MB_LEN_MAX.3:18 build/C/man2/_exit.2:30 build/C/man3/a64l.3:10 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:27 build/C/man3/cfree.3:25 build/C/man3/clearenv.3:27 build/C/man3/drand48.3:31 build/C/man3/drand48_r.3:28 build/C/man3/ecvt.3:33 build/C/man3/ecvt_r.3:31 build/C/man3/exit.3:30 build/C/man3/gcvt.3:31 build/C/man3/getauxval.3:28 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:27 build/C/man3/rpmatch.3:30 build/C/man3/setenv.3:38 build/C/man3/strtod.3:46 build/C/man3/strtoimax.3:25 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
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man3/MB_CUR_MAX.3:20
  51 msgid "MB_CUR_MAX - maximum length of a multibyte character in the current locale"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man3/MB_CUR_MAX.3:20 build/C/man3/MB_LEN_MAX.3:20 build/C/man2/_exit.2:32 build/C/man3/a64l.3:12 build/C/man3/atexit.3:36 build/C/man3/atof.3:34 build/C/man3/atoi.3:36 build/C/man3/canonicalize_file_name.3:29 build/C/man3/cfree.3:27 build/C/man3/clearenv.3:29 build/C/man3/drand48.3:34 build/C/man3/drand48_r.3:32 build/C/man3/ecvt.3:35 build/C/man3/ecvt_r.3:33 build/C/man3/exit.3:32 build/C/man3/gcvt.3:33 build/C/man3/getauxval.3:30 build/C/man3/getenv.3:36 build/C/man3/getloadavg.3:37 build/C/man3/getsubopt.3:28 build/C/man3/malloc.3:33 build/C/man3/mblen.3:19 build/C/man3/mbstowcs.3:19 build/C/man3/mbtowc.3:19 build/C/man3/mkdtemp.3:29 build/C/man3/mkstemp.3:38 build/C/man3/mktemp.3:37 build/C/man3/on_exit.3:34 build/C/man3/putenv.3:39 build/C/man3/qecvt.3:31 build/C/man3/rand.3:44 build/C/man3/random.3:36 build/C/man3/random_r.3:30 build/C/man3/rpmatch.3:32 build/C/man3/setenv.3:40 build/C/man3/strtod.3:48 build/C/man3/strtoimax.3:27 build/C/man3/strtol.3:34 build/C/man3/strtoul.3:36 build/C/man3/system.3:33 build/C/man3/wcstombs.3:19 build/C/man3/wctomb.3:19
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man3/MB_CUR_MAX.3:23 build/C/man3/atexit.3:39 build/C/man3/atof.3:37 build/C/man3/atoi.3:39 build/C/man3/cfree.3:31 build/C/man3/clearenv.3:32 build/C/man3/drand48.3:37 build/C/man3/drand48_r.3:35 build/C/man3/ecvt_r.3:36 build/C/man3/exit.3:35 build/C/man3/gcvt.3:36 build/C/man3/getenv.3:39 build/C/man3/malloc.3:36 build/C/man3/mblen.3:22 build/C/man3/mbstowcs.3:22 build/C/man3/mbtowc.3:22 build/C/man3/mkdtemp.3:32 build/C/man3/mkstemp.3:41 build/C/man3/mktemp.3:40 build/C/man3/on_exit.3:37 build/C/man3/putenv.3:42 build/C/man3/rand.3:47 build/C/man3/random.3:39 build/C/man3/random_r.3:33 build/C/man3/rpmatch.3:35 build/C/man3/setenv.3:43 build/C/man3/strtol.3:37 build/C/man3/strtoul.3:39 build/C/man3/system.3:36 build/C/man3/wcstombs.3:22 build/C/man3/wctomb.3:22
  62 #, no-wrap
  63 msgid "B<#include E<lt>stdlib.hE<gt>>\n"
  64 msgstr ""
  65
  66 #. type: SH
  67 #: build/C/man3/MB_CUR_MAX.3:24 build/C/man3/MB_LEN_MAX.3:24 build/C/man2/_exit.2:56 build/C/man3/a64l.3:33 build/C/man3/atexit.3:42 build/C/man3/atof.3:40 build/C/man3/atoi.3:64 build/C/man3/canonicalize_file_name.3:35 build/C/man3/cfree.3:52 build/C/man3/clearenv.3:43 build/C/man3/drand48.3:75 build/C/man3/drand48_r.3:83 build/C/man3/ecvt.3:69 build/C/man3/ecvt_r.3:64 build/C/man3/exit.3:38 build/C/man3/gcvt.3:64 build/C/man3/getauxval.3:36 build/C/man3/getenv.3:52 build/C/man3/getloadavg.3:44 build/C/man3/getsubopt.3:50 build/C/man3/malloc.3:42 build/C/man3/mblen.3:25 build/C/man3/mbstowcs.3:25 build/C/man3/mbtowc.3:25 build/C/man3/mkdtemp.3:55 build/C/man3/mkstemp.3:76 build/C/man3/mktemp.3:66 build/C/man3/on_exit.3:48 build/C/man3/putenv.3:54 build/C/man3/qecvt.3:53 build/C/man3/rand.3:62 build/C/man3/random.3:64 build/C/man3/random_r.3:58 build/C/man3/rpmatch.3:46 build/C/man3/setenv.3:61 build/C/man3/strtod.3:73 build/C/man3/strtoimax.3:35 build/C/man3/strtol.3:59 build/C/man3/strtoul.3:62 build/C/man3/system.3:39 build/C/man3/wcstombs.3:25 build/C/man3/wctomb.3:25
  68 #, no-wrap
  69 msgid "DESCRIPTION"
  70 msgstr ""
  71
  72 #. type: Plain text
  73 #: build/C/man3/MB_CUR_MAX.3:31
  74 msgid ""
  75 "The B<MB_CUR_MAX> macro defines an integer expression giving the maximum "
  76 "number of bytes needed to represent a single wide character in the current "
  77 "locale.  It is locale dependent and therefore not a compile-time constant."
  78 msgstr ""
  79
  80 #. type: SH
  81 #: build/C/man3/MB_CUR_MAX.3:31 build/C/man3/MB_LEN_MAX.3:29 build/C/man2/_exit.2:79 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:61 build/C/man3/cfree.3:96 build/C/man3/clearenv.3:50 build/C/man3/drand48_r.3:96 build/C/man3/ecvt.3:99 build/C/man3/ecvt_r.3:86 build/C/man3/exit.3:86 build/C/man3/gcvt.3:72 build/C/man3/getauxval.3:171 build/C/man3/getenv.3:88 build/C/man3/getloadavg.3:55 build/C/man3/getsubopt.3:110 build/C/man3/malloc.3:129 build/C/man3/mblen.3:75 build/C/man3/mbstowcs.3:83 build/C/man3/mbtowc.3:94 build/C/man3/mkdtemp.3:68 build/C/man3/mkstemp.3:136 build/C/man3/mktemp.3:77 build/C/man3/on_exit.3:76 build/C/man3/putenv.3:67 build/C/man3/rand.3:118 build/C/man3/random.3:118 build/C/man3/random_r.3:100 build/C/man3/rpmatch.3:73 build/C/man3/setenv.3:104 build/C/man3/strtod.3:128 build/C/man3/strtoimax.3:45 build/C/man3/strtol.3:117 build/C/man3/strtoul.3:127 build/C/man3/system.3:54 build/C/man3/wcstombs.3:79 build/C/man3/wctomb.3:63
  82 #, no-wrap
  83 msgid "RETURN VALUE"
  84 msgstr ""
  85
  86 #. type: Plain text
  87 #: build/C/man3/MB_CUR_MAX.3:35
  88 msgid ""
  89 "An integer in the range [1, B<MB_LEN_MAX>].  The value 1 denotes traditional "
  90 "8-bit encoded characters."
  91 msgstr ""
  92
  93 #. type: SH
  94 #: build/C/man3/MB_CUR_MAX.3:35 build/C/man3/MB_LEN_MAX.3:31 build/C/man2/_exit.2:81 build/C/man3/a64l.3:71 build/C/man3/atexit.3:76 build/C/man3/atof.3:57 build/C/man3/atoi.3:93 build/C/man3/canonicalize_file_name.3:73 build/C/man3/cfree.3:112 build/C/man3/clearenv.3:60 build/C/man3/drand48.3:260 build/C/man3/drand48_r.3:98 build/C/man3/ecvt.3:117 build/C/man3/ecvt_r.3:88 build/C/man3/exit.3:90 build/C/man3/gcvt.3:77 build/C/man3/getauxval.3:185 build/C/man3/getenv.3:96 build/C/man3/getloadavg.3:65 build/C/man3/getsubopt.3:129 build/C/man3/malloc.3:168 build/C/man3/mblen.3:92 build/C/man3/mbstowcs.3:93 build/C/man3/mbtowc.3:114 build/C/man3/mkdtemp.3:86 build/C/man3/mkstemp.3:176 build/C/man3/mktemp.3:92 build/C/man3/on_exit.3:81 build/C/man3/putenv.3:79 build/C/man3/qecvt.3:83 build/C/man3/rand.3:129 build/C/man3/random.3:152 build/C/man3/random_r.3:128 build/C/man3/rpmatch.3:99 build/C/man3/setenv.3:127 build/C/man3/strtod.3:160 build/C/man3/strtoimax.3:58 build/C/man3/strtol.3:161 build/C/man3/strtoul.3:165 build/C/man3/system.3:78 build/C/man3/wcstombs.3:88 build/C/man3/wctomb.3:84
  95 #, no-wrap
  96 msgid "CONFORMING TO"
  97 msgstr ""
  98
  99 #. type: Plain text
 100 #: build/C/man3/MB_CUR_MAX.3:37 build/C/man3/MB_LEN_MAX.3:33 build/C/man3/strtoimax.3:60
 101 msgid "C99, POSIX.1-2001."
 102 msgstr ""
 103
 104 #. type: SH
 105 #: build/C/man3/MB_CUR_MAX.3:37 build/C/man3/MB_LEN_MAX.3:44 build/C/man2/_exit.2:124 build/C/man3/a64l.3:93 build/C/man3/atexit.3:161 build/C/man3/atof.3:59 build/C/man3/atoi.3:113 build/C/man3/canonicalize_file_name.3:75 build/C/man3/cfree.3:117 build/C/man3/clearenv.3:97 build/C/man3/drand48.3:266 build/C/man3/drand48_r.3:100 build/C/man3/ecvt.3:135 build/C/man3/ecvt_r.3:95 build/C/man3/exit.3:177 build/C/man3/gcvt.3:86 build/C/man3/getauxval.3:211 build/C/man3/getenv.3:129 build/C/man3/getloadavg.3:69 build/C/man3/getsubopt.3:226 build/C/man3/malloc.3:259 build/C/man3/mblen.3:106 build/C/man3/mbstowcs.3:107 build/C/man3/mbtowc.3:129 build/C/man3/mkdtemp.3:91 build/C/man3/mkstemp.3:214 build/C/man3/mktemp.3:115 build/C/man3/on_exit.3:88 build/C/man3/putenv.3:119 build/C/man3/qecvt.3:94 build/C/man3/rand.3:217 build/C/man3/random.3:188 build/C/man3/random_r.3:132 build/C/man3/rpmatch.3:144 build/C/man3/setenv.3:152 build/C/man3/strtod.3:179 build/C/man3/strtoimax.3:60 build/C/man3/strtol.3:285 build/C/man3/strtoul.3:213 build/C/man3/system.3:153 build/C/man3/wcstombs.3:102 build/C/man3/wctomb.3:99
 106 #, no-wrap
 107 msgid "SEE ALSO"
 108 msgstr ""
 109
 110 #. type: Plain text
 111 #: build/C/man3/MB_CUR_MAX.3:44
 112 msgid ""
 113 "B<MB_LEN_MAX>(3), B<mblen>(3), B<mbstowcs>(3), B<mbtowc>(3), B<wcstombs>(3), "
 114 "B<wctomb>(3)"
 115 msgstr ""
 116
 117 #. type: SH
 118 #: build/C/man3/MB_CUR_MAX.3:44 build/C/man3/MB_LEN_MAX.3:46 build/C/man2/_exit.2:136 build/C/man3/a64l.3:97 build/C/man3/atexit.3:165 build/C/man3/atof.3:65 build/C/man3/atoi.3:118 build/C/man3/canonicalize_file_name.3:78 build/C/man3/cfree.3:119 build/C/man3/clearenv.3:103 build/C/man3/drand48.3:269 build/C/man3/drand48_r.3:104 build/C/man3/ecvt.3:141 build/C/man3/ecvt_r.3:99 build/C/man3/exit.3:184 build/C/man3/gcvt.3:90 build/C/man3/getauxval.3:217 build/C/man3/getenv.3:137 build/C/man3/getloadavg.3:72 build/C/man3/getsubopt.3:228 build/C/man3/malloc.3:283 build/C/man3/mblen.3:108 build/C/man3/mbstowcs.3:110 build/C/man3/mbtowc.3:133 build/C/man3/mkdtemp.3:98 build/C/man3/mkstemp.3:220 build/C/man3/mktemp.3:120 build/C/man3/on_exit.3:92 build/C/man3/putenv.3:125 build/C/man3/qecvt.3:99 build/C/man3/rand.3:220 build/C/man3/random.3:193 build/C/man3/random_r.3:136 build/C/man3/rpmatch.3:150 build/C/man3/setenv.3:157 build/C/man3/strtod.3:185 build/C/man3/strtoimax.3:66 build/C/man3/strtol.3:291 build/C/man3/strtoul.3:219 build/C/man3/system.3:158 build/C/man3/wcstombs.3:105 build/C/man3/wctomb.3:103
 119 #, no-wrap
 120 msgid "COLOPHON"
 121 msgstr ""
 122
 123 #. type: Plain text
 124 #: build/C/man3/MB_CUR_MAX.3:51 build/C/man3/MB_LEN_MAX.3:53 build/C/man2/_exit.2:143 build/C/man3/a64l.3:104 build/C/man3/atexit.3:172 build/C/man3/atof.3:72 build/C/man3/atoi.3:125 build/C/man3/canonicalize_file_name.3:85 build/C/man3/cfree.3:126 build/C/man3/clearenv.3:110 build/C/man3/drand48.3:276 build/C/man3/drand48_r.3:111 build/C/man3/ecvt.3:148 build/C/man3/ecvt_r.3:106 build/C/man3/exit.3:191 build/C/man3/gcvt.3:97 build/C/man3/getauxval.3:224 build/C/man3/getenv.3:144 build/C/man3/getloadavg.3:79 build/C/man3/getsubopt.3:235 build/C/man3/malloc.3:290 build/C/man3/mblen.3:115 build/C/man3/mbstowcs.3:117 build/C/man3/mbtowc.3:140 build/C/man3/mkdtemp.3:105 build/C/man3/mkstemp.3:227 build/C/man3/mktemp.3:127 build/C/man3/on_exit.3:99 build/C/man3/putenv.3:132 build/C/man3/qecvt.3:106 build/C/man3/rand.3:227 build/C/man3/random.3:200 build/C/man3/random_r.3:143 build/C/man3/rpmatch.3:157 build/C/man3/setenv.3:164 build/C/man3/strtod.3:192 build/C/man3/strtoimax.3:73 build/C/man3/strtol.3:298 build/C/man3/strtoul.3:226 build/C/man3/system.3:165 build/C/man3/wcstombs.3:112 build/C/man3/wctomb.3:110
 125 msgid ""
 126 "This page is part of release 3.53 of the Linux I<man-pages> project.  A "
 127 "description of the project, and information about reporting bugs, can be "
 128 "found at \\%http://www.kernel.org/doc/man-pages/."
 129 msgstr ""
 130
 131 #. type: TH
 132 #: build/C/man3/MB_LEN_MAX.3:17
 133 #, no-wrap
 134 msgid "MB_LEN_MAX"
 135 msgstr ""
 136
 137 #. type: Plain text
 138 #: build/C/man3/MB_LEN_MAX.3:20
 139 msgid "MB_LEN_MAX - maximum multibyte length of a character across all locales"
 140 msgstr ""
 141
 142 #. type: Plain text
 143 #: build/C/man3/MB_LEN_MAX.3:23
 144 #, no-wrap
 145 msgid "B<#include E<lt>limits.hE<gt>>\n"
 146 msgstr ""
 147
 148 #. type: Plain text
 149 #: build/C/man3/MB_LEN_MAX.3:29
 150 msgid ""
 151 "The B<MB_LEN_MAX> macro is the upper bound for the number of bytes needed to "
 152 "represent a single wide character, across all locales."
 153 msgstr ""
 154
 155 #. type: Plain text
 156 #: build/C/man3/MB_LEN_MAX.3:31
 157 msgid "A constant integer greater than zero."
 158 msgstr ""
 159
 160 #. type: SH
 161 #: build/C/man3/MB_LEN_MAX.3:33 build/C/man2/_exit.2:86 build/C/man3/a64l.3:73 build/C/man3/atexit.3:78 build/C/man3/atoi.3:103 build/C/man3/clearenv.3:74 build/C/man3/drand48.3:262 build/C/man3/ecvt.3:129 build/C/man3/ecvt_r.3:90 build/C/man3/exit.3:92 build/C/man3/getauxval.3:187 build/C/man3/getenv.3:102 build/C/man3/getsubopt.3:131 build/C/man3/malloc.3:170 build/C/man3/mblen.3:94 build/C/man3/mbstowcs.3:95 build/C/man3/mbtowc.3:116 build/C/man3/mkstemp.3:189 build/C/man3/mktemp.3:96 build/C/man3/putenv.3:81 build/C/man3/qecvt.3:89 build/C/man3/rand.3:141 build/C/man3/random.3:154 build/C/man3/setenv.3:129 build/C/man3/strtod.3:165 build/C/man3/strtol.3:166 build/C/man3/strtoul.3:170 build/C/man3/system.3:80 build/C/man3/wcstombs.3:90 build/C/man3/wctomb.3:86
 162 #, no-wrap
 163 msgid "NOTES"
 164 msgstr ""
 165
 166 #. type: Plain text
 167 #: build/C/man3/MB_LEN_MAX.3:44
 168 msgid ""
 169 "The entities B<MB_LEN_MAX> and I<sizeof(wchar_t)> are totally unrelated.  In "
 170 "glibc, B<MB_LEN_MAX> is typically 6 while I<sizeof(wchar_t)> is 4."
 171 msgstr ""
 172
 173 #. type: Plain text
 174 #: build/C/man3/MB_LEN_MAX.3:46
 175 msgid "B<MB_CUR_MAX>(3)"
 176 msgstr ""
 177
 178 #. type: TH
 179 #: build/C/man2/_exit.2:29
 180 #, no-wrap
 181 msgid "_EXIT"
 182 msgstr ""
 183
 184 #. type: TH
 185 #: build/C/man2/_exit.2:29 build/C/man3/gcvt.3:30 build/C/man3/strtod.3:45
 186 #, no-wrap
 187 msgid "2010-09-20"
 188 msgstr ""
 189
 190 #. type: Plain text
 191 #: build/C/man2/_exit.2:32
 192 msgid "_exit, _Exit - terminate the calling process"
 193 msgstr ""
 194
 195 #. type: Plain text
 196 #: build/C/man2/_exit.2:34
 197 msgid "B<#include E<lt>unistd.hE<gt>>"
 198 msgstr ""
 199
 200 #. type: Plain text
 201 #: build/C/man2/_exit.2:36
 202 msgid "B<void _exit(int >I<status>B<);>"
 203 msgstr ""
 204
 205 #. type: Plain text
 206 #: build/C/man2/_exit.2:38 build/C/man3/a64l.3:14 build/C/man3/canonicalize_file_name.3:33 build/C/man3/ecvt.3:37 build/C/man3/getsubopt.3:30 build/C/man3/qecvt.3:33 build/C/man3/strtod.3:50
 207 msgid "B<#include E<lt>stdlib.hE<gt>>"
 208 msgstr ""
 209
 210 #. type: Plain text
 211 #: build/C/man2/_exit.2:40
 212 msgid "B<void _Exit(int >I<status>B<);>"
 213 msgstr ""
 214
 215 #. type: Plain text
 216 #: build/C/man2/_exit.2:44 build/C/man3/a64l.3:22 build/C/man3/atoi.3:52 build/C/man3/cfree.3:48 build/C/man3/clearenv.3:39 build/C/man3/drand48.3:60 build/C/man3/drand48_r.3:68 build/C/man3/ecvt.3:47 build/C/man3/ecvt_r.3:53 build/C/man3/gcvt.3:43 build/C/man3/getenv.3:48 build/C/man3/getsubopt.3:37 build/C/man3/mkdtemp.3:39 build/C/man3/mkstemp.3:54 build/C/man3/mktemp.3:47 build/C/man3/on_exit.3:44 build/C/man3/putenv.3:50 build/C/man3/qecvt.3:45 build/C/man3/rand.3:58 build/C/man3/random.3:52 build/C/man3/random_r.3:47 build/C/man3/rpmatch.3:42 build/C/man3/setenv.3:52 build/C/man3/strtod.3:60 build/C/man3/strtol.3:47 build/C/man3/strtoul.3:50
 217 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
 218 msgstr ""
 219
 220 #. type: Plain text
 221 #: build/C/man2/_exit.2:48
 222 msgid "B<_Exit>():"
 223 msgstr ""
 224
 225 #. type: Plain text
 226 #: build/C/man2/_exit.2:51 build/C/man3/strtod.3:68
 227 msgid ""
 228 "_XOPEN_SOURCE\\ E<gt>=\\ 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ "
 229 "200112L;"
 230 msgstr ""
 231
 232 #. type: Plain text
 233 #: build/C/man2/_exit.2:54 build/C/man3/atoi.3:62 build/C/man3/strtod.3:71 build/C/man3/strtol.3:57 build/C/man3/strtoul.3:60
 234 msgid "or I<cc\\ -std=c99>"
 235 msgstr ""
 236
 237 #. type: Plain text
 238 #: build/C/man2/_exit.2:67
 239 msgid ""
 240 "The function B<_exit>()  terminates the calling process \"immediately\".  "
 241 "Any open file descriptors belonging to the process are closed; any children "
 242 "of the process are inherited by process 1, I<init>, and the process's parent "
 243 "is sent a B<SIGCHLD> signal."
 244 msgstr ""
 245
 246 #. type: Plain text
 247 #: build/C/man2/_exit.2:74
 248 msgid ""
 249 "The value I<status> is returned to the parent process as the process's exit "
 250 "status, and can be collected using one of the B<wait>(2)  family of calls."
 251 msgstr ""
 252
 253 #. type: Plain text
 254 #: build/C/man2/_exit.2:79
 255 msgid "The function B<_Exit>()  is equivalent to B<_exit>()."
 256 msgstr ""
 257
 258 #. type: Plain text
 259 #: build/C/man2/_exit.2:81
 260 msgid "These functions do not return."
 261 msgstr ""
 262
 263 #. type: Plain text
 264 #: build/C/man2/_exit.2:86
 265 msgid "SVr4, POSIX.1-2001, 4.3BSD.  The function B<_Exit>()  was introduced by C99."
 266 msgstr ""
 267
 268 #. type: Plain text
 269 #: build/C/man2/_exit.2:90
 270 msgid ""
 271 "For a discussion on the effects of an exit, the transmission of exit status, "
 272 "zombie processes, signals sent, and so on, see B<exit>(3)."
 273 msgstr ""
 274
 275 #. type: Plain text
 276 #: build/C/man2/_exit.2:117
 277 msgid ""
 278 "The function B<_exit>()  is like B<exit>(3), but does not call any functions "
 279 "registered with B<atexit>(3)  or B<on_exit>(3).  Whether it flushes standard "
 280 "I/O buffers and removes temporary files created with B<tmpfile>(3)  is "
 281 "implementation-dependent.  On the other hand, B<_exit>()  does close open "
 282 "file descriptors, and this may cause an unknown delay, waiting for pending "
 283 "output to finish.  If the delay is undesired, it may be useful to call "
 284 "functions like B<tcflush>(3)  before calling B<_exit>().  Whether any "
 285 "pending I/O is canceled, and which pending I/O may be canceled upon "
 286 "B<_exit>(), is implementation-dependent."
 287 msgstr ""
 288
 289 #. type: Plain text
 290 #: build/C/man2/_exit.2:124
 291 msgid ""
 292 "In glibc up to version 2.3, the B<_exit>()  wrapper function invoked the "
 293 "kernel system call of the same name.  Since glibc 2.3, the wrapper function "
 294 "invokes B<exit_group>(2), in order to terminate all of the threads in a "
 295 "process."
 296 msgstr ""
 297
 298 #. type: Plain text
 299 #: build/C/man2/_exit.2:136
 300 msgid ""
 301 "B<execve>(2), B<exit_group>(2), B<fork>(2), B<kill>(2), B<wait>(2), "
 302 "B<wait4>(2), B<waitpid>(2), B<atexit>(3), B<exit>(3), B<on_exit>(3), "
 303 "B<termios>(3)"
 304 msgstr ""
 305
 306 #. type: TH
 307 #: build/C/man3/a64l.3:9
 308 #, no-wrap
 309 msgid "A64L"
 310 msgstr ""
 311
 312 #. type: TH
 313 #: build/C/man3/a64l.3:9 build/C/man3/drand48.3:30 build/C/man3/mblen.3:16
 314 #, no-wrap
 315 msgid "2013-06-21"
 316 msgstr ""
 317
 318 #. type: Plain text
 319 #: build/C/man3/a64l.3:12
 320 msgid "a64l, l64a - convert between long and base-64"
 321 msgstr ""
 322
 323 #. type: Plain text
 324 #: build/C/man3/a64l.3:16
 325 msgid "B<long a64l(char *>I<str64>B<);>"
 326 msgstr ""
 327
 328 #. type: Plain text
 329 #: build/C/man3/a64l.3:18
 330 msgid "B<char *l64a(long >I<value>B<);>"
 331 msgstr ""
 332
 333 #. type: Plain text
 334 #: build/C/man3/a64l.3:26
 335 msgid "B<a64l>(), B<l64a>():"
 336 msgstr ""
 337
 338 #. type: Plain text
 339 #: build/C/man3/a64l.3:31 build/C/man3/ecvt.3:66
 340 msgid ""
 341 "_SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ "
 342 "_XOPEN_SOURCE_EXTENDED"
 343 msgstr ""
 344
 345 #. type: Plain text
 346 #: build/C/man3/a64l.3:48
 347 msgid ""
 348 "These functions provide a conversion between 32-bit long integers and "
 349 "little-endian base-64 ASCII strings (of length zero to six).  If the string "
 350 "used as argument for B<a64l>()  has length greater than six, only the first "
 351 "six bytes are used.  If the type I<long> has more than 32 bits, then "
 352 "B<l64a>()  uses only the low order 32 bits of I<value>, and B<a64l>()  "
 353 "sign-extends its 32-bit result."
 354 msgstr ""
 355
 356 #. type: Plain text
 357 #: build/C/man3/a64l.3:50
 358 msgid "The 64 digits in the base-64 system are:"
 359 msgstr ""
 360
 361 #. type: Plain text
 362 #: build/C/man3/a64l.3:58
 363 #, no-wrap
 364 msgid ""
 365 "\\&\\(aq.\\(aq\trepresents a 0\n"
 366 "\\&\\(aq/\\(aq\trepresents a 1\n"
 367 "0-9\trepresent  2-11\n"
 368 "A-Z\trepresent 12-37\n"
 369 "a-z\trepresent 38-63\n"
 370 msgstr ""
 371
 372 #. type: Plain text
 373 #: build/C/man3/a64l.3:62
 374 msgid "So 123 = 59*64^0 + 1*64^1 = \"v/\"."
 375 msgstr ""
 376
 377 #. type: SH
 378 #: build/C/man3/a64l.3:62 build/C/man3/drand48.3:245 build/C/man3/ecvt.3:110 build/C/man3/mblen.3:87 build/C/man3/qecvt.3:72
 379 #, no-wrap
 380 msgid "ATTRIBUTES"
 381 msgstr ""
 382
 383 #. type: SS
 384 #: build/C/man3/a64l.3:63 build/C/man3/drand48.3:246 build/C/man3/ecvt.3:111 build/C/man3/mblen.3:88 build/C/man3/qecvt.3:73
 385 #, no-wrap
 386 msgid "Multithreading (see pthreads(7))"
 387 msgstr ""
 388
 389 #. type: Plain text
 390 #: build/C/man3/a64l.3:67
 391 msgid "The B<l64a>()  function is not thread-safe."
 392 msgstr ""
 393
 394 #. type: Plain text
 395 #: build/C/man3/a64l.3:71
 396 msgid "The B<a64l>()  function is thread-safe."
 397 msgstr ""
 398
 399 #. type: Plain text
 400 #: build/C/man3/a64l.3:73 build/C/man3/getsubopt.3:131
 401 msgid "POSIX.1-2001."
 402 msgstr ""
 403
 404 #. type: Plain text
 405 #: build/C/man3/a64l.3:78
 406 msgid ""
 407 "The value returned by B<l64a>()  may be a pointer to a static buffer, "
 408 "possibly overwritten by later calls."
 409 msgstr ""
 410
 411 #. type: Plain text
 412 #: build/C/man3/a64l.3:87
 413 msgid ""
 414 "The behavior of B<l64a>()  is undefined when I<value> is negative.  If "
 415 "I<value> is zero, it returns an empty string."
 416 msgstr ""
 417
 418 #. type: Plain text
 419 #: build/C/man3/a64l.3:90
 420 msgid ""
 421 "These functions are broken in glibc before 2.2.5 (puts most significant "
 422 "digit first)."
 423 msgstr ""
 424
 425 #. type: Plain text
 426 #: build/C/man3/a64l.3:93
 427 msgid "This is not the encoding used by B<uuencode>(1)."
 428 msgstr ""
 429
 430 #.  .BR itoa (3),
 431 #. type: Plain text
 432 #: build/C/man3/a64l.3:97
 433 msgid "B<uuencode>(1), B<strtoul>(3)"
 434 msgstr ""
 435
 436 #. type: TH
 437 #: build/C/man3/atexit.3:33
 438 #, no-wrap
 439 msgid "ATEXIT"
 440 msgstr ""
 441
 442 #. type: TH
 443 #: build/C/man3/atexit.3:33 build/C/man3/on_exit.3:31
 444 #, no-wrap
 445 msgid "2008-12-05"
 446 msgstr ""
 447
 448 #. type: Plain text
 449 #: build/C/man3/atexit.3:36
 450 msgid "atexit - register a function to be called at normal process termination"
 451 msgstr ""
 452
 453 #. type: Plain text
 454 #: build/C/man3/atexit.3:41
 455 #, no-wrap
 456 msgid "B<int atexit(void (*>I<function>B<)(void));>\n"
 457 msgstr ""
 458
 459 #. type: Plain text
 460 #: build/C/man3/atexit.3:54
 461 msgid ""
 462 "The B<atexit>()  function registers the given I<function> to be called at "
 463 "normal process termination, either via B<exit>(3)  or via return from the "
 464 "program's I<main>().  Functions so registered are called in the reverse "
 465 "order of their registration; no arguments are passed."
 466 msgstr ""
 467
 468 #. type: Plain text
 469 #: build/C/man3/atexit.3:57 build/C/man3/on_exit.3:69
 470 msgid ""
 471 "The same function may be registered multiple times: it is called once for "
 472 "each registration."
 473 msgstr ""
 474
 475 #. type: Plain text
 476 #: build/C/man3/atexit.3:63
 477 msgid ""
 478 "POSIX.1-2001 requires that an implementation allow at least B<ATEXIT_MAX> "
 479 "(32) such functions to be registered.  The actual limit supported by an "
 480 "implementation can be obtained using B<sysconf>(3)."
 481 msgstr ""
 482
 483 #. type: Plain text
 484 #: build/C/man3/atexit.3:71 build/C/man3/on_exit.3:76
 485 msgid ""
 486 "When a child process is created via B<fork>(2), it inherits copies of its "
 487 "parent's registrations.  Upon a successful call to one of the B<exec>(3)  "
 488 "functions, all registrations are removed."
 489 msgstr ""
 490
 491 #. type: Plain text
 492 #: build/C/man3/atexit.3:76
 493 msgid ""
 494 "The B<atexit>()  function returns the value 0 if successful; otherwise it "
 495 "returns a nonzero value."
 496 msgstr ""
 497
 498 #. type: Plain text
 499 #: build/C/man3/atexit.3:78
 500 msgid "SVr4, 4.3BSD, C89, C99, POSIX.1-2001."
 501 msgstr ""
 502
 503 #. type: Plain text
 504 #: build/C/man3/atexit.3:85
 505 msgid ""
 506 "Functions registered using B<atexit>()  (and B<on_exit>(3))  are not called "
 507 "if a process terminates abnormally because of the delivery of a signal."
 508 msgstr ""
 509
 510 #. type: Plain text
 511 #: build/C/man3/atexit.3:92
 512 msgid ""
 513 "If one of the functions registered functions calls B<_exit>(2), then any "
 514 "remaining functions are not invoked, and the other process termination steps "
 515 "performed by B<exit>(3)  are not performed."
 516 msgstr ""
 517
 518 #.  This can happen on OpenBSD 4.2 for example, and is documented
 519 #.  as occurring on FreeBSD as well.
 520 #.  Glibc does "the Right Thing" -- invocation of the remaining
 521 #.  exit handlers carries on as normal.
 522 #. type: Plain text
 523 #: build/C/man3/atexit.3:109
 524 msgid ""
 525 "POSIX.1-2001 says that the result of calling B<exit>(3)  more than once "
 526 "(i.e., calling B<exit>(3)  within a function registered using B<atexit>())  "
 527 "is undefined.  On some systems (but not Linux), this can result in an "
 528 "infinite recursion; portable programs should not invoke B<exit>(3)  inside a "
 529 "function registered using B<atexit>()."
 530 msgstr ""
 531
 532 #. type: Plain text
 533 #: build/C/man3/atexit.3:118
 534 msgid ""
 535 "The B<atexit>()  and B<on_exit>(3)  functions register functions on the same "
 536 "list: at normal process termination, the registered functions are invoked in "
 537 "reverse order of their registration by these two functions."
 538 msgstr ""
 539
 540 #.  In glibc, things seem to be handled okay
 541 #. type: Plain text
 542 #: build/C/man3/atexit.3:124
 543 msgid ""
 544 "POSIX.1-2001 says that the result is undefined if B<longjmp>(3)  is used to "
 545 "terminate execution of one of the functions registered B<atexit>()."
 546 msgstr ""
 547
 548 #. type: SS
 549 #: build/C/man3/atexit.3:124
 550 #, no-wrap
 551 msgid "Linux notes"
 552 msgstr ""
 553
 554 #. type: Plain text
 555 #: build/C/man3/atexit.3:131
 556 msgid ""
 557 "Since glibc 2.2.3, B<atexit>()  (and B<on_exit>(3))  can be used within a "
 558 "shared library to establish functions that are called when the shared "
 559 "library is unloaded."
 560 msgstr ""
 561
 562 #. type: SH
 563 #: build/C/man3/atexit.3:131 build/C/man3/getsubopt.3:138 build/C/man3/rand.3:160 build/C/man3/rpmatch.3:119 build/C/man3/strtod.3:174 build/C/man3/strtol.3:204 build/C/man3/strtoul.3:208
 564 #, no-wrap
 565 msgid "EXAMPLE"
 566 msgstr ""
 567
 568 #. type: Plain text
 569 #: build/C/man3/atexit.3:136
 570 #, no-wrap
 571 msgid ""
 572 "#include E<lt>stdio.hE<gt>\n"
 573 "#include E<lt>stdlib.hE<gt>\n"
 574 "#include E<lt>unistd.hE<gt>\n"
 575 msgstr ""
 576
 577 #. type: Plain text
 578 #: build/C/man3/atexit.3:142
 579 #, no-wrap
 580 msgid ""
 581 "void\n"
 582 "bye(void)\n"
 583 "{\n"
 584 "    printf(\"That was all, folks\\en\");\n"
 585 "}\n"
 586 msgstr ""
 587
 588 #. type: Plain text
 589 #: build/C/man3/atexit.3:148
 590 #, no-wrap
 591 msgid ""
 592 "int\n"
 593 "main(void)\n"
 594 "{\n"
 595 "    long a;\n"
 596 "    int i;\n"
 597 msgstr ""
 598
 599 #. type: Plain text
 600 #: build/C/man3/atexit.3:151
 601 #, no-wrap
 602 msgid ""
 603 "    a = sysconf(_SC_ATEXIT_MAX);\n"
 604 "    printf(\"ATEXIT_MAX = %ld\\en\", a);\n"
 605 msgstr ""
 606
 607 #. type: Plain text
 608 #: build/C/man3/atexit.3:157
 609 #, no-wrap
 610 msgid ""
 611 "    i = atexit(bye);\n"
 612 "    if (i != 0) {\n"
 613 "        fprintf(stderr, \"cannot set exit function\\en\");\n"
 614 "        exit(EXIT_FAILURE);\n"
 615 "    }\n"
 616 msgstr ""
 617
 618 #. type: Plain text
 619 #: build/C/man3/atexit.3:160 build/C/man3/getsubopt.3:225 build/C/man3/rand.3:215 build/C/man3/strtol.3:284
 620 #, no-wrap
 621 msgid ""
 622 "    exit(EXIT_SUCCESS);\n"
 623 "}\n"
 624 msgstr ""
 625
 626 #. type: Plain text
 627 #: build/C/man3/atexit.3:165
 628 msgid "B<_exit>(2), B<exit>(3), B<on_exit>(3)"
 629 msgstr ""
 630
 631 #. type: TH
 632 #: build/C/man3/atof.3:31
 633 #, no-wrap
 634 msgid "ATOF"
 635 msgstr ""
 636
 637 #. type: TH
 638 #: build/C/man3/atof.3:31 build/C/man3/atoi.3:33
 639 #, no-wrap
 640 msgid "2012-08-03"
 641 msgstr ""
 642
 643 #. type: TH
 644 #: build/C/man3/atof.3:31 build/C/man3/atoi.3:33 build/C/man3/canonicalize_file_name.3:26 build/C/man3/drand48_r.3:27 build/C/man3/ecvt_r.3:30 build/C/man3/getauxval.3:27 build/C/man3/getenv.3:33 build/C/man3/getsubopt.3:25 build/C/man3/malloc.3:30 build/C/man3/mblen.3:16 build/C/man3/mbstowcs.3:16 build/C/man3/mbtowc.3:16 build/C/man3/mkdtemp.3:26 build/C/man3/mkstemp.3:35 build/C/man3/mktemp.3:34 build/C/man3/on_exit.3:31 build/C/man3/putenv.3:36 build/C/man3/qecvt.3:28 build/C/man3/random.3:33 build/C/man3/random_r.3:26 build/C/man3/rpmatch.3:29 build/C/man3/setenv.3:37 build/C/man3/strtol.3:31 build/C/man3/strtoul.3:33 build/C/man3/wcstombs.3:16 build/C/man3/wctomb.3:16
 645 #, no-wrap
 646 msgid "GNU"
 647 msgstr ""
 648
 649 #. type: Plain text
 650 #: build/C/man3/atof.3:34
 651 msgid "atof - convert a string to a double"
 652 msgstr ""
 653
 654 #. type: Plain text
 655 #: build/C/man3/atof.3:39
 656 #, no-wrap
 657 msgid "B<double atof(const char *>I<nptr>B<);>\n"
 658 msgstr ""
 659
 660 #. type: Plain text
 661 #: build/C/man3/atof.3:47
 662 msgid ""
 663 "The B<atof>()  function converts the initial portion of the string pointed "
 664 "to by I<nptr> to I<double>.  The behavior is the same as"
 665 msgstr ""
 666
 667 #. type: Plain text
 668 #: build/C/man3/atof.3:50
 669 msgid "strtod(nptr, NULL);"
 670 msgstr ""
 671
 672 #. type: Plain text
 673 #: build/C/man3/atof.3:55
 674 msgid "except that B<atof>()  does not detect errors."
 675 msgstr ""
 676
 677 #. type: Plain text
 678 #: build/C/man3/atof.3:57 build/C/man3/atoi.3:93
 679 msgid "The converted value."
 680 msgstr ""
 681
 682 #. type: Plain text
 683 #: build/C/man3/atof.3:59
 684 msgid "SVr4, POSIX.1-2001, 4.3BSD, C89, C99."
 685 msgstr ""
 686
 687 #. type: Plain text
 688 #: build/C/man3/atof.3:65
 689 msgid "B<atoi>(3), B<atol>(3), B<strtod>(3), B<strtol>(3), B<strtoul>(3)"
 690 msgstr ""
 691
 692 #. type: TH
 693 #: build/C/man3/atoi.3:33
 694 #, no-wrap
 695 msgid "ATOI"
 696 msgstr ""
 697
 698 #. type: Plain text
 699 #: build/C/man3/atoi.3:36
 700 msgid "atoi, atol, atoll, atoq - convert a string to an integer"
 701 msgstr ""
 702
 703 #. type: Plain text
 704 #: build/C/man3/atoi.3:41
 705 #, no-wrap
 706 msgid "B<int atoi(const char *>I<nptr>B<);>\n"
 707 msgstr ""
 708
 709 #. type: Plain text
 710 #: build/C/man3/atoi.3:43
 711 #, no-wrap
 712 msgid "B<long atol(const char *>I<nptr>B<);>\n"
 713 msgstr ""
 714
 715 #. type: Plain text
 716 #: build/C/man3/atoi.3:45
 717 #, no-wrap
 718 msgid "B<long long atoll(const char *>I<nptr>B<);>\n"
 719 msgstr ""
 720
 721 #. type: Plain text
 722 #: build/C/man3/atoi.3:47
 723 #, no-wrap
 724 msgid "B<long long atoq(const char *>I<nptr>B<);>\n"
 725 msgstr ""
 726
 727 #. type: Plain text
 728 #: build/C/man3/atoi.3:56
 729 msgid "B<atoll>():"
 730 msgstr ""
 731
 732 #. type: Plain text
 733 #: build/C/man3/atoi.3:59
 734 msgid ""
 735 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 600 || "
 736 "_ISOC99_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
 737 msgstr ""
 738
 739 #. type: Plain text
 740 #: build/C/man3/atoi.3:71
 741 msgid ""
 742 "The B<atoi>()  function converts the initial portion of the string pointed "
 743 "to by I<nptr> to I<int>.  The behavior is the same as"
 744 msgstr ""
 745
 746 #. type: Plain text
 747 #: build/C/man3/atoi.3:74
 748 msgid "strtol(nptr, NULL, 10);"
 749 msgstr ""
 750
 751 #. type: Plain text
 752 #: build/C/man3/atoi.3:79
 753 msgid "except that B<atoi>()  does not detect errors."
 754 msgstr ""
 755
 756 #. type: Plain text
 757 #: build/C/man3/atoi.3:91
 758 msgid ""
 759 "The B<atol>()  and B<atoll>()  functions behave the same as B<atoi>(), "
 760 "except that they convert the initial portion of the string to their return "
 761 "type of I<long> or I<long long>.  B<atoq>()  is an obsolete name for "
 762 "B<atoll>()."
 763 msgstr ""
 764
 765 #. type: Plain text
 766 #: build/C/man3/atoi.3:103
 767 msgid ""
 768 "SVr4, POSIX.1-2001, 4.3BSD, C99.  C89 and POSIX.1-1996 include the functions "
 769 "B<atoi>()  and B<atol>()  only.  B<atoq>()  is a GNU extension."
 770 msgstr ""
 771
 772 #. type: Plain text
 773 #: build/C/man3/atoi.3:113
 774 msgid ""
 775 "The nonstandard B<atoq>()  function is not present in libc 4.6.27 or glibc "
 776 "2, but is present in libc5 and libc 4.7 (though only as an inline function "
 777 "in I<E<lt>stdlib.hE<gt>> until libc 5.4.44).  The B<atoll>()  function is "
 778 "present in glibc 2 since version 2.0.2, but not in libc4 or libc5."
 779 msgstr ""
 780
 781 #. type: Plain text
 782 #: build/C/man3/atoi.3:118
 783 msgid "B<atof>(3), B<strtod>(3), B<strtol>(3), B<strtoul>(3)"
 784 msgstr ""
 785
 786 #. type: TH
 787 #: build/C/man3/canonicalize_file_name.3:26
 788 #, no-wrap
 789 msgid "CANONICALIZE_FILE_NAME"
 790 msgstr ""
 791
 792 #. type: TH
 793 #: build/C/man3/canonicalize_file_name.3:26
 794 #, no-wrap
 795 msgid "2013-05-11"
 796 msgstr ""
 797
 798 #. type: Plain text
 799 #: build/C/man3/canonicalize_file_name.3:29
 800 msgid "canonicalize_file_name - return the canonicalized absolute pathname"
 801 msgstr ""
 802
 803 #. type: Plain text
 804 #: build/C/man3/canonicalize_file_name.3:31
 805 msgid "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */"
 806 msgstr ""
 807
 808 #. type: Plain text
 809 #: build/C/man3/canonicalize_file_name.3:35
 810 msgid "B<char *canonicalize_file_name(const char *>I<path>B<);>"
 811 msgstr ""
 812
 813 #. type: Plain text
 814 #: build/C/man3/canonicalize_file_name.3:49
 815 msgid ""
 816 "The B<canonicalize_file_name>()  function returns a null-terminated string "
 817 "containing the canonicalized absolute pathname corresponding to I<path>.  In "
 818 "the returned string, symbolic links are resolved, as are I<.> and I<..> "
 819 "pathname components.  Consecutive slash (I</>)  characters are replaced by a "
 820 "single slash."
 821 msgstr ""
 822
 823 #. type: Plain text
 824 #: build/C/man3/canonicalize_file_name.3:55
 825 msgid ""
 826 "The returned string is dynamically allocated by B<canonicalize_file_name>()  "
 827 "and the caller should deallocate it with B<free>(3)  when it is no longer "
 828 "required."
 829 msgstr ""
 830
 831 #. type: Plain text
 832 #: build/C/man3/canonicalize_file_name.3:59
 833 msgid "The call I<canonicalize_file_name(path)> is equivalent to the call:"
 834 msgstr ""
 835
 836 #. type: Plain text
 837 #: build/C/man3/canonicalize_file_name.3:61
 838 #, no-wrap
 839 msgid "    realpath(path, NULL);\n"
 840 msgstr ""
 841
 842 #. type: Plain text
 843 #: build/C/man3/canonicalize_file_name.3:70
 844 msgid ""
 845 "On success, B<canonicalize_file_name>()  returns a null-terminated string.  "
 846 "On error (e.g., a pathname component is unreadable or does not exist), "
 847 "B<canonicalize_file_name>()  returns NULL and sets I<errno> to indicate the "
 848 "error."
 849 msgstr ""
 850
 851 #. type: SH
 852 #: build/C/man3/canonicalize_file_name.3:70 build/C/man3/getauxval.3:179 build/C/man3/mkdtemp.3:75 build/C/man3/mkstemp.3:142 build/C/man3/mktemp.3:88 build/C/man3/putenv.3:75 build/C/man3/random.3:140 build/C/man3/random_r.3:105 build/C/man3/rpmatch.3:82 build/C/man3/setenv.3:118 build/C/man3/strtod.3:156 build/C/man3/strtol.3:144 build/C/man3/strtoul.3:148
 853 #, no-wrap
 854 msgid "ERRORS"
 855 msgstr ""
 856
 857 #. type: Plain text
 858 #: build/C/man3/canonicalize_file_name.3:73
 859 msgid "See B<realpath>(3)."
 860 msgstr ""
 861
 862 #. type: Plain text
 863 #: build/C/man3/canonicalize_file_name.3:75
 864 msgid "This function is a GNU extension."
 865 msgstr ""
 866
 867 #. type: Plain text
 868 #: build/C/man3/canonicalize_file_name.3:78
 869 msgid "B<readlink>(2), B<realpath>(3)"
 870 msgstr ""
 871
 872 #. type: TH
 873 #: build/C/man3/cfree.3:24
 874 #, no-wrap
 875 msgid "CFREE"
 876 msgstr ""
 877
 878 #. type: TH
 879 #: build/C/man3/cfree.3:24 build/C/man3/drand48_r.3:27 build/C/man3/ecvt_r.3:30 build/C/man3/rpmatch.3:29
 880 #, no-wrap
 881 msgid "2007-07-26"
 882 msgstr ""
 883
 884 #. type: Plain text
 885 #: build/C/man3/cfree.3:27
 886 msgid "cfree - free allocated memory"
 887 msgstr ""
 888
 889 #. type: Plain text
 890 #: build/C/man3/cfree.3:34
 891 #, no-wrap
 892 msgid ""
 893 "/* In SunOS 4 */\n"
 894 "B<int cfree(void *>I<ptr>B<);>\n"
 895 msgstr ""
 896
 897 #. type: Plain text
 898 #: build/C/man3/cfree.3:37
 899 #, no-wrap
 900 msgid ""
 901 "/* In glibc or FreeBSD libcompat */\n"
 902 "B<void cfree(void *>I<ptr>B<);>\n"
 903 msgstr ""
 904
 905 #. type: Plain text
 906 #: build/C/man3/cfree.3:40
 907 #, no-wrap
 908 msgid ""
 909 "/* In SCO OpenServer */\n"
 910 "B<void cfree(char *>I<ptr>B<, unsigned >I<num>B<, unsigned >I<size>B<);>\n"
 911 msgstr ""
 912
 913 #. type: Plain text
 914 #: build/C/man3/cfree.3:43
 915 #, no-wrap
 916 msgid ""
 917 "/* In Solaris watchmalloc.so.1 */\n"
 918 "B<void cfree(void *>I<ptr>B<, size_t >I<nelem>B<, size_t >I<elsize>B<);>\n"
 919 msgstr ""
 920
 921 #. type: Plain text
 922 #: build/C/man3/cfree.3:52
 923 msgid "B<cfree>(): _BSD_SOURCE || _SVID_SOURCE"
 924 msgstr ""
 925
 926 #. type: Plain text
 927 #: build/C/man3/cfree.3:57
 928 msgid "This function should never be used.  Use B<free>(3)  instead."
 929 msgstr ""
 930
 931 #. type: SS
 932 #: build/C/man3/cfree.3:57
 933 #, no-wrap
 934 msgid "1-arg cfree"
 935 msgstr ""
 936
 937 #. type: Plain text
 938 #: build/C/man3/cfree.3:63
 939 msgid ""
 940 "In glibc, the function B<cfree>()  is a synonym for B<free>(3), \"added for "
 941 "compatibility with SunOS\"."
 942 msgstr ""
 943
 944 #. type: Plain text
 945 #: build/C/man3/cfree.3:69
 946 msgid ""
 947 "Other systems have other functions with this name.  The declaration is "
 948 "sometimes in I<E<lt>stdlib.hE<gt>> and sometimes in I<E<lt>malloc.hE<gt>>."
 949 msgstr ""
 950
 951 #. type: SS
 952 #: build/C/man3/cfree.3:69
 953 #, no-wrap
 954 msgid "3-arg cfree"
 955 msgstr ""
 956
 957 #. type: Plain text
 958 #: build/C/man3/cfree.3:74
 959 msgid ""
 960 "Some SCO and Solaris versions have malloc libraries with a 3-argument "
 961 "B<cfree>(), apparently as an analog to B<calloc>(3)."
 962 msgstr ""
 963
 964 #. type: Plain text
 965 #: build/C/man3/cfree.3:76
 966 msgid "If you need it while porting something, add"
 967 msgstr ""
 968
 969 #. type: Plain text
 970 #: build/C/man3/cfree.3:79
 971 msgid "#define cfree(p, n, s) free((p))"
 972 msgstr ""
 973
 974 #. type: Plain text
 975 #: build/C/man3/cfree.3:82
 976 msgid "to your file."
 977 msgstr ""
 978
 979 #. type: Plain text
 980 #: build/C/man3/cfree.3:91
 981 msgid ""
 982 "A frequently asked question is \"Can I use B<free>(3)  to free memory "
 983 "allocated with B<calloc>(3), or do I need B<cfree>()?\" Answer: use "
 984 "B<free>(3)."
 985 msgstr ""
 986
 987 #. type: Plain text
 988 #: build/C/man3/cfree.3:96
 989 msgid ""
 990 "An SCO manual writes: \"The cfree routine is provided for compliance to the "
 991 "iBCSe2 standard and simply calls free.  The num and size arguments to cfree "
 992 "are not used.\""
 993 msgstr ""
 994
 995 #. type: Plain text
 996 #: build/C/man3/cfree.3:112
 997 msgid ""
 998 "The SunOS version of B<cfree>()  (which is a synonym for B<free>(3))  "
 999 "returns 1 on success and 0 on failure.  In case of error, I<errno> is set to "
1000 "B<EINVAL>: the value of I<ptr> was not a pointer to a block previously "
1001 "allocated by one of the routines in the B<malloc>(3)  family."
1002 msgstr ""
1003
1004 #. type: Plain text
1005 #: build/C/man3/cfree.3:117
1006 msgid ""
1007 "The 3-argument version of B<cfree>()  as used by SCO conforms to the iBCSe2 "
1008 "standard: Intel386 Binary Compatibility Specification, Edition 2."
1009 msgstr ""
1010
1011 #. type: Plain text
1012 #: build/C/man3/cfree.3:119
1013 msgid "B<malloc>(3)"
1014 msgstr ""
1015
1016 #. type: TH
1017 #: build/C/man3/clearenv.3:26
1018 #, no-wrap
1019 msgid "CLEARENV"
1020 msgstr ""
1021
1022 #. type: TH
1023 #: build/C/man3/clearenv.3:26
1024 #, no-wrap
1025 msgid "2010-10-04"
1026 msgstr ""
1027
1028 #. type: Plain text
1029 #: build/C/man3/clearenv.3:29
1030 msgid "clearenv - clear the environment"
1031 msgstr ""
1032
1033 #. type: Plain text
1034 #: build/C/man3/clearenv.3:34
1035 #, no-wrap
1036 msgid "B<int clearenv(void);>\n"
1037 msgstr ""
1038
1039 #. type: Plain text
1040 #: build/C/man3/clearenv.3:43
1041 msgid "B<clearenv>(): _SVID_SOURCE || _BSD_SOURCE"
1042 msgstr ""
1043
1044 #. type: Plain text
1045 #: build/C/man3/clearenv.3:50
1046 msgid ""
1047 "The B<clearenv>()  function clears the environment of all name-value pairs "
1048 "and sets the value of the external variable I<environ> to NULL."
1049 msgstr ""
1050
1051 #.  Most versions of UNIX return -1 on error, or do not even have errors.
1052 #.  Glibc info and the Watcom C library document "a nonzero value".
1053 #. type: Plain text
1054 #: build/C/man3/clearenv.3:57
1055 msgid ""
1056 "The B<clearenv>()  function returns zero on success, and a nonzero value on "
1057 "failure."
1058 msgstr ""
1059
1060 #. type: SH
1061 #: build/C/man3/clearenv.3:57 build/C/man3/getauxval.3:181 build/C/man3/getenv.3:93 build/C/man3/getloadavg.3:63 build/C/man3/mkdtemp.3:84 build/C/man3/mkstemp.3:169
1062 #, no-wrap
1063 msgid "VERSIONS"
1064 msgstr ""
1065
1066 #. type: Plain text
1067 #: build/C/man3/clearenv.3:60
1068 msgid "Not in libc4, libc5.  In glibc since glibc 2.0."
1069 msgstr ""
1070
1071 #. type: Plain text
1072 #: build/C/man3/clearenv.3:74
1073 msgid ""
1074 "Various UNIX variants (DG/UX, HP-UX, QNX, ...).  POSIX.9 (bindings for "
1075 "FORTRAN77).  POSIX.1-1996 did not accept B<clearenv>()  and B<putenv>(3), "
1076 "but changed its mind and scheduled these functions for some later issue of "
1077 "this standard (cf. B.4.6.1).  However, POSIX.1-2001 adds only B<putenv>(3), "
1078 "and rejected B<clearenv>()."
1079 msgstr ""
1080
1081 #. type: Plain text
1082 #: build/C/man3/clearenv.3:78
1083 msgid ""
1084 "Used in security-conscious applications.  If it is unavailable the "
1085 "assignment"
1086 msgstr ""
1087
1088 #. type: Plain text
1089 #: build/C/man3/clearenv.3:81
1090 #, no-wrap
1091 msgid "    environ = NULL;\n"
1092 msgstr ""
1093
1094 #. type: Plain text
1095 #: build/C/man3/clearenv.3:84
1096 msgid "will probably do."
1097 msgstr ""
1098
1099 #.  .LP
1100 #.  HP-UX has a ENOMEM error return.
1101 #. type: Plain text
1102 #: build/C/man3/clearenv.3:97
1103 msgid ""
1104 "The DG/UX and Tru64 man pages write: If I<environ> has been modified by "
1105 "anything other than the B<putenv>(3), B<getenv>(3), or B<clearenv>()  "
1106 "functions, then B<clearenv>()  will return an error and the process "
1107 "environment will remain unchanged."
1108 msgstr ""
1109
1110 #. type: Plain text
1111 #: build/C/man3/clearenv.3:103
1112 msgid "B<getenv>(3), B<putenv>(3), B<setenv>(3), B<unsetenv>(3), B<environ>(7)"
1113 msgstr ""
1114
1115 #. type: TH
1116 #: build/C/man3/drand48.3:30
1117 #, no-wrap
1118 msgid "DRAND48"
1119 msgstr ""
1120
1121 #. type: Plain text
1122 #: build/C/man3/drand48.3:34
1123 msgid ""
1124 "drand48, erand48, lrand48, nrand48, mrand48, jrand48, srand48, seed48, "
1125 "lcong48 - generate uniformly distributed pseudo-random numbers"
1126 msgstr ""
1127
1128 #. type: Plain text
1129 #: build/C/man3/drand48.3:39
1130 #, no-wrap
1131 msgid "B<double drand48(void);>\n"
1132 msgstr ""
1133
1134 #. type: Plain text
1135 #: build/C/man3/drand48.3:41
1136 #, no-wrap
1137 msgid "B<double erand48(unsigned short >I<xsubi>B<[3]);>\n"
1138 msgstr ""
1139
1140 #. type: Plain text
1141 #: build/C/man3/drand48.3:43
1142 #, no-wrap
1143 msgid "B<long int lrand48(void);>\n"
1144 msgstr ""
1145
1146 #. type: Plain text
1147 #: build/C/man3/drand48.3:45
1148 #, no-wrap
1149 msgid "B<long int nrand48(unsigned short >I<xsubi>B<[3]);>\n"
1150 msgstr ""
1151
1152 #. type: Plain text
1153 #: build/C/man3/drand48.3:47
1154 #, no-wrap
1155 msgid "B<long int mrand48(void);>\n"
1156 msgstr ""
1157
1158 #. type: Plain text
1159 #: build/C/man3/drand48.3:49
1160 #, no-wrap
1161 msgid "B<long int jrand48(unsigned short >I<xsubi>B<[3]);>\n"
1162 msgstr ""
1163
1164 #. type: Plain text
1165 #: build/C/man3/drand48.3:51
1166 #, no-wrap
1167 msgid "B<void srand48(long int >I<seedval>B<);>\n"
1168 msgstr ""
1169
1170 #. type: Plain text
1171 #: build/C/man3/drand48.3:53
1172 #, no-wrap
1173 msgid "B<unsigned short *seed48(unsigned short >I<seed16v>B<[3]);>\n"
1174 msgstr ""
1175
1176 #. type: Plain text
1177 #: build/C/man3/drand48.3:55
1178 #, no-wrap
1179 msgid "B<void lcong48(unsigned short >I<param>B<[7]);>\n"
1180 msgstr ""
1181
1182 #.  .BR drand48 (),
1183 #.  .BR erand48 (),
1184 #.  .BR lrand48 (),
1185 #.  .BR nrand48 (),
1186 #.  .BR mrand48 (),
1187 #.  .BR jrand48 (),
1188 #.  .BR srand48 (),
1189 #.  .BR seed48 (),
1190 #.  .BR lcong48 ():
1191 #. type: Plain text
1192 #: build/C/man3/drand48.3:74
1193 msgid "All functions shown above: _SVID_SOURCE || _XOPEN_SOURCE"
1194 msgstr ""
1195
1196 #. type: Plain text
1197 #: build/C/man3/drand48.3:78
1198 msgid ""
1199 "These functions generate pseudo-random numbers using the linear congruential "
1200 "algorithm and 48-bit integer arithmetic."
1201 msgstr ""
1202
1203 #. type: Plain text
1204 #: build/C/man3/drand48.3:86
1205 msgid ""
1206 "The B<drand48>()  and B<erand48>()  functions return nonnegative "
1207 "double-precision floating-point values uniformly distributed between [0.0, "
1208 "1.0)."
1209 msgstr ""
1210
1211 #. type: Plain text
1212 #: build/C/man3/drand48.3:93
1213 msgid ""
1214 "The B<lrand48>()  and B<nrand48>()  functions return nonnegative long "
1215 "integers uniformly distributed between 0 and 2^31."
1216 msgstr ""
1217
1218 #. type: Plain text
1219 #: build/C/man3/drand48.3:100
1220 msgid ""
1221 "The B<mrand48>()  and B<jrand48>()  functions return signed long integers "
1222 "uniformly distributed between -2^31 and 2^31."
1223 msgstr ""
1224
1225 #. type: Plain text
1226 #: build/C/man3/drand48.3:119
1227 msgid ""
1228 "The B<srand48>(), B<seed48>()  and B<lcong48>()  functions are "
1229 "initialization functions, one of which should be called before using "
1230 "B<drand48>(), B<lrand48>()  or B<mrand48>().  The functions B<erand48>(), "
1231 "B<nrand48>()  and B<jrand48>()  do not require an initialization function to "
1232 "be called first."
1233 msgstr ""
1234
1235 #. type: Plain text
1236 #: build/C/man3/drand48.3:123
1237 msgid ""
1238 "All the functions work by generating a sequence of 48-bit integers, I<Xi>, "
1239 "according to the linear congruential formula:"
1240 msgstr ""
1241
1242 #. type: Plain text
1243 #: build/C/man3/drand48.3:127
1244 #, no-wrap
1245 msgid "B<Xn+1 = (aXn + c) mod m, where n E<gt>= 0>\n"
1246 msgstr ""
1247
1248 #. type: Plain text
1249 #: build/C/man3/drand48.3:140
1250 msgid ""
1251 "The parameter I<m> = 2^48, hence 48-bit integer arithmetic is performed.  "
1252 "Unless B<lcong48>()  is called, I<a> and I<c> are given by:"
1253 msgstr ""
1254
1255 #. type: Plain text
1256 #: build/C/man3/drand48.3:145
1257 #, no-wrap
1258 msgid ""
1259 "B<a = 0x5DEECE66D>\n"
1260 "B<c = 0xB>\n"
1261 msgstr ""
1262
1263 #. type: Plain text
1264 #: build/C/man3/drand48.3:165
1265 msgid ""
1266 "The value returned by any of the functions B<drand48>(), B<erand48>(), "
1267 "B<lrand48>(), B<nrand48>(), B<mrand48>()  or B<jrand48>()  is computed by "
1268 "first generating the next 48-bit I<Xi> in the sequence.  Then the "
1269 "appropriate number of bits, according to the type of data item to be "
1270 "returned, is copied from the high-order bits of I<Xi> and transformed into "
1271 "the returned value."
1272 msgstr ""
1273
1274 #. type: Plain text
1275 #: build/C/man3/drand48.3:191
1276 msgid ""
1277 "The functions B<drand48>(), B<lrand48>()  and B<mrand48>()  store the last "
1278 "48-bit I<Xi> generated in an internal buffer.  The functions B<erand48>(), "
1279 "B<nrand48>()  and B<jrand48>()  require the calling program to provide "
1280 "storage for the successive I<Xi> values in the array argument I<xsubi>.  The "
1281 "functions are initialized by placing the initial value of I<Xi> into the "
1282 "array before calling the function for the first time."
1283 msgstr ""
1284
1285 #. type: Plain text
1286 #: build/C/man3/drand48.3:200
1287 msgid ""
1288 "The initializer function B<srand48>()  sets the high order 32-bits of I<Xi> "
1289 "to the argument I<seedval>.  The low order 16-bits are set to the arbitrary "
1290 "value 0x330E."
1291 msgstr ""
1292
1293 #. type: Plain text
1294 #: build/C/man3/drand48.3:214
1295 msgid ""
1296 "The initializer function B<seed48>()  sets the value of I<Xi> to the 48-bit "
1297 "value specified in the array argument I<seed16v>.  The previous value of "
1298 "I<Xi> is copied into an internal buffer and a pointer to this buffer is "
1299 "returned by B<seed48>()."
1300 msgstr ""
1301
1302 #. type: Plain text
1303 #: build/C/man3/drand48.3:245
1304 msgid ""
1305 "The initialization function B<lcong48>()  allows the user to specify initial "
1306 "values for I<Xi>, I<a> and I<c>.  Array argument elements I<param[0-2]> "
1307 "specify I<Xi>, I<param[3-5]> specify I<a>, and I<param[6]> specifies I<c>.  "
1308 "After B<lcong48>()  has been called, a subsequent call to either "
1309 "B<srand48>()  or B<seed48>()  will restore the standard values of I<a> and "
1310 "I<c>."
1311 msgstr ""
1312
1313 #. type: Plain text
1314 #: build/C/man3/drand48.3:260
1315 msgid ""
1316 "The B<drand48>(), B<erand48>(), B<lrand48>(), B<nrand48>(), B<mrand48>(), "
1317 "B<jrand48>(), B<srand48>(), B<seed48>(), and B<lcong48>()  functions record "
1318 "global state information for the random number generator, so they are not "
1319 "thread-safe."
1320 msgstr ""
1321
1322 #. type: Plain text
1323 #: build/C/man3/drand48.3:262
1324 msgid "SVr4, POSIX.1-2001."
1325 msgstr ""
1326
1327 #. type: Plain text
1328 #: build/C/man3/drand48.3:266
1329 msgid ""
1330 "These functions are declared obsolete by SVID 3, which states that "
1331 "B<rand>(3)  should be used instead."
1332 msgstr ""
1333
1334 #. type: Plain text
1335 #: build/C/man3/drand48.3:269
1336 msgid "B<rand>(3), B<random>(3)"
1337 msgstr ""
1338
1339 #. type: TH
1340 #: build/C/man3/drand48_r.3:27
1341 #, no-wrap
1342 msgid "DRAND48_R"
1343 msgstr ""
1344
1345 #. type: Plain text
1346 #: build/C/man3/drand48_r.3:32
1347 msgid ""
1348 "drand48_r, erand48_r, lrand48_r, nrand48_r, mrand48_r, jrand48_r, srand48_r, "
1349 "seed48_r, lcong48_r - generate uniformly distributed pseudo-random numbers "
1350 "reentrantly"
1351 msgstr ""
1352
1353 #. type: Plain text
1354 #: build/C/man3/drand48_r.3:37
1355 #, no-wrap
1356 msgid "B<int drand48_r(struct drand48_data *>I<buffer>B<, double *>I<result>B<);>\n"
1357 msgstr ""
1358
1359 #. type: Plain text
1360 #: build/C/man3/drand48_r.3:39
1361 #, no-wrap
1362 msgid "B<int erand48_r(unsigned short >I<xsubi>B<[3]>I<,>\n"
1363 msgstr ""
1364
1365 #. type: Plain text
1366 #: build/C/man3/drand48_r.3:41
1367 #, no-wrap
1368 msgid "B<              struct drand48_data *>I<buffer>B<, double *>I<result>B<);>\n"
1369 msgstr ""
1370
1371 #. type: Plain text
1372 #: build/C/man3/drand48_r.3:43
1373 #, no-wrap
1374 msgid ""
1375 "B<int lrand48_r(struct drand48_data *>I<buffer>B<, long int "
1376 "*>I<result>B<);>\n"
1377 msgstr ""
1378
1379 #. type: Plain text
1380 #: build/C/man3/drand48_r.3:45
1381 #, no-wrap
1382 msgid "B<int nrand48_r(unsigned short int >I<xsubi[3]>B<,>\n"
1383 msgstr ""
1384
1385 #. type: Plain text
1386 #: build/C/man3/drand48_r.3:47 build/C/man3/drand48_r.3:53
1387 #, no-wrap
1388 msgid ""
1389 "B<              struct drand48_data *>I<buffer>B<, long int "
1390 "*>I<result>B<);>\n"
1391 msgstr ""
1392
1393 #. type: Plain text
1394 #: build/C/man3/drand48_r.3:49
1395 #, no-wrap
1396 msgid ""
1397 "B<int mrand48_r(struct drand48_data *>I<buffer>B<,long int "
1398 "*>I<result>B<);>\n"
1399 msgstr ""
1400
1401 #. type: Plain text
1402 #: build/C/man3/drand48_r.3:51
1403 #, no-wrap
1404 msgid "B<int jrand48_r(unsigned short int >I<xsubi[3]>B<,>\n"
1405 msgstr ""
1406
1407 #. type: Plain text
1408 #: build/C/man3/drand48_r.3:55
1409 #, no-wrap
1410 msgid ""
1411 "B<int srand48_r(long int >I<seedval>B<, struct drand48_data "
1412 "*>I<buffer>B<);>\n"
1413 msgstr ""
1414
1415 #. type: Plain text
1416 #: build/C/man3/drand48_r.3:57
1417 #, no-wrap
1418 msgid "B<int seed48_r(unsigned short int >I<seed16v[3]>B<,>\n"
1419 msgstr ""
1420
1421 #. type: Plain text
1422 #: build/C/man3/drand48_r.3:59
1423 #, no-wrap
1424 msgid "B<             struct drand48_data *>I<buffer>B<);>\n"
1425 msgstr ""
1426
1427 #. type: Plain text
1428 #: build/C/man3/drand48_r.3:61
1429 #, no-wrap
1430 msgid "B<int lcong48_r(unsigned short int >I<param[7]>B<,>\n"
1431 msgstr ""
1432
1433 #. type: Plain text
1434 #: build/C/man3/drand48_r.3:63
1435 #, no-wrap
1436 msgid "B<              struct drand48_data *>I<buffer>B<);>\n"
1437 msgstr ""
1438
1439 #.  .BR drand48_r (),
1440 #.  .BR erand48_r (),
1441 #.  .BR lrand48_r (),
1442 #.  .BR nrand48_r (),
1443 #.  .BR mrand48_r (),
1444 #.  .BR jrand48_r (),
1445 #.  .BR srand48_r (),
1446 #.  .BR seed48_r (),
1447 #.  .BR lcong48_r ():
1448 #. type: Plain text
1449 #: build/C/man3/drand48_r.3:82
1450 msgid "All functions shown above: _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE"
1451 msgstr ""
1452
1453 #. type: Plain text
1454 #: build/C/man3/drand48_r.3:89
1455 msgid ""
1456 "These functions are the reentrant analogs of the functions described in "
1457 "B<drand48>(3).  Instead of modifying the global random generator state, they "
1458 "use the supplied data I<buffer>."
1459 msgstr ""
1460
1461 #. type: Plain text
1462 #: build/C/man3/drand48_r.3:96
1463 msgid ""
1464 "Before the first use, this struct must be initialized, for example, by "
1465 "filling it with zeros, or by calling one of the functions B<srand48_r>(), "
1466 "B<seed48_r>(), or B<lcong48_r>()."
1467 msgstr ""
1468
1469 #. type: Plain text
1470 #: build/C/man3/drand48_r.3:98
1471 msgid "The return value is 0."
1472 msgstr ""
1473
1474 #. type: Plain text
1475 #: build/C/man3/drand48_r.3:100
1476 msgid "These functions are GNU extensions and are not portable."
1477 msgstr ""
1478
1479 #. type: Plain text
1480 #: build/C/man3/drand48_r.3:104 build/C/man3/random_r.3:136
1481 msgid "B<drand48>(3), B<rand>(3), B<random>(3)"
1482 msgstr ""
1483
1484 #. type: TH
1485 #: build/C/man3/ecvt.3:32
1486 #, no-wrap
1487 msgid "ECVT"
1488 msgstr ""
1489
1490 #. type: TH
1491 #: build/C/man3/ecvt.3:32
1492 #, no-wrap
1493 msgid "2013-07-04"
1494 msgstr ""
1495
1496 #. type: Plain text
1497 #: build/C/man3/ecvt.3:35
1498 msgid "ecvt, fcvt - convert a floating-point number to a string"
1499 msgstr ""
1500
1501 #. type: Plain text
1502 #: build/C/man3/ecvt.3:40
1503 msgid ""
1504 "B<char *ecvt(double >I<number>B<, int >I<ndigits>B<, int *>I<decpt>B<,> "
1505 "B<int *>I<sign>B<);>"
1506 msgstr ""
1507
1508 #. type: Plain text
1509 #: build/C/man3/ecvt.3:43
1510 msgid ""
1511 "B<char *fcvt(double >I<number>B<, int >I<ndigits>B<, int *>I<decpt>B<,> "
1512 "B<int *>I<sign>B<);>"
1513 msgstr ""
1514
1515 #. type: Plain text
1516 #: build/C/man3/ecvt.3:51
1517 msgid "B<ecvt>(), B<fcvt>():"
1518 msgstr ""
1519
1520 #. type: TP
1521 #: build/C/man3/ecvt.3:54 build/C/man3/gcvt.3:49 build/C/man3/mktemp.3:53
1522 #, no-wrap
1523 msgid "Since glibc 2.12:"
1524 msgstr ""
1525
1526 #. type: Plain text
1527 #: build/C/man3/ecvt.3:61 build/C/man3/gcvt.3:56
1528 #, no-wrap
1529 msgid ""
1530 "_SVID_SOURCE ||\n"
1531 "    (_XOPEN_SOURCE\\ E<gt>=\\ 500 ||\n"
1532 "        _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED) &&\n"
1533 "    !(_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600)\n"
1534 msgstr ""
1535
1536 #. type: TP
1537 #: build/C/man3/ecvt.3:62 build/C/man3/gcvt.3:57 build/C/man3/mktemp.3:59
1538 #, no-wrap
1539 msgid "Before glibc 2.12:"
1540 msgstr ""
1541
1542 #. type: Plain text
1543 #: build/C/man3/ecvt.3:92
1544 msgid ""
1545 "The B<ecvt>()  function converts I<number> to a null-terminated string of "
1546 "I<ndigits> digits (where I<ndigits> is reduced to a system-specific limit "
1547 "determined by the precision of a I<double>), and returns a pointer to the "
1548 "string.  The high-order digit is nonzero, unless I<number> is zero.  The low "
1549 "order digit is rounded.  The string itself does not contain a decimal point; "
1550 "however, the position of the decimal point relative to the start of the "
1551 "string is stored in I<*decpt>.  A negative value for I<*decpt> means that "
1552 "the decimal point is to the left of the start of the string.  If the sign of "
1553 "I<number> is negative, I<*sign> is set to a nonzero value, otherwise it is "
1554 "set to 0.  If I<number> is zero, it is unspecified whether I<*decpt> is 0 or "
1555 "1."
1556 msgstr ""
1557
1558 #. type: Plain text
1559 #: build/C/man3/ecvt.3:99
1560 msgid ""
1561 "The B<fcvt>()  function is identical to B<ecvt>(), except that I<ndigits> "
1562 "specifies the number of digits after the decimal point."
1563 msgstr ""
1564
1565 #. type: Plain text
1566 #: build/C/man3/ecvt.3:110
1567 msgid ""
1568 "Both the B<ecvt>()  and B<fcvt>()  functions return a pointer to a static "
1569 "string containing the ASCII representation of I<number>.  The static string "
1570 "is overwritten by each call to B<ecvt>()  or B<fcvt>()."
1571 msgstr ""
1572
1573 #. type: Plain text
1574 #: build/C/man3/ecvt.3:117
1575 msgid "The B<ecvt>()  and B<fcvt>()  functions are not thread-safe."
1576 msgstr ""
1577
1578 #. type: Plain text
1579 #: build/C/man3/ecvt.3:129
1580 msgid ""
1581 "SVr2; marked as LEGACY in POSIX.1-2001.  POSIX.1-2008 removes the "
1582 "specifications of B<ecvt>()  and B<fcvt>(), recommending the use of "
1583 "B<sprintf>(3)  instead (though B<snprintf>(3)  may be preferable)."
1584 msgstr ""
1585
1586 #. type: Plain text
1587 #: build/C/man3/ecvt.3:135
1588 msgid ""
1589 "Linux libc4 and libc5 specified the type of I<ndigits> as I<size_t>.  Not "
1590 "all locales use a point as the radix character (\"decimal point\")."
1591 msgstr ""
1592
1593 #. type: Plain text
1594 #: build/C/man3/ecvt.3:141
1595 msgid "B<ecvt_r>(3), B<gcvt>(3), B<qecvt>(3), B<setlocale>(3), B<sprintf>(3)"
1596 msgstr ""
1597
1598 #. type: TH
1599 #: build/C/man3/ecvt_r.3:30
1600 #, no-wrap
1601 msgid "ECVT_R"
1602 msgstr ""
1603
1604 #. type: Plain text
1605 #: build/C/man3/ecvt_r.3:33
1606 msgid ""
1607 "ecvt_r, fcvt_r, qecvt_r, qfcvt_r - convert a floating-point number to a "
1608 "string"
1609 msgstr ""
1610
1611 #. type: Plain text
1612 #: build/C/man3/ecvt_r.3:39
1613 #, no-wrap
1614 msgid ""
1615 "B<int ecvt_r(double >I<number>B<, int >I<ndigits>B<, int *>I<decpt>B<,>\n"
1616 "B<           int *>I<sign>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
1617 msgstr ""
1618
1619 #. type: Plain text
1620 #: build/C/man3/ecvt_r.3:42
1621 #, no-wrap
1622 msgid ""
1623 "B<int fcvt_r(double >I<number>B<, int >I<ndigits>B<, int *>I<decpt>B<,>\n"
1624 "B<           int *>I<sign>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
1625 msgstr ""
1626
1627 #. type: Plain text
1628 #: build/C/man3/ecvt_r.3:45
1629 #, no-wrap
1630 msgid ""
1631 "B<int qecvt_r(long double >I<number>B<, int >I<ndigits>B<, int "
1632 "*>I<decpt>B<,>\n"
1633 "B<           int *>I<sign>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
1634 msgstr ""
1635
1636 #. type: Plain text
1637 #: build/C/man3/ecvt_r.3:48
1638 #, no-wrap
1639 msgid ""
1640 "B<int qfcvt_r(long double >I<number>B<, int >I<ndigits>B<, int "
1641 "*>I<decpt>B<,>\n"
1642 "B<           int *>I<sign>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
1643 msgstr ""
1644
1645 #. type: Plain text
1646 #: build/C/man3/ecvt_r.3:60
1647 msgid "B<ecvt_r>(), B<fcvt_r>(), B<qecvt_r>(), B<qfcvt_r>():"
1648 msgstr ""
1649
1650 #. type: Plain text
1651 #: build/C/man3/ecvt_r.3:62
1652 msgid "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500"
1653 msgstr ""
1654
1655 #. type: Plain text
1656 #: build/C/man3/ecvt_r.3:86
1657 msgid ""
1658 "The functions B<ecvt_r>(), B<fcvt_r>(), B<qecvt_r>()  and B<qfcvt_r>()  are "
1659 "identical to B<ecvt>(3), B<fcvt>(3), B<qecvt>(3)  and B<qfcvt>(3), "
1660 "respectively, except that they do not return their result in a static "
1661 "buffer, but instead use the supplied I<buf> of size I<len>.  See B<ecvt>(3)  "
1662 "and B<qecvt>(3)."
1663 msgstr ""
1664
1665 #. type: Plain text
1666 #: build/C/man3/ecvt_r.3:88
1667 msgid "These functions return 0 on success, and -1 otherwise."
1668 msgstr ""
1669
1670 #. type: Plain text
1671 #: build/C/man3/ecvt_r.3:90
1672 msgid "These functions are GNU extensions."
1673 msgstr ""
1674
1675 #. type: Plain text
1676 #: build/C/man3/ecvt_r.3:95 build/C/man3/qecvt.3:94
1677 msgid "These functions are obsolete.  Instead, B<sprintf>(3)  is recommended."
1678 msgstr ""
1679
1680 #. type: Plain text
1681 #: build/C/man3/ecvt_r.3:99
1682 msgid "B<ecvt>(3), B<qecvt>(3), B<sprintf>(3)"
1683 msgstr ""
1684
1685 #. type: TH
1686 #: build/C/man3/exit.3:29
1687 #, no-wrap
1688 msgid "EXIT"
1689 msgstr ""
1690
1691 #. type: TH
1692 #: build/C/man3/exit.3:29
1693 #, no-wrap
1694 msgid "2013-02-14"
1695 msgstr ""
1696
1697 #. type: Plain text
1698 #: build/C/man3/exit.3:32
1699 msgid "exit - cause normal process termination"
1700 msgstr ""
1701
1702 #. type: Plain text
1703 #: build/C/man3/exit.3:37
1704 #, no-wrap
1705 msgid "B<void exit(int >I<status>B<);>\n"
1706 msgstr ""
1707
1708 #. type: Plain text
1709 #: build/C/man3/exit.3:45
1710 msgid ""
1711 "The B<exit>()  function causes normal process termination and the value of "
1712 "I<status & 0377> is returned to the parent (see B<wait>(2))."
1713 msgstr ""
1714
1715 #. type: Plain text
1716 #: build/C/man3/exit.3:72
1717 msgid ""
1718 "All functions registered with B<atexit>(3)  and B<on_exit>(3)  are called, "
1719 "in the reverse order of their registration.  (It is possible for one of "
1720 "these functions to use B<atexit>(3)  or B<on_exit>(3)  to register an "
1721 "additional function to be executed during exit processing; the new "
1722 "registration is added to the front of the list of functions that remain to "
1723 "be called.)  If one of these functions does not return (e.g., it calls "
1724 "B<_exit>(2), or kills itself with a signal), then none of the remaining "
1725 "functions is called, and further exit processing (in particular, flushing of "
1726 "B<stdio>(3)  streams) is abandoned.  If a function has been registered "
1727 "multiple times using B<atexit>(3)  or B<on_exit>(3), then it is called as "
1728 "many times as it was registered."
1729 msgstr ""
1730
1731 #. type: Plain text
1732 #: build/C/man3/exit.3:79
1733 msgid ""
1734 "All open B<stdio>(3)  streams are flushed and closed.  Files created by "
1735 "B<tmpfile>(3)  are removed."
1736 msgstr ""
1737
1738 #. type: Plain text
1739 #: build/C/man3/exit.3:86
1740 msgid ""
1741 "The C standard specifies two constants, B<EXIT_SUCCESS> and B<EXIT_FAILURE>, "
1742 "that may be passed to B<exit>()  to indicate successful or unsuccessful "
1743 "termination, respectively."
1744 msgstr ""
1745
1746 #. type: Plain text
1747 #: build/C/man3/exit.3:90
1748 msgid "The B<exit>()  function does not return."
1749 msgstr ""
1750
1751 #. type: Plain text
1752 #: build/C/man3/exit.3:92
1753 msgid "SVr4, 4.3BSD, POSIX.1-2001, C89, C99."
1754 msgstr ""
1755
1756 #. type: Plain text
1757 #: build/C/man3/exit.3:109
1758 msgid ""
1759 "It is undefined what happens if one of the functions registered using "
1760 "B<atexit>(3)  and B<on_exit>(3)  calls either B<exit>()  or B<longjmp>(3).  "
1761 "Note that a call to B<execve>(2)  removes registrations created using "
1762 "B<atexit>(3)  and B<on_exit>(3)."
1763 msgstr ""
1764
1765 #. type: Plain text
1766 #: build/C/man3/exit.3:118
1767 msgid ""
1768 "The use of B<EXIT_SUCCESS> and B<EXIT_FAILURE> is slightly more portable (to "
1769 "non-UNIX environments) than the use of 0 and some nonzero value like 1 or "
1770 "-1.  In particular, VMS uses a different convention."
1771 msgstr ""
1772
1773 #. type: Plain text
1774 #: build/C/man3/exit.3:121
1775 msgid ""
1776 "BSD has attempted to standardize exit codes; see the file "
1777 "I<E<lt>sysexits.hE<gt>>."
1778 msgstr ""
1779
1780 #. type: Plain text
1781 #: build/C/man3/exit.3:146
1782 msgid ""
1783 "After B<exit>(), the exit status must be transmitted to the parent process.  "
1784 "There are three cases.  If the parent has set B<SA_NOCLDWAIT>, or has set "
1785 "the B<SIGCHLD> handler to B<SIG_IGN>, the status is discarded.  If the "
1786 "parent was waiting on the child it is notified of the exit status.  In both "
1787 "cases the exiting process dies immediately.  If the parent has not indicated "
1788 "that it is not interested in the exit status, but is not waiting, the "
1789 "exiting process turns into a \"zombie\" process (which is nothing but a "
1790 "container for the single byte representing the exit status) so that the "
1791 "parent can learn the exit status when it later calls one of the B<wait>(2)  "
1792 "functions."
1793 msgstr ""
1794
1795 #. type: Plain text
1796 #: build/C/man3/exit.3:156
1797 msgid ""
1798 "If the implementation supports the B<SIGCHLD> signal, this signal is sent to "
1799 "the parent.  If the parent has set B<SA_NOCLDWAIT>, it is undefined whether "
1800 "a B<SIGCHLD> signal is sent."
1801 msgstr ""
1802
1803 #. type: Plain text
1804 #: build/C/man3/exit.3:165
1805 msgid ""
1806 "If the process is a session leader and its controlling terminal is the "
1807 "controlling terminal of the session, then each process in the foreground "
1808 "process group of this controlling terminal is sent a B<SIGHUP> signal, and "
1809 "the terminal is disassociated from this session, allowing it to be acquired "
1810 "by a new controlling process."
1811 msgstr ""
1812
1813 #. type: Plain text
1814 #: build/C/man3/exit.3:177
1815 msgid ""
1816 "If the exit of the process causes a process group to become orphaned, and if "
1817 "any member of the newly orphaned process group is stopped, then a B<SIGHUP> "
1818 "signal followed by a B<SIGCONT> signal will be sent to each process in this "
1819 "process group.  See B<setpgid>(2)  for an explanation of orphaned process "
1820 "groups."
1821 msgstr ""
1822
1823 #. type: Plain text
1824 #: build/C/man3/exit.3:184
1825 msgid ""
1826 "B<_exit>(2), B<setpgid>(2), B<wait>(2), B<atexit>(3), B<on_exit>(3), "
1827 "B<tmpfile>(3)"
1828 msgstr ""
1829
1830 #. type: TH
1831 #: build/C/man3/gcvt.3:30
1832 #, no-wrap
1833 msgid "GCVT"
1834 msgstr ""
1835
1836 #. type: Plain text
1837 #: build/C/man3/gcvt.3:33
1838 msgid "gcvt - convert a floating-point number to a string"
1839 msgstr ""
1840
1841 #. type: Plain text
1842 #: build/C/man3/gcvt.3:38
1843 #, no-wrap
1844 msgid "B<char *gcvt(double >I<number>B<, size_t >I<ndigit>B<, char *>I<buf>B<);>\n"
1845 msgstr ""
1846
1847 #. type: Plain text
1848 #: build/C/man3/gcvt.3:46
1849 msgid "B<gcvt>():"
1850 msgstr ""
1851
1852 #. type: Plain text
1853 #: build/C/man3/gcvt.3:61
1854 msgid ""
1855 "_SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE && "
1856 "_XOPEN_SOURCE_EXTENDED"
1857 msgstr ""
1858
1859 #. type: Plain text
1860 #: build/C/man3/gcvt.3:72
1861 msgid ""
1862 "The B<gcvt>()  function converts I<number> to a minimal length "
1863 "null-terminated ASCII string and stores the result in I<buf>.  It produces "
1864 "I<ndigit> significant digits in either B<printf>(3)  F format or E format."
1865 msgstr ""
1866
1867 #. type: Plain text
1868 #: build/C/man3/gcvt.3:77
1869 msgid ""
1870 "The B<gcvt>()  function returns the address of the string pointed to by "
1871 "I<buf>."
1872 msgstr ""
1873
1874 #. type: Plain text
1875 #: build/C/man3/gcvt.3:86
1876 msgid ""
1877 "Marked as LEGACY in POSIX.1-2001.  POSIX.1-2008 removes the specification of "
1878 "B<gcvt>(), recommending the use of B<sprintf>(3)  instead (though "
1879 "B<snprintf>(3)  may be preferable)."
1880 msgstr ""
1881
1882 #. type: Plain text
1883 #: build/C/man3/gcvt.3:90
1884 msgid "B<ecvt>(3), B<fcvt>(3), B<sprintf>(3)"
1885 msgstr ""
1886
1887 #. type: TH
1888 #: build/C/man3/getauxval.3:27
1889 #, no-wrap
1890 msgid "GETAUXVAL"
1891 msgstr ""
1892
1893 #. type: TH
1894 #: build/C/man3/getauxval.3:27
1895 #, no-wrap
1896 msgid "2012-11-07"
1897 msgstr ""
1898
1899 #. type: Plain text
1900 #: build/C/man3/getauxval.3:30
1901 msgid "getauxval - retrieve a value from the auxiliary vector"
1902 msgstr ""
1903
1904 #. type: Plain text
1905 #: build/C/man3/getauxval.3:33
1906 #, no-wrap
1907 msgid "B<#include E<lt>sys/auxv.hE<gt>>\n"
1908 msgstr ""
1909
1910 #. type: Plain text
1911 #: build/C/man3/getauxval.3:35
1912 #, no-wrap
1913 msgid "B<unsigned long getauxval(unsigned long >I<type>B<);>\n"
1914 msgstr ""
1915
1916 #. type: Plain text
1917 #: build/C/man3/getauxval.3:43
1918 msgid ""
1919 "The B<getauxval>()  function retrieves values from the auxiliary vector, a "
1920 "mechanism that the kernel's ELF binary loader uses to pass certain "
1921 "information to user space when a program is executed."
1922 msgstr ""
1923
1924 #. type: Plain text
1925 #: build/C/man3/getauxval.3:51
1926 msgid ""
1927 "Each entry in the auxiliary vector consists of a pair of values: a type that "
1928 "identifies what this entry represents, and a value for that type.  Given the "
1929 "argument I<type>, B<getauxval>()  returns the corresponding value."
1930 msgstr ""
1931
1932 #. type: Plain text
1933 #: build/C/man3/getauxval.3:58
1934 msgid ""
1935 "The value returned for each I<type> is given in the following list.  Not all "
1936 "I<type> values are present on all architectures."
1937 msgstr ""
1938
1939 #. type: TP
1940 #: build/C/man3/getauxval.3:58
1941 #, no-wrap
1942 msgid "B<AT_BASE>"
1943 msgstr ""
1944
1945 #. type: Plain text
1946 #: build/C/man3/getauxval.3:61
1947 msgid "The base address of the program interpreter (usually, the dynamic linker)."
1948 msgstr ""
1949
1950 #. type: TP
1951 #: build/C/man3/getauxval.3:61
1952 #, no-wrap
1953 msgid "B<AT_BASE_PLATFORM>"
1954 msgstr ""
1955
1956 #. type: Plain text
1957 #: build/C/man3/getauxval.3:66
1958 msgid ""
1959 "A string identifying the real platform; may differ from B<AT_PLATFORM> "
1960 "(PowerPC only)."
1961 msgstr ""
1962
1963 #. type: TP
1964 #: build/C/man3/getauxval.3:66
1965 #, no-wrap
1966 msgid "B<AT_CLKTCK>"
1967 msgstr ""
1968
1969 #. type: Plain text
1970 #: build/C/man3/getauxval.3:73
1971 msgid ""
1972 "The frequency with which B<times>(2)  counts.  This value can also be "
1973 "obtained via I<sysconf(_SC_CLK_TCK)>."
1974 msgstr ""
1975
1976 #. type: TP
1977 #: build/C/man3/getauxval.3:73
1978 #, no-wrap
1979 msgid "B<AT_DCACHEBSIZE>"
1980 msgstr ""
1981
1982 #. type: Plain text
1983 #: build/C/man3/getauxval.3:76
1984 msgid "The data cache block size."
1985 msgstr ""
1986
1987 #. type: TP
1988 #: build/C/man3/getauxval.3:76
1989 #, no-wrap
1990 msgid "B<AT_EGID>"
1991 msgstr ""
1992
1993 #. type: Plain text
1994 #: build/C/man3/getauxval.3:79
1995 msgid "The effective group ID of the thread."
1996 msgstr ""
1997
1998 #. type: TP
1999 #: build/C/man3/getauxval.3:79
2000 #, no-wrap
2001 msgid "B<AT_ENTRY>"
2002 msgstr ""
2003
2004 #. type: Plain text
2005 #: build/C/man3/getauxval.3:82
2006 msgid "The entry address of the executable."
2007 msgstr ""
2008
2009 #. type: TP
2010 #: build/C/man3/getauxval.3:82
2011 #, no-wrap
2012 msgid "B<AT_EUID>"
2013 msgstr ""
2014
2015 #. type: Plain text
2016 #: build/C/man3/getauxval.3:85
2017 msgid "The effective user ID of the thread."
2018 msgstr ""
2019
2020 #. type: TP
2021 #: build/C/man3/getauxval.3:85
2022 #, no-wrap
2023 msgid "B<AT_EXECFD>"
2024 msgstr ""
2025
2026 #. type: Plain text
2027 #: build/C/man3/getauxval.3:88
2028 msgid "File descriptor of program."
2029 msgstr ""
2030
2031 #. type: TP
2032 #: build/C/man3/getauxval.3:88
2033 #, no-wrap
2034 msgid "B<AT_EXECFN>"
2035 msgstr ""
2036
2037 #. type: Plain text
2038 #: build/C/man3/getauxval.3:91
2039 msgid "Pathname used to execute program."
2040 msgstr ""
2041
2042 #. type: TP
2043 #: build/C/man3/getauxval.3:91
2044 #, no-wrap
2045 msgid "B<AT_FLAGS>"
2046 msgstr ""
2047
2048 #. type: Plain text
2049 #: build/C/man3/getauxval.3:94
2050 msgid "Flags (unused)."
2051 msgstr ""
2052
2053 #. type: TP
2054 #: build/C/man3/getauxval.3:94
2055 #, no-wrap
2056 msgid "B<AT_FPUCW>"
2057 msgstr ""
2058
2059 #. type: Plain text
2060 #: build/C/man3/getauxval.3:99
2061 msgid ""
2062 "Used FPU control word (SuperH architecture only).  This gives some "
2063 "information about the FPU initialization performed by the kernel."
2064 msgstr ""
2065
2066 #. type: TP
2067 #: build/C/man3/getauxval.3:99
2068 #, no-wrap
2069 msgid "B<AT_GID>"
2070 msgstr ""
2071
2072 #. type: Plain text
2073 #: build/C/man3/getauxval.3:102
2074 msgid "The real group ID of the thread."
2075 msgstr ""
2076
2077 #. type: TP
2078 #: build/C/man3/getauxval.3:102
2079 #, no-wrap
2080 msgid "B<AT_HWCAP>"
2081 msgstr ""
2082
2083 #. type: Plain text
2084 #: build/C/man3/getauxval.3:112
2085 msgid ""
2086 "A pointer to a multibyte mask of bits whose settings indicate detailed "
2087 "processor capabilities.  The contents of the bit mask are hardware dependent "
2088 "(for example, see the kernel source file "
2089 "I<arch/x86/include/asm/cpufeature.h> for details relating to the Intel x86 "
2090 "architecture).  A human-readable version of the same information is "
2091 "available via I</proc/cpuinfo>."
2092 msgstr ""
2093
2094 #. type: TP
2095 #: build/C/man3/getauxval.3:112
2096 #, no-wrap
2097 msgid "B<AT_ICACHEBSIZE>"
2098 msgstr ""
2099
2100 #.  .TP
2101 #.  .BR AT_IGNORE
2102 #.  .TP
2103 #.  .BR AT_IGNOREPPC
2104 #.  .TP
2105 #.  .BR AT_NOTELF
2106 #. type: Plain text
2107 #: build/C/man3/getauxval.3:121
2108 msgid "The instruction cache block size."
2109 msgstr ""
2110
2111 #. type: TP
2112 #: build/C/man3/getauxval.3:121
2113 #, no-wrap
2114 msgid "B<AT_PAGESZ>"
2115 msgstr ""
2116
2117 #. type: Plain text
2118 #: build/C/man3/getauxval.3:125
2119 msgid "The system page size (the same value returned by I<sysconf(_SC_PAGESIZE)>)."
2120 msgstr ""
2121
2122 #. type: TP
2123 #: build/C/man3/getauxval.3:125
2124 #, no-wrap
2125 msgid "B<AT_PHDR>"
2126 msgstr ""
2127
2128 #. type: Plain text
2129 #: build/C/man3/getauxval.3:128
2130 msgid "The address of the program headers of the executable."
2131 msgstr ""
2132
2133 #. type: TP
2134 #: build/C/man3/getauxval.3:128
2135 #, no-wrap
2136 msgid "B<AT_PHENT>"
2137 msgstr ""
2138
2139 #. type: Plain text
2140 #: build/C/man3/getauxval.3:131
2141 msgid "The size of program header entry."
2142 msgstr ""
2143
2144 #. type: TP
2145 #: build/C/man3/getauxval.3:131
2146 #, no-wrap
2147 msgid "B<AT_PHNUM>"
2148 msgstr ""
2149
2150 #. type: Plain text
2151 #: build/C/man3/getauxval.3:134
2152 msgid "The number of program headers."
2153 msgstr ""
2154
2155 #. type: TP
2156 #: build/C/man3/getauxval.3:134
2157 #, no-wrap
2158 msgid "B<AT_PLATFORM>"
2159 msgstr ""
2160
2161 #. type: Plain text
2162 #: build/C/man3/getauxval.3:141
2163 msgid ""
2164 "A pointer to a string that identifies the hardware platform that the program "
2165 "is running on.  The dynamic linker uses this in the interpretation of "
2166 "I<rpath> values."
2167 msgstr ""
2168
2169 #. type: TP
2170 #: build/C/man3/getauxval.3:141
2171 #, no-wrap
2172 msgid "B<AT_RANDOM>"
2173 msgstr ""
2174
2175 #. type: Plain text
2176 #: build/C/man3/getauxval.3:144
2177 msgid "The address of sixteen bytes containing a random value."
2178 msgstr ""
2179
2180 #. type: TP
2181 #: build/C/man3/getauxval.3:144
2182 #, no-wrap
2183 msgid "B<AT_SECURE>"
2184 msgstr ""
2185
2186 #. type: Plain text
2187 #: build/C/man3/getauxval.3:156
2188 msgid ""
2189 "Has a nonzero value if this executable should be treated securely.  Most "
2190 "commonly, a nonzero value indicates that the process is executing a "
2191 "set-user-ID or set-group-ID program; alternatively, a nonzero value may be "
2192 "triggered by a Linux Security Module.  When this value is nonzero, the "
2193 "dynamic linker disables the use of certain environment variables (see "
2194 "B<ld-linux.so>(8))  and glibc changes other aspects of its behavior.  (See "
2195 "also B<secure_getenv>(3).)"
2196 msgstr ""
2197
2198 #. type: TP
2199 #: build/C/man3/getauxval.3:156
2200 #, no-wrap
2201 msgid "B<AT_SYSINFO>"
2202 msgstr ""
2203
2204 #. type: Plain text
2205 #: build/C/man3/getauxval.3:160
2206 msgid ""
2207 "The entry point to the system call function in the VDSO.  Not present/needed "
2208 "on all architectures (e.g., absent on x86-64)."
2209 msgstr ""
2210
2211 #. type: TP
2212 #: build/C/man3/getauxval.3:160
2213 #, no-wrap
2214 msgid "B<AT_SYSINFO_EHDR>"
2215 msgstr ""
2216
2217 #. type: Plain text
2218 #: build/C/man3/getauxval.3:165
2219 msgid ""
2220 "The address of a page containing the Virtual Dynamic Shared Object (VDSO)  "
2221 "that the kernel creates in order to provide fast implementations of certain "
2222 "system calls."
2223 msgstr ""
2224
2225 #. type: TP
2226 #: build/C/man3/getauxval.3:165
2227 #, no-wrap
2228 msgid "B<AT_UCACHEBSIZE>"
2229 msgstr ""
2230
2231 #. type: Plain text
2232 #: build/C/man3/getauxval.3:168
2233 msgid "The unified cache block size."
2234 msgstr ""
2235
2236 #. type: TP
2237 #: build/C/man3/getauxval.3:168
2238 #, no-wrap
2239 msgid "B<AT_UID>"
2240 msgstr ""
2241
2242 #. type: Plain text
2243 #: build/C/man3/getauxval.3:171
2244 msgid "The real user ID of the thread."
2245 msgstr ""
2246
2247 #. type: Plain text
2248 #: build/C/man3/getauxval.3:179
2249 msgid ""
2250 "On success, B<getauxval>()  returns the value corresponding to I<type>.  If "
2251 "I<type> is not found, 0 is returned."
2252 msgstr ""
2253
2254 #. type: Plain text
2255 #: build/C/man3/getauxval.3:181
2256 msgid "No errors are diagnosed."
2257 msgstr ""
2258
2259 #. type: Plain text
2260 #: build/C/man3/getauxval.3:185
2261 msgid "The B<getauxval>()  function was added to glibc in version 2.16."
2262 msgstr ""
2263
2264 #. type: Plain text
2265 #: build/C/man3/getauxval.3:187
2266 msgid "This function is a nonstandard glibc extension."
2267 msgstr ""
2268
2269 #. type: Plain text
2270 #: build/C/man3/getauxval.3:196
2271 msgid ""
2272 "The primary consumer of the information in the auxiliary vector is the "
2273 "dynamic linker B<ld-linux.so>(8).  The auxiliary vector is a convenient and "
2274 "efficient shortcut that allows the kernel to communicate a certain set of "
2275 "standard information that the dynamic linker usually or always needs.  In "
2276 "some cases, the same information could be obtained by system calls, but "
2277 "using the auxiliary vector is cheaper."
2278 msgstr ""
2279
2280 #. type: Plain text
2281 #: build/C/man3/getauxval.3:202
2282 msgid ""
2283 "The auxiliary vector resides just above the argument list and environment in "
2284 "the process address space.  The auxiliary vector supplied to a program can "
2285 "be viewed by setting the B<LD_SHOW_AUXV> environment variable when running a "
2286 "program:"
2287 msgstr ""
2288
2289 #. type: Plain text
2290 #: build/C/man3/getauxval.3:204
2291 #, no-wrap
2292 msgid "    $ LD_SHOW_AUXV=1 sleep 1\n"
2293 msgstr ""
2294
2295 #. type: Plain text
2296 #: build/C/man3/getauxval.3:211
2297 msgid ""
2298 "The auxiliary vector of any process can (subject to file permissions)  be "
2299 "obtained via I</proc/PID/auxv>; see B<proc>(5)  for more information."
2300 msgstr ""
2301
2302 #. type: Plain text
2303 #: build/C/man3/getauxval.3:214
2304 msgid "B<secure_getenv>(3), B<ld-linux.so>(8)"
2305 msgstr ""
2306
2307 #. type: Plain text
2308 #: build/C/man3/getauxval.3:217
2309 msgid "The kernel source file I<Documentation/ABI/stable/vdso>"
2310 msgstr ""
2311
2312 #. type: TH
2313 #: build/C/man3/getenv.3:33
2314 #, no-wrap
2315 msgid "GETENV"
2316 msgstr ""
2317
2318 #. type: TH
2319 #: build/C/man3/getenv.3:33
2320 #, no-wrap
2321 msgid "2012-08-14"
2322 msgstr ""
2323
2324 #. type: Plain text
2325 #: build/C/man3/getenv.3:36
2326 msgid "getenv, secure_getenv - get an environment variable"
2327 msgstr ""
2328
2329 #. type: Plain text
2330 #: build/C/man3/getenv.3:41
2331 #, no-wrap
2332 msgid "B<char *getenv(const char *>I<name>B<);>\n"
2333 msgstr ""
2334
2335 #. type: Plain text
2336 #: build/C/man3/getenv.3:43
2337 #, no-wrap
2338 msgid "B<char *secure_getenv(const char *>I<name>B<);>\n"
2339 msgstr ""
2340
2341 #. type: Plain text
2342 #: build/C/man3/getenv.3:52
2343 msgid "B<secure_getenv>(): _GNU_SOURCE"
2344 msgstr ""
2345
2346 #. type: Plain text
2347 #: build/C/man3/getenv.3:61
2348 msgid ""
2349 "The B<getenv>()  function searches the environment list to find the "
2350 "environment variable I<name>, and returns a pointer to the corresponding "
2351 "I<value> string."
2352 msgstr ""
2353
2354 #. type: Plain text
2355 #: build/C/man3/getenv.3:69
2356 msgid ""
2357 "The GNU-specific B<secure_getenv>()  function is just like B<getenv>()  "
2358 "except that it returns NULL in cases where \"secure execution\" is "
2359 "required.  Secure execution is required if one of the following conditions "
2360 "was true when the program run by the calling process was loaded:"
2361 msgstr ""
2362
2363 #. type: IP
2364 #: build/C/man3/getenv.3:69 build/C/man3/getenv.3:74 build/C/man3/getenv.3:76
2365 #, no-wrap
2366 msgid "*"
2367 msgstr ""
2368
2369 #. type: Plain text
2370 #: build/C/man3/getenv.3:74
2371 msgid ""
2372 "the process's effective user ID did not match its real user ID or the "
2373 "process's effective group ID did not match its real group ID (typically this "
2374 "is the result of executing a set-user-ID or set-group-ID program);"
2375 msgstr ""
2376
2377 #. type: Plain text
2378 #: build/C/man3/getenv.3:76
2379 msgid "the effective capability bit was set on the executable file; or"
2380 msgstr ""
2381
2382 #. type: Plain text
2383 #: build/C/man3/getenv.3:78
2384 msgid "the process has a nonempty permitted capability set."
2385 msgstr ""
2386
2387 #. type: Plain text
2388 #: build/C/man3/getenv.3:81
2389 msgid ""
2390 "Secure execution may also required if triggered by some Linux security "
2391 "modules."
2392 msgstr ""
2393
2394 #. type: Plain text
2395 #: build/C/man3/getenv.3:88
2396 msgid ""
2397 "The B<secure_getenv>()  function is intended for use in general-purpose "
2398 "libraries to avoid vulnerabilities that could occur if set-user-ID or "
2399 "set-group-ID programs accidentally trusted the environment."
2400 msgstr ""
2401
2402 #. type: Plain text
2403 #: build/C/man3/getenv.3:93
2404 msgid ""
2405 "The B<getenv>()  function returns a pointer to the value in the environment, "
2406 "or NULL if there is no match."
2407 msgstr ""
2408
2409 #. type: Plain text
2410 #: build/C/man3/getenv.3:96
2411 msgid "B<secure_getenv>()  first appeared in glibc 2.17."
2412 msgstr ""
2413
2414 #. type: Plain text
2415 #: build/C/man3/getenv.3:99
2416 msgid "B<getenv>(): SVr4, POSIX.1-2001, 4.3BSD, C89, C99."
2417 msgstr ""
2418
2419 #. type: Plain text
2420 #: build/C/man3/getenv.3:102
2421 msgid "B<secure_getenv>()  is a GNU extension."
2422 msgstr ""
2423
2424 #. type: Plain text
2425 #: build/C/man3/getenv.3:104
2426 msgid "The strings in the environment list are of the form I<name=value>."
2427 msgstr ""
2428
2429 #. type: Plain text
2430 #: build/C/man3/getenv.3:110
2431 msgid ""
2432 "As typically implemented, B<getenv>()  returns a pointer to a string within "
2433 "the environment list.  The caller must take care not to modify this string, "
2434 "since that would change the environment of the process."
2435 msgstr ""
2436
2437 #. type: Plain text
2438 #: build/C/man3/getenv.3:123
2439 msgid ""
2440 "The implementation of B<getenv>()  is not required to be reentrant.  The "
2441 "string pointed to by the return value of B<getenv>()  may be statically "
2442 "allocated, and can be modified by a subsequent call to B<getenv>(), "
2443 "B<putenv>(3), B<setenv>(3), or B<unsetenv>(3)."
2444 msgstr ""
2445
2446 #. type: Plain text
2447 #: build/C/man3/getenv.3:129
2448 msgid ""
2449 "The \"secure execution\" mode of B<secure_getenv>()  is controlled by the "
2450 "B<AT_SECURE> flag contained in the auxiliary vector passed from the kernel "
2451 "to user space."
2452 msgstr ""
2453
2454 #. type: Plain text
2455 #: build/C/man3/getenv.3:137
2456 msgid ""
2457 "B<clearenv>(3), B<getauxval>(3), B<putenv>(3), B<setenv>(3), B<unsetenv>(3), "
2458 "B<capabilities>(7), B<environ>(7)"
2459 msgstr ""
2460
2461 #. type: TH
2462 #: build/C/man3/getloadavg.3:34
2463 #, no-wrap
2464 msgid "GETLOADAVG"
2465 msgstr ""
2466
2467 #. type: TH
2468 #: build/C/man3/getloadavg.3:34
2469 #, no-wrap
2470 msgid "2007-12-08"
2471 msgstr ""
2472
2473 #. type: Plain text
2474 #: build/C/man3/getloadavg.3:37
2475 msgid "getloadavg - get system load averages"
2476 msgstr ""
2477
2478 #. type: Plain text
2479 #: build/C/man3/getloadavg.3:41
2480 #, no-wrap
2481 msgid ""
2482 "B<#define _BSD_SOURCE>         /* See feature_test_macros(7) */\n"
2483 "B<#include E<lt>stdlib.hE<gt>>\n"
2484 msgstr ""
2485
2486 #. type: Plain text
2487 #: build/C/man3/getloadavg.3:43
2488 #, no-wrap
2489 msgid "B<int getloadavg(double >I<loadavg[]>B<, int >I<nelem>B<);>\n"
2490 msgstr ""
2491
2492 #. type: Plain text
2493 #: build/C/man3/getloadavg.3:55
2494 msgid ""
2495 "The B<getloadavg>()  function returns the number of processes in the system "
2496 "run queue averaged over various periods of time.  Up to I<nelem> samples are "
2497 "retrieved and assigned to successive elements of I<loadavg>[].  The system "
2498 "imposes a maximum of 3 samples, representing averages over the last 1, 5, "
2499 "and 15 minutes, respectively."
2500 msgstr ""
2501
2502 #.  .SH HISTORY
2503 #.  The
2504 #.  BR getloadavg ()
2505 #.  function appeared in
2506 #.  4.3BSD Reno .
2507 #. type: Plain text
2508 #: build/C/man3/getloadavg.3:63
2509 msgid ""
2510 "If the load average was unobtainable, -1 is returned; otherwise, the number "
2511 "of samples actually retrieved is returned."
2512 msgstr ""
2513
2514 #. type: Plain text
2515 #: build/C/man3/getloadavg.3:65
2516 msgid "This function is available in glibc since version 2.2."
2517 msgstr ""
2518
2519 #.  mdoc seems to have a bug - there must be no newline here
2520 #. type: Plain text
2521 #: build/C/man3/getloadavg.3:69
2522 msgid "Not in POSIX.1-2001.  Present on the BSDs and Solaris."
2523 msgstr ""
2524
2525 #. type: Plain text
2526 #: build/C/man3/getloadavg.3:72
2527 msgid "B<uptime>(1), B<proc>(5)"
2528 msgstr ""
2529
2530 #. type: TH
2531 #: build/C/man3/getsubopt.3:25
2532 #, no-wrap
2533 msgid "GETSUBOPT"
2534 msgstr ""
2535
2536 #. type: TH
2537 #: build/C/man3/getsubopt.3:25 build/C/man3/mkdtemp.3:26
2538 #, no-wrap
2539 msgid "2010-09-26"
2540 msgstr ""
2541
2542 #. type: Plain text
2543 #: build/C/man3/getsubopt.3:28
2544 msgid "getsubopt - parse suboption arguments from a string"
2545 msgstr ""
2546
2547 #. type: Plain text
2548 #: build/C/man3/getsubopt.3:33
2549 msgid ""
2550 "B<int getsubopt(char **>I<optionp>B<, char * const *>I<tokens>B<, char "
2551 "**>I<valuep>B<);>"
2552 msgstr ""
2553
2554 #. type: Plain text
2555 #: build/C/man3/getsubopt.3:40
2556 msgid "B<getsubopt>():"
2557 msgstr ""
2558
2559 #. type: Plain text
2560 #: build/C/man3/getsubopt.3:45
2561 msgid "_XOPEN_SOURCE\\ E<gt>= 500 || _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
2562 msgstr ""
2563
2564 #. type: Plain text
2565 #: build/C/man3/getsubopt.3:47
2566 msgid "|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
2567 msgstr ""
2568
2569 #. type: Plain text
2570 #: build/C/man3/getsubopt.3:64
2571 msgid ""
2572 "B<getsubopt>()  parses the list of comma-separated suboptions provided in "
2573 "I<optionp>.  (Such a suboption list is typically produced when B<getopt>(3)  "
2574 "is used to parse a command line; see for example the I<-o> option of "
2575 "B<mount>(8).)  Each suboption may include an associated value, which is "
2576 "separated from the suboption name by an equal sign.  The following is an "
2577 "example of the kind of string that might be passed in I<optionp>:"
2578 msgstr ""
2579
2580 #. type: Plain text
2581 #: build/C/man3/getsubopt.3:67
2582 msgid "B<ro,name=xyz>"
2583 msgstr ""
2584
2585 #. type: Plain text
2586 #: build/C/man3/getsubopt.3:77
2587 msgid ""
2588 "The I<tokens> argument is a pointer to a NULL-terminated array of pointers "
2589 "to the tokens that B<getsubopt>()  will look for in I<optionp>.  The tokens "
2590 "should be distinct, null-terminated strings containing at least one "
2591 "character, with no embedded equal signs or commas."
2592 msgstr ""
2593
2594 #. type: Plain text
2595 #: build/C/man3/getsubopt.3:98
2596 msgid ""
2597 "Each call to B<getsubopt>()  returns information about the next unprocessed "
2598 "suboption in I<optionp>.  The first equal sign in a suboption (if any) is "
2599 "interpreted as a separator between the name and the value of that "
2600 "suboption.  The value extends to the next comma, or (for the last suboption) "
2601 "to the end of the string.  If the name of the suboption matches a known name "
2602 "from I<tokens>, and a value string was found, B<getsubopt>()  sets "
2603 "I<*valuep> to the address of that string.  The first comma in I<optionp> is "
2604 "overwritten with a null byte, so I<*valuep> is precisely the \"value "
2605 "string\" for that suboption."
2606 msgstr ""
2607
2608 #. type: Plain text
2609 #: build/C/man3/getsubopt.3:102
2610 msgid ""
2611 "If the suboption is recognized, but no value string was found, I<*valuep> is "
2612 "set to NULL."
2613 msgstr ""
2614
2615 #. type: Plain text
2616 #: build/C/man3/getsubopt.3:110
2617 msgid ""
2618 "When B<getsubopt>()  returns, I<optionp> points to the next suboption, or to "
2619 "the null byte (\\(aq\\e0\\(aq) at the end of the string if the last "
2620 "suboption was just processed."
2621 msgstr ""
2622
2623 #. type: Plain text
2624 #: build/C/man3/getsubopt.3:122
2625 msgid ""
2626 "If the first suboption in I<optionp> is recognized, B<getsubopt>()  returns "
2627 "the index of the matching suboption element in I<tokens>.  Otherwise, -1 is "
2628 "returned and I<*valuep> is the entire I<name>B<[=>I<value>B<]> string."
2629 msgstr ""
2630
2631 #. type: Plain text
2632 #: build/C/man3/getsubopt.3:129
2633 msgid ""
2634 "Since I<*optionp> is changed, the first suboption before the call to "
2635 "B<getsubopt>()  is not (necessarily) the same as the first suboption after "
2636 "B<getsubopt>()."
2637 msgstr ""
2638
2639 #. type: Plain text
2640 #: build/C/man3/getsubopt.3:138
2641 msgid ""
2642 "Since B<getsubopt>()  overwrites any commas it finds in the string "
2643 "I<*optionp>, that string must be writable; it cannot be a string constant."
2644 msgstr ""
2645
2646 #. type: Plain text
2647 #: build/C/man3/getsubopt.3:140
2648 msgid "The following program expects suboptions following a \"-o\" option."
2649 msgstr ""
2650
2651 #. type: Plain text
2652 #: build/C/man3/getsubopt.3:146
2653 #, no-wrap
2654 msgid ""
2655 "#define _XOPEN_SOURCE 500\n"
2656 "#include E<lt>stdlib.hE<gt>\n"
2657 "#include E<lt>assert.hE<gt>\n"
2658 "#include E<lt>stdio.hE<gt>\n"
2659 msgstr ""
2660
2661 #. type: Plain text
2662 #: build/C/man3/getsubopt.3:163
2663 #, no-wrap
2664 msgid ""
2665 "int main(int argc, char **argv)\n"
2666 "{\n"
2667 "    enum {\n"
2668 "        RO_OPT = 0,\n"
2669 "        RW_OPT,\n"
2670 "        NAME_OPT\n"
2671 "    };\n"
2672 "    char *const token[] = {\n"
2673 "        [RO_OPT]   = \"ro\",\n"
2674 "        [RW_OPT]   = \"rw\",\n"
2675 "        [NAME_OPT] = \"name\",\n"
2676 "        NULL\n"
2677 "    };\n"
2678 "    char *subopts;\n"
2679 "    char *value;\n"
2680 "    int opt;\n"
2681 msgstr ""
2682
2683 #. type: Plain text
2684 #: build/C/man3/getsubopt.3:168
2685 #, no-wrap
2686 msgid ""
2687 "    int readonly = 0;\n"
2688 "    int readwrite = 0;\n"
2689 "    char *name = NULL;\n"
2690 "    int errfnd = 0;\n"
2691 msgstr ""
2692
2693 #. type: Plain text
2694 #: build/C/man3/getsubopt.3:174
2695 #, no-wrap
2696 msgid ""
2697 "    while ((opt = getopt(argc, argv, \"o:\")) != -1) {\n"
2698 "        switch (opt) {\n"
2699 "        case \\(aqo\\(aq:\n"
2700 "            subopts = optarg;\n"
2701 "            while (*subopts != \\(aq\\e0\\(aq && !errfnd) {\n"
2702 msgstr ""
2703
2704 #. type: Plain text
2705 #: build/C/man3/getsubopt.3:179
2706 #, no-wrap
2707 msgid ""
2708 "            switch (getsubopt(&subopts, token, &value)) {\n"
2709 "            case RO_OPT:\n"
2710 "                readonly = 1;\n"
2711 "                break;\n"
2712 msgstr ""
2713
2714 #. type: Plain text
2715 #: build/C/man3/getsubopt.3:183
2716 #, no-wrap
2717 msgid ""
2718 "            case RW_OPT:\n"
2719 "                readwrite = 1;\n"
2720 "                break;\n"
2721 msgstr ""
2722
2723 #. type: Plain text
2724 #: build/C/man3/getsubopt.3:191
2725 #, no-wrap
2726 msgid ""
2727 "            case NAME_OPT:\n"
2728 "                if (value == NULL) {\n"
2729 "                    fprintf(stderr, \"Missing value for \"\n"
2730 "                            \"suboption \\(aq%s\\(aq\\en\", "
2731 "token[NAME_OPT]);\n"
2732 "                    errfnd = 1;\n"
2733 "                    continue;\n"
2734 "                }\n"
2735 msgstr ""
2736
2737 #. type: Plain text
2738 #: build/C/man3/getsubopt.3:194
2739 #, no-wrap
2740 msgid ""
2741 "                name = value;\n"
2742 "                break;\n"
2743 msgstr ""
2744
2745 #. type: Plain text
2746 #: build/C/man3/getsubopt.3:208
2747 #, no-wrap
2748 msgid ""
2749 "            default:\n"
2750 "                fprintf(stderr, \"No match found \"\n"
2751 "                        \"for token: /%s/\\en\", value);\n"
2752 "                errfnd = 1;\n"
2753 "                break;\n"
2754 "            }\n"
2755 "        }\n"
2756 "        if (readwrite && readonly) {\n"
2757 "            fprintf(stderr, \"Only one of \\(aq%s\\(aq and \\(aq%s\\(aq can "
2758 "be \"\n"
2759 "                    \"specified\\en\", token[RO_OPT], token[RW_OPT]);\n"
2760 "            errfnd = 1;\n"
2761 "        }\n"
2762 "        break;\n"
2763 msgstr ""
2764
2765 #. type: Plain text
2766 #: build/C/man3/getsubopt.3:213
2767 #, no-wrap
2768 msgid ""
2769 "        default:\n"
2770 "            errfnd = 1;\n"
2771 "        }\n"
2772 "    }\n"
2773 msgstr ""
2774
2775 #. type: Plain text
2776 #: build/C/man3/getsubopt.3:220
2777 #, no-wrap
2778 msgid ""
2779 "    if (errfnd || argc == 1) {\n"
2780 "        fprintf(stderr, \"\\enUsage: %s -o E<lt>suboptstringE<gt>\\en\", "
2781 "argv[0]);\n"
2782 "        fprintf(stderr, \"suboptions are \\(aqro\\(aq, \\(aqrw\\(aq, \"\n"
2783 "                \"and \\(aqname=E<lt>valueE<gt>\\(aq\\en\");\n"
2784 "        exit(EXIT_FAILURE);\n"
2785 "    }\n"
2786 msgstr ""
2787
2788 #. type: Plain text
2789 #: build/C/man3/getsubopt.3:222
2790 #, no-wrap
2791 msgid "    /* Remainder of program... */\n"
2792 msgstr ""
2793
2794 #. type: Plain text
2795 #: build/C/man3/getsubopt.3:228
2796 msgid "B<getopt>(3)"
2797 msgstr ""
2798
2799 #. type: TH
2800 #: build/C/man3/malloc.3:30
2801 #, no-wrap
2802 msgid "MALLOC"
2803 msgstr ""
2804
2805 #. type: TH
2806 #: build/C/man3/malloc.3:30
2807 #, no-wrap
2808 msgid "2012-05-10"
2809 msgstr ""
2810
2811 #. type: Plain text
2812 #: build/C/man3/malloc.3:33
2813 msgid "malloc, free, calloc, realloc - allocate and free dynamic memory"
2814 msgstr ""
2815
2816 #. type: Plain text
2817 #: build/C/man3/malloc.3:41
2818 #, no-wrap
2819 msgid ""
2820 "B<void *malloc(size_t >I<size>B<);>\n"
2821 "B<void free(void >I<*ptr>B<);>\n"
2822 "B<void *calloc(size_t >I<nmemb>B<, size_t >I<size>B<);>\n"
2823 "B<void *realloc(void >I<*ptr>B<, size_t >I<size>B<);>\n"
2824 msgstr ""
2825
2826 #.  glibc does this:
2827 #. type: Plain text
2828 #: build/C/man3/malloc.3:58
2829 msgid ""
2830 "The B<malloc>()  function allocates I<size> bytes and returns a pointer to "
2831 "the allocated memory.  I<The memory is not initialized>.  If I<size> is 0, "
2832 "then B<malloc>()  returns either NULL, or a unique pointer value that can "
2833 "later be successfully passed to B<free>()."
2834 msgstr ""
2835
2836 #. type: Plain text
2837 #: build/C/man3/malloc.3:74
2838 msgid ""
2839 "The B<free>()  function frees the memory space pointed to by I<ptr>, which "
2840 "must have been returned by a previous call to B<malloc>(), B<calloc>()  or "
2841 "B<realloc>().  Otherwise, or if I<free(ptr)> has already been called before, "
2842 "undefined behavior occurs.  If I<ptr> is NULL, no operation is performed."
2843 msgstr ""
2844
2845 #.  glibc does this:
2846 #. type: Plain text
2847 #: build/C/man3/malloc.3:93
2848 msgid ""
2849 "The B<calloc>()  function allocates memory for an array of I<nmemb> elements "
2850 "of I<size> bytes each and returns a pointer to the allocated memory.  The "
2851 "memory is set to zero.  If I<nmemb> or I<size> is 0, then B<calloc>()  "
2852 "returns either NULL, or a unique pointer value that can later be "
2853 "successfully passed to B<free>()."
2854 msgstr ""
2855
2856 #. type: Plain text
2857 #: build/C/man3/malloc.3:129
2858 msgid ""
2859 "The B<realloc>()  function changes the size of the memory block pointed to "
2860 "by I<ptr> to I<size> bytes.  The contents will be unchanged in the range "
2861 "from the start of the region up to the minimum of the old and new sizes.  If "
2862 "the new size is larger than the old size, the added memory will I<not> be "
2863 "initialized.  If I<ptr> is NULL, then the call is equivalent to "
2864 "I<malloc(size)>, for all values of I<size>; if I<size> is equal to zero, and "
2865 "I<ptr> is not NULL, then the call is equivalent to I<free(ptr)>.  Unless "
2866 "I<ptr> is NULL, it must have been returned by an earlier call to "
2867 "B<malloc>(), B<calloc>()  or B<realloc>().  If the area pointed to was "
2868 "moved, a I<free(ptr)> is done."
2869 msgstr ""
2870
2871 #. type: Plain text
2872 #: build/C/man3/malloc.3:149
2873 msgid ""
2874 "The B<malloc>()  and B<calloc>()  functions return a pointer to the "
2875 "allocated memory that is suitably aligned for any kind of variable.  On "
2876 "error, these functions return NULL.  NULL may also be returned by a "
2877 "successful call to B<malloc>()  with a I<size> of zero, or by a successful "
2878 "call to B<calloc>()  with I<nmemb> or I<size> equal to zero."
2879 msgstr ""
2880
2881 #. type: Plain text
2882 #: build/C/man3/malloc.3:153
2883 msgid "The B<free>()  function returns no value."
2884 msgstr ""
2885
2886 #. type: Plain text
2887 #: build/C/man3/malloc.3:168
2888 msgid ""
2889 "The B<realloc>()  function returns a pointer to the newly allocated memory, "
2890 "which is suitably aligned for any kind of variable and may be different from "
2891 "I<ptr>, or NULL if the request fails.  If I<size> was equal to 0, either "
2892 "NULL or a pointer suitable to be passed to B<free>()  is returned.  If "
2893 "B<realloc>()  fails the original block is left untouched; it is not freed or "
2894 "moved."
2895 msgstr ""
2896
2897 #. type: Plain text
2898 #: build/C/man3/malloc.3:170
2899 msgid "C89, C99."
2900 msgstr ""
2901
2902 #. type: Plain text
2903 #: build/C/man3/malloc.3:186
2904 msgid ""
2905 "By default, Linux follows an optimistic memory allocation strategy.  This "
2906 "means that when B<malloc>()  returns non-NULL there is no guarantee that the "
2907 "memory really is available.  In case it turns out that the system is out of "
2908 "memory, one or more processes will be killed by the OOM killer.  For more "
2909 "information, see the description of I</proc/sys/vm/overcommit_memory> and "
2910 "I</proc/sys/vm/oom_adj> in B<proc>(5), and the Linux kernel source file "
2911 "I<Documentation/vm/overcommit-accounting>."
2912 msgstr ""
2913
2914 #. type: Plain text
2915 #: build/C/man3/malloc.3:207
2916 msgid ""
2917 "Normally, B<malloc>()  allocates memory from the heap, and adjusts the size "
2918 "of the heap as required, using B<sbrk>(2).  When allocating blocks of memory "
2919 "larger than B<MMAP_THRESHOLD> bytes, the glibc B<malloc>()  implementation "
2920 "allocates the memory as a private anonymous mapping using B<mmap>(2).  "
2921 "B<MMAP_THRESHOLD> is 128 kB by default, but is adjustable using "
2922 "B<mallopt>(3).  Allocations performed using B<mmap>(2)  are unaffected by "
2923 "the B<RLIMIT_DATA> resource limit (see B<getrlimit>(2))."
2924 msgstr ""
2925
2926 #. type: Plain text
2927 #: build/C/man3/malloc.3:225
2928 msgid ""
2929 "To avoid corruption in multithreaded applications, mutexes are used "
2930 "internally to protect the memory-management data structures employed by "
2931 "these functions.  In a multithreaded application in which threads "
2932 "simultaneously allocate and free memory, there could be contention for these "
2933 "mutexes.  To scalably handle memory allocation in multithreaded "
2934 "applications, glibc creates additional I<memory allocation arenas> if mutex "
2935 "contention is detected.  Each arena is a large region of memory that is "
2936 "internally allocated by the system (using B<brk>(2)  or B<mmap>(2)), and "
2937 "managed with its own mutexes."
2938 msgstr ""
2939
2940 #. type: Plain text
2941 #: build/C/man3/malloc.3:243
2942 msgid ""
2943 "The UNIX 98 standard requires B<malloc>(), B<calloc>(), and B<realloc>()  to "
2944 "set I<errno> to B<ENOMEM> upon failure.  Glibc assumes that this is done "
2945 "(and the glibc versions of these routines do this); if you use a private "
2946 "malloc implementation that does not set I<errno>, then certain library "
2947 "routines may fail without having a reason in I<errno>."
2948 msgstr ""
2949
2950 #. type: Plain text
2951 #: build/C/man3/malloc.3:252
2952 msgid ""
2953 "Crashes in B<malloc>(), B<calloc>(), B<realloc>(), or B<free>()  are almost "
2954 "always related to heap corruption, such as overflowing an allocated chunk or "
2955 "freeing the same pointer twice."
2956 msgstr ""
2957
2958 #. type: Plain text
2959 #: build/C/man3/malloc.3:259
2960 msgid ""
2961 "Recent versions of Linux libc (later than 5.4.23) and glibc (2.x)  include a "
2962 "B<malloc>()  implementation which is tunable via environment variables.  For "
2963 "details, see B<mallopt>(3)."
2964 msgstr ""
2965
2966 #. type: Plain text
2967 #: build/C/man3/malloc.3:283
2968 msgid ""
2969 "B<brk>(2), B<mmap>(2), B<alloca>(3), B<malloc_get_state>(3), "
2970 "B<malloc_info>(3), B<malloc_trim>(3), B<malloc_usable_size>(3), "
2971 "B<mallopt>(3), B<mcheck>(3), B<mtrace>(3), B<posix_memalign>(3)"
2972 msgstr ""
2973
2974 #. type: TH
2975 #: build/C/man3/mblen.3:16
2976 #, no-wrap
2977 msgid "MBLEN"
2978 msgstr ""
2979
2980 #. type: Plain text
2981 #: build/C/man3/mblen.3:19
2982 msgid "mblen - determine number of bytes in next multibyte character"
2983 msgstr ""
2984
2985 #. type: Plain text
2986 #: build/C/man3/mblen.3:24
2987 #, no-wrap
2988 msgid "B<int mblen(const char *>I<s>B<, size_t >I<n>B<);>\n"
2989 msgstr ""
2990
2991 #. type: Plain text
2992 #: build/C/man3/mblen.3:43
2993 msgid ""
2994 "If I<s> is not a NULL pointer, the B<mblen>()  function inspects at most "
2995 "I<n> bytes of the multibyte string starting at I<s> and extracts the next "
2996 "complete multibyte character.  It uses a static anonymous shift state known "
2997 "only to the B<mblen>()  function.  If the multibyte character is not the "
2998 "null wide character, it returns the number of bytes that were consumed from "
2999 "I<s>.  If the multibyte character is the null wide character, it returns 0."
3000 msgstr ""
3001
3002 #. type: Plain text
3003 #: build/C/man3/mblen.3:57
3004 msgid ""
3005 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
3006 "character, B<mblen>()  returns -1.  This can happen even if I<n> is greater "
3007 "than or equal to I<MB_CUR_MAX>, if the multibyte string contains redundant "
3008 "shift sequences."
3009 msgstr ""
3010
3011 #. type: Plain text
3012 #: build/C/man3/mblen.3:64
3013 msgid ""
3014 "If the multibyte string starting at I<s> contains an invalid multibyte "
3015 "sequence before the next complete character, B<mblen>()  also returns -1."
3016 msgstr ""
3017
3018 #.  The Dinkumware doc and the Single UNIX specification say this, but
3019 #.  glibc doesn't implement this.
3020 #. type: Plain text
3021 #: build/C/man3/mblen.3:75
3022 msgid ""
3023 "If I<s> is a NULL pointer, the B<mblen>()  function resets the shift state, "
3024 "known to only this function, to the initial state, and returns nonzero if "
3025 "the encoding has nontrivial shift state, or zero if the encoding is "
3026 "stateless."
3027 msgstr ""
3028
3029 #. type: Plain text
3030 #: build/C/man3/mblen.3:87
3031 msgid ""
3032 "The B<mblen>()  function returns the number of bytes parsed from the "
3033 "multibyte sequence starting at I<s>, if a non-null wide character was "
3034 "recognized.  It returns 0, if a null wide character was recognized.  It "
3035 "returns -1, if an invalid multibyte sequence was encountered or if it "
3036 "couldn't parse a complete multibyte character."
3037 msgstr ""
3038
3039 #. type: Plain text
3040 #: build/C/man3/mblen.3:92
3041 msgid "The B<mblen>()  function is not thread-safe."
3042 msgstr ""
3043
3044 #. type: Plain text
3045 #: build/C/man3/mblen.3:94 build/C/man3/mbstowcs.3:95 build/C/man3/mbtowc.3:116 build/C/man3/wcstombs.3:90 build/C/man3/wctomb.3:86
3046 msgid "C99."
3047 msgstr ""
3048
3049 #. type: Plain text
3050 #: build/C/man3/mblen.3:101
3051 msgid ""
3052 "The behavior of B<mblen>()  depends on the B<LC_CTYPE> category of the "
3053 "current locale."
3054 msgstr ""
3055
3056 #. type: Plain text
3057 #: build/C/man3/mblen.3:106
3058 msgid ""
3059 "The function B<mbrlen>(3)  provides a better interface to the same "
3060 "functionality."
3061 msgstr ""
3062
3063 #. type: Plain text
3064 #: build/C/man3/mblen.3:108
3065 msgid "B<mbrlen>(3)"
3066 msgstr ""
3067
3068 #. type: TH
3069 #: build/C/man3/mbstowcs.3:16
3070 #, no-wrap
3071 msgid "MBSTOWCS"
3072 msgstr ""
3073
3074 #. type: TH
3075 #: build/C/man3/mbstowcs.3:16 build/C/man3/mbtowc.3:16
3076 #, no-wrap
3077 msgid "2011-09-28"
3078 msgstr ""
3079
3080 #. type: Plain text
3081 #: build/C/man3/mbstowcs.3:19
3082 msgid "mbstowcs - convert a multibyte string to a wide-character string"
3083 msgstr ""
3084
3085 #. type: Plain text
3086 #: build/C/man3/mbstowcs.3:24
3087 #, no-wrap
3088 msgid ""
3089 "B<size_t mbstowcs(wchar_t *>I<dest>B<, const char *>I<src>B<, size_t "
3090 ">I<n>B<);>\n"
3091 msgstr ""
3092
3093 #. type: Plain text
3094 #: build/C/man3/mbstowcs.3:43
3095 msgid ""
3096 "If I<dest> is not a NULL pointer, the B<mbstowcs>()  function converts the "
3097 "multibyte string I<src> to a wide-character string starting at I<dest>.  At "
3098 "most I<n> wide characters are written to I<dest>.  The conversion starts in "
3099 "the initial state.  The conversion can stop for three reasons:"
3100 msgstr ""
3101
3102 #. type: IP
3103 #: build/C/man3/mbstowcs.3:43
3104 #, no-wrap
3105 msgid "1."
3106 msgstr ""
3107
3108 #. type: Plain text
3109 #: build/C/man3/mbstowcs.3:48
3110 msgid ""
3111 "An invalid multibyte sequence has been encountered.  In this case "
3112 "I<(size_t)\\ -1> is returned."
3113 msgstr ""
3114
3115 #. type: IP
3116 #: build/C/man3/mbstowcs.3:48
3117 #, no-wrap
3118 msgid "2."
3119 msgstr ""
3120
3121 #. type: Plain text
3122 #: build/C/man3/mbstowcs.3:57
3123 msgid ""
3124 "I<n> non-L\\(aq\\e0\\(aq wide characters have been stored at I<dest>.  In "
3125 "this case the number of wide characters written to I<dest> is returned, but "
3126 "the shift state at this point is lost."
3127 msgstr ""
3128
3129 #. type: IP
3130 #: build/C/man3/mbstowcs.3:57
3131 #, no-wrap
3132 msgid "3."
3133 msgstr ""
3134
3135 #. type: Plain text
3136 #: build/C/man3/mbstowcs.3:63
3137 msgid ""
3138 "The multibyte string has been completely converted, including the "
3139 "terminating null wide character (\\(aq\\e0\\(aq).  In this case the number "
3140 "of wide characters written to I<dest>, excluding the terminating null wide "
3141 "character, is returned."
3142 msgstr ""
3143
3144 #. type: Plain text
3145 #: build/C/man3/mbstowcs.3:69
3146 msgid ""
3147 "The programmer must ensure that there is room for at least I<n> wide "
3148 "characters at I<dest>."
3149 msgstr ""
3150
3151 #. type: Plain text
3152 #: build/C/man3/mbstowcs.3:77
3153 msgid ""
3154 "If I<dest> is NULL, I<n> is ignored, and the conversion proceeds as above, "
3155 "except that the converted wide characters are not written out to memory, and "
3156 "that no length limit exists."
3157 msgstr ""
3158
3159 #. type: Plain text
3160 #: build/C/man3/mbstowcs.3:83
3161 msgid ""
3162 "In order to avoid the case 2 above, the programmer should make sure I<n> is "
3163 "greater or equal to I<mbstowcs(NULL,src,0)+1>."
3164 msgstr ""
3165
3166 #. type: Plain text
3167 #: build/C/man3/mbstowcs.3:93
3168 msgid ""
3169 "The B<mbstowcs>()  function returns the number of wide characters that make "
3170 "up the converted part of the wide-character string, not including the "
3171 "terminating null wide character.  If an invalid multibyte sequence was "
3172 "encountered, I<(size_t)\\ -1> is returned."
3173 msgstr ""
3174
3175 #. type: Plain text
3176 #: build/C/man3/mbstowcs.3:102
3177 msgid ""
3178 "The behavior of B<mbstowcs>()  depends on the B<LC_CTYPE> category of the "
3179 "current locale."
3180 msgstr ""
3181
3182 #. type: Plain text
3183 #: build/C/man3/mbstowcs.3:107
3184 msgid ""
3185 "The function B<mbsrtowcs>(3)  provides a better interface to the same "
3186 "functionality."
3187 msgstr ""
3188
3189 #. type: Plain text
3190 #: build/C/man3/mbstowcs.3:110
3191 msgid "B<mbsrtowcs>(3), B<wcstombs>(3)"
3192 msgstr ""
3193
3194 #. type: TH
3195 #: build/C/man3/mbtowc.3:16
3196 #, no-wrap
3197 msgid "MBTOWC"
3198 msgstr ""
3199
3200 #. type: Plain text
3201 #: build/C/man3/mbtowc.3:19
3202 msgid "mbtowc - convert a multibyte sequence to a wide character"
3203 msgstr ""
3204
3205 #. type: Plain text
3206 #: build/C/man3/mbtowc.3:24
3207 #, no-wrap
3208 msgid "B<int mbtowc(wchar_t *>I<pwc>B<, const char *>I<s>B<, size_t >I<n>B<);>\n"
3209 msgstr ""
3210
3211 #. type: Plain text
3212 #: build/C/man3/mbtowc.3:50
3213 msgid ""
3214 "The main case for this function is when I<s> is not NULL and I<pwc> is not "
3215 "NULL.  In this case, the B<mbtowc>()  function inspects at most I<n> bytes "
3216 "of the multibyte string starting at I<s>, extracts the next complete "
3217 "multibyte character, converts it to a wide character and stores it at "
3218 "I<*pwc>.  It updates an internal shift state known only to the B<mbtowc>()  "
3219 "function.  If I<s> does not point to a null byte (\\(aq\\e0\\(aq), it "
3220 "returns the number of bytes that were consumed from I<s>, otherwise it "
3221 "returns 0."
3222 msgstr ""
3223
3224 #. type: Plain text
3225 #: build/C/man3/mbtowc.3:64
3226 msgid ""
3227 "If the I<n> bytes starting at I<s> do not contain a complete multibyte "
3228 "character, or if they contain an invalid multibyte sequence, B<mbtowc>()  "
3229 "returns -1.  This can happen even if I<n> E<gt>= I<MB_CUR_MAX>, if the "
3230 "multibyte string contains redundant shift sequences."
3231 msgstr ""
3232
3233 #. type: Plain text
3234 #: build/C/man3/mbtowc.3:75
3235 msgid ""
3236 "A different case is when I<s> is not NULL but I<pwc> is NULL.  In this case "
3237 "the B<mbtowc>()  function behaves as above, except that it does not store "
3238 "the converted wide character in memory."
3239 msgstr ""
3240
3241 #.  The Dinkumware doc and the Single UNIX specification say this, but
3242 #.  glibc doesn't implement this.
3243 #. type: Plain text
3244 #: build/C/man3/mbtowc.3:94
3245 msgid ""
3246 "A third case is when I<s> is NULL.  In this case, I<pwc> and I<n> are "
3247 "ignored.  The B<mbtowc>()  function resets the shift state, only known to "
3248 "this function, to the initial state, and returns nonzero if the encoding has "
3249 "nontrivial shift state, or zero if the encoding is stateless."
3250 msgstr ""
3251
3252 #. type: Plain text
3253 #: build/C/man3/mbtowc.3:106
3254 msgid ""
3255 "If I<s> is not NULL, the B<mbtowc>()  function returns the number of "
3256 "consumed bytes starting at I<s>, or 0 if I<s> points to a null byte, or -1 "
3257 "upon failure."
3258 msgstr ""
3259
3260 #. type: Plain text
3261 #: build/C/man3/mbtowc.3:114
3262 msgid ""
3263 "If I<s> is NULL, the B<mbtowc>()  function returns nonzero if the encoding "
3264 "has nontrivial shift state, or zero if the encoding is stateless."
3265 msgstr ""
3266
3267 #. type: Plain text
3268 #: build/C/man3/mbtowc.3:123
3269 msgid ""
3270 "The behavior of B<mbtowc>()  depends on the B<LC_CTYPE> category of the "
3271 "current locale."
3272 msgstr ""
3273
3274 #. type: Plain text
3275 #: build/C/man3/mbtowc.3:129
3276 msgid ""
3277 "This function is not multithread safe.  The function B<mbrtowc>(3)  provides "
3278 "a better interface to the same functionality."
3279 msgstr ""
3280
3281 #. type: Plain text
3282 #: build/C/man3/mbtowc.3:133
3283 msgid "B<MB_CUR_MAX>(3), B<mbrtowc>(3), B<mbstowcs>(3)"
3284 msgstr ""
3285
3286 #. type: TH
3287 #: build/C/man3/mkdtemp.3:26
3288 #, no-wrap
3289 msgid "MKDTEMP"
3290 msgstr ""
3291
3292 #. type: Plain text
3293 #: build/C/man3/mkdtemp.3:29
3294 msgid "mkdtemp - create a unique temporary directory"
3295 msgstr ""
3296
3297 #. type: Plain text
3298 #: build/C/man3/mkdtemp.3:34
3299 #, no-wrap
3300 msgid "B<char *mkdtemp(char *>I<template>B<);>\n"
3301 msgstr ""
3302
3303 #. type: Plain text
3304 #: build/C/man3/mkdtemp.3:42
3305 msgid "B<mkdtemp>():"
3306 msgstr ""
3307
3308 #. type: Plain text
3309 #: build/C/man3/mkdtemp.3:47
3310 msgid "_BSD_SOURCE"
3311 msgstr ""
3312
3313 #. type: Plain text
3314 #: build/C/man3/mkdtemp.3:49
3315 msgid "|| /* Since glibc 2.10: */"
3316 msgstr ""
3317
3318 #. type: Plain text
3319 #: build/C/man3/mkdtemp.3:51
3320 msgid "(_POSIX_C_SOURCE\\ E<gt>=\\ 200809L || _XOPEN_SOURCE\\ E<gt>=\\ 700)"
3321 msgstr ""
3322
3323 #. type: Plain text
3324 #: build/C/man3/mkdtemp.3:68
3325 msgid ""
3326 "The B<mkdtemp>()  function generates a uniquely named temporary directory "
3327 "from I<template>.  The last six characters of I<template> must be XXXXXX and "
3328 "these are replaced with a string that makes the directory name unique.  The "
3329 "directory is then created with permissions 0700.  Since it will be modified, "
3330 "I<template> must not be a string constant, but should be declared as a "
3331 "character array."
3332 msgstr ""
3333
3334 #. type: Plain text
3335 #: build/C/man3/mkdtemp.3:75
3336 msgid ""
3337 "The B<mkdtemp>()  function returns a pointer to the modified template string "
3338 "on success, and NULL on failure, in which case I<errno> is set "
3339 "appropriately."
3340 msgstr ""
3341
3342 #. type: TP
3343 #: build/C/man3/mkdtemp.3:76 build/C/man3/mkstemp.3:147 build/C/man3/mktemp.3:89 build/C/man3/random.3:141 build/C/man3/random.3:148 build/C/man3/random_r.3:106 build/C/man3/random_r.3:110 build/C/man3/random_r.3:119 build/C/man3/setenv.3:119 build/C/man3/strtol.3:145 build/C/man3/strtoul.3:149
3344 #, no-wrap
3345 msgid "B<EINVAL>"
3346 msgstr ""
3347
3348 #. type: Plain text
3349 #: build/C/man3/mkdtemp.3:80
3350 msgid ""
3351 "The last six characters of I<template> were not XXXXXX.  Now I<template> is "
3352 "unchanged."
3353 msgstr ""
3354
3355 #. type: Plain text
3356 #: build/C/man3/mkdtemp.3:84
3357 msgid "Also see B<mkdir>(2)  for other possible values for I<errno>."
3358 msgstr ""
3359
3360 #. type: Plain text
3361 #: build/C/man3/mkdtemp.3:86
3362 msgid "Available since glibc 2.1.91."
3363 msgstr ""
3364
3365 #.  As at 2006, this function is being considered for a revision of POSIX.1
3366 #.  Also in NetBSD 1.4.
3367 #. type: Plain text
3368 #: build/C/man3/mkdtemp.3:91
3369 msgid "POSIX.1-2008.  This function is present on the BSDs."
3370 msgstr ""
3371
3372 #. type: Plain text
3373 #: build/C/man3/mkdtemp.3:98
3374 msgid ""
3375 "B<mkdir>(2), B<mkstemp>(3), B<mktemp>(3), B<tempnam>(3), B<tmpfile>(3), "
3376 "B<tmpnam>(3)"
3377 msgstr ""
3378
3379 #. type: TH
3380 #: build/C/man3/mkstemp.3:35
3381 #, no-wrap
3382 msgid "MKSTEMP"
3383 msgstr ""
3384
3385 #. type: TH
3386 #: build/C/man3/mkstemp.3:35
3387 #, no-wrap
3388 msgid "2012-12-21"
3389 msgstr ""
3390
3391 #. type: Plain text
3392 #: build/C/man3/mkstemp.3:38
3393 msgid "mkstemp, mkostemp, mkstemps, mkostemps - create a unique temporary file"
3394 msgstr ""
3395
3396 #. type: Plain text
3397 #: build/C/man3/mkstemp.3:43
3398 #, no-wrap
3399 msgid "B<int mkstemp(char *>I<template>B<);>\n"
3400 msgstr ""
3401
3402 #. type: Plain text
3403 #: build/C/man3/mkstemp.3:45
3404 #, no-wrap
3405 msgid "B<int mkostemp(char *>I<template>B<, int >I<flags>B<);>\n"
3406 msgstr ""
3407
3408 #. type: Plain text
3409 #: build/C/man3/mkstemp.3:47
3410 #, no-wrap
3411 msgid "B<int mkstemps(char *>I<template>B<, int >I<suffixlen>B<);>\n"
3412 msgstr ""
3413
3414 #. type: Plain text
3415 #: build/C/man3/mkstemp.3:49
3416 #, no-wrap
3417 msgid ""
3418 "B<int mkostemps(char *>I<template>B<, int >I<suffixlen>B<, int "
3419 ">I<flags>B<);>\n"
3420 msgstr ""
3421
3422 #. type: Plain text
3423 #: build/C/man3/mkstemp.3:57
3424 msgid "B<mkstemp>():"
3425 msgstr ""
3426
3427 #. type: Plain text
3428 #: build/C/man3/mkstemp.3:62 build/C/man3/mktemp.3:63
3429 msgid ""
3430 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
3431 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
3432 msgstr ""
3433
3434 #. type: Plain text
3435 #: build/C/man3/mkstemp.3:64
3436 msgid "|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200112L"
3437 msgstr ""
3438
3439 #. type: Plain text
3440 #: build/C/man3/mkstemp.3:70
3441 msgid "B<mkostemp>(): _GNU_SOURCE"
3442 msgstr ""
3443
3444 #. type: Plain text
3445 #: build/C/man3/mkstemp.3:73
3446 msgid "B<mkstemps>(): _BSD_SOURCE || _SVID_SOURCE"
3447 msgstr ""
3448
3449 #. type: Plain text
3450 #: build/C/man3/mkstemp.3:76
3451 msgid "B<mkostemps>(): _GNU_SOURCE"
3452 msgstr ""
3453
3454 #. type: Plain text
3455 #: build/C/man3/mkstemp.3:83
3456 msgid ""
3457 "The B<mkstemp>()  function generates a unique temporary filename from "
3458 "I<template>, creates and opens the file, and returns an open file descriptor "
3459 "for the file."
3460 msgstr ""
3461
3462 #. type: Plain text
3463 #: build/C/man3/mkstemp.3:91
3464 msgid ""
3465 "The last six characters of I<template> must be \"XXXXXX\" and these are "
3466 "replaced with a string that makes the filename unique.  Since it will be "
3467 "modified, I<template> must not be a string constant, but should be declared "
3468 "as a character array."
3469 msgstr ""
3470
3471 #. type: Plain text
3472 #: build/C/man3/mkstemp.3:99
3473 msgid ""
3474 "The file is created with permissions 0600, that is, read plus write for "
3475 "owner only.  The returned file descriptor provides both read and write "
3476 "access to the file.  The file is opened with the B<open>(2)  B<O_EXCL> flag, "
3477 "guaranteeing that the caller is the process that creates the file."
3478 msgstr ""
3479
3480 #. type: Plain text
3481 #: build/C/man3/mkstemp.3:111
3482 msgid ""
3483 "The B<mkostemp>()  function is like B<mkstemp>(), with the difference that "
3484 "flags as for B<open>(2)  may be specified in I<flags> (e.g., B<O_APPEND>, "
3485 "B<O_SYNC>)."
3486 msgstr ""
3487
3488 #. type: Plain text
3489 #: build/C/man3/mkstemp.3:127
3490 msgid ""
3491 "The B<mkstemps>()  function is like B<mkstemp>(), except that the string in "
3492 "I<template> contains a suffix of I<suffixlen> characters.  Thus, I<template> "
3493 "is of the form I<prefixXXXXXXsuffix>, and the string XXXXXX is modified as "
3494 "for B<mkstemp>()."
3495 msgstr ""
3496
3497 #. type: Plain text
3498 #: build/C/man3/mkstemp.3:136
3499 msgid ""
3500 "The B<mkostemps>()  function is to B<mkstemps>()  as B<mkostemp>()  is to "
3501 "B<mkstemp>()."
3502 msgstr ""
3503
3504 #. type: Plain text
3505 #: build/C/man3/mkstemp.3:142
3506 msgid ""
3507 "On success, these functions return the file descriptor of the temporary "
3508 "file.  On error, -1 is returned, and I<errno> is set appropriately."
3509 msgstr ""
3510
3511 #. type: TP
3512 #: build/C/man3/mkstemp.3:143
3513 #, no-wrap
3514 msgid "B<EEXIST>"
3515 msgstr ""
3516
3517 #. type: Plain text
3518 #: build/C/man3/mkstemp.3:147
3519 msgid ""
3520 "Could not create a unique temporary filename.  Now the contents of "
3521 "I<template> are undefined."
3522 msgstr ""
3523
3524 #. type: Plain text
3525 #: build/C/man3/mkstemp.3:155
3526 msgid ""
3527 "For B<mkstemp>()  and B<mkostemp>(): The last six characters of I<template> "
3528 "were not XXXXXX; now I<template> is unchanged."
3529 msgstr ""
3530
3531 #. type: Plain text
3532 #: build/C/man3/mkstemp.3:166
3533 msgid ""
3534 "For B<mkstemps>()  and B<mkostemps>(): I<template> is less than I<(6 + "
3535 "suffixlen)> characters long, or the last 6 characters before the suffix in "
3536 "I<template> were not XXXXXX."
3537 msgstr ""
3538
3539 #. type: Plain text
3540 #: build/C/man3/mkstemp.3:169
3541 msgid ""
3542 "These functions may also fail with any of the errors described for "
3543 "B<open>(2)."
3544 msgstr ""
3545
3546 #. type: Plain text
3547 #: build/C/man3/mkstemp.3:176
3548 msgid ""
3549 "B<mkostemp>()  is available since glibc 2.7.  B<mkstemps>()  and "
3550 "B<mkostemps>()  are available since glibc 2.11."
3551 msgstr ""
3552
3553 #. type: Plain text
3554 #: build/C/man3/mkstemp.3:179
3555 msgid "B<mkstemp>(): 4.3BSD, POSIX.1-2001."
3556 msgstr ""
3557
3558 #.  mkstemps() appears to be at least on the BSDs, Mac OS X, Solaris,
3559 #.  and Tru64.
3560 #. type: Plain text
3561 #: build/C/man3/mkstemp.3:184
3562 msgid "B<mkstemps>(): unstandardized, but appears on several other systems."
3563 msgstr ""
3564
3565 #. type: Plain text
3566 #: build/C/man3/mkstemp.3:189
3567 msgid "B<mkostemp>()  and B<mkostemps>(): are glibc extensions."
3568 msgstr ""
3569
3570 #. type: Plain text
3571 #: build/C/man3/mkstemp.3:196
3572 msgid ""
3573 "In glibc versions 2.06 and earlier, the file is created with permissions "
3574 "0666, that is, read and write for all users.  This old behavior may be a "
3575 "security risk, especially since other UNIX flavors use 0600, and somebody "
3576 "might overlook this detail when porting programs.  POSIX.1-2008 adds a "
3577 "requirement that the file be created with mode 0600."
3578 msgstr ""
3579
3580 #. type: Plain text
3581 #: build/C/man3/mkstemp.3:207
3582 msgid ""
3583 "More generally, the POSIX specification of B<mkstemp>()  does not say "
3584 "anything about file modes, so the application should make sure its file mode "
3585 "creation mask (see B<umask>(2))  is set appropriately before calling "
3586 "B<mkstemp>()  (and B<mkostemp>())."
3587 msgstr ""
3588
3589 #. type: Plain text
3590 #: build/C/man3/mkstemp.3:214
3591 msgid ""
3592 "The prototype for B<mktemp>()  is in I<E<lt>unistd.hE<gt>> for libc4, libc5, "
3593 "glibc1; glibc2 follows POSIX.1 and has the prototype in "
3594 "I<E<lt>stdlib.hE<gt>>."
3595 msgstr ""
3596
3597 #. type: Plain text
3598 #: build/C/man3/mkstemp.3:220
3599 msgid "B<mkdtemp>(3), B<mktemp>(3), B<tempnam>(3), B<tmpfile>(3), B<tmpnam>(3)"
3600 msgstr ""
3601
3602 #. type: TH
3603 #: build/C/man3/mktemp.3:34
3604 #, no-wrap
3605 msgid "MKTEMP"
3606 msgstr ""
3607
3608 #. type: TH
3609 #: build/C/man3/mktemp.3:34 build/C/man3/putenv.3:36 build/C/man3/random.3:33 build/C/man3/random_r.3:26
3610 #, no-wrap
3611 msgid "2013-04-19"
3612 msgstr ""
3613
3614 #. type: Plain text
3615 #: build/C/man3/mktemp.3:37
3616 msgid "mktemp - make a unique temporary filename"
3617 msgstr ""
3618
3619 #. type: Plain text
3620 #: build/C/man3/mktemp.3:42
3621 #, no-wrap
3622 msgid "B<char *mktemp(char *>I<template>B<);>\n"
3623 msgstr ""
3624
3625 #. type: Plain text
3626 #: build/C/man3/mktemp.3:50
3627 msgid "B<mktemp>():"
3628 msgstr ""
3629
3630 #. type: Plain text
3631 #: build/C/man3/mktemp.3:59
3632 #, no-wrap
3633 msgid ""
3634 "_BSD_SOURCE || _SVID_SOURCE ||\n"
3635 "    (_XOPEN_SOURCE\\ E<gt>=\\ 500 ||\n"
3636 "         _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED) &&\n"
3637 "    !(_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600)\n"
3638 msgstr ""
3639
3640 #. type: Plain text
3641 #: build/C/man3/mktemp.3:77
3642 msgid ""
3643 "The B<mktemp>()  function generates a unique temporary filename from "
3644 "I<template>.  The last six characters of I<template> must be XXXXXX and "
3645 "these are replaced with a string that makes the filename unique.  Since it "
3646 "will be modified, I<template> must not be a string constant, but should be "
3647 "declared as a character array."
3648 msgstr ""
3649
3650 #. type: Plain text
3651 #: build/C/man3/mktemp.3:88
3652 msgid ""
3653 "The B<mktemp>()  function always returns I<template>.  If a unique name was "
3654 "created, the last six bytes of I<template> will have been modified in such a "
3655 "way that the resulting name is unique (i.e., does not exist already)  If a "
3656 "unique name could not be created, I<template> is made an empty string, and "
3657 "I<errno> is set to indicate the error."
3658 msgstr ""
3659
3660 #. type: Plain text
3661 #: build/C/man3/mktemp.3:92
3662 msgid "The last six characters of I<template> were not XXXXXX."
3663 msgstr ""
3664
3665 #. type: Plain text
3666 #: build/C/man3/mktemp.3:96
3667 msgid ""
3668 "4.3BSD, POSIX.1-2001.  POSIX.1-2008 removes the specification of "
3669 "B<mktemp>()."
3670 msgstr ""
3671
3672 #. type: Plain text
3673 #: build/C/man3/mktemp.3:102
3674 msgid ""
3675 "The prototype is in I<E<lt>unistd.hE<gt>> for libc4, libc5, glibc1; glibc2 "
3676 "follows the Single UNIX Specification and has the prototype in "
3677 "I<E<lt>stdlib.hE<gt>>."
3678 msgstr ""
3679
3680 #. type: SH
3681 #: build/C/man3/mktemp.3:102 build/C/man3/random.3:180 build/C/man3/rpmatch.3:104 build/C/man3/setenv.3:143
3682 #, no-wrap
3683 msgid "BUGS"
3684 msgstr ""
3685
3686 #. type: Plain text
3687 #: build/C/man3/mktemp.3:115
3688 msgid ""
3689 "Never use B<mktemp>().  Some implementations follow 4.3BSD and replace "
3690 "XXXXXX by the current process ID and a single letter, so that at most 26 "
3691 "different names can be returned.  Since on the one hand the names are easy "
3692 "to guess, and on the other hand there is a race between testing whether the "
3693 "name exists and opening the file, every use of B<mktemp>()  is a security "
3694 "risk.  The race is avoided by B<mkstemp>(3)."
3695 msgstr ""
3696
3697 #. type: Plain text
3698 #: build/C/man3/mktemp.3:120
3699 msgid "B<mkstemp>(3), B<tempnam>(3), B<tmpfile>(3), B<tmpnam>(3)"
3700 msgstr ""
3701
3702 #. type: TH
3703 #: build/C/man3/on_exit.3:31
3704 #, no-wrap
3705 msgid "ON_EXIT"
3706 msgstr ""
3707
3708 #. type: Plain text
3709 #: build/C/man3/on_exit.3:34
3710 msgid "on_exit - register a function to be called at normal process termination"
3711 msgstr ""
3712
3713 #. type: Plain text
3714 #: build/C/man3/on_exit.3:39
3715 #, no-wrap
3716 msgid "B<int on_exit(void (*>I<function>B<)(int , void *), void *>I<arg>B<);>\n"
3717 msgstr ""
3718
3719 #. type: Plain text
3720 #: build/C/man3/on_exit.3:48
3721 msgid "B<on_exit>(): _BSD_SOURCE || _SVID_SOURCE"
3722 msgstr ""
3723
3724 #. type: Plain text
3725 #: build/C/man3/on_exit.3:66
3726 msgid ""
3727 "The B<on_exit>()  function registers the given I<function> to be called at "
3728 "normal process termination, whether via B<exit>(3)  or via return from the "
3729 "program's I<main>().  The I<function> is passed the status argument given to "
3730 "the last call to B<exit>(3)  and the I<arg> argument from B<on_exit>()."
3731 msgstr ""
3732
3733 #. type: Plain text
3734 #: build/C/man3/on_exit.3:81
3735 msgid ""
3736 "The B<on_exit>()  function returns the value 0 if successful; otherwise it "
3737 "returns a nonzero value."
3738 msgstr ""
3739
3740 #. type: Plain text
3741 #: build/C/man3/on_exit.3:88
3742 msgid ""
3743 "This function comes from SunOS 4, but is also present in libc4, libc5 and "
3744 "glibc.  It no longer occurs in Solaris (SunOS 5).  Avoid this function, and "
3745 "use the standard B<atexit>(3)  instead."
3746 msgstr ""
3747
3748 #. type: Plain text
3749 #: build/C/man3/on_exit.3:92
3750 msgid "B<_exit>(2), B<atexit>(3), B<exit>(3)"
3751 msgstr ""
3752
3753 #. type: TH
3754 #: build/C/man3/putenv.3:36
3755 #, no-wrap
3756 msgid "PUTENV"
3757 msgstr ""
3758
3759 #. type: Plain text
3760 #: build/C/man3/putenv.3:39
3761 msgid "putenv - change or add an environment variable"
3762 msgstr ""
3763
3764 #.  Not: const char *
3765 #. type: Plain text
3766 #: build/C/man3/putenv.3:45
3767 #, no-wrap
3768 msgid "B<int putenv(char *>I<string>B<);>\n"
3769 msgstr ""
3770
3771 #. type: Plain text
3772 #: build/C/man3/putenv.3:54
3773 msgid "B<putenv>(): _SVID_SOURCE || _XOPEN_SOURCE"
3774 msgstr ""
3775
3776 #. type: Plain text
3777 #: build/C/man3/putenv.3:67
3778 msgid ""
3779 "The B<putenv>()  function adds or changes the value of environment "
3780 "variables.  The argument I<string> is of the form I<name>=I<value>.  If "
3781 "I<name> does not already exist in the environment, then I<string> is added "
3782 "to the environment.  If I<name> does exist, then the value of I<name> in the "
3783 "environment is changed to I<value>.  The string pointed to by I<string> "
3784 "becomes part of the environment, so altering the string changes the "
3785 "environment."
3786 msgstr ""
3787
3788 #. type: Plain text
3789 #: build/C/man3/putenv.3:75
3790 msgid ""
3791 "The B<putenv>()  function returns zero on success, or nonzero if an error "
3792 "occurs.  In the event of an error, I<errno> is set to indicate the cause."
3793 msgstr ""
3794
3795 #. type: TP
3796 #: build/C/man3/putenv.3:76 build/C/man3/setenv.3:124
3797 #, no-wrap
3798 msgid "B<ENOMEM>"
3799 msgstr ""
3800
3801 #. type: Plain text
3802 #: build/C/man3/putenv.3:79
3803 msgid "Insufficient space to allocate new environment."
3804 msgstr ""
3805
3806 #. type: Plain text
3807 #: build/C/man3/putenv.3:81
3808 msgid "SVr4, POSIX.1-2001, 4.3BSD."
3809 msgstr ""
3810
3811 #. type: Plain text
3812 #: build/C/man3/putenv.3:86
3813 msgid ""
3814 "The B<putenv>()  function is not required to be reentrant, and the one in "
3815 "libc4, libc5 and glibc 2.0 is not, but the glibc 2.1 version is."
3816 msgstr ""
3817
3818 #. type: Plain text
3819 #: build/C/man3/putenv.3:99
3820 msgid ""
3821 "Description for libc4, libc5, glibc: If the argument I<string> is of the "
3822 "form I<name>, and does not contain an \\(aq=\\(aq character, then the "
3823 "variable I<name> is removed from the environment.  If B<putenv>()  has to "
3824 "allocate a new array I<environ>, and the previous array was also allocated "
3825 "by B<putenv>(), then it will be freed.  In no case will the old storage "
3826 "associated to the environment variable itself be freed."
3827 msgstr ""
3828
3829 #. type: Plain text
3830 #: build/C/man3/putenv.3:115
3831 msgid ""
3832 "The libc4 and libc5 and glibc 2.1.2 versions conform to SUSv2: the pointer "
3833 "I<string> given to B<putenv>()  is used.  In particular, this string becomes "
3834 "part of the environment; changing it later will change the environment.  "
3835 "(Thus, it is an error is to call B<putenv>()  with an automatic variable as "
3836 "the argument, then return from the calling function while I<string> is still "
3837 "part of the environment.)  However, glibc 2.0-2.1.1 differs: a copy of the "
3838 "string is used.  On the one hand this causes a memory leak, and on the other "
3839 "hand it violates SUSv2.  This has been fixed in glibc 2.1.2."
3840 msgstr ""
3841
3842 #. type: Plain text
3843 #: build/C/man3/putenv.3:117
3844 msgid "The 4.4BSD version, like glibc 2.0, uses a copy."
3845 msgstr ""
3846
3847 #. type: Plain text
3848 #: build/C/man3/putenv.3:119
3849 msgid "SUSv2 removes the I<const> from the prototype, and so does glibc 2.1.3."
3850 msgstr ""
3851
3852 #. type: Plain text
3853 #: build/C/man3/putenv.3:125
3854 msgid "B<clearenv>(3), B<getenv>(3), B<setenv>(3), B<unsetenv>(3), B<environ>(7)"
3855 msgstr ""
3856
3857 #. type: TH
3858 #: build/C/man3/qecvt.3:28
3859 #, no-wrap
3860 msgid "QECVT"
3861 msgstr ""
3862
3863 #. type: TH
3864 #: build/C/man3/qecvt.3:28
3865 #, no-wrap
3866 msgid "2013-07-22"
3867 msgstr ""
3868
3869 #. type: Plain text
3870 #: build/C/man3/qecvt.3:31
3871 msgid "qecvt, qfcvt, qgcvt - convert a floating-point number to a string"
3872 msgstr ""
3873
3874 #. type: Plain text
3875 #: build/C/man3/qecvt.3:36
3876 msgid ""
3877 "B<char *qecvt(long double >I<number>B<, int >I<ndigits>B<, int "
3878 "*>I<decpt>B<,> B<int *>I<sign>B<);>"
3879 msgstr ""
3880
3881 #. type: Plain text
3882 #: build/C/man3/qecvt.3:39
3883 msgid ""
3884 "B<char *qfcvt(long double >I<number>B<, int >I<ndigits>B<, int "
3885 "*>I<decpt>B<,> B<int *>I<sign>B<);>"
3886 msgstr ""
3887
3888 #. type: Plain text
3889 #: build/C/man3/qecvt.3:41
3890 msgid "B<char *qgcvt(long double >I<number>B<, int >I<ndigit>B<, char *>I<buf>B<);>"
3891 msgstr ""
3892
3893 #. type: Plain text
3894 #: build/C/man3/qecvt.3:52
3895 msgid "B<qecvt>(), B<qfcvt>(), B<qgcvt>(): _SVID_SOURCE"
3896 msgstr ""
3897
3898 #. type: Plain text
3899 #: build/C/man3/qecvt.3:72
3900 msgid ""
3901 "The functions B<qecvt>(), B<qfcvt>()  and B<qgcvt>()  are identical to "
3902 "B<ecvt>(3), B<fcvt>(3)  and B<gcvt>(3)  respectively, except that they use a "
3903 "I<long double> argument I<number>.  See B<ecvt>(3)  and B<gcvt>(3)."
3904 msgstr ""
3905
3906 #. type: Plain text
3907 #: build/C/man3/qecvt.3:79
3908 msgid "The B<qecvt>()  and B<qfcvt>()  functions are not thread-safe."
3909 msgstr ""
3910
3911 #. type: Plain text
3912 #: build/C/man3/qecvt.3:83
3913 msgid "The B<qgcvt>()  function is thread-safe."
3914 msgstr ""
3915
3916 #. type: Plain text
3917 #: build/C/man3/qecvt.3:89
3918 msgid ""
3919 "SVr4.  Not seen in most common UNIX implementations, but occurs in SunOS.  "
3920 "Not supported by libc4 and libc5.  Supported by glibc."
3921 msgstr ""
3922
3923 #. type: Plain text
3924 #: build/C/man3/qecvt.3:99
3925 msgid "B<ecvt>(3), B<ecvt_r>(3), B<gcvt>(3), B<sprintf>(3)"
3926 msgstr ""
3927
3928 #. type: TH
3929 #: build/C/man3/rand.3:41
3930 #, no-wrap
3931 msgid "RAND"
3932 msgstr ""
3933
3934 #. type: TH
3935 #: build/C/man3/rand.3:41
3936 #, no-wrap
3937 msgid "2010-10-01"
3938 msgstr ""
3939
3940 #. type: Plain text
3941 #: build/C/man3/rand.3:44
3942 msgid "rand, rand_r, srand - pseudo-random number generator"
3943 msgstr ""
3944
3945 #. type: Plain text
3946 #: build/C/man3/rand.3:49
3947 #, no-wrap
3948 msgid "B<int rand(void);>\n"
3949 msgstr ""
3950
3951 #. type: Plain text
3952 #: build/C/man3/rand.3:51
3953 #, no-wrap
3954 msgid "B<int rand_r(unsigned int *>I<seedp>B<);>\n"
3955 msgstr ""
3956
3957 #. type: Plain text
3958 #: build/C/man3/rand.3:53
3959 #, no-wrap
3960 msgid "B<void srand(unsigned int >I<seed>B<);>\n"
3961 msgstr ""
3962
3963 #. type: Plain text
3964 #: build/C/man3/rand.3:62
3965 msgid "B<rand_r>(): _POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _POSIX_SOURCE"
3966 msgstr ""
3967
3968 #. type: Plain text
3969 #: build/C/man3/rand.3:68
3970 msgid ""
3971 "The B<rand>()  function returns a pseudo-random integer in the range 0 to "
3972 "B<RAND_MAX> inclusive (i.e., the mathematical range [0,\\ B<RAND_MAX>])."
3973 msgstr ""
3974
3975 #. type: Plain text
3976 #: build/C/man3/rand.3:77
3977 msgid ""
3978 "The B<srand>()  function sets its argument as the seed for a new sequence of "
3979 "pseudo-random integers to be returned by B<rand>().  These sequences are "
3980 "repeatable by calling B<srand>()  with the same seed value."
3981 msgstr ""
3982
3983 #. type: Plain text
3984 #: build/C/man3/rand.3:81
3985 msgid ""
3986 "If no seed value is provided, the B<rand>()  function is automatically "
3987 "seeded with a value of 1."
3988 msgstr ""
3989
3990 #. type: Plain text
3991 #: build/C/man3/rand.3:92
3992 msgid ""
3993 "The function B<rand>()  is not reentrant or thread-safe, since it uses "
3994 "hidden state that is modified on each call.  This might just be the seed "
3995 "value to be used by the next call, or it might be something more elaborate.  "
3996 "In order to get reproducible behavior in a threaded application, this state "
3997 "must be made explicit; this can be done using the reentrant function "
3998 "B<rand_r>()."
3999 msgstr ""
4000
4001 #. type: Plain text
4002 #: build/C/man3/rand.3:108
4003 msgid ""
4004 "Like B<rand>(), B<rand_r>()  returns a pseudo-random integer in the range "
4005 "[0,\\ B<RAND_MAX>].  The I<seedp> argument is a pointer to an I<unsigned "
4006 "int> that is used to store state between calls.  If B<rand_r>()  is called "
4007 "with the same initial value for the integer pointed to by I<seedp>, and that "
4008 "value is not modified between calls, then the same pseudo-random sequence "
4009 "will result."
4010 msgstr ""
4011
4012 #. type: Plain text
4013 #: build/C/man3/rand.3:118
4014 msgid ""
4015 "The value pointed to by the I<seedp> argument of B<rand_r>()  provides only "
4016 "a very small amount of state, so this function will be a weak pseudo-random "
4017 "generator.  Try B<drand48_r>(3)  instead."
4018 msgstr ""
4019
4020 #. type: Plain text
4021 #: build/C/man3/rand.3:129
4022 msgid ""
4023 "The B<rand>()  and B<rand_r>()  functions return a value between 0 and "
4024 "B<RAND_MAX> (inclusive).  The B<srand>()  function returns no value."
4025 msgstr ""
4026
4027 #. type: Plain text
4028 #: build/C/man3/rand.3:141
4029 msgid ""
4030 "The functions B<rand>()  and B<srand>()  conform to SVr4, 4.3BSD, C89, C99, "
4031 "POSIX.1-2001.  The function B<rand_r>()  is from POSIX.1-2001.  POSIX.1-2008 "
4032 "marks B<rand_r>()  as obsolete."
4033 msgstr ""
4034
4035 #. type: Plain text
4036 #: build/C/man3/rand.3:160
4037 msgid ""
4038 "The versions of B<rand>()  and B<srand>()  in the Linux C Library use the "
4039 "same random number generator as B<random>(3)  and B<srandom>(3), so the "
4040 "lower-order bits should be as random as the higher-order bits.  However, on "
4041 "older B<rand>()  implementations, and on current implementations on "
4042 "different systems, the lower-order bits are much less random than the "
4043 "higher-order bits.  Do not use this function in applications intended to be "
4044 "portable when good randomness is needed.  (Use B<random>(3)  instead.)"
4045 msgstr ""
4046
4047 #. type: Plain text
4048 #: build/C/man3/rand.3:166
4049 msgid ""
4050 "POSIX.1-2001 gives the following example of an implementation of B<rand>()  "
4051 "and B<srand>(), possibly useful when one needs the same sequence on two "
4052 "different machines."
4053 msgstr ""
4054
4055 #. type: Plain text
4056 #: build/C/man3/rand.3:170
4057 #, no-wrap
4058 msgid "static unsigned long next = 1;\n"
4059 msgstr ""
4060
4061 #. type: Plain text
4062 #: build/C/man3/rand.3:176
4063 #, no-wrap
4064 msgid ""
4065 "/* RAND_MAX assumed to be 32767 */\n"
4066 "int myrand(void) {\n"
4067 "    next = next * 1103515245 + 12345;\n"
4068 "    return((unsigned)(next/65536) % 32768);\n"
4069 "}\n"
4070 msgstr ""
4071
4072 #. type: Plain text
4073 #: build/C/man3/rand.3:180
4074 #, no-wrap
4075 msgid ""
4076 "void mysrand(unsigned seed) {\n"
4077 "    next = seed;\n"
4078 "}\n"
4079 msgstr ""
4080
4081 #. type: Plain text
4082 #: build/C/man3/rand.3:187
4083 msgid ""
4084 "The following program can be used to display the pseudo-random sequence "
4085 "produced by B<rand>()  when given a particular seed."
4086 msgstr ""
4087
4088 #. type: Plain text
4089 #: build/C/man3/rand.3:192
4090 #, no-wrap
4091 msgid ""
4092 "#include E<lt>stdlib.hE<gt>\n"
4093 "#include E<lt>stdio.hE<gt>\n"
4094 msgstr ""
4095
4096 #. type: Plain text
4097 #: build/C/man3/rand.3:198
4098 #, no-wrap
4099 msgid ""
4100 "int\n"
4101 "main(int argc, char *argv[])\n"
4102 "{\n"
4103 "    int j, r, nloops;\n"
4104 "    unsigned int seed;\n"
4105 msgstr ""
4106
4107 #. type: Plain text
4108 #: build/C/man3/rand.3:203
4109 #, no-wrap
4110 msgid ""
4111 "    if (argc != 3) {\n"
4112 "        fprintf(stderr, \"Usage: %s E<lt>seedE<gt> E<lt>nloopsE<gt>\\en\", "
4113 "argv[0]);\n"
4114 "        exit(EXIT_FAILURE);\n"
4115 "    }\n"
4116 msgstr ""
4117
4118 #. type: Plain text
4119 #: build/C/man3/rand.3:206
4120 #, no-wrap
4121 msgid ""
4122 "    seed = atoi(argv[1]);\n"
4123 "    nloops = atoi(argv[2]);\n"
4124 msgstr ""
4125
4126 #. type: Plain text
4127 #: build/C/man3/rand.3:212
4128 #, no-wrap
4129 msgid ""
4130 "    srand(seed);\n"
4131 "    for (j = 0; j E<lt> nloops; j++) {\n"
4132 "        r =  rand();\n"
4133 "        printf(\"%d\\en\", r);\n"
4134 "    }\n"
4135 msgstr ""
4136
4137 #. type: Plain text
4138 #: build/C/man3/rand.3:220
4139 msgid "B<drand48>(3), B<random>(3)"
4140 msgstr ""
4141
4142 #. type: TH
4143 #: build/C/man3/random.3:33
4144 #, no-wrap
4145 msgid "RANDOM"
4146 msgstr ""
4147
4148 #. type: Plain text
4149 #: build/C/man3/random.3:36
4150 msgid "random, srandom, initstate, setstate - random number generator"
4151 msgstr ""
4152
4153 #. type: Plain text
4154 #: build/C/man3/random.3:41
4155 #, no-wrap
4156 msgid "B<long int random(void);>\n"
4157 msgstr ""
4158
4159 #. type: Plain text
4160 #: build/C/man3/random.3:43
4161 #, no-wrap
4162 msgid "B<void srandom(unsigned int >I<seed>B<);>\n"
4163 msgstr ""
4164
4165 #. type: Plain text
4166 #: build/C/man3/random.3:45
4167 #, no-wrap
4168 msgid ""
4169 "B<char *initstate(unsigned int >I<seed>B<, char *>I<state>B<, size_t "
4170 ">I<n>B<);>\n"
4171 msgstr ""
4172
4173 #. type: Plain text
4174 #: build/C/man3/random.3:47
4175 #, no-wrap
4176 msgid "B<char *setstate(char *>I<state>B<);>\n"
4177 msgstr ""
4178
4179 #. type: Plain text
4180 #: build/C/man3/random.3:59
4181 msgid "B<random>(), B<srandom>(), B<initstate>(), B<setstate>():"
4182 msgstr ""
4183
4184 #. type: Plain text
4185 #: build/C/man3/random.3:62
4186 msgid ""
4187 "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
4188 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
4189 msgstr ""
4190
4191 #. type: Plain text
4192 #: build/C/man3/random.3:73
4193 msgid ""
4194 "The B<random>()  function uses a nonlinear additive feedback random number "
4195 "generator employing a default table of size 31 long integers to return "
4196 "successive pseudo-random numbers in the range from 0 to B<RAND_MAX>.  The "
4197 "period of this random number generator is very large, approximately I<16\\ "
4198 "*\\ ((2^31)\\ -\\ 1)>."
4199 msgstr ""
4200
4201 #. type: Plain text
4202 #: build/C/man3/random.3:87
4203 msgid ""
4204 "The B<srandom>()  function sets its argument as the seed for a new sequence "
4205 "of pseudo-random integers to be returned by B<random>().  These sequences "
4206 "are repeatable by calling B<srandom>()  with the same seed value.  If no "
4207 "seed value is provided, the B<random>()  function is automatically seeded "
4208 "with a value of 1."
4209 msgstr ""
4210
4211 #. type: Plain text
4212 #: build/C/man3/random.3:102
4213 msgid ""
4214 "The B<initstate>()  function allows a state array I<state> to be initialized "
4215 "for use by B<random>().  The size of the state array I<n> is used by "
4216 "B<initstate>()  to decide how sophisticated a random number generator it "
4217 "should use\\(emthe larger the state array, the better the random numbers "
4218 "will be.  I<seed> is the seed for the initialization, which specifies a "
4219 "starting point for the random number sequence, and provides for restarting "
4220 "at the same point."
4221 msgstr ""
4222
4223 #. type: Plain text
4224 #: build/C/man3/random.3:118
4225 msgid ""
4226 "The B<setstate>()  function changes the state array used by the B<random>()  "
4227 "function.  The state array I<state> is used for random number generation "
4228 "until the next call to B<initstate>()  or B<setstate>().  I<state> must "
4229 "first have been initialized using B<initstate>()  or be the result of a "
4230 "previous call of B<setstate>()."
4231 msgstr ""
4232
4233 #. type: Plain text
4234 #: build/C/man3/random.3:126
4235 msgid ""
4236 "The B<random>()  function returns a value between 0 and B<RAND_MAX>.  The "
4237 "B<srandom>()  function returns no value."
4238 msgstr ""
4239
4240 #. type: Plain text
4241 #: build/C/man3/random.3:133
4242 msgid ""
4243 "The B<initstate>()  function returns a pointer to the previous state array.  "
4244 "On error, I<errno> is set to indicate the cause."
4245 msgstr ""
4246
4247 #. type: Plain text
4248 #: build/C/man3/random.3:140
4249 msgid ""
4250 "On success, B<setstate>()  returns a pointer to the previous state array.  "
4251 "On error, it returns NULL, with I<errno> set to indicate the cause of the "
4252 "error."
4253 msgstr ""
4254
4255 #. type: Plain text
4256 #: build/C/man3/random.3:148
4257 msgid "The I<state> argument given to B<setstate>()  was NULL."
4258 msgstr ""
4259
4260 #. type: Plain text
4261 #: build/C/man3/random.3:152
4262 msgid "A state array of less than 8 bytes was specified to B<initstate>()."
4263 msgstr ""
4264
4265 #. type: Plain text
4266 #: build/C/man3/random.3:154 build/C/man3/setenv.3:129
4267 msgid "4.3BSD, POSIX.1-2001."
4268 msgstr ""
4269
4270 #. type: Plain text
4271 #: build/C/man3/random.3:160
4272 msgid ""
4273 "Current \"optimal\" values for the size of the state array I<n> are 8, 32, "
4274 "64, 128, and 256 bytes; other amounts will be rounded down to the nearest "
4275 "known amount.  Using less than 8 bytes will cause an error."
4276 msgstr ""
4277
4278 #. type: Plain text
4279 #: build/C/man3/random.3:167
4280 msgid ""
4281 "This function should not be used in cases where multiple threads use "
4282 "B<random>()  and the behavior should be reproducible.  Use B<random_r>(3)  "
4283 "for that purpose."
4284 msgstr ""
4285
4286 #. type: Plain text
4287 #: build/C/man3/random.3:174
4288 msgid ""
4289 "Random-number generation is a complex topic.  I<Numerical Recipes in C: The "
4290 "Art of Scientific Computing> (William H. Press, Brian P. Flannery, Saul "
4291 "A. Teukolsky, William T. Vetterling; New York: Cambridge University Press, "
4292 "2007, 3rd ed.)  provides an excellent discussion of practical random-number "
4293 "generation issues in Chapter 7 (Random Numbers)."
4294 msgstr ""
4295
4296 #. type: Plain text
4297 #: build/C/man3/random.3:180
4298 msgid ""
4299 "For a more theoretical discussion which also covers many practical issues in "
4300 "depth, see Chapter 3 (Random Numbers) in Donald E. Knuth's I<The Art of "
4301 "Computer Programming>, volume 2 (Seminumerical Algorithms), 2nd ed.; "
4302 "Reading, Massachusetts: Addison-Wesley Publishing Company, 1981."
4303 msgstr ""
4304
4305 #.  http://sourceware.org/bugzilla/show_bug.cgi?id=15380
4306 #. type: Plain text
4307 #: build/C/man3/random.3:188
4308 msgid ""
4309 "According to POSIX, B<initstate>()  should return NULL on error.  In the "
4310 "glibc implementation, I<errno> is (as specified) set on error, but the "
4311 "function does not return NULL."
4312 msgstr ""
4313
4314 #. type: Plain text
4315 #: build/C/man3/random.3:193
4316 msgid "B<drand48>(3), B<rand>(3), B<random_r>(3), B<srand>(3)"
4317 msgstr ""
4318
4319 #. type: TH
4320 #: build/C/man3/random_r.3:26
4321 #, no-wrap
4322 msgid "RANDOM_R"
4323 msgstr ""
4324
4325 #. type: Plain text
4326 #: build/C/man3/random_r.3:30
4327 msgid ""
4328 "random_r, srandom_r, initstate_r, setstate_r - reentrant random number "
4329 "generator"
4330 msgstr ""
4331
4332 #. type: Plain text
4333 #: build/C/man3/random_r.3:35
4334 #, no-wrap
4335 msgid "B<int random_r(struct random_data *>I<buf>B<, int32_t *>I<result>B<);>\n"
4336 msgstr ""
4337
4338 #. type: Plain text
4339 #: build/C/man3/random_r.3:37
4340 #, no-wrap
4341 msgid "B<int srandom_r(unsigned int >I<seed>B<, struct random_data *>I<buf>B<);>\n"
4342 msgstr ""
4343
4344 #. type: Plain text
4345 #: build/C/man3/random_r.3:40
4346 #, no-wrap
4347 msgid ""
4348 "B<int initstate_r(unsigned int >I<seed>B<, char *>I<statebuf>B<,>\n"
4349 "B<                size_t >I<statelen>B<, struct random_data *>I<buf>B<);>\n"
4350 msgstr ""
4351
4352 #. type: Plain text
4353 #: build/C/man3/random_r.3:42
4354 #, no-wrap
4355 msgid "B<int setstate_r(char *>I<statebuf>B<, struct random_data *>I<buf>B<);>\n"
4356 msgstr ""
4357
4358 #. type: Plain text
4359 #: build/C/man3/random_r.3:54
4360 msgid "B<random_r>(), B<srandom_r>(), B<initstate_r>(), B<setstate_r>():"
4361 msgstr ""
4362
4363 #. type: Plain text
4364 #: build/C/man3/random_r.3:56
4365 msgid "_SVID_SOURCE || _BSD_SOURCE"
4366 msgstr ""
4367
4368 #. type: Plain text
4369 #: build/C/man3/random_r.3:64
4370 msgid ""
4371 "These functions are the reentrant equivalents of the functions described in "
4372 "B<random>(3).  They are suitable for use in multithreaded programs where "
4373 "each thread needs to obtain an independent, reproducible sequence of random "
4374 "numbers."
4375 msgstr ""
4376
4377 #. type: Plain text
4378 #: build/C/man3/random_r.3:75
4379 msgid ""
4380 "The B<random_r>()  function is like B<random>(3), except that instead of "
4381 "using state information maintained in a global variable, it uses the state "
4382 "information in the argument pointed to by I<buf>.  The generated random "
4383 "number is returned in the argument I<result>."
4384 msgstr ""
4385
4386 #. type: Plain text
4387 #: build/C/man3/random_r.3:84
4388 msgid ""
4389 "The B<srandom_r>()  function is like B<srandom>(3), except that it "
4390 "initializes the seed for the random number generator whose state is "
4391 "maintained in the object pointed to by I<buf>, instead of the seed "
4392 "associated with the global state variable."
4393 msgstr ""
4394
4395 #. type: Plain text
4396 #: build/C/man3/random_r.3:92
4397 msgid ""
4398 "The B<initstate_r>()  function is like B<initstate>(3)  except that it "
4399 "initializes the state in the object pointed to by I<buf>, rather than "
4400 "initializing the global state variable."
4401 msgstr ""
4402
4403 #. type: Plain text
4404 #: build/C/man3/random_r.3:100
4405 msgid ""
4406 "The B<setstate_r>()  function is like B<setstate>(3)  except that it "
4407 "modifies the state in the object pointer to by I<buf>, rather than modifying "
4408 "the global state variable."
4409 msgstr ""
4410
4411 #. type: Plain text
4412 #: build/C/man3/random_r.3:105
4413 msgid ""
4414 "All of these functions return 0 on success.  On error, -1 is returned, with "
4415 "I<errno> set to indicate the cause of the error."
4416 msgstr ""
4417
4418 #. type: Plain text
4419 #: build/C/man3/random_r.3:110
4420 msgid "A state array of less than 8 bytes was specified to B<initstate_r>()."
4421 msgstr ""
4422
4423 #. type: Plain text
4424 #: build/C/man3/random_r.3:119
4425 msgid "The I<statebuf> or I<buf> argument to B<setstate_r>()  was NULL."
4426 msgstr ""
4427
4428 #. type: Plain text
4429 #: build/C/man3/random_r.3:128
4430 msgid "The I<buf> or I<result> argument to B<random_r>()  was NULL."
4431 msgstr ""
4432
4433 #.  These functions appear to be on Tru64, but don't seem to be on
4434 #.  Solaris, HP-UX, or FreeBSD.
4435 #. type: Plain text
4436 #: build/C/man3/random_r.3:132
4437 msgid "These functions are nonstandard glibc extensions."
4438 msgstr ""
4439
4440 #. type: TH
4441 #: build/C/man3/rpmatch.3:29
4442 #, no-wrap
4443 msgid "RPMATCH"
4444 msgstr ""
4445
4446 #. type: Plain text
4447 #: build/C/man3/rpmatch.3:32
4448 msgid "rpmatch - determine if the answer to a question is affirmative or negative"
4449 msgstr ""
4450
4451 #. type: Plain text
4452 #: build/C/man3/rpmatch.3:37
4453 #, no-wrap
4454 msgid "B<int rpmatch(const char *>I<response>B<);>\n"
4455 msgstr ""
4456
4457 #. type: Plain text
4458 #: build/C/man3/rpmatch.3:46
4459 msgid "B<rpmatch>(): _SVID_SOURCE"
4460 msgstr ""
4461
4462 #. type: Plain text
4463 #: build/C/man3/rpmatch.3:50
4464 msgid ""
4465 "B<rpmatch>()  handles a user response to yes or no questions, with support "
4466 "for internationalization."
4467 msgstr ""
4468
4469 #. type: Plain text
4470 #: build/C/man3/rpmatch.3:57
4471 msgid ""
4472 "I<response> should be a null-terminated string containing a user-supplied "
4473 "response, perhaps obtained with B<fgets>(3)  or B<getline>(3)."
4474 msgstr ""
4475
4476 #. type: Plain text
4477 #: build/C/man3/rpmatch.3:67
4478 msgid ""
4479 "The user's language preference is taken into account per the environment "
4480 "variables B<LANG>, B<LC_MESSAGES>, and B<LC_ALL>, if the program has called "
4481 "B<setlocale>(3)  to effect their changes."
4482 msgstr ""
4483
4484 #. type: Plain text
4485 #: build/C/man3/rpmatch.3:73
4486 msgid ""
4487 "Regardless of the locale, responses matching B<^[Yy]> are always accepted as "
4488 "affirmative, and those matching B<^[Nn]> are always accepted as negative."
4489 msgstr ""
4490
4491 #. type: Plain text
4492 #: build/C/man3/rpmatch.3:82
4493 msgid ""
4494 "After examining I<response>, B<rpmatch>()  returns 0 for a recognized "
4495 "negative response (\"no\"), 1 for a recognized positive response (\"yes\"), "
4496 "and -1 when the value of I<response> is unrecognized."
4497 msgstr ""
4498
4499 #. type: Plain text
4500 #: build/C/man3/rpmatch.3:86
4501 msgid ""
4502 "A return value of -1 may indicate either an invalid input, or some other "
4503 "error.  It is incorrect to only test if the return value is nonzero."
4504 msgstr ""
4505
4506 #. type: Plain text
4507 #: build/C/man3/rpmatch.3:99
4508 msgid ""
4509 "B<rpmatch>()  can fail for any of the reasons that B<regcomp>(3)  or "
4510 "B<regexec>(3)  can fail; the cause of the error is not available from "
4511 "I<errno> or anywhere else, but indicates a failure of the regex engine (but "
4512 "this case is indistinguishable from that of an unrecognized value of "
4513 "I<response>)."
4514 msgstr ""
4515
4516 #.  It is available on at least AIX 5.1 and FreeBSD 6.0.
4517 #. type: Plain text
4518 #: build/C/man3/rpmatch.3:104
4519 msgid ""
4520 "B<rpmatch>()  is not required by any standard, but is available on a few "
4521 "other systems."
4522 msgstr ""
4523
4524 #. type: Plain text
4525 #: build/C/man3/rpmatch.3:119
4526 msgid ""
4527 "The B<rpmatch>()  implementation looks at only the first character of "
4528 "I<response>.  As a consequence, \"nyes\" returns 0, and \"ynever; not in a "
4529 "million years\" returns 1.  It would be preferable to accept input strings "
4530 "much more strictly, for example (using the extended regular expression "
4531 "notation described in B<regex>(7)): B<^([yY]|yes|YES)$> and "
4532 "B<^([nN]|no|NO)$>."
4533 msgstr ""
4534
4535 #. type: Plain text
4536 #: build/C/man3/rpmatch.3:123
4537 msgid ""
4538 "The following program displays the results when B<rpmatch>()  is applied to "
4539 "the string given in the program's command-line argument."
4540 msgstr ""
4541
4542 #. type: Plain text
4543 #: build/C/man3/rpmatch.3:130
4544 #, no-wrap
4545 msgid ""
4546 "#define _SVID_SOURCE\n"
4547 "#include E<lt>locale.hE<gt>\n"
4548 "#include E<lt>stdlib.hE<gt>\n"
4549 "#include E<lt>string.hE<gt>\n"
4550 "#include E<lt>stdio.hE<gt>\n"
4551 msgstr ""
4552
4553 #. type: Plain text
4554 #: build/C/man3/rpmatch.3:138
4555 #, no-wrap
4556 msgid ""
4557 "int\n"
4558 "main(int argc, char *argv[])\n"
4559 "{\n"
4560 "    if (argc != 2 || strcmp(argv[1], \"--help\") == 0) {\n"
4561 "        fprintf(stderr, \"%s response\\en\", argv[0]);\n"
4562 "        exit(EXIT_FAILURE);\n"
4563 "    }\n"
4564 msgstr ""
4565
4566 #. type: Plain text
4567 #: build/C/man3/rpmatch.3:143
4568 #, no-wrap
4569 msgid ""
4570 "    setlocale(LC_ALL, \"\");\n"
4571 "    printf(\"rpmatch() returns: %d\\en\", rpmatch(argv[1]));\n"
4572 "    exit(EXIT_SUCCESS);\n"
4573 "}\n"
4574 msgstr ""
4575
4576 #. type: Plain text
4577 #: build/C/man3/rpmatch.3:150
4578 msgid ""
4579 "B<fgets>(3), B<getline>(3), B<nl_langinfo>(3), B<regcomp>(3), "
4580 "B<setlocale>(3)"
4581 msgstr ""
4582
4583 #. type: TH
4584 #: build/C/man3/setenv.3:37
4585 #, no-wrap
4586 msgid "SETENV"
4587 msgstr ""
4588
4589 #. type: TH
4590 #: build/C/man3/setenv.3:37
4591 #, no-wrap
4592 msgid "2009-09-20"
4593 msgstr ""
4594
4595 #. type: Plain text
4596 #: build/C/man3/setenv.3:40
4597 msgid "setenv - change or add an environment variable"
4598 msgstr ""
4599
4600 #. type: Plain text
4601 #: build/C/man3/setenv.3:45
4602 #, no-wrap
4603 msgid ""
4604 "B<int setenv(const char *>I<name>B<, const char *>I<value>B<, int "
4605 ">I<overwrite>B<);>\n"
4606 msgstr ""
4607
4608 #. type: Plain text
4609 #: build/C/man3/setenv.3:47
4610 #, no-wrap
4611 msgid "B<int unsetenv(const char *>I<name>B<);>\n"
4612 msgstr ""
4613
4614 #. type: Plain text
4615 #: build/C/man3/setenv.3:57
4616 msgid "B<setenv>(), B<unsetenv>():"
4617 msgstr ""
4618
4619 #. type: Plain text
4620 #: build/C/man3/setenv.3:59
4621 msgid ""
4622 "_BSD_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ "
4623 "E<gt>=\\ 600"
4624 msgstr ""
4625
4626 #. type: Plain text
4627 #: build/C/man3/setenv.3:93
4628 msgid ""
4629 "The B<setenv>()  function adds the variable I<name> to the environment with "
4630 "the value I<value>, if I<name> does not already exist.  If I<name> does "
4631 "exist in the environment, then its value is changed to I<value> if "
4632 "I<overwrite> is nonzero; if I<overwrite> is zero, then the value of I<name> "
4633 "is not changed.  This function makes copies of the strings pointed to by "
4634 "I<name> and I<value> (by contrast with B<putenv>(3))."
4635 msgstr ""
4636
4637 #. type: Plain text
4638 #: build/C/man3/setenv.3:104
4639 msgid ""
4640 "The B<unsetenv>()  function deletes the variable I<name> from the "
4641 "environment.  If I<name> does not exist in the environment, then the "
4642 "function succeeds, and the environment is unchanged."
4643 msgstr ""
4644
4645 #. type: Plain text
4646 #: build/C/man3/setenv.3:111
4647 msgid ""
4648 "The B<setenv>()  function returns zero on success, or -1 on error, with "
4649 "I<errno> set to indicate the cause of the error."
4650 msgstr ""
4651
4652 #. type: Plain text
4653 #: build/C/man3/setenv.3:118
4654 msgid ""
4655 "The B<unsetenv>()  function returns zero on success, or -1 on error, with "
4656 "I<errno> set to indicate the cause of the error."
4657 msgstr ""
4658
4659 #. type: Plain text
4660 #: build/C/man3/setenv.3:124
4661 msgid ""
4662 "I<name> is NULL, points to a string of length 0, or contains an \\(aq=\\(aq "
4663 "character."
4664 msgstr ""
4665
4666 #. type: Plain text
4667 #: build/C/man3/setenv.3:127
4668 msgid "Insufficient memory to add a new variable to the environment."
4669 msgstr ""
4670
4671 #. type: Plain text
4672 #: build/C/man3/setenv.3:135
4673 msgid ""
4674 "POSIX.1-2001 does not require B<setenv>()  or B<unsetenv>()  to be "
4675 "reentrant."
4676 msgstr ""
4677
4678 #. type: Plain text
4679 #: build/C/man3/setenv.3:143
4680 msgid ""
4681 "Prior to glibc 2.2.2, B<unsetenv>()  was prototyped as returning I<void>; "
4682 "more recent glibc versions follow the POSIX.1-2001-compliant prototype shown "
4683 "in the SYNOPSIS."
4684 msgstr ""
4685
4686 #. type: Plain text
4687 #: build/C/man3/setenv.3:152
4688 msgid ""
4689 "POSIX.1-2001 specifies that if I<name> contains an \\(aq=\\(aq character, "
4690 "then B<setenv>()  should fail with the error B<EINVAL>; however, versions of "
4691 "glibc before 2.3.4 allowed an \\(aq=\\(aq sign in I<name>."
4692 msgstr ""
4693
4694 #. type: Plain text
4695 #: build/C/man3/setenv.3:157
4696 msgid "B<clearenv>(3), B<getenv>(3), B<putenv>(3), B<environ>(7)"
4697 msgstr ""
4698
4699 #. type: TH
4700 #: build/C/man3/strtod.3:45
4701 #, no-wrap
4702 msgid "STRTOD"
4703 msgstr ""
4704
4705 #. type: Plain text
4706 #: build/C/man3/strtod.3:48
4707 msgid "strtod, strtof, strtold - convert ASCII string to floating-point number"
4708 msgstr ""
4709
4710 #. type: Plain text
4711 #: build/C/man3/strtod.3:52
4712 msgid "B<double strtod(const char *>I<nptr>B<, char **>I<endptr>B<);>"
4713 msgstr ""
4714
4715 #. type: Plain text
4716 #: build/C/man3/strtod.3:54
4717 msgid "B<float strtof(const char *>I<nptr>B<, char **>I<endptr>B<);>"
4718 msgstr ""
4719
4720 #. type: Plain text
4721 #: build/C/man3/strtod.3:56
4722 msgid "B<long double strtold(const char *>I<nptr>B<, char **>I<endptr>B<);>"
4723 msgstr ""
4724
4725 #. type: Plain text
4726 #: build/C/man3/strtod.3:65
4727 msgid "B<strtof>(), B<strtold>():"
4728 msgstr ""
4729
4730 #. type: Plain text
4731 #: build/C/man3/strtod.3:87
4732 msgid ""
4733 "The B<strtod>(), B<strtof>(), and B<strtold>()  functions convert the "
4734 "initial portion of the string pointed to by I<nptr> to I<double>, I<float>, "
4735 "and I<long double> representation, respectively."
4736 msgstr ""
4737
4738 #. type: Plain text
4739 #: build/C/man3/strtod.3:94
4740 msgid ""
4741 "The expected form of the (initial portion of the) string is optional leading "
4742 "white space as recognized by B<isspace>(3), an optional plus (\\(aq+\\(aq) "
4743 "or minus sign (\\(aq-\\(aq) and then either (i) a decimal number, or (ii) a "
4744 "hexadecimal number, or (iii) an infinity, or (iv) a NAN (not-a-number)."
4745 msgstr ""
4746
4747 #. type: Plain text
4748 #: build/C/man3/strtod.3:103
4749 msgid ""
4750 "A I<decimal number> consists of a nonempty sequence of decimal digits "
4751 "possibly containing a radix character (decimal point, locale-dependent, "
4752 "usually \\(aq.\\(aq), optionally followed by a decimal exponent.  A decimal "
4753 "exponent consists of an \\(aqE\\(aq or \\(aqe\\(aq, followed by an optional "
4754 "plus or minus sign, followed by a nonempty sequence of decimal digits, and "
4755 "indicates multiplication by a power of 10."
4756 msgstr ""
4757
4758 #. type: Plain text
4759 #: build/C/man3/strtod.3:114
4760 msgid ""
4761 "A I<hexadecimal number> consists of a \"0x\" or \"0X\" followed by a "
4762 "nonempty sequence of hexadecimal digits possibly containing a radix "
4763 "character, optionally followed by a binary exponent.  A binary exponent "
4764 "consists of a \\(aqP\\(aq or \\(aqp\\(aq, followed by an optional plus or "
4765 "minus sign, followed by a nonempty sequence of decimal digits, and indicates "
4766 "multiplication by a power of 2.  At least one of radix character and binary "
4767 "exponent must be present."
4768 msgstr ""
4769
4770 #. type: Plain text
4771 #: build/C/man3/strtod.3:118
4772 msgid "An I<infinity> is either \"INF\" or \"INFINITY\", disregarding case."
4773 msgstr ""
4774
4775 #.  From glibc 2.8's stdlib/strtod_l.c:
4776 #.      We expect it to be a number which is put in the
4777 #.      mantissa of the number.
4778 #. type: Plain text
4779 #: build/C/man3/strtod.3:128
4780 msgid ""
4781 "A I<NAN> is \"NAN\" (disregarding case) optionally followed by \\(aq(\\(aq, "
4782 "a sequence of characters, followed by \\(aq)\\(aq.  The character string "
4783 "specifies in an implementation-dependent way the type of NAN."
4784 msgstr ""
4785
4786 #. type: Plain text
4787 #: build/C/man3/strtod.3:130
4788 msgid "These functions return the converted value, if any."
4789 msgstr ""
4790
4791 #. type: Plain text
4792 #: build/C/man3/strtod.3:137
4793 msgid ""
4794 "If I<endptr> is not NULL, a pointer to the character after the last "
4795 "character used in the conversion is stored in the location referenced by "
4796 "I<endptr>."
4797 msgstr ""
4798
4799 #. type: Plain text
4800 #: build/C/man3/strtod.3:142
4801 msgid ""
4802 "If no conversion is performed, zero is returned and the value of I<nptr> is "
4803 "stored in the location referenced by I<endptr>."
4804 msgstr ""
4805
4806 #. type: Plain text
4807 #: build/C/man3/strtod.3:156
4808 msgid ""
4809 "If the correct value would cause overflow, plus or minus B<HUGE_VAL> "
4810 "(B<HUGE_VALF>, B<HUGE_VALL>)  is returned (according to the sign of the "
4811 "value), and B<ERANGE> is stored in I<errno>.  If the correct value would "
4812 "cause underflow, zero is returned and B<ERANGE> is stored in I<errno>."
4813 msgstr ""
4814
4815 #. type: TP
4816 #: build/C/man3/strtod.3:157 build/C/man3/strtol.3:151 build/C/man3/strtoul.3:155
4817 #, no-wrap
4818 msgid "B<ERANGE>"
4819 msgstr ""
4820
4821 #. type: Plain text
4822 #: build/C/man3/strtod.3:160
4823 msgid "Overflow or underflow occurred."
4824 msgstr ""
4825
4826 #. type: Plain text
4827 #: build/C/man3/strtod.3:165
4828 msgid "C89 describes B<strtod>(), C99 describes the other two functions."
4829 msgstr ""
4830
4831 #. type: Plain text
4832 #: build/C/man3/strtod.3:174
4833 msgid ""
4834 "Since 0 can legitimately be returned on both success and failure, the "
4835 "calling program should set I<errno> to 0 before the call, and then determine "
4836 "if an error occurred by checking whether I<errno> has a nonzero value after "
4837 "the call."
4838 msgstr ""
4839
4840 #. type: Plain text
4841 #: build/C/man3/strtod.3:179 build/C/man3/strtoul.3:213
4842 msgid ""
4843 "See the example on the B<strtol>(3)  manual page; the use of the functions "
4844 "described in this manual page is similar."
4845 msgstr ""
4846
4847 #. type: Plain text
4848 #: build/C/man3/strtod.3:185
4849 msgid "B<atof>(3), B<atoi>(3), B<atol>(3), B<strtol>(3), B<strtoul>(3)"
4850 msgstr ""
4851
4852 #. type: TH
4853 #: build/C/man3/strtoimax.3:24
4854 #, no-wrap
4855 msgid "STRTOIMAX"
4856 msgstr ""
4857
4858 #. type: TH
4859 #: build/C/man3/strtoimax.3:24
4860 #, no-wrap
4861 msgid "2003-11-28"
4862 msgstr ""
4863
4864 #. type: Plain text
4865 #: build/C/man3/strtoimax.3:27
4866 msgid "strtoimax, strtoumax - convert string to integer"
4867 msgstr ""
4868
4869 #. type: Plain text
4870 #: build/C/man3/strtoimax.3:30
4871 #, no-wrap
4872 msgid "B<#include E<lt>inttypes.hE<gt>>\n"
4873 msgstr ""
4874
4875 #. type: Plain text
4876 #: build/C/man3/strtoimax.3:32
4877 #, no-wrap
4878 msgid ""
4879 "B<intmax_t strtoimax(const char *>I<nptr>B<, char **>I<endptr>B<, int "
4880 ">I<base>B<);>\n"
4881 msgstr ""
4882
4883 #. type: Plain text
4884 #: build/C/man3/strtoimax.3:34
4885 #, no-wrap
4886 msgid ""
4887 "B<uintmax_t strtoumax(const char *>I<nptr>B<, char **>I<endptr>B<, int "
4888 ">I<base>B<);>\n"
4889 msgstr ""
4890
4891 #. type: Plain text
4892 #: build/C/man3/strtoimax.3:45
4893 msgid ""
4894 "These functions are just like B<strtol>(3)  and B<strtoul>(3), except that "
4895 "they return a value of type I<intmax_t> and I<uintmax_t>, respectively."
4896 msgstr ""
4897
4898 #. type: Plain text
4899 #: build/C/man3/strtoimax.3:58
4900 msgid ""
4901 "On success, the converted value is returned.  If nothing was found to "
4902 "convert, zero is returned.  On overflow or underflow B<INTMAX_MAX> or "
4903 "B<INTMAX_MIN> or B<UINTMAX_MAX> is returned, and I<errno> is set to "
4904 "B<ERANGE>."
4905 msgstr ""
4906
4907 #. type: Plain text
4908 #: build/C/man3/strtoimax.3:66
4909 msgid "B<imaxabs>(3), B<imaxdiv>(3), B<strtol>(3), B<strtoul>(3), B<wcstoimax>(3)"
4910 msgstr ""
4911
4912 #. type: TH
4913 #: build/C/man3/strtol.3:31
4914 #, no-wrap
4915 msgid "STRTOL"
4916 msgstr ""
4917
4918 #. type: TH
4919 #: build/C/man3/strtol.3:31
4920 #, no-wrap
4921 msgid "2013-02-10"
4922 msgstr ""
4923
4924 #. type: Plain text
4925 #: build/C/man3/strtol.3:34
4926 msgid "strtol, strtoll, strtoq - convert a string to a long integer"
4927 msgstr ""
4928
4929 #. type: Plain text
4930 #: build/C/man3/strtol.3:39
4931 #, no-wrap
4932 msgid ""
4933 "B<long int strtol(const char *>I<nptr>B<, char **>I<endptr>B<, int "
4934 ">I<base>B<);>\n"
4935 msgstr ""
4936
4937 #. type: Plain text
4938 #: build/C/man3/strtol.3:42
4939 #, no-wrap
4940 msgid ""
4941 "B<long long int strtoll(const char *>I<nptr>B<, char **>I<endptr>B<, int "
4942 ">I<base>B<);>\n"
4943 msgstr ""
4944
4945 #. type: Plain text
4946 #: build/C/man3/strtol.3:51
4947 msgid "B<strtoll>():"
4948 msgstr ""
4949
4950 #. type: Plain text
4951 #: build/C/man3/strtol.3:54 build/C/man3/strtoul.3:57
4952 msgid ""
4953 "XOPEN_SOURCE\\ E<gt>=\\ 600 || _BSD_SOURCE || _SVID_SOURCE || _ISOC99_SOURCE "
4954 "|| _POSIX_C_SOURCE\\ E<gt>=\\ 200112L;"
4955 msgstr ""
4956
4957 #. type: Plain text
4958 #: build/C/man3/strtol.3:68
4959 msgid ""
4960 "The B<strtol>()  function converts the initial part of the string in I<nptr> "
4961 "to a long integer value according to the given I<base>, which must be "
4962 "between 2 and 36 inclusive, or be the special value 0."
4963 msgstr ""
4964
4965 #. type: Plain text
4966 #: build/C/man3/strtol.3:81 build/C/man3/strtoul.3:89
4967 msgid ""
4968 "The string may begin with an arbitrary amount of white space (as determined "
4969 "by B<isspace>(3))  followed by a single optional \\(aq+\\(aq or \\(aq-\\(aq "
4970 "sign.  If I<base> is zero or 16, the string may then include a \"0x\" "
4971 "prefix, and the number will be read in base 16; otherwise, a zero I<base> is "
4972 "taken as 10 (decimal) unless the next character is \\(aq0\\(aq, in which "
4973 "case it is taken as 8 (octal)."
4974 msgstr ""
4975
4976 #. type: Plain text
4977 #: build/C/man3/strtol.3:90
4978 msgid ""
4979 "The remainder of the string is converted to a I<long int> value in the "
4980 "obvious manner, stopping at the first character which is not a valid digit "
4981 "in the given base.  (In bases above 10, the letter \\(aqA\\(aq in either "
4982 "upper or lower case represents 10, \\(aqB\\(aq represents 11, and so forth, "
4983 "with \\(aqZ\\(aq representing 35.)"
4984 msgstr ""
4985
4986 #. type: Plain text
4987 #: build/C/man3/strtol.3:111
4988 msgid ""
4989 "If I<endptr> is not NULL, B<strtol>()  stores the address of the first "
4990 "invalid character in I<*endptr>.  If there were no digits at all, "
4991 "B<strtol>()  stores the original value of I<nptr> in I<*endptr> (and returns "
4992 "0).  In particular, if I<*nptr> is not \\(aq\\e0\\(aq but I<**endptr> is "
4993 "\\(aq\\e0\\(aq on return, the entire string is valid."
4994 msgstr ""
4995
4996 #. type: Plain text
4997 #: build/C/man3/strtol.3:117
4998 msgid ""
4999 "The B<strtoll>()  function works just like the B<strtol>()  function but "
5000 "returns a long long integer value."
5001 msgstr ""
5002
5003 #. type: Plain text
5004 #: build/C/man3/strtol.3:144
5005 msgid ""
5006 "The B<strtol>()  function returns the result of the conversion, unless the "
5007 "value would underflow or overflow.  If an underflow occurs, B<strtol>()  "
5008 "returns B<LONG_MIN>.  If an overflow occurs, B<strtol>()  returns "
5009 "B<LONG_MAX>.  In both cases, I<errno> is set to B<ERANGE>.  Precisely the "
5010 "same holds for B<strtoll>()  (with B<LLONG_MIN> and B<LLONG_MAX> instead of "
5011 "B<LONG_MIN> and B<LONG_MAX>)."
5012 msgstr ""
5013
5014 #. type: Plain text
5015 #: build/C/man3/strtol.3:151 build/C/man3/strtoul.3:155
5016 msgid "(not in C99)  The given I<base> contains an unsupported value."
5017 msgstr ""
5018
5019 #. type: Plain text
5020 #: build/C/man3/strtol.3:154 build/C/man3/strtoul.3:158
5021 msgid "The resulting value was out of range."
5022 msgstr ""
5023
5024 #. type: Plain text
5025 #: build/C/man3/strtol.3:161 build/C/man3/strtoul.3:165
5026 msgid ""
5027 "The implementation may also set I<errno> to B<EINVAL> in case no conversion "
5028 "was performed (no digits seen, and 0 returned)."
5029 msgstr ""
5030
5031 #. type: Plain text
5032 #: build/C/man3/strtol.3:166
5033 msgid ""
5034 "B<strtol>()  conforms to SVr4, 4.3BSD, C89, C99 and POSIX.1-2001, and "
5035 "B<strtoll>()  to C99 and POSIX.1-2001."
5036 msgstr ""
5037
5038 #. type: Plain text
5039 #: build/C/man3/strtol.3:184
5040 msgid ""
5041 "Since B<strtol>()  can legitimately return 0, B<LONG_MAX>, or B<LONG_MIN> "
5042 "(B<LLONG_MAX> or B<LLONG_MIN> for B<strtoll>())  on both success and "
5043 "failure, the calling program should set I<errno> to 0 before the call, and "
5044 "then determine if an error occurred by checking whether I<errno> has a "
5045 "nonzero value after the call."
5046 msgstr ""
5047
5048 #. type: Plain text
5049 #: build/C/man3/strtol.3:189
5050 msgid ""
5051 "According to POSIX.1-2001, in locales other than the \"C\" and \"POSIX\", "
5052 "these functions may accept other, implementation-defined numeric strings."
5053 msgstr ""
5054
5055 #. type: Plain text
5056 #: build/C/man3/strtol.3:191 build/C/man3/strtoul.3:190
5057 msgid "BSD also has"
5058 msgstr ""
5059
5060 #. type: Plain text
5061 #: build/C/man3/strtol.3:195
5062 #, no-wrap
5063 msgid ""
5064 "B<quad_t strtoq(const char *>I<nptr>B<, char **>I<endptr>B<, int "
5065 ">I<base>B<);>\n"
5066 msgstr ""
5067
5068 #. type: Plain text
5069 #: build/C/man3/strtol.3:204
5070 msgid ""
5071 "with completely analogous definition.  Depending on the wordsize of the "
5072 "current architecture, this may be equivalent to B<strtoll>()  or to "
5073 "B<strtol>()."
5074 msgstr ""
5075
5076 #. type: Plain text
5077 #: build/C/man3/strtol.3:218
5078 msgid ""
5079 "The program shown below demonstrates the use of B<strtol>().  The first "
5080 "command-line argument specifies a string from which B<strtol>()  should "
5081 "parse a number.  The second (optional) argument specifies the base to be "
5082 "used for the conversion.  (This argument is converted to numeric form using "
5083 "B<atoi>(3), a function that performs no error checking and has a simpler "
5084 "interface than B<strtol>().)  Some examples of the results produced by this "
5085 "program are the following:"
5086 msgstr ""
5087
5088 #. type: Plain text
5089 #: build/C/man3/strtol.3:234
5090 #, no-wrap
5091 msgid ""
5092 "$B< ./a.out 123>\n"
5093 "strtol() returned 123\n"
5094 "$B< ./a.out \\(aq    123\\(aq>\n"
5095 "strtol() returned 123\n"
5096 "$B< ./a.out 123abc>\n"
5097 "strtol() returned 123\n"
5098 "Further characters after number: abc\n"
5099 "$B< ./a.out 123abc 55>\n"
5100 "strtol: Invalid argument\n"
5101 "$B< ./a.out \\(aq\\(aq>\n"
5102 "No digits were found\n"
5103 "$B< ./a.out 4000000000>\n"
5104 "strtol: Numerical result out of range\n"
5105 msgstr ""
5106
5107 #. type: SS
5108 #: build/C/man3/strtol.3:236
5109 #, no-wrap
5110 msgid "Program source"
5111 msgstr ""
5112
5113 #. type: Plain text
5114 #: build/C/man3/strtol.3:243
5115 #, no-wrap
5116 msgid ""
5117 "#include E<lt>stdlib.hE<gt>\n"
5118 "#include E<lt>limits.hE<gt>\n"
5119 "#include E<lt>stdio.hE<gt>\n"
5120 "#include E<lt>errno.hE<gt>\n"
5121 msgstr ""
5122
5123 #. type: Plain text
5124 #: build/C/man3/strtol.3:250
5125 #, no-wrap
5126 msgid ""
5127 "int\n"
5128 "main(int argc, char *argv[])\n"
5129 "{\n"
5130 "    int base;\n"
5131 "    char *endptr, *str;\n"
5132 "    long val;\n"
5133 msgstr ""
5134
5135 #. type: Plain text
5136 #: build/C/man3/strtol.3:255
5137 #, no-wrap
5138 msgid ""
5139 "    if (argc E<lt> 2) {\n"
5140 "        fprintf(stderr, \"Usage: %s str [base]\\en\", argv[0]);\n"
5141 "        exit(EXIT_FAILURE);\n"
5142 "    }\n"
5143 msgstr ""
5144
5145 #. type: Plain text
5146 #: build/C/man3/strtol.3:258
5147 #, no-wrap
5148 msgid ""
5149 "    str = argv[1];\n"
5150 "    base = (argc E<gt> 2) ? atoi(argv[2]) : 10;\n"
5151 msgstr ""
5152
5153 #. type: Plain text
5154 #: build/C/man3/strtol.3:261
5155 #, no-wrap
5156 msgid ""
5157 "    errno = 0;    /* To distinguish success/failure after call */\n"
5158 "    val = strtol(str, &endptr, base);\n"
5159 msgstr ""
5160
5161 #. type: Plain text
5162 #: build/C/man3/strtol.3:263
5163 #, no-wrap
5164 msgid "    /* Check for various possible errors */\n"
5165 msgstr ""
5166
5167 #. type: Plain text
5168 #: build/C/man3/strtol.3:269
5169 #, no-wrap
5170 msgid ""
5171 "    if ((errno == ERANGE && (val == LONG_MAX || val == LONG_MIN))\n"
5172 "            || (errno != 0 && val == 0)) {\n"
5173 "        perror(\"strtol\");\n"
5174 "        exit(EXIT_FAILURE);\n"
5175 "    }\n"
5176 msgstr ""
5177
5178 #. type: Plain text
5179 #: build/C/man3/strtol.3:274
5180 #, no-wrap
5181 msgid ""
5182 "    if (endptr == str) {\n"
5183 "        fprintf(stderr, \"No digits were found\\en\");\n"
5184 "        exit(EXIT_FAILURE);\n"
5185 "    }\n"
5186 msgstr ""
5187
5188 #. type: Plain text
5189 #: build/C/man3/strtol.3:276
5190 #, no-wrap
5191 msgid "    /* If we got here, strtol() successfully parsed a number */\n"
5192 msgstr ""
5193
5194 #. type: Plain text
5195 #: build/C/man3/strtol.3:278
5196 #, no-wrap
5197 msgid "    printf(\"strtol() returned %ld\\en\", val);\n"
5198 msgstr ""
5199
5200 #. type: Plain text
5201 #: build/C/man3/strtol.3:281
5202 #, no-wrap
5203 msgid ""
5204 "    if (*endptr != \\(aq\\e0\\(aq)        /* Not necessarily an "
5205 "error... */\n"
5206 "        printf(\"Further characters after number: %s\\en\", endptr);\n"
5207 msgstr ""
5208
5209 #. type: Plain text
5210 #: build/C/man3/strtol.3:291
5211 msgid "B<atof>(3), B<atoi>(3), B<atol>(3), B<strtod>(3), B<strtoul>(3)"
5212 msgstr ""
5213
5214 #. type: TH
5215 #: build/C/man3/strtoul.3:33
5216 #, no-wrap
5217 msgid "STRTOUL"
5218 msgstr ""
5219
5220 #. type: TH
5221 #: build/C/man3/strtoul.3:33
5222 #, no-wrap
5223 msgid "2011-09-15"
5224 msgstr ""
5225
5226 #. type: Plain text
5227 #: build/C/man3/strtoul.3:36
5228 msgid "strtoul, strtoull, strtouq - convert a string to an unsigned long integer"
5229 msgstr ""
5230
5231 #. type: Plain text
5232 #: build/C/man3/strtoul.3:42
5233 #, no-wrap
5234 msgid ""
5235 "B<unsigned long int strtoul(const char *>I<nptr>B<, char **>I<endptr>B<, int "
5236 ">I<base>B<);>\n"
5237 msgstr ""
5238
5239 #. type: Plain text
5240 #: build/C/man3/strtoul.3:45
5241 #, no-wrap
5242 msgid ""
5243 "B<unsigned long long int strtoull(const char *>I<nptr>B<, char "
5244 "**>I<endptr>B<,>\n"
5245 "B<                                int >I<base>B<);>\n"
5246 msgstr ""
5247
5248 #. type: Plain text
5249 #: build/C/man3/strtoul.3:54
5250 msgid "B<strtoull>():"
5251 msgstr ""
5252
5253 #. type: Plain text
5254 #: build/C/man3/strtoul.3:75
5255 msgid ""
5256 "The B<strtoul>()  function converts the initial part of the string in "
5257 "I<nptr> to an I<unsigned long int> value according to the given I<base>, "
5258 "which must be between 2 and 36 inclusive, or be the special value 0."
5259 msgstr ""
5260
5261 #. type: Plain text
5262 #: build/C/man3/strtoul.3:98
5263 msgid ""
5264 "The remainder of the string is converted to an I<unsigned long int> value in "
5265 "the obvious manner, stopping at the first character which is not a valid "
5266 "digit in the given base.  (In bases above 10, the letter \\(aqA\\(aq in "
5267 "either upper or lower case represents 10, \\(aqB\\(aq represents 11, and so "
5268 "forth, with \\(aqZ\\(aq representing 35.)"
5269 msgstr ""
5270
5271 #. type: Plain text
5272 #: build/C/man3/strtoul.3:119
5273 msgid ""
5274 "If I<endptr> is not NULL, B<strtoul>()  stores the address of the first "
5275 "invalid character in I<*endptr>.  If there were no digits at all, "
5276 "B<strtoul>()  stores the original value of I<nptr> in I<*endptr> (and "
5277 "returns 0).  In particular, if I<*nptr> is not \\(aq\\e0\\(aq but "
5278 "I<**endptr> is \\(aq\\e0\\(aq on return, the entire string is valid."
5279 msgstr ""
5280
5281 #. type: Plain text
5282 #: build/C/man3/strtoul.3:127
5283 msgid ""
5284 "The B<strtoull>()  function works just like the B<strtoul>()  function but "
5285 "returns an I<unsigned long long int> value."
5286 msgstr ""
5287
5288 #. type: Plain text
5289 #: build/C/man3/strtoul.3:148
5290 msgid ""
5291 "The B<strtoul>()  function returns either the result of the conversion or, "
5292 "if there was a leading minus sign, the negation of the result of the "
5293 "conversion represented as an unsigned value, unless the original "
5294 "(nonnegated) value would overflow; in the latter case, B<strtoul>()  returns "
5295 "B<ULONG_MAX> and sets I<errno> to B<ERANGE>.  Precisely the same holds for "
5296 "B<strtoull>()  (with B<ULLONG_MAX> instead of B<ULONG_MAX>)."
5297 msgstr ""
5298
5299 #. type: Plain text
5300 #: build/C/man3/strtoul.3:170
5301 msgid ""
5302 "B<strtoul>()  conforms to SVr4, C89, C99 and POSIX-2001, and B<strtoull>()  "
5303 "to C99 and POSIX.1-2001."
5304 msgstr ""
5305
5306 #. type: Plain text
5307 #: build/C/man3/strtoul.3:184
5308 msgid ""
5309 "Since B<strtoul>()  can legitimately return 0 or B<ULONG_MAX> (B<ULLONG_MAX> "
5310 "for B<strtoull>())  on both success and failure, the calling program should "
5311 "set I<errno> to 0 before the call, and then determine if an error occurred "
5312 "by checking whether I<errno> has a nonzero value after the call."
5313 msgstr ""
5314
5315 #. type: Plain text
5316 #: build/C/man3/strtoul.3:188
5317 msgid ""
5318 "In locales other than the \"C\" locale, other strings may be accepted.  (For "
5319 "example, the thousands separator of the current locale may be supported.)"
5320 msgstr ""
5321
5322 #. type: Plain text
5323 #: build/C/man3/strtoul.3:194
5324 #, no-wrap
5325 msgid ""
5326 "B<u_quad_t strtouq(const char *>I<nptr>B<, char **>I<endptr>B<, int "
5327 ">I<base>B<);>\n"
5328 msgstr ""
5329
5330 #. type: Plain text
5331 #: build/C/man3/strtoul.3:203
5332 msgid ""
5333 "with completely analogous definition.  Depending on the wordsize of the "
5334 "current architecture, this may be equivalent to B<strtoull>()  or to "
5335 "B<strtoul>()."
5336 msgstr ""
5337
5338 #. type: Plain text
5339 #: build/C/man3/strtoul.3:208
5340 msgid ""
5341 "Negative values are considered valid input and are silently converted to the "
5342 "equivalent I<unsigned long int> value."
5343 msgstr ""
5344
5345 #. type: Plain text
5346 #: build/C/man3/strtoul.3:219
5347 msgid "B<atof>(3), B<atoi>(3), B<atol>(3), B<strtod>(3), B<strtol>(3)"
5348 msgstr ""
5349
5350 #. type: TH
5351 #: build/C/man3/system.3:30
5352 #, no-wrap
5353 msgid "SYSTEM"
5354 msgstr ""
5355
5356 #. type: TH
5357 #: build/C/man3/system.3:30
5358 #, no-wrap
5359 msgid "2010-09-10"
5360 msgstr ""
5361
5362 #. type: Plain text
5363 #: build/C/man3/system.3:33
5364 msgid "system - execute a shell command"
5365 msgstr ""
5366
5367 #. type: Plain text
5368 #: build/C/man3/system.3:38
5369 #, no-wrap
5370 msgid "B<int system(const char *>I<command>B<);>\n"
5371 msgstr ""
5372
5373 #. type: Plain text
5374 #: build/C/man3/system.3:54
5375 msgid ""
5376 "B<system>()  executes a command specified in I<command> by calling B</bin/sh "
5377 "-c> I<command>, and returns after the command has been completed.  During "
5378 "execution of the command, B<SIGCHLD> will be blocked, and B<SIGINT> and "
5379 "B<SIGQUIT> will be ignored."
5380 msgstr ""
5381
5382 #. type: Plain text
5383 #: build/C/man3/system.3:69
5384 msgid ""
5385 "The value returned is -1 on error (e.g., B<fork>(2)  failed), and the return "
5386 "status of the command otherwise.  This latter return status is in the format "
5387 "specified in B<wait>(2).  Thus, the exit code of the command will be "
5388 "I<WEXITSTATUS(status)>.  In case I</bin/sh> could not be executed, the exit "
5389 "status will be that of a command that does I<exit(127)>."
5390 msgstr ""
5391
5392 #. type: Plain text
5393 #: build/C/man3/system.3:75
5394 msgid ""
5395 "If the value of I<command> is NULL, B<system>()  returns nonzero if the "
5396 "shell is available, and zero if not."
5397 msgstr ""
5398
5399 #. type: Plain text
5400 #: build/C/man3/system.3:78
5401 msgid "B<system>()  does not affect the wait status of any other children."
5402 msgstr ""
5403
5404 #. type: Plain text
5405 #: build/C/man3/system.3:80
5406 msgid "C89, C99, POSIX.1-2001."
5407 msgstr ""
5408
5409 #. type: Plain text
5410 #: build/C/man3/system.3:93
5411 msgid ""
5412 "If the B<_XOPEN_SOURCE> feature test macro is defined (before including "
5413 "I<any> header files), then the macros described in B<wait>(2)  "
5414 "(B<WEXITSTATUS>(), etc.) are made available when including "
5415 "I<E<lt>stdlib.hE<gt>>."
5416 msgstr ""
5417
5418 #. type: Plain text
5419 #: build/C/man3/system.3:104
5420 msgid ""
5421 "As mentioned, B<system>()  ignores B<SIGINT> and B<SIGQUIT>.  This may make "
5422 "programs that call it from a loop uninterruptible, unless they take care "
5423 "themselves to check the exit status of the child.  E.g."
5424 msgstr ""
5425
5426 #. type: Plain text
5427 #: build/C/man3/system.3:109
5428 #, no-wrap
5429 msgid ""
5430 "    while (something) {\n"
5431 "        int ret = system(\"foo\");\n"
5432 msgstr ""
5433
5434 #. type: Plain text
5435 #: build/C/man3/system.3:114
5436 #, no-wrap
5437 msgid ""
5438 "        if (WIFSIGNALED(ret) &&\n"
5439 "            (WTERMSIG(ret) == SIGINT || WTERMSIG(ret) == SIGQUIT))\n"
5440 "                break;\n"
5441 "    }\n"
5442 msgstr ""
5443
5444 #. type: Plain text
5445 #: build/C/man3/system.3:134
5446 msgid ""
5447 "Do not use B<system>()  from a program with set-user-ID or set-group-ID "
5448 "privileges, because strange values for some environment variables might be "
5449 "used to subvert system integrity.  Use the B<exec>(3)  family of functions "
5450 "instead, but not B<execlp>(3)  or B<execvp>(3).  B<system>()  will not, in "
5451 "fact, work properly from programs with set-user-ID or set-group-ID "
5452 "privileges on systems on which I</bin/sh> is bash version 2, since bash 2 "
5453 "drops privileges on startup.  (Debian uses a modified bash which does not do "
5454 "this when invoked as B<sh>.)"
5455 msgstr ""
5456
5457 #. type: Plain text
5458 #: build/C/man3/system.3:148
5459 msgid ""
5460 "In versions of glibc before 2.1.3, the check for the availability of "
5461 "I</bin/sh> was not actually performed if I<command> was NULL; instead it was "
5462 "always assumed to be available, and B<system>()  always returned 1 in this "
5463 "case.  Since glibc 2.1.3, this check is performed because, even though "
5464 "POSIX.1-2001 requires a conforming implementation to provide a shell, that "
5465 "shell may not be available or executable if the calling program has "
5466 "previously called B<chroot>(2)  (which is not specified by POSIX.1-2001)."
5467 msgstr ""
5468
5469 #. type: Plain text
5470 #: build/C/man3/system.3:153
5471 msgid ""
5472 "It is possible for the shell command to return 127, so that code is not a "
5473 "sure indication that the B<execve>(2)  call failed."
5474 msgstr ""
5475
5476 #. type: Plain text
5477 #: build/C/man3/system.3:158
5478 msgid "B<sh>(1), B<signal>(2), B<wait>(2), B<exec>(3)"
5479 msgstr ""
5480
5481 #. type: TH
5482 #: build/C/man3/wcstombs.3:16
5483 #, no-wrap
5484 msgid "WCSTOMBS"
5485 msgstr ""
5486
5487 #. type: TH
5488 #: build/C/man3/wcstombs.3:16
5489 #, no-wrap
5490 msgid "2011-10-16"
5491 msgstr ""
5492
5493 #. type: Plain text
5494 #: build/C/man3/wcstombs.3:19
5495 msgid "wcstombs - convert a wide-character string to a multibyte string"
5496 msgstr ""
5497
5498 #. type: Plain text
5499 #: build/C/man3/wcstombs.3:24
5500 #, no-wrap
5501 msgid ""
5502 "B<size_t wcstombs(char *>I<dest>B<, const wchar_t *>I<src>B<, size_t "
5503 ">I<n>B<);>\n"
5504 msgstr ""
5505
5506 #. type: Plain text
5507 #: build/C/man3/wcstombs.3:42
5508 msgid ""
5509 "If I<dest> is not a NULL pointer, the B<wcstombs>()  function converts the "
5510 "wide-character string I<src> to a multibyte string starting at I<dest>.  At "
5511 "most I<n> bytes are written to I<dest>.  The conversion starts in the "
5512 "initial state.  The conversion can stop for three reasons:"
5513 msgstr ""
5514
5515 #. type: Plain text
5516 #: build/C/man3/wcstombs.3:48
5517 msgid ""
5518 "1. A wide character has been encountered that can not be represented as a "
5519 "multibyte sequence (according to the current locale).  In this case "
5520 "I<(size_t)\\ -1> is returned."
5521 msgstr ""
5522
5523 #. type: Plain text
5524 #: build/C/man3/wcstombs.3:53
5525 msgid ""
5526 "2. The length limit forces a stop.  In this case the number of bytes written "
5527 "to I<dest> is returned, but the shift state at this point is lost."
5528 msgstr ""
5529
5530 #. type: Plain text
5531 #: build/C/man3/wcstombs.3:60
5532 msgid ""
5533 "3. The wide-character string has been completely converted, including the "
5534 "terminating null wide character (L\\(aq\\e0\\(aq).  In this case the "
5535 "conversion ends in the initial state.  The number of bytes written to "
5536 "I<dest>, excluding the terminating null byte (\\(aq\\e0\\(aq), is returned."
5537 msgstr ""
5538
5539 #. type: Plain text
5540 #: build/C/man3/wcstombs.3:66
5541 msgid ""
5542 "The programmer must ensure that there is room for at least I<n> bytes at "
5543 "I<dest>."
5544 msgstr ""
5545
5546 #. type: Plain text
5547 #: build/C/man3/wcstombs.3:74
5548 msgid ""
5549 "If I<dest> is NULL, I<n> is ignored, and the conversion proceeds as above, "
5550 "except that the converted bytes are not written out to memory, and that no "
5551 "length limit exists."
5552 msgstr ""
5553
5554 #. type: Plain text
5555 #: build/C/man3/wcstombs.3:79
5556 msgid ""
5557 "In order to avoid the case 2 above, the programmer should make sure I<n> is "
5558 "greater or equal to I<wcstombs(NULL,src,0)+1>."
5559 msgstr ""
5560
5561 #. type: Plain text
5562 #: build/C/man3/wcstombs.3:88
5563 msgid ""
5564 "The B<wcstombs>()  function returns the number of bytes that make up the "
5565 "converted part of multibyte sequence, not including the terminating null "
5566 "byte.  If a wide character was encountered which could not be converted, "
5567 "I<(size_t)\\ -1> is returned."
5568 msgstr ""
5569
5570 #. type: Plain text
5571 #: build/C/man3/wcstombs.3:97
5572 msgid ""
5573 "The behavior of B<wcstombs>()  depends on the B<LC_CTYPE> category of the "
5574 "current locale."
5575 msgstr ""
5576
5577 #. type: Plain text
5578 #: build/C/man3/wcstombs.3:102
5579 msgid ""
5580 "The function B<wcsrtombs>(3)  provides a thread safe interface to the same "
5581 "functionality."
5582 msgstr ""
5583
5584 #. type: Plain text
5585 #: build/C/man3/wcstombs.3:105
5586 msgid "B<mbstowcs>(3), B<wcsrtombs>(3)"
5587 msgstr ""
5588
5589 #. type: TH
5590 #: build/C/man3/wctomb.3:16
5591 #, no-wrap
5592 msgid "WCTOMB"
5593 msgstr ""
5594
5595 #. type: TH
5596 #: build/C/man3/wctomb.3:16
5597 #, no-wrap
5598 msgid "1999-07-25"
5599 msgstr ""
5600
5601 #. type: Plain text
5602 #: build/C/man3/wctomb.3:19
5603 msgid "wctomb - convert a wide character to a multibyte sequence"
5604 msgstr ""
5605
5606 #. type: Plain text
5607 #: build/C/man3/wctomb.3:24
5608 #, no-wrap
5609 msgid "B<int wctomb(char *>I<s>B<, wchar_t >I<wc>B<);>\n"
5610 msgstr ""
5611
5612 #. type: Plain text
5613 #: build/C/man3/wctomb.3:45
5614 msgid ""
5615 "If I<s> is not NULL, the B<wctomb>()  function converts the wide character "
5616 "I<wc> to its multibyte representation and stores it at the beginning of the "
5617 "character array pointed to by I<s>.  It updates the shift state, which is "
5618 "stored in a static anonymous variable known only to the B<wctomb>()  "
5619 "function, and returns the length of said multibyte representation, that is, "
5620 "the number of bytes written at I<s>."
5621 msgstr ""
5622
5623 #. type: Plain text
5624 #: build/C/man3/wctomb.3:51
5625 msgid ""
5626 "The programmer must ensure that there is room for at least B<MB_CUR_MAX> "
5627 "bytes at I<s>."
5628 msgstr ""
5629
5630 #.  The Dinkumware doc and the Single UNIX specification say this, but
5631 #.  glibc doesn't implement this.
5632 #. type: Plain text
5633 #: build/C/man3/wctomb.3:63
5634 msgid ""
5635 "If I<s> is NULL, the B<wctomb>()  function resets the shift state, known "
5636 "only to this function, to the initial state, and returns nonzero if the "
5637 "encoding has nontrivial shift state, or zero if the encoding is stateless."
5638 msgstr ""
5639
5640 #. type: Plain text
5641 #: build/C/man3/wctomb.3:77
5642 msgid ""
5643 "If I<s> is not NULL, the B<wctomb>()  function returns the number of bytes "
5644 "that have been written to the byte array at I<s>.  If I<wc> can not be "
5645 "represented as a multibyte sequence (according to the current locale), -1 is "
5646 "returned."
5647 msgstr ""
5648
5649 #. type: Plain text
5650 #: build/C/man3/wctomb.3:84
5651 msgid ""
5652 "If I<s> is NULL, the B<wctomb>()  function returns nonzero if the encoding "
5653 "has nontrivial shift state, or zero if the encoding is stateless."
5654 msgstr ""
5655
5656 #. type: Plain text
5657 #: build/C/man3/wctomb.3:93
5658 msgid ""
5659 "The behavior of B<wctomb>()  depends on the B<LC_CTYPE> category of the "
5660 "current locale."
5661 msgstr ""
5662
5663 #. type: Plain text
5664 #: build/C/man3/wctomb.3:99
5665 msgid ""
5666 "This function is not multithread safe.  The function B<wcrtomb>(3)  provides "
5667 "a better interface to the same functionality."
5668 msgstr ""
5669
5670 #. type: Plain text
5671 #: build/C/man3/wctomb.3:103
5672 msgid "B<MB_CUR_MAX>(3), B<wcrtomb>(3), B<wcstombs>(3)"
5673 msgstr ""