ypcat(1)                                                 ypcat(1)



     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
               networks    networks.byaddr     /etc/networks
               services    services.byname     /etc/services
               protocols   protocols.bynumber  /etc/protocols
               netgroup    netgroup            /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



     Page 1                                        (last mod. 1/16/87)

     ypcat(1)                                                 ypcat(1)



               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
               flag 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(1).  The
               default domain is the one that is interesting to most
               users.

     FILES
          /usr/bin/ypacat

     SEE ALSO
          ypfiles(1M), yppush(1M), yppasswd(1M).
          ``Installing the Yellow Pages'' in Oreo Network System
          Administration.































     Page 2                                        (last mod. 1/16/87)