getent(1): Add EXAMPLES section

Add 3 small examples to the EXAMPLES section.

Approved by:	manpages (gbe@)
Differential Revision:		https://reviews.freebsd.org/D26866
This commit is contained in:
Fernando Apesteguía 2020-10-24 16:40:34 +00:00
parent b19cdab345
commit f7585b288b

View File

@ -29,7 +29,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd June 4, 2016 .Dd October 24, 2020
.Dt GETENT 1 .Dt GETENT 1
.Os .Os
.Sh NAME .Sh NAME
@ -103,6 +103,24 @@ utility exits 0 on success,
.Ar database , .Ar database ,
or 3 if there is no support for enumeration on or 3 if there is no support for enumeration on
.Ar database . .Ar database .
.Sh EXAMPLES
Show entry for user sshd from the passwd database:
.Bd -literal -offset indent
$ getent passwd sshd
sshd:*:22:22:Secure Shell Daemon:/var/empty:/usr/sbin/nologin
.Ed
.Pp
Show entry for TCP from the protocols database:
.Bd -literal -offset indent
$ getent protocols tcp
tcp 6 TCP
.Ed
.Pp
Show entry for the localhost IPv6 address ::1 from the hosts database:
.Bd -literal -offset indent
$ getent hosts ::1
::1 localhost localhost.my.domain
.Ed
.Sh SEE ALSO .Sh SEE ALSO
.Xr getutxent 3 , .Xr getutxent 3 ,
.Xr ethers 5 , .Xr ethers 5 ,
@ -123,7 +141,4 @@ command appeared in
.Nx 3.0 , .Nx 3.0 ,
and was imported into and was imported into
.Fx 7.0 . .Fx 7.0 .
It was based on the command of the same name in It was based on the command of the same name in Solaris and Linux.
.Tn Solaris
and
.Tn Linux .