The options to getent are now documented, after being around for nearly
a decade without changes.
Signed-off-by: Robin H. Johnson <robbat2@xxxxxxxxxx>
CC: Nalin Dahyabhai <nalin@xxxxxxxxxx> (original -s {service} option)
CC: Jay Fenlason <fenlason@xxxxxxxxxx> (-s {database}:{service} addition)
CC: Ulrich Drepper <drepper@xxxxxxxxxx> (IDN flags)
---
man1/getent.1 | 22 ++++++++++++++++++++--
1 file changed, 20 insertions(+), 2 deletions(-)
diff --git a/man1/getent.1 b/man1/getent.1
index a15d880..16f2668 100644
--- a/man1/getent.1
+++ b/man1/getent.1
@@ -1,4 +1,5 @@
.\" Copyright (c) 2011, Mark R. Bannister <cambridge@xxxxxxxxxxxxxxxxxxxxx>
+.\" Copyright (c) 2015, Robin H. Johnson <robbat2@xxxxxxxxxx>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
@@ -25,8 +26,7 @@
.SH NAME
getent \- get entries from Name Service Switch libraries
.SH SYNOPSIS
-.B "getent
-.IR database " [" key " ...]"
+.BR getent\ [\fIoption\fP]...\ \fIdatabase\fP\ \fIkey\fP...
.SH DESCRIPTION
The
.B getent
@@ -342,6 +342,24 @@ in succession to
.BR getspnam (3)
and display the result.
.RE
+.SH OPTIONS
+.TP
+.BR \-s\ \fIservice\fP\ \-\-service\ \fIservice\fP
+.\" commit 9d0881aa76b399e6a025c5cf44bebe2ae0efa8af (glibc)
+Override all databases with the specified service. (Since glibc-2.2.5.)
+.TP
+.BR \-s\ \fIdatabase\fP:\fIservice\fP\ \-\-service\ \fIdatabase\fP:\fIservice\fP
+.\" commit b4f6f4be85d32b9c03361c38376e36f08100e3e8 (glibc)
+Override only specified databases with the specified service. The option may be used
+multiple times, but only the last service for each database will be used. (Since glibc-2.4.)
+.TP
+.BR \-i\ \-\-no\-idn
+.\" commit a160f8d808cf8020b13bd0ef4a9eaf3c11f964ad (glibc)
+Disables IDN encoding in lookups for
+.BR ahosts
+/
+.BR getaddrinfo (3)
+(Since glibc-2.13.)
.SH EXIT STATUS
One of the following exit values can be returned by
.BR getent :
--
2.3.0
--
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
