|Skip Navigation Links|
|Exit Print View|
|man pages section 3: Extended Library Functions, Volume 4 Oracle Solaris 11.1 Information Library|
- determine whether entities are masked in the Service Configuration Facility
cc [ flag... ] file... -lscf [ library... ] #include <libscf.h> int scf_service_is_masked(const scf_service_t *svc);
int scf_instance_is_masked(const scf_instance_t *inst);
int scf_pg_is_masked(const scf_propertygroup_t *pg);
int scf_property_is_masked(const scf_property_t *prop);
Entities are masked if an administrator has requested they be deleted, but the entity is backed by configuration in the filesystem such as manifests and profiles.
Masked entities are not discovered through libscf(3LIB) unless the caller decorates the initial handle with scf_handle_decorate(h, “show_masked”, SCF_DECORATE_TRUE). If the caller needs to ignore masked entities, it must explicitly call one of the functions described on this manual page to determine the entity is masked.
These functions allow consumers to determine whether an entity is masked.
If the entity is not masked, these functions return 0. If the entity is masked, they return 1. In the event of error, they return -1.
These functions will fail if:
The entity is not masked.
The entity or one of its parents has been deleted.
The entity is not set.
The repository handle is not bound.
The connection to the repository was lost.
The scf_error(3SCF) function can be used to retrieve the error value.
See attributes(5) for descriptions of the following attributes: