VND_PROP_WRITEABLE(3VND) VND_PROP_WRITEABLE(3VND)
NAME
vnd_prop_writeable - determine if a vnd property can be updated
SYNOPSIS
cc [ flag... ] file... -lvnd [ library... ]
#include <libvnd.h>
int vnd_prop_writeable(vnd_prop_t prop, boolean_t *wp);
DESCRIPTION
The vnd_prop_writeable function is used as a programmatic means to
determine whether a given vnd property is writeable or not. The property
to check is specified in prop and should be from the list described in
libvnd(3VND). The argument wp is a pointer to a boolean_t which will be
updated upon the successful completion of the function. The argument wp
must be a valid pointer. If a property is writeable than the value
pointed to by wp is set to B_TRUE. If the property is read-only, then the
value is set to B_FALSE.
RETURN VALUES
On success, vnd_prop_writeable returns zero and the value pointed to by
wp is updated with whether the property is writeable. If the property
prop does not exist, then vnd_prop_writeable will return -1.
EXAMPLES
Example 1 Check whether the property VND_PROP_TXBUF is writable
The following sample C program checks whether the vnd property
VND_PROP_TXBUF is writeable or not.
#include <libvnd.h>
#include <stdio.h>
#include <stdlib.h>
int
main(void)
{
boolean_t canwrite;
if (vnd_prop_writeable(VND_PROP_TXBUF, &prop) != 0)
abort();
if (canwrite == B_TRUE)
(void) printf("VND_PROP_TXBUF is writeable0);
else
(void) printf("VND_PROP_TXBUF is read only0);
return (0);
}
ATTRIBUTES
See
attributes(5) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|Stability | Committed |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+
SEE ALSO
vndadm(1M),
libvnd(3VND) February 21, 2014
VND_PROP_WRITEABLE(3VND)