SCF_SIMPLE_WALK_INSTANCES(3SCF) Service Configuration Facility Library Functions


NAME


scf_simple_walk_instances - observational interface for Service
Configuration Facility

SYNOPSIS


cc [ flag... ] file... -lscf [ library... ]
#include <libscf.h>

int scf_simple_walk_instances(uint_t flags, void *private,
int (*inst_callback)(scf_handle_t *, scf_instance_t *, void *));


DESCRIPTION


The scf_simple_walk_instances() function iterates over every service
instance in a specified state and calls a callback function provided by
the user on each specified instance.


The function takes a flags argument to indicate which instance states are
involved in the iteration, an opaque buffer to be passed to the callback
function, and a callback function with three arguments, a handle, an
instance pointer, and an opaque buffer. If the callback function returns
a value other than success, iteration is ended, an error is set, and the
function returns -1.


The handle passed to the callback function is provided to the callback
function by the library. This handle is used by the callback function for
all low-level allocation involved in the function.


The simplified library provides defined constants for the flags argument.
The user can use a bitwise OR to apply more than one flag. The
SCF_STATE_ALL flag is a bitwise OR of all the other states.The flags are:

o SCF_STATE_UNINIT

o SCF_STATE_MAINT

o SCF_STATE_OFFLINE

o SCF_STATE_DISABLED

o SCF_STATE_ONLINE

o SCF_STATE_DEGRADED

o SCF_STATE_ALL

RETURN VALUES


Upon successful completion, scf_simple_walk_instances() returns 0.
Otherwise, it returns -1.

ATTRIBUTES


See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


libscf(3LIB), attributes(7)


August 17, 2004 SCF_SIMPLE_WALK_INSTANCES(3SCF)