volmgt_ownspath(3volmgt)

1volmgt_ownspath(3VOLMGTV)olume Management Library Functiovnoslmgt_ownspath(3VOLMGT)
2
3
4

NAME

6       volmgt_ownspath - check volume management name space for path
7

SYNOPSIS

9       cc [flag]... file... −lvolgmt [library]...
10       #include <volmgt.h>
11
12       int volmgt_ownspath(char *path);
13
14

PARAMETERS

16       path    A string containing the path.
17
18

DESCRIPTION

20       This  function  is  obsolete.  The management of removable media by the
21       Volume Management feature, including vold, has been replaced  by  soft‐
22       ware  that  supports the Hardware Abstraction Layer (HAL). Programmatic
23       support for HAL is through the HAL APIs, which are  documented  on  the
24       HAL  web  site.  See hal(5). The return value of this function is unde‐
25       fined.
26
27
28       The volmgt_ownspath() function checks to see if a given  path  is  con‐
29       tained in the volume management name space. This is achieved by compar‐
30       ing the beginning of the  supplied  path  name  with  the  output  from
31       volmgt_root(3VOLMGT)
32

RETURN VALUES

34       The return from this function is undefined.
35

EXAMPLES

37       Example 1 Using volmgt_ownspath()
38
39
40       The  following  example  first  checks if volume management is running,
41       then checks the volume management name space for path, and then returns
42       the id for the piece of media.
43
44
45         char *path;
46
47         ...
48
49         if (volmgt_running()) {
50              if (volmgt_ownspath(path)) {
51                   (void) printf("id of %s is %lld\n",
52                        path, media_getid(path));
53              }
54         }
55
56

ATTRIBUTES

58       See attributes(5)  for descriptions of the following attributes:
59
60
61
62
63       ┌─────────────────────────────┬─────────────────────────────┐
64       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
65       ├─────────────────────────────┼─────────────────────────────┤
66       │MT-Level                     │Safe                         │
67       ├─────────────────────────────┼─────────────────────────────┤
68       │Interface Stability          │Obsolete                     │
69       └─────────────────────────────┴─────────────────────────────┘
70