'\" te
.\"  Copyright 1989 AT&T  Copyright (c) 1997 Sun Microsystems, Inc.  All Rights Reserved.
.TH ypmatch 1 "22 Aug 1997" "SunOS 5.11" "User Commands"
.SH NAME
ypmatch \- print the value of one or more keys from a NIS map
.SH SYNOPSIS
.LP
.nf
\fBypmatch\fR [\fB-k\fR] [\fB-t\fR] [\fB-d\fR \fIdomain\fR] \fIkey\fR [\fIkey\fR]... \fImname\fR
.fi

.LP
.nf
\fBypmatch\fR \fB-x\fR
.fi

.SH DESCRIPTION
.sp
.LP
\fBypmatch\fR prints the values associated with one or more keys from the \fBNIS's\fR name services map specified by \fImname\fR, which may be either a map name or a map nickname.
.sp
.LP
Multiple keys can be specified; all keys will be searched for in the same map. The keys must be the same case and length. No pattern matching is available. If a key is not matched, a diagnostic message is produced.
.SH OPTIONS
.sp
.LP
The following options are supported:
.sp
.ne 2
.mk
.na
\fB\fB-k\fR\fR
.ad
.RS 13n
.rt  
Before printing the value of a key, print the key itself, followed by a colon (\fB:\fR).
.RE

.sp
.ne 2
.mk
.na
\fB\fB-t\fR\fR
.ad
.RS 13n
.rt  
Inhibit map nickname translation.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-d\fR\fI domain\fR\fR
.ad
.RS 13n
.rt  
Specify a domain other than the default domain.
.RE

.sp
.ne 2
.mk
.na
\fB\fB-x\fR\fR
.ad
.RS 13n
.rt  
Display the map nickname table. This lists the nicknames the command knows of, and indicates the map name associated with each nickname.
.RE

.SH OPERANDS
.sp
.LP
The following operand is supported:
.sp
.ne 2
.mk
.na
\fB\fImname\fR\fR
.ad
.RS 9n
.rt  
The \fBNIS's\fR name services map
.RE

.SH EXIT STATUS
.sp
.LP
The following exit values are returned:
.sp
.ne 2
.mk
.na
\fB\fB0\fR\fR
.ad
.RS 5n
.rt  
Successful operation.
.RE

.sp
.ne 2
.mk
.na
\fB\fB1\fR\fR
.ad
.RS 5n
.rt  
An error occurred.
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Availabilitysystem/network/nis
.TE

.SH SEE ALSO
.sp
.LP
\fBypcat\fR(1), \fBypfiles\fR(4), \fBattributes\fR(5)
.SH NOTES
.sp
.LP
\fBypmatch\fR will fail with an \fBRPC\fR error message on yp operation if enough file descriptors are not available. The number of file descriptors should be increased if this occurs.