NAME

ypcat - print values in a YP data base

SYNOPSIS

ypcat [ −a ] [ −k ] [ −t ] [ −d domainname ]  keyword

DESCRIPTION

Ypcat prints out values in a yellow pages (YP) map specified by a keyword, which may be either a mapname or an abbreviated mapname.  Since ypcat employs YP network services, the location of the YP server cannot be supplied. 

Suppose you want to look at the system password file.  Each machine has a file /etc/passwd, containing only a small amount of information. The network-wide password database is served by the YP, and holds information in a map named passwd.byname, whose abbreviated name is passwd. Thus, to see the system passwords, you type:

ypcat passwd

Here is a list of abbreviated mapnames, full mapnames, and corresponding system files:

passwd  passwd.byname   /etc/passwd
group   group.byname    /etc/group
hosts   hosts.byaddr    /etc/hosts
networksnetworks.byaddr /etc/networks
servicesservices.byname /etc/services
protocolsprotocols.bynumber/etc/protocols
netgroupnetgroup        /etc/netgroup

A list of all maps in the default domain can be seen by typing:

ypcat -k ypmaps

A list of all the known domains can be seen by typing:

ypcat -d yp_private -k ypdomains

OPTIONS

−a Get all the key_value pairs back from the YP, including private symbols.  These are uninteresting to almost everyone. 

−k Dump the keys, as well as the values.  Keys are already within the values for maps interesting to most users.  Here again, the extra information you get back is generally uninteresting.  Exceptions are those maps in which the value is null (that is, all of the information in the map is in the keys), or maps in which the key is not part of the value.  None of the maps derived from files that have an ASCII version in /etc fall into those classes. 

−t Inhibit translation of abbreviated mapname to mapname.  For example, ypcat −t passwd will fail because there is no file named passwd, while ypcat passwd will be translated to ypcat passwd.byname. The purpose of this option is to let you specify a mapname which is also a keyword name.

−d Used to specify a domain other that the default domain.  The default domain is returned by domainname(8). The default domain is the one that is interesting to most users.

SEE ALSO

ypfiles(8), yppush(8), newpasswd(8)

Sun Release 2.0  —  Last change: 1 February 1985