scf_limit(3SCF)

Name

scf_limit - limit information for Service Configuration Facility

Synopsis

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

ssize_t scf_limit(uint32_t name);

Description

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.

Return Values

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

Errors

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.

Attributes

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

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

See also

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