]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man1/getent.1
prctl.2: Fix alphabetical misplacements in ERRORS
[thirdparty/man-pages.git] / man1 / getent.1
index a421d736669c9a79e2aa175656b1ef68d8e0cf19..a1a49fd46e46722ff2c3815ab8c16e97f5917324 100644 (file)
@@ -1,5 +1,7 @@
 .\" Copyright (c) 2011, Mark R. Bannister <cambridge@users.sourceforge.net>
+.\" Copyright (c) 2015, Robin H. Johnson <robbat2@gentoo.org>
 .\"
+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END
 .\"
-.TH GETENT 1 2011-10-31 "Linux" "User Commands"
+.TH GETENT 1 2015-04-19 "Linux" "User Commands"
 .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
@@ -214,7 +215,7 @@ and
 to match to a netgroup name via
 .BR innetgr (3).
 Enumeration is not supported on
-.BR initgroups ,
+.BR netgroup ,
 so either one or three
 .I keys
 must be provided.
@@ -341,7 +342,37 @@ in succession to
 .BR getspnam (3)
 and display the result.
 .RE
-.SH "EXIT STATUS"
+.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 / getaddrinfo (3)
+(Since glibc-2.13.)
+.TP
+.BR \-? ", " \-\-help
+Print a usage summary and exit.
+.TP
+.B "\-\-usage"
+Print a short usage summary and exit.
+.TP
+.BR \-V ", " \-\-version
+Print the version number, license, and disclaimer of warranty for
+.BR getent .
+.SH EXIT STATUS
 One of the following exit values can be returned by
 .BR getent :
 .RS 3
@@ -364,5 +395,5 @@ could not be found in the
 Enumeration not supported on this
 .IR database .
 .RE
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR nsswitch.conf (5)