volmgt_root(3VOLMGT) Volume Management Library Functions volmgt_root(3VOLMGT)
NAME
volmgt_root - return the Volume Management root directory
SYNOPSIS
cc [ flag ... ] file ... -lvolmgt [ library ... ]
#include <volmgt.h>
const char *volmgt_root(void);
DESCRIPTION
The volmgt_root() function returns the current Volume Management root directory, which by default is /vol but can be configured to be in a
different location.
RETURN VALUES
The volmgt_root() function returns pointer to a static string containing the root directory for Volume Management.
ERRORS
This function may fail if an open() of /dev/volctl fails. If this occurs a pointer to the default Volume Management root directory is
returned.
EXAMPLES
Example 1: Finding the Volume Management root directory.
To find out where the Volume Management root directory is:
if ((path = volmgt_root()) != NULL) {
(void) printf("Volume Management root dir=%s
", path);
} else {
(void) printf("can't find Volume Management root dir
");
}
FILES
/vol default location for the Volume Management root directory
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO
cc(1B), vold(1M), open(2), volmgt_check(3VOLMGT), volmgt_inuse(3VOLMGT), volmgt_running(3VOLMGT), attributes(5), volfs(7FS)
NOTES
This function returns the default root directory location even when Volume Management is not running.
SunOS 5.10 1 Feb 2001 volmgt_root(3VOLMGT)