The cmm_mastership_release() function triggers a
switchover. This function must be called from the master node. If a service
or application attempts to call this function from another node, CMM_EPERM is returned.
If the vice-master node is qualified to be master when cmm_mastership_release() is called, then this node becomes master. The calling node remains
master until the vice-master node has taken the master role.
If no node is qualified to become master when the cmm_mastership_release() function is called, CMM_ECANCELED is
returned.
See the Netra High Availability Suite Foundation Services 2.1 6/03 CMM Programming Guide for information on the notifications returned
in different scenarios.
Any program on the master node can execute this function. No authentication
is performed.