getent

 

---

 
 
 
 Maintenance Commands                                   getent(1M)
 
 
 


NAME
      getent - get entries from administrative database
 


SYNOPSIS
      getent database  [ key ... ]
 


DESCRIPTION
      getent gets a list of entries from the administrative  data-
      base  specified by database. The information generally comes
      from one or more of the sources that are specified  for  the
      database in /etc/nsswitch.conf.
 
      database is the name of the database to  be  examined.  This
      can  be  passwd,  group, hosts,ipnodes, services, protocols,
      ethers, network, or netmasks. For each of these  databases,
      getent  uses  the  appropriate library routines described in
      getpwnam(3C),       getgrnam(3C),       gethostbyaddr(3NSL),
      gethostbyname(3NSL),               getipnodebyaddr(3SOCKET),
      getipnodebyname(3SOCKET),            getservbyname(3SOCKET),
      getprotobyname(3SOCKET),         ethers(3SOCKET),        and
      getnetbyname(3SOCKET), respectively.
 
      Each key must be in a format appropriate  for  searching  on
      the  respective  database. For example, it can be a username
      or numeric-uid for passwd; hostname or IP address for hosts;
      or  service,  service/protocol, port, or port/proto for ser-
      vices.
 
      getent prints out the database entries that  match  each  of
      the supplied keys, one per line, in the format of the match-
      ing  administrative  file:  passwd(4),  group(4),  hosts(4),
      ipnodes(4),services(4),  protocols(4), ethers(3SOCKET), net-
      works(4), or netmasks(4).  If no key is given,  all  entries
      returned  by  the corresponding enumeration library routine,
      for  example,  getpwent()  or  gethostent(),  are   printed.
      Enumeration is not supported on ipnodes.
 
 EXIT STATUS
      The following exit values are returned:
 
           0     Successful completion.
 
           1     Command syntax was incorrect, an  invalid  option
                 was used, or an internal error occurred.
 
           2     At least one of the specified entry names was not
                 found in the database.
 
           3     There is no support for enumeration on this data-
                 base.
 
 
 
 
 
 SunOS 5.8           Last change: 10 Nov 1999                    1
 
 
 
 
 
 
 Maintenance Commands                                   getent(1M)
 
 
 


FILES
      /etc/nsswitch.conf"
            name service switch configuration file
 
      /etc/passwd"
            password file
 
      /etc/group"
            group file
 
      /etc/inet/hosts"
            IPv4 host name database
 
      /etc/inet/ipnodes
            IPv4 and IPv6 host name database
 
      /etc/services"
            Internet services and aliases
 
      /etc/protocols"
            protocol name database
 
      /etc/ethers"
            Ethernet address to hostname database or domain
 
      /etc/networks"
            network name database
 
      /etc/netmasks"
            network mask database
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWcsu                     |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      ethers(3SOCKET),     getgrnam(3C),      gethostbyaddr(3NSL),
      gethostbyname(3NSL),                       gethostent(3NSL),
      getipnodebyaddr(3SOCKET),          getipnodebyname(3SOCKET),
      getnetbyname(3SOCKET),              getprotobyname(3SOCKET),
      getpwnam(3C),  getservbyname(3SOCKET),  group(4),  hosts(4),
      ipnodes(4),   netmasks(4),   network(4),  nsswitch.conf(4),
      passwd(4), protocols(4), services(4), attributes(5)
 
 
 
 
 
 SunOS 5.8           Last change: 10 Nov 1999                    2
 
 
 

---