NAME

ypmatch − print the value of one or more keys from an NIS map

SYNOPSIS

ypmatch [−d domain] [−k] [−t] key... mname
ypmatch −x

DESCRIPTION

The ypmatch command prints the values associated with one or more keys from the Network Information Service (NIS) map (database) specified by mname, which may be either a mapname or a map nickname.

Multiple keys can be specified.  After the key values and the map name have been specified, ypmatch searches the map for all of the specified keys.  The specified keys must be exact values in terms of capitalization and length.  The ypmatch command does not have a pattern matching capability.  If ypmatch cannot match a key, it produces a diagnostic message. 

The default list of mapnames served by NIS is as follows: passwd.byname, passwd.byuid, group.byname, group.byuid, hosts.byname, hosts.byaddr, networks.byname, networks.byaddr, services.byname, rpc.bynumber, protocols.byname, protocols.bynumber, netgroup.byuser, netgroup.byhost, mail.alias. 

FLAGS

−dDisplays key values for specified domain.

−kDisplays key, followed by a colon (:), before displaying value of the key.  This is useful if the keys are not duplicated in the returned values, or if the number of specified keys is so large that the output is confusing. 

−tInhibits translation of nickname to mapname.  For example,

ypmatch −t zippy passwd

fails because there is no map named passwd, while

ypmatch zippy passwd

succeeds because ypmatch translates it to

ypmatch zippy passwd.byname.

−xDisplays map nickname table.  This option tells ypmatch to list the nicknames (mnames) with their associated mapnames.

EXAMPLES

The following are sample command lines that illustrate how to use the ypmatch command to access information in each of the maps:

RELATED INFORMATION

ypfiles(4), ypcat(1)
Network Administration and Problem Solving