Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GETENT(1)		    General Commands Manual		     GETENT(1)

NAME
       getent -- get entries from administrative database

SYNOPSIS
       getent database [key ...]

DESCRIPTION
       The  getent utility retrieves and displays entries from the administra-
       tive database specified by database, using the lookup  order  specified
       in nsswitch.conf(5).  The display format	for a given database is	as per
       the "traditional" file format for that database.

       The database argument may be one	of:

	     Database	 Display format
	     ethers	 address name
	     group	 group:passwd:gid:[member[,member]...]
	     hosts	 address name [alias ...]
	     netgroup	 (host,user,domain) [...]
	     networks	 name network [alias ...]
	     passwd	 user:passwd:uid:gid:gecos:home_dir:shell
	     protocols	 name protocol [alias ...]
	     rpc	 name number [alias ...]
	     services	 name port/protocol [alias ...]
	     shells	 /path/to/shell
	     utmpx	 [time]	type: properties

       If  one	or  more key arguments are provided, they will be looked up in
       database	using the appropriate function.	 For  example,	"passwd"  sup-
       ports  a	 numeric  UID  or user name; "hosts" supports an IPv4 address,
       IPv6 address, or	host name; and "services"  supports  a	service	 name,
       service	name/protocol  name,  numeric  port,  or numeric port/protocol
       name.

       If no key is provided and database supports  enumeration,  all  entries
       for  database will be retrieved using the appropriate enumeration func-
       tion and	printed.

EXIT STATUS
       The getent utility exits	0 on success, 1	if there was an	error  in  the
       command	syntax,	 2  if one of the specified key	names was not found in
       database, or 3 if there is no support for enumeration on	database.

EXAMPLES
       Show entry for user sshd	from the passwd	database:

	     $ getent passwd sshd
	     sshd:*:22:22:Secure Shell Daemon:/var/empty:/usr/sbin/nologin

       Show entry for TCP from the protocols database:

	     $ getent protocols	tcp
	     tcp		   6  TCP

       Show entry for the localhost IPv6 address ::1 from the hosts database:

	     $ getent hosts ::1
	     ::1	       localhost  localhost.my.domain

SEE ALSO
       getutxent(3), ethers(5),	group(5), hosts(5), netgroup(5),  networks(5),
       nsswitch.conf(5),   passwd(5),	protocols(5),	rpc(5),	  services(5),
       shells(5)

HISTORY
       A getent	 command  appeared  in	NetBSD	3.0,  and  was	imported  into
       FreeBSD	7.0.   It was based on the command of the same name in Solaris
       and Linux.

FreeBSD	13.2		       October 24, 2020			     GETENT(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=getent&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help