PTREE_GET_PROP_BY_NAME man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

PTREE_GET_PROP_BY_NAME(3PICLTREE)	     PTREE_GET_PROP_BY_NAME(3PICLTREE)

NAME
       ptree_get_prop_by_name - get a property handle by name

SYNOPSIS
       cc [ flag ] file... -lpicltree [ library... ]
       #include <picltree.h>

       int ptree_get_prop_by_name(picl_nodehdl_t nodeh, char *name,
	    picl_prophdl_t *proph);

DESCRIPTION
       The  ptree_get_prop_by_name() function gets the handle of the property,
       whose name is specified in name, of the node specified  by  the	handle
       nodeh.	The  property  handle is copied into the location specified by
       proph.

RETURN VALUES
       Upon successful completion, 0 is returned. On failure,  a  non-negative
       integer is returned to indicate an error.

       PICL_RESERVEDNAME  is returned if the name specified is a PICL reserved
       name property. Reserved name properties do not have an associated prop‐
       erty  handle. Use ptree_get_propval_by_name(3PICLTREE) to get the value
       of a reserved property.

       PICL_STALEHANDLE is returned if the handle is  no  longer  valid.  This
       occurs if the PICL tree was refreshed or reinitialized.

       PICL_INVALIDHANDLE is returned if the specified handle never existed.

ERRORS
       PICL_NOTNODE
			     Not a node

       PICL_RESERVEDNAME
			     Property name is reserved

       PICL_INVALIDHANDLE
			     Invalid handle

       PICL_STALEHANDLE
			     Stale handle

       PICL_PROPNOTFOUND
			     Property not found

       PICL_FAILURE
			     General system failure

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │Interface Stability │ Evolving	      │
       ├────────────────────┼─────────────────┤
       │MT-Level	    │ MT-Safe	      │
       └────────────────────┴─────────────────┘

SEE ALSO
       ptree_get_first_prop(3PICLTREE),	 ptree_get_propval_by_name(3PICLTREE),
       attributes(5)

				 Mar 28, 2000PTREE_GET_PROP_BY_NAME(3PICLTREE)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net