volmgt_ownspath(3VOLMGT)				Volume Management Library Functions				  volmgt_ownspath(3VOLMGT)

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 compar-
       ing 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
",
		      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.10							    21 Apr 1998 					  volmgt_ownspath(3VOLMGT)