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