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)