ypcat(1)                                                 ypcat(1)



NAME
     ypcat - lists the contents of a Network Information  Service
     (NIS) map

SYNOPSIS
     ypcat [-d domain-name] [-k] [-t] map-or-nick-name

     ypcat -x

ARGUMENTS
     -d domain-name
          Specifies a domain other than the local system's domain
          as returned by the domainname command.

     -k   Displays each key and its corresponding value.

     -t   Inhibits the translation of a nickname to a map name.
          For example, ypcat -t passwd fails because there is no
          map named passwd, whereas the passwd in ypcat passwd is
          translated to ypcat passwd.byname.

     -x   Displays the map nickname table. The table lists the
          nicknames the command knows of and indicates the long
          map name associated with each nickname.

DESCRIPTION
     ypcat lists the contents of the NIS map specified by
     map-or-nick-name, which may be either the name of a map or a
     map's ``nickname.''  The ypcat command uses the NIS service
     to determine the server from which to get the map.

     The most common use of NIS is to provide lookup service for
     administrative files such as the /etc/passwd file. When a
     system is managed by NIS, each system on the network has a
     local /etc/passwd file that contains required administrative
     entries.  The master server maintains a global password file
     containing a login entry for each user of a system on the
     network. The global password file is used to generate a file
     that in NIS terminology is called a map. The NIS subsystem
     uses the map to provide information when commands, running
     on an NIS client, request NIS service.

     The information in maps is sorted in a variety of ways. For
     example, one of the password maps is passwd.byname in which
     the entries are sorted by login name.

     The map name passwd.byname is an example of a long map name.
     To accommodate the System V file system, which limits names
     to 14 characters, the A/UX(Reg.) implementation of NIS uses
     short map names and translates any long map names into short
     map names. In addition to long map names and short map
     names, the most commonly used maps have nicknames.  Here is



January 1992                                                    1

ypcat(1)                                                 ypcat(1)



     a list of nicknames, long map names, short map names, and
     the source files they correspond to:

        Nickname           Long map nameShort map nameSource file
        aliases            mail.aliasesm.a/usr/lib/aliases
        ethers ethers.byname         e.nm/etc/ethers
        group  group.byname          grp.nm/etc/group
        hosts  hosts.byaddr          hst.ad/etc/hosts
        passwd passwd.byname         pwd.nm/etc/passwd
        protocols          protocols.bynumberptc.nr/etc/protocols
               netgroup    netg      /etc/netgroup
        networks           networks.byaddrntw.ad/etc/networks
        services           services.bynamesvc.nm/etc/services

     Refer to ypfiles(4) and ypserv(1M) for an overview of NIS.

EXAMPLES
     To see the contents of the global password file, enter:

        ypcat passwd


FILES
     /usr/bin/ypcat
          Executable file
SEE ALSO
     domainname(1), ypmatch(1)

     ypserv(1M) in A/UX System Administrator's Reference

     ypfiles(4) in A/UX Programmer's Reference

     Chapter 4, ``Setting Up the Network Information Service,''
     in A/UX Network System Administration





















2                                                    January 1992