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(1) General Commands Manual ypmatch(1)NAME
ypmatch - print the value of one or more keys from an NIS map
SYNOPSIS
ypmatch [-d domain] [-k] [-t] key... mname
ypmatch -x
OPTIONS
Displays key values for specified domain. 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. 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 ypmatch translates it to ypmatch zippy passwd.byname. Displays map nickname table. This option tells ypmatch to
list the nicknames (mnames) with their associated mapnames.
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 speci-
fied 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, net-
group.byhost, mail.alias.
EXAMPLES
The following are sample command lines that illustrate how to use the ypmatch 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 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(4), ypcat(1)
Network Administration
ypmatch(1)