SCF_LIMIT(3SCF) Service Configuration Facility Library Functions SCF_LIMIT(3SCF)

scf_limit - limit information for Service Configuration Facility

cc [ flag... ] file... -lscf [ library... ]
#include <libscf.h>
ssize_t scf_limit(uint32_t name);

The scf_limit() function returns information about implementation-defined limits in the service configuration facility. These limits are generally maximum lengths for various strings. The values returned do not change during the execution of a program, but they should not be cached between executions.

The available values for name are:

SCF_LIMIT_MAX_FMRI_LENGTH

Return the maximum length of an FMRI the service configuration facility accepts.

SCF_LIMIT_MAX_PG_TYPE_LENGTH

Return the maximum length for property group types in the service configuration facility.

SCF_LIMIT_MAX_NAME_LENGTH

Return the maximum length for names in the service configuration facility. This value does not include space for the required terminating null byte.

SCF_LIMIT_MAX_VALUE_LENGTH

Return the maximum string length a scf_value_t can hold, not including the terminating null byte.

Lengths do not include space for the required terminating null byte.

Upon successful completion, scf_limit() returns the requested value. Otherwise, it returns -1.

The scf_limit() function will fail if:

SCF_ERROR_INVALID_ARGUMENT

The name argument is not a recognized request.

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

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

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

libscf(3LIB), scf_error(3SCF), attributes(7)

August 17, 2004 OmniOS