usr/src/man/man1/ypmatch.1

   1 '\" te
   2 .\"  Copyright 1989 AT&T  Copyright (c) 1997 Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH YPMATCH 1 "Aug 22, 1997"
   7 .SH NAME
   8 ypmatch \- print the value of one or more keys from a NIS map
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 \fBypmatch\fR [\fB-k\fR] [\fB-t\fR] [\fB-d\fR \fIdomain\fR] \fIkey\fR [\fIkey\fR]... \fImname\fR
  13 .fi
  14
  15 .LP
  16 .nf
  17 \fBypmatch\fR \fB-x\fR
  18 .fi
  19
  20 .SH DESCRIPTION
  21 .sp
  22 .LP
  23 \fBypmatch\fR prints the values associated with one or more keys from the
  24 \fBNIS's\fR name services map specified by \fImname\fR, which may be either a
  25 map name or a map nickname.
  26 .sp
  27 .LP
  28 Multiple keys can be specified; all keys will be searched for in the same map.
  29 The keys must be the same case and length. No pattern matching is available. If
  30 a key is not matched, a diagnostic message is produced.
  31 .SH OPTIONS
  32 .sp
  33 .LP
  34 The following options are supported:
  35 .sp
  36 .ne 2
  37 .na
  38 \fB\fB-k\fR\fR
  39 .ad
  40 .RS 13n
  41 Before printing the value of a key, print the key itself, followed by a colon
  42 (\fB:\fR).
  43 .RE
  44
  45 .sp
  46 .ne 2
  47 .na
  48 \fB\fB-t\fR\fR
  49 .ad
  50 .RS 13n
  51 Inhibit map nickname translation.
  52 .RE
  53
  54 .sp
  55 .ne 2
  56 .na
  57 \fB\fB-d\fR\fI domain\fR\fR
  58 .ad
  59 .RS 13n
  60 Specify a domain other than the default domain.
  61 .RE
  62
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fB-x\fR\fR
  67 .ad
  68 .RS 13n
  69 Display the map nickname table. This lists the nicknames the command knows of,
  70 and indicates the map name associated with each nickname.
  71 .RE
  72
  73 .SH OPERANDS
  74 .sp
  75 .LP
  76 The following operand is supported:
  77 .sp
  78 .ne 2
  79 .na
  80 \fB\fImname\fR\fR
  81 .ad
  82 .RS 9n
  83 The \fBNIS's\fR name services map
  84 .RE
  85
  86 .SH EXIT STATUS
  87 .sp
  88 .LP
  89 The following exit values are returned:
  90 .sp
  91 .ne 2
  92 .na
  93 \fB\fB0\fR\fR
  94 .ad
  95 .RS 5n
  96 Successful operation.
  97 .RE
  98
  99 .sp
 100 .ne 2
 101 .na
 102 \fB\fB1\fR\fR
 103 .ad
 104 .RS 5n
 105 An error occurred.
 106 .RE
 107
 108 .SH SEE ALSO
 109 .sp
 110 .LP
 111 \fBypcat\fR(1), \fBypfiles\fR(4), \fBattributes\fR(5)
 112 .SH NOTES
 113 .sp
 114 .LP
 115 \fBypmatch\fR will fail with an \fBRPC\fR error message on yp operation if
 116 enough file descriptors are not available. The number of file descriptors
 117 should be increased if this occurs.