volmgt_root(3VOLMGT) Volume Management Library Functions volmgt_root(3VOLMGT)NAMEvolmgt_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 contain‐
ing 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\n", path);
} else {
(void) printf("can't find Volume Management root dir\n");
}
FILES
/vol default location for the Volume Management root direc‐
tory
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOcc(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)