1 VOLMGT_OWNSPATH(3VOLMGT)                   Volume Management Library Functions
   2 
   3 
   4 
   5 NAME
   6        volmgt_ownspath - check volume management name space for path
   7 
   8 SYNOPSIS
   9        cc [flag]... file... -lvolmgt [library]...
  10        #include <volmgt.h>
  11 
  12        int volmgt_ownspath(char *path);
  13 
  14 
  15 PARAMETERS
  16        path
  17                A string containing the path.
  18 
  19 
  20 DESCRIPTION
  21        This function is obsolete. The management of removable media by the
  22        Volume Management feature, including vold, has been replaced by
  23        software that supports the Hardware Abstraction Layer (HAL).
  24        Programmatic support for HAL is through the HAL APIs, which are
  25        documented on the HAL web site. See hal(5). The return value of this
  26        function is undefined.
  27 
  28 
  29        The volmgt_ownspath() function checks to see if a given path is
  30        contained in the volume management name space. This is achieved by
  31        comparing the beginning of the supplied path name with the output from
  32        volmgt_root(3VOLMGT)
  33 
  34 RETURN VALUES
  35        The return from this function is undefined.
  36 
  37 EXAMPLES
  38        Example 1 Using volmgt_ownspath()
  39 
  40 
  41        The following example first checks if volume management is running,
  42        then checks the volume management name space for path, and then returns
  43        the id for the piece of media.
  44 
  45 
  46          char *path;
  47 
  48          ...
  49 
  50          if (volmgt_running()) {
  51               if (volmgt_ownspath(path)) {
  52                    (void) printf("id of %s is %lld\n",
  53                         path, media_getid(path));
  54               }
  55          }
  56 
  57 
  58 ATTRIBUTES
  59        See attributes(5)  for descriptions of the following attributes:
  60 
  61 
  62 
  63 
  64        +--------------------+-----------------+
  65        |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
  66        +--------------------+-----------------+
  67        |MT-Level            | Safe            |
  68        +--------------------+-----------------+
  69        |Interface Stability | Obsolete        |
  70        +--------------------+-----------------+
  71 
  72 SEE ALSO
  73        volmgt_root(3VOLMGT), volmgt_running(3VOLMGT), attributes(5), hal(5)
  74 
  75 
  76 
  77                                  March 8, 2007        VOLMGT_OWNSPATH(3VOLMGT)