Print this page
3243 Add shadow support to getent(1)

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/getent.1m
          +++ new/usr/src/man/man1m/getent.1m
   1    1  '\" te
        2 +.\" Copyright (c) 2014 Gary Mills
   2    3  .\" Copyright (C) 1999, Sun Microsystems, Inc. All Rights Reserved
   3    4  .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4    5  .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5    6  .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6      -.TH GETENT 1M "Mar 26, 2007"
        7 +.TH GETENT 1M "Mar 14, 2014"
   7    8  .SH NAME
   8    9  getent \- get entries from administrative database
   9   10  .SH SYNOPSIS
  10   11  .LP
  11   12  .nf
  12   13  \fBgetent\fR \fIdatabase\fR [\fIkey\fR]...
  13   14  .fi
  14   15  
  15   16  .SH DESCRIPTION
  16   17  .sp
  17   18  .LP
  18   19  \fBgetent\fR gets a list of entries from the administrative database specified
  19   20  by \fIdatabase\fR. The information generally comes from one or more of the
  20   21  sources that are specified for the \fIdatabase\fR in \fB/etc/nsswitch.conf\fR.
  21   22  .sp
  22   23  .LP
  23   24  \fIdatabase\fR is the name of the database to be examined. This can be
  24      -\fBpasswd\fR, \fBgroup\fR, \fBhosts\fR, \fBipnodes\fR, \fBservices\fR,
       25 +\fBpasswd\fR, \fBshadow\fR, \fBgroup\fR, \fBhosts\fR, \fBipnodes\fR, \fBservices\fR,
  25   26  \fBprotocols\fR, \fBethers\fR, \fBproject\fR, \fBnetworks\fR, or
  26   27  \fBnetmasks\fR. For each of these databases, \fBgetent\fR uses the appropriate
  27      -library routines described in \fBgetpwnam\fR(3C), \fBgetgrnam\fR(3C),
       28 +library routines described in \fBgetpwnam\fR(3C), \fBgetspnam\fR(3C), \fBgetgrnam\fR(3C),
  28   29  \fBgethostbyaddr\fR(3NSL), \fBgethostbyname\fR(3NSL),
  29   30  \fBgetipnodebyaddr\fR(3SOCKET), \fBgetipnodebyname\fR(3SOCKET),
  30   31  \fBgetservbyname\fR(3SOCKET), \fBgetprotobyname\fR(3SOCKET),
  31   32  \fBethers\fR(3SOCKET), \fBgetprojbyname\fR(3PROJECT) and
  32   33  \fBgetnetbyname\fR(3SOCKET), respectively.
  33   34  .sp
  34   35  .LP
  35   36  Each \fIkey\fR must be in a format appropriate for searching on the respective
  36   37  database. For example, it can be a \fIusername\fR or \fInumeric-uid\fR for
  37   38  \fBpasswd\fR; \fIhostname\fR or \fIIP\fR \fIaddress\fR for \fBhosts\fR; or
  38   39  \fIservice\fR, \fIservice/protocol\fR, \fIport\fR, or \fIport/proto\fR for
  39   40  \fBservices\fR.
  40   41  .sp
  41   42  .LP
  42   43  \fBgetent\fR prints out the database entries that match each of the supplied
  43   44  keys, one per line, in the format of the matching administrative file:
  44      -\fBpasswd\fR(4), \fBgroup\fR(4), \fBproject\fR(4), \fBhosts\fR(4),
       45 +\fBpasswd\fR(4), \fBshadow\fR(4), \fBgroup\fR(4), \fBproject\fR(4), \fBhosts\fR(4),
  45   46  \fBservices\fR(4), \fBprotocols\fR(4), \fBethers\fR(3SOCKET),
  46   47  \fBnetworks\fR(4), or \fBnetmasks\fR(4). If no key is given, all entries
  47   48  returned by the corresponding enumeration library routine, for example,
  48   49  \fBgetpwent()\fR or \fBgethostent()\fR, are printed. Enumeration is not
  49   50  supported on \fBipnodes\fR.
  50   51  .SS "Key Interpretation for \fBpasswd\fR and \fBgroup\fR Databases"
  51   52  .sp
  52   53  .LP
  53   54  When \fBgetent\fR is invoked with database set to \fBpasswd\fR, each key value
  54   55  is processed as follows:
↓ open down ↓ 86 lines elided ↑ open up ↑
 141  142  
 142  143  .sp
 143  144  .ne 2
 144  145  .na
 145  146  \fB\fB/etc/passwd\fR\fR
 146  147  .ad
 147  148  .RS 22n
 148  149  password file
 149  150  .RE
 150  151  
      152 +.sp
      153 +.ne 2
      154 +.na
      155 +\fB\fB/etc/shadow\fR\fR
      156 +.ad
      157 +.RS 22n
      158 +shadowed password file
      159 +.RE
      160 +
 151  161  .sp
 152  162  .ne 2
 153  163  .na
 154  164  \fB\fB/etc/group\fR\fR
 155  165  .ad
 156  166  .RS 22n
 157  167  group file
 158  168  .RE
 159  169  
 160  170  .sp
↓ open down ↓ 73 lines elided ↑ open up ↑
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX