volmgt_feature_enabled(3VOLMGT) Volume Management Library Functions volmgt_feature_enabled(3VOLMGT)NAME
volmgt_feature_enabled - check whether specific Volume Management features are enabled
SYNOPSIS
cc [ flag ... ] file ... -l volmgt [ library ... ]
#include <volmgt.h>
int volmgt_feature_enabled(char *feat_str);
DESCRIPTION
The volmgt_feature_enabled() routine checks whether specific Volume Management features are enabled. volmgt_feature_enabled() checks for
the Volume Management features passed in to it by the feat_str parameter.
Currently, the only supported feature string that volmgt_feature_enabled() checks for is floppy-summit-interfaces. The floppy-summit-
interfaces feature string checks for the presence of the libvolmgt routines volmgt_acquire() and volmgt_release().
The list of features that volmgt_feature_enabled() checks for is expected to expand in the future.
RETURN VALUES
0 is returned if the specified feature is not currently available. A non-zero value indicates that the specified feature is currently
available.
EXAMPLES
Example 1: A sample of the volmgt_feature_enabled() function.
In the following example, volmgt_feature_enabled() checks whether the floppy-summit-interfaces feature is enabled.
if (volmgt_feature_enabled("floppy-summit-interfaces")) {
(void) printf("Media Sharing Routines ARE present
");
} else {
(void) printf("Media Sharing Routines are NOT present
");
}
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|MT-Level | MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO volmgt_acquire(3VOLMGT), volmgt_release(3VOLMGT), attributes(5)SunOS 5.10 13 Dec 1996 volmgt_feature_enabled(3VOLMGT)
Check Out this Related Man Page
media_getid(3VOLMGT) Volume Management Library Functions media_getid(3VOLMGT)NAME
media_getid - return the id of a piece of media
SYNOPSIS
cc [flag ...] file ...-lvolgmt [library ...]
#include <volmgt.h>
ulonglong_t media_getid(char *vol_path);
DESCRIPTION
media_getid() returns the id of a piece of media. Volume Management must be running. See volmgt_running(3VOLMGT).
PARAMETERS
vol_path Path to the block or character special device.
RETURN VALUES
media_getid() returns the id of the volume. This value is unique for each volume. If media_getid() returns 0, the path provided is not
valid, for example, it is a block or char device.
EXAMPLES
Example 1: Using media_getid()
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));
}
}
If a program using media_getid() does not check whether or not Volume Management is running, then any NULL return value will be ambiguous,
as it could mean that either Volume Management does not have path in its name space, or Volume Management is not running.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|MT Level |Safe |
+-----------------------------+-----------------------------+
|Commitment Level |Public |
+-----------------------------+-----------------------------+
SEE ALSO volmgt_ownspath(3VOLMGT),volmgt_running(3VOLMGT),attributes(5)SunOS 5.10 29 Apr1998 media_getid(3VOLMGT)