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

Name | Synopsis | Description | Return Values | Errors | Examples | Files | Attributes | See Also | Notes