opensolaris man page for volmgt_running

volmgt_running(3VOLMGT) 				Volume Management Library Functions				   volmgt_running(3VOLMGT)

NAME
       volmgt_running - return whether or not volume management is running

SYNOPSIS
       cc [ flag ... ] file ... -lvolmgt [ library ... ]
       #include <volmgt.h>

       int volmgt_running(void);

DESCRIPTION
       This  function  is obsolete. The management of removable media by the Volume Management feature, including vold, has been replaced by soft-
       ware that supports the Hardware Abstraction Layer (HAL). Programmatic support for HAL is through the HAL APIs, which are documented on  the
       HAL web site. See hal(5).

       volmgt_running() tells whether or not Volume Management is running.

RETURN VALUES
       volmgt_running() always returns 0 indicating Volume Management (as implemented by vold) is not running.

ERRORS
       volmgt_running() will fail, returning 0, if a stat(2) or open(2) of /dev/volctl fails, or if any of the following is true:

       ENXIO	Volume Management is not running.

       EINTR	An interrupt signal was detected while checking to see if Volume Management was running.

EXAMPLES
       Example 1 Using volmgt_running()

       To see if Volume Management is running:

	 if (volmgt_running() != 0) {
		 (void) printf("Volume Management is running
");
	 } else {
		 (void) printf("Volume Management is NOT running
");
	 }

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Obsolete			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       cc(1B), open(2), stat(2), volmgt_check(3VOLMGT), volmgt_inuse(3VOLMGT), attributes(5), hal(5)

NOTES
       Volume Management must be running for many of the Volume Management library routines to work.

SunOS 5.11							    8 Mar 2007						   volmgt_running(3VOLMGT)