scf_limit (3scf) manual page

Table of Contents

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 implementationdefined 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:

tab() allbox; cw(2.750000i)| cw(2.750000i) lw(2.750000i) lw(2.750000i). ATTRIBUTE TYPEATTRIBUTE VALUE Interface StabilityEvolving MT-LevelMT-Safe

See Also

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


Table of Contents