volmgt_root(3X)

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>

char *volmgt_root(void);

DESCRIPTION

volmgt_root() returns the current Volume Management root directory, which by default is /vol but can be configured to be in a different location.

RETURN VALUES

A pointer to a static string containing the root directory for Volume Management is returned.

ERRORS

This routine 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(3X), volmgt_inuse(3X), volmgt_running (3X), attributes(5), volfs(7FS)

NOTES

This routine will return the default root directory location even when Volume Management is not running.

SunOS 5.7  Last Revised 31 Dec 1996

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