scf_limit(3SCF) 				 Service Configuration Facility Library Functions				   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 terminat-
	   ing 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)

SunOS 5.11							    17 Aug 2004 						   scf_limit(3SCF)