From patchwork Fri Apr 17 06:53:04 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Robin H. Johnson" X-Patchwork-Id: 461934 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id AB0191402B5 for ; Fri, 17 Apr 2015 16:53:54 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=pass reason="1024-bit key; unprotected key" header.d=sourceware.org header.i=@sourceware.org header.b=yQDFUNEy; dkim-adsp=none (unprotected policy); dkim-atps=neutral DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:cc:subject:date:message-id; q=dns; s= default; b=aGth4lTOySdFM5mHsbwQvYYNhWxNd0XB0yUN81VmYRig79rEQ4yur uVIj2LIlJ3kFUuao67e4wx5SSEdHIl8xlbWN0Fyio8gmaiDHYy0tbNWNClf7sX7d WLWBgmoP3vY21oU7B1qAOzC6ropw4emrCqiXoRxwWTUo83TLyCnhT0= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:cc:subject:date:message-id; s=default; bh=Y59sL0RKyqcPpR0Qu3aNqYXeUeg=; b=yQDFUNEyaBmQf0HABGzABsB5JiPY IJtxcUm+nLi698/4yAvsWPOI795vGGpvcHKbFnkP/zxMMEYsMysIcNfOrGBRa4CD PxRVhLrxRcFQP1DngTmvVoxmRzvoYKlcz4hfXklVbOYxDoy18E4qfhKwpn22kXxN ISDtb+pvnukiZSY= Received: (qmail 117619 invoked by alias); 17 Apr 2015 06:53:48 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Delivered-To: mailing list libc-alpha@sourceware.org Received: (qmail 117606 invoked by uid 89); 17 Apr 2015 06:53:46 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=1.8 required=5.0 tests=BAYES_50, KAM_LAZY_DOMAIN_SECURITY autolearn=no version=3.3.2 X-HELO: smtp.gentoo.org X-Spam-Check-By: orbis-terrarum.net From: "Robin H. Johnson" To: mtk.manpages@gmail.com Cc: linux-man@vger.kernel.org, libc-alpha@sourceware.org, "Robin H. Johnson" , Nalin Dahyabhai , Jay Fenlason , Ulrich Drepper Subject: [PATCH] getent.1: Document options. Date: Thu, 16 Apr 2015 23:53:04 -0700 Message-Id: <1429253584-14733-1-git-send-email-robbat2@gentoo.org> The options to getent are now documented, after being around for nearly a decade without changes. Signed-off-by: Robin H. Johnson CC: Nalin Dahyabhai (original -s {service} option) CC: Jay Fenlason (-s {database}:{service} addition) CC: Ulrich Drepper (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 +.\" Copyright (c) 2015, Robin H. Johnson .\" .\" %%%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 :