VRRP Library Functions	 			vrrp_startup(3VRRP)



NAME
     vrrp_startup, vrrp_shutdown - send a STARTUP or SHUTDOWN event
        to a VRRP instance

SYNOPSIS
     cc	[ flag ... ] file ... -lvrrp [ library ... ]
     #include <libvrrp.h>

     vrrp_ret_t vrrp_startup(const char *name);

     vrrp_ret_t vrrp_shutdown(const char *name);


DESCRIPTION
     The vrrp_startup() and vrrp_shutdown() functions send a a STARTUP
     or SHUTDOWN event to a VRRP instance, respectively.

     On receiving the STARTUP event, the VRRP instance, if in the
     INITIALIZE state, will leave the INITIALIZE state and eventually
     enter either BACKUP or MASTER state. On receiving the SHUTDOWN
     event, the VRRP instance, if in BACKUP or MASTER state, will
     enter the INITIALIZE state, which is actually a "paused" state.
     
     The argument name can be set to NULL, to send event to all VRRP
     instances in the system. If the specified instance does not exist,
     the function fails with VRRP_ENOINST.

     This function requires the PRIV_SYS_NET_CONFIG and PRIV_NET_RAWACCESS
     privileges. If the caller doesn't have enough privileges, the attempt
     fails with VRRP_ENOPERM.


RETURN VALUES
     Upon success, VRRP_SUCCESS is returned. If VRRP_ESYS is
     returned,	errno  contains	 the  specific	UNIX system error
     value. Otherwise, a VRRP error value defined in <libvrrp.h>
     or	listed in the following	section	is returned.

ERRORS
     VRRP_ENOINST	    VRRP instance does not exist

     VRRP_ENOPERM	    Insufficient privilege


ATTRIBUTES
     See attributes(5) for description of  the	following  attri-
     butes:

     ____________________________________________________________
    |	    ATTRIBUTE TYPE	  |	  ATTRIBUTE VALUE	|
    |_____________________________|_____________________________|
    | Interface	Stability	  | Project Private		|
    |_____________________________|_____________________________|
    | MT-Level			  | Safe			|
    |_____________________________|_____________________________|


SEE ALSO
     libvrrp(3LIB), vrrpadm(1M), vrrpd(1M)