Skip Navigation Links | |
Exit Print View | |
man pages section 3: Extended Library Functions Oracle Solaris 10 1/13 Information Library |
Extended Library Functions - Part 1
Extended Library Functions - Part 2
Extended Library Functions - Part 3
Extended Library Functions - Part 4
Extended Library Functions - Part 5
ptree_add_row_to_table(3PICLTREE)
ptree_create_and_add_node(3PICLTREE)
ptree_create_and_add_prop(3PICLTREE)
ptree_get_first_prop(3PICLTREE)
ptree_get_frutree_parent(3PICLTREE)
ptree_get_next_by_col(3PICLTREE)
ptree_get_next_by_row(3PICLTREE)
ptree_get_next_prop(3PICLTREE)
ptree_get_node_by_path(3PICLTREE)
ptree_get_prop_by_name(3PICLTREE)
ptree_get_propinfo_by_name(3PICLTREE)
ptree_get_propval_by_name(3PICLTREE)
ptree_init_propinfo(3PICLTREE)
ptree_register_handler(3PICLTREE)
ptree_unregister_handler(3PICLTREE)
ptree_update_propval(3PICLTREE)
ptree_update_propval_by_name(3PICLTREE)
ptree_walk_tree_by_class(3PICLTREE)
rsm_create_localmemory_handle(3RSM)
rsm_free_interconnect_topology(3RSM)
rsm_free_localmemory_handle(3RSM)
rsm_get_interconnect_topology(3RSM)
rsm_intr_signal_wait_pollfd(3RSM)
rsm_memseg_export_create(3RSM)
rsm_memseg_export_destroy(3RSM)
rsm_memseg_export_publish(3RSM)
rsm_memseg_export_rebind(3RSM)
rsm_memseg_export_republish(3RSM)
rsm_memseg_export_unpublish(3RSM)
rsm_memseg_import_close_barrier(3RSM)
rsm_memseg_import_connect(3RSM)
rsm_memseg_import_destroy_barrier(3RSM)
rsm_memseg_import_disconnect(3RSM)
rsm_memseg_import_get_mode(3RSM)
rsm_memseg_import_init_barrier(3RSM)
rsm_memseg_import_open_barrier(3RSM)
rsm_memseg_import_order_barrier(3RSM)
rsm_memseg_import_set_mode(3RSM)
rsm_memseg_release_pollfd(3RSM)
SCF_Card_exchangeAPDU(3SMARTCARD)
SCF_Card_waitForCardRemoved(3SMARTCARD)
scf_entry_destroy_children(3SCF)
scf_instance_get_pg_composed(3SCF)
scf_instance_get_snapshot(3SCF)
scf_iter_instance_pgs_composed(3SCF)
scf_iter_instance_pgs_typed(3SCF)
scf_iter_instance_pgs_typed_composed(3SCF)
scf_iter_instance_snapshots(3SCF)
scf_iter_property_values(3SCF)
scf_iter_service_instances(3SCF)
scf_iter_service_pgs_typed(3SCF)
scf_iter_snaplevel_pgs_typed(3SCF)
scf_pg_get_parent_instance(3SCF)
scf_pg_get_parent_service(3SCF)
scf_pg_get_parent_snaplevel(3SCF)
scf_pg_get_underlying_pg(3SCF)
scf_service_add_instance(3SCF)
scf_service_get_instance(3SCF)
SCF_Session_freeInfo(3SMARTCARD)
SCF_Session_getInfo(3SMARTCARD)
SCF_Session_getSession(3SMARTCARD)
SCF_Session_getTerminal(3SMARTCARD)
scf_simple_app_props_free(3SCF)
scf_simple_app_props_get(3SCF)
scf_simple_app_props_next(3SCF)
scf_simple_app_props_search(3SCF)
scf_simple_prop_next_astring(3SCF)
scf_simple_prop_next_boolean(3SCF)
scf_simple_prop_next_count(3SCF)
scf_simple_prop_next_integer(3SCF)
scf_simple_prop_next_opaque(3SCF)
scf_simple_prop_next_reset(3SCF)
scf_simple_prop_next_time(3SCF)
scf_simple_prop_next_ustring(3SCF)
scf_simple_prop_numvalues(3SCF)
scf_simple_walk_instances(3SCF)
scf_snaplevel_get_instance_name(3SCF)
scf_snaplevel_get_next_snaplevel(3SCF)
scf_snaplevel_get_parent(3SCF)
scf_snaplevel_get_scope_name(3SCF)
scf_snaplevel_get_service_name(3SCF)
scf_snapshot_get_base_snaplevel(3SCF)
SCF_Terminal_addEventListener(3SMARTCARD)
SCF_Terminal_close(3SMARTCARD)
SCF_Terminal_freeInfo(3SMARTCARD)
SCF_Terminal_getCard(3SMARTCARD)
SCF_Terminal_getInfo(3SMARTCARD)
SCF_Terminal_removeEventListener(3SMARTCARD)
SCF_Terminal_updateEventListener(3SMARTCARD)
SCF_Terminal_waitForCardAbsent(3SMARTCARD)
SCF_Terminal_waitForCardPresent(3SMARTCARD)
scf_transaction_destroy_children(3SCF)
scf_transaction_property_change(3SCF)
scf_transaction_property_change_type(3SCF)
scf_transaction_property_delete(3SCF)
scf_transaction_property_new(3SCF)
scf_transaction_reset_all(3SCF)
scf_value_get_as_string_typed(3SCF)
- create and manipulate property handles in the Service Configuration Facility
cc [ flag… ] file… -lscf [ library… ] #include <libscf.h> scf_property_t *scf_property_create(scf_handle_t *handle);
scf_handle_t *scf_property_handle(scf_property_t *prop);
void scf_property_destroy(scf_property_t *prop);
ssize_t scf_property_get_name(const scf_property_t *prop, char *buf, size_t size);
int scf_property_type(const scf_property_t *prop, scf_type_t *type);
int scf_property_is_type(const scf_property_t *prop, scf_type_t type);
int scf_property_get_value(const scf_property_t *prop, scf_value_t *value);
int scf_pg_get_property(const scf_property_t *pg, const char *name, scf_property_t *prop);
Properties are named sets of values of one type. They are grouped into property groups (see scf_pg_create(3SCF)) that are updated atomically using transactions (see scf_transaction_create(3SCF)).
An scf_property_t is an opaque handle that can be set to a single property at any given time. When set, it inherits the point-in-time from the source scf_propertygroup_t and does not change until reset.
The scf_property_create() function allocates and initializes a new scf_property_t bound to handle. The scf_property_destroy() function destroys and frees prop.
The scf_property_handle() function returns the handle to which prop is bound.
The scf_property_type() function retrieves the type of the property to which prop is set.
The scf_property_is_type() function determines if the property is compatible with type. See scf_value_create(3SCF).
The scf_property_get_value() function retrieves the single value that the property to which prop is set contains. If the property has more than one value, the value argument is set to one of the values. To retrieve all values associated with a property, see scf_iter_property_values(3SCF).
The scf_pg_get_property() function sets prop to the property specified by name in the property group specified by pg.
Upon successful completion, scf_property_create() returns a new scf_property_t. Otherwise, it returns NULL.
Upon successful completion, scf_property_get_name() function returns the length of the string written, not including the terminating null byte. Otherwise, it returns -1.
Upon successful completion, scf_pg_get_property(), scf_property_type(), scf_property_is_type(), and scf_pg_get_value() functions return 0. Otherwise, they return -1.
The scf_property_create() function will fail if:
The value of the handle argument is NULL.
There is not enough memory to allocate an scf_property_t.
The server does not have adequate resources for a new property handle.
The scf_property_handle() function will fail if:
The handle associated with prop has been destroyed.
The scf_property_get_name(), scf_property_type(), scf_property_is_type(), and scf_property_get_value() functions will fail if:
The property's parent property group or an ancestor has been deleted.
The handle was never bound or has been unbound.
The property is not set.
The connection to the repository was lost.
The scf_property_is_type() function will fail if:
The type argument is not a valid type.
The prop argument is not of a type compatible with type.
The scf_pg_get_property() function will fail if:
The property group specified by pg is not set.
The property specified by name was not found.
The value of the name argument is not a valid property name.
The property group and property are not derived from the same handle.
The connection to the repository was lost.
The handle was never bound or has been unbound.
The property group or an ancestor has been deleted.
The scf_property_get_value() function will fail if:
The property has more than one value associated with it. The value argument will be set to one of the values.
The property has no values associated with it. The value argument will be reset.
The property and value are derived from different handles.
The scf_error(3SCF) function can be used to retrieve the error value.
See attributes(5) for descriptions of the following attributes:
|
libscf(3LIB), scf_error(3SCF), scf_handle_decode_fmri(3SCF), scf_iter_property_values(3SCF), scf_pg_create(3SCF), scf_property_to_fmri(3SCF), scf_transaction_create(3SCF), scf_value_create(3SCF), attributes(5)