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