Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ volmgt_root(3X) — SunOS 5.6

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

cc(1B)

vold(1M)

open(2)

volmgt_check(3X)

volmgt_inuse(3X)

volmgt_running(3X)

attributes(5)

volfs(7FS)

volmgt_root(3X)

NAME

volmgt_root − return the Volume Management root directory

SYNOPSIS

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

#include <volmgt.h>

char ∗volmgt_root(void);

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

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(3X), volmgt_inuse(3X), volmgt_running(3X), attributes(5), volfs(7FS)

NOTES

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

SunOS 5.6  —  Last change: 31 Dec 1996

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026