Name

ypmatch − print the value of one or more keys from a yp map

Syntax

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

Description

The ypmatch command prints the values associated with one or more keys from the yellow pages (YP) map (database) specified by a 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 YP is as follows: passwd.byname, passwd.byuid, group.byname, group.byuid, hosts.byname, hosts.byaddr, networks.byname, networks.byaddr, services.byname_proto, services.byport, services.byname, rpc.bynumber, protocols.byname, protocols.bynumber, netgroup.byuser, netgroup.byhost, mail.alias.

Note that the YP server must be running ULTRIX Version 4.2 or higher for the services.byname_proto and services.byport maps to exist.  Also note that the services.byname map is accessed with port numbers, not service names.  Use the service.byname_proto map to access services by name.  The services.byname map remains for compatibility.  See the Examples section for sample command lines that illustrate how to access information in each of the maps.

Options

−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:

See Also

ypfiles(5yp), ypcat(1yp)
Guide to the Yellow Pages Service