ypmatch(1yp) ypmatch(1yp)
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 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, searches the map for all of the specified keys.
The specified keys must be exact values in terms of capitalization and length. The command does not have a pattern matching capability.
If cannot match a key, it produces a diagnostic message.
The default list of mapnames served by YP is as follows:
Note that the YP server must be running ULTRIX Version 4.2 or higher for the and maps to exist. Also note that the map is accessed with
port numbers, not service names. Use the map to access services by name. The map remains for compatibility. See the Examples section for
sample command lines that illustrate how to access information in each of the maps.
Options
-d Displays key values for specified domain.
-k Displays 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.
-t Inhibits 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 translates it to
ypmatch zippy passwd.byname.
-x Displays map nickname table. This option tells to list the nicknames (mnames) with their associated mapnames.
Examples
The following are sample command lines that illustrate how to use the command to access information in each of the maps:
-------------------------------------------------------------------
Mapname Sample command
-------------------------------------------------------------------
passwd.byname ypmatch user1 passwd.byname
passwd.byuid ypmatch uid1 passwd.byuid
group.byname ypmatch group1 group.byname
group.byuid ypmatch gid1 group.bygid
hosts.byname ypmatch host1 host.byname
hosts.byaddr ypmatch hostaddr1 hosts.byaddr
networks.byname ypmatch network1 networks.byname
networks.byaddr ypmatch netaddr1 networks.byaddr
services.byname_proto ypmatch service1/udp services.byname_proto
services.byport ypmatch servport/tcp service.byport
services.byname ypmatch servport/tcp services.byname
rpc.bynumber ypmatch rpcnum rpc.bynumber
protocols.byname ypmatch proto1 protocols.byname
protocols.bynumber ypmatch protonum1 protocols.bynumber
netgroup.byuser ypmatch user1 netgroup.byuser
netgroup.byhost ypmatch host1 netgroup.byhost
mail.alias ypmatch mailgroup1 mail.alias
-------------------------------------------------------------------
See Also
ypfiles(5yp), ypcat(1yp)
Guide to the Yellow Pages Service
ypmatch(1yp)
