volmgt_ownspath(3VOLMGT)

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUES | EXAMPLES | ATTRIBUTES | SEE ALSO

NAME

volmgt_ownspath– check Volume Management name space for path

SYNOPSIS

cc [[flag]]… file… -lvolgmt [[library]]…
#include <volmgt.h>

int volmgt_ownspath(char *path);

PARAMETERS

path

A string containing the path.

DESCRIPTION

The volmgt_ownspath() function checks to see if a given path is contained in the Volume Management name space. This is achieved by comparing the beginning of the supplied path name with the output from volmgt_root(3VOLMGT)

RETURN VALUES

The volgmt_ownspath() function returns a non-zero value if path is owned by Volume Management. It returns 0 if path is not in its name space or Volume Management is not running.

EXAMPLES

---

Example 1 Using volmgt_ownspath()




The following example first checks if Volume Management is running, then checks the Volume Management name space for path, and then returns the id for the piece of media.

char *path;

...

if (volmgt_running()) {
     if (volmgt_ownspath(path)) {
          (void) printf("id of %s is %lld\n",
               path, media_getid(path));
     }
}

---

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT Level	Safe
Commitment Level	Public

SEE ALSO

volmgt_root(3VOLMGT), volmgt_running(3VOLMGT), attributes(5)

SunOS 5.9  Last Revised 21 Apr 1998

NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUES | EXAMPLES | ATTRIBUTES | SEE ALSO