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)