po4a/pwdgrp/po/pwdgrp.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-01 22:50+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/fgetgrent.3:30
  21 #, no-wrap
  22 msgid "FGETGRENT"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man3/fgetgrent.3:30 build/C/man3/getgrent_r.3:24 build/C/man3/getgrnam.3:33 build/C/man3/getgrouplist.3:29
  27 #, no-wrap
  28 msgid "2014-08-19"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man3/fgetgrent.3:30 build/C/man3/fgetpwent.3:33 build/C/man3/getgrent_r.3:24 build/C/man3/getgrouplist.3:29 build/C/man3/getpw.3:32 build/C/man3/getpwent.3:33 build/C/man3/getpwent_r.3:24 build/C/man3/getpwnam.3:37 build/C/man3/getspnam.3:8 build/C/man3/initgroups.3:32 build/C/man3/putgrent.3:7 build/C/man3/putpwent.3:30 build/C/man3/setaliasent.3:9
  33 #, no-wrap
  34 msgid "GNU"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man3/fgetgrent.3:30 build/C/man3/fgetpwent.3:33 build/C/man5/ftpusers.5:19 build/C/man3/getgrent.3:30 build/C/man3/getgrent_r.3:24 build/C/man3/getgrnam.3:33 build/C/man3/getgrouplist.3:29 build/C/man3/getpw.3:32 build/C/man3/getpwent.3:33 build/C/man3/getpwent_r.3:24 build/C/man3/getpwnam.3:37 build/C/man3/getspnam.3:8 build/C/man5/group.5:26 build/C/man3/initgroups.3:32 build/C/man5/passwd.5:30 build/C/man3/putgrent.3:7 build/C/man3/putpwent.3:30 build/C/man3/setaliasent.3:9
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man3/fgetgrent.3:31 build/C/man3/fgetpwent.3:34 build/C/man5/ftpusers.5:20 build/C/man3/getgrent.3:31 build/C/man3/getgrent_r.3:25 build/C/man3/getgrnam.3:34 build/C/man3/getgrouplist.3:30 build/C/man3/getpw.3:33 build/C/man3/getpwent.3:34 build/C/man3/getpwent_r.3:25 build/C/man3/getpwnam.3:38 build/C/man3/getspnam.3:9 build/C/man5/group.5:27 build/C/man3/initgroups.3:33 build/C/man5/passwd.5:31 build/C/man3/putgrent.3:8 build/C/man3/putpwent.3:31 build/C/man3/setaliasent.3:10
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man3/fgetgrent.3:33
  51 msgid "fgetgrent - get group file entry"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man3/fgetgrent.3:33 build/C/man3/fgetpwent.3:36 build/C/man3/getgrent.3:33 build/C/man3/getgrent_r.3:27 build/C/man3/getgrnam.3:36 build/C/man3/getgrouplist.3:32 build/C/man3/getpw.3:35 build/C/man3/getpwent.3:36 build/C/man3/getpwent_r.3:27 build/C/man3/getpwnam.3:40 build/C/man3/getspnam.3:13 build/C/man3/initgroups.3:35 build/C/man3/putgrent.3:10 build/C/man3/putpwent.3:33 build/C/man3/setaliasent.3:13
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man3/fgetgrent.3:38
  62 #, no-wrap
  63 msgid ""
  64 "B<#include E<lt>stdio.hE<gt>>\n"
  65 "B<#include E<lt>sys/types.hE<gt>>\n"
  66 "B<#include E<lt>grp.hE<gt>>\n"
  67 msgstr ""
  68
  69 #. type: Plain text
  70 #: build/C/man3/fgetgrent.3:40
  71 #, no-wrap
  72 msgid "B<struct group *fgetgrent(FILE *>I<stream>B<);>\n"
  73 msgstr ""
  74
  75 #. type: Plain text
  76 #: build/C/man3/fgetgrent.3:45 build/C/man3/fgetpwent.3:48 build/C/man3/getgrent.3:48 build/C/man3/getgrent_r.3:43 build/C/man3/getgrnam.3:57 build/C/man3/getgrouplist.3:42 build/C/man3/getpwent.3:51 build/C/man3/getpwent_r.3:43 build/C/man3/getpwnam.3:61 build/C/man3/getspnam.3:61 build/C/man3/initgroups.3:46 build/C/man3/putpwent.3:45
  77 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
  78 msgstr ""
  79
  80 #. type: Plain text
  81 #: build/C/man3/fgetgrent.3:49
  82 msgid "B<fgetgrent>(): _SVID_SOURCE"
  83 msgstr ""
  84
  85 #. type: SH
  86 #: build/C/man3/fgetgrent.3:49 build/C/man3/fgetpwent.3:52 build/C/man5/ftpusers.5:22 build/C/man3/getgrent.3:68 build/C/man3/getgrent_r.3:51 build/C/man3/getgrnam.3:67 build/C/man3/getgrouplist.3:46 build/C/man3/getpw.3:43 build/C/man3/getpwent.3:62 build/C/man3/getpwent_r.3:50 build/C/man3/getpwnam.3:71 build/C/man3/getspnam.3:72 build/C/man5/group.5:29 build/C/man3/initgroups.3:50 build/C/man5/passwd.5:33 build/C/man3/putgrent.3:16 build/C/man3/putpwent.3:49 build/C/man3/setaliasent.3:31
  87 #, no-wrap
  88 msgid "DESCRIPTION"
  89 msgstr ""
  90
  91 #. type: Plain text
  92 #: build/C/man3/fgetgrent.3:63
  93 msgid ""
  94 "The B<fgetgrent>()  function returns a pointer to a structure containing the "
  95 "group information from the file referred to by I<stream>.  The first time it "
  96 "is called it returns the first entry; thereafter, it returns successive "
  97 "entries.  The file referred to by I<stream> must have the same format as "
  98 "I</etc/group> (see B<group>(5))."
  99 msgstr ""
 100
 101 #. type: Plain text
 102 #: build/C/man3/fgetgrent.3:65 build/C/man3/getgrent.3:92 build/C/man3/getgrent_r.3:68 build/C/man3/getgrnam.3:86
 103 msgid "The I<group> structure is defined in I<E<lt>grp.hE<gt>> as follows:"
 104 msgstr ""
 105
 106 #. type: Plain text
 107 #: build/C/man3/fgetgrent.3:75 build/C/man3/getgrent.3:102 build/C/man3/getgrent_r.3:78 build/C/man3/getgrnam.3:96
 108 #, no-wrap
 109 msgid ""
 110 "struct group {\n"
 111 "    char   *gr_name;        /* group name */\n"
 112 "    char   *gr_passwd;      /* group password */\n"
 113 "    gid_t   gr_gid;         /* group ID */\n"
 114 "    char  **gr_mem;         /* NULL-terminated array of pointers\n"
 115 "                               to names of group members */\n"
 116 "};\n"
 117 msgstr ""
 118
 119 #. type: SH
 120 #: build/C/man3/fgetgrent.3:77 build/C/man3/fgetpwent.3:81 build/C/man3/getgrent.3:107 build/C/man3/getgrent_r.3:102 build/C/man3/getgrnam.3:137 build/C/man3/getgrouplist.3:78 build/C/man3/getpw.3:72 build/C/man3/getpwent.3:103 build/C/man3/getpwent_r.3:103 build/C/man3/getpwnam.3:143 build/C/man3/getspnam.3:216 build/C/man3/initgroups.3:68 build/C/man3/putgrent.3:42 build/C/man3/putpwent.3:70 build/C/man3/setaliasent.3:89
 121 #, no-wrap
 122 msgid "RETURN VALUE"
 123 msgstr ""
 124
 125 #. type: Plain text
 126 #: build/C/man3/fgetgrent.3:87
 127 msgid ""
 128 "The B<fgetgrent>()  function returns a pointer to a I<group> structure, or "
 129 "NULL if there are no more entries or an error occurs.  In the event of an "
 130 "error, I<errno> is set to indicate the cause."
 131 msgstr ""
 132
 133 #. type: SH
 134 #: build/C/man3/fgetgrent.3:87 build/C/man3/fgetpwent.3:91 build/C/man3/getgrent.3:130 build/C/man3/getgrent_r.3:109 build/C/man3/getgrnam.3:175 build/C/man3/getpw.3:78 build/C/man3/getpwent.3:125 build/C/man3/getpwent_r.3:110 build/C/man3/getpwnam.3:181 build/C/man3/getspnam.3:229 build/C/man3/initgroups.3:75 build/C/man3/putpwent.3:78
 135 #, no-wrap
 136 msgid "ERRORS"
 137 msgstr ""
 138
 139 #. type: TP
 140 #: build/C/man3/fgetgrent.3:88 build/C/man3/fgetpwent.3:92 build/C/man3/getgrent.3:153 build/C/man3/getgrnam.3:197 build/C/man3/getpw.3:87 build/C/man3/getpwent.3:140 build/C/man3/getpwnam.3:203 build/C/man3/initgroups.3:76
 141 #, no-wrap
 142 msgid "B<ENOMEM>"
 143 msgstr ""
 144
 145 #.  not in POSIX
 146 #.  to allocate the group structure, or to allocate buffers
 147 #. type: Plain text
 148 #: build/C/man3/fgetgrent.3:93 build/C/man3/getgrent.3:159 build/C/man3/getgrnam.3:204
 149 msgid "Insufficient memory to allocate I<group> structure."
 150 msgstr ""
 151
 152 #. type: SH
 153 #: build/C/man3/fgetgrent.3:93 build/C/man3/fgetpwent.3:101 build/C/man3/getgrent.3:177 build/C/man3/getgrent_r.3:117 build/C/man3/getgrnam.3:224 build/C/man3/getgrouplist.3:98 build/C/man3/getpw.3:96 build/C/man3/getpwent.3:165 build/C/man3/getpwent_r.3:118 build/C/man3/getpwnam.3:230 build/C/man3/getspnam.3:249 build/C/man3/initgroups.3:88 build/C/man3/putgrent.3:44 build/C/man3/putpwent.3:82 build/C/man3/setaliasent.3:101
 154 #, no-wrap
 155 msgid "CONFORMING TO"
 156 msgstr ""
 157
 158 #. type: Plain text
 159 #: build/C/man3/fgetgrent.3:95 build/C/man3/fgetpwent.3:103 build/C/man3/putpwent.3:84
 160 msgid "SVr4."
 161 msgstr ""
 162
 163 #. type: SH
 164 #: build/C/man3/fgetgrent.3:95 build/C/man3/fgetpwent.3:103 build/C/man5/ftpusers.5:49 build/C/man3/getgrent.3:179 build/C/man3/getgrent_r.3:184 build/C/man3/getgrnam.3:247 build/C/man3/getgrouplist.3:189 build/C/man3/getpw.3:105 build/C/man3/getpwent.3:170 build/C/man3/getpwent_r.3:180 build/C/man3/getpwnam.3:326 build/C/man3/getspnam.3:253 build/C/man5/group.5:61 build/C/man3/initgroups.3:90 build/C/man5/passwd.5:162 build/C/man3/putgrent.3:46 build/C/man3/putpwent.3:84 build/C/man3/setaliasent.3:145
 165 #, no-wrap
 166 msgid "SEE ALSO"
 167 msgstr ""
 168
 169 #. type: Plain text
 170 #: build/C/man3/fgetgrent.3:105
 171 msgid ""
 172 "B<endgrent>(3), B<fgetgrent_r>(3), B<fopen>(3), B<getgrent>(3), "
 173 "B<getgrgid>(3), B<getgrnam>(3), B<putgrent>(3), B<setgrent>(3), B<group>(5)"
 174 msgstr ""
 175
 176 #. type: SH
 177 #: build/C/man3/fgetgrent.3:105 build/C/man3/fgetpwent.3:114 build/C/man5/ftpusers.5:53 build/C/man3/getgrent.3:187 build/C/man3/getgrent_r.3:191 build/C/man3/getgrnam.3:254 build/C/man3/getgrouplist.3:196 build/C/man3/getpw.3:114 build/C/man3/getpwent.3:178 build/C/man3/getpwent_r.3:188 build/C/man3/getpwnam.3:336 build/C/man3/getspnam.3:258 build/C/man5/group.5:67 build/C/man3/initgroups.3:94 build/C/man5/passwd.5:171 build/C/man3/putgrent.3:50 build/C/man3/putpwent.3:92 build/C/man3/setaliasent.3:154
 178 #, no-wrap
 179 msgid "COLOPHON"
 180 msgstr ""
 181
 182 #. type: Plain text
 183 #: build/C/man3/fgetgrent.3:113 build/C/man3/fgetpwent.3:122 build/C/man5/ftpusers.5:61 build/C/man3/getgrent.3:195 build/C/man3/getgrent_r.3:199 build/C/man3/getgrnam.3:262 build/C/man3/getgrouplist.3:204 build/C/man3/getpw.3:122 build/C/man3/getpwent.3:186 build/C/man3/getpwent_r.3:196 build/C/man3/getpwnam.3:344 build/C/man3/getspnam.3:266 build/C/man5/group.5:75 build/C/man3/initgroups.3:102 build/C/man5/passwd.5:179 build/C/man3/putgrent.3:58 build/C/man3/putpwent.3:100 build/C/man3/setaliasent.3:162
 184 msgid ""
 185 "This page is part of release 3.75 of the Linux I<man-pages> project.  A "
 186 "description of the project, information about reporting bugs, and the latest "
 187 "version of this page, can be found at "
 188 "\\%http://www.kernel.org/doc/man-pages/."
 189 msgstr ""
 190
 191 #. type: TH
 192 #: build/C/man3/fgetpwent.3:33
 193 #, no-wrap
 194 msgid "FGETPWENT"
 195 msgstr ""
 196
 197 #. type: TH
 198 #: build/C/man3/fgetpwent.3:33 build/C/man3/putpwent.3:30
 199 #, no-wrap
 200 msgid "2013-04-19"
 201 msgstr ""
 202
 203 #. type: Plain text
 204 #: build/C/man3/fgetpwent.3:36
 205 msgid "fgetpwent - get password file entry"
 206 msgstr ""
 207
 208 #. type: Plain text
 209 #: build/C/man3/fgetpwent.3:41 build/C/man3/putpwent.3:38
 210 #, no-wrap
 211 msgid ""
 212 "B<#include E<lt>stdio.hE<gt>>\n"
 213 "B<#include E<lt>sys/types.hE<gt>>\n"
 214 "B<#include E<lt>pwd.hE<gt>>\n"
 215 msgstr ""
 216
 217 #. type: Plain text
 218 #: build/C/man3/fgetpwent.3:43
 219 #, no-wrap
 220 msgid "B<struct passwd *fgetpwent(FILE *>I<stream>B<);>\n"
 221 msgstr ""
 222
 223 #. type: Plain text
 224 #: build/C/man3/fgetpwent.3:52
 225 msgid "B<fgetpwent>(): _SVID_SOURCE"
 226 msgstr ""
 227
 228 #. type: Plain text
 229 #: build/C/man3/fgetpwent.3:65
 230 msgid ""
 231 "The B<fgetpwent>()  function returns a pointer to a structure containing the "
 232 "broken out fields of a line in the file I<stream>.  The first time it is "
 233 "called it returns the first entry; thereafter, it returns successive "
 234 "entries.  The file referred to by I<stream> must have the same format as "
 235 "I</etc/passwd> (see B<passwd>(5))."
 236 msgstr ""
 237
 238 #. type: Plain text
 239 #: build/C/man3/fgetpwent.3:67 build/C/man3/getpw.3:55 build/C/man3/getpwent.3:86 build/C/man3/getpwent_r.3:67 build/C/man3/getpwnam.3:90 build/C/man3/putpwent.3:56
 240 msgid "The I<passwd> structure is defined in I<E<lt>pwd.hE<gt>> as follows:"
 241 msgstr ""
 242
 243 #. type: Plain text
 244 #: build/C/man3/fgetpwent.3:79
 245 #, no-wrap
 246 msgid ""
 247 "struct passwd {\n"
 248 "    char   *pw_name;       /* username */\n"
 249 "    char   *pw_passwd;     /* user password */\n"
 250 "    uid_t   pw_uid;        /* user ID */\n"
 251 "    gid_t   pw_gid;        /* group ID */\n"
 252 "    char   *pw_gecos;      /* real name */\n"
 253 "    char   *pw_dir;        /* home directory */\n"
 254 "    char   *pw_shell;      /* shell program */\n"
 255 "};\n"
 256 msgstr ""
 257
 258 #. type: Plain text
 259 #: build/C/man3/fgetpwent.3:91
 260 msgid ""
 261 "The B<fgetpwent>()  function returns a pointer to a I<passwd> structure, or "
 262 "NULL if there are no more entries or an error occurs.  In the event of an "
 263 "error, I<errno> is set to indicate the cause."
 264 msgstr ""
 265
 266 #.  not in POSIX
 267 #.  This structure is static, allocated 0 or 1 times. No memory leak. (libc45)
 268 #. type: Plain text
 269 #: build/C/man3/fgetpwent.3:97 build/C/man3/getpw.3:92 build/C/man3/getpwent.3:147 build/C/man3/getpwnam.3:210
 270 msgid "Insufficient memory to allocate I<passwd> structure."
 271 msgstr ""
 272
 273 #. type: SH
 274 #: build/C/man3/fgetpwent.3:97 build/C/man5/ftpusers.5:47 build/C/man3/getgrent.3:162 build/C/man3/getgrnam.3:207 build/C/man3/getpw.3:92 build/C/man3/getpwent.3:150 build/C/man3/getpwnam.3:213 build/C/man3/getspnam.3:236 build/C/man5/group.5:53 build/C/man3/initgroups.3:84 build/C/man5/passwd.5:142 build/C/man3/setaliasent.3:95
 275 #, no-wrap
 276 msgid "FILES"
 277 msgstr ""
 278
 279 #. type: Plain text
 280 #: build/C/man3/fgetpwent.3:98 build/C/man3/getpw.3:93 build/C/man3/getpwent.3:151 build/C/man3/getpwnam.3:214 build/C/man5/passwd.5:144
 281 #, no-wrap
 282 msgid "I</etc/passwd>"
 283 msgstr ""
 284
 285 #. type: Plain text
 286 #: build/C/man3/fgetpwent.3:101 build/C/man3/getpw.3:96
 287 msgid "password database file"
 288 msgstr ""
 289
 290 #. type: Plain text
 291 #: build/C/man3/fgetpwent.3:114
 292 msgid ""
 293 "B<endpwent>(3), B<fgetpwent_r>(3), B<fopen>(3), B<getpw>(3), B<getpwent>(3), "
 294 "B<getpwnam>(3), B<getpwuid>(3), B<putpwent>(3), B<setpwent>(3), B<passwd>(5)"
 295 msgstr ""
 296
 297 #. type: TH
 298 #: build/C/man5/ftpusers.5:19
 299 #, no-wrap
 300 msgid "FTPUSERS"
 301 msgstr ""
 302
 303 #. type: TH
 304 #: build/C/man5/ftpusers.5:19
 305 #, no-wrap
 306 msgid "2000-08-27"
 307 msgstr ""
 308
 309 #. type: TH
 310 #: build/C/man5/ftpusers.5:19 build/C/man5/group.5:26 build/C/man5/passwd.5:30
 311 #, no-wrap
 312 msgid "Linux"
 313 msgstr ""
 314
 315 #. type: Plain text
 316 #: build/C/man5/ftpusers.5:22
 317 msgid "ftpusers - list of users that may not log in via the FTP daemon"
 318 msgstr ""
 319
 320 #. type: Plain text
 321 #: build/C/man5/ftpusers.5:41
 322 msgid ""
 323 "The text file B<ftpusers> contains a list of users that may not log in using "
 324 "the File Transfer Protocol (FTP) server daemon.  This file is used not "
 325 "merely for system administration purposes but for improving security within "
 326 "a TCP/IP networked environment.  It will typically contain a list of the "
 327 "users that either have no business using ftp or have too many privileges to "
 328 "be allowed to log in through the FTP server daemon.  Such users usually "
 329 "include root, daemon, bin, uucp, and news.  If your FTP server daemon "
 330 "doesn't use B<ftpusers>, then it is suggested that you read its "
 331 "documentation to find out how to block access for certain users.  Washington "
 332 "University FTP server Daemon (wuftpd) and Professional FTP Daemon (proftpd) "
 333 "are known to make use of B<ftpusers>."
 334 msgstr ""
 335
 336 #. type: SS
 337 #: build/C/man5/ftpusers.5:41
 338 #, no-wrap
 339 msgid "Format"
 340 msgstr ""
 341
 342 #. type: Plain text
 343 #: build/C/man5/ftpusers.5:47
 344 msgid ""
 345 "The format of B<ftpusers> is very simple.  There is one account name (or "
 346 "username) per line.  Lines starting with a # are ignored."
 347 msgstr ""
 348
 349 #. type: Plain text
 350 #: build/C/man5/ftpusers.5:49
 351 msgid "I</etc/ftpusers>"
 352 msgstr ""
 353
 354 #. type: Plain text
 355 #: build/C/man5/ftpusers.5:53
 356 msgid "B<passwd>(5), B<proftpd>(8), B<wuftpd>(8)"
 357 msgstr ""
 358
 359 #. type: TH
 360 #: build/C/man3/getgrent.3:30
 361 #, no-wrap
 362 msgid "GETGRENT"
 363 msgstr ""
 364
 365 #. type: TH
 366 #: build/C/man3/getgrent.3:30
 367 #, no-wrap
 368 msgid "2014-10-02"
 369 msgstr ""
 370
 371 #. type: Plain text
 372 #: build/C/man3/getgrent.3:33
 373 msgid "getgrent, setgrent, endgrent - get group file entry"
 374 msgstr ""
 375
 376 #. type: Plain text
 377 #: build/C/man3/getgrent.3:37 build/C/man3/getgrnam.3:40 build/C/man3/initgroups.3:39
 378 #, no-wrap
 379 msgid ""
 380 "B<#include E<lt>sys/types.hE<gt>>\n"
 381 "B<#include E<lt>grp.hE<gt>>\n"
 382 msgstr ""
 383
 384 #. type: Plain text
 385 #: build/C/man3/getgrent.3:39
 386 #, no-wrap
 387 msgid "B<struct group *getgrent(void);>\n"
 388 msgstr ""
 389
 390 #. type: Plain text
 391 #: build/C/man3/getgrent.3:41
 392 #, no-wrap
 393 msgid "B<void setgrent(void);>\n"
 394 msgstr ""
 395
 396 #. type: Plain text
 397 #: build/C/man3/getgrent.3:43
 398 #, no-wrap
 399 msgid "B<void endgrent(void);>\n"
 400 msgstr ""
 401
 402 #. type: Plain text
 403 #: build/C/man3/getgrent.3:53
 404 msgid "B<setgrent>():"
 405 msgstr ""
 406
 407 #. type: Plain text
 408 #: build/C/man3/getgrent.3:56
 409 msgid ""
 410 "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
 411 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED ||"
 412 msgstr ""
 413
 414 #. type: Plain text
 415 #: build/C/man3/getgrent.3:58
 416 msgid "/* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
 417 msgstr ""
 418
 419 #. type: Plain text
 420 #: build/C/man3/getgrent.3:62
 421 msgid "B<getgrent>(), B<endgrent>():"
 422 msgstr ""
 423
 424 #. type: Plain text
 425 #: build/C/man3/getgrent.3:65
 426 msgid ""
 427 "_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
 428 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
 429 msgstr ""
 430
 431 #. type: Plain text
 432 #: build/C/man3/getgrent.3:80
 433 msgid ""
 434 "The B<getgrent>()  function returns a pointer to a structure containing the "
 435 "broken-out fields of a record in the group database (e.g., the local group "
 436 "file I</etc/group>, NIS, and LDAP).  The first time B<getgrent>()  is "
 437 "called, it returns the first entry; thereafter, it returns successive "
 438 "entries."
 439 msgstr ""
 440
 441 #. type: Plain text
 442 #: build/C/man3/getgrent.3:85
 443 msgid ""
 444 "The B<setgrent>()  function rewinds to the beginning of the group database, "
 445 "to allow repeated scans."
 446 msgstr ""
 447
 448 #. type: Plain text
 449 #: build/C/man3/getgrent.3:90
 450 msgid ""
 451 "The B<endgrent>()  function is used to close the group database after all "
 452 "processing has been performed."
 453 msgstr ""
 454
 455 #. type: Plain text
 456 #: build/C/man3/getgrent.3:107 build/C/man3/getgrent_r.3:83 build/C/man3/getgrnam.3:101
 457 msgid "For more information about the fields of this structure, see B<group>(5)."
 458 msgstr ""
 459
 460 #. type: Plain text
 461 #: build/C/man3/getgrent.3:114
 462 msgid ""
 463 "The B<getgrent>()  function returns a pointer to a I<group> structure, or "
 464 "NULL if there are no more entries or an error occurs."
 465 msgstr ""
 466
 467 #. type: Plain text
 468 #: build/C/man3/getgrent.3:121
 469 msgid ""
 470 "Upon error, I<errno> may be set.  If one wants to check I<errno> after the "
 471 "call, it should be set to zero before the call."
 472 msgstr ""
 473
 474 #. type: Plain text
 475 #: build/C/man3/getgrent.3:130
 476 msgid ""
 477 "The return value may point to a static area, and may be overwritten by "
 478 "subsequent calls to B<getgrent>(), B<getgrgid>(3), or B<getgrnam>(3).  (Do "
 479 "not pass the returned pointer to B<free>(3).)"
 480 msgstr ""
 481
 482 #. type: TP
 483 #: build/C/man3/getgrent.3:131
 484 #, no-wrap
 485 msgid "B<EAGAIN>"
 486 msgstr ""
 487
 488 #. type: Plain text
 489 #: build/C/man3/getgrent.3:136
 490 msgid ""
 491 "The service was temporarily unavailable; try again later.  For NSS backends "
 492 "in glibc this indicates a temporary error talking to the backend.  The error "
 493 "may correct itself, retrying later is suggested."
 494 msgstr ""
 495
 496 #. type: TP
 497 #: build/C/man3/getgrent.3:136 build/C/man3/getgrnam.3:183 build/C/man3/getpwent.3:126 build/C/man3/getpwnam.3:189
 498 #, no-wrap
 499 msgid "B<EINTR>"
 500 msgstr ""
 501
 502 #. type: Plain text
 503 #: build/C/man3/getgrent.3:139 build/C/man3/getgrnam.3:186 build/C/man3/getpwent.3:129 build/C/man3/getpwnam.3:192
 504 msgid "A signal was caught."
 505 msgstr ""
 506
 507 #. type: TP
 508 #: build/C/man3/getgrent.3:139 build/C/man3/getgrnam.3:186 build/C/man3/getpwent.3:129 build/C/man3/getpwnam.3:192
 509 #, no-wrap
 510 msgid "B<EIO>"
 511 msgstr ""
 512
 513 #. type: Plain text
 514 #: build/C/man3/getgrent.3:142 build/C/man3/getgrnam.3:189 build/C/man3/getpwent.3:132 build/C/man3/getpwnam.3:195
 515 msgid "I/O error."
 516 msgstr ""
 517
 518 #. type: TP
 519 #: build/C/man3/getgrent.3:142 build/C/man3/getgrnam.3:189 build/C/man3/getpwent.3:132 build/C/man3/getpwnam.3:195
 520 #, no-wrap
 521 msgid "B<EMFILE>"
 522 msgstr ""
 523
 524 #. type: Plain text
 525 #: build/C/man3/getgrent.3:145
 526 msgid "The calling process already has too many open files."
 527 msgstr ""
 528
 529 #. type: TP
 530 #: build/C/man3/getgrent.3:145 build/C/man3/getgrnam.3:194 build/C/man3/getpwent.3:137 build/C/man3/getpwnam.3:200
 531 #, no-wrap
 532 msgid "B<ENFILE>"
 533 msgstr ""
 534
 535 #. type: Plain text
 536 #: build/C/man3/getgrent.3:148
 537 msgid "Too many open files in the system."
 538 msgstr ""
 539
 540 #. type: TP
 541 #: build/C/man3/getgrent.3:148 build/C/man3/getgrent_r.3:110 build/C/man3/getpw.3:83 build/C/man3/getpwent_r.3:111
 542 #, no-wrap
 543 msgid "B<ENOENT>"
 544 msgstr ""
 545
 546 #. type: Plain text
 547 #: build/C/man3/getgrent.3:153
 548 msgid ""
 549 "A necessary input file cannot be found.  For NSS backends in glibc this "
 550 "indicates the backend is not correctly configured."
 551 msgstr ""
 552
 553 #. type: TP
 554 #: build/C/man3/getgrent.3:159 build/C/man3/getgrent_r.3:113 build/C/man3/getgrnam.3:204 build/C/man3/getpwent.3:147 build/C/man3/getpwent_r.3:114 build/C/man3/getpwnam.3:210 build/C/man3/getspnam.3:233
 555 #, no-wrap
 556 msgid "B<ERANGE>"
 557 msgstr ""
 558
 559 #. type: Plain text
 560 #: build/C/man3/getgrent.3:162 build/C/man3/getgrnam.3:207 build/C/man3/getpwent.3:150 build/C/man3/getpwnam.3:213
 561 msgid "Insufficient buffer space supplied."
 562 msgstr ""
 563
 564 #. type: TP
 565 #: build/C/man3/getgrent.3:163 build/C/man3/getgrnam.3:208
 566 #, no-wrap
 567 msgid "I</etc/group>"
 568 msgstr ""
 569
 570 #. type: Plain text
 571 #: build/C/man3/getgrent.3:166 build/C/man3/getgrnam.3:211
 572 msgid "local group database file"
 573 msgstr ""
 574
 575 #. type: SH
 576 #: build/C/man3/getgrent.3:166 build/C/man3/getgrnam.3:211 build/C/man3/getpwent.3:154 build/C/man3/getpwnam.3:217
 577 #, no-wrap
 578 msgid "ATTRIBUTES"
 579 msgstr ""
 580
 581 #. type: SS
 582 #: build/C/man3/getgrent.3:167 build/C/man3/getgrnam.3:212 build/C/man3/getpwent.3:155 build/C/man3/getpwnam.3:218
 583 #, no-wrap
 584 msgid "Multithreading (see pthreads(7))"
 585 msgstr ""
 586
 587 #. type: Plain text
 588 #: build/C/man3/getgrent.3:171
 589 msgid "The B<getgrent>()  function is not thread-safe."
 590 msgstr ""
 591
 592 #. type: Plain text
 593 #: build/C/man3/getgrent.3:177
 594 msgid "The B<setgrent>()  and B<endgrent>()  functions are thread-safe."
 595 msgstr ""
 596
 597 #. type: Plain text
 598 #: build/C/man3/getgrent.3:179 build/C/man3/getgrnam.3:226
 599 msgid "SVr4, 4.3BSD, POSIX.1-2001."
 600 msgstr ""
 601
 602 #. type: Plain text
 603 #: build/C/man3/getgrent.3:187
 604 msgid ""
 605 "B<fgetgrent>(3), B<getgrent_r>(3), B<getgrgid>(3), B<getgrnam>(3), "
 606 "B<getgrouplist>(3), B<putgrent>(3), B<group>(5)"
 607 msgstr ""
 608
 609 #. type: TH
 610 #: build/C/man3/getgrent_r.3:24
 611 #, no-wrap
 612 msgid "GETGRENT_R"
 613 msgstr ""
 614
 615 #. type: Plain text
 616 #: build/C/man3/getgrent_r.3:27
 617 msgid "getgrent_r, fgetgrent_r - get group file entry reentrantly"
 618 msgstr ""
 619
 620 #. type: Plain text
 621 #: build/C/man3/getgrent_r.3:30
 622 #, no-wrap
 623 msgid "B<#include E<lt>grp.hE<gt>>\n"
 624 msgstr ""
 625
 626 #. type: Plain text
 627 #: build/C/man3/getgrent_r.3:32
 628 #, no-wrap
 629 msgid "B<int getgrent_r(struct group *>I<gbuf>B<, char *>I<buf>B<,>\n"
 630 msgstr ""
 631
 632 #. type: Plain text
 633 #: build/C/man3/getgrent_r.3:34
 634 #, no-wrap
 635 msgid "B<               size_t >I<buflen>B<, struct group **>I<gbufp>B<);>\n"
 636 msgstr ""
 637
 638 #. type: Plain text
 639 #: build/C/man3/getgrent_r.3:36
 640 #, no-wrap
 641 msgid ""
 642 "B<int fgetgrent_r(FILE *>I<fp>B<, struct group *>I<gbuf>B<, char "
 643 "*>I<buf>B<,>\n"
 644 msgstr ""
 645
 646 #. type: Plain text
 647 #: build/C/man3/getgrent_r.3:38
 648 #, no-wrap
 649 msgid "B<                size_t >I<buflen>B<, struct group **>I<gbufp>B<);>\n"
 650 msgstr ""
 651
 652 #.  FIXME . The FTM requirements seem inconsistent here.  File a glibc bug?
 653 #. type: Plain text
 654 #: build/C/man3/getgrent_r.3:48
 655 msgid "B<getgrent_r>(): _GNU_SOURCE"
 656 msgstr ""
 657
 658 #. type: Plain text
 659 #: build/C/man3/getgrent_r.3:51
 660 msgid "B<fgetgrent_r>(): _SVID_SOURCE"
 661 msgstr ""
 662
 663 #. type: Plain text
 664 #: build/C/man3/getgrent_r.3:64
 665 msgid ""
 666 "The functions B<getgrent_r>()  and B<fgetgrent_r>()  are the reentrant "
 667 "versions of B<getgrent>(3)  and B<fgetgrent>(3).  The former reads the next "
 668 "group entry from the stream initialized by B<setgrent>(3).  The latter reads "
 669 "the next group entry from the stream I<fp>."
 670 msgstr ""
 671
 672 #. type: Plain text
 673 #: build/C/man3/getgrent_r.3:102
 674 msgid ""
 675 "The nonreentrant functions return a pointer to static storage, where this "
 676 "static storage contains further pointers to group name, password and "
 677 "members.  The reentrant functions described here return all of that in "
 678 "caller-provided buffers.  First of all there is the buffer I<gbuf> that can "
 679 "hold a I<struct group>.  And next the buffer I<buf> of size I<buflen> that "
 680 "can hold additional strings.  The result of these functions, the I<struct "
 681 "group> read from the stream, is stored in the provided buffer I<*gbuf>, and "
 682 "a pointer to this I<struct group> is returned in I<*gbufp>."
 683 msgstr ""
 684
 685 #. type: Plain text
 686 #: build/C/man3/getgrent_r.3:109
 687 msgid ""
 688 "On success, these functions return 0 and I<*gbufp> is a pointer to the "
 689 "I<struct group>.  On error, these functions return an error value and "
 690 "I<*gbufp> is NULL."
 691 msgstr ""
 692
 693 #. type: Plain text
 694 #: build/C/man3/getgrent_r.3:113 build/C/man3/getpwent_r.3:114
 695 msgid "No more entries."
 696 msgstr ""
 697
 698 #. type: Plain text
 699 #: build/C/man3/getgrent_r.3:117 build/C/man3/getpwent_r.3:118
 700 msgid "Insufficient buffer space supplied.  Try again with larger buffer."
 701 msgstr ""
 702
 703 #. type: Plain text
 704 #: build/C/man3/getgrent_r.3:122 build/C/man3/getpwent_r.3:123
 705 msgid ""
 706 "These functions are GNU extensions, done in a style resembling the POSIX "
 707 "version of functions like B<getpwnam_r>(3).  Other systems use prototype"
 708 msgstr ""
 709
 710 #. type: Plain text
 711 #: build/C/man3/getgrent_r.3:127
 712 #, no-wrap
 713 msgid ""
 714 "struct group *getgrent_r(struct group *grp, char *buf,\n"
 715 "                         int buflen);\n"
 716 msgstr ""
 717
 718 #. type: Plain text
 719 #: build/C/man3/getgrent_r.3:131 build/C/man3/getpwent_r.3:132
 720 msgid "or, better,"
 721 msgstr ""
 722
 723 #. type: Plain text
 724 #: build/C/man3/getgrent_r.3:136
 725 #, no-wrap
 726 msgid ""
 727 "int getgrent_r(struct group *grp, char *buf, int buflen,\n"
 728 "               FILE **gr_fp);\n"
 729 msgstr ""
 730
 731 #. type: SH
 732 #: build/C/man3/getgrent_r.3:138 build/C/man3/getgrnam.3:226 build/C/man3/getpwent_r.3:140 build/C/man3/getpwnam.3:235 build/C/man5/passwd.5:144
 733 #, no-wrap
 734 msgid "NOTES"
 735 msgstr ""
 736
 737 #. type: Plain text
 738 #: build/C/man3/getgrent_r.3:143
 739 msgid ""
 740 "The function B<getgrent_r>()  is not really reentrant since it shares the "
 741 "reading position in the stream with all other threads."
 742 msgstr ""
 743
 744 #. type: SH
 745 #: build/C/man3/getgrent_r.3:143 build/C/man3/getgrouplist.3:109 build/C/man3/getpwent_r.3:145 build/C/man3/getpwnam.3:274 build/C/man3/setaliasent.3:115
 746 #, no-wrap
 747 msgid "EXAMPLE"
 748 msgstr ""
 749
 750 #. type: Plain text
 751 #: build/C/man3/getgrent_r.3:150
 752 #, no-wrap
 753 msgid ""
 754 "#define _GNU_SOURCE\n"
 755 "#include E<lt>grp.hE<gt>\n"
 756 "#include E<lt>stdio.hE<gt>\n"
 757 "#include E<lt>stdlib.hE<gt>\n"
 758 "#define BUFLEN 4096\n"
 759 msgstr ""
 760
 761 #. type: Plain text
 762 #: build/C/man3/getgrent_r.3:157
 763 #, no-wrap
 764 msgid ""
 765 "int\n"
 766 "main(void)\n"
 767 "{\n"
 768 "    struct group grp, *grpp;\n"
 769 "    char buf[BUFLEN];\n"
 770 "    int i;\n"
 771 msgstr ""
 772
 773 #. type: Plain text
 774 #: build/C/man3/getgrent_r.3:174
 775 #, no-wrap
 776 msgid ""
 777 "    setgrent();\n"
 778 "    while (1) {\n"
 779 "        i = getgrent_r(&grp, buf, BUFLEN, &grpp);\n"
 780 "        if (i)\n"
 781 "            break;\n"
 782 "        printf(\"%s (%d):\", grpp-E<gt>gr_name, grpp-E<gt>gr_gid);\n"
 783 "        for (i = 0; ; i++) {\n"
 784 "            if (grpp-E<gt>gr_mem[i] == NULL)\n"
 785 "                break;\n"
 786 "            printf(\" %s\", grpp-E<gt>gr_mem[i]);\n"
 787 "        }\n"
 788 "        printf(\"\\en\");\n"
 789 "    }\n"
 790 "    endgrent();\n"
 791 "    exit(EXIT_SUCCESS);\n"
 792 "}\n"
 793 msgstr ""
 794
 795 #. type: Plain text
 796 #: build/C/man3/getgrent_r.3:191
 797 msgid ""
 798 "B<fgetgrent>(3), B<getgrent>(3), B<getgrgid>(3), B<getgrnam>(3), "
 799 "B<putgrent>(3), B<group>(5)"
 800 msgstr ""
 801
 802 #. type: TH
 803 #: build/C/man3/getgrnam.3:33
 804 #, no-wrap
 805 msgid "GETGRNAM"
 806 msgstr ""
 807
 808 #. type: Plain text
 809 #: build/C/man3/getgrnam.3:36
 810 msgid "getgrnam, getgrnam_r, getgrgid, getgrgid_r - get group file entry"
 811 msgstr ""
 812
 813 #. type: Plain text
 814 #: build/C/man3/getgrnam.3:42
 815 #, no-wrap
 816 msgid "B<struct group *getgrnam(const char *>I<name>B<);>\n"
 817 msgstr ""
 818
 819 #. type: Plain text
 820 #: build/C/man3/getgrnam.3:44
 821 #, no-wrap
 822 msgid "B<struct group *getgrgid(gid_t >I<gid>B<);>\n"
 823 msgstr ""
 824
 825 #. type: Plain text
 826 #: build/C/man3/getgrnam.3:46
 827 #, no-wrap
 828 msgid "B<int getgrnam_r(const char *>I<name>B<, struct group *>I<grp>B<,>\n"
 829 msgstr ""
 830
 831 #. type: Plain text
 832 #: build/C/man3/getgrnam.3:48 build/C/man3/getgrnam.3:52
 833 #, no-wrap
 834 msgid ""
 835 "B<          char *>I<buf>B<, size_t >I<buflen>B<, struct group "
 836 "**>I<result>B<);>\n"
 837 msgstr ""
 838
 839 #. type: Plain text
 840 #: build/C/man3/getgrnam.3:50
 841 #, no-wrap
 842 msgid "B<int getgrgid_r(gid_t >I<gid>B<, struct group *>I<grp>B<,>\n"
 843 msgstr ""
 844
 845 #. type: Plain text
 846 #: build/C/man3/getgrnam.3:62
 847 msgid "B<getgrnam_r>(), B<getgrgid_r>():"
 848 msgstr ""
 849
 850 #. type: Plain text
 851 #: build/C/man3/getgrnam.3:65 build/C/man3/getpwnam.3:69
 852 msgid ""
 853 "_POSIX_C_SOURCE\\ E<gt>=\\ 1 || _XOPEN_SOURCE || _BSD_SOURCE || _SVID_SOURCE "
 854 "|| _POSIX_SOURCE"
 855 msgstr ""
 856
 857 #. type: Plain text
 858 #: build/C/man3/getgrnam.3:77
 859 msgid ""
 860 "The B<getgrnam>()  function returns a pointer to a structure containing the "
 861 "broken-out fields of the record in the group database (e.g., the local group "
 862 "file I</etc/group>, NIS, and LDAP)  that matches the group name I<name>."
 863 msgstr ""
 864
 865 #. type: Plain text
 866 #: build/C/man3/getgrnam.3:84
 867 msgid ""
 868 "The B<getgrgid>()  function returns a pointer to a structure containing the "
 869 "broken-out fields of the record in the group database that matches the group "
 870 "ID I<gid>."
 871 msgstr ""
 872
 873 #. type: Plain text
 874 #: build/C/man3/getgrnam.3:124
 875 msgid ""
 876 "The B<getgrnam_r>()  and B<getgrgid_r>()  functions obtain the same "
 877 "information as B<getgrnam>()  and B<getgrgid>(), but store the retrieved "
 878 "I<group> structure in the space pointed to by I<grp>.  The string fields "
 879 "pointed to by the members of the I<group> structure are stored in the buffer "
 880 "I<buf> of size I<buflen>.  A pointer to the result (in case of success) or "
 881 "NULL (in case no entry was found or an error occurred) is stored in "
 882 "I<*result>."
 883 msgstr ""
 884
 885 #. type: Plain text
 886 #: build/C/man3/getgrnam.3:126 build/C/man3/getpwnam.3:132
 887 msgid "The call"
 888 msgstr ""
 889
 890 #. type: Plain text
 891 #: build/C/man3/getgrnam.3:128
 892 #, no-wrap
 893 msgid "    sysconf(_SC_GETGR_R_SIZE_MAX)\n"
 894 msgstr ""
 895
 896 #. type: Plain text
 897 #: build/C/man3/getgrnam.3:137 build/C/man3/getpwnam.3:143
 898 msgid ""
 899 "returns either -1, without changing I<errno>, or an initial suggested size "
 900 "for I<buf>.  (If this size is too small, the call fails with B<ERANGE>, in "
 901 "which case the caller can retry with a larger buffer.)"
 902 msgstr ""
 903
 904 #. type: Plain text
 905 #: build/C/man3/getgrnam.3:152
 906 msgid ""
 907 "The B<getgrnam>()  and B<getgrgid>()  functions return a pointer to a "
 908 "I<group> structure, or NULL if the matching entry is not found or an error "
 909 "occurs.  If an error occurs, I<errno> is set appropriately.  If one wants to "
 910 "check I<errno> after the call, it should be set to zero before the call."
 911 msgstr ""
 912
 913 #. type: Plain text
 914 #: build/C/man3/getgrnam.3:161
 915 msgid ""
 916 "The return value may point to a static area, and may be overwritten by "
 917 "subsequent calls to B<getgrent>(3), B<getgrgid>(), or B<getgrnam>().  (Do "
 918 "not pass the returned pointer to B<free>(3).)"
 919 msgstr ""
 920
 921 #. type: Plain text
 922 #: build/C/man3/getgrnam.3:175
 923 msgid ""
 924 "On success, B<getgrnam_r>()  and B<getgrgid_r>()  return zero, and set "
 925 "I<*result> to I<grp>.  If no matching group record was found, these "
 926 "functions return 0 and store NULL in I<*result>.  In case of error, an error "
 927 "number is returned, and NULL is stored in I<*result>."
 928 msgstr ""
 929
 930 #. type: TP
 931 #: build/C/man3/getgrnam.3:176 build/C/man3/getpwnam.3:182
 932 #, no-wrap
 933 msgid "B<0> or B<ENOENT> or B<ESRCH> or B<EBADF> or B<EPERM> or ... "
 934 msgstr ""
 935
 936 #. type: Plain text
 937 #: build/C/man3/getgrnam.3:183
 938 msgid "The given I<name> or I<gid> was not found."
 939 msgstr ""
 940
 941 #. type: Plain text
 942 #: build/C/man3/getgrnam.3:194 build/C/man3/getpwent.3:137 build/C/man3/getpwnam.3:200
 943 msgid ""
 944 "The maximum number (B<OPEN_MAX>)  of files was open already in the calling "
 945 "process."
 946 msgstr ""
 947
 948 #. type: Plain text
 949 #: build/C/man3/getgrnam.3:197 build/C/man3/getpwent.3:140 build/C/man3/getpwnam.3:203
 950 msgid "The maximum number of files was open already in the system."
 951 msgstr ""
 952
 953 #. type: Plain text
 954 #: build/C/man3/getgrnam.3:218
 955 msgid "The B<getgrnam>()  and B<getgrgid>()  functions are not thread-safe."
 956 msgstr ""
 957
 958 #. type: Plain text
 959 #: build/C/man3/getgrnam.3:224
 960 msgid "The B<getgrnam_r>()  and B<getgrgid_r>()  functions are thread-safe."
 961 msgstr ""
 962
 963 #.  more precisely:
 964 #.  AIX 5.1 - gives ESRCH
 965 #.  OSF1 4.0g - gives EWOULDBLOCK
 966 #.  libc, glibc up to version 2.6, Irix 6.5 - give ENOENT
 967 #.  glibc since version 2.7 - give 0
 968 #.  FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 - give EPERM
 969 #.  SunOS 5.8 - gives EBADF
 970 #.  Tru64 5.1b, HP-UX-11i, SunOS 5.7 - give 0
 971 #. type: Plain text
 972 #: build/C/man3/getgrnam.3:247
 973 msgid ""
 974 "The formulation given above under \"RETURN VALUE\" is from POSIX.1-2001.  It "
 975 "does not call \"not found\" an error, hence does not specify what value "
 976 "I<errno> might have in this situation.  But that makes it impossible to "
 977 "recognize errors.  One might argue that according to POSIX I<errno> should "
 978 "be left unchanged if an entry is not found.  Experiments on various "
 979 "UNIX-like systems shows that lots of different values occur in this "
 980 "situation: 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM, and probably others."
 981 msgstr ""
 982
 983 #. type: Plain text
 984 #: build/C/man3/getgrnam.3:254
 985 msgid ""
 986 "B<endgrent>(3), B<fgetgrent>(3), B<getgrent>(3), B<getpwnam>(3), "
 987 "B<setgrent>(3), B<group>(5)"
 988 msgstr ""
 989
 990 #. type: TH
 991 #: build/C/man3/getgrouplist.3:29
 992 #, no-wrap
 993 msgid "GETGROUPLIST"
 994 msgstr ""
 995
 996 #. type: Plain text
 997 #: build/C/man3/getgrouplist.3:32
 998 msgid "getgrouplist - get list of groups to which a user belongs"
 999 msgstr ""
1000
1001 #. type: Plain text
1002 #: build/C/man3/getgrouplist.3:34 build/C/man3/putgrent.3:14
1003 msgid "B<#include E<lt>grp.hE<gt>>"
1004 msgstr ""
1005
1006 #. type: Plain text
1007 #: build/C/man3/getgrouplist.3:36
1008 msgid "B<int getgrouplist(const char *>I<user>B<, gid_t >I<group>B<,>"
1009 msgstr ""
1010
1011 #. type: Plain text
1012 #: build/C/man3/getgrouplist.3:38
1013 msgid "B< gid_t *>I<groups>B<, int *>I<ngroups>B<);>"
1014 msgstr ""
1015
1016 #. type: Plain text
1017 #: build/C/man3/getgrouplist.3:46
1018 msgid "B<getgrouplist>(): _BSD_SOURCE"
1019 msgstr ""
1020
1021 #. type: Plain text
1022 #: build/C/man3/getgrouplist.3:58
1023 msgid ""
1024 "The B<getgrouplist>()  function scans the group database (see B<group>(5))  "
1025 "to obtain the list of groups that I<user> belongs to.  Up to I<*ngroups> of "
1026 "these groups are returned in the array I<groups>."
1027 msgstr ""
1028
1029 #. type: Plain text
1030 #: build/C/man3/getgrouplist.3:68
1031 msgid ""
1032 "If it was not among the groups defined for I<user> in the group database, "
1033 "then I<group> is included in the list of groups returned by "
1034 "B<getgrouplist>(); typically this argument is specified as the group ID from "
1035 "the password record for I<user>."
1036 msgstr ""
1037
1038 #. type: Plain text
1039 #: build/C/man3/getgrouplist.3:78
1040 msgid ""
1041 "The I<ngroups> argument is a value-result argument: on return it always "
1042 "contains the number of groups found for I<user>, including I<group>; this "
1043 "value may be greater than the number of groups stored in I<groups>."
1044 msgstr ""
1045
1046 #. type: Plain text
1047 #: build/C/man3/getgrouplist.3:86
1048 msgid ""
1049 "If the number of groups of which I<user> is a member is less than or equal "
1050 "to I<*ngroups>, then the value I<*ngroups> is returned."
1051 msgstr ""
1052
1053 #. type: Plain text
1054 #: build/C/man3/getgrouplist.3:96
1055 msgid ""
1056 "If the user is a member of more than I<*ngroups> groups, then "
1057 "B<getgrouplist>()  returns -1.  In this case, the value returned in "
1058 "I<*ngroups> can be used to resize the buffer passed to a further call "
1059 "B<getgrouplist>()."
1060 msgstr ""
1061
1062 #. type: SH
1063 #: build/C/man3/getgrouplist.3:96
1064 #, no-wrap
1065 msgid "VERSIONS"
1066 msgstr ""
1067
1068 #. type: Plain text
1069 #: build/C/man3/getgrouplist.3:98
1070 msgid "This function is present since glibc 2.2.4."
1071 msgstr ""
1072
1073 #. type: Plain text
1074 #: build/C/man3/getgrouplist.3:100
1075 msgid "This function is nonstandard; it appears on most BSDs."
1076 msgstr ""
1077
1078 #. type: SH
1079 #: build/C/man3/getgrouplist.3:100 build/C/man3/getpw.3:98 build/C/man5/group.5:55
1080 #, no-wrap
1081 msgid "BUGS"
1082 msgstr ""
1083
1084 #. type: Plain text
1085 #: build/C/man3/getgrouplist.3:109
1086 msgid ""
1087 "In glibc versions before 2.3.3, the implementation of this function contains "
1088 "a buffer-overrun bug: it returns the complete list of groups for I<user> in "
1089 "the array I<groups>, even when the number of groups exceeds I<*ngroups>."
1090 msgstr ""
1091
1092 #. type: Plain text
1093 #: build/C/man3/getgrouplist.3:118
1094 msgid ""
1095 "The program below displays the group list for the user named in its first "
1096 "command-line argument.  The second command-line argument specifies the "
1097 "I<ngroups> value to be supplied to B<getgrouplist>().  The following shell "
1098 "session shows examples of the use of this program:"
1099 msgstr ""
1100
1101 #. type: Plain text
1102 #: build/C/man3/getgrouplist.3:128
1103 #, no-wrap
1104 msgid ""
1105 "$B< ./a.out cecilia 0>\n"
1106 "getgrouplist() returned -1; ngroups = 3\n"
1107 "$B< ./a.out cecilia 3>\n"
1108 "ngroups = 3\n"
1109 "16 (dialout)\n"
1110 "33 (video)\n"
1111 "100 (users)\n"
1112 msgstr ""
1113
1114 #. type: SS
1115 #: build/C/man3/getgrouplist.3:130
1116 #, no-wrap
1117 msgid "Program source"
1118 msgstr ""
1119
1120 #. type: Plain text
1121 #: build/C/man3/getgrouplist.3:137
1122 #, no-wrap
1123 msgid ""
1124 "#include E<lt>stdio.hE<gt>\n"
1125 "#include E<lt>stdlib.hE<gt>\n"
1126 "#include E<lt>grp.hE<gt>\n"
1127 "#include E<lt>pwd.hE<gt>\n"
1128 msgstr ""
1129
1130 #. type: Plain text
1131 #: build/C/man3/getgrouplist.3:145
1132 #, no-wrap
1133 msgid ""
1134 "int\n"
1135 "main(int argc, char *argv[])\n"
1136 "{\n"
1137 "    int j, ngroups;\n"
1138 "    gid_t *groups;\n"
1139 "    struct passwd *pw;\n"
1140 "    struct group *gr;\n"
1141 msgstr ""
1142
1143 #. type: Plain text
1144 #: build/C/man3/getgrouplist.3:150
1145 #, no-wrap
1146 msgid ""
1147 "    if (argc != 3) {\n"
1148 "        fprintf(stderr, \"Usage: %s E<lt>userE<gt> E<lt>ngroupsE<gt>\\en\", "
1149 "argv[0]);\n"
1150 "        exit(EXIT_FAILURE);\n"
1151 "    }\n"
1152 msgstr ""
1153
1154 #. type: Plain text
1155 #: build/C/man3/getgrouplist.3:152
1156 #, no-wrap
1157 msgid "    ngroups = atoi(argv[2]);\n"
1158 msgstr ""
1159
1160 #. type: Plain text
1161 #: build/C/man3/getgrouplist.3:158
1162 #, no-wrap
1163 msgid ""
1164 "    groups = malloc(ngroups * sizeof (gid_t));\n"
1165 "    if (groups == NULL) {\n"
1166 "        perror(\"malloc\");\n"
1167 "        exit(EXIT_FAILURE);\n"
1168 "    }\n"
1169 msgstr ""
1170
1171 #. type: Plain text
1172 #: build/C/man3/getgrouplist.3:160
1173 #, no-wrap
1174 msgid "    /* Fetch passwd structure (contains first group ID for user) */\n"
1175 msgstr ""
1176
1177 #. type: Plain text
1178 #: build/C/man3/getgrouplist.3:166
1179 #, no-wrap
1180 msgid ""
1181 "    pw = getpwnam(argv[1]);\n"
1182 "    if (pw == NULL) {\n"
1183 "        perror(\"getpwnam\");\n"
1184 "        exit(EXIT_SUCCESS);\n"
1185 "    }\n"
1186 msgstr ""
1187
1188 #. type: Plain text
1189 #: build/C/man3/getgrouplist.3:168
1190 #, no-wrap
1191 msgid "    /* Retrieve group list */\n"
1192 msgstr ""
1193
1194 #. type: Plain text
1195 #: build/C/man3/getgrouplist.3:174
1196 #, no-wrap
1197 msgid ""
1198 "    if (getgrouplist(argv[1], pw-E<gt>pw_gid, groups, &ngroups) == -1) {\n"
1199 "        fprintf(stderr, \"getgrouplist() returned -1; ngroups = %d\\en\",\n"
1200 "                ngroups);\n"
1201 "        exit(EXIT_FAILURE);\n"
1202 "    }\n"
1203 msgstr ""
1204
1205 #. type: Plain text
1206 #: build/C/man3/getgrouplist.3:176
1207 #, no-wrap
1208 msgid "    /* Display list of retrieved groups, along with group names */\n"
1209 msgstr ""
1210
1211 #. type: Plain text
1212 #: build/C/man3/getgrouplist.3:185
1213 #, no-wrap
1214 msgid ""
1215 "    fprintf(stderr, \"ngroups = %d\\en\", ngroups);\n"
1216 "    for (j = 0; j E<lt> ngroups; j++) {\n"
1217 "        printf(\"%d\", groups[j]);\n"
1218 "        gr = getgrgid(groups[j]);\n"
1219 "        if (gr != NULL)\n"
1220 "            printf(\" (%s)\", gr-E<gt>gr_name);\n"
1221 "        printf(\"\\en\");\n"
1222 "    }\n"
1223 msgstr ""
1224
1225 #. type: Plain text
1226 #: build/C/man3/getgrouplist.3:188
1227 #, no-wrap
1228 msgid ""
1229 "    exit(EXIT_SUCCESS);\n"
1230 "}\n"
1231 msgstr ""
1232
1233 #. type: Plain text
1234 #: build/C/man3/getgrouplist.3:196
1235 msgid ""
1236 "B<getgroups>(2), B<setgroups>(2), B<getgrent>(3), B<group_member>(3), "
1237 "B<group>(5), B<passwd>(5)"
1238 msgstr ""
1239
1240 #. type: TH
1241 #: build/C/man3/getpw.3:32
1242 #, no-wrap
1243 msgid "GETPW"
1244 msgstr ""
1245
1246 #. type: TH
1247 #: build/C/man3/getpw.3:32 build/C/man3/getpwent_r.3:24 build/C/man5/group.5:26
1248 #, no-wrap
1249 msgid "2010-10-21"
1250 msgstr ""
1251
1252 #. type: Plain text
1253 #: build/C/man3/getpw.3:35
1254 msgid "getpw - reconstruct password line entry"
1255 msgstr ""
1256
1257 #. type: Plain text
1258 #: build/C/man3/getpw.3:40
1259 #, no-wrap
1260 msgid ""
1261 "B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */\n"
1262 "B<#include E<lt>sys/types.hE<gt>>\n"
1263 "B<#include E<lt>pwd.hE<gt>>\n"
1264 msgstr ""
1265
1266 #. type: Plain text
1267 #: build/C/man3/getpw.3:42
1268 #, no-wrap
1269 msgid "B<int getpw(uid_t >I<uid>B<, char *>I<buf>B<);>\n"
1270 msgstr ""
1271
1272 #. type: Plain text
1273 #: build/C/man3/getpw.3:49
1274 msgid ""
1275 "The B<getpw>()  function reconstructs the password line entry for the given "
1276 "user ID I<uid> in the buffer I<buf>.  The returned buffer contains a line of "
1277 "format"
1278 msgstr ""
1279
1280 #. type: Plain text
1281 #: build/C/man3/getpw.3:52
1282 msgid "B<name:passwd:uid:gid:gecos:dir:shell>"
1283 msgstr ""
1284
1285 #. type: Plain text
1286 #: build/C/man3/getpw.3:67 build/C/man3/getpwent.3:98 build/C/man3/getpwnam.3:102
1287 #, no-wrap
1288 msgid ""
1289 "struct passwd {\n"
1290 "    char   *pw_name;       /* username */\n"
1291 "    char   *pw_passwd;     /* user password */\n"
1292 "    uid_t   pw_uid;        /* user ID */\n"
1293 "    gid_t   pw_gid;        /* group ID */\n"
1294 "    char   *pw_gecos;      /* user information */\n"
1295 "    char   *pw_dir;        /* home directory */\n"
1296 "    char   *pw_shell;      /* shell program */\n"
1297 "};\n"
1298 msgstr ""
1299
1300 #. type: Plain text
1301 #: build/C/man3/getpw.3:72 build/C/man3/getpwent.3:103 build/C/man3/getpwent_r.3:84
1302 msgid "For more information about the fields of this structure, see B<passwd>(5)."
1303 msgstr ""
1304
1305 #. type: Plain text
1306 #: build/C/man3/getpw.3:78
1307 msgid ""
1308 "The B<getpw>()  function returns 0 on success; on error, it returns -1, and "
1309 "I<errno> is set to indicate the error."
1310 msgstr ""
1311
1312 #. type: TP
1313 #: build/C/man3/getpw.3:79 build/C/man3/putpwent.3:79
1314 #, no-wrap
1315 msgid "B<EINVAL>"
1316 msgstr ""
1317
1318 #. type: Plain text
1319 #: build/C/man3/getpw.3:83
1320 msgid "I<buf> is NULL."
1321 msgstr ""
1322
1323 #. type: Plain text
1324 #: build/C/man3/getpw.3:87
1325 msgid "No user corresponding to I<uid>."
1326 msgstr ""
1327
1328 #. type: Plain text
1329 #: build/C/man3/getpw.3:98
1330 msgid "SVr2."
1331 msgstr ""
1332
1333 #. type: Plain text
1334 #: build/C/man3/getpw.3:105
1335 msgid ""
1336 "The B<getpw>()  function is dangerous as it may overflow the provided buffer "
1337 "I<buf>.  It is obsoleted by B<getpwuid>(3)."
1338 msgstr ""
1339
1340 #. type: Plain text
1341 #: build/C/man3/getpw.3:114
1342 msgid ""
1343 "B<endpwent>(3), B<fgetpwent>(3), B<getpwent>(3), B<getpwnam>(3), "
1344 "B<getpwuid>(3), B<putpwent>(3), B<setpwent>(3), B<passwd>(5)"
1345 msgstr ""
1346
1347 #. type: TH
1348 #: build/C/man3/getpwent.3:33
1349 #, no-wrap
1350 msgid "GETPWENT"
1351 msgstr ""
1352
1353 #. type: TH
1354 #: build/C/man3/getpwent.3:33
1355 #, no-wrap
1356 msgid "2013-06-21"
1357 msgstr ""
1358
1359 #. type: Plain text
1360 #: build/C/man3/getpwent.3:36
1361 msgid "getpwent, setpwent, endpwent - get password file entry"
1362 msgstr ""
1363
1364 #. type: Plain text
1365 #: build/C/man3/getpwent.3:40 build/C/man3/getpwnam.3:44
1366 #, no-wrap
1367 msgid ""
1368 "B<#include E<lt>sys/types.hE<gt>>\n"
1369 "B<#include E<lt>pwd.hE<gt>>\n"
1370 msgstr ""
1371
1372 #. type: Plain text
1373 #: build/C/man3/getpwent.3:42
1374 #, no-wrap
1375 msgid "B<struct passwd *getpwent(void);>\n"
1376 msgstr ""
1377
1378 #. type: Plain text
1379 #: build/C/man3/getpwent.3:44
1380 #, no-wrap
1381 msgid "B<void setpwent(void);>\n"
1382 msgstr ""
1383
1384 #. type: Plain text
1385 #: build/C/man3/getpwent.3:46
1386 #, no-wrap
1387 msgid "B<void endpwent(void);>\n"
1388 msgstr ""
1389
1390 #. type: Plain text
1391 #: build/C/man3/getpwent.3:57
1392 msgid "B<getpwent>(), B<setpwent>(), B<endpwent>():"
1393 msgstr ""
1394
1395 #. type: Plain text
1396 #: build/C/man3/getpwent.3:60
1397 msgid ""
1398 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
1399 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
1400 msgstr ""
1401
1402 #. type: Plain text
1403 #: build/C/man3/getpwent.3:74
1404 msgid ""
1405 "The B<getpwent>()  function returns a pointer to a structure containing the "
1406 "broken-out fields of a record from the password database (e.g., the local "
1407 "password file I</etc/passwd>, NIS, and LDAP).  The first time B<getpwent>()  "
1408 "is called, it returns the first entry; thereafter, it returns successive "
1409 "entries."
1410 msgstr ""
1411
1412 #. type: Plain text
1413 #: build/C/man3/getpwent.3:79
1414 msgid ""
1415 "The B<setpwent>()  function rewinds to the beginning of the password "
1416 "database."
1417 msgstr ""
1418
1419 #. type: Plain text
1420 #: build/C/man3/getpwent.3:84
1421 msgid ""
1422 "The B<endpwent>()  function is used to close the password database after all "
1423 "processing has been performed."
1424 msgstr ""
1425
1426 #. type: Plain text
1427 #: build/C/man3/getpwent.3:116
1428 msgid ""
1429 "The B<getpwent>()  function returns a pointer to a I<passwd> structure, or "
1430 "NULL if there are no more entries or an error occurred.  If an error occurs, "
1431 "I<errno> is set appropriately.  If one wants to check I<errno> after the "
1432 "call, it should be set to zero before the call."
1433 msgstr ""
1434
1435 #. type: Plain text
1436 #: build/C/man3/getpwent.3:125
1437 msgid ""
1438 "The return value may point to a static area, and may be overwritten by "
1439 "subsequent calls to B<getpwent>(), B<getpwnam>(3), or B<getpwuid>(3).  (Do "
1440 "not pass the returned pointer to B<free>(3).)"
1441 msgstr ""
1442
1443 #. type: Plain text
1444 #: build/C/man3/getpwent.3:154 build/C/man3/getpwnam.3:217
1445 msgid "local password database file"
1446 msgstr ""
1447
1448 #. type: Plain text
1449 #: build/C/man3/getpwent.3:159
1450 msgid "The B<getpwent>()  function is not thread-safe."
1451 msgstr ""
1452
1453 #. type: Plain text
1454 #: build/C/man3/getpwent.3:165
1455 msgid "The B<setpwent>()  and B<endpwent>()  functions are thread-safe."
1456 msgstr ""
1457
1458 #. type: Plain text
1459 #: build/C/man3/getpwent.3:170 build/C/man3/getpwnam.3:235
1460 msgid ""
1461 "SVr4, 4.3BSD, POSIX.1-2001.  The I<pw_gecos> field is not specified in "
1462 "POSIX, but is present on most implementations."
1463 msgstr ""
1464
1465 #. type: Plain text
1466 #: build/C/man3/getpwent.3:178
1467 msgid ""
1468 "B<fgetpwent>(3), B<getpw>(3), B<getpwent_r>(3), B<getpwnam>(3), "
1469 "B<getpwuid>(3), B<putpwent>(3), B<passwd>(5)"
1470 msgstr ""
1471
1472 #. type: TH
1473 #: build/C/man3/getpwent_r.3:24
1474 #, no-wrap
1475 msgid "GETPWENT_R"
1476 msgstr ""
1477
1478 #. type: Plain text
1479 #: build/C/man3/getpwent_r.3:27
1480 msgid "getpwent_r, fgetpwent_r - get passwd file entry reentrantly"
1481 msgstr ""
1482
1483 #. type: Plain text
1484 #: build/C/man3/getpwent_r.3:30
1485 #, no-wrap
1486 msgid "B<#include E<lt>pwd.hE<gt>>\n"
1487 msgstr ""
1488
1489 #. type: Plain text
1490 #: build/C/man3/getpwent_r.3:32
1491 #, no-wrap
1492 msgid "B<int getpwent_r(struct passwd *>I<pwbuf>B<, char *>I<buf>B<,>\n"
1493 msgstr ""
1494
1495 #. type: Plain text
1496 #: build/C/man3/getpwent_r.3:34
1497 #, no-wrap
1498 msgid "B<               size_t >I<buflen>B<, struct passwd **>I<pwbufp>B<);>\n"
1499 msgstr ""
1500
1501 #. type: Plain text
1502 #: build/C/man3/getpwent_r.3:36
1503 #, no-wrap
1504 msgid ""
1505 "B<int fgetpwent_r(FILE *>I<fp>B<, struct passwd *>I<pwbuf>B<, char "
1506 "*>I<buf>B<,>\n"
1507 msgstr ""
1508
1509 #. type: Plain text
1510 #: build/C/man3/getpwent_r.3:38
1511 #, no-wrap
1512 msgid "B<                size_t >I<buflen>B<, struct passwd **>I<pwbufp>B<);>\n"
1513 msgstr ""
1514
1515 #. type: Plain text
1516 #: build/C/man3/getpwent_r.3:47
1517 msgid "B<getpwent_r>(), _BSD_SOURCE || _SVID_SOURCE"
1518 msgstr ""
1519
1520 #. type: Plain text
1521 #: build/C/man3/getpwent_r.3:50
1522 msgid "B<fgetpwent_r>(): _SVID_SOURCE"
1523 msgstr ""
1524
1525 #. type: Plain text
1526 #: build/C/man3/getpwent_r.3:63
1527 msgid ""
1528 "The functions B<getpwent_r>()  and B<fgetpwent_r>()  are the reentrant "
1529 "versions of B<getpwent>(3)  and B<fgetpwent>(3).  The former reads the next "
1530 "passwd entry from the stream initialized by B<setpwent>(3).  The latter "
1531 "reads the next passwd entry from the stream I<fp>."
1532 msgstr ""
1533
1534 #. type: Plain text
1535 #: build/C/man3/getpwent_r.3:79
1536 #, no-wrap
1537 msgid ""
1538 "struct passwd {\n"
1539 "    char    *pw_name;      /* username */\n"
1540 "    char    *pw_passwd;    /* user password */\n"
1541 "    uid_t    pw_uid;       /* user ID */\n"
1542 "    gid_t    pw_gid;       /* group ID */\n"
1543 "    char    *pw_gecos;     /* user information */\n"
1544 "    char    *pw_dir;       /* home directory */\n"
1545 "    char    *pw_shell;     /* shell program */\n"
1546 "};\n"
1547 msgstr ""
1548
1549 #. type: Plain text
1550 #: build/C/man3/getpwent_r.3:103
1551 msgid ""
1552 "The nonreentrant functions return a pointer to static storage, where this "
1553 "static storage contains further pointers to user name, password, gecos "
1554 "field, home directory and shell.  The reentrant functions described here "
1555 "return all of that in caller-provided buffers.  First of all there is the "
1556 "buffer I<pwbuf> that can hold a I<struct passwd>.  And next the buffer "
1557 "I<buf> of size I<buflen> that can hold additional strings.  The result of "
1558 "these functions, the I<struct passwd> read from the stream, is stored in the "
1559 "provided buffer I<*pwbuf>, and a pointer to this I<struct passwd> is "
1560 "returned in I<*pwbufp>."
1561 msgstr ""
1562
1563 #. type: Plain text
1564 #: build/C/man3/getpwent_r.3:110
1565 msgid ""
1566 "On success, these functions return 0 and I<*pwbufp> is a pointer to the "
1567 "I<struct passwd>.  On error, these functions return an error value and "
1568 "I<*pwbufp> is NULL."
1569 msgstr ""
1570
1571 #. type: Plain text
1572 #: build/C/man3/getpwent_r.3:128
1573 #, no-wrap
1574 msgid ""
1575 "struct passwd *\n"
1576 "getpwent_r(struct passwd *pwd, char *buf, int buflen);\n"
1577 msgstr ""
1578
1579 #. type: Plain text
1580 #: build/C/man3/getpwent_r.3:138
1581 #, no-wrap
1582 msgid ""
1583 "int\n"
1584 "getpwent_r(struct passwd *pwd, char *buf, int buflen,\n"
1585 "           FILE **pw_fp);\n"
1586 msgstr ""
1587
1588 #. type: Plain text
1589 #: build/C/man3/getpwent_r.3:145
1590 msgid ""
1591 "The function B<getpwent_r>()  is not really reentrant since it shares the "
1592 "reading position in the stream with all other threads."
1593 msgstr ""
1594
1595 #. type: Plain text
1596 #: build/C/man3/getpwent_r.3:151
1597 #, no-wrap
1598 msgid ""
1599 "#define _GNU_SOURCE\n"
1600 "#include E<lt>pwd.hE<gt>\n"
1601 "#include E<lt>stdio.hE<gt>\n"
1602 "#define BUFLEN 4096\n"
1603 msgstr ""
1604
1605 #. type: Plain text
1606 #: build/C/man3/getpwent_r.3:158
1607 #, no-wrap
1608 msgid ""
1609 "int\n"
1610 "main(void)\n"
1611 "{\n"
1612 "    struct passwd pw, *pwp;\n"
1613 "    char buf[BUFLEN];\n"
1614 "    int i;\n"
1615 msgstr ""
1616
1617 #. type: Plain text
1618 #: build/C/man3/getpwent_r.3:170
1619 #, no-wrap
1620 msgid ""
1621 "    setpwent();\n"
1622 "    while (1) {\n"
1623 "        i = getpwent_r(&pw, buf, BUFLEN, &pwp);\n"
1624 "        if (i)\n"
1625 "            break;\n"
1626 "        printf(\"%s (%d)\\etHOME %s\\etSHELL %s\\en\", pwp-E<gt>pw_name,\n"
1627 "               pwp-E<gt>pw_uid, pwp-E<gt>pw_dir, pwp-E<gt>pw_shell);\n"
1628 "    }\n"
1629 "    endpwent();\n"
1630 "    exit(EXIT_SUCCESS);\n"
1631 "}\n"
1632 msgstr ""
1633
1634 #. type: Plain text
1635 #: build/C/man3/getpwent_r.3:188
1636 msgid ""
1637 "B<fgetpwent>(3), B<getpw>(3), B<getpwent>(3), B<getpwnam>(3), "
1638 "B<getpwuid>(3), B<putpwent>(3), B<passwd>(5)"
1639 msgstr ""
1640
1641 #. type: TH
1642 #: build/C/man3/getpwnam.3:37
1643 #, no-wrap
1644 msgid "GETPWNAM"
1645 msgstr ""
1646
1647 #. type: TH
1648 #: build/C/man3/getpwnam.3:37
1649 #, no-wrap
1650 msgid "2013-07-22"
1651 msgstr ""
1652
1653 #. type: Plain text
1654 #: build/C/man3/getpwnam.3:40
1655 msgid "getpwnam, getpwnam_r, getpwuid, getpwuid_r - get password file entry"
1656 msgstr ""
1657
1658 #. type: Plain text
1659 #: build/C/man3/getpwnam.3:46
1660 #, no-wrap
1661 msgid "B<struct passwd *getpwnam(const char *>I<name>B<);>\n"
1662 msgstr ""
1663
1664 #. type: Plain text
1665 #: build/C/man3/getpwnam.3:48
1666 #, no-wrap
1667 msgid "B<struct passwd *getpwuid(uid_t >I<uid>B<);>\n"
1668 msgstr ""
1669
1670 #. type: Plain text
1671 #: build/C/man3/getpwnam.3:50
1672 #, no-wrap
1673 msgid "B<int getpwnam_r(const char *>I<name>B<, struct passwd *>I<pwd>B<,>\n"
1674 msgstr ""
1675
1676 #. type: Plain text
1677 #: build/C/man3/getpwnam.3:52 build/C/man3/getpwnam.3:56
1678 #, no-wrap
1679 msgid ""
1680 "B<               char *>I<buf>B<, size_t >I<buflen>B<, struct passwd "
1681 "**>I<result>B<);>\n"
1682 msgstr ""
1683
1684 #. type: Plain text
1685 #: build/C/man3/getpwnam.3:54
1686 #, no-wrap
1687 msgid "B<int getpwuid_r(uid_t >I<uid>B<, struct passwd *>I<pwd>B<,>\n"
1688 msgstr ""
1689
1690 #. type: Plain text
1691 #: build/C/man3/getpwnam.3:66
1692 msgid "B<getpwnam_r>(), B<getpwuid_r>():"
1693 msgstr ""
1694
1695 #. type: Plain text
1696 #: build/C/man3/getpwnam.3:81
1697 msgid ""
1698 "The B<getpwnam>()  function returns a pointer to a structure containing the "
1699 "broken-out fields of the record in the password database (e.g., the local "
1700 "password file I</etc/passwd>, NIS, and LDAP)  that matches the username "
1701 "I<name>."
1702 msgstr ""
1703
1704 #. type: Plain text
1705 #: build/C/man3/getpwnam.3:88
1706 msgid ""
1707 "The B<getpwuid>()  function returns a pointer to a structure containing the "
1708 "broken-out fields of the record in the password database that matches the "
1709 "user ID I<uid>."
1710 msgstr ""
1711
1712 #. type: Plain text
1713 #: build/C/man3/getpwnam.3:108
1714 msgid "See B<passwd>(5)  for more information about these fields."
1715 msgstr ""
1716
1717 #. type: Plain text
1718 #: build/C/man3/getpwnam.3:130
1719 msgid ""
1720 "The B<getpwnam_r>()  and B<getpwuid_r>()  functions obtain the same "
1721 "information as B<getpwnam>()  and B<getpwuid>(), but store the retrieved "
1722 "I<passwd> structure in the space pointed to by I<pwd>.  The string fields "
1723 "pointed to by the members of the I<passwd> structure are stored in the "
1724 "buffer I<buf> of size I<buflen>.  A pointer to the result (in case of "
1725 "success) or NULL (in case no entry was found or an error occurred) is stored "
1726 "in I<*result>."
1727 msgstr ""
1728
1729 #. type: Plain text
1730 #: build/C/man3/getpwnam.3:134
1731 #, no-wrap
1732 msgid "    sysconf(_SC_GETPW_R_SIZE_MAX)\n"
1733 msgstr ""
1734
1735 #. type: Plain text
1736 #: build/C/man3/getpwnam.3:158
1737 msgid ""
1738 "The B<getpwnam>()  and B<getpwuid>()  functions return a pointer to a "
1739 "I<passwd> structure, or NULL if the matching entry is not found or an error "
1740 "occurs.  If an error occurs, I<errno> is set appropriately.  If one wants to "
1741 "check I<errno> after the call, it should be set to zero before the call."
1742 msgstr ""
1743
1744 #. type: Plain text
1745 #: build/C/man3/getpwnam.3:167
1746 msgid ""
1747 "The return value may point to a static area, and may be overwritten by "
1748 "subsequent calls to B<getpwent>(3), B<getpwnam>(), or B<getpwuid>().  (Do "
1749 "not pass the returned pointer to B<free>(3).)"
1750 msgstr ""
1751
1752 #. type: Plain text
1753 #: build/C/man3/getpwnam.3:181
1754 msgid ""
1755 "On success, B<getpwnam_r>()  and B<getpwuid_r>()  return zero, and set "
1756 "I<*result> to I<pwd>.  If no matching password record was found, these "
1757 "functions return 0 and store NULL in I<*result>.  In case of error, an error "
1758 "number is returned, and NULL is stored in I<*result>."
1759 msgstr ""
1760
1761 #. type: Plain text
1762 #: build/C/man3/getpwnam.3:189
1763 msgid "The given I<name> or I<uid> was not found."
1764 msgstr ""
1765
1766 #. type: Plain text
1767 #: build/C/man3/getpwnam.3:224
1768 msgid "The B<getpwnam>()  and B<getpwuid>()  functions are not thread-safe."
1769 msgstr ""
1770
1771 #. type: Plain text
1772 #: build/C/man3/getpwnam.3:230
1773 msgid "The B<getpwnam_r>()  and B<getpwuid_r>()  functions are thread-safe."
1774 msgstr ""
1775
1776 #.  more precisely:
1777 #.  AIX 5.1 - gives ESRCH
1778 #.  OSF1 4.0g - gives EWOULDBLOCK
1779 #.  libc, glibc up to version 2.6, Irix 6.5 - give ENOENT
1780 #.  glibc since version 2.7 - give 0
1781 #.  FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 - give EPERM
1782 #.  SunOS 5.8 - gives EBADF
1783 #.  Tru64 5.1b, HP-UX-11i, SunOS 5.7 - give 0
1784 #. type: Plain text
1785 #: build/C/man3/getpwnam.3:256
1786 msgid ""
1787 "The formulation given above under \"RETURN VALUE\" is from POSIX.1-2001.  It "
1788 "does not call \"not found\" an error, and hence does not specify what value "
1789 "I<errno> might have in this situation.  But that makes it impossible to "
1790 "recognize errors.  One might argue that according to POSIX I<errno> should "
1791 "be left unchanged if an entry is not found.  Experiments on various "
1792 "UNIX-like systems show that lots of different values occur in this "
1793 "situation: 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM, and probably others."
1794 msgstr ""
1795
1796 #. type: Plain text
1797 #: build/C/man3/getpwnam.3:274
1798 msgid ""
1799 "The I<pw_dir> field contains the name of the initial working directory of "
1800 "the user.  Login programs use the value of this field to initialize the "
1801 "B<HOME> environment variable for the login shell.  An application that wants "
1802 "to determine its user's home directory should inspect the value of B<HOME> "
1803 "(rather than the value I<getpwuid(getuid())-E<gt>pw_dir>)  since this allows "
1804 "the user to modify their notion of \"the home directory\" during a login "
1805 "session.  To determine the (initial) home directory of another user, it is "
1806 "necessary to use I<getpwnam(\"username\")-E<gt>pw_dir> or similar."
1807 msgstr ""
1808
1809 #. type: Plain text
1810 #: build/C/man3/getpwnam.3:279
1811 msgid ""
1812 "The program below demonstrates the use of B<getpwnam_r>()  to find the full "
1813 "username and user ID for the username supplied as a command-line argument."
1814 msgstr ""
1815
1816 #. type: Plain text
1817 #: build/C/man3/getpwnam.3:286
1818 #, no-wrap
1819 msgid ""
1820 "#include E<lt>pwd.hE<gt>\n"
1821 "#include E<lt>stdio.hE<gt>\n"
1822 "#include E<lt>stdlib.hE<gt>\n"
1823 "#include E<lt>unistd.hE<gt>\n"
1824 "#include E<lt>errno.hE<gt>\n"
1825 msgstr ""
1826
1827 #. type: Plain text
1828 #: build/C/man3/getpwnam.3:295
1829 #, no-wrap
1830 msgid ""
1831 "int\n"
1832 "main(int argc, char *argv[])\n"
1833 "{\n"
1834 "    struct passwd pwd;\n"
1835 "    struct passwd *result;\n"
1836 "    char *buf;\n"
1837 "    size_t bufsize;\n"
1838 "    int s;\n"
1839 msgstr ""
1840
1841 #. type: Plain text
1842 #: build/C/man3/getpwnam.3:300
1843 #, no-wrap
1844 msgid ""
1845 "    if (argc != 2) {\n"
1846 "        fprintf(stderr, \"Usage: %s username\\en\", argv[0]);\n"
1847 "        exit(EXIT_FAILURE);\n"
1848 "    }\n"
1849 msgstr ""
1850
1851 #. type: Plain text
1852 #: build/C/man3/getpwnam.3:304
1853 #, no-wrap
1854 msgid ""
1855 "    bufsize = sysconf(_SC_GETPW_R_SIZE_MAX);\n"
1856 "    if (bufsize == -1)          /* Value was indeterminate */\n"
1857 "        bufsize = 16384;        /* Should be more than enough */\n"
1858 msgstr ""
1859
1860 #. type: Plain text
1861 #: build/C/man3/getpwnam.3:310
1862 #, no-wrap
1863 msgid ""
1864 "    buf = malloc(bufsize);\n"
1865 "    if (buf == NULL) {\n"
1866 "        perror(\"malloc\");\n"
1867 "        exit(EXIT_FAILURE);\n"
1868 "    }\n"
1869 msgstr ""
1870
1871 #. type: Plain text
1872 #: build/C/man3/getpwnam.3:321
1873 #, no-wrap
1874 msgid ""
1875 "    s = getpwnam_r(argv[1], &pwd, buf, bufsize, &result);\n"
1876 "    if (result == NULL) {\n"
1877 "        if (s == 0)\n"
1878 "            printf(\"Not found\\en\");\n"
1879 "        else {\n"
1880 "            errno = s;\n"
1881 "            perror(\"getpwnam_r\");\n"
1882 "        }\n"
1883 "        exit(EXIT_FAILURE);\n"
1884 "    }\n"
1885 msgstr ""
1886
1887 #. type: Plain text
1888 #: build/C/man3/getpwnam.3:325
1889 #, no-wrap
1890 msgid ""
1891 "    printf(\"Name: %s; UID: %ld\\en\", pwd.pw_gecos, (long) pwd.pw_uid);\n"
1892 "    exit(EXIT_SUCCESS);\n"
1893 "}\n"
1894 msgstr ""
1895
1896 #. type: Plain text
1897 #: build/C/man3/getpwnam.3:336
1898 msgid ""
1899 "B<endpwent>(3), B<fgetpwent>(3), B<getgrnam>(3), B<getpw>(3), "
1900 "B<getpwent>(3), B<getspnam>(3), B<putpwent>(3), B<setpwent>(3), B<passwd>(5)"
1901 msgstr ""
1902
1903 #. type: TH
1904 #: build/C/man3/getspnam.3:8
1905 #, no-wrap
1906 msgid "GETSPNAM"
1907 msgstr ""
1908
1909 #. type: TH
1910 #: build/C/man3/getspnam.3:8
1911 #, no-wrap
1912 msgid "2014-05-28"
1913 msgstr ""
1914
1915 #. type: Plain text
1916 #: build/C/man3/getspnam.3:13
1917 msgid ""
1918 "getspnam, getspnam_r, getspent, getspent_r, setspent, endspent, fgetspent, "
1919 "fgetspent_r, sgetspent, sgetspent_r, putspent, lckpwdf, ulckpwdf - get "
1920 "shadow password file entry"
1921 msgstr ""
1922
1923 #. type: Plain text
1924 #: build/C/man3/getspnam.3:16
1925 #, no-wrap
1926 msgid "/* General shadow password file API */\n"
1927 msgstr ""
1928
1929 #. type: Plain text
1930 #: build/C/man3/getspnam.3:18 build/C/man3/getspnam.3:40
1931 #, no-wrap
1932 msgid "B<#include E<lt>shadow.hE<gt>>\n"
1933 msgstr ""
1934
1935 #. type: Plain text
1936 #: build/C/man3/getspnam.3:20
1937 #, no-wrap
1938 msgid "B<struct spwd *getspnam(const char *>I<name>B<);>\n"
1939 msgstr ""
1940
1941 #. type: Plain text
1942 #: build/C/man3/getspnam.3:22
1943 #, no-wrap
1944 msgid "B<struct spwd *getspent(void);>\n"
1945 msgstr ""
1946
1947 #. type: Plain text
1948 #: build/C/man3/getspnam.3:24
1949 #, no-wrap
1950 msgid "B<void setspent(void);>\n"
1951 msgstr ""
1952
1953 #. type: Plain text
1954 #: build/C/man3/getspnam.3:26
1955 #, no-wrap
1956 msgid "B<void endspent(void);>\n"
1957 msgstr ""
1958
1959 #. type: Plain text
1960 #: build/C/man3/getspnam.3:28
1961 #, no-wrap
1962 msgid "B<struct spwd *fgetspent(FILE *>I<fp>B<);>\n"
1963 msgstr ""
1964
1965 #. type: Plain text
1966 #: build/C/man3/getspnam.3:30
1967 #, no-wrap
1968 msgid "B<struct spwd *sgetspent(const char *>I<s>B<);>\n"
1969 msgstr ""
1970
1971 #. type: Plain text
1972 #: build/C/man3/getspnam.3:32
1973 #, no-wrap
1974 msgid "B<int putspent(const struct spwd *>I<p>B<, FILE *>I<fp>B<);>\n"
1975 msgstr ""
1976
1977 #. type: Plain text
1978 #: build/C/man3/getspnam.3:34
1979 #, no-wrap
1980 msgid "B<int lckpwdf(void);>\n"
1981 msgstr ""
1982
1983 #. type: Plain text
1984 #: build/C/man3/getspnam.3:36
1985 #, no-wrap
1986 msgid "B<int ulckpwdf(void);>\n"
1987 msgstr ""
1988
1989 #. type: Plain text
1990 #: build/C/man3/getspnam.3:38
1991 #, no-wrap
1992 msgid "/* GNU extension */\n"
1993 msgstr ""
1994
1995 #. type: Plain text
1996 #: build/C/man3/getspnam.3:42
1997 #, no-wrap
1998 msgid "B<int getspent_r(struct spwd *>I<spbuf>B<,>\n"
1999 msgstr ""
2000
2001 #. type: Plain text
2002 #: build/C/man3/getspnam.3:44 build/C/man3/getspnam.3:48 build/C/man3/getspnam.3:52 build/C/man3/getspnam.3:56
2003 #, no-wrap
2004 msgid ""
2005 "B<        char *>I<buf>B<, size_t >I<buflen>B<, struct spwd "
2006 "**>I<spbufp>B<);>\n"
2007 msgstr ""
2008
2009 #. type: Plain text
2010 #: build/C/man3/getspnam.3:46
2011 #, no-wrap
2012 msgid "B<int getspnam_r(const char *>I<name>B<, struct spwd *>I<spbuf>B<,>\n"
2013 msgstr ""
2014
2015 #. type: Plain text
2016 #: build/C/man3/getspnam.3:50
2017 #, no-wrap
2018 msgid "B<int fgetspent_r(FILE *>I<fp>B<, struct spwd *>I<spbuf>B<,>\n"
2019 msgstr ""
2020
2021 #. type: Plain text
2022 #: build/C/man3/getspnam.3:54
2023 #, no-wrap
2024 msgid "B<int sgetspent_r(const char *>I<s>B<, struct spwd *>I<spbuf>B<,>\n"
2025 msgstr ""
2026
2027 #. type: Plain text
2028 #: build/C/man3/getspnam.3:68
2029 msgid "B<getspent_r>(), B<getspnam_r>(), B<fgetspent_r>(), B<sgetspent_r>():"
2030 msgstr ""
2031
2032 #. type: Plain text
2033 #: build/C/man3/getspnam.3:70
2034 msgid "_BSD_SOURCE || _SVID_SOURCE"
2035 msgstr ""
2036
2037 #. type: Plain text
2038 #: build/C/man3/getspnam.3:84
2039 msgid ""
2040 "Long ago it was considered safe to have encrypted passwords openly visible "
2041 "in the password file.  When computers got faster and people got more "
2042 "security-conscious, this was no longer acceptable.  Julianne Frances Haugh "
2043 "implemented the shadow password suite that keeps the encrypted passwords in "
2044 "the shadow password database (e.g., the local shadow password file "
2045 "I</etc/shadow>, NIS, and LDAP), readable only by root."
2046 msgstr ""
2047
2048 #.  FIXME . I've commented out the following for the
2049 #.  moment.  The relationship between PAM and nsswitch.conf needs
2050 #.  to be clearly documented in one place, which is pointed to by
2051 #.  the pages for the user, group, and shadow password functions.
2052 #.  (Jul 2005, mtk)
2053 #
2054 #.  This shadow password setup has been superseded by PAM
2055 #.  (pluggable authentication modules), and the file
2056 #.  .I /etc/nsswitch.conf
2057 #.  now describes the sources to be used.
2058 #. type: Plain text
2059 #: build/C/man3/getspnam.3:101
2060 msgid ""
2061 "The functions described below resemble those for the traditional password "
2062 "database (e.g., see B<getpwnam>(3)  and B<getpwent>(3))."
2063 msgstr ""
2064
2065 #. type: Plain text
2066 #: build/C/man3/getspnam.3:108
2067 msgid ""
2068 "The B<getspnam>()  function returns a pointer to a structure containing the "
2069 "broken-out fields of the record in the shadow password database that matches "
2070 "the username I<name>."
2071 msgstr ""
2072
2073 #.  some systems require a call of setspent() before the first getspent()
2074 #.  glibc does not
2075 #. type: Plain text
2076 #: build/C/man3/getspnam.3:120
2077 msgid ""
2078 "The B<getspent>()  function returns a pointer to the next entry in the "
2079 "shadow password database.  The position in the input stream is initialized "
2080 "by B<setspent>().  When done reading, the program may call B<endspent>()  so "
2081 "that resources can be deallocated."
2082 msgstr ""
2083
2084 #. type: Plain text
2085 #: build/C/man3/getspnam.3:127
2086 msgid ""
2087 "The B<fgetspent>()  function is similar to B<getspent>()  but uses the "
2088 "supplied stream instead of the one implicitly opened by B<setspent>()."
2089 msgstr ""
2090
2091 #. type: Plain text
2092 #: build/C/man3/getspnam.3:134
2093 msgid ""
2094 "The B<sgetspent>()  function parses the supplied string I<s> into a struct "
2095 "I<spwd>."
2096 msgstr ""
2097
2098 #. type: Plain text
2099 #: build/C/man3/getspnam.3:144
2100 msgid ""
2101 "The B<putspent>()  function writes the contents of the supplied struct "
2102 "I<spwd> I<*p> as a text line in the shadow password file format to the "
2103 "stream I<fp>.  String entries with value NULL and numerical entries with "
2104 "value -1 are written as an empty string."
2105 msgstr ""
2106
2107 #. type: Plain text
2108 #: build/C/man3/getspnam.3:159
2109 msgid ""
2110 "The B<lckpwdf>()  function is intended to protect against multiple "
2111 "simultaneous accesses of the shadow password database.  It tries to acquire "
2112 "a lock, and returns 0 on success, or -1 on failure (lock not obtained within "
2113 "15 seconds).  The B<ulckpwdf>()  function releases the lock again.  Note "
2114 "that there is no protection against direct access of the shadow password "
2115 "file.  Only programs that use B<lckpwdf>()  will notice the lock."
2116 msgstr ""
2117
2118 #.  Also in libc5
2119 #.  SUN doesn't have sgetspent()
2120 #. type: Plain text
2121 #: build/C/man3/getspnam.3:164
2122 msgid ""
2123 "These were the functions that formed the original shadow API.  They are "
2124 "widely available."
2125 msgstr ""
2126
2127 #. type: SS
2128 #: build/C/man3/getspnam.3:164
2129 #, no-wrap
2130 msgid "Reentrant versions"
2131 msgstr ""
2132
2133 #. type: Plain text
2134 #: build/C/man3/getspnam.3:181
2135 msgid ""
2136 "Analogous to the reentrant functions for the password database, glibc also "
2137 "has reentrant functions for the shadow password database.  The "
2138 "B<getspnam_r>()  function is like B<getspnam>()  but stores the retrieved "
2139 "shadow password structure in the space pointed to by I<spbuf>.  This shadow "
2140 "password structure contains pointers to strings, and these strings are "
2141 "stored in the buffer I<buf> of size I<buflen>.  A pointer to the result (in "
2142 "case of success) or NULL (in case no entry was found or an error occurred) "
2143 "is stored in I<*spbufp>."
2144 msgstr ""
2145
2146 #. type: Plain text
2147 #: build/C/man3/getspnam.3:188
2148 msgid ""
2149 "The functions B<getspent_r>(), B<fgetspent_r>(), and B<sgetspent_r>()  are "
2150 "similarly analogous to their nonreentrant counterparts."
2151 msgstr ""
2152
2153 #.  SUN doesn't have sgetspent_r()
2154 #. type: Plain text
2155 #: build/C/man3/getspnam.3:192
2156 msgid ""
2157 "Some non-glibc systems also have functions with these names, often with "
2158 "different prototypes."
2159 msgstr ""
2160
2161 #. type: SS
2162 #: build/C/man3/getspnam.3:192
2163 #, no-wrap
2164 msgid "Structure"
2165 msgstr ""
2166
2167 #. type: Plain text
2168 #: build/C/man3/getspnam.3:194
2169 msgid ""
2170 "The shadow password structure is defined in I<E<lt>shadow.hE<gt>> as "
2171 "follows:"
2172 msgstr ""
2173
2174 #. type: Plain text
2175 #: build/C/man3/getspnam.3:214
2176 #, no-wrap
2177 msgid ""
2178 "struct spwd {\n"
2179 "    char *sp_namp;     /* Login name */\n"
2180 "    char *sp_pwdp;     /* Encrypted password */\n"
2181 "    long  sp_lstchg;   /* Date of last change\n"
2182 "                          (measured in days since\n"
2183 "                          1970-01-01 00:00:00 +0000 (UTC)) */\n"
2184 "    long  sp_min;      /* Min # of days between changes */\n"
2185 "    long  sp_max;      /* Max # of days between changes */\n"
2186 "    long  sp_warn;     /* # of days before password expires\n"
2187 "                          to warn user to change it */\n"
2188 "    long  sp_inact;    /* # of days after password expires\n"
2189 "                          until account is disabled */\n"
2190 "    long  sp_expire;   /* Date when account expires\n"
2191 "                          (measured in days since\n"
2192 "                          1970-01-01 00:00:00 +0000 (UTC)) */\n"
2193 "    unsigned long sp_flag;  /* Reserved */\n"
2194 "};\n"
2195 msgstr ""
2196
2197 #. type: Plain text
2198 #: build/C/man3/getspnam.3:223
2199 msgid ""
2200 "The functions that return a pointer return NULL if no more entries are "
2201 "available or if an error occurs during processing.  The functions which have "
2202 "I<int> as the return value return 0 for success and -1 for failure, with "
2203 "I<errno> set to indicate the cause of the error."
2204 msgstr ""
2205
2206 #. type: Plain text
2207 #: build/C/man3/getspnam.3:226
2208 msgid ""
2209 "For the nonreentrant functions, the return value may point to static area, "
2210 "and may be overwritten by subsequent calls to these functions."
2211 msgstr ""
2212
2213 #. type: Plain text
2214 #: build/C/man3/getspnam.3:229
2215 msgid ""
2216 "The reentrant functions return zero on success.  In case of error, an error "
2217 "number is returned."
2218 msgstr ""
2219
2220 #. type: TP
2221 #: build/C/man3/getspnam.3:230
2222 #, no-wrap
2223 msgid "B<EACCES>"
2224 msgstr ""
2225
2226 #. type: Plain text
2227 #: build/C/man3/getspnam.3:233
2228 msgid "The caller does not have permission to access the shadow password file."
2229 msgstr ""
2230
2231 #. type: Plain text
2232 #: build/C/man3/getspnam.3:236
2233 msgid "Supplied buffer is too small."
2234 msgstr ""
2235
2236 #. type: TP
2237 #: build/C/man3/getspnam.3:237
2238 #, no-wrap
2239 msgid "I</etc/shadow>"
2240 msgstr ""
2241
2242 #. type: Plain text
2243 #: build/C/man3/getspnam.3:240
2244 msgid "local shadow password database file"
2245 msgstr ""
2246
2247 #. type: TP
2248 #: build/C/man3/getspnam.3:240
2249 #, no-wrap
2250 msgid "I</etc/.pwd.lock>"
2251 msgstr ""
2252
2253 #. type: Plain text
2254 #: build/C/man3/getspnam.3:243
2255 msgid "lock file"
2256 msgstr ""
2257
2258 #. type: Plain text
2259 #: build/C/man3/getspnam.3:249
2260 msgid ""
2261 "The include file I<E<lt>paths.hE<gt>> defines the constant B<_PATH_SHADOW> "
2262 "to the pathname of the shadow password file."
2263 msgstr ""
2264
2265 #. type: Plain text
2266 #: build/C/man3/getspnam.3:253
2267 msgid ""
2268 "The shadow password database and its associated API are not specified in "
2269 "POSIX.1-2001.  However, many other systems provide a similar API."
2270 msgstr ""
2271
2272 #. type: Plain text
2273 #: build/C/man3/getspnam.3:258
2274 msgid "B<getgrnam>(3), B<getpwnam>(3), B<getpwnam_r>(3), B<shadow>(5)"
2275 msgstr ""
2276
2277 #. type: TH
2278 #: build/C/man5/group.5:26
2279 #, no-wrap
2280 msgid "GROUP"
2281 msgstr ""
2282
2283 #. type: Plain text
2284 #: build/C/man5/group.5:29
2285 msgid "group - user group file"
2286 msgstr ""
2287
2288 #. type: Plain text
2289 #: build/C/man5/group.5:34
2290 msgid ""
2291 "The I</etc/group> file is a text file that defines the groups on the "
2292 "system.  There is one entry per line, with the following format:"
2293 msgstr ""
2294
2295 #. type: Plain text
2296 #: build/C/man5/group.5:37
2297 msgid "group_name:password:GID:user_list"
2298 msgstr ""
2299
2300 #. type: Plain text
2301 #: build/C/man5/group.5:40
2302 msgid "The fields are as follows:"
2303 msgstr ""
2304
2305 #. type: TP
2306 #: build/C/man5/group.5:40
2307 #, no-wrap
2308 msgid "I<group_name>"
2309 msgstr ""
2310
2311 #. type: Plain text
2312 #: build/C/man5/group.5:43
2313 msgid "the name of the group."
2314 msgstr ""
2315
2316 #. type: TP
2317 #: build/C/man5/group.5:43 build/C/man5/passwd.5:91
2318 #, no-wrap
2319 msgid "I<password>"
2320 msgstr ""
2321
2322 #. type: Plain text
2323 #: build/C/man5/group.5:47
2324 msgid ""
2325 "the (encrypted) group password.  If this field is empty, no password is "
2326 "needed."
2327 msgstr ""
2328
2329 #. type: TP
2330 #: build/C/man5/group.5:47 build/C/man5/passwd.5:103
2331 #, no-wrap
2332 msgid "I<GID>"
2333 msgstr ""
2334
2335 #. type: Plain text
2336 #: build/C/man5/group.5:50
2337 msgid "the numeric group ID."
2338 msgstr ""
2339
2340 #. type: TP
2341 #: build/C/man5/group.5:50
2342 #, no-wrap
2343 msgid "I<user_list>"
2344 msgstr ""
2345
2346 #. type: Plain text
2347 #: build/C/man5/group.5:53
2348 msgid "a list of the usernames that are members of this group, separated by commas."
2349 msgstr ""
2350
2351 #. type: Plain text
2352 #: build/C/man5/group.5:55
2353 msgid "/etc/group"
2354 msgstr ""
2355
2356 #. type: Plain text
2357 #: build/C/man5/group.5:61
2358 msgid ""
2359 "As the 4.2BSD B<initgroups>(3)  man page says: No-one seems to keep "
2360 "I</etc/group> up-to-date."
2361 msgstr ""
2362
2363 #. type: Plain text
2364 #: build/C/man5/group.5:67
2365 msgid "B<login>(1), B<newgrp>(1), B<getgrent>(3), B<getgrnam>(3), B<passwd>(5)"
2366 msgstr ""
2367
2368 #. type: TH
2369 #: build/C/man3/initgroups.3:32
2370 #, no-wrap
2371 msgid "INITGROUPS"
2372 msgstr ""
2373
2374 #. type: TH
2375 #: build/C/man3/initgroups.3:32
2376 #, no-wrap
2377 msgid "2007-07-26"
2378 msgstr ""
2379
2380 #. type: Plain text
2381 #: build/C/man3/initgroups.3:35
2382 msgid "initgroups - initialize the supplementary group access list"
2383 msgstr ""
2384
2385 #. type: Plain text
2386 #: build/C/man3/initgroups.3:41
2387 #, no-wrap
2388 msgid "B<int initgroups(const char *>I<user>B<, gid_t >I<group>B<);>\n"
2389 msgstr ""
2390
2391 #. type: Plain text
2392 #: build/C/man3/initgroups.3:50
2393 msgid "B<initgroups>(): _BSD_SOURCE"
2394 msgstr ""
2395
2396 #. type: Plain text
2397 #: build/C/man3/initgroups.3:64
2398 msgid ""
2399 "The B<initgroups>()  function initializes the group access list by reading "
2400 "the group database I</etc/group> and using all groups of which I<user> is a "
2401 "member.  The additional group I<group> is also added to the list."
2402 msgstr ""
2403
2404 #. type: Plain text
2405 #: build/C/man3/initgroups.3:68
2406 msgid "The I<user> argument must be non-NULL."
2407 msgstr ""
2408
2409 #. type: Plain text
2410 #: build/C/man3/initgroups.3:75
2411 msgid ""
2412 "The B<initgroups>()  function returns 0 on success.  On error, -1 is "
2413 "returned, and I<errno> is set appropriately."
2414 msgstr ""
2415
2416 #. type: Plain text
2417 #: build/C/man3/initgroups.3:79
2418 msgid "Insufficient memory to allocate group information structure."
2419 msgstr ""
2420
2421 #. type: TP
2422 #: build/C/man3/initgroups.3:79
2423 #, no-wrap
2424 msgid "B<EPERM>"
2425 msgstr ""
2426
2427 #. type: Plain text
2428 #: build/C/man3/initgroups.3:84
2429 msgid ""
2430 "The calling process has insufficient privilege.  See the underlying system "
2431 "call B<setgroups>(2)."
2432 msgstr ""
2433
2434 #. type: Plain text
2435 #: build/C/man3/initgroups.3:87
2436 #, no-wrap
2437 msgid "I</etc/group>\t\tgroup database file\n"
2438 msgstr ""
2439
2440 #. type: Plain text
2441 #: build/C/man3/initgroups.3:90
2442 msgid "SVr4, 4.3BSD."
2443 msgstr ""
2444
2445 #. type: Plain text
2446 #: build/C/man3/initgroups.3:94
2447 msgid "B<getgroups>(2), B<setgroups>(2), B<credentials>(7)"
2448 msgstr ""
2449
2450 #. type: TH
2451 #: build/C/man5/passwd.5:30
2452 #, no-wrap
2453 msgid "PASSWD"
2454 msgstr ""
2455
2456 #. type: TH
2457 #: build/C/man5/passwd.5:30
2458 #, no-wrap
2459 msgid "2014-02-11"
2460 msgstr ""
2461
2462 #. type: Plain text
2463 #: build/C/man5/passwd.5:33
2464 msgid "passwd - password file"
2465 msgstr ""
2466
2467 #. type: Plain text
2468 #: build/C/man5/passwd.5:41
2469 msgid ""
2470 "The I</etc/passwd> file is a text file that describes user login accounts "
2471 "for the system.  It should have read permission allowed for all users (many "
2472 "utilities, like B<ls>(1)  use it to map user IDs to usernames), but write "
2473 "access only for the superuser."
2474 msgstr ""
2475
2476 #. type: Plain text
2477 #: build/C/man5/passwd.5:53
2478 msgid ""
2479 "In the good old days there was no great problem with this general read "
2480 "permission.  Everybody could read the encrypted passwords, but the hardware "
2481 "was too slow to crack a well-chosen password, and moreover the basic "
2482 "assumption used to be that of a friendly user-community.  These days many "
2483 "people run some version of the shadow password suite, where I</etc/passwd> "
2484 "has an \\(aqx\\(aq character in the password field, and the encrypted "
2485 "passwords are in I</etc/shadow>, which is readable by the superuser only."
2486 msgstr ""
2487
2488 #. type: Plain text
2489 #: build/C/man5/passwd.5:62
2490 msgid ""
2491 "If the encrypted password, whether in I</etc/passwd> or in I</etc/shadow>, "
2492 "is an empty string, login is allowed without even asking for a password.  "
2493 "Note that this functionality may be intentionally disabled in applications, "
2494 "or configurable (for example using the \"nullok\" or \"nonull\" arguments to "
2495 "pam_unix.so)."
2496 msgstr ""
2497
2498 #. type: Plain text
2499 #: build/C/man5/passwd.5:67
2500 msgid ""
2501 "If the encrypted password in I</etc/passwd> is \"I<*NP*>\" (without the "
2502 "quotes), the shadow record should be obtained from an NIS+ server."
2503 msgstr ""
2504
2505 #. type: Plain text
2506 #: build/C/man5/passwd.5:73
2507 msgid ""
2508 "Regardless of whether shadow passwords are used, many system administrators "
2509 "use an asterisk (*) in the encrypted password field to make sure that this "
2510 "user can not authenticate him- or herself using a password.  (But see NOTES "
2511 "below.)"
2512 msgstr ""
2513
2514 #. type: Plain text
2515 #: build/C/man5/passwd.5:78
2516 msgid ""
2517 "If you create a new login, first put an asterisk (*) in the password field, "
2518 "then use B<passwd>(1)  to set it."
2519 msgstr ""
2520
2521 #. type: Plain text
2522 #: build/C/man5/passwd.5:81
2523 msgid ""
2524 "Each line of the file describes a single user, and contains seven "
2525 "colon-separated fields:"
2526 msgstr ""
2527
2528 #. type: Plain text
2529 #: build/C/man5/passwd.5:84
2530 msgid "name:password:UID:GID:GECOS:directory:shell"
2531 msgstr ""
2532
2533 #. type: Plain text
2534 #: build/C/man5/passwd.5:87
2535 msgid "The field are as follows:"
2536 msgstr ""
2537
2538 #. type: TP
2539 #: build/C/man5/passwd.5:87
2540 #, no-wrap
2541 msgid "I<name>"
2542 msgstr ""
2543
2544 #. type: Plain text
2545 #: build/C/man5/passwd.5:91
2546 msgid "This is the user's login name.  It should not contain capital letters."
2547 msgstr ""
2548
2549 #. type: Plain text
2550 #: build/C/man5/passwd.5:98
2551 msgid ""
2552 "This is either the encrypted user password, an asterisk (*), or the letter "
2553 "\\(aqx\\(aq.  (See B<pwconv>(8)  for an explanation of \\(aqx\\(aq.)"
2554 msgstr ""
2555
2556 #. type: TP
2557 #: build/C/man5/passwd.5:98
2558 #, no-wrap
2559 msgid "I<UID>"
2560 msgstr ""
2561
2562 #. type: Plain text
2563 #: build/C/man5/passwd.5:103
2564 msgid "The privileged I<root> login account (superuser) has the user ID 0."
2565 msgstr ""
2566
2567 #. type: Plain text
2568 #: build/C/man5/passwd.5:108
2569 msgid ""
2570 "This is the numeric primary group ID for this user.  (Additional groups for "
2571 "the user are defined in the system group file; see B<group>(5))."
2572 msgstr ""
2573
2574 #. type: TP
2575 #: build/C/man5/passwd.5:108
2576 #, no-wrap
2577 msgid "I<GECOS>"
2578 msgstr ""
2579
2580 #. type: Plain text
2581 #: build/C/man5/passwd.5:116
2582 msgid ""
2583 "This field (sometimes called the \"comment field\")  is optional and used "
2584 "only for informational purposes.  Usually, it contains the full username.  "
2585 "Some programs (for example, B<finger>(1))  display information from this "
2586 "field."
2587 msgstr ""
2588
2589 #. type: Plain text
2590 #: build/C/man5/passwd.5:125
2591 msgid ""
2592 "GECOS stands for \"General Electric Comprehensive Operating System\", which "
2593 "was renamed to GCOS when GE's large systems division was sold to Honeywell.  "
2594 "Dennis Ritchie has reported: \"Sometimes we sent printer output or batch "
2595 "jobs to the GCOS machine.  The gcos field in the password file was a place "
2596 "to stash the information for the $IDENTcard.  Not elegant.\""
2597 msgstr ""
2598
2599 #. type: TP
2600 #: build/C/man5/passwd.5:125
2601 #, no-wrap
2602 msgid "I<directory>"
2603 msgstr ""
2604
2605 #. type: Plain text
2606 #: build/C/man5/passwd.5:132
2607 msgid ""
2608 "This is the user's home directory: the initial directory where the user is "
2609 "placed after logging in.  The value in this field is used to set the B<HOME> "
2610 "environment variable."
2611 msgstr ""
2612
2613 #. type: TP
2614 #: build/C/man5/passwd.5:132
2615 #, no-wrap
2616 msgid "I<shell>"
2617 msgstr ""
2618
2619 #. type: Plain text
2620 #: build/C/man5/passwd.5:142
2621 msgid ""
2622 "This is the program to run at login (if empty, use I</bin/sh>).  If set to a "
2623 "nonexistent executable, the user will be unable to login through "
2624 "B<login>(1).  The value in this field is used to set the B<SHELL> "
2625 "environment variable."
2626 msgstr ""
2627
2628 #. type: Plain text
2629 #: build/C/man5/passwd.5:148
2630 msgid ""
2631 "If you want to create user groups, there must be an entry in I</etc/group>, "
2632 "or no group will exist."
2633 msgstr ""
2634
2635 #. type: Plain text
2636 #: build/C/man5/passwd.5:162
2637 msgid ""
2638 "If the encrypted password is set to an asterisk (*), the user will be unable "
2639 "to login using B<login>(1), but may still login using B<rlogin>(1), run "
2640 "existing processes and initiate new ones through B<rsh>(1), B<cron>(8), "
2641 "B<at>(1), or mail filters, etc.  Trying to lock an account by simply "
2642 "changing the shell field yields the same result and additionally allows the "
2643 "use of B<su>(1)."
2644 msgstr ""
2645
2646 #. type: Plain text
2647 #: build/C/man5/passwd.5:171
2648 msgid ""
2649 "B<login>(1), B<passwd>(1), B<su>(1), B<crypt>(3), B<getpwent>(3), "
2650 "B<getpwnam>(3), B<group>(5), B<shadow>(5)"
2651 msgstr ""
2652
2653 #. type: TH
2654 #: build/C/man3/putgrent.3:7
2655 #, no-wrap
2656 msgid "PUTGRENT"
2657 msgstr ""
2658
2659 #. type: TH
2660 #: build/C/man3/putgrent.3:7 build/C/man3/setaliasent.3:9
2661 #, no-wrap
2662 msgid "2003-09-09"
2663 msgstr ""
2664
2665 #. type: Plain text
2666 #: build/C/man3/putgrent.3:10
2667 msgid "putgrent - write a group database entry to a file"
2668 msgstr ""
2669
2670 #. type: Plain text
2671 #: build/C/man3/putgrent.3:12
2672 msgid "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */"
2673 msgstr ""
2674
2675 #. type: Plain text
2676 #: build/C/man3/putgrent.3:16
2677 msgid "B<int putgrent(const struct group *>I<grp>B<, FILE *>I<fp>B<);>"
2678 msgstr ""
2679
2680 #. type: Plain text
2681 #: build/C/man3/putgrent.3:27
2682 msgid ""
2683 "The B<putgrent>()  function is the counterpart for B<fgetgrent>(3).  The "
2684 "function writes the content of the provided I<struct group> into the file "
2685 "pointed to by I<fp>.  The list of group members must be NULL-terminated or "
2686 "NULL-initialized."
2687 msgstr ""
2688
2689 #. type: Plain text
2690 #: build/C/man3/putgrent.3:31
2691 msgid "The I<struct group> is defined as follows:"
2692 msgstr ""
2693
2694 #. type: Plain text
2695 #: build/C/man3/putgrent.3:40
2696 #, no-wrap
2697 msgid ""
2698 "struct group {\n"
2699 "    char   *gr_name;      /* group name */\n"
2700 "    char   *gr_passwd;    /* group password */\n"
2701 "    gid_t   gr_gid;       /* group ID */\n"
2702 "    char  **gr_mem;       /* group members */\n"
2703 "};\n"
2704 msgstr ""
2705
2706 #. type: Plain text
2707 #: build/C/man3/putgrent.3:44
2708 msgid "The function returns zero on success, and a nonzero value on error."
2709 msgstr ""
2710
2711 #. type: Plain text
2712 #: build/C/man3/putgrent.3:46
2713 msgid "This function is a GNU extension."
2714 msgstr ""
2715
2716 #. type: Plain text
2717 #: build/C/man3/putgrent.3:50
2718 msgid "B<fgetgrent>(3), B<getgrent>(3), B<group>(5)"
2719 msgstr ""
2720
2721 #. type: TH
2722 #: build/C/man3/putpwent.3:30
2723 #, no-wrap
2724 msgid "PUTPWENT"
2725 msgstr ""
2726
2727 #. type: Plain text
2728 #: build/C/man3/putpwent.3:33
2729 msgid "putpwent - write a password file entry"
2730 msgstr ""
2731
2732 #. type: Plain text
2733 #: build/C/man3/putpwent.3:40
2734 #, no-wrap
2735 msgid "B<int putpwent(const struct passwd *>I<p>B<, FILE *>I<stream>B<);>\n"
2736 msgstr ""
2737
2738 #. type: Plain text
2739 #: build/C/man3/putpwent.3:49
2740 msgid "B<putpwent>(): _SVID_SOURCE"
2741 msgstr ""
2742
2743 #. type: Plain text
2744 #: build/C/man3/putpwent.3:54
2745 msgid ""
2746 "The B<putpwent>()  function writes a password entry from the structure I<p> "
2747 "in the file associated with I<stream>."
2748 msgstr ""
2749
2750 #. type: Plain text
2751 #: build/C/man3/putpwent.3:68
2752 #, no-wrap
2753 msgid ""
2754 "struct passwd {\n"
2755 "    char    *pw_name;        /* username */\n"
2756 "    char    *pw_passwd;      /* user password */\n"
2757 "    uid_t    pw_uid;         /* user ID */\n"
2758 "    gid_t    pw_gid;         /* group ID */\n"
2759 "    char    *pw_gecos;       /* real name */\n"
2760 "    char    *pw_dir;         /* home directory */\n"
2761 "    char    *pw_shell;       /* shell program */\n"
2762 "};\n"
2763 msgstr ""
2764
2765 #. type: Plain text
2766 #: build/C/man3/putpwent.3:78
2767 msgid ""
2768 "The B<putpwent>()  function returns 0 on success, or -1 if an error occurs.  "
2769 "In the event of an error, I<errno> is set to indicate the cause."
2770 msgstr ""
2771
2772 #. type: Plain text
2773 #: build/C/man3/putpwent.3:82
2774 msgid "Invalid (NULL) argument given."
2775 msgstr ""
2776
2777 #. type: Plain text
2778 #: build/C/man3/putpwent.3:92
2779 msgid ""
2780 "B<endpwent>(3), B<fgetpwent>(3), B<getpw>(3), B<getpwent>(3), "
2781 "B<getpwnam>(3), B<getpwuid>(3), B<setpwent>(3)"
2782 msgstr ""
2783
2784 #. type: TH
2785 #: build/C/man3/setaliasent.3:9
2786 #, no-wrap
2787 msgid "SETALIASENT"
2788 msgstr ""
2789
2790 #. type: Plain text
2791 #: build/C/man3/setaliasent.3:13
2792 msgid ""
2793 "setaliasent, endaliasent, getaliasent, getaliasent_r, getaliasbyname, "
2794 "getaliasbyname_r - read an alias entry"
2795 msgstr ""
2796
2797 #. type: Plain text
2798 #: build/C/man3/setaliasent.3:15
2799 msgid "B<#include E<lt>aliases.hE<gt>>"
2800 msgstr ""
2801
2802 #. type: Plain text
2803 #: build/C/man3/setaliasent.3:17
2804 msgid "B<void setaliasent(void);>"
2805 msgstr ""
2806
2807 #. type: Plain text
2808 #: build/C/man3/setaliasent.3:19
2809 msgid "B<void endaliasent(void);>"
2810 msgstr ""
2811
2812 #. type: Plain text
2813 #: build/C/man3/setaliasent.3:21
2814 msgid "B<struct aliasent *getaliasent(void);>"
2815 msgstr ""
2816
2817 #. type: Plain text
2818 #: build/C/man3/setaliasent.3:23
2819 msgid "B<int getaliasent_r(struct aliasent *>I<result>B<,>"
2820 msgstr ""
2821
2822 #. type: Plain text
2823 #: build/C/man3/setaliasent.3:25 build/C/man3/setaliasent.3:31
2824 msgid "B< char *>I<buffer>B<, size_t >I<buflen>B<, struct aliasent **>I<res>B<);>"
2825 msgstr ""
2826
2827 #. type: Plain text
2828 #: build/C/man3/setaliasent.3:27
2829 msgid "B<struct aliasent *getaliasbyname(const char *>I<name>B<);>"
2830 msgstr ""
2831
2832 #. type: Plain text
2833 #: build/C/man3/setaliasent.3:29
2834 msgid ""
2835 "B<int getaliasbyname_r(const char *>I<name>B<, struct aliasent "
2836 "*>I<result>B<,>"
2837 msgstr ""
2838
2839 #. type: Plain text
2840 #: build/C/man3/setaliasent.3:37
2841 msgid ""
2842 "One of the databases available with the Name Service Switch (NSS)  is the "
2843 "aliases database, that contains mail aliases.  (To find out which databases "
2844 "are supported, try I<getent --help>.)  Six functions are provided to access "
2845 "the aliases database."
2846 msgstr ""
2847
2848 #. type: Plain text
2849 #: build/C/man3/setaliasent.3:44
2850 msgid ""
2851 "The B<getaliasent>()  function returns a pointer to a structure containing "
2852 "the group information from the aliases database.  The first time it is "
2853 "called it returns the first entry; thereafter, it returns successive "
2854 "entries."
2855 msgstr ""
2856
2857 #. type: Plain text
2858 #: build/C/man3/setaliasent.3:49
2859 msgid ""
2860 "The B<setaliasent>()  function rewinds the file pointer to the beginning of "
2861 "the aliases database."
2862 msgstr ""
2863
2864 #. type: Plain text
2865 #: build/C/man3/setaliasent.3:53
2866 msgid "The B<endaliasent>()  function closes the aliases database."
2867 msgstr ""
2868
2869 #. type: Plain text
2870 #: build/C/man3/setaliasent.3:60
2871 msgid ""
2872 "B<getaliasent_r>()  is the reentrant version of the previous function.  The "
2873 "requested structure is stored via the first argument but the programmer "
2874 "needs to fill the other arguments also.  Not providing enough space causes "
2875 "the function to fail."
2876 msgstr ""
2877
2878 #. type: Plain text
2879 #: build/C/man3/setaliasent.3:66
2880 msgid ""
2881 "The function B<getaliasbyname>()  takes the name argument and searches the "
2882 "aliases database.  The entry is returned as a pointer to a I<struct "
2883 "aliasent>."
2884 msgstr ""
2885
2886 #. type: Plain text
2887 #: build/C/man3/setaliasent.3:73
2888 msgid ""
2889 "B<getaliasbyname_r>()  is the reentrant version of the previous function.  "
2890 "The requested structure is stored via the second argument but the programmer "
2891 "needs to fill the other arguments also.  Not providing enough space causes "
2892 "the function to fail."
2893 msgstr ""
2894
2895 #. type: Plain text
2896 #: build/C/man3/setaliasent.3:78
2897 msgid "The I<struct aliasent> is defined in I<E<lt>aliases.hE<gt>>:"
2898 msgstr ""
2899
2900 #. type: Plain text
2901 #: build/C/man3/setaliasent.3:87
2902 #, no-wrap
2903 msgid ""
2904 "struct aliasent {\n"
2905 "    char    *alias_name;             /* alias name */\n"
2906 "    size_t   alias_members_len;\n"
2907 "    char   **alias_members;          /* alias name list */\n"
2908 "    int      alias_local;\n"
2909 "};\n"
2910 msgstr ""
2911
2912 #. type: Plain text
2913 #: build/C/man3/setaliasent.3:95
2914 msgid ""
2915 "The functions B<getaliasent_r>()  and B<getaliasbyname_r>()  return a "
2916 "nonzero value on error."
2917 msgstr ""
2918
2919 #. type: Plain text
2920 #: build/C/man3/setaliasent.3:101
2921 msgid ""
2922 "The default alias database is the file I</etc/aliases>.  This can be changed "
2923 "in the I</etc/nsswitch.conf> file."
2924 msgstr ""
2925
2926 #. type: Plain text
2927 #: build/C/man3/setaliasent.3:104
2928 msgid "These routines are glibc-specific.  The NeXT system has similar routines:"
2929 msgstr ""
2930
2931 #. type: Plain text
2932 #: build/C/man3/setaliasent.3:108
2933 #, no-wrap
2934 msgid "#include E<lt>aliasdb.hE<gt>\n"
2935 msgstr ""
2936
2937 #. type: Plain text
2938 #: build/C/man3/setaliasent.3:113
2939 #, no-wrap
2940 msgid ""
2941 "void alias_setent(void);\n"
2942 "void alias_endent(void);\n"
2943 "alias_ent *alias_getent(void);\n"
2944 "alias_ent *alias_getbyname(char *name);\n"
2945 msgstr ""
2946
2947 #. type: Plain text
2948 #: build/C/man3/setaliasent.3:119
2949 msgid ""
2950 "The following example compiles with I<gcc example.c -o example>.  It will "
2951 "dump all names in the alias database."
2952 msgstr ""
2953
2954 #. type: Plain text
2955 #: build/C/man3/setaliasent.3:125
2956 #, no-wrap
2957 msgid ""
2958 "#include E<lt>aliases.hE<gt>\n"
2959 "#include E<lt>stdio.hE<gt>\n"
2960 "#include E<lt>stdlib.hE<gt>\n"
2961 "#include E<lt>errno.hE<gt>\n"
2962 msgstr ""
2963
2964 #. type: Plain text
2965 #: build/C/man3/setaliasent.3:144
2966 #, no-wrap
2967 msgid ""
2968 "int\n"
2969 "main(void)\n"
2970 "{\n"
2971 "    struct aliasent *al;\n"
2972 "    setaliasent();\n"
2973 "    for (;;) {\n"
2974 "        al = getaliasent();\n"
2975 "        if (al == NULL)\n"
2976 "            break;\n"
2977 "        printf(\"Name: %s\\en\", al-E<gt>alias_name);\n"
2978 "    }\n"
2979 "    if (errno) {\n"
2980 "        perror(\"reading alias\");\n"
2981 "        exit(EXIT_FAILURE);\n"
2982 "    }\n"
2983 "    endaliasent();\n"
2984 "    exit(EXIT_SUCCESS);\n"
2985 "}\n"
2986 msgstr ""
2987
2988 #
2989 #.  /etc/sendmail/aliases
2990 #.  Yellow Pages
2991 #.  newaliases, postalias
2992 #. type: Plain text
2993 #: build/C/man3/setaliasent.3:154
2994 msgid "B<getgrent>(3), B<getpwent>(3), B<getspent>(3), B<aliases>(5)"
2995 msgstr ""