From 50f469b65ac695416519ddc46cf71066cfcd6c1b Mon Sep 17 00:00:00 2001
From: Fernando Apesteguía <fernape@FreeBSD.org>
Date: Sat, 24 Oct 2020 16:40:34 +0000
Subject: getent(1): Add EXAMPLES section

Add 3 small examples to the EXAMPLES section.

Approved by:	manpages (gbe@)
Differential Revision:		https://reviews.freebsd.org/D26866
---
 getent.1 | 25 ++++++++++++++++++++-----
 1 file changed, 20 insertions(+), 5 deletions(-)

diff --git a/getent.1 b/getent.1
index a77a180..5ecf3b8 100644
--- a/getent.1
+++ b/getent.1
@@ -29,7 +29,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 4, 2016
+.Dd October 24, 2020
 .Dt GETENT 1
 .Os
 .Sh NAME
@@ -103,6 +103,24 @@ utility exits 0 on success,
 .Ar database ,
 or 3 if there is no support for enumeration on
 .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
 .Xr getutxent 3 ,
 .Xr ethers 5 ,
@@ -123,7 +141,4 @@ command appeared in
 .Nx 3.0 ,
 and was imported into
 .Fx 7.0 .
-It was based on the command of the same name in
-.Tn Solaris
-and
-.Tn Linux .
+It was based on the command of the same name in Solaris and Linux.
-- 
cgit v1.2.3-56-ge451