sunos man page for volmgt_root

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)