| PPATH_NUMBER(3) | Library Functions Manual | PPATH_NUMBER(3) |
ppath_number,
ppath_copydel_int64,
ppath_copyset_int64,
ppath_set_int64,
ppath_get_int64,
ppath_delete_int64,
ppath_copydel_uint64,
ppath_copyset_uint64,
ppath_set_uint64,
ppath_get_uint64,
ppath_delete_uint64 —
#include <ppath/ppath.h>
int
ppath_copydel_int64(prop_object_t,
prop_object_t *,
const ppath_t *);
int
ppath_copyset_int64(prop_object_t,
prop_object_t *,
const ppath_t *,
int64_t);
int
ppath_set_int64(prop_object_t,
const ppath_t *,
int64_t);
int
ppath_get_int64(prop_object_t,
const ppath_t *,
int64_t *);
int
ppath_delete_int64(prop_object_t,
const ppath_t *);
int
ppath_copydel_uint64(prop_object_t,
prop_object_t *,
const ppath_t *);
int
ppath_copyset_uint64(prop_object_t,
prop_object_t *,
const ppath_t *,
uint64_t);
int
ppath_set_uint64(prop_object_t,
const ppath_t *,
uint64_t);
int
ppath_get_uint64(prop_object_t,
const ppath_t *,
uint64_t *);
int
ppath_delete_uint64(prop_object_t,
const ppath_t *);
ppath_number routines read, write, or delete
integers in a property list by path.
ppath_number provides these functions for manipulating
integers in a property list by the integers' paths:
ppath_copydel_int64(prop_object_t
o, prop_object_t *op, const
ppath_t *p)ppath_copydel_uint64(prop_object_t
o, prop_object_t *op, const
ppath_t *p)If *op is NULL,
ppath_copydel_int64() and
ppath_copydel_uint64() create a shallow copy of
o at *op. If
*op is not NULL,
ppath_copydel_int64() and
ppath_copydel_uint64() expect for
*op to be an existing shallow copy of
o.
For the purposes of
ppath_copydel_int64() and
ppath_copydel_uint64(),
*op is a shallow copy of property list
o if equal properties at equal paths are shared
between the two. Before ppath_copydel_int64()
and ppath_copydel_uint64() modify a property
shared by *op and o, they
create a private copy of the property for *op.
ppath_copyset_int64(prop_object_t
o, prop_object_t *op, const
ppath_t *p, int64_t v)ppath_copyset_uint64(prop_object_t
o, prop_object_t *op, const
ppath_t *p, uint64_t v)If *op is NULL,
ppath_copyset_int64() and
ppath_copyset_uint64() create a shallow copy of
o at *op. If
*op is not NULL,
ppath_copyset_int64() and
ppath_copyset_uint64() expect for
*op to be an existing shallow copy of
o.
For the purposes of
ppath_copyset_int64() and
ppath_copyset_uint64(),
*op is a shallow copy of property list
o if equal properties at equal paths are shared
between the two. Before ppath_copydel_int64()
and ppath_copydel_uint64() modify a property
shared by *op and o, they
create a private copy of the property for *op.
ppath_set_int64(prop_object_t
o, const ppath_t *p, int64_t
v)ppath_set_uint64(prop_object_t
o, const ppath_t *, uint64_t
v)ppath_get_int64(prop_object_t
o, const ppath_t *p, int64_t
*vp)ppath_get_uint64(prop_object_t
o, const ppath_t *p, uint64_t
*vp)ppath_delete_int64(prop_object_t
o, const ppath_t *p)ppath_delete_uint64(prop_object_t
o, const ppath_t *p)ppath_delete_int64() and
ppath_delete_uint64() decrease by one the deleted
number's reference count.ppath_number routines return 0 on success, and non-zero
on error.
EFTYPE]ppath_number operation returns
EFTYPE
when the object named by the path is not a
prop_number_t.ENOENT]ppath_number routines return
ENOENT
if the path p does not exist in
o.ENOMEM]ppath_set_int64(),
ppath_set_uint64(),
ppath_copyset_int64(), and
ppath_copyset_uint64() return
ENOMEM
if there was insufficient memory to complete the operation.ppath_number property container path library first
appeared in NetBSD 6.0.
| September 13, 2011 | NetBSD 9.0 |