Content-type: text/html Man page of volmgt_root

volmgt_root

Section: Volume Management Library Functions (3VOLMGT)
Updated: 1 Feb 2001
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
MT-LevelMT-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.


 

Index

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

This document was created by man2html, using the manual pages.
Time: 02:38:46 GMT, October 02, 2010