UNREGISTERHOST(3N)					    UNREGISTERHOST(3N)

NAME    [Toc]    [Back]

     unregisterhost - remove the existing host entry in	NIS hosts database

SYNOPSIS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111