[Go to CFHT Home Page] Man Pages
Back to Software Index  BORDER=0Manpage Top Level
    volmgt_root(3X) manual page Table of Contents

Name

volmgt_root - return the Volume Management root directory

Synopsis

cc [ flag... ] file ... -lvolmgt [ library.... ]

#include <volmgt.h>

char *volmgt_root(void);

MT-Level

MT-Safe

Description

volmgt_root() returns the current Volume Management root directory, which by default is /vol but can be configured to be in a different location.

Return Values

A pointer to a static string containing the root directory for Volume Management is returned.

Errors

This routine may fail if an open() of /dev/volctl fails. If this occurs a pointer to the default Volume Management root directory is returned.

Examples

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

See Also

cc(1B) , vold(1M) , open(2) , volmgt_check(3X) , volmgt_inuse(3X) , volmgt_running(3X) , volfs(7FS)

Notes

This routine will return the default root directory location even when Volume Management is not running.


Table of Contents