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)