yppoll(1M)                                                       yppoll(1M)

NAME
     yppoll - query the version of a NIS file

SYNOPSIS
     /usr/sbin/yppoll [-d domain] [-h host] mapname

DESCRIPTION
     This command can be used to obtain information about

     -  the version number of a specific NIS file

     -  the name of the master that manages this NIS file.

     This command is useful if the system administrator wants to make sure
     that the latest version of a NIS file is on a slave, for example.

     The yppoll command uses the ypserv daemon on one of the NIS servers
     and the ypbind daemon on the local host to execute this query. Both
     daemons must be active.

     The yppoll command asks the ypbind daemon of the local host for the
     Internet address and the port number of the appropriate ypserv daemon.
     The yppoll command then fetches the data from this ypserv daemon.

OPTIONS
     -h host
          is specified if you want to output the version number of a NIS
          file that is stored on a specific NIS server. host is the name or
          Internet address of the NIS server.

          The default value is the name of the host that is output when the
          ypwhich command is issued.

     -d domain
          is specified if you want to output the version number of a NIS
          file that does not belong to the current domain. domain is the
          name of the other domain.

          The default value is the name of the domain that is output when
          the domainname(1) command is issued.

     mname
          is the full name of the NIS file for which you want to output the
          version number.

          You will find an overview of the standard NIS files under the
          description of the ypcat(1) command.








Page 1                       Reliant UNIX 5.44                Printed 11/98

yppoll(1M)                                                       yppoll(1M)

EXAMPLES
     You want to compare the version (order) number of the NIS file
     passwd.byname on the master with that of the same file on the NIS
     server providing NIS services to the local host. The ypwhich command
     outputs the name of the NIS server catering to the local host.

     Input:

     yppoll passwd.byname

     Output:

     Domain workshop is supported.
     Map passwd.byname has order number 562326241.
     The master server is boston.

     The yppoll command reports that

     -  the domain workshop is supported,

     -  the version (order) number of the NIS file passwd.byname on the
        next NIS server is 562326241,

     -  the master for the domain workshop is boston.

     Input:

     yppoll -h boston passwd.byname

     Output:

     Domain workshop is supported.
     Map passwd.byname has order number 562326241.
     The master server is boston.

     The version (order) number of the NIS file passwd.byname on the NIS
     server responsible for the local host is the same as on the master.

SEE ALSO
     domainname(1), ypcat(1), ypwhich(1), ypserv(1M), ypfiles(4),
     ypservers(4).













Page 2                       Reliant UNIX 5.44                Printed 11/98