SCF_LIMIT(3SCF) Service Configuration Facility Library Functions


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 | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO


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


August 17, 2004 SCF_LIMIT(3SCF)