scf_service_delcust(3SCF)

Name

scf_service_delcust, scf_instance_delcust, scf_pg_delcust, scf_property_delcust - remove administrative customizations in the Service Configuration Facility

Synopsis

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

int scf_service_delcust(scf_service_t *svc);

int scf_instance_delcust(scf_instance_t *inst);

int scf_pg_delcust(scf_propertygroup_t *pg);

int scf_transaction_property_delcust(scf_transaction_t *t,
      scf_transaction_entry_t *e, const char *prop);

Description

The *_delcust() family of commands allows libscf(3LIB) consumers to remove all administrative customizations for an entity with one function. This includes removing any “masked” notations previously created by using the scf_*_delete() functions.

The customizations at the administrative layer can be explored with the get_decoration suite of functions. See scf_service_get_decoration(3SCF).

The customizations removed are all customizations for the entity and its children, if any exist.

Return Values

Upon successful completion, these functions return 0. Otherwise they return —1.

Errors

These functions will fail if:

SCF_ERROR_DELETED

The entity or one of its parents has been deleted by somebody else.

SCF_ERROR_NOT_SET

The entity is not set.

SCF_ERROR_NOT_BOUND

The repository handle is not bound.

SCF_ERROR_CONNECTION_BROKEN

The connection to the repository was lost.

SCF_ERROR_NO_RESOURCES

The server does not have adequate resources for a new scope handle.

SCF_ERROR_PERMISSION_DENIED

The user does not have sufficient privileges delete customizations.

SCF_ERROR_BACKEND_READONLY

The repository backend is read-only.

SCF_ERROR_BACKEND_ACCESS

The repository backend refused the modification.

The scf_error(3SCF) function can be used to retrieve the error value.

Attributes

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

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level Safe

See also

libscf(3LIB), scf_error(3SCF), scf_handle_decode_fmri(3SCF), scf_service_get_decoration(3SCF), attributes(5)