picl_walk_tree_by_class man page on SmartOS

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

PICL_WALK_TREE_BY_CLASS(3PICL)			PICL_WALK_TREE_BY_CLASS(3PICL)

NAME
       picl_walk_tree_by_class - walk subtree by class

SYNOPSIS
       cc [ flag... ] file... -lpicl [ library... ]
       #include <picl.h>

       int picl_walk_tree_by_class(picl_nodehdl_t rooth,
	    const char *classname, void *c_args,
	    int (*callback)(picl_nodehdl_t nodeh, void *c_args));

DESCRIPTION
       The picl_walk_tree_by_class() function visits all the nodes of the sub‐
       tree under the node specified by rooth. The PICL class name of the vis‐
       ited  node  is  compared with the class name specified by classname. If
       the class names match, then the callback function specified by callback
       is  called  with	 the matching node handle and the argument provided in
       c_args. If the class name specified in  classname  is  NULL,  then  the
       callback function is invoked for all the nodes.

       The  return  value  from	 the  callback	function  is used to determine
       whether to continue or terminate the tree walk. The  callback  function
       returns PICL_WALK_CONTINUE or PICL_WALK_TERMINATE to continue or termi‐
       nate the tree walk.

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

       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.
       This  error may be returned for a previously valid handle if the daemon
       was brought down and restarted. When this occurs a client must  revali‐
       date any saved handles.

ERRORS
       PICL_NOTINITIALIZED
			      Session not initialized

       PICL_NORESPONSE
			      Daemon not responding

       PICL_NOTNODE
			      Not a node

       PICL_INVALIDHANDLE
			      Invalid handle specified

       PICL_STALEHANDLE
			      Stale handle specified

       PICL_FAILURE
			      General system failure

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

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

SEE ALSO
       picl_get_propval_by_name(3PICL), attributes(5)

				  Aug 1, 2000	PICL_WALK_TREE_BY_CLASS(3PICL)
[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