summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFernando ApesteguĂ­a <fernape@FreeBSD.org>2020-10-24 16:40:34 +0000
committerFernando ApesteguĂ­a <fernape@FreeBSD.org>2020-10-24 16:40:34 +0000
commit50f469b65ac695416519ddc46cf71066cfcd6c1b (patch)
treea5e9e13855e9de03936d8cd8956fd62ea757fcc2
parentc055bf56d2b45d442a006bab43939cb1b2d7c0dd (diff)
downloadgetent-darwin-50f469b65ac695416519ddc46cf71066cfcd6c1b.tar.gz
getent-darwin-50f469b65ac695416519ddc46cf71066cfcd6c1b.tar.zst
getent-darwin-50f469b65ac695416519ddc46cf71066cfcd6c1b.zip
getent(1): Add EXAMPLES section
Add 3 small examples to the EXAMPLES section. Approved by: manpages (gbe@) Differential Revision: https://reviews.freebsd.org/D26866
-rw-r--r--getent.125
1 files 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.