| PPATH_OBJECT(3) | Library Functions Manual | PPATH_OBJECT(3) | 
ppath_object,
  ppath_copydel_object,
  ppath_copyset_object,
  ppath_set_object,
  ppath_get_object,
  ppath_delete_object,
  ppath_copydel_data,
  ppath_copyset_data,
  ppath_set_data,
  ppath_get_data,
  ppath_dup_data,
  ppath_delete_data,
  ppath_copydel_string,
  ppath_copyset_string,
  ppath_set_string,
  ppath_get_string,
  ppath_dup_string,
  ppath_delete_string —
#include <ppath/ppath.h>
int
  
  ppath_copydel_object(prop_object_t,
    prop_object_t *,
    const ppath_t *);
int
  
  ppath_copyset_object(prop_object_t,
    prop_object_t *,
    const ppath_t *,
    prop_object_t);
int
  
  ppath_set_object(prop_object_t,
    const ppath_t *,
    prop_object_t);
int
  
  ppath_get_object(prop_object_t,
    const ppath_t *,
    prop_object_t *);
int
  
  ppath_delete_object(prop_object_t,
    const ppath_t *);
int
  
  ppath_copydel_data(prop_object_t,
    prop_object_t *,
    const ppath_t *);
int
  
  ppath_copyset_data(prop_object_t,
    prop_object_t *,
    const ppath_t *,
    const void *,
    size_t);
int
  
  ppath_set_data(prop_object_t,
    const ppath_t *,
    const void *,
    size_t);
int
  
  ppath_get_data(prop_object_t,
    const ppath_t *,
    const void **,
    size_t *);
int
  
  ppath_dup_data(prop_object_t,
    const ppath_t *,
    void **,
    size_t *);
int
  
  ppath_delete_data(prop_object_t,
    const ppath_t *);
int
  
  ppath_copydel_string(prop_object_t,
    prop_object_t *,
    const ppath_t *);
int
  
  ppath_copyset_string(prop_object_t,
    prop_object_t *,
    const ppath_t *,
    const char *);
int
  
  ppath_set_string(prop_object_t,
    const ppath_t *,
    const char *);
int
  
  ppath_get_string(prop_object_t,
    const ppath_t *,
    const char **);
int
  
  ppath_dup_string(prop_object_t,
    const ppath_t *,
    char **);
int
  
  ppath_delete_string(prop_object_t,
    const ppath_t *);
ppath_object routines read, write, or delete objects
  in a property list by path.
ppath_object provides these functions for manipulating
  objects in a property list by the objects' paths:
ppath_copydel_object(prop_object_t
    o, prop_object_t *op, const
    ppath_t *p)If *op is NULL,
        ppath_copydel_object() creates a shallow copy of
        o at *op. If
        *op is not NULL,
        ppath_copydel_object() expects for
        *op to be an existing shallow copy of
        o.
For the purposes of
        ppath_copydel_object(),
        *op is a shallow copy of property list
        o if equal properties at equal paths are shared
        between the two. Before ppath_copydel_object()
        modifies a property shared by *op and
        o, it creates a private copy of the property for
        *op.
ppath_copyset_object(prop_object_t
    o, prop_object_t *op, const
    ppath_t *p, prop_object_t v)If *op is NULL,
        ppath_copyset_object() creates a shallow copy of
        o at *op. If
        *op is not NULL,
        ppath_copyset_object() expects for
        *op to be an existing shallow copy of
        o.
For the purposes of
        ppath_copyset_object(),
        *op is a shallow copy of property list
        o if equal properties at equal paths are shared
        between the two. Before ppath_copydel_object()
        modifies a property shared by *op and
        o, it creates a private copy of the property for
        *op.
ppath_set_object(prop_object_t
    o, const ppath_t *p,
    prop_object_t v)ppath_get_object(prop_object_t
    o, const ppath_t *p,
    prop_object_t *vp)ppath_get_object() does
      not increase the reference count of the retrieved
      object.ppath_delete_object(prop_object_t
    o, const ppath_t *p)ppath_delete_object() decreases by one the deleted
      object's reference count.ppath_object routines return 0 on success, and non-zero
  on error.
EFTYPE]ppath_object call requested aENOENT]ppath_copyset_object(),
      ppath_delete_object(),
      ppath_get_object(), and
      ppath_set_object() return
      ENOENT
      if the path p does not exist in
      o.ENOMEM]ppath_set_object() and
      ppath_copyset_object() will return
      ENOMEM
      if there was insufficient memory to complete the operation.ppath_object property container path library first
  appeared in NetBSD 6.0.
| August 24, 2011 | NetBSD 10.0 |