volmgt_root(3VOLMGT)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | EXAMPLES | FILES | ATTRIBUTES | SEE ALSO | NOTES

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\n", path);
} else {
        (void) printf("can't find Volume Management root dir\n");
}

---

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.9  Last Revised 1 Feb 2001

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | EXAMPLES | FILES | ATTRIBUTES | SEE ALSO | NOTES