Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
Volume Management Library Functionsvolmgt_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 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 TYPEATTRIBUTE VALUE
MT LevelSafe
Commitment LevelPublic

SEE ALSO

 

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

SunOS 5.9Go To TopLast Changed 21 Apr 1998
 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.