sunos man page for volmgt_root

Query: volmgt_root

OS: sunos

Section: 3volmgt

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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)
Related Man Pages
media_findname(3volmgt) - sunos
volmgt_symname(3volmgt) - sunos
volmgt_check(3volmgt) - opensolaris
volmgt_inuse(3volmgt) - opensolaris
volmgt_running(3volmgt) - opensolaris
Similar Topics in the Unix Linux Community
Root User Management
Location of File
Finding latest dir based on it's name (yyyymmdd)
Benefit of Kernel
Stop root from writing to directory