For completeness, here was the patch I applied.
Cheers,
Michael
--- a/man1/getent.1
+++ b/man1/getent.1
@@ -26,13 +26,16 @@ getent \- get entries from Name Service Switch libraries
.SH SYNOPSIS
.BI "getent " database " [ " key " ... ]"
.SH DESCRIPTION
-Displays entries from databases supported by the Name Service Switch libraries,
+The
+.I getent
+command displays entries from databases supported by the
+Name Service Switch libraries,
which are configured in
.IR /etc/nsswitch.conf .
If one or more
.I key
-is provided, then only the entries that match the supplied keys will be
-displayed.
+arguments are provided,
+then only the entries that match the supplied keys will be displayed.
Otherwise, if no
.I key
is provided, all entries will be displayed (unless the database does not
@@ -40,15 +43,15 @@ support enumeration).
.LP
The
.I database
-may be any supported by the GNU C Library, listed below:
+may be any of those supported by the GNU C Library, listed below:
.RS 3
.TP 10
.B ahosts
When no
.I key
-is provided, uses
+is provided, use
.BR sethostent (3),
-.BR gethostent (3)
+.BR gethostent (3),
and
.BR endhostent (3)
to enumerate the hosts database.
@@ -56,7 +59,7 @@ This is identical to using
.BR hosts .
When one or more
.I key
-is provided, passes each
+arguments are provided, pass each
.I key
in succession to
.BR getaddrinfo (3)
@@ -66,14 +69,14 @@ enumerating each socket address structure returned.
.TP
.B ahostsv4
Same as
-.B ahosts
-except for the address family
+.BR ahosts ,
+but use the address family
.BR AF_INET .
.TP
.B ahostsv6
Same as
-.B ahosts
-except for the address family
+.BR ahosts ,
+but use the address family
.BR AF_INET6 .
The call to
.BR getaddrinfo (3)
@@ -84,30 +87,30 @@ flag.
.B aliases
When no
.I key
-is provided, uses
+is provided, use
.BR setaliasent (3),
-.BR getaliasent (3)
+.BR getaliasent (3),
and
.BR endaliasent (3)
to enumerate the aliases database.
When one or more
.I key
-is provided, passes each
+arguments are provided, pass each
.I key
in succession to
.BR getaliasbyname (3)
-and displays the result.
+and display the result.
.TP
.B ethers
When one or more
.I key
-is provided, passes each
+arguments are provided, pass each
.I key
in succession to
.BR ether_aton (3)
and
.BR ether_hostton (3)
-until a result is obtained, and displays the result.
+until a result is obtained, and display the result.
Enumeration is not supported on
.BR ethers ,
so a
@@ -117,53 +120,53 @@ must be provided.
.B group
When no
.I key
-is provided, uses
+is provided, use
.BR setgrent (3),
-.BR getgrent (3)
+.BR getgrent (3),
and
.BR endgrent (3)
to enumerate the group database.
When one or more
.I key
-is provided, passes each numeric
+arguments are provided, pass each numeric
.I key
to
.BR getgrgid (3)
-and each non-numeric
+and each nonnumeric
.I key
to
.BR getgrnam (3)
-and displays the result.
+and display the result.
.TP
.B gshadow
When no
.I key
-is provided, uses
+is provided, use
.BR setsgent (3),
-.BR getsgent (3)
+.BR getsgent (3),
and
.BR endsgent (3)
to enumerate the gshadow database.
When one or more
.I key
-is provided, passes each
+arguments are provided, pass each
.I key
in succession to
.BR getsgnam (3)
-and displays the result.
+and display the result.
.TP
.B hosts
When no
.I key
-is provided, uses
+is provided, use
.BR sethostent (3),
-.BR gethostent (3)
+.BR gethostent (3),
and
.BR endhostent (3)
to enumerate the hosts database.
When one or more
.I key
-is provided, passes each
+arguments are provided, pass each
.I key
to
.BR gethostbyaddr (3)
@@ -173,16 +176,16 @@ depending on whether a call to
.BR inet_pton (3)
indicates that the
.I key
-is an IPv6 or IPv4 address or not, and displays the result.
+is an IPv6 or IPv4 address or not, and display the result.
.TP
.B initgroups
When one or more
.I key
-is provided, passes each
+arguments are provided, pass each
.I key
in succession to
.BR getgrouplist (3)
-and displays the result.
+and display the result.
Enumeration is not supported on
.BR initgroups ,
so a
@@ -192,13 +195,13 @@ must be provided.
.B netgroup
When one
.I key
-is provided, passes the
+is provided, pass the
.I key
to
.BR setnetgrent (3)
and, using
.BR getnetgrent (3)
-displays the resulting string triple
+display the resulting string triple
.RI ( hostname ", " username ", " domainname ).
Alternatively, three
.I keys
@@ -218,124 +221,124 @@ must be provided.
.B networks
When no
.I key
-is provided, uses
+is provided, use
.BR setnetent (3),
-.BR getnetent (3)
+.BR getnetent (3),
and
.BR endnetent (3)
to enumerate the networks database.
When one or more
.I key
-is provided, passes each numeric
+arguments are provided, pass each numeric
.I key
to
.BR getnetbyaddr (3)
-and each non-numeric
+and each nonnumeric
.I key
to
.BR getnetbyname (3)
-and displays the result.
+and display the result.
.TP
.B passwd
When no
.I key
-is provided, uses
+is provided, use
.BR setpwent (3),
-.BR getpwent (3)
+.BR getpwent (3),
and
.BR endpwent (3)
to enumerate the passwd database.
When one or more
.I key
-is provided, passes each numeric
+arguments are provided, pass each numeric
.I key
to
.BR getpwuid (3)
-and each non-numeric
+and each nonnumeric
.I key
to
.BR getpwnam (3)
-and displays the result.
+and display the result.
.TP
.B protocols
When no
.I key
-is provided, uses
+is provided, use
.BR setprotoent (3),
-.BR getprotoent (3)
+.BR getprotoent (3),
and
.BR endprotoent (3)
to enumerate the protocols database.
When one or more
.I key
-is provided, passes each numeric
+arguments are provided, pass each numeric
.I key
to
.BR getprotobynumber (3)
-and each non-numeric
+and each nonnumeric
.I key
to
.BR getprotobyname (3)
-and displays the result.
+and display the result.
.TP
.B rpc
When no
.I key
-is provided, uses
+is provided, use
.BR setrpcent (3),
-.BR getrpcent (3)
+.BR getrpcent (3),
and
.BR endrpcent (3)
to enumerate the rpc database.
When one or more
.I key
-is provided, passes each numeric
+arguments are provided, pass each numeric
.I key
to
.BR getrpcbynumber (3)
-and each non-numeric
+and each nonnumeric
.I key
to
.BR getrpcbyname (3)
-and displays the result.
+and display the result.
.TP
.B services
When no
.I key
-is provided, uses
+is provided, use
.BR setservent (3),
-.BR getservent (3)
+.BR getservent (3),
and
.BR endservent (3)
to enumerate the services database.
When one or more
.I key
-is provided, passes each numeric
+arguments are provided, pass each numeric
.I key
to
.BR getservbynumber (3)
-and each non-numeric
+and each nonnumeric
.I key
to
.BR getservbyname (3)
-and displays the result.
+and display the result.
.TP
.B shadow
When no
.I key
-is provided, uses
+is provided, use
.BR setspent (3),
-.BR getspent (3)
+.BR getspent (3),
and
.BR endspent (3)
to enumerate the shadow database.
When one or more
.I key
-is provided, passes each
+arguments are provided, pass each
.I key
in succession to
.BR getspnam (3)
-and displays the result.
+and display the result.
.RE
.SH "EXIT STATUS"
One of the following exit values can be returned by
@@ -361,4 +364,4 @@ Enumeration not supported on this
.IR database .
.RE
.SH "SEE ALSO"
-.BR nsswitch.conf (5).
+.BR nsswitch.conf (5)
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
[Netdev]
[Linux Ethernet Bridging]
[Linux Wireless]
[Kernel Newbies]
[Memory]
[Security]
[Linux for Hams]
[Netfilter]
[Bugtraq]
[Photo]
[Yosemite]
[Yosemite News]
[MIPS Linux]
[ARM Linux]
[Linux RAID]
[Linux Admin]
[Samba]
[Video 4 Linux]
[Linux Resources]
