Content-type: text/html Man page of scf_simple_walk_instances

scf_simple_walk_instances

Section: Service Configuration Facility Library Functions (3SCF)
Updated: 17 Aug 2004
Index Return to Main Contents
 

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:

SCF_STATE_UNINIT
SCF_STATE_MAINT
SCF_STATE_OFFLINE
SCF_STATE_DISABLED
SCF_STATE_ONLINE
SCF_STATE_DEGRADED
SCF_STATE_ALL

 

RETURN VALUES

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

ATTRIBUTES

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

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityEvolving
MT-LevelMT-Safe

 

SEE ALSO

libscf(3LIB), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:18 GMT, October 02, 2010