ypmatch(1) [plan9 man page]
ypmatch(1) User Commands ypmatch(1) NAME
ypmatch - print the value of one or more keys from a NIS map SYNOPSIS
ypmatch [-k] [-t] [-d domain] key [key...] mname ypmatch -x DESCRIPTION
ypmatch prints the values associated with one or more keys from the NIS's name services map specified by mname, which may be either a map name or a map nickname. 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 match- ing is available. If a key is not matched, a diagnostic message is produced. OPTIONS
The following options are supported: -k Before printing the value of a key, print the key itself, followed by a colon (:). -t Inhibit map nickname translation. -d domain Specify a domain other than the default domain. -x Display the map nickname table. This lists the nicknames the command knows of, and indicates the map name associated with each nickname. OPERANDS
The following operand is supported: mname The NIS's name services map EXIT STATUS
The following exit values are returned: 0 Successful operation. 1 An error occurred. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWnisu | +-----------------------------+-----------------------------+ SEE ALSO
ypcat(1), ypfiles(4), attributes(5) NOTES
ypmatch will fail with an RPC error message on yp operation if enough file descriptors are not available. The number of file descriptors should be increased if this occurs. SunOS 5.10 22 Aug 1997 ypmatch(1)
Check Out this Related Man Page
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)