unregisterhost(3N)

NAME
     unregisterhost - remove the existing host entry in NIS hosts database

SYNOPSIS
     int unregisterhost(char *name, char *passwd);

DESCRIPTION
     Unregisterhost sends an host name unregister request to registrar(1M) on
     NIS master via the yp_update(3R) call.  After successfully completed, the
     host name will no longer be in the NIS hosts database and its Internet
     address is freed.  This routine should be used only when NIS is enabled
     in the network.

     The arguments for the routine are:

          name The host name of the entry to be deleted.

          passwd
               The root password of NIS master. If the NIS master does not
               have root password, simply pass a NULL.

     Unregisterhost returns NULL when successfully completed.  All error codes
     are defined in <rpcsvc/ypclnt.h>.

     Unregisterhost always wait until NIS databases are pushed to all slave
     servers.

SEE ALSO
     registrar(1M), yp_update(1M), registerinethost(3N), renamehost(3N),
     yppush(1M)